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
@@ -0,0 +1,110 @@
1
+ /**
2
+ * Нативные уведомления ОС (Спринт 25).
3
+ *
4
+ * Windows — Toast через PowerShell/WinRT, macOS — Notification Center через
5
+ * osascript, Linux — notify-send (libnotify). Внешних зависимостей нет:
6
+ * node-notifier не требуется. Все ошибки проглатываются намеренно —
7
+ * уведомление не должно ломать задачу.
8
+ */
9
+ import { execFile } from "node:child_process";
10
+ import { promisify } from "node:util";
11
+ const execFileAsync = promisify(execFile);
12
+ /** Таймаут запуска процесса уведомления. */
13
+ const DEFAULT_TIMEOUT_MS = 15000;
14
+ /** Скрипт Windows Toast: текст передаётся через env, чтобы не экранировать кавычки. */
15
+ const WINDOWS_TOAST_SCRIPT = `
16
+ $ErrorActionPreference = 'Stop'
17
+ $title = [System.Security.SecurityElement]::Escape($env:OCS_NOTIFY_TITLE)
18
+ $body = [System.Security.SecurityElement]::Escape($env:OCS_NOTIFY_BODY)
19
+ $silent = if ($env:OCS_NOTIFY_SOUND -eq '1') { '' } else { '<audio silent="true"/>' }
20
+ $xml = '<toast><visual><binding template="ToastGeneric"><text>' + $title + '</text><text>' + $body + '</text></binding></visual>' + $silent + '</toast>'
21
+ [Windows.UI.Notifications.ToastNotificationManager, Windows.UI.Notifications, ContentType=WindowsRuntime] > $null
22
+ [Windows.Data.Xml.Dom.XmlDocument, Windows.Data.Xml.Dom.XmlDocument, ContentType=WindowsRuntime] > $null
23
+ $doc = [Windows.Data.Xml.Dom.XmlDocument]::new()
24
+ $doc.LoadXml($xml)
25
+ $toast = [Windows.UI.Notifications.ToastNotification]::new($doc)
26
+ $appId = '{1AC14E77-02E7-4E5D-B744-2EB1AE5198B7}\\WindowsPowerShell\\v1.0\\powershell.exe'
27
+ [Windows.UI.Notifications.ToastNotificationManager]::CreateToastNotifier($appId).Show($toast)
28
+ `.trim();
29
+ /**
30
+ * Собирает команду нативного уведомления для платформы.
31
+ * Чистая функция: ничего не запускает.
32
+ */
33
+ export function buildNativeNotificationCommand(platform, message) {
34
+ const title = (message.title ?? "OpenCode Scheduler").trim() || "OpenCode Scheduler";
35
+ const body = String(message.body ?? "");
36
+ const sound = message.sound !== false;
37
+ if (platform === "win32") {
38
+ return {
39
+ command: "powershell.exe",
40
+ args: [
41
+ "-NoProfile",
42
+ "-NonInteractive",
43
+ "-ExecutionPolicy",
44
+ "Bypass",
45
+ "-Command",
46
+ WINDOWS_TOAST_SCRIPT,
47
+ ],
48
+ env: {
49
+ OCS_NOTIFY_TITLE: title,
50
+ OCS_NOTIFY_BODY: body,
51
+ OCS_NOTIFY_SOUND: sound ? "1" : "0",
52
+ },
53
+ };
54
+ }
55
+ if (platform === "darwin") {
56
+ const script = 'display notification (system attribute "OCS_NOTIFY_BODY") ' +
57
+ 'with title (system attribute "OCS_NOTIFY_TITLE")' +
58
+ (sound ? ' sound name "Glass"' : "");
59
+ return {
60
+ command: "osascript",
61
+ args: ["-e", script],
62
+ env: {
63
+ OCS_NOTIFY_TITLE: title,
64
+ OCS_NOTIFY_BODY: body,
65
+ },
66
+ };
67
+ }
68
+ return {
69
+ command: "notify-send",
70
+ args: [
71
+ "-a",
72
+ "OpenCode Scheduler",
73
+ "-u",
74
+ "normal",
75
+ "-i",
76
+ "dialog-information",
77
+ title,
78
+ body,
79
+ ],
80
+ };
81
+ }
82
+ /**
83
+ * Показывает нативное уведомление. Никогда не бросает исключение.
84
+ */
85
+ export async function sendNativeNotification(message, options = {}) {
86
+ const platform = options.platform ?? process.platform;
87
+ const command = buildNativeNotificationCommand(platform, message);
88
+ const env = { ...process.env, ...(command.env ?? {}) };
89
+ const timeoutMs = Math.max(1000, Math.floor(options.timeoutMs ?? DEFAULT_TIMEOUT_MS));
90
+ try {
91
+ if (options.exec) {
92
+ await options.exec(command.command, command.args, env);
93
+ }
94
+ else {
95
+ await execFileAsync(command.command, command.args, {
96
+ env,
97
+ timeout: timeoutMs,
98
+ windowsHide: true,
99
+ maxBuffer: 1024 * 1024,
100
+ });
101
+ }
102
+ return { success: true };
103
+ }
104
+ catch (err) {
105
+ return {
106
+ success: false,
107
+ error: err instanceof Error ? err.message : String(err),
108
+ };
109
+ }
110
+ }
@@ -252,7 +252,7 @@ async function main() {
252
252
  console.error(`[windows-scheduler] record-history: запись #${runId} уже завершена или не найдена.`);
253
253
  return;
254
254
  }
255
- await handleCompletion(taskName, st, chainTarget, error, durationMs);
255
+ await handleCompletion(taskName, st, chainTarget, error, durationMs, tokens, costUsd);
256
256
  return;
257
257
  }
258
258
  // Обратная совместимость: старый режим без --start.
@@ -279,16 +279,16 @@ async function main() {
279
279
  ? definition?.nextTaskOnSuccess || null
280
280
  : definition?.nextTaskOnError || null;
281
281
  recordRun(taskName, st, startedAt, durationMs, error, chainTarget, tokens, costUsd, model, preFlightStatus, postFlightStatus, new Date().toISOString(), definition?.workspaceId ?? null, definition?.allowedTools ?? null, definition?.deniedTools ?? null);
282
- await handleCompletion(taskName, st, chainTarget, error, durationMs);
282
+ await handleCompletion(taskName, st, chainTarget, error, durationMs, tokens, costUsd);
283
283
  }
284
284
  /**
285
285
  * Общая пост-обработка завершённого запуска: уведомление, цепочки задач,
286
286
  * DAG-зависимости и повторы. Используется и legacy-режимом, и --finish.
287
287
  */
288
- async function handleCompletion(taskName, st, chainTarget, error, durationMs) {
288
+ async function handleCompletion(taskName, st, chainTarget, error, durationMs, tokens, costUsd) {
289
289
  // Уведомление о завершении (webhook). Ошибки отправки логируются внутри
290
290
  // и не влияют на историю, цепочки и повторы.
291
- await notifyTaskCompletion(taskName, st, durationMs, error);
291
+ await notifyTaskCompletion(taskName, st, durationMs, error, tokens, costUsd);
292
292
  // Matrix (Спринт 15): клон завершился — двигаем sequential-цепочку или
293
293
  // очередь concurrency-лимита (Спринт 17), а когда все клоны готовы —
294
294
  // фиксируем агрегат и запускаем matrix-complete.
@@ -0,0 +1,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"}
@@ -0,0 +1,331 @@
1
+ import crypto from "node:crypto";
2
+ import fs from "node:fs";
3
+ import path from "node:path";
4
+ import { PLUGIN_DIR } from "../types.js";
5
+ /**
6
+ * Зашифрованное хранилище секретов (Спринт 26).
7
+ *
8
+ * Зависимостей нет: ключ 32 байта лежит в `secrets.key` (права 0600), сами
9
+ * значения — в `secrets.json`, зашифрованные AES-256-GCM. Имя секрета
10
+ * используется как AAD, поэтому перестановка записей между именами ломает
11
+ * расшифровку. В открытом виде секреты не попадают ни в settings.json, ни в
12
+ * tasks.json, ни в историю, ни в логи — для этого есть resolveSecretRefs()
13
+ * и redactSecretsInText().
14
+ *
15
+ * Ссылка на секрет в env выглядит как `${secret:NAME}`. Ссылка может быть
16
+ * частью значения: `Authorization=Bearer ${secret:GITHUB_TOKEN}`.
17
+ */
18
+ export const SECRETS_FILE = path.join(PLUGIN_DIR, "secrets.json");
19
+ export const SECRETS_KEY_FILE = path.join(PLUGIN_DIR, "secrets.key");
20
+ export const SECRET_REF_RE = /\$\{secret:([A-Za-z0-9_.-]{1,64})\}/g;
21
+ const SECRET_NAME_RE = /^[A-Za-z0-9_.-]{1,64}$/;
22
+ const KEY_BYTES = 32;
23
+ let cache = null;
24
+ let keyCache = null;
25
+ function warn(message, err) {
26
+ try {
27
+ console.warn(`[secrets] ${message}: ${err instanceof Error ? err.message : String(err)}`);
28
+ }
29
+ catch {
30
+ // console может быть недоступен — молча игнорируем.
31
+ }
32
+ }
33
+ /** Проверяет имя секрета; возвращает trimmed-значение. */
34
+ export function validateSecretName(name) {
35
+ const value = String(name ?? "").trim();
36
+ if (!SECRET_NAME_RE.test(value)) {
37
+ throw new Error("Имя секрета: латиница, цифры, '_', '.', '-', от 1 до 64 символов.");
38
+ }
39
+ return value;
40
+ }
41
+ /** true, если значение содержит хотя бы одну ссылку `${secret:...}`. */
42
+ export function hasSecretRef(value) {
43
+ if (typeof value !== "string")
44
+ return false;
45
+ SECRET_REF_RE.lastIndex = 0;
46
+ return SECRET_REF_RE.test(value);
47
+ }
48
+ function ensureDir() {
49
+ fs.mkdirSync(PLUGIN_DIR, { recursive: true });
50
+ }
51
+ function chmodPrivate(file) {
52
+ if (process.platform === "win32")
53
+ return;
54
+ try {
55
+ fs.chmodSync(file, 0o600);
56
+ }
57
+ catch {
58
+ // ACL на некоторых ФС не поддерживают chmod — не критично.
59
+ }
60
+ }
61
+ /** Читает или создаёт ключ шифрования. */
62
+ function loadKey() {
63
+ ensureDir();
64
+ try {
65
+ const stat = fs.statSync(SECRETS_KEY_FILE);
66
+ const stamp = `${stat.mtimeMs}:${stat.size}`;
67
+ if (keyCache && keyCache.stamp === stamp)
68
+ return keyCache.key;
69
+ const raw = fs.readFileSync(SECRETS_KEY_FILE);
70
+ if (raw.length !== KEY_BYTES) {
71
+ throw new Error("повреждён файл ключа секретов");
72
+ }
73
+ keyCache = { stamp, key: raw };
74
+ return raw;
75
+ }
76
+ catch (err) {
77
+ if (err?.code !== "ENOENT")
78
+ throw err;
79
+ const key = crypto.randomBytes(KEY_BYTES);
80
+ fs.writeFileSync(SECRETS_KEY_FILE, key, { mode: 0o600 });
81
+ chmodPrivate(SECRETS_KEY_FILE);
82
+ keyCache = { stamp: `${fs.statSync(SECRETS_KEY_FILE).mtimeMs}:${KEY_BYTES}`, key };
83
+ return key;
84
+ }
85
+ }
86
+ function emptyFile() {
87
+ return { version: 1, secrets: {} };
88
+ }
89
+ /** Читает secrets.json с кэшем по mtime/size. Битый файл — пустое хранилище. */
90
+ function readFileSafe() {
91
+ try {
92
+ const stat = fs.statSync(SECRETS_FILE);
93
+ const stamp = `${stat.mtimeMs}:${stat.size}`;
94
+ if (cache && cache.stamp === stamp)
95
+ return cache.file;
96
+ const parsed = JSON.parse(fs.readFileSync(SECRETS_FILE, "utf8"));
97
+ if (!parsed || typeof parsed !== "object" || Array.isArray(parsed)) {
98
+ throw new Error("некорректный формат secrets.json");
99
+ }
100
+ const rawSecrets = parsed.secrets;
101
+ const secrets = {};
102
+ if (rawSecrets && typeof rawSecrets === "object" && !Array.isArray(rawSecrets)) {
103
+ for (const [name, entry] of Object.entries(rawSecrets)) {
104
+ const record = entry;
105
+ if (SECRET_NAME_RE.test(name) &&
106
+ typeof record?.iv === "string" &&
107
+ typeof record?.tag === "string" &&
108
+ typeof record?.data === "string") {
109
+ secrets[name] = {
110
+ iv: record.iv,
111
+ tag: record.tag,
112
+ data: record.data,
113
+ updatedAt: typeof record.updatedAt === "string"
114
+ ? record.updatedAt
115
+ : new Date(0).toISOString(),
116
+ };
117
+ }
118
+ }
119
+ }
120
+ const file = { version: 1, secrets };
121
+ cache = { stamp, file };
122
+ return file;
123
+ }
124
+ catch (err) {
125
+ if (err?.code !== "ENOENT")
126
+ warn("не удалось прочитать secrets.json", err);
127
+ return emptyFile();
128
+ }
129
+ }
130
+ /** Атомарная запись: temp + rename, права 0600. */
131
+ function writeFileSafe(file) {
132
+ ensureDir();
133
+ const tmp = `${SECRETS_FILE}.tmp`;
134
+ fs.writeFileSync(tmp, JSON.stringify(file, null, 2), { encoding: "utf8", mode: 0o600 });
135
+ try {
136
+ fs.rmSync(SECRETS_FILE, { force: true });
137
+ }
138
+ catch {
139
+ // файла нет — не ошибка
140
+ }
141
+ fs.renameSync(tmp, SECRETS_FILE);
142
+ chmodPrivate(SECRETS_FILE);
143
+ try {
144
+ const stat = fs.statSync(SECRETS_FILE);
145
+ cache = { stamp: `${stat.mtimeMs}:${stat.size}`, file };
146
+ }
147
+ catch {
148
+ cache = null;
149
+ }
150
+ }
151
+ function encryptValue(name, value, key) {
152
+ const iv = crypto.randomBytes(12);
153
+ const cipher = crypto.createCipheriv("aes-256-gcm", key, iv);
154
+ cipher.setAAD(Buffer.from(name, "utf8"));
155
+ const data = Buffer.concat([cipher.update(value, "utf8"), cipher.final()]);
156
+ return {
157
+ iv: iv.toString("base64"),
158
+ tag: cipher.getAuthTag().toString("base64"),
159
+ data: data.toString("base64"),
160
+ updatedAt: new Date().toISOString(),
161
+ };
162
+ }
163
+ function decryptValue(name, entry, key) {
164
+ const decipher = crypto.createDecipheriv("aes-256-gcm", key, Buffer.from(entry.iv, "base64"));
165
+ decipher.setAAD(Buffer.from(name, "utf8"));
166
+ decipher.setAuthTag(Buffer.from(entry.tag, "base64"));
167
+ return Buffer.concat([
168
+ decipher.update(Buffer.from(entry.data, "base64")),
169
+ decipher.final(),
170
+ ]).toString("utf8");
171
+ }
172
+ /** Сохраняет (или перезаписывает) секрет. Значение не логируется. */
173
+ export function setSecret(name, value) {
174
+ const secretName = validateSecretName(name);
175
+ const text = String(value ?? "");
176
+ const key = loadKey();
177
+ const file = readFileSafe();
178
+ file.secrets[secretName] = encryptValue(secretName, text, key);
179
+ writeFileSafe(file);
180
+ return {
181
+ name: secretName,
182
+ preview: previewOf(text),
183
+ updatedAt: file.secrets[secretName].updatedAt,
184
+ };
185
+ }
186
+ /** Читает секрет; undefined, если его нет или он не расшифровывается. */
187
+ export function getSecret(name) {
188
+ try {
189
+ const secretName = validateSecretName(name);
190
+ const file = readFileSafe();
191
+ const entry = file.secrets[secretName];
192
+ if (!entry)
193
+ return undefined;
194
+ return decryptValue(secretName, entry, loadKey());
195
+ }
196
+ catch (err) {
197
+ warn("не удалось расшифровать секрет", err);
198
+ return undefined;
199
+ }
200
+ }
201
+ /** true, если секрет существует и расшифровывается. */
202
+ export function hasSecret(name) {
203
+ return getSecret(name) !== undefined;
204
+ }
205
+ /** Удаляет секрет; true — запись была. */
206
+ export function deleteSecret(name) {
207
+ const secretName = validateSecretName(name);
208
+ const file = readFileSafe();
209
+ if (!(secretName in file.secrets))
210
+ return false;
211
+ delete file.secrets[secretName];
212
+ writeFileSafe(file);
213
+ return true;
214
+ }
215
+ function previewOf(value) {
216
+ const text = String(value ?? "");
217
+ if (!text)
218
+ return "••••";
219
+ const tail = text.length >= 4 ? text.slice(-4) : "";
220
+ return tail ? `••••${tail}` : "••••";
221
+ }
222
+ /** Список секретов без значений (только имена, маски и время обновления). */
223
+ export function listSecrets() {
224
+ const file = readFileSafe();
225
+ return Object.keys(file.secrets)
226
+ .sort((a, b) => a.localeCompare(b))
227
+ .map((name) => {
228
+ let preview = "••••";
229
+ try {
230
+ const value = decryptValue(name, file.secrets[name], loadKey());
231
+ preview = previewOf(value);
232
+ }
233
+ catch {
234
+ preview = "••••";
235
+ }
236
+ return { name, preview, updatedAt: file.secrets[name].updatedAt };
237
+ });
238
+ }
239
+ /** Подставляет все ссылки `${secret:NAME}` в строку. */
240
+ export function expandSecretRefs(value) {
241
+ const missing = new Set();
242
+ const result = String(value ?? "").replace(SECRET_REF_RE, (_match, name) => {
243
+ const secret = getSecret(name);
244
+ if (secret === undefined) {
245
+ missing.add(name);
246
+ return "";
247
+ }
248
+ return secret;
249
+ });
250
+ return { value: result, missing: [...missing] };
251
+ }
252
+ /**
253
+ * Разворачивает ссылки во всех значениях env. Отсутствующие секреты дают
254
+ * пустую строку и попадают в `missing` (только имена — без значений).
255
+ */
256
+ export function resolveSecretRefs(env) {
257
+ const resolved = {};
258
+ const missing = new Set();
259
+ for (const [key, value] of Object.entries(env ?? {})) {
260
+ const result = expandSecretRefs(String(value ?? ""));
261
+ resolved[key] = result.value;
262
+ for (const name of result.missing)
263
+ missing.add(name);
264
+ }
265
+ return { env: resolved, missing: [...missing] };
266
+ }
267
+ /** Все расшифрованные значения (для редактирования текста). Кэш на 5 секунд. */
268
+ let valuesCache = null;
269
+ function knownSecretValues() {
270
+ const now = Date.now();
271
+ if (valuesCache && now - valuesCache.at < 5000)
272
+ return valuesCache.values;
273
+ const file = readFileSafe();
274
+ const values = [];
275
+ let key;
276
+ try {
277
+ key = loadKey();
278
+ }
279
+ catch {
280
+ return [];
281
+ }
282
+ for (const [name, entry] of Object.entries(file.secrets)) {
283
+ try {
284
+ const value = decryptValue(name, entry, key);
285
+ if (value.length >= 4)
286
+ values.push(value);
287
+ }
288
+ catch {
289
+ // повреждённая запись пропускается
290
+ }
291
+ }
292
+ // Длинные значения первыми, чтобы не оставить хвост после короткой замены.
293
+ values.sort((a, b) => b.length - a.length);
294
+ valuesCache = { at: now, values };
295
+ return values;
296
+ }
297
+ /**
298
+ * Вырезает из произвольного текста известные значения секретов и типовые
299
+ * присваивания вида `TOKEN=...` / `password: ...`.
300
+ */
301
+ export function redactSecretsInText(text) {
302
+ const source = typeof text === "string" ? text : String(text ?? "");
303
+ if (!source)
304
+ return source;
305
+ let result = source;
306
+ // Защищаем ссылки ${secret:NAME} от общих правил маскировки: слово "secret"
307
+ // попадает под чувствительные ключи и ломало бы ссылки.
308
+ const protectedRefs = [];
309
+ result = result.replace(SECRET_REF_RE, (_match, name) => {
310
+ const placeholder = `\u0000SECRET_REF_${protectedRefs.length}\u0000`;
311
+ protectedRefs.push(`\${secret:${name}}`);
312
+ return placeholder;
313
+ });
314
+ for (const value of knownSecretValues()) {
315
+ if (!value)
316
+ continue;
317
+ result = result.split(value).join("***");
318
+ }
319
+ result = result.replace(/\b([A-Za-z0-9_]*(?:TOKEN|SECRET|PASSWORD|PASSWD|API_KEY|APIKEY|CREDENTIAL|AUTH)[A-Za-z0-9_]*)\b(\s*[=:]\s*)(["']?)([^\s"',;]+)\3/gi, (_match, key, sep, quote) => `${key}${sep}${quote}***${quote}`);
320
+ // Восстанавливаем защищённые ссылки.
321
+ for (let i = 0; i < protectedRefs.length; i++) {
322
+ result = result.split(`\u0000SECRET_REF_${i}\u0000`).join(protectedRefs[i]);
323
+ }
324
+ return result;
325
+ }
326
+ /** Сбрасывает кэши (для тестов и после ручного изменения файлов). */
327
+ export function resetSecretsCache() {
328
+ cache = null;
329
+ keyCache = null;
330
+ valuesCache = null;
331
+ }
@@ -1 +1 @@
1
- {"version":3,"file":"structured-log.d.ts","sourceRoot":"","sources":["../../src/core/structured-log.ts"],"names":[],"mappings":"AAIA;;;;;;;;;;;;GAYG;AAEH,uCAAuC;AACvC,MAAM,MAAM,kBAAkB,GAAG,aAAa,GAAG,cAAc,GAAG,eAAe,GAAG,MAAM,CAAC;AAE3F,MAAM,WAAW,mBAAmB;IAClC,0BAA0B;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,kBAAkB,CAAC;IAC1B,qCAAqC;IACrC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,mEAAmE;IACnE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,2CAA2C;IAC3C,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,0CAA0C;IAC1C,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,iCAAiC;IACjC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,+BAA+B;IAC/B,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,wBAAwB;IACvC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,mCAAmC;IACnC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,kCAAkC;IAClC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,wBAAwB;IACvC,OAAO,EAAE,mBAAmB,EAAE,CAAC;IAC/B,sEAAsE;IACtE,KAAK,EAAE,MAAM,CAAC;IACd,mDAAmD;IACnD,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;CACd;AAED,8CAA8C;AAC9C,eAAO,MAAM,mBAAmB,QAAmC,CAAC;AACpE,eAAO,MAAM,sBAAsB,QAA6B,CAAC;AACjE,eAAO,MAAM,wBAAwB,QAAmB,CAAC;AAiCzD;;;GAGG;AACH,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,IAAI,CAAC,mBAAmB,EAAE,IAAI,CAAC,GAAG;IAAE,EAAE,CAAC,EAAE,MAAM,CAAA;CAAE,GACxD,OAAO,CAcT;AAcD;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAChC,MAAM,GAAE,wBAA6B,GACpC,wBAAwB,CA4C1B;AAED,sDAAsD;AACtD,wBAAgB,mBAAmB,IAAI,IAAI,CAO1C"}
1
+ {"version":3,"file":"structured-log.d.ts","sourceRoot":"","sources":["../../src/core/structured-log.ts"],"names":[],"mappings":"AAKA;;;;;;;;;;;;GAYG;AAEH,uCAAuC;AACvC,MAAM,MAAM,kBAAkB,GAAG,aAAa,GAAG,cAAc,GAAG,eAAe,GAAG,MAAM,CAAC;AAE3F,MAAM,WAAW,mBAAmB;IAClC,0BAA0B;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,kBAAkB,CAAC;IAC1B,qCAAqC;IACrC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,mEAAmE;IACnE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,2CAA2C;IAC3C,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,0CAA0C;IAC1C,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,iCAAiC;IACjC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,+BAA+B;IAC/B,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,wBAAwB;IACvC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,mCAAmC;IACnC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,kCAAkC;IAClC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,wBAAwB;IACvC,OAAO,EAAE,mBAAmB,EAAE,CAAC;IAC/B,sEAAsE;IACtE,KAAK,EAAE,MAAM,CAAC;IACd,mDAAmD;IACnD,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;CACd;AAED,8CAA8C;AAC9C,eAAO,MAAM,mBAAmB,QAAmC,CAAC;AACpE,eAAO,MAAM,sBAAsB,QAA6B,CAAC;AACjE,eAAO,MAAM,wBAAwB,QAAmB,CAAC;AAiCzD;;;GAGG;AACH,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,IAAI,CAAC,mBAAmB,EAAE,IAAI,CAAC,GAAG;IAAE,EAAE,CAAC,EAAE,MAAM,CAAA;CAAE,GACxD,OAAO,CAsBT;AAcD;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAChC,MAAM,GAAE,wBAA6B,GACpC,wBAAwB,CA4C1B;AAED,sDAAsD;AACtD,wBAAgB,mBAAmB,IAAI,IAAI,CAO1C"}
@@ -1,6 +1,7 @@
1
1
  import fs from "node:fs";
2
2
  import path from "node:path";
3
3
  import { LOG_DIR } from "../types.js";
4
+ import { redactSecretsInText } from "./secrets.js";
4
5
  /** Текущий файл и его архив после ротации. */
5
6
  export const STRUCTURED_LOG_FILE = path.join(LOG_DIR, "runs.jsonl");
6
7
  export const STRUCTURED_LOG_ARCHIVE = `${STRUCTURED_LOG_FILE}.1`;
@@ -48,6 +49,14 @@ export function appendStructuredLog(record) {
48
49
  ...record,
49
50
  ts: record.ts ?? new Date().toISOString(),
50
51
  };
52
+ // Спринт 26: даже если ошибка пришла из внешнего процесса, известные
53
+ // значения секретов и присваивания TOKEN=/password: вырезаются.
54
+ if (typeof payload.error === "string") {
55
+ payload.error = redactSecretsInText(payload.error);
56
+ }
57
+ if (typeof payload.reason === "string") {
58
+ payload.reason = redactSecretsInText(payload.reason);
59
+ }
51
60
  fs.appendFileSync(STRUCTURED_LOG_FILE, `${JSON.stringify(payload)}\n`, "utf8");
52
61
  return true;
53
62
  }
@@ -0,0 +1,45 @@
1
+ /**
2
+ * Telegram Bot API: отправка уведомлений (Спринт 25).
3
+ *
4
+ * Модуль намеренно не зависит от настроек и сетевого слоя приложения:
5
+ * всё, что нужно, передаётся аргументами. Это позволяет тестировать
6
+ * экранирование и сборку запроса без реальных вызовов Telegram.
7
+ */
8
+ export type TelegramParseMode = "" | "HTML" | "Markdown" | "MarkdownV2";
9
+ export interface TelegramSendOptions {
10
+ /** База API; по умолчанию https://api.telegram.org. */
11
+ apiBase?: string;
12
+ /** Разметка; пусто — plain text. */
13
+ parseMode?: TelegramParseMode;
14
+ /** Отправить без звука. */
15
+ disableNotification?: boolean;
16
+ /** ID темы форума, если указан. */
17
+ messageThreadId?: number | null;
18
+ /** Добавить ссылку на дашборд. */
19
+ includeDashboardLink?: boolean;
20
+ /** URL дашборда; null/пусто — ссылка не добавляется. */
21
+ dashboardUrl?: string | null;
22
+ /** Таймаут запроса в мс. */
23
+ timeoutMs?: number;
24
+ /** Подмена fetch для тестов. */
25
+ fetchImpl?: typeof fetch;
26
+ }
27
+ /** Экранирует текст под выбранный parse_mode. */
28
+ export declare function escapeTelegramText(text: string, parseMode?: TelegramParseMode): string;
29
+ /**
30
+ * Готовит текст сообщения: экранирует пользовательские данные и добавляет
31
+ * ссылку на дашборд в разметке выбранного режима.
32
+ */
33
+ export declare function formatTelegramText(text: string, parseMode?: TelegramParseMode, dashboardUrl?: string | null): string;
34
+ /** Проверяет формат токена бота; возвращает trimmed-значение. */
35
+ export declare function validateTelegramToken(token: string): string;
36
+ /** Маскирует токен для сообщений об ошибках и логов. */
37
+ export declare function maskTelegramToken(token: string): string;
38
+ /**
39
+ * Отправляет сообщение через Bot API `sendMessage`.
40
+ *
41
+ * Бросает Error с безопасным текстом (токен замаскирован). Вызывающий код
42
+ * обязан перехватить ошибку, чтобы уведомление не ломало задачу.
43
+ */
44
+ export declare function sendTelegramMessage(token: string, chatId: string, text: string, options?: TelegramSendOptions): Promise<void>;
45
+ //# sourceMappingURL=telegram.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"telegram.d.ts","sourceRoot":"","sources":["../../src/core/telegram.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,MAAM,MAAM,iBAAiB,GAAG,EAAE,GAAG,MAAM,GAAG,UAAU,GAAG,YAAY,CAAC;AAKxE,MAAM,WAAW,mBAAmB;IAClC,uDAAuD;IACvD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,oCAAoC;IACpC,SAAS,CAAC,EAAE,iBAAiB,CAAC;IAC9B,2BAA2B;IAC3B,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B,mCAAmC;IACnC,eAAe,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,kCAAkC;IAClC,oBAAoB,CAAC,EAAE,OAAO,CAAC;IAC/B,wDAAwD;IACxD,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,4BAA4B;IAC5B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,gCAAgC;IAChC,SAAS,CAAC,EAAE,OAAO,KAAK,CAAC;CAC1B;AAED,iDAAiD;AACjD,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,MAAM,EACZ,SAAS,GAAE,iBAAsB,GAChC,MAAM,CAeR;AAYD;;;GAGG;AACH,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,MAAM,EACZ,SAAS,GAAE,iBAAsB,EACjC,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,GAC3B,MAAM,CAiBR;AAED,iEAAiE;AACjE,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAW3D;AAED,wDAAwD;AACxD,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CASvD;AAsBD;;;;;GAKG;AACH,wBAAsB,mBAAmB,CACvC,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,EACZ,OAAO,GAAE,mBAAwB,GAChC,OAAO,CAAC,IAAI,CAAC,CAwEf"}