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/dist/server.js CHANGED
@@ -16,6 +16,7 @@ import { authenticateHookRequest, extractHookSignature, extractHookToken, readRe
16
16
  import { appendStructuredLog, readStructuredLogs } from "./core/structured-log.js";
17
17
  import { PROMETHEUS_CONTENT_TYPE, renderPrometheusMetrics } from "./core/prometheus.js";
18
18
  import { buildOtlpExport } from "./core/otel.js";
19
+ import { readAuditLog, recordAudit } from "./core/audit.js";
19
20
  /**
20
21
  * Локальный веб-дашборд (Спринт 5).
21
22
  * Встроенный модуль http из Node.js — без внешних зависимостей.
@@ -446,6 +447,7 @@ async function handleRequest(req, res, deps) {
446
447
  pathname === "/api/history/export" ||
447
448
  pathname === "/api/export-db" ||
448
449
  pathname === "/api/workspaces" ||
450
+ pathname === "/api/audit" ||
449
451
  pathname === "/api/health" ||
450
452
  pathname === "/api/logs" ||
451
453
  pathname === "/metrics" ||
@@ -711,6 +713,27 @@ async function handleRequest(req, res, deps) {
711
713
  }
712
714
  return;
713
715
  }
716
+ // Журнал аудита (Спринт 26): GET /api/audit?action=…&actor=…&limit=…
717
+ if (req.method === "GET" && pathname === "/api/audit") {
718
+ try {
719
+ const limitRaw = Number(url.searchParams.get("limit"));
720
+ const result = readAuditLog({
721
+ action: url.searchParams.get("action") ?? undefined,
722
+ target: url.searchParams.get("target") ?? undefined,
723
+ actor: url.searchParams.get("actor") ?? undefined,
724
+ since: url.searchParams.get("since") ?? undefined,
725
+ until: url.searchParams.get("until") ?? undefined,
726
+ limit: Number.isFinite(limitRaw) ? limitRaw : undefined,
727
+ });
728
+ sendJson(res, 200, { success: true, ...result });
729
+ }
730
+ catch (err) {
731
+ sendJson(res, 500, {
732
+ error: err instanceof Error ? err.message : String(err),
733
+ });
734
+ }
735
+ return;
736
+ }
714
737
  // Входящий webhook-триггер (Спринт 22): POST /api/hooks/:task?token=…
715
738
  const hookMatch = req.method === "POST" && pathname.match(/^\/api\/hooks\/(.+)$/);
716
739
  if (hookMatch) {
@@ -788,6 +811,15 @@ async function handleRequest(req, res, deps) {
788
811
  ? `Задача "${task.name}" уже выполняется.`
789
812
  : `Задача "${task.name}" запущена по webhook.`;
790
813
  logHook(202, "accepted", undefined, bodyResult.body.length);
814
+ recordAudit({
815
+ action: "task.run",
816
+ targetType: "task",
817
+ target: task.name,
818
+ actor: "http",
819
+ source: "POST /api/hooks/:name",
820
+ remote,
821
+ details: { trigger: "hook" },
822
+ });
791
823
  sendJson(res, 202, {
792
824
  success: true,
793
825
  task: task.name,
@@ -812,6 +844,15 @@ async function handleRequest(req, res, deps) {
812
844
  }
813
845
  try {
814
846
  const result = await deps.runTask(name);
847
+ recordAudit({
848
+ action: "task.run",
849
+ targetType: "task",
850
+ target: name,
851
+ actor: "http",
852
+ source: "POST /api/run/:name",
853
+ remote: req.socket.remoteAddress ?? null,
854
+ details: { alreadyRunning: Boolean(result?.alreadyRunning) },
855
+ });
815
856
  sendJson(res, 200, {
816
857
  success: true,
817
858
  message: result?.alreadyRunning
@@ -841,6 +882,15 @@ async function handleRequest(req, res, deps) {
841
882
  }
842
883
  try {
843
884
  const result = await deps.cancelMatrix(name);
885
+ recordAudit({
886
+ action: "matrix.cancel",
887
+ targetType: "matrix",
888
+ target: name,
889
+ actor: "http",
890
+ source: "POST /api/cancel-matrix/:name",
891
+ remote: req.socket.remoteAddress ?? null,
892
+ details: { cancelled: result.cancelled },
893
+ });
844
894
  sendJson(res, 200, {
845
895
  success: true,
846
896
  message: result.message,
@@ -863,6 +913,15 @@ async function handleRequest(req, res, deps) {
863
913
  }
864
914
  try {
865
915
  const removed = await deps.cleanupMatrixOrphans();
916
+ recordAudit({
917
+ action: "matrix.cleanup",
918
+ targetType: "matrix",
919
+ target: "orphans",
920
+ actor: "http",
921
+ source: "POST /api/matrix-cleanup",
922
+ remote: req.socket.remoteAddress ?? null,
923
+ details: { removed: removed.length },
924
+ });
866
925
  sendJson(res, 200, {
867
926
  success: true,
868
927
  removed,
@@ -889,6 +948,14 @@ async function handleRequest(req, res, deps) {
889
948
  }
890
949
  try {
891
950
  await deps.deleteTask(name);
951
+ recordAudit({
952
+ action: "task.delete",
953
+ targetType: "task",
954
+ target: name,
955
+ actor: "http",
956
+ source: "POST /api/delete/:name",
957
+ remote: req.socket.remoteAddress ?? null,
958
+ });
892
959
  sendJson(res, 200, { success: true, message: `Задача "${name}" удалена.` });
893
960
  }
894
961
  catch (err) {
@@ -159,6 +159,15 @@ export interface IntegrationSettings {
159
159
  /** Входящие webhook-триггеры из CI/CD. */
160
160
  hooks: HookSettings;
161
161
  }
162
+ /** Настройки журнала аудита (Спринт 26). */
163
+ export interface AuditSettings {
164
+ /** Вести журнал мутаций. */
165
+ enabled: boolean;
166
+ /** Сколько дней хранить записи; 0 — без ограничения по времени. */
167
+ retentionDays: number;
168
+ /** Максимум записей; старые удаляются первыми. */
169
+ maxRecords: number;
170
+ }
162
171
  /**
163
172
  * Глобальные настройки плагина, которые меняются из GUI.
164
173
  * Хранятся в settings.json рядом с tasks.json / history.json.
@@ -174,6 +183,8 @@ export interface SchedulerSettings {
174
183
  history: HistorySettings;
175
184
  /** Внешние интеграции: входящие webhook-триггеры. */
176
185
  integrations: IntegrationSettings;
186
+ /** Журнал аудита мутаций (Спринт 26). */
187
+ audit: AuditSettings;
177
188
  }
178
189
  export declare const SETTINGS_FILE: string;
179
190
  export declare const DEFAULT_MAX_CONCURRENT = 1;
@@ -188,6 +199,11 @@ export declare const DEFAULT_STUCK_AFTER_MINUTES = 60;
188
199
  /** Входящие хуки (Спринт 22): тело до 256 KiB, timestamp ±5 минут. */
189
200
  export declare const DEFAULT_HOOK_MAX_BODY_BYTES: number;
190
201
  export declare const DEFAULT_HOOK_TIMESTAMP_TOLERANCE_SECONDS = 300;
202
+ /** Аудит (Спринт 26): включён, 90 дней и не больше 10 000 записей. */
203
+ export declare const DEFAULT_AUDIT_RETENTION_DAYS = 90;
204
+ export declare const DEFAULT_AUDIT_MAX_RECORDS = 10000;
205
+ /** Значения аудита по умолчанию. */
206
+ export declare function defaultAuditSettings(): AuditSettings;
191
207
  /** Значения интеграций по умолчанию: хуки выключены, подпись обязательна. */
192
208
  export declare function defaultIntegrations(): IntegrationSettings;
193
209
  /** Генерирует криптостойкие учётные данные для входящего хука. */
@@ -1 +1 @@
1
- {"version":3,"file":"settings.d.ts","sourceRoot":"","sources":["../src/settings.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"settings.d.ts","sourceRoot":"","sources":["../src/settings.ts"],"names":[],"mappings":"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"}
package/dist/settings.js CHANGED
@@ -17,6 +17,29 @@ export const DEFAULT_HOOK_MAX_BODY_BYTES = 256 * 1024;
17
17
  export const DEFAULT_HOOK_TIMESTAMP_TOLERANCE_SECONDS = 300;
18
18
  const MAX_HOOK_BODY_BYTES = 5 * 1024 * 1024;
19
19
  const MAX_HOOK_CREDENTIAL_LENGTH = 512;
20
+ /** Аудит (Спринт 26): включён, 90 дней и не больше 10 000 записей. */
21
+ export const DEFAULT_AUDIT_RETENTION_DAYS = 90;
22
+ export const DEFAULT_AUDIT_MAX_RECORDS = 10000;
23
+ /** Значения аудита по умолчанию. */
24
+ export function defaultAuditSettings() {
25
+ return {
26
+ enabled: true,
27
+ retentionDays: DEFAULT_AUDIT_RETENTION_DAYS,
28
+ maxRecords: DEFAULT_AUDIT_MAX_RECORDS,
29
+ };
30
+ }
31
+ /** Приводит настройки аудита к безопасному виду. */
32
+ function normalizeAuditSettings(value, fallback) {
33
+ if (!value || typeof value !== "object" || Array.isArray(value)) {
34
+ return { ...fallback };
35
+ }
36
+ const raw = value;
37
+ return {
38
+ enabled: typeof raw.enabled === "boolean" ? raw.enabled : fallback.enabled,
39
+ retentionDays: normalizeRetentionLimit(raw.retentionDays, fallback.retentionDays),
40
+ maxRecords: normalizeRetentionLimit(raw.maxRecords, fallback.maxRecords),
41
+ };
42
+ }
20
43
  /** Значения интеграций по умолчанию: хуки выключены, подпись обязательна. */
21
44
  export function defaultIntegrations() {
22
45
  return {
@@ -352,6 +375,7 @@ export async function loadSettings() {
352
375
  const fallbackNotifications = defaultNotifications();
353
376
  const fallbackHistory = defaultHistorySettings();
354
377
  const fallbackIntegrations = defaultIntegrations();
378
+ const fallbackAudit = defaultAuditSettings();
355
379
  try {
356
380
  const raw = await fs.readFile(SETTINGS_FILE, "utf8");
357
381
  const parsed = JSON.parse(raw);
@@ -361,6 +385,7 @@ export async function loadSettings() {
361
385
  notifications: normalizeNotifications(parsed?.notifications, fallbackNotifications),
362
386
  history: normalizeHistorySettings(parsed?.history, fallbackHistory),
363
387
  integrations: normalizeIntegrations(parsed?.integrations, fallbackIntegrations),
388
+ audit: normalizeAuditSettings(parsed?.audit, fallbackAudit),
364
389
  };
365
390
  }
366
391
  catch {
@@ -370,6 +395,7 @@ export async function loadSettings() {
370
395
  notifications: fallbackNotifications,
371
396
  history: fallbackHistory,
372
397
  integrations: fallbackIntegrations,
398
+ audit: fallbackAudit,
373
399
  };
374
400
  }
375
401
  }
@@ -392,6 +418,9 @@ export async function saveSettings(patch) {
392
418
  integrations: patch.integrations !== undefined
393
419
  ? normalizeIntegrations(patch.integrations, current.integrations)
394
420
  : current.integrations,
421
+ audit: patch.audit !== undefined
422
+ ? normalizeAuditSettings(patch.audit, current.audit)
423
+ : current.audit,
395
424
  };
396
425
  // Удобство: при включении хуков без явных учётных данных генерируем их,
397
426
  // чтобы функция сразу работала, а секреты не приходилось придумывать вручную.
@@ -50,12 +50,18 @@ export declare function parseEnvFileContent(content: string): Record<string, str
50
50
  export declare function readWorkspaceEnvFile(envFile?: string): Record<string, string>;
51
51
  /**
52
52
  * Итоговые env-переменные workspace: сначала .env-файл, затем явные пары
53
- * (пары важнее файла). Никогда не бросает.
53
+ * (пары важнее файла). Ссылки `${secret:NAME}` разворачиваются из
54
+ * зашифрованного хранилища (Спринт 26); отсутствующий секрет даёт пустую
55
+ * строку и предупреждение с именем — без значения. Никогда не бросает.
54
56
  */
55
57
  export declare function resolveWorkspaceEnv(workspace: Workspace | undefined): Record<string, string>;
56
58
  /** Маскирует значение секрета для логов. */
57
59
  export declare function maskSecretValue(): string;
58
- /** Копия env для логов: значения «секретных» ключей заменены на ***. */
60
+ /**
61
+ * Копия env для логов: значения «секретных» ключей заменены на ***.
62
+ * Чистые ссылки `${secret:NAME}` сохраняются как есть — это не секрет,
63
+ * а указатель, и он помогает диагностике (Спринт 26).
64
+ */
59
65
  export declare function maskEnvForLog(env: Record<string, string> | undefined): Record<string, string>;
60
66
  /**
61
67
  * Каталог env-файлов задач внутри каталога плагина (по одному файлу на задачу).
@@ -1 +1 @@
1
- {"version":3,"file":"workspaces.d.ts","sourceRoot":"","sources":["../src/workspaces.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"workspaces.d.ts","sourceRoot":"","sources":["../src/workspaces.ts"],"names":[],"mappings":"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"}
@@ -4,6 +4,7 @@ import { basename, join, resolve } from "node:path";
4
4
  import { spawnSync } from "node:child_process";
5
5
  import { getDb } from "./db/index.js";
6
6
  import { clearWorkspaceAssignments } from "./db/tasks-repo.js";
7
+ import { hasSecretRef, resolveSecretRefs } from "./core/secrets.js";
7
8
  /** Максимум пар env на workspace — защита от раздувания строки JSON. */
8
9
  export const MAX_WORKSPACE_ENV_PAIRS = 100;
9
10
  /** Палитра цветных маркеров для GUI/дашборда. */
@@ -88,28 +89,44 @@ export function readWorkspaceEnvFile(envFile) {
88
89
  }
89
90
  /**
90
91
  * Итоговые env-переменные workspace: сначала .env-файл, затем явные пары
91
- * (пары важнее файла). Никогда не бросает.
92
+ * (пары важнее файла). Ссылки `${secret:NAME}` разворачиваются из
93
+ * зашифрованного хранилища (Спринт 26); отсутствующий секрет даёт пустую
94
+ * строку и предупреждение с именем — без значения. Никогда не бросает.
92
95
  */
93
96
  export function resolveWorkspaceEnv(workspace) {
94
97
  if (!workspace)
95
98
  return {};
96
- return {
99
+ const merged = {
97
100
  ...readWorkspaceEnvFile(workspace.envFile),
98
101
  ...(workspace.env ?? {}),
99
102
  };
103
+ const resolved = resolveSecretRefs(merged);
104
+ if (resolved.missing.length > 0) {
105
+ console.warn(`[workspace] "${workspace.name}": не найдены секреты: ${resolved.missing.join(", ")}`);
106
+ }
107
+ return resolved.env;
100
108
  }
101
109
  /** Маскирует значение секрета для логов. */
102
110
  export function maskSecretValue() {
103
111
  return "***";
104
112
  }
105
113
  const SECRET_KEY_RE = /(TOKEN|SECRET|PASS|PASSWORD|KEY|CREDENTIAL|AUTH)/i;
106
- /** Копия env для логов: значения «секретных» ключей заменены на ***. */
114
+ /**
115
+ * Копия env для логов: значения «секретных» ключей заменены на ***.
116
+ * Чистые ссылки `${secret:NAME}` сохраняются как есть — это не секрет,
117
+ * а указатель, и он помогает диагностике (Спринт 26).
118
+ */
107
119
  export function maskEnvForLog(env) {
108
120
  if (!env)
109
121
  return {};
110
122
  const masked = {};
111
123
  for (const [key, value] of Object.entries(env)) {
112
- masked[key] = SECRET_KEY_RE.test(key) ? maskSecretValue() : value;
124
+ if (hasSecretRef(value)) {
125
+ masked[key] = String(value);
126
+ }
127
+ else {
128
+ masked[key] = SECRET_KEY_RE.test(key) ? maskSecretValue() : value;
129
+ }
113
130
  }
114
131
  return masked;
115
132
  }
@@ -120,7 +120,7 @@ from their clones instead of their own last run.
120
120
 
121
121
  | Path | Role |
122
122
  | --- | --- |
123
- | `src/index.ts` | Plugin lifecycle, 12 agent tools, RPC handlers, task CRUD, view assembly |
123
+ | `src/index.ts` | Plugin lifecycle, 24 agent tools, RPC handlers, task CRUD, view assembly |
124
124
  | `src/rpc.ts` | JSON-schema contracts for every RPC method |
125
125
  | `src/gui.tsx` | OpenCode sidebar panel (SolidJS, built to `gui-experimental.cjs`) |
126
126
  | `src/server.ts` | Local web dashboard HTTP server and HTML rendering |
@@ -129,10 +129,12 @@ from their clones instead of their own last run.
129
129
  | `src/profiles.ts` | Profile directory resolution: per-profile plugin dir (base for `default`, `<base>/profiles/<name>` for named profiles); profile name, marker, port, create/delete/switch |
130
130
  | `src/workspaces.ts` | Workspace registry and path validation; env pairs and `.env` file resolution with secret masking |
131
131
  | `src/templates.ts` | Reusable task templates |
132
- | `src/settings.ts` | Plugin settings: notifications and history retention |
132
+ | `src/settings.ts` | Plugin settings: notifications, history retention, audit |
133
133
  | `src/notifications.ts` | Multi-channel delivery (webhook, Telegram, native OS) with retries/backoff, templates, task filters, quiet hours, matrix and stuck-clone notifications, daily/weekly digest |
134
134
  | `src/core/telegram.ts` | Telegram Bot API `sendMessage`: parse-mode escaping, dashboard link, token validation and masking |
135
135
  | `src/core/native-notify.ts` | Native OS notifications: Windows Toast (PowerShell/WinRT), macOS `osascript`, Linux `notify-send`; no external dependency |
136
+ | `src/core/secrets.ts` | Encrypted secret store (AES-256-GCM, `secrets.key` 0600, `${secret:NAME}` refs, redaction) |
137
+ | `src/core/audit.ts` | SQLite audit journal (`audit_log`), redacted details, retention cleanup |
136
138
  | `src/history.ts` | History model and status types |
137
139
  | `src/version.ts` | Runtime plugin version (reads package.json) |
138
140
  | `src/core/retention.ts` | Daily history prune and incremental vacuum |
@@ -306,7 +308,7 @@ never requires a manual migration.
306
308
 
307
309
  | Interface | Audience | Entry point |
308
310
  | --- | --- | --- |
309
- | Agent tools | AI agent | 22 tools registered via `ctx.tool.transform` |
311
+ | Agent tools | AI agent | 24 tools registered via `ctx.tool.transform` |
310
312
  | Agent skill | AI agent | `skills/scheduled-job-best-practices` |
311
313
  | RPC | Sidebar GUI | `src/rpc.ts` contracts, ~30 methods |
312
314
  | Sidebar GUI | Human | `gui-experimental.cjs` |
@@ -320,8 +322,14 @@ never requires a manual migration.
320
322
  - `allowedTools` / `deniedTools` are **metadata passed to the run**, not a sandbox.
321
323
  They are recorded in history for audit, but they do not constrain `opencode` at the
322
324
  OS level.
323
- - Secrets are stored in plain text in the SQLite database and in wrapper files. Use
324
- environment variables or a secret manager for anything sensitive.
325
+ - Task prompts, hooks and Quality Gate scripts are **plain text** executed with your
326
+ user privileges; only secrets (in `secrets.json`, AES-256-GCM) are encrypted.
327
+ Workspace `env` can reference secrets as `${secret:NAME}`; values are masked in
328
+ logs, history and audit. Treat task creation like granting shell access.
329
+ - Secrets are stored encrypted in `<PLUGIN_DIR>/secrets.json` (AES-256-GCM) with a
330
+ 32-byte key file `secrets.key` (rights 0600). Workspace `env` can reference them
331
+ as `${secret:NAME}`; values are substituted at run time and masked in logs,
332
+ history and audit.
325
333
  - Workspace paths are validated, but hooks are not sandboxed: only schedule jobs from
326
334
  repositories you trust.
327
335
 
package/docs/FEATURES.md CHANGED
@@ -436,6 +436,33 @@ and native OS notifications — configurable in settings and testable with
436
436
  and reports per-channel success/failure. Failures in one channel never block the
437
437
  others and never throw into the task run.
438
438
 
439
+ ### Secrets (Спринт 26)
440
+
441
+ Encrypted secret storage in `<PLUGIN_DIR>/secrets.json` with AES-256-GCM and a
442
+ 32-byte key file `secrets.key` (rights 0600). The `manage_secrets` tool (and the
443
+ «🔐 Секреты» GUI panel) supports `list`, `set` and `delete`. Secret names match
444
+ `[A-Za-z0-9_.-]` and are up to 64 characters; list shows only name, masked preview
445
+ (`••••` + last 4 chars) and update time — never the value.
446
+
447
+ In task workspace `env`, reference a secret as `${secret:NAME}`. The value is
448
+ substituted at run time (missing secrets resolve to an empty string with a
449
+ name-only warning). Secret references survive masking — they are shown verbatim in
450
+ the GUI env editor — while literal secret-like values (`TOKEN=`, `PASSWORD=`, …)
451
+ are masked as `***` in logs, structured logs, history and audit.
452
+
453
+ ### Audit log (Спринт 26)
454
+
455
+ Every mutation — task create/update/delete/run, settings, templates, profiles,
456
+ workspaces, secrets, import, history cleanup — is recorded in an `audit_log`
457
+ table in SQLite with action, target type/target, actor (`mcp`/`gui`/`http`),
458
+ source, redacted details and remote address. Indexes on `ts` and `action`;
459
+ retention defaults to 90 days / 10 000 records with automatic cleanup.
460
+
461
+ The `get_audit_log` tool (and the «📜 Журнал аудита» GUI panel) reads the journal
462
+ with filters by `action`, `target`, `actor`, `since`/`until` and `limit`. Also
463
+ available as RPC `get_audit` and HTTP `GET /api/audit`. Secret values in details
464
+ are redacted; `${secret:NAME}` references are preserved verbatim.
465
+
439
466
  ### Crash recovery
440
467
 
441
468
  Runs left in `running` after a crash are marked `error` on the next plugin start, so
@@ -453,11 +480,12 @@ the `cleanup_history` RPC and the GUI's «Очистить сейчас» button
453
480
 
454
481
  ## Agent interface
455
482
 
456
- Twenty-two tools: `schedule_task`, `list_tasks`, `update_task`, `delete_task`,
483
+ Twenty-four tools: `schedule_task`, `list_tasks`, `update_task`, `delete_task`,
457
484
  `run_task_now`, `pause_task`, `resume_task`, `get_history`, `get_task_logs`, `dry_run`,
458
485
  `manage_workspaces`, `matrix_control` (results/cancel/cleanup/preview), `get_metrics`,
459
486
  `get_analytics`, `manage_settings`, `manage_templates`, `manage_profiles`,
460
487
  `transfer_tasks`, `send_notification`, `get_dashboard_info`, `cleanup_history`,
488
+ `manage_secrets`, `get_audit_log`,
461
489
  `emit_event`.
462
490
 
463
491
  A bundled skill, `scheduled-job-best-practices`, teaches the agent safe defaults:
package/docs/README.ru.md CHANGED
@@ -38,8 +38,8 @@ English version: [README.md](../README.md).
38
38
  | Триггеры | cron, одноразовый запуск (`triggerType: "once"`), изменение файла (chokidar), MCP-события, входящие webhooks (`POST /api/hooks/:task` с HMAC) |
39
39
  | Мультирепо | workspaces с валидацией путей, запуски по workspace, матрица поверх родительской задачи |
40
40
  | Наблюдаемость | история SQLite (success / error / timeout / partial / running), метрики (длительность, токены, стоимость), JSONL-логи с `/api/logs`, Prometheus `/metrics`, экспорт OTLP, логи по задачам, веб-дашборд с аналитикой за 14 дней, ретеншн истории и экспорт CSV/JSON |
41
- | Эксплуатация | dry-run, экспорт/импорт JSON, шаблоны, уведомления по нескольким каналам (webhook, Telegram, нативные toast), тихие часы, дайджест, настройки |
42
- | Интерфейсы | панель OpenCode GUI, веб-дашборд, 22 инструмента для агента, встроенный скилл |
41
+ | Эксплуатация | dry-run, экспорт/импорт JSON, шаблоны, уведомления по нескольким каналам (webhook, Telegram, нативные toast), тихие часы, дайджест, зашифрованные секреты (`${secret:NAME}`), журнал аудита, настройки |
42
+ | Интерфейсы | панель OpenCode GUI, веб-дашборд, 24 инструмента для агента, встроенный скилл |
43
43
 
44
44
  ## Установка
45
45
 
@@ -80,7 +80,7 @@ npm run build && npm run build:gui
80
80
 
81
81
  ## Инструменты для агента
82
82
 
83
- Агенту доступен весь функционал — 22 инструмента: расписание, пайплайны, эксплуатация, аналитика и администрирование.
83
+ Агенту доступен весь функционал — 24 инструмента: расписание, пайплайны, эксплуатация, аналитика и администрирование.
84
84
 
85
85
  | Инструмент | Аргументы | Что делает |
86
86
  |---|---|---|
@@ -158,6 +158,10 @@ src/
158
158
  dry-run.ts симуляция пайплайна
159
159
  lock.ts защита от наложения запусков
160
160
  file-watcher.ts триггеры chokidar
161
+ telegram.ts доставка в Telegram Bot API
162
+ native-notify.ts нативные уведомления (Windows/macOS/Linux)
163
+ secrets.ts зашифрованное хранилище секретов (AES-256-GCM)
164
+ audit.ts журнал аудита (audit_log в SQLite)
161
165
  db/ SQLite: задачи, история, метрики, настройки
162
166
  task-transfer.ts экспорт / импорт / валидация
163
167
  ```
@@ -201,6 +205,12 @@ Windows (Планировщик Windows), macOS (launchd) и Linux (crontab). Р
201
205
  **Можно ли отключить уведомления на ночь?**
202
206
  Да. Задайте `notifications.quietHours` (`enabled`, `from`, `to` в `HH:MM`). В этом окне успешные и `partial` запуски не отправляются, а ошибки и таймауты приходят всегда.
203
207
 
208
+ **Как хранить секреты?**
209
+ Используйте `manage_secrets` (или панель «🔐 Секреты» в сайдбаре). Секреты хранятся в `<PLUGIN_DIR>/secrets.json` с шифрованием AES-256-GCM и ключевым файлом `secrets.key` (права 0600). В `env` задачи секрет ссылается как `${secret:NAME}` — значение подставляется при запуске и маскируется в логах, истории и аудите.
210
+
211
+ **Можно ли посмотреть, кто что изменил?**
212
+ Да. Журнал аудита (`get_audit_log`, панель «📜 Журнал аудита», `GET /api/audit`) записывает каждую мутацию — создание/изменение/удаление/запуск задачи, настройки, шаблоны, профили, workspace, секреты, импорт, очистку истории — с aktёром (mcp/gui/http), источником, временной меткой и замаскированными деталями. Ретеншн по умолчанию 90 дней / 10 000 записей.
213
+
204
214
  **Чем это отличается от `experimental.schedules` в OpenCode?**
205
215
  Встроенный планировщик выполняет задачи, пока OpenCode запущен. Этот плагин использует нативный планировщик ОС и добавляет DAG-пайплайны, матричные сборки, Quality Gates, webhooks и наблюдаемость.
206
216