opencode-windows-scheduler 1.2.2 → 1.3.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/ROADMAP.md CHANGED
@@ -1,123 +1,90 @@
1
1
  # 🗺️ Roadmap — opencode-windows-scheduler
2
2
 
3
- План развития плагина. Тактический спринт-план; стратегические приоритеты — в [ROADMAP-STRATEGY.md](./ROADMAP-STRATEGY.md).
3
+ Текущая версия: **1.3.0** (14.11.2026). Плагин опубликован в npm, CI зелёный на Windows / macOS / Linux, 22 инструмента агента, 27 тестовых сюит.
4
4
 
5
- > **Важно:** согласно стратегическому роадмапу (после аудита плагина) перед Спринтом 18 идут два внеплановых спринта:
6
- > **17.5 — OSS-упаковка** (LICENSE, npm, CI, английский README) и **17.6 — Паритет агента** (полный доступ к функционалу через инструменты). Детали — в `ROADMAP-STRATEGY.md`.
5
+ - Стратегия и позиционирование — [ROADMAP-STRATEGY.md](./ROADMAP-STRATEGY.md).
6
+ - Что уже выпущено — [CHANGELOG.md](./CHANGELOG.md).
7
+ - Устройство и возможности — [docs/ARCHITECTURE.md](./docs/ARCHITECTURE.md), [docs/FEATURES.md](./docs/FEATURES.md).
7
8
 
8
- ## Сделано (Спринты 1–16)
9
+ ---
9
10
 
10
- | # | Тема | Артефакты |
11
- |---|---|---|
12
- | 1–8 | Ядро: cron → schtasks, lock-файлы, таймауты, повторы, Quality Gate, цепочки (DAG), файловые триггеры, dry-run | `src/core/*`, `src/schtasks.ts` |
13
- | 9 | SQLite-хранилище задач и истории | `src/db/*` |
14
- | 10 | Восстановление после краха, незавершённые записи → error | `src/db/recovery.ts` |
15
- | 11 | Лёгкие уведомления: webhook (Discord/Slack-совместимый) + тосты GUI | `src/notifications.ts`, `src/settings.ts` |
16
- | 12 | Workspace-ы: отдельные директории задач, роль-скоуп tools | `src/workspaces.ts` |
17
- | 13 | Дашборд (HTTP): задачи, история, dry-run, фильтры | `src/server.ts` |
18
- | 14 | Экспорт/импорт задач, шаблоны | `src/task-transfer.ts`, `src/templates.ts` |
19
- | 15 | Matrix Builds (fan-out): клоны по workspace, parallel/sequential, failureMode, агрегация, DAG | `src/core/matrix.ts`, `SPRINT15` в истории |
20
- | 16 | Lifecycle матриц: каскадное удаление, отмена, чистка сирот, guard на удаление клона | `src/core/matrix.ts`, `test-matrix-lifecycle.mjs` |
21
- | 17 | Синхронизация матриц (`syncMatrixFamily`) + per-workspace overrides + concurrency | `src/core/matrix.ts`, `SPRINT17` (отчёт не писался) |
22
- | 18 | Ретеншн истории (30 дней / 5000 записей), аналитика за 14 дней, CSV/JSON-экспорт, `/api/health` | `SPRINT18.md` |
23
- | 19 | Планирование 2.0: timezone на задачу, окна запуска notBefore/notAfter, расширенный cron (@every/L/#), пауза до даты с автопродолжением, следующие срабатывания в dry-run | `SPRINT19.md` |
24
- | 20 | Уведомления v2: ретраи/таймаут webhook, шаблоны, фильтры по задачам, уведомления матриц, детектор зависших клонов, дайджест (день/неделя) | `SPRINT20.md` |
25
- | 21 | Мультипроектность: профили (`default`, `work`, …) с отдельными БД/настройками/портом дашборда, группировка задач по workspace в GUI/дашборде, переключение профиля, env-переменные на workspace (`.env` или пары) с маскировкой секретов, тесты `test-profiles.mjs`/`test-env.mjs` | `SPRINT21.md` |
26
-
27
- ## Спринт 17 — Синхронизация матриц + per-workspace настройки ✅ Готово
28
-
29
- **Проблема:** после создания матрицы изменение `matrix.workspaceIds` (или промпта/хуков) в `update_task`/GUI не пересоздаёт клонов — семья рассинхронизируется, появляются устаревшие клоны. Плюс нельзя задать клону отличия от родителя (свой промпт, модель, QG).
30
-
31
- **Объём:**
32
- 1. `syncMatrixFamily(parent)` в `src/core/matrix.ts`:
33
- - diff текущих клонов (по `matrixParentId`) и `expandMatrixTask(parent)`;
34
- - удалить лишних (ОС + БД, терпимо), создать недостающих, обновить изменившихся (промпт/модель/хуки/QG/tools);
35
- - обновить агрегатор (`ensureMatrixCompleteTask` / удалить, если `createAggregator` выключили);
36
- - защита: не трогать клонов со статусом `running` (вернуть предупреждение).
37
- 2. Вызвать `syncMatrixFamily` из `update_task` (RPC) и из `schedulerUpdateTask`, если определена матрица.
38
- 3. Per-workspace overrides: `matrix.overrides?: Record<workspaceId, { prompt?, model?, qualityGate?, beforeScript?, afterScript? }>` — применяются в `expandMatrixTask`; валидация в `task-transfer.ts` (workspaceId должен входить в `workspaceIds`); round-trip экспорт/импорт.
39
- 4. `matrix.concurrency?: number` — максимум одновременно работающих клонов матрицы (в дополнение к глобальному `maxConcurrent`): sequential = 1, parallel без значения = без лимита. Учёт в `runMatrix`/`advanceSequentialMatrix`.
40
- 5. GUI: редактор overrides на workspace в матричном блоке, поле «параллелизм», превью с учётом overrides; дашборд — бейдж лимита.
41
-
42
- **Готово, когда:**
43
- - изменение `workspaceIds` (добавление/удаление/замена) корректно синхронизирует клонов и агрегатор;
44
- - `running`-клоны не удаляются, возвращается предупреждение;
45
- - overrides и `concurrency` проходят export/import round-trip;
46
- - тесты: `test-matrix-sync.mjs` (≥15 проверок) + весь `npm test` зелёный.
11
+ ## История релизов
47
12
 
48
- **Ограничения на потом:** история удалённых при синхронизации клонов остаётся (чистится ретеншном — Спринт 18).
49
-
50
- ## Спринт 18 — Ретеншн истории и аналитика ✅ Готово
51
-
52
- Отчёт: `SPRINT18.md`. По факту:
53
- 1. Настройки `history.retentionDays` / `history.maxRecords` в settings.json (дефолт 30 дней / 5000 записей, 0 — выкл.), автоочистка раз в сутки при старте плагина + `PRAGMA incremental_vacuum`; ручная кнопка «🧹 Очистить сейчас» и RPC `cleanup_history`. GUI: сворачиваемая секция «🧹 История и ретеншн».
54
- 2. RPC: `cleanup_history` + отдельный `get_analytics` (`days` 1..365, `topLimit >= 1`): агрегаты по дням/задачам/моделям/матрицам, success rate, токены, стоимость. All-time RPC `get_metrics` оставлен как был — отдельное имя, см. SPRINT18.md (расхождение с этим пунктом).
55
- 3. Дашборд: блок «📊 Аналитика за период» (KPI, график по дням, топ задач по стоимости, матрицы), экспорт истории в CSV/JSON (`/api/history/export?format=csv|json`).
56
- 4. `/api/health`: `version` (из package.json), `scheduler`, `queueDepth` (незавершённые запуски), `db` (`getDbStatus()`). Статистику осиротевших задач health не отдаёт — сироты остаются в матричных инструментах (`matrix_control`).
57
- 5. Тесты: `test-retention.mjs` (19 проверок) + `test-metrics.mjs` (25 проверок), оба в цепочке `npm test`.
58
-
59
- ## Спринт 19 — Планирование 2.0 ✅ Готово
13
+ | Версия | Дата | Что вошло |
14
+ |---|---|---|
15
+ | 1.0.0 | 13.11.2026 | Ядро: cron и нативный планировщик ОС (Windows / macOS / Linux), lock-файлы, таймауты, повторы, Quality Gate, DAG и цепочки, файловые и MCP-триггеры, SQLite-история, workspaces, дашборд, dry-run, экспорт/импорт, шаблоны, матричные сборки (fan-out, lifecycle, sync). |
16
+ | 1.1.0 | 13.11.2026 | Паритет агента: 12 инструментов, полная схема `schedule_task`, встроенный скилл `scheduled-job-best-practices`, документация ARCHITECTURE / FEATURES / MIGRATION, ретеншн истории и аналитика за 14 дней. |
17
+ | 1.2.0 | 13.11.2026 | Планирование 2.0 (timezone, окна `notBefore`/`notAfter`, расширенный cron, `pausedUntil`), уведомления v2 (ретраи, шаблоны, фильтры, матрицы, дайджест), профили и env на workspace, входящие webhooks с HMAC, JSONL-логи, Prometheus `/metrics`, OTLP-экспорт, 22 инструмента агента. |
18
+ | 1.2.1 | 13.11.2026 | Одноразовые запуски (`runAt` / `delaySeconds`), непрерывность сессий (`new` / `reuse` / `last`, `sessionMaxRuns`), TUI-панель с логами и клавиатурной навигацией, SVG-граф DAG и светлая тема в дашборде, `partial` отдельно от `error`. |
19
+ | 1.2.2 | 13.11.2026 | Кроссплатформенный дашборд: снятие зомби-процесса на macOS/Linux (`lsof`, `ss`), ожидание освобождения порта после SIGKILL, платформо-независимый тест заголовка. |
20
+ | 1.2.3 | 13.11.2026 | Документация и дистрибуция: установка через `plugins` и `opencode plugin add` (ключ `plugin` устарел), FAQ, английский README для npm, русский README в `docs/README.ru.md`, расширенные описание и keywords пакета. |
21
+ | 1.3.0 | 14.11.2026 | Уведомления: Telegram Bot API (HTML / MarkdownV2 / Markdown, тема форума, ссылка на дашборд), нативные toast на Windows / macOS / Linux без внешних зависимостей, тихие часы, стоимость и токены в сообщениях, тестовая отправка по выбранному каналу. |
60
22
 
61
- **По факту:** все пять пунктов реализованы (отчёт: `SPRINT19.md`).
23
+ ---
62
24
 
63
- 1. `timezone` на задачу (IANA) — корректный пересчёт cron в этом поясе, DST-безопасный `nextRun`/`prevRun`, для зоны ≠ системной задача уходит в poll-режим (`MINUTE /mo 1` + gate в обёртке); следующий запуск тоже считается в dry-run (`scheduleDetails.nextRuns`).
64
- 2. Окна запуска `notBefore`/`notAfter` (HH:MM, можно через полночь) — запуск переносится на открытие окна, не пропускается (postpone в `schedule-gate` с dedup через defer-файл).
65
- 3. Расширенный cron: `@every 15m|2h|1d`, `L` (последний день месяца), `d#n` (N-й день недели, например `FRI#3`), имена месяцев/дней недели, диапазоны и списки со шагами.
66
- 4. Пауза до даты `pausedUntil` — `pause_task(name, until?)` сохраняет ISO-момент в определении задачи; плагин возобновляет задачи автоматически при старте и по таймеру каждые 5 мин, `resume_task` снимает паузу досрочно.
67
- 5. Тесты: `test-schedule-v2.mjs` (50 проверок: парсер, nextRun/prevRun, DST Берлин весна/осень, окна incl. через полночь, CLI-шлюз exit-коды) — в цепочке `npm test`.
25
+ ## Ближайшие спринты
68
26
 
69
- ## Спринт 20 — Уведомления v2 ✅ Готово
27
+ Порядок отражает приоритет: сначала то, что мешает пользователям каждый день, затем переход к CI/CD-оркестрации.
70
28
 
71
- **По факту:** все пять пунктов реализованы (отчёт: `SPRINT20.md`).
29
+ ### Спринт 26 — Секреты и аудит (P1)
72
30
 
73
- 1. Дайджест: ежедневный (`daily`) или еженедельный (`weekly`, с догоняющей отправкой после понедельника) — запуски, success rate, стоимость, токены и топ ошибок; планировщик проверяет раз в минуту, есть RPC `send_digest` и кнопка «📊 Отправить дайджест сейчас» (ручная отправка расписание не сдвигает).
74
- 2. Уведомления матриц: успех, `partial` и «все клоны упали» после агрегата; детектор зависших клонов (`matrix.stuckAfterMinutes`, дефолт 60, 0 — выкл.) уведомляет один раз на запуск.
75
- 3. Шаблоны `templates.success`/`templates.error` с плейсхолдерами `{task} {status} {duration} {error} {emoji}` и фильтры `filters.include`/`exclude` (маски `*`, исключения важнее включений).
76
- 4. Webhook: `timeoutMs` (дефолт 10 000), `retryCount` (дефолт 2) и `retryDelayMs` (дефолт 1000), ретраи на сеть/таймаут/5xx/429 с экспоненциальным backoff до 30 с, прочие 4xx без повторов.
77
- 5. **ntfy.sh не реализован** (исключён заданием), каналы: webhook + тосты. Тесты: `test-notifications-v2.mjs` (44 проверки) — в цепочке `npm test`.
31
+ - Secrets management: Windows Credential Manager / macOS Keychain / Linux Secret Service (keytar) или внешний Vault; подстановка в env задачи, маскирование в логах, истории и экспорте.
32
+ - Audit log: кто создал / изменил / запустил / удалил задачу, когда и через какой интерфейс (агент, GUI, HTTP); поверх structured-log, с ротацией.
33
+ - **Готово, когда:** секреты не хранятся в открытом виде, экспорт их не раскрывает, аудит покрывает все мутации задач и проверен тестом.
78
34
 
79
- ## Спринт 21 — Мультипроектность ✅ Готово
35
+ ### Спринт 27 — Git-триггеры и условия запуска (P2)
80
36
 
81
- 1. Профили (`default`, `work`, …): отдельные БД/настройки/дашборд-порт.
82
- 2. Группировка задач по проекту в GUI/дашборде, переключение профиля.
83
- 3. Env-переменные на workspace (`.env`-файл или пары ключ-значение) с маскировкой секретов в логах.
84
- 4. Тесты: `test-profiles.mjs`, `test-env.mjs`.
37
+ - Git-триггер: запуск только при новых коммитах (`HEAD` против последнего запуска), фильтр по ветке и путям (`git diff --name-only`).
38
+ - Glob-маски и ignore-списки для файловых триггеров (сейчас `watchPath` — конкретный файл или папка).
39
+ - Временные окна: «только 09:00–19:00 по будням» и поведение вне окна (skip / перенести / выполнить).
40
+ - **Готово, когда:** триггеры настраиваются через `schedule_task` и GUI, dry-run показывает причину пропуска, есть тест на git- и glob-сценарии.
85
41
 
86
- ## Спринт 22 — Интеграции и наблюдаемость ✅ Готово
42
+ ### Спринт 28 — Pipeline-as-code (P2)
87
43
 
88
- **По факту:** все четыре пункта реализованы, включая опциональный OTLP-экспорт (отчёт: `SPRINT22.md`).
44
+ - `opencode.pipeline.yaml` в репозитории: versioned, reviewable, без новых зависимостей (парсер YAML — или JSON-совместимый подформат).
45
+ - CLI `opencode pipeline validate|run|export`: проверка, запуск, экспорт в JSON задач плагина.
46
+ - Импорт/экспорт пайплайна, конфликты с задачами из GUI — в лог и историю.
47
+ - **Готово, когда:** пайплайн из репозитория запускается одной командой, DAG и матрицы описываются в файле, спецификация покрыта тестом и документацией.
89
48
 
90
- 1. Входящий webhook-триггер: `POST /api/hooks/:task?token=…` с HMAC-SHA256 по сырому телу; заголовки `X-Scheduler-Signature`, `X-Hub-Signature-256` (GitHub), `X-Gitlab-Token`; опциональная проверка timestamp. Канал выключен по умолчанию, token/secret генерируются при включении.
91
- 2. Structured logs: JSONL `<PLUGIN_DIR>/logs/runs.jsonl` с событиями `run.started` / `run.finished` / `hook.received`, ротация 10 МБ и `GET /api/logs` с фильтрами `task`, `status`, `event`, `since`, `until`, `limit` (+ `format=jsonl`).
92
- 3. Prometheus: `GET /metrics` — запуски, ошибки, токены, стоимость, histogram длительности, глубина очереди и объём истории.
93
- 4. OpenTelemetry: `GET /api/history/export?format=otlp` — OTLP/JSON со стабильными traceId/spanId на каждый запуск.
49
+ ### Спринт 29 — Docker runner (P2)
94
50
 
95
- Тесты: `test-integrations.mjs` (116 проверок) — в цепочке `npm test`.
51
+ - Runner abstraction: локальный процесс (сейчас), Docker, SSH-хост. Задача описывает *что* делать, runner — *где*.
52
+ - Docker: образ, монтирование workspace, лимиты CPU/RAM, сеть on/off; по умолчанию выключен.
53
+ - Интеграция, а не собственный sandbox: Docker / Landstrip вместо изобретения изоляции.
54
+ - **Готово, когда:** задача выполняется в контейнере с теми же хуками, Quality Gate, историей и метриками, что и локально.
96
55
 
97
- ## Спринт 23 — One-shot расписание ✅ Готово
56
+ ### Спринт 30 — Метрики v2 (P3)
98
57
 
99
- **По факту:** разовые задачи реализованы (отчёт: `SPRINT23.md`).
58
+ - Token efficiency score: успешные запуски на потраченные токены, отдельно успех и ошибки, по задачам и моделям.
59
+ - Cost forecasting: скользящее среднее, тренд, бюджет на день/неделю с алертом.
60
+ - Готовый Grafana dashboard JSON + инструкция (Prometheus и OTLP уже есть).
100
61
 
101
- 1. `triggerType: "once"`: `runAt` (ISO-8601, локальная дата допускается) либо `delaySeconds`; `schedule` не нужен. Задаётся через `schedule_task`, `update_task`, RPC `create_task` / `update_task`, импорт задач и GUI/дашборд.
102
- 2. Нативная регистрация: Windows `/sc ONCE` с датой и временем, Linux `at -t`, macOS `StartCalendarInterval` + cleanup wrapper после запуска. Повторный запуск после рестарта плагина не создаётся.
103
- 3. Export/import: `runAt` сохраняется в JSON, старые пакеты без него импортируются как раньше; матрица с one-shot отклоняется.
104
- 4. Dry-run: для once `trigger: "once"`, `scheduleDetails.nextRuns = [runAt]`; GUI/дашборд показывают «Разово» и запланированное время.
62
+ ### Спринт 31 — Локализация документации (P3)
105
63
 
106
- Тесты: `test-one-shot.mjs` (41 проверка) — в цепочке `npm test`.
64
+ - `docs/README.zh.md` и `docs/README.es.md`, синхронизированные с английским.
65
+ - Переводы обновляются вместе с релизом; PR-шаблон для сообщества.
107
66
 
108
- ## Спринт 24 — Session continuity ✅ Готово
67
+ ---
109
68
 
110
- **По факту:** непрерывность сессий реализована (отчёт: `SPRINT24.md`).
69
+ ## Идеи без спринта
111
70
 
112
- 1. `session`: `new` (по умолчанию — свежая сессия на каждый запуск), `reuse` (постоянная сессия задачи, `--session <sessionId>`), `last` (`--continue`). `sessionId` генерируется автоматически, пользователем не принимается и не экспортируется.
113
- 2. `sessionMaxRuns` (только для `reuse`): после N запусков сессия удаляется (`opencode session delete`), счётчик сбрасывается, следующая сессия — новая. `sessionRunCount` — внутреннее поле, не экспортируется.
114
- 3. Export/import: `session`, `sessionId` (reuse) и `sessionMaxRuns` сохраняются; старые пакеты без этих полей импортируются как `new`; `sessionRunCount` не экспортируется никогда.
115
- 4. GUI/дашборд: селектор режима и бейджи (⟳ сессия / ↪ продолжение); dry-run показывает режим и sessionId для reuse.
71
+ - **Guard-условия**: shell-команда, ненулевой код = пропуск запуска, статус `skipped` в истории.
72
+ - **Worktree-изоляция**: одноразовый `git worktree` на запуск, политика очистки, защита незакоммиченных изменений.
73
+ - **Approvals и окружения**: ручное подтверждение перед деплоем, dev / staging / prod, артефакты запусков.
74
+ - **Remote runners**: агент на удалённой машине, центральный дашборд, очередь и конкурентность на кластере.
75
+ - **Экспорт в CI**: адаптеры GitHub Actions и GitLab CI из pipeline-as-code (не наоборот).
76
+ - **Библиотека рецептов**: встроенные шаблоны (`nightly-refactor`, `dependency-audit`, `doc-sync`, `coverage-report`) + `manage_templates action=install`.
77
+ - **DAG в GUI**: клик по узлу → карточка задачи, zoom/pan, подсветка пути, дорожка матричных клонов.
78
+ - **Per-task permissions**: строгая реализация `allowedTools` / `deniedTools` (сейчас они advisory — см. `docs/FEATURES.md`).
79
+ - **Нативный scheduler OpenCode**: режим `nativeScheduler: auto|on|off` вместо рекомендации отключать `experimental.schedules`.
80
+ - **Имя и позиционирование**: алиас `opencode-pipeline` для 2.0, чтобы название не ограничивало кроссплатформенность.
116
81
 
117
- Тесты: `test-session-continuity.mjs` (50 проверок) — в цепочке `npm test`.
82
+ ---
118
83
 
119
- ## Правила спринта (не меняются)
84
+ ## Правила разработки
120
85
 
121
- - Без новых зависимостей, Node 24, `npm run build` + `npm run build:gui` обязательны.
122
- - Каждый спринт: новый `test-*.mjs` в цепочку `npm test`, отчёт `SPRINT<n>.md`.
123
- - Обратная совместимость: старые `tasks.json`/экспорт читаются без миграции пользователем.
86
+ - Node.js 20+ (`engines`), CI — Node 24 на Windows, macOS и Linux.
87
+ - Обязательны `npm run build` и `npm run build:gui`; `npm test` включает 26 сюит, включая `test-docs.mjs`.
88
+ - Новые runtime-зависимости — только с обоснованием; предпочтение optional dependencies и нативным командам ОС.
89
+ - Обратная совместимость: старые `tasks.json` и экспорт читаются без миграции пользователем.
90
+ - Каждый релиз обновляет CHANGELOG, README (EN + RU) и `docs/`; устаревшие отчёты спринтов не хранятся в корне — история живёт здесь и в CHANGELOG.
@@ -0,0 +1,36 @@
1
+ export interface NativeNotificationMessage {
2
+ /** Заголовок; по умолчанию «OpenCode Scheduler». */
3
+ title?: string;
4
+ /** Текст уведомления. */
5
+ body: string;
6
+ /** Со звуком, если платформа поддерживает. */
7
+ sound?: boolean;
8
+ }
9
+ /** Готовая команда запуска — удобно проверять в тестах. */
10
+ export interface NativeCommand {
11
+ command: string;
12
+ args: string[];
13
+ env?: Record<string, string>;
14
+ }
15
+ /**
16
+ * Собирает команду нативного уведомления для платформы.
17
+ * Чистая функция: ничего не запускает.
18
+ */
19
+ export declare function buildNativeNotificationCommand(platform: NodeJS.Platform, message: NativeNotificationMessage): NativeCommand;
20
+ export interface SendNativeOptions {
21
+ /** Подмена платформы для тестов. */
22
+ platform?: NodeJS.Platform;
23
+ /** Подмена запуска процесса для тестов. */
24
+ exec?: (command: string, args: string[], env: NodeJS.ProcessEnv) => Promise<void>;
25
+ /** Таймаут процесса в мс. */
26
+ timeoutMs?: number;
27
+ }
28
+ export interface NativeSendResult {
29
+ success: boolean;
30
+ error?: string;
31
+ }
32
+ /**
33
+ * Показывает нативное уведомление. Никогда не бросает исключение.
34
+ */
35
+ export declare function sendNativeNotification(message: NativeNotificationMessage, options?: SendNativeOptions): Promise<NativeSendResult>;
36
+ //# sourceMappingURL=native-notify.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"native-notify.d.ts","sourceRoot":"","sources":["../../src/core/native-notify.ts"],"names":[],"mappings":"AAgBA,MAAM,WAAW,yBAAyB;IACxC,oDAAoD;IACpD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,yBAAyB;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,8CAA8C;IAC9C,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,2DAA2D;AAC3D,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC9B;AAkBD;;;GAGG;AACH,wBAAgB,8BAA8B,CAC5C,QAAQ,EAAE,MAAM,CAAC,QAAQ,EACzB,OAAO,EAAE,yBAAyB,GACjC,aAAa,CAoDf;AAED,MAAM,WAAW,iBAAiB;IAChC,oCAAoC;IACpC,QAAQ,CAAC,EAAE,MAAM,CAAC,QAAQ,CAAC;IAC3B,2CAA2C;IAC3C,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,GAAG,EAAE,MAAM,CAAC,UAAU,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAClF,6BAA6B;IAC7B,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,wBAAsB,sBAAsB,CAC1C,OAAO,EAAE,yBAAyB,EAClC,OAAO,GAAE,iBAAsB,GAC9B,OAAO,CAAC,gBAAgB,CAAC,CAwB3B"}
@@ -0,0 +1,110 @@
1
+ /**
2
+ * Нативные уведомления ОС (Спринт 25).
3
+ *
4
+ * Windows — Toast через PowerShell/WinRT, macOS — Notification Center через
5
+ * osascript, Linux — notify-send (libnotify). Внешних зависимостей нет:
6
+ * node-notifier не требуется. Все ошибки проглатываются намеренно —
7
+ * уведомление не должно ломать задачу.
8
+ */
9
+ import { execFile } from "node:child_process";
10
+ import { promisify } from "node:util";
11
+ const execFileAsync = promisify(execFile);
12
+ /** Таймаут запуска процесса уведомления. */
13
+ const DEFAULT_TIMEOUT_MS = 15000;
14
+ /** Скрипт Windows Toast: текст передаётся через env, чтобы не экранировать кавычки. */
15
+ const WINDOWS_TOAST_SCRIPT = `
16
+ $ErrorActionPreference = 'Stop'
17
+ $title = [System.Security.SecurityElement]::Escape($env:OCS_NOTIFY_TITLE)
18
+ $body = [System.Security.SecurityElement]::Escape($env:OCS_NOTIFY_BODY)
19
+ $silent = if ($env:OCS_NOTIFY_SOUND -eq '1') { '' } else { '<audio silent="true"/>' }
20
+ $xml = '<toast><visual><binding template="ToastGeneric"><text>' + $title + '</text><text>' + $body + '</text></binding></visual>' + $silent + '</toast>'
21
+ [Windows.UI.Notifications.ToastNotificationManager, Windows.UI.Notifications, ContentType=WindowsRuntime] > $null
22
+ [Windows.Data.Xml.Dom.XmlDocument, Windows.Data.Xml.Dom.XmlDocument, ContentType=WindowsRuntime] > $null
23
+ $doc = [Windows.Data.Xml.Dom.XmlDocument]::new()
24
+ $doc.LoadXml($xml)
25
+ $toast = [Windows.UI.Notifications.ToastNotification]::new($doc)
26
+ $appId = '{1AC14E77-02E7-4E5D-B744-2EB1AE5198B7}\\WindowsPowerShell\\v1.0\\powershell.exe'
27
+ [Windows.UI.Notifications.ToastNotificationManager]::CreateToastNotifier($appId).Show($toast)
28
+ `.trim();
29
+ /**
30
+ * Собирает команду нативного уведомления для платформы.
31
+ * Чистая функция: ничего не запускает.
32
+ */
33
+ export function buildNativeNotificationCommand(platform, message) {
34
+ const title = (message.title ?? "OpenCode Scheduler").trim() || "OpenCode Scheduler";
35
+ const body = String(message.body ?? "");
36
+ const sound = message.sound !== false;
37
+ if (platform === "win32") {
38
+ return {
39
+ command: "powershell.exe",
40
+ args: [
41
+ "-NoProfile",
42
+ "-NonInteractive",
43
+ "-ExecutionPolicy",
44
+ "Bypass",
45
+ "-Command",
46
+ WINDOWS_TOAST_SCRIPT,
47
+ ],
48
+ env: {
49
+ OCS_NOTIFY_TITLE: title,
50
+ OCS_NOTIFY_BODY: body,
51
+ OCS_NOTIFY_SOUND: sound ? "1" : "0",
52
+ },
53
+ };
54
+ }
55
+ if (platform === "darwin") {
56
+ const script = 'display notification (system attribute "OCS_NOTIFY_BODY") ' +
57
+ 'with title (system attribute "OCS_NOTIFY_TITLE")' +
58
+ (sound ? ' sound name "Glass"' : "");
59
+ return {
60
+ command: "osascript",
61
+ args: ["-e", script],
62
+ env: {
63
+ OCS_NOTIFY_TITLE: title,
64
+ OCS_NOTIFY_BODY: body,
65
+ },
66
+ };
67
+ }
68
+ return {
69
+ command: "notify-send",
70
+ args: [
71
+ "-a",
72
+ "OpenCode Scheduler",
73
+ "-u",
74
+ "normal",
75
+ "-i",
76
+ "dialog-information",
77
+ title,
78
+ body,
79
+ ],
80
+ };
81
+ }
82
+ /**
83
+ * Показывает нативное уведомление. Никогда не бросает исключение.
84
+ */
85
+ export async function sendNativeNotification(message, options = {}) {
86
+ const platform = options.platform ?? process.platform;
87
+ const command = buildNativeNotificationCommand(platform, message);
88
+ const env = { ...process.env, ...(command.env ?? {}) };
89
+ const timeoutMs = Math.max(1000, Math.floor(options.timeoutMs ?? DEFAULT_TIMEOUT_MS));
90
+ try {
91
+ if (options.exec) {
92
+ await options.exec(command.command, command.args, env);
93
+ }
94
+ else {
95
+ await execFileAsync(command.command, command.args, {
96
+ env,
97
+ timeout: timeoutMs,
98
+ windowsHide: true,
99
+ maxBuffer: 1024 * 1024,
100
+ });
101
+ }
102
+ return { success: true };
103
+ }
104
+ catch (err) {
105
+ return {
106
+ success: false,
107
+ error: err instanceof Error ? err.message : String(err),
108
+ };
109
+ }
110
+ }
@@ -252,7 +252,7 @@ async function main() {
252
252
  console.error(`[windows-scheduler] record-history: запись #${runId} уже завершена или не найдена.`);
253
253
  return;
254
254
  }
255
- await handleCompletion(taskName, st, chainTarget, error, durationMs);
255
+ await handleCompletion(taskName, st, chainTarget, error, durationMs, tokens, costUsd);
256
256
  return;
257
257
  }
258
258
  // Обратная совместимость: старый режим без --start.
@@ -279,16 +279,16 @@ async function main() {
279
279
  ? definition?.nextTaskOnSuccess || null
280
280
  : definition?.nextTaskOnError || null;
281
281
  recordRun(taskName, st, startedAt, durationMs, error, chainTarget, tokens, costUsd, model, preFlightStatus, postFlightStatus, new Date().toISOString(), definition?.workspaceId ?? null, definition?.allowedTools ?? null, definition?.deniedTools ?? null);
282
- await handleCompletion(taskName, st, chainTarget, error, durationMs);
282
+ await handleCompletion(taskName, st, chainTarget, error, durationMs, tokens, costUsd);
283
283
  }
284
284
  /**
285
285
  * Общая пост-обработка завершённого запуска: уведомление, цепочки задач,
286
286
  * DAG-зависимости и повторы. Используется и legacy-режимом, и --finish.
287
287
  */
288
- async function handleCompletion(taskName, st, chainTarget, error, durationMs) {
288
+ async function handleCompletion(taskName, st, chainTarget, error, durationMs, tokens, costUsd) {
289
289
  // Уведомление о завершении (webhook). Ошибки отправки логируются внутри
290
290
  // и не влияют на историю, цепочки и повторы.
291
- await notifyTaskCompletion(taskName, st, durationMs, error);
291
+ await notifyTaskCompletion(taskName, st, durationMs, error, tokens, costUsd);
292
292
  // Matrix (Спринт 15): клон завершился — двигаем sequential-цепочку или
293
293
  // очередь concurrency-лимита (Спринт 17), а когда все клоны готовы —
294
294
  // фиксируем агрегат и запускаем matrix-complete.
@@ -0,0 +1,45 @@
1
+ /**
2
+ * Telegram Bot API: отправка уведомлений (Спринт 25).
3
+ *
4
+ * Модуль намеренно не зависит от настроек и сетевого слоя приложения:
5
+ * всё, что нужно, передаётся аргументами. Это позволяет тестировать
6
+ * экранирование и сборку запроса без реальных вызовов Telegram.
7
+ */
8
+ export type TelegramParseMode = "" | "HTML" | "Markdown" | "MarkdownV2";
9
+ export interface TelegramSendOptions {
10
+ /** База API; по умолчанию https://api.telegram.org. */
11
+ apiBase?: string;
12
+ /** Разметка; пусто — plain text. */
13
+ parseMode?: TelegramParseMode;
14
+ /** Отправить без звука. */
15
+ disableNotification?: boolean;
16
+ /** ID темы форума, если указан. */
17
+ messageThreadId?: number | null;
18
+ /** Добавить ссылку на дашборд. */
19
+ includeDashboardLink?: boolean;
20
+ /** URL дашборда; null/пусто — ссылка не добавляется. */
21
+ dashboardUrl?: string | null;
22
+ /** Таймаут запроса в мс. */
23
+ timeoutMs?: number;
24
+ /** Подмена fetch для тестов. */
25
+ fetchImpl?: typeof fetch;
26
+ }
27
+ /** Экранирует текст под выбранный parse_mode. */
28
+ export declare function escapeTelegramText(text: string, parseMode?: TelegramParseMode): string;
29
+ /**
30
+ * Готовит текст сообщения: экранирует пользовательские данные и добавляет
31
+ * ссылку на дашборд в разметке выбранного режима.
32
+ */
33
+ export declare function formatTelegramText(text: string, parseMode?: TelegramParseMode, dashboardUrl?: string | null): string;
34
+ /** Проверяет формат токена бота; возвращает trimmed-значение. */
35
+ export declare function validateTelegramToken(token: string): string;
36
+ /** Маскирует токен для сообщений об ошибках и логов. */
37
+ export declare function maskTelegramToken(token: string): string;
38
+ /**
39
+ * Отправляет сообщение через Bot API `sendMessage`.
40
+ *
41
+ * Бросает Error с безопасным текстом (токен замаскирован). Вызывающий код
42
+ * обязан перехватить ошибку, чтобы уведомление не ломало задачу.
43
+ */
44
+ export declare function sendTelegramMessage(token: string, chatId: string, text: string, options?: TelegramSendOptions): Promise<void>;
45
+ //# sourceMappingURL=telegram.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"telegram.d.ts","sourceRoot":"","sources":["../../src/core/telegram.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,MAAM,MAAM,iBAAiB,GAAG,EAAE,GAAG,MAAM,GAAG,UAAU,GAAG,YAAY,CAAC;AAKxE,MAAM,WAAW,mBAAmB;IAClC,uDAAuD;IACvD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,oCAAoC;IACpC,SAAS,CAAC,EAAE,iBAAiB,CAAC;IAC9B,2BAA2B;IAC3B,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B,mCAAmC;IACnC,eAAe,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,kCAAkC;IAClC,oBAAoB,CAAC,EAAE,OAAO,CAAC;IAC/B,wDAAwD;IACxD,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,4BAA4B;IAC5B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,gCAAgC;IAChC,SAAS,CAAC,EAAE,OAAO,KAAK,CAAC;CAC1B;AAED,iDAAiD;AACjD,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,MAAM,EACZ,SAAS,GAAE,iBAAsB,GAChC,MAAM,CAeR;AAYD;;;GAGG;AACH,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,MAAM,EACZ,SAAS,GAAE,iBAAsB,EACjC,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,GAC3B,MAAM,CAiBR;AAED,iEAAiE;AACjE,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAW3D;AAED,wDAAwD;AACxD,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CASvD;AAsBD;;;;;GAKG;AACH,wBAAsB,mBAAmB,CACvC,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,EACZ,OAAO,GAAE,mBAAwB,GAChC,OAAO,CAAC,IAAI,CAAC,CAwEf"}
@@ -0,0 +1,160 @@
1
+ /** Таймаут запроса по умолчанию. */
2
+ const DEFAULT_TIMEOUT_MS = 10000;
3
+ /** Экранирует текст под выбранный parse_mode. */
4
+ export function escapeTelegramText(text, parseMode = "") {
5
+ const value = String(text ?? "");
6
+ if (parseMode === "HTML") {
7
+ return value
8
+ .replace(/&/g, "&amp;")
9
+ .replace(/</g, "&lt;")
10
+ .replace(/>/g, "&gt;");
11
+ }
12
+ if (parseMode === "MarkdownV2") {
13
+ return value.replace(/([\\_*[\]()~`>#+\-=|{}.!])/g, "\\$1");
14
+ }
15
+ if (parseMode === "Markdown") {
16
+ return value.replace(/([\\_*[\]`])/g, "\\$1");
17
+ }
18
+ return value;
19
+ }
20
+ /** Экранирует URL для HTML-атрибута. */
21
+ function escapeHtmlAttribute(url) {
22
+ return url
23
+ .replace(/&/g, "&amp;")
24
+ .replace(/</g, "&lt;")
25
+ .replace(/>/g, "&gt;")
26
+ .replace(/"/g, "&quot;")
27
+ .replace(/'/g, "&#39;");
28
+ }
29
+ /**
30
+ * Готовит текст сообщения: экранирует пользовательские данные и добавляет
31
+ * ссылку на дашборд в разметке выбранного режима.
32
+ */
33
+ export function formatTelegramText(text, parseMode = "", dashboardUrl) {
34
+ const body = escapeTelegramText(text, parseMode);
35
+ const url = (dashboardUrl ?? "").trim();
36
+ if (!url)
37
+ return body;
38
+ if (parseMode === "HTML") {
39
+ return `${body}\n\n<a href="${escapeHtmlAttribute(url)}">📊 Открыть дашборд</a>`;
40
+ }
41
+ if (parseMode === "MarkdownV2") {
42
+ const escapedUrl = url.replace(/[)\\]/g, "\\$&");
43
+ return `${body}\n\n[📊 Открыть дашборд](${escapedUrl})`;
44
+ }
45
+ if (parseMode === "Markdown") {
46
+ const escapedUrl = url.replace(/[)]/g, "\\)");
47
+ return `${body}\n\n[📊 Открыть дашборд](${escapedUrl})`;
48
+ }
49
+ return `${body}\n\n📊 Открыть дашборд: ${url}`;
50
+ }
51
+ /** Проверяет формат токена бота; возвращает trimmed-значение. */
52
+ export function validateTelegramToken(token) {
53
+ const value = (token ?? "").trim();
54
+ if (!value) {
55
+ throw new Error("Не задан токен Telegram-бота.");
56
+ }
57
+ // Формат BotFather: <digits>:<base64-ish>. Проверяем достаточно мягко,
58
+ // чтобы не ломать тестовые токены, но отсекать явный мусор.
59
+ if (!/^\d+:[A-Za-z0-9_-]{5,}$/.test(value)) {
60
+ throw new Error("Некорректный токен Telegram-бота.");
61
+ }
62
+ return value;
63
+ }
64
+ /** Маскирует токен для сообщений об ошибках и логов. */
65
+ export function maskTelegramToken(token) {
66
+ const value = (token ?? "").trim();
67
+ if (!value)
68
+ return "***";
69
+ const colon = value.indexOf(":");
70
+ if (colon <= 0)
71
+ return "***";
72
+ const id = value.slice(0, colon);
73
+ const secret = value.slice(colon + 1);
74
+ const tail = secret.length >= 4 ? secret.slice(-4) : "";
75
+ return `${id}:***${tail}`;
76
+ }
77
+ /** Убирает токен из произвольного текста ошибки. */
78
+ function sanitizeErrorText(text, token) {
79
+ if (!text)
80
+ return text;
81
+ return text.split(token).join(maskTelegramToken(token));
82
+ }
83
+ function resolveApiBase(apiBase) {
84
+ const value = (apiBase ?? "https://api.telegram.org").trim().replace(/\/+$/, "");
85
+ let parsed;
86
+ try {
87
+ parsed = new URL(value);
88
+ }
89
+ catch {
90
+ throw new Error("Некорректный адрес Telegram API.");
91
+ }
92
+ if (parsed.protocol !== "http:" && parsed.protocol !== "https:") {
93
+ throw new Error("Telegram API поддерживает только http:// или https://.");
94
+ }
95
+ return value;
96
+ }
97
+ /**
98
+ * Отправляет сообщение через Bot API `sendMessage`.
99
+ *
100
+ * Бросает Error с безопасным текстом (токен замаскирован). Вызывающий код
101
+ * обязан перехватить ошибку, чтобы уведомление не ломало задачу.
102
+ */
103
+ export async function sendTelegramMessage(token, chatId, text, options = {}) {
104
+ const safeToken = validateTelegramToken(token);
105
+ const target = (chatId ?? "").trim();
106
+ if (!target) {
107
+ throw new Error("Не задан chat_id Telegram.");
108
+ }
109
+ const apiBase = resolveApiBase(options.apiBase);
110
+ const parseMode = options.parseMode ?? "";
111
+ const body = {
112
+ chat_id: target,
113
+ text: formatTelegramText(text, parseMode, options.includeDashboardLink === false ? null : options.dashboardUrl),
114
+ };
115
+ if (parseMode)
116
+ body.parse_mode = parseMode;
117
+ if (options.disableNotification)
118
+ body.disable_notification = true;
119
+ if (typeof options.messageThreadId === "number" &&
120
+ Number.isFinite(options.messageThreadId) &&
121
+ options.messageThreadId > 0) {
122
+ body.message_thread_id = Math.floor(options.messageThreadId);
123
+ }
124
+ const timeoutMs = Math.max(1000, Math.floor(options.timeoutMs ?? DEFAULT_TIMEOUT_MS));
125
+ const fetchImpl = options.fetchImpl ?? fetch;
126
+ const controller = new AbortController();
127
+ const timer = setTimeout(() => controller.abort(), timeoutMs);
128
+ try {
129
+ const response = await fetchImpl(`${apiBase}/bot${safeToken}/sendMessage`, {
130
+ method: "POST",
131
+ headers: { "Content-Type": "application/json" },
132
+ body: JSON.stringify(body),
133
+ signal: controller.signal,
134
+ });
135
+ const raw = await response.text().catch(() => "");
136
+ let parsed = null;
137
+ try {
138
+ parsed = raw ? JSON.parse(raw) : null;
139
+ }
140
+ catch {
141
+ parsed = null;
142
+ }
143
+ if (!response.ok || parsed?.ok === false) {
144
+ const description = (typeof parsed?.description === "string" && parsed.description) ||
145
+ raw.slice(0, 200) ||
146
+ `HTTP ${response.status}`;
147
+ throw new Error(`Telegram API: ${sanitizeErrorText(description, safeToken)}`);
148
+ }
149
+ }
150
+ catch (err) {
151
+ if (err?.name === "AbortError") {
152
+ throw new Error(`Таймаут Telegram API (${Math.floor(timeoutMs / 1000)} с).`);
153
+ }
154
+ const message = err instanceof Error ? err.message : String(err);
155
+ throw new Error(sanitizeErrorText(message, safeToken));
156
+ }
157
+ finally {
158
+ clearTimeout(timer);
159
+ }
160
+ }
package/dist/index.d.ts CHANGED
@@ -274,6 +274,12 @@ export declare const sendNotificationSchema: z.ZodObject<{
274
274
  digest: "digest";
275
275
  test: "test";
276
276
  }>;
277
+ channel: z.ZodOptional<z.ZodEnum<{
278
+ webhook: "webhook";
279
+ telegram: "telegram";
280
+ native: "native";
281
+ all: "all";
282
+ }>>;
277
283
  }, z.core.$strip>;
278
284
  /** get_dashboard_info — сведения о панели управления. */
279
285
  export declare const getDashboardInfoSchema: z.ZodObject<{}, z.core.$strip>;