cron

name	cron
description	Управление собственным расписанием — напоминания, рутины, периодические задачи. Триггеры — "напомни", "каждый день/час/утро", "по расписанию", "schedule", "reminder", "отмени напоминание", "что запланировано".

Cron: расписания и напоминания

Ты управляешь своим расписанием сам — через CLI, который редактирует jobs.json. Бот перечитывает файл каждую минуту и запускает задания в отдельной cron-сессии. Результат запуска уходит пользователю в Telegram.

Команды

Рабочая директория — vault, проект уровнем выше (--project ..):

Таймзона. Время в --cron — местное; ВСЕГДА передавай --tz зоной ПОЛЬЗОВАТЕЛЯ. Никогда не хардкодь чужую зону. В примерах ниже стоит "${TZ:-UTC}" — это РАБОЧЕЕ значение: shell подставит env TZ (зона из конфигурации пользователя), а если она не задана — UTC. Чтобы зафиксировать конкретную зону, замени на IANA-имя (напр. Europe/Moscow). <offset> в --at — UTC-смещение зоны (+05:00, +03:00, +00:00), его подставляешь при вычислении времени.

# Повторяющееся по cron-выражению (время местное — указывай --tz)
uv run --project .. python -m d_brain.cron add \
  --prompt "Собери утреннюю сводку: вчерашний daily, goals недели" \
  --cron "0 9 * * *" --tz "${TZ:-UTC}" --id morning-brief

# Интервал в секундах
uv run --project .. python -m d_brain.cron add \
  --prompt "Проверь inbox в vault, новое разложи по карточкам. Если пусто — начни ответ с [SILENT]" \
  --every 3600

# Разовое напоминание: ВСЕГДА --at + --delete-after-run
uv run --project .. python -m d_brain.cron add \
  --prompt "Напомни про звонок с подрядчиком" \
  --at "2026-06-12T18:00:00<offset>" --delete-after-run   # <offset>, напр. +05:00

uv run --project .. python -m d_brain.cron list
uv run --project .. python -m d_brain.cron remove <id>
uv run --project .. python -m d_brain.cron enable <id>   # вернуть авто-отключённый

Ошибка → exit 2 и текст в stderr: прочитай и исправь аргументы.

Перевод естественного языка в расписание

Просьба	Аргументы
«каждый день в 9»	--cron "0 9 * * *" --tz "${TZ:-UTC}"
«по будням в 18:30»	--cron "30 18 * * 1-5" --tz "${TZ:-UTC}"
«каждое воскресенье»	--cron "0 10 * * 0" --tz "${TZ:-UTC}"
«каждый час»	--every 3600
«каждые 15 минут»	--every 900
«через 20 минут»	вычисли ISO-время: now+20m → --at <ISO> --delete-after-run
«завтра в 15»	--at "<завтра>T15:00:00<offset>" --delete-after-run

Правила

1. Никогда не эмулируй расписание через sleep, циклы в Bash или фоновые процессы — только этот CLI.
2. Разовое («напомни…») — всегда --at + --delete-after-run.
3. --at пиши со смещением зоны ПОЛЬЗОВАТЕЛЯ (<offset>, напр. +05:00); naive-время (без смещения) трактуется в --tz, по умолчанию UTC.
4. Prompt задания — самодостаточный: исполняет отдельная сессия без контекста текущего разговора. Включай в prompt всё нужное (пути, имена, критерии).
5. Мониторинговым заданиям («проверь и скажи, если что-то новое») вели в prompt: «если ничего важного — начни ответ строкой [SILENT]» — тогда пользователь не получит пустой спам.
6. Recursion guard: если текущий запрос сам помечен [CRON JOB ...] — ты внутри планового запуска; создавать/менять/удалять задания ЗАПРЕЩЕНО.
7. После add/remove подтверди пользователю результат строкой из list (id, расписание, next run).