R-package-update-check — Еженедельный дайджест новых пакетов CRAN

Агент собирает список пакетов, впервые опубликованных на CRAN за последние 7 дней, формирует человекочитаемые описания каждого пакета и сохраняет результат в виде `.md` файла.

Источники данных

1. CRAN /web/packages/available_packages_by_date.html — страница с датами

первой публикации. URL: https://cran.r-project.org/web/packages/available_packages_by_date.html

1. crandb API (основной): https://crandb.r-pkg.org/{pkg} — JSON с полями

Title, Description, Author, License, Imports и др.

1. CRAN DESCRIPTION-файл (резервный):

https://cran.r-project.org/web/packages/{pkg}/DESCRIPTION

Алгоритм выполнения

Шаг 1 — Получить список новых пакетов

Загрузи страницу с датами публикаций и отфильтруй пакеты, у которых дата первого появления попадает в диапазон [сегодня − 7 дней, сегодня].

# Пример парсинга в R
url <- "https://cran.r-project.org/web/packages/available_packages_by_date.html"
page <- rvest::read_html(url)
tbl  <- rvest::html_table(page)[[1]]
new_pkgs <- tbl[as.Date(tbl$Date) >= Sys.Date() - 7, ]

Если R недоступен — используй web_fetch + парсинг HTML напрямую.

Шаг 2 — Получить метаданные каждого пакета

Для каждого пакета из списка обратись к crandb API:

GET https://crandb.r-pkg.org/<pkg_name>

Извлеки поля: Title, Description, Author, Maintainer, License, Imports, Suggests, URL.

При ошибке 404 — пробуй DESCRIPTION-файл напрямую: https://cran.r-project.org/web/packages/<pkg>/DESCRIPTION

Шаг 3 — Сформировать Markdown-описание каждого пакета

Для каждого пакета используй строго этот шаблон:

### {Название пакета} ({версия})

**Что делает:** {1–2 предложения, суть пакета простым языком}

**Область применения:** {тег: статистика / визуализация / машинное обучение /
работа с данными / веб / биоинформатика / утилиты / другое}

**Зависимости:** {основные импорты через запятую, не более 5}

**Лицензия:** {лицензия}

**Автор/мейнтейнер:** {имя}

**Ссылка:** https://cran.r-project.org/package={pkg}

Описание «Что делает» — на языке пользователя, простым языком. Не копируй дословно поле Description из DESCRIPTION — перефразируй.

Шаг 4 — Собрать и сохранить итоговый .md файл

#### Структура файла

# Новые пакеты CRAN: {дата_начала} — {дата_конца}

> Дайджест сформирован автоматически агентом Hermes.
> Всего новых пакетов за период: {N}

## Содержание по категориям

- Статистика: {n}
- Визуализация: {n}
- Машинное обучение: {n}
- Работа с данными: {n}
- Биоинформатика: {n}
- Утилиты: {n}
- Другое: {n}

---

## Пакеты

{блоки пакетов, сгруппированные по категории, внутри категории — по алфавиту}

---

*Источник: [CRAN](https://cran.r-project.org) /
[crandb](https://crandb.r-pkg.org)*

#### Имя файла

Формат: cran-digest-{YYYY-MM-DD}.md, где дата — последний день периода (обычно сегодня).

Пример: cran-digest-2025-06-13.md

#### Сохранение и передача файла

1. Определи рабочую директорию агента: используй переменную окружения $PWD

или выполни os.getcwd() / getwd() — это и есть целевая папка. Никогда не используй захардкоженный путь вроде /mnt/user-data/outputs/.

1. Запишь файл в определённую рабочую директорию:

{рабочая_директория}/cran-digest-{YYYY-MM-DD}.md

1. Вызови present_files с полным путём к файлу, чтобы пользователь мог его скачать.
2. В чат выведи краткое резюме: количество пакетов, топ-3 категории.

Параметры запуска

Пользователь может уточнить запрос — учитывай эти параметры без переспросов:

Приоритеты при большом числе пакетов

Если пакетов больше 30 и пользователь не просил полный список:

1. Предупреди о числе пакетов одной фразой.
2. Предложи три варианта: показать все / только топ-N / отфильтровать по теме.
3. При выборе «топ-N» — приоритизируй пакеты с наибольшим числом зависимостей

(признак востребованности) или с наиболее содержательным Description.

Обработка ошибок

Пример минимального вызова

«Покажи новые пакеты CRAN за эту неделю»

Агент без дополнительных вопросов:

1. Определяет диапазон дат (сегодня − 7 дней).
2. Получает список новых пакетов.
3. Формирует описания.
4. Сохраняет cran-digest-{сегодня}.md в outputs.
5. Вызывает present_files — пользователь получает ссылку на скачивание.
6. В чат выводит: «Готово. Найдено X пакетов. Файл сохранён.»