opencode-windows-scheduler 1.2.3 → 1.4.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.
Files changed (58) hide show
  1. package/CHANGELOG.md +61 -2
  2. package/README.md +21 -4
  3. package/ROADMAP-STRATEGY.md +61 -159
  4. package/ROADMAP.md +60 -98
  5. package/dist/core/audit.d.ts +68 -0
  6. package/dist/core/audit.d.ts.map +1 -0
  7. package/dist/core/audit.js +206 -0
  8. package/dist/core/native-notify.d.ts +36 -0
  9. package/dist/core/native-notify.d.ts.map +1 -0
  10. package/dist/core/native-notify.js +110 -0
  11. package/dist/core/record-history.js +4 -4
  12. package/dist/core/secrets.d.ts +57 -0
  13. package/dist/core/secrets.d.ts.map +1 -0
  14. package/dist/core/secrets.js +331 -0
  15. package/dist/core/structured-log.d.ts.map +1 -1
  16. package/dist/core/structured-log.js +9 -0
  17. package/dist/core/telegram.d.ts +45 -0
  18. package/dist/core/telegram.d.ts.map +1 -0
  19. package/dist/core/telegram.js +160 -0
  20. package/dist/db/schema.d.ts +1 -1
  21. package/dist/db/schema.d.ts.map +1 -1
  22. package/dist/db/schema.js +15 -0
  23. package/dist/index.d.ts +30 -4
  24. package/dist/index.d.ts.map +1 -1
  25. package/dist/index.js +349 -22
  26. package/dist/notifications.d.ts +26 -6
  27. package/dist/notifications.d.ts.map +1 -1
  28. package/dist/notifications.js +191 -34
  29. package/dist/rpc.d.ts +400 -0
  30. package/dist/rpc.d.ts.map +1 -1
  31. package/dist/rpc.js +146 -0
  32. package/dist/server.d.ts.map +1 -1
  33. package/dist/server.js +67 -0
  34. package/dist/settings.d.ts +63 -2
  35. package/dist/settings.d.ts.map +1 -1
  36. package/dist/settings.js +126 -2
  37. package/dist/workspaces.d.ts +8 -2
  38. package/dist/workspaces.d.ts.map +1 -1
  39. package/dist/workspaces.js +21 -4
  40. package/docs/ARCHITECTURE.md +16 -6
  41. package/docs/FEATURES.md +57 -12
  42. package/docs/README.ru.md +23 -4
  43. package/gui-experimental.cjs +4 -4
  44. package/package.json +5 -2
  45. package/src/core/audit.ts +291 -0
  46. package/src/core/native-notify.ts +154 -0
  47. package/src/core/record-history.ts +6 -4
  48. package/src/core/secrets.ts +385 -0
  49. package/src/core/structured-log.ts +9 -0
  50. package/src/core/telegram.ts +219 -0
  51. package/src/db/schema.ts +15 -0
  52. package/src/gui.tsx +543 -6
  53. package/src/index.ts +459 -22
  54. package/src/notifications.ts +232 -40
  55. package/src/rpc.ts +157 -0
  56. package/src/server.ts +67 -0
  57. package/src/settings.ts +213 -4
  58. package/src/workspaces.ts +22 -4
package/ROADMAP.md CHANGED
@@ -1,123 +1,85 @@
1
1
  # 🗺️ Roadmap — opencode-windows-scheduler
2
2
 
3
- План развития плагина. Тактический спринт-план; стратегические приоритеты — в [ROADMAP-STRATEGY.md](./ROADMAP-STRATEGY.md).
3
+ Текущая версия: **1.4.0** (14.11.2026). Плагин опубликован в npm, CI зелёный на Windows / macOS / Linux, 22 инструмента агента, 29 тестовых сюит.
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` зелёный.
47
-
48
- **Ограничения на потом:** история удалённых при синхронизации клонов остаётся (чистится ретеншном — Спринт 18).
11
+ ## История релизов
49
12
 
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 ✅ Готово
60
-
61
- **По факту:** все пять пунктов реализованы (отчёт: `SPRINT19.md`).
62
-
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`.
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 без внешних зависимостей, тихие часы, стоимость и токены в сообщениях, тестовая отправка по выбранному каналу. |
22
+ | 1.4.0 | 14.11.2026 | Секреты и аудит: зашифрованное хранилище (AES-256-GCM, secrets.key 0600) с ссылками ${secret:NAME}, маскирование в логах и истории, журнал аудита (audit_log в SQLite, ротация 90 дней / 10 000 записей), инструменты manage_secrets и get_audit_log, GUI-панели секретов и аудита, HTTP-аудит мутаций. |
68
23
 
69
- ## Спринт 20 — Уведомления v2 ✅ Готово
24
+ ---
70
25
 
71
- **По факту:** все пять пунктов реализованы (отчёт: `SPRINT20.md`).
26
+ ## Ближайшие спринты
72
27
 
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`.
28
+ Порядок отражает приоритет: сначала то, что мешает пользователям каждый день, затем переход к CI/CD-оркестрации.
78
29
 
79
- ## Спринт 21 — Мультипроектность ✅ Готово
30
+ ### Спринт 27 — Git-триггеры и условия запуска (P2)
80
31
 
81
- 1. Профили (`default`, `work`, …): отдельные БД/настройки/дашборд-порт.
82
- 2. Группировка задач по проекту в GUI/дашборде, переключение профиля.
83
- 3. Env-переменные на workspace (`.env`-файл или пары ключ-значение) с маскировкой секретов в логах.
84
- 4. Тесты: `test-profiles.mjs`, `test-env.mjs`.
32
+ - Git-триггер: запуск только при новых коммитах (`HEAD` против последнего запуска), фильтр по ветке и путям (`git diff --name-only`).
33
+ - Glob-маски и ignore-списки для файловых триггеров (сейчас `watchPath` — конкретный файл или папка).
34
+ - Временные окна: «только 09:00–19:00 по будням» и поведение вне окна (skip / перенести / выполнить).
35
+ - **Готово, когда:** триггеры настраиваются через `schedule_task` и GUI, dry-run показывает причину пропуска, есть тест на git- и glob-сценарии.
85
36
 
86
- ## Спринт 22 — Интеграции и наблюдаемость ✅ Готово
37
+ ### Спринт 28 — Pipeline-as-code (P2)
87
38
 
88
- **По факту:** все четыре пункта реализованы, включая опциональный OTLP-экспорт (отчёт: `SPRINT22.md`).
39
+ - `opencode.pipeline.yaml` в репозитории: versioned, reviewable, без новых зависимостей (парсер YAML — или JSON-совместимый подформат).
40
+ - CLI `opencode pipeline validate|run|export`: проверка, запуск, экспорт в JSON задач плагина.
41
+ - Импорт/экспорт пайплайна, конфликты с задачами из GUI — в лог и историю.
42
+ - **Готово, когда:** пайплайн из репозитория запускается одной командой, DAG и матрицы описываются в файле, спецификация покрыта тестом и документацией.
89
43
 
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 на каждый запуск.
44
+ ### Спринт 29 — Docker runner (P2)
94
45
 
95
- Тесты: `test-integrations.mjs` (116 проверок) — в цепочке `npm test`.
46
+ - Runner abstraction: локальный процесс (сейчас), Docker, SSH-хост. Задача описывает *что* делать, runner — *где*.
47
+ - Docker: образ, монтирование workspace, лимиты CPU/RAM, сеть on/off; по умолчанию выключен.
48
+ - Интеграция, а не собственный sandbox: Docker / Landstrip вместо изобретения изоляции.
49
+ - **Готово, когда:** задача выполняется в контейнере с теми же хуками, Quality Gate, историей и метриками, что и локально.
96
50
 
97
- ## Спринт 23 — One-shot расписание ✅ Готово
51
+ ### Спринт 30 — Метрики v2 (P3)
98
52
 
99
- **По факту:** разовые задачи реализованы (отчёт: `SPRINT23.md`).
53
+ - Token efficiency score: успешные запуски на потраченные токены, отдельно успех и ошибки, по задачам и моделям.
54
+ - Cost forecasting: скользящее среднее, тренд, бюджет на день/неделю с алертом.
55
+ - Готовый Grafana dashboard JSON + инструкция (Prometheus и OTLP уже есть).
100
56
 
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/дашборд показывают «Разово» и запланированное время.
57
+ ### Спринт 31 — Локализация документации (P3)
105
58
 
106
- Тесты: `test-one-shot.mjs` (41 проверка) — в цепочке `npm test`.
59
+ - `docs/README.zh.md` и `docs/README.es.md`, синхронизированные с английским.
60
+ - Переводы обновляются вместе с релизом; PR-шаблон для сообщества.
107
61
 
108
- ## Спринт 24 — Session continuity ✅ Готово
62
+ ---
109
63
 
110
- **По факту:** непрерывность сессий реализована (отчёт: `SPRINT24.md`).
64
+ ## Идеи без спринта
111
65
 
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.
66
+ - **Guard-условия**: shell-команда, ненулевой код = пропуск запуска, статус `skipped` в истории.
67
+ - **Worktree-изоляция**: одноразовый `git worktree` на запуск, политика очистки, защита незакоммиченных изменений.
68
+ - **Approvals и окружения**: ручное подтверждение перед деплоем, dev / staging / prod, артефакты запусков.
69
+ - **Remote runners**: агент на удалённой машине, центральный дашборд, очередь и конкурентность на кластере.
70
+ - **Экспорт в CI**: адаптеры GitHub Actions и GitLab CI из pipeline-as-code (не наоборот).
71
+ - **Библиотека рецептов**: встроенные шаблоны (`nightly-refactor`, `dependency-audit`, `doc-sync`, `coverage-report`) + `manage_templates action=install`.
72
+ - **DAG в GUI**: клик по узлу → карточка задачи, zoom/pan, подсветка пути, дорожка матричных клонов.
73
+ - **Per-task permissions**: строгая реализация `allowedTools` / `deniedTools` (сейчас они advisory — см. `docs/FEATURES.md`).
74
+ - **Нативный scheduler OpenCode**: режим `nativeScheduler: auto|on|off` вместо рекомендации отключать `experimental.schedules`.
75
+ - **Имя и позиционирование**: алиас `opencode-pipeline` для 2.0, чтобы название не ограничивало кроссплатформенность.
116
76
 
117
- Тесты: `test-session-continuity.mjs` (50 проверок) — в цепочке `npm test`.
77
+ ---
118
78
 
119
- ## Правила спринта (не меняются)
79
+ ## Правила разработки
120
80
 
121
- - Без новых зависимостей, Node 24, `npm run build` + `npm run build:gui` обязательны.
122
- - Каждый спринт: новый `test-*.mjs` в цепочку `npm test`, отчёт `SPRINT<n>.md`.
123
- - Обратная совместимость: старые `tasks.json`/экспорт читаются без миграции пользователем.
81
+ - Node.js 20+ (`engines`), CI — Node 24 на Windows, macOS и Linux.
82
+ - Обязательны `npm run build` и `npm run build:gui`; `npm test` включает 26 сюит, включая `test-docs.mjs`.
83
+ - Новые runtime-зависимости — только с обоснованием; предпочтение optional dependencies и нативным командам ОС.
84
+ - Обратная совместимость: старые `tasks.json` и экспорт читаются без миграции пользователем.
85
+ - Каждый релиз обновляет CHANGELOG, README (EN + RU) и `docs/`; устаревшие отчёты спринтов не хранятся в корне — история живёт здесь и в CHANGELOG.
@@ -0,0 +1,68 @@
1
+ /**
2
+ * Журнал аудита мутаций (Спринт 26).
3
+ *
4
+ * Фиксирует кто, когда и через какой интерфейс создал / изменил / запустил /
5
+ * удалил задачу или настройки. Записи лежат в SQLite рядом с историей, поэтому
6
+ * аудит не зависит от файловых логов и переживает перезапуск. Любая ошибка
7
+ * записи проглатывается: аудит не должен ломать основную операцию.
8
+ */
9
+ export type AuditActor = "mcp" | "gui" | "http" | "system" | string;
10
+ export interface AuditEntryInput {
11
+ action: string;
12
+ targetType?: string | null;
13
+ target?: string | null;
14
+ actor: AuditActor;
15
+ /** Конкретный инструмент / RPC-метод / HTTP-маршрут. */
16
+ source?: string | null;
17
+ details?: unknown;
18
+ remote?: string | null;
19
+ /** Время события (ISO). По умолчанию — сейчас. */
20
+ ts?: string;
21
+ }
22
+ export interface AuditRecord {
23
+ id: number;
24
+ ts: string;
25
+ action: string;
26
+ targetType: string | null;
27
+ target: string | null;
28
+ actor: string;
29
+ source: string | null;
30
+ details: unknown;
31
+ remote: string | null;
32
+ }
33
+ export interface ReadAuditFilter {
34
+ action?: string;
35
+ target?: string;
36
+ actor?: string;
37
+ since?: string;
38
+ until?: string;
39
+ limit?: number;
40
+ }
41
+ export interface ReadAuditResult {
42
+ records: AuditRecord[];
43
+ total: number;
44
+ }
45
+ export declare const DEFAULT_AUDIT_RETENTION_DAYS = 90;
46
+ export declare const DEFAULT_AUDIT_MAX_RECORDS = 10000;
47
+ /** Рекурсивно вычищает секреты из произвольной структуры details. */
48
+ export declare function redactAuditDetails(value: unknown, depth?: number): unknown;
49
+ /**
50
+ * Записывает событие аудита. Никогда не бросает исключение.
51
+ * Возвращает id записи или null при ошибке.
52
+ */
53
+ export declare function recordAudit(entry: AuditEntryInput): number | null;
54
+ /** Читает журнал аудита (новые сверху). */
55
+ export declare function readAuditLog(filter?: ReadAuditFilter): ReadAuditResult;
56
+ /**
57
+ * Удаляет старые записи и лишние сверх maxRecords.
58
+ * Возвращает количество удалённых строк.
59
+ */
60
+ export declare function cleanupAuditLog(options?: {
61
+ retentionDays?: number;
62
+ maxRecords?: number;
63
+ }): number;
64
+ /** Удаляет все записи (тесты / обслуживание). */
65
+ export declare function clearAuditLog(): void;
66
+ /** Сбрасывает троттлинг очистки (для тестов). */
67
+ export declare function resetAuditCleanupThrottle(): void;
68
+ //# sourceMappingURL=audit.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"audit.d.ts","sourceRoot":"","sources":["../../src/core/audit.ts"],"names":[],"mappings":"AAGA;;;;;;;GAOG;AAEH,MAAM,MAAM,UAAU,GAAG,KAAK,GAAG,KAAK,GAAG,MAAM,GAAG,QAAQ,GAAG,MAAM,CAAC;AAEpE,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,KAAK,EAAE,UAAU,CAAC;IAClB,wDAAwD;IACxD,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,kDAAkD;IAClD,EAAE,CAAC,EAAE,MAAM,CAAC;CACb;AAED,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;CACvB;AAED,MAAM,WAAW,eAAe;IAC9B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,WAAW,EAAE,CAAC;IACvB,KAAK,EAAE,MAAM,CAAC;CACf;AAED,eAAO,MAAM,4BAA4B,KAAK,CAAC;AAC/C,eAAO,MAAM,yBAAyB,QAAS,CAAC;AAShD,qEAAqE;AACrE,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,OAAO,EAAE,KAAK,SAAI,GAAG,OAAO,CAoBrE;AAaD;;;GAGG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,eAAe,GAAG,MAAM,GAAG,IAAI,CAiCjE;AA0CD,2CAA2C;AAC3C,wBAAgB,YAAY,CAAC,MAAM,GAAE,eAAoB,GAAG,eAAe,CA8C1E;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,OAAO,GAAE;IACvC,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,UAAU,CAAC,EAAE,MAAM,CAAC;CAChB,GAAG,MAAM,CA4Cd;AAED,iDAAiD;AACjD,wBAAgB,aAAa,IAAI,IAAI,CAMpC;AAED,iDAAiD;AACjD,wBAAgB,yBAAyB,IAAI,IAAI,CAEhD"}
@@ -0,0 +1,206 @@
1
+ import { getDb } from "../db/index.js";
2
+ import { redactSecretsInText } from "./secrets.js";
3
+ export const DEFAULT_AUDIT_RETENTION_DAYS = 90;
4
+ export const DEFAULT_AUDIT_MAX_RECORDS = 10000;
5
+ const SENSITIVE_KEY_RE = /(TOKEN|SECRET|PASS|PASSWORD|PASSWD|API_?KEY|CREDENTIAL|AUTH)/i;
6
+ const PURE_SECRET_REF_RE = /^\$\{secret:[A-Za-z0-9_.-]{1,64}\}$/;
7
+ function looksLikeSecretRef(value) {
8
+ return PURE_SECRET_REF_RE.test(value.trim());
9
+ }
10
+ /** Рекурсивно вычищает секреты из произвольной структуры details. */
11
+ export function redactAuditDetails(value, depth = 0) {
12
+ if (depth > 8)
13
+ return "[truncated]";
14
+ if (typeof value === "string")
15
+ return redactSecretsInText(value);
16
+ if (value == null || typeof value !== "object")
17
+ return value;
18
+ if (Array.isArray(value)) {
19
+ return value.slice(0, 200).map((item) => redactAuditDetails(item, depth + 1));
20
+ }
21
+ const result = {};
22
+ for (const [key, item] of Object.entries(value)) {
23
+ if (typeof item === "string" &&
24
+ SENSITIVE_KEY_RE.test(key) &&
25
+ !looksLikeSecretRef(item)) {
26
+ result[key] = "***";
27
+ }
28
+ else {
29
+ result[key] = redactAuditDetails(item, depth + 1);
30
+ }
31
+ }
32
+ return result;
33
+ }
34
+ function safeJson(value) {
35
+ if (value === undefined || value === null)
36
+ return null;
37
+ try {
38
+ return JSON.stringify(redactAuditDetails(value));
39
+ }
40
+ catch {
41
+ return null;
42
+ }
43
+ }
44
+ let lastCleanupAt = 0;
45
+ /**
46
+ * Записывает событие аудита. Никогда не бросает исключение.
47
+ * Возвращает id записи или null при ошибке.
48
+ */
49
+ export function recordAudit(entry) {
50
+ try {
51
+ const ts = entry.ts ?? new Date().toISOString();
52
+ const result = getDb()
53
+ .prepare(`INSERT INTO audit_log
54
+ (ts, action, target_type, target, actor, source, details_json, remote)
55
+ VALUES (?, ?, ?, ?, ?, ?, ?, ?)`)
56
+ .run(ts, String(entry.action || "unknown").slice(0, 128), entry.targetType == null ? null : String(entry.targetType).slice(0, 64), entry.target == null ? null : String(entry.target).slice(0, 256), String(entry.actor || "system").slice(0, 32), entry.source == null ? null : String(entry.source).slice(0, 128), safeJson(entry.details), entry.remote == null ? null : String(entry.remote).slice(0, 128));
57
+ maybeCleanup();
58
+ return Number(result.lastInsertRowid) || null;
59
+ }
60
+ catch (err) {
61
+ try {
62
+ console.warn(`[audit] не удалось записать событие: ${err instanceof Error ? err.message : String(err)}`);
63
+ }
64
+ catch {
65
+ // console недоступен — молча игнорируем.
66
+ }
67
+ return null;
68
+ }
69
+ }
70
+ /**
71
+ * Ленивая ротация: не чаще раза в час, лимиты по умолчанию. Точные лимиты из
72
+ * settings применяются в cleanupHistory / manage_settings.
73
+ */
74
+ function maybeCleanup() {
75
+ const now = Date.now();
76
+ if (now - lastCleanupAt < 60 * 60 * 1000)
77
+ return;
78
+ lastCleanupAt = now;
79
+ try {
80
+ cleanupAuditLog({
81
+ retentionDays: DEFAULT_AUDIT_RETENTION_DAYS,
82
+ maxRecords: DEFAULT_AUDIT_MAX_RECORDS,
83
+ });
84
+ }
85
+ catch {
86
+ // очистка не критична
87
+ }
88
+ }
89
+ function rowToRecord(row) {
90
+ let details = null;
91
+ if (row.details_json) {
92
+ try {
93
+ details = JSON.parse(String(row.details_json));
94
+ }
95
+ catch {
96
+ details = String(row.details_json);
97
+ }
98
+ }
99
+ return {
100
+ id: Number(row.id),
101
+ ts: String(row.ts),
102
+ action: String(row.action),
103
+ targetType: row.target_type == null ? null : String(row.target_type),
104
+ target: row.target == null ? null : String(row.target),
105
+ actor: String(row.actor ?? "system"),
106
+ source: row.source == null ? null : String(row.source),
107
+ details,
108
+ remote: row.remote == null ? null : String(row.remote),
109
+ };
110
+ }
111
+ /** Читает журнал аудита (новые сверху). */
112
+ export function readAuditLog(filter = {}) {
113
+ const limit = Math.max(1, Math.min(5000, Math.floor(filter.limit ?? 200) || 200));
114
+ const where = [];
115
+ const params = [];
116
+ if (filter.action?.trim()) {
117
+ where.push("action = ?");
118
+ params.push(filter.action.trim());
119
+ }
120
+ if (filter.target?.trim()) {
121
+ where.push("target = ?");
122
+ params.push(filter.target.trim());
123
+ }
124
+ if (filter.actor?.trim()) {
125
+ where.push("actor = ?");
126
+ params.push(filter.actor.trim());
127
+ }
128
+ if (filter.since?.trim()) {
129
+ where.push("ts >= ?");
130
+ params.push(filter.since.trim());
131
+ }
132
+ if (filter.until?.trim()) {
133
+ where.push("ts <= ?");
134
+ params.push(filter.until.trim());
135
+ }
136
+ const clause = where.length ? `WHERE ${where.join(" AND ")}` : "";
137
+ try {
138
+ const db = getDb();
139
+ const totalRow = db
140
+ .prepare(`SELECT COUNT(*) AS count FROM audit_log ${clause}`)
141
+ .get(...params);
142
+ const rows = db
143
+ .prepare(`SELECT * FROM audit_log ${clause} ORDER BY ts DESC, id DESC LIMIT ?`)
144
+ .all(...params, limit);
145
+ return { records: rows.map(rowToRecord), total: Number(totalRow?.count) || 0 };
146
+ }
147
+ catch (err) {
148
+ try {
149
+ console.warn(`[audit] не удалось прочитать журнал: ${err instanceof Error ? err.message : String(err)}`);
150
+ }
151
+ catch {
152
+ // ignore
153
+ }
154
+ return { records: [], total: 0 };
155
+ }
156
+ }
157
+ /**
158
+ * Удаляет старые записи и лишние сверх maxRecords.
159
+ * Возвращает количество удалённых строк.
160
+ */
161
+ export function cleanupAuditLog(options = {}) {
162
+ const retentionDays = Math.max(0, Math.floor(options.retentionDays ?? DEFAULT_AUDIT_RETENTION_DAYS) || 0);
163
+ const maxRecords = Math.max(100, Math.floor(options.maxRecords ?? DEFAULT_AUDIT_MAX_RECORDS) || DEFAULT_AUDIT_MAX_RECORDS);
164
+ let deleted = 0;
165
+ try {
166
+ const db = getDb();
167
+ if (retentionDays > 0) {
168
+ const cutoff = new Date(Date.now() - retentionDays * 24 * 60 * 60 * 1000).toISOString();
169
+ const result = db.prepare("DELETE FROM audit_log WHERE ts < ?").run(cutoff);
170
+ deleted += Number(result.changes) || 0;
171
+ }
172
+ const countRow = db.prepare("SELECT COUNT(*) AS count FROM audit_log").get();
173
+ const count = Number(countRow?.count) || 0;
174
+ if (count > maxRecords) {
175
+ const excess = count - maxRecords;
176
+ const result = db
177
+ .prepare(`DELETE FROM audit_log WHERE id IN (
178
+ SELECT id FROM audit_log ORDER BY ts ASC, id ASC LIMIT ?
179
+ )`)
180
+ .run(excess);
181
+ deleted += Number(result.changes) || 0;
182
+ }
183
+ }
184
+ catch (err) {
185
+ try {
186
+ console.warn(`[audit] не удалось очистить журнал: ${err instanceof Error ? err.message : String(err)}`);
187
+ }
188
+ catch {
189
+ // ignore
190
+ }
191
+ }
192
+ return deleted;
193
+ }
194
+ /** Удаляет все записи (тесты / обслуживание). */
195
+ export function clearAuditLog() {
196
+ try {
197
+ getDb().exec("DELETE FROM audit_log");
198
+ }
199
+ catch {
200
+ // ignore
201
+ }
202
+ }
203
+ /** Сбрасывает троттлинг очистки (для тестов). */
204
+ export function resetAuditCleanupThrottle() {
205
+ lastCleanupAt = 0;
206
+ }
@@ -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"}