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.
- package/CHANGELOG.md +61 -2
- package/README.md +21 -4
- package/ROADMAP-STRATEGY.md +61 -159
- package/ROADMAP.md +60 -98
- package/dist/core/audit.d.ts +68 -0
- package/dist/core/audit.d.ts.map +1 -0
- package/dist/core/audit.js +206 -0
- package/dist/core/native-notify.d.ts +36 -0
- package/dist/core/native-notify.d.ts.map +1 -0
- package/dist/core/native-notify.js +110 -0
- package/dist/core/record-history.js +4 -4
- package/dist/core/secrets.d.ts +57 -0
- package/dist/core/secrets.d.ts.map +1 -0
- package/dist/core/secrets.js +331 -0
- package/dist/core/structured-log.d.ts.map +1 -1
- package/dist/core/structured-log.js +9 -0
- package/dist/core/telegram.d.ts +45 -0
- package/dist/core/telegram.d.ts.map +1 -0
- package/dist/core/telegram.js +160 -0
- package/dist/db/schema.d.ts +1 -1
- package/dist/db/schema.d.ts.map +1 -1
- package/dist/db/schema.js +15 -0
- package/dist/index.d.ts +30 -4
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +349 -22
- package/dist/notifications.d.ts +26 -6
- package/dist/notifications.d.ts.map +1 -1
- package/dist/notifications.js +191 -34
- package/dist/rpc.d.ts +400 -0
- package/dist/rpc.d.ts.map +1 -1
- package/dist/rpc.js +146 -0
- package/dist/server.d.ts.map +1 -1
- package/dist/server.js +67 -0
- package/dist/settings.d.ts +63 -2
- package/dist/settings.d.ts.map +1 -1
- package/dist/settings.js +126 -2
- package/dist/workspaces.d.ts +8 -2
- package/dist/workspaces.d.ts.map +1 -1
- package/dist/workspaces.js +21 -4
- package/docs/ARCHITECTURE.md +16 -6
- package/docs/FEATURES.md +57 -12
- package/docs/README.ru.md +23 -4
- package/gui-experimental.cjs +4 -4
- package/package.json +5 -2
- package/src/core/audit.ts +291 -0
- package/src/core/native-notify.ts +154 -0
- package/src/core/record-history.ts +6 -4
- package/src/core/secrets.ts +385 -0
- package/src/core/structured-log.ts +9 -0
- package/src/core/telegram.ts +219 -0
- package/src/db/schema.ts +15 -0
- package/src/gui.tsx +543 -6
- package/src/index.ts +459 -22
- package/src/notifications.ts +232 -40
- package/src/rpc.ts +157 -0
- package/src/server.ts +67 -0
- package/src/settings.ts +213 -4
- package/src/workspaces.ts +22 -4
package/ROADMAP.md
CHANGED
|
@@ -1,123 +1,85 @@
|
|
|
1
1
|
# 🗺️ Roadmap — opencode-windows-scheduler
|
|
2
2
|
|
|
3
|
-
|
|
3
|
+
Текущая версия: **1.4.0** (14.11.2026). Плагин опубликован в npm, CI зелёный на Windows / macOS / Linux, 22 инструмента агента, 29 тестовых сюит.
|
|
4
4
|
|
|
5
|
-
|
|
6
|
-
|
|
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
|
-
|
|
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
|
-
|
|
51
|
-
|
|
52
|
-
|
|
53
|
-
1.
|
|
54
|
-
2.
|
|
55
|
-
|
|
56
|
-
|
|
57
|
-
|
|
58
|
-
|
|
59
|
-
|
|
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
|
-
|
|
24
|
+
---
|
|
70
25
|
|
|
71
|
-
|
|
26
|
+
## Ближайшие спринты
|
|
72
27
|
|
|
73
|
-
|
|
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
|
-
|
|
30
|
+
### Спринт 27 — Git-триггеры и условия запуска (P2)
|
|
80
31
|
|
|
81
|
-
|
|
82
|
-
|
|
83
|
-
|
|
84
|
-
|
|
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
|
-
|
|
37
|
+
### Спринт 28 — Pipeline-as-code (P2)
|
|
87
38
|
|
|
88
|
-
|
|
39
|
+
- `opencode.pipeline.yaml` в репозитории: versioned, reviewable, без новых зависимостей (парсер YAML — или JSON-совместимый подформат).
|
|
40
|
+
- CLI `opencode pipeline validate|run|export`: проверка, запуск, экспорт в JSON задач плагина.
|
|
41
|
+
- Импорт/экспорт пайплайна, конфликты с задачами из GUI — в лог и историю.
|
|
42
|
+
- **Готово, когда:** пайплайн из репозитория запускается одной командой, DAG и матрицы описываются в файле, спецификация покрыта тестом и документацией.
|
|
89
43
|
|
|
90
|
-
|
|
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
|
-
|
|
46
|
+
- Runner abstraction: локальный процесс (сейчас), Docker, SSH-хост. Задача описывает *что* делать, runner — *где*.
|
|
47
|
+
- Docker: образ, монтирование workspace, лимиты CPU/RAM, сеть on/off; по умолчанию выключен.
|
|
48
|
+
- Интеграция, а не собственный sandbox: Docker / Landstrip вместо изобретения изоляции.
|
|
49
|
+
- **Готово, когда:** задача выполняется в контейнере с теми же хуками, Quality Gate, историей и метриками, что и локально.
|
|
96
50
|
|
|
97
|
-
|
|
51
|
+
### Спринт 30 — Метрики v2 (P3)
|
|
98
52
|
|
|
99
|
-
|
|
53
|
+
- Token efficiency score: успешные запуски на потраченные токены, отдельно успех и ошибки, по задачам и моделям.
|
|
54
|
+
- Cost forecasting: скользящее среднее, тренд, бюджет на день/неделю с алертом.
|
|
55
|
+
- Готовый Grafana dashboard JSON + инструкция (Prometheus и OTLP уже есть).
|
|
100
56
|
|
|
101
|
-
|
|
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
|
-
|
|
59
|
+
- `docs/README.zh.md` и `docs/README.es.md`, синхронизированные с английским.
|
|
60
|
+
- Переводы обновляются вместе с релизом; PR-шаблон для сообщества.
|
|
107
61
|
|
|
108
|
-
|
|
62
|
+
---
|
|
109
63
|
|
|
110
|
-
|
|
64
|
+
## Идеи без спринта
|
|
111
65
|
|
|
112
|
-
|
|
113
|
-
|
|
114
|
-
|
|
115
|
-
|
|
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
|
-
|
|
77
|
+
---
|
|
118
78
|
|
|
119
|
-
## Правила
|
|
79
|
+
## Правила разработки
|
|
120
80
|
|
|
121
|
-
-
|
|
122
|
-
-
|
|
123
|
-
-
|
|
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"}
|