opencode-windows-scheduler 1.3.0 → 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 (44) hide show
  1. package/CHANGELOG.md +23 -1
  2. package/README.md +9 -3
  3. package/ROADMAP-STRATEGY.md +11 -11
  4. package/ROADMAP.md +2 -7
  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/secrets.d.ts +57 -0
  9. package/dist/core/secrets.d.ts.map +1 -0
  10. package/dist/core/secrets.js +331 -0
  11. package/dist/core/structured-log.d.ts.map +1 -1
  12. package/dist/core/structured-log.js +9 -0
  13. package/dist/db/schema.d.ts +1 -1
  14. package/dist/db/schema.d.ts.map +1 -1
  15. package/dist/db/schema.js +15 -0
  16. package/dist/index.d.ts +24 -4
  17. package/dist/index.d.ts.map +1 -1
  18. package/dist/index.js +342 -19
  19. package/dist/rpc.d.ts +400 -0
  20. package/dist/rpc.d.ts.map +1 -1
  21. package/dist/rpc.js +146 -0
  22. package/dist/server.d.ts.map +1 -1
  23. package/dist/server.js +67 -0
  24. package/dist/settings.d.ts +16 -0
  25. package/dist/settings.d.ts.map +1 -1
  26. package/dist/settings.js +29 -0
  27. package/dist/workspaces.d.ts +8 -2
  28. package/dist/workspaces.d.ts.map +1 -1
  29. package/dist/workspaces.js +21 -4
  30. package/docs/ARCHITECTURE.md +13 -5
  31. package/docs/FEATURES.md +29 -1
  32. package/docs/README.ru.md +13 -3
  33. package/gui-experimental.cjs +4 -4
  34. package/package.json +4 -2
  35. package/src/core/audit.ts +291 -0
  36. package/src/core/secrets.ts +385 -0
  37. package/src/core/structured-log.ts +9 -0
  38. package/src/db/schema.ts +15 -0
  39. package/src/gui.tsx +323 -0
  40. package/src/index.ts +452 -19
  41. package/src/rpc.ts +157 -0
  42. package/src/server.ts +67 -0
  43. package/src/settings.ts +51 -0
  44. package/src/workspaces.ts +22 -4
package/CHANGELOG.md CHANGED
@@ -4,6 +4,27 @@ All notable changes to this project are documented here. Format follows [Keep a
4
4
 
5
5
  ## [Unreleased]
6
6
 
7
+ ## [1.4.0] - 2026-11-14
8
+
9
+ ### Added
10
+
11
+ - **Зашифрованное хранилище секретов (Спринт 26):** AES-256-GCM в `<PLUGIN_DIR>/secrets.json` с ключом `secrets.key` (32 байта, права 0600); API `setSecret/getSecret/deleteSecret/listSecrets/hasSecret`; имена `[A-Za-z0-9_.-]` до 64 символов; превью `••••` + последние 4 символа.
12
+ - **Ссылки на секреты в задачах:** `${secret:NAME}` подставляется из хранилища в `env` рабочей зоны при запуске; отсутствующие секреты дают пустую строку с предупреждением (только имя); ссылки маскируются в логах, истории и аудите.
13
+ - **Журнал аудита (Спринт 26):** таблица `audit_log` в SQLite (действие, цель, актор mcp/gui/http, источник, детали, удалённый адрес) с индексами по времени и действию; ротация 90 дней / 10 000 записей; аудит всех мутаций задач, настроек, шаблонов, профилей, рабочих зон, секретов, импорта и очистки истории.
14
+ - **Инструменты агента:** `manage_secrets` (list/set/delete) и `get_audit_log` (фильтры action/target/actor/since/until/limit); RPC `list_secrets`, `save_secret`, `delete_secret`, `get_audit`; `GET /api/audit`.
15
+ - **GUI:** панель «🔐 Секреты» (список имён + превью, создание, удаление) и панель «📜 Журнал аудита» (таблица с фильтрами), блок ретеншна аудита в настройках.
16
+
17
+ ### Changed
18
+
19
+ - `manage_settings` принимает блок `audit` (`enabled`, `retentionDays`, `maxRecords`); по умолчанию аудит включён, ретеншн 90 дн., лимит 10 000 записей.
20
+ - `resolveWorkspaceEnv` раскрывает `${secret:NAME}` после слияния env-файла и пар; `maskEnvForLog` оставляет ссылки нетронутыми, маскируя только личные значения.
21
+ - `appendStructuredLog` редуцирует `payload.error` / `payload.reason` перед записью JSONL.
22
+
23
+ ### Security
24
+
25
+ - Секреты никогда не хранятся в открытом виде; значения не логируются, не попадают в историю запусков и не раскрываются при экспорте задач.
26
+ - Токен Telegram и chat_id можно задать через env `OPENCODE_SCHEDULER_TELEGRAM_BOT_TOKEN` / `OPENCODE_SCHEDULER_TELEGRAM_CHAT_ID` вместо `settings.json`.
27
+
7
28
  ## [1.3.0] - 2026-11-14
8
29
 
9
30
  ### Added
@@ -158,7 +179,8 @@ First public release.
158
179
  - Deleting a matrix parent deletes its family, but deleting a workspace does not touch existing matrix jobs.
159
180
  - Agent tools cover a subset of the RPC surface (see roadmap item 0.4).
160
181
 
161
- [Unreleased]: https://github.com/DeadSno/opencode-windows-scheduler/compare/v1.3.0...HEAD
182
+ [Unreleased]: https://github.com/DeadSno/opencode-windows-scheduler/compare/v1.4.0...HEAD
183
+ [1.4.0]: https://github.com/DeadSno/opencode-windows-scheduler/compare/v1.3.0...v1.4.0
162
184
  [1.3.0]: https://github.com/DeadSno/opencode-windows-scheduler/compare/v1.2.3...v1.3.0
163
185
  [1.2.3]: https://github.com/DeadSno/opencode-windows-scheduler/compare/v1.2.2...v1.2.3
164
186
  [1.2.2]: https://github.com/DeadSno/opencode-windows-scheduler/compare/v1.2.1...v1.2.2
package/README.md CHANGED
@@ -39,8 +39,8 @@ Want to see it without installing OpenCode? `node scripts/demo-dashboard.mjs` st
39
39
  | Triggers | cron, one-shot (`triggerType: "once"`), file change (chokidar), MCP events, incoming webhooks (`POST /api/hooks/:task` with HMAC) |
40
40
  | Multi-repo | workspaces with path validation, per-workspace runs, matrix over one parent task |
41
41
  | Observability | SQLite history (success / error / timeout / partial / running), metrics (duration, tokens, cost), JSONL run logs with `/api/logs`, Prometheus `/metrics`, OTLP export, per-task logs, local web dashboard with 14-day analytics, history retention and CSV/JSON export |
42
- | Operations | dry-run preview, export/import JSON, templates, multi-channel notifications (webhook, Telegram, native OS toasts), quiet hours, digest, settings |
43
- | Interfaces | OpenCode GUI panel, web dashboard, 22 agent tools, built-in agent skill |
42
+ | Operations | dry-run preview, export/import JSON, templates, multi-channel notifications (webhook, Telegram, native OS toasts), quiet hours, digest, encrypted secrets (`${secret:NAME}`), audit log, settings |
43
+ | Interfaces | OpenCode GUI panel, web dashboard, 24 agent tools, built-in agent skill |
44
44
 
45
45
  ## Install
46
46
 
@@ -173,7 +173,7 @@ Job wrappers run `opencode run` in the task working directory, so project MCP se
173
173
  npm install
174
174
  npm run build # tsc
175
175
  npm run build:gui # vite
176
- npm test # 27 test suites, 500+ checks
176
+ npm test # 29 test suites, 500+ checks
177
177
  ```
178
178
 
179
179
  See [CONTRIBUTING.md](CONTRIBUTING.md) for details.
@@ -205,6 +205,12 @@ No. Windows Toast (PowerShell/WinRT), macOS Notification Center (`osascript`) an
205
205
  **Can I silence notifications at night?**
206
206
  Yes. Set `notifications.quietHours` (`enabled`, `from`, `to` in `HH:MM`). During the window successful and `partial` runs are suppressed, while failures and timeouts are always delivered.
207
207
 
208
+ **How do I store secrets?**
209
+ Use `manage_secrets` (or the «🔐 Секреты» panel in the sidebar) to create an encrypted secret. Secrets are stored in `<PLUGIN_DIR>/secrets.json` with AES-256-GCM and a key file (`secrets.key`, rights 0600). In task `env`, reference a secret as `${secret:NAME}` — the value is substituted at run time and masked in logs, history and audit. The secret name can also be set via `manage_settings` → `notifications.telegram.botToken` left empty and `OPENCODE_SCHEDULER_TELEGRAM_BOT_TOKEN` env var instead.
210
+
211
+ **Can I see who changed what?**
212
+ Yes. The audit log (`get_audit_log` tool, «📜 Журнал аудита» panel, `GET /api/audit`) records every mutation — task create/update/delete/run, settings, templates, profiles, workspaces, secrets, import, history cleanup — with actor (mcp/gui/http), source, timestamp and redacted details. Retention defaults to 90 days / 10 000 records.
213
+
208
214
  **How is this different from `experimental.schedules`?**
209
215
  The built-in scheduler runs jobs while OpenCode is open. This plugin uses the native OS scheduler and adds DAG pipelines, matrix builds, quality gates, webhooks and observability.
210
216
 
@@ -17,14 +17,15 @@
17
17
  | **Open source-first** | Публичный roadmap, CI на 3 ОС, английская документация |
18
18
  | **Оркестрация, а не таймер** | Ров — DAG, матрицы, Quality Gates, наблюдаемость. Cron скопируют за неделю |
19
19
 
20
- **Текущая точка (1.3.0):**
20
+ **Текущая точка (1.4.0):**
21
21
 
22
22
  - опубликован в npm, CI зелёный на Windows / macOS / Linux;
23
- - 22 инструмента агента — паритет с RPC-поверхностью;
23
+ - 24 инструмента агента — паритет с RPC-поверхностью;
24
24
  - one-shot запуски, непрерывность сессий, профили, webhooks, Telegram и нативные toast, тихие часы, Prometheus и OTLP — есть;
25
+ - зашифрованные секреты (${secret:NAME}) и журнал аудита — есть;
25
26
  - английский README и `docs/` — основные, русский синхронизирован в `docs/README.ru.md`.
26
27
 
27
- **Чего ещё нет:** управления секретами и аудита, git-триггеров, pipeline-as-code, Docker-runner, approvals и remote runners.
28
+ **Чего ещё нет:** git-триггеров, pipeline-as-code, Docker-runner, approvals и remote runners.
28
29
 
29
30
  ---
30
31
 
@@ -36,9 +37,9 @@ Telegram Bot API и нативные уведомления ОС, фильтры
36
37
 
37
38
  **Почему:** соседний `@mohak34/opencode-notifier` набирает ~12k загрузок в месяц только на desktop-уведомлениях — спрос доказан.
38
39
 
39
- ### 2. Секреты и аудит (P1)
40
+ ### 2. Секреты и аудит (P1) — Released in 1.4.0
40
41
 
41
- Credential Manager / Keychain / Secret Service, маскирование в логах и экспорте, audit log всех мутаций задач.
42
+ Зашифрованное хранилище (${secret:NAME}), маскирование в логах и экспорте, audit log всех мутаций задач, инструменты manage_secrets / get_audit_log.
42
43
 
43
44
  **Почему:** без этого «CI/CD для агентов» не продаётся даже бесплатно — в задачах живут токены и доступы.
44
45
 
@@ -83,13 +84,13 @@ Credential Manager / Keychain / Secret Service, маскирование в ло
83
84
 
84
85
  ## Метрики успеха
85
86
 
86
- | Метрика | Сейчас (1.3.0) | Через 2 мес | Через 6 мес |
87
+ | Метрика | Сейчас (1.4.0) | Через 2 мес | Через 6 мес |
87
88
  |---|---|---|---|
88
- | npm latest | 1.3.0 | регулярные патчи | 2.x |
89
+ | npm latest | 1.4.0 | регулярные патчи | 2.x |
89
90
  | CI на 3 ОС | ✅ | ✅ | ✅ |
90
91
  | Покрытие RPC инструментами агента | 100% | 100% | 100% |
91
92
  | Telegram / toast | ✅ | ✅ | ✅ |
92
- | Secrets / audit | ❌ | ✅ | ✅ |
93
+ | Secrets / audit | ✅ | ✅ | ✅ |
93
94
  | Git-триггеры | ❌ | ✅ | ✅ |
94
95
  | Pipeline-as-code | ❌ | прототип | ✅ |
95
96
  | Docker runner | ❌ | ❌ | ✅ |
@@ -112,8 +113,7 @@ Credential Manager / Keychain / Secret Service, маскирование в ло
112
113
 
113
114
  ## Ближайшие две недели
114
115
 
115
- 1. Спринт 26: секреты и audit log.
116
- 2. Затем git-триггеры и pipeline-as-code.
117
- 3. Docker runner — после подтверждения спроса.
116
+ 1. Git-триггеры и pipeline-as-code.
117
+ 2. Docker runner — после подтверждения спроса.
118
118
 
119
119
  **Критерий месяца:** пользователь ставит плагин одной командой, получает уведомление в Telegram о падении задачи, а токены и доступы не лежат открытым текстом в `tasks.json`.
package/ROADMAP.md CHANGED
@@ -1,6 +1,6 @@
1
1
  # 🗺️ Roadmap — opencode-windows-scheduler
2
2
 
3
- Текущая версия: **1.3.0** (14.11.2026). Плагин опубликован в npm, CI зелёный на Windows / macOS / Linux, 22 инструмента агента, 27 тестовых сюит.
3
+ Текущая версия: **1.4.0** (14.11.2026). Плагин опубликован в npm, CI зелёный на Windows / macOS / Linux, 22 инструмента агента, 29 тестовых сюит.
4
4
 
5
5
  - Стратегия и позиционирование — [ROADMAP-STRATEGY.md](./ROADMAP-STRATEGY.md).
6
6
  - Что уже выпущено — [CHANGELOG.md](./CHANGELOG.md).
@@ -19,6 +19,7 @@
19
19
  | 1.2.2 | 13.11.2026 | Кроссплатформенный дашборд: снятие зомби-процесса на macOS/Linux (`lsof`, `ss`), ожидание освобождения порта после SIGKILL, платформо-независимый тест заголовка. |
20
20
  | 1.2.3 | 13.11.2026 | Документация и дистрибуция: установка через `plugins` и `opencode plugin add` (ключ `plugin` устарел), FAQ, английский README для npm, русский README в `docs/README.ru.md`, расширенные описание и keywords пакета. |
21
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-аудит мутаций. |
22
23
 
23
24
  ---
24
25
 
@@ -26,12 +27,6 @@
26
27
 
27
28
  Порядок отражает приоритет: сначала то, что мешает пользователям каждый день, затем переход к CI/CD-оркестрации.
28
29
 
29
- ### Спринт 26 — Секреты и аудит (P1)
30
-
31
- - Secrets management: Windows Credential Manager / macOS Keychain / Linux Secret Service (keytar) или внешний Vault; подстановка в env задачи, маскирование в логах, истории и экспорте.
32
- - Audit log: кто создал / изменил / запустил / удалил задачу, когда и через какой интерфейс (агент, GUI, HTTP); поверх structured-log, с ротацией.
33
- - **Готово, когда:** секреты не хранятся в открытом виде, экспорт их не раскрывает, аудит покрывает все мутации задач и проверен тестом.
34
-
35
30
  ### Спринт 27 — Git-триггеры и условия запуска (P2)
36
31
 
37
32
  - Git-триггер: запуск только при новых коммитах (`HEAD` против последнего запуска), фильтр по ветке и путям (`git diff --name-only`).
@@ -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,57 @@
1
+ /**
2
+ * Зашифрованное хранилище секретов (Спринт 26).
3
+ *
4
+ * Зависимостей нет: ключ 32 байта лежит в `secrets.key` (права 0600), сами
5
+ * значения — в `secrets.json`, зашифрованные AES-256-GCM. Имя секрета
6
+ * используется как AAD, поэтому перестановка записей между именами ломает
7
+ * расшифровку. В открытом виде секреты не попадают ни в settings.json, ни в
8
+ * tasks.json, ни в историю, ни в логи — для этого есть resolveSecretRefs()
9
+ * и redactSecretsInText().
10
+ *
11
+ * Ссылка на секрет в env выглядит как `${secret:NAME}`. Ссылка может быть
12
+ * частью значения: `Authorization=Bearer ${secret:GITHUB_TOKEN}`.
13
+ */
14
+ export declare const SECRETS_FILE: string;
15
+ export declare const SECRETS_KEY_FILE: string;
16
+ export declare const SECRET_REF_RE: RegExp;
17
+ export interface SecretListItem {
18
+ name: string;
19
+ /** Маска вида `••••ABCD` — само значение никогда не возвращается. */
20
+ preview: string;
21
+ updatedAt: string;
22
+ }
23
+ /** Проверяет имя секрета; возвращает trimmed-значение. */
24
+ export declare function validateSecretName(name: string): string;
25
+ /** true, если значение содержит хотя бы одну ссылку `${secret:...}`. */
26
+ export declare function hasSecretRef(value: unknown): boolean;
27
+ /** Сохраняет (или перезаписывает) секрет. Значение не логируется. */
28
+ export declare function setSecret(name: string, value: string): SecretListItem;
29
+ /** Читает секрет; undefined, если его нет или он не расшифровывается. */
30
+ export declare function getSecret(name: string): string | undefined;
31
+ /** true, если секрет существует и расшифровывается. */
32
+ export declare function hasSecret(name: string): boolean;
33
+ /** Удаляет секрет; true — запись была. */
34
+ export declare function deleteSecret(name: string): boolean;
35
+ /** Список секретов без значений (только имена, маски и время обновления). */
36
+ export declare function listSecrets(): SecretListItem[];
37
+ /** Подставляет все ссылки `${secret:NAME}` в строку. */
38
+ export declare function expandSecretRefs(value: string): {
39
+ value: string;
40
+ missing: string[];
41
+ };
42
+ /**
43
+ * Разворачивает ссылки во всех значениях env. Отсутствующие секреты дают
44
+ * пустую строку и попадают в `missing` (только имена — без значений).
45
+ */
46
+ export declare function resolveSecretRefs(env: Record<string, string>): {
47
+ env: Record<string, string>;
48
+ missing: string[];
49
+ };
50
+ /**
51
+ * Вырезает из произвольного текста известные значения секретов и типовые
52
+ * присваивания вида `TOKEN=...` / `password: ...`.
53
+ */
54
+ export declare function redactSecretsInText(text: unknown): string;
55
+ /** Сбрасывает кэши (для тестов и после ручного изменения файлов). */
56
+ export declare function resetSecretsCache(): void;
57
+ //# sourceMappingURL=secrets.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"secrets.d.ts","sourceRoot":"","sources":["../../src/core/secrets.ts"],"names":[],"mappings":"AAKA;;;;;;;;;;;;GAYG;AAEH,eAAO,MAAM,YAAY,QAAwC,CAAC;AAClE,eAAO,MAAM,gBAAgB,QAAuC,CAAC;AACrE,eAAO,MAAM,aAAa,QAAyC,CAAC;AAmBpE,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,qEAAqE;IACrE,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;CACnB;AAoBD,0DAA0D;AAC1D,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAQvD;AAED,wEAAwE;AACxE,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAIpD;AAmID,qEAAqE;AACrE,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,cAAc,CAYrE;AAED,yEAAyE;AACzE,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAW1D;AAED,uDAAuD;AACvD,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAE/C;AAED,0CAA0C;AAC1C,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAOlD;AASD,6EAA6E;AAC7E,wBAAgB,WAAW,IAAI,cAAc,EAAE,CAc9C;AAED,wDAAwD;AACxD,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG;IAC/C,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB,CAWA;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG;IAC9D,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC5B,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB,CASA;AA8BD;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,OAAO,GAAG,MAAM,CA8BzD;AAED,qEAAqE;AACrE,wBAAgB,iBAAiB,IAAI,IAAI,CAIxC"}