Cron

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

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

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

## Команды

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

```bash
# Повторяющееся по cron-выражению (время — местное, указывай --tz)
uv run --project .. python -m d_brain.cron add \
  --prompt "Собери утреннюю сводку: вчерашний daily, goals недели" \
  --cron "0 9 * * *" --tz Asia/Tashkent --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+05:00" --delete-after-run

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 <зона пользователя>` |
| «по будням в 18:30» | `--cron "30 18 * * 1-5" --tz ...` |
| «каждое воскресенье» | `--cron "0 10 * * 0" --tz ...` |
| «каждый час» | `--every 3600` |
| «каждые 15 минут» | `--every 900` |
| «через 20 минут» | вычисли ISO-время: now+20m → `--at <ISO> --delete-after-run` |
| «завтра в 15» | `--at "<завтра>T15:00:00+05:00" --delete-after-run` |

## Правила

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