agent-steward 0.0.3 → 0.0.4

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 (171) hide show
  1. package/CHANGELOG.md +20 -0
  2. package/README.md +3 -3
  3. package/ROADMAP-STRATEGY.md +9 -9
  4. package/ROADMAP.md +50 -34
  5. package/dist/core/dlq-api.d.ts +44 -0
  6. package/dist/core/dlq-api.d.ts.map +1 -0
  7. package/dist/core/dlq-api.js +68 -0
  8. package/dist/core/dry-run.d.ts.map +1 -1
  9. package/dist/core/dry-run.js +18 -1
  10. package/dist/core/lock.d.ts +20 -4
  11. package/dist/core/lock.d.ts.map +1 -1
  12. package/dist/core/lock.js +97 -22
  13. package/dist/core/one-shot.d.ts +5 -1
  14. package/dist/core/one-shot.d.ts.map +1 -1
  15. package/dist/core/one-shot.js +33 -8
  16. package/dist/core/opencode-cli.d.ts +28 -0
  17. package/dist/core/opencode-cli.d.ts.map +1 -0
  18. package/dist/core/opencode-cli.js +74 -0
  19. package/dist/core/opencode-models.d.ts +62 -0
  20. package/dist/core/opencode-models.d.ts.map +1 -0
  21. package/dist/core/opencode-models.js +277 -0
  22. package/dist/core/ps-wrapper.d.ts +1 -1
  23. package/dist/core/ps-wrapper.d.ts.map +1 -1
  24. package/dist/core/ps-wrapper.js +11 -1
  25. package/dist/core/record-history.d.ts +15 -0
  26. package/dist/core/record-history.d.ts.map +1 -1
  27. package/dist/core/record-history.js +56 -32
  28. package/dist/core/router/dispatch.d.ts +36 -0
  29. package/dist/core/router/dispatch.d.ts.map +1 -0
  30. package/dist/core/router/dispatch.js +59 -0
  31. package/dist/core/router/escalation.d.ts +47 -0
  32. package/dist/core/router/escalation.d.ts.map +1 -0
  33. package/dist/core/router/escalation.js +87 -0
  34. package/dist/core/router/planner.d.ts +53 -0
  35. package/dist/core/router/planner.d.ts.map +1 -0
  36. package/dist/core/router/planner.js +113 -0
  37. package/dist/core/router/rules.d.ts +46 -0
  38. package/dist/core/router/rules.d.ts.map +1 -0
  39. package/dist/core/router/rules.js +85 -0
  40. package/dist/core/run-panel-api.d.ts +94 -0
  41. package/dist/core/run-panel-api.d.ts.map +1 -0
  42. package/dist/core/run-panel-api.js +169 -0
  43. package/dist/core/schedule-gate.js +5 -1
  44. package/dist/core/schedule-v2.d.ts +34 -0
  45. package/dist/core/schedule-v2.d.ts.map +1 -1
  46. package/dist/core/schedule-v2.js +91 -5
  47. package/dist/core/scheduler/at-fallback.d.ts +55 -2
  48. package/dist/core/scheduler/at-fallback.d.ts.map +1 -1
  49. package/dist/core/scheduler/at-fallback.js +135 -5
  50. package/dist/core/scheduler/linux.d.ts +10 -1
  51. package/dist/core/scheduler/linux.d.ts.map +1 -1
  52. package/dist/core/scheduler/linux.js +29 -11
  53. package/dist/core/scheduler/posix.d.ts.map +1 -1
  54. package/dist/core/scheduler/posix.js +25 -1
  55. package/dist/core/scheduler/registry.d.ts +11 -0
  56. package/dist/core/scheduler/registry.d.ts.map +1 -1
  57. package/dist/core/scheduler/registry.js +83 -21
  58. package/dist/core/scheduler/run-now.d.ts +16 -0
  59. package/dist/core/scheduler/run-now.d.ts.map +1 -0
  60. package/dist/core/scheduler/run-now.js +28 -0
  61. package/dist/core/secrets.d.ts.map +1 -1
  62. package/dist/core/secrets.js +125 -28
  63. package/dist/core/session.d.ts.map +1 -1
  64. package/dist/core/session.js +18 -11
  65. package/dist/core/task-name.d.ts +24 -0
  66. package/dist/core/task-name.d.ts.map +1 -0
  67. package/dist/core/task-name.js +40 -0
  68. package/dist/core/wrappers/bash.d.ts.map +1 -1
  69. package/dist/core/wrappers/bash.js +49 -4
  70. package/dist/db/capability-repo.d.ts +83 -0
  71. package/dist/db/capability-repo.d.ts.map +1 -0
  72. package/dist/db/capability-repo.js +182 -0
  73. package/dist/db/history-repo.d.ts +8 -0
  74. package/dist/db/history-repo.d.ts.map +1 -1
  75. package/dist/db/history-repo.js +19 -0
  76. package/dist/db/index.d.ts +4 -0
  77. package/dist/db/index.d.ts.map +1 -1
  78. package/dist/db/index.js +39 -1
  79. package/dist/db/migrate.d.ts.map +1 -1
  80. package/dist/db/migrate.js +3 -1
  81. package/dist/db/run-context.d.ts +103 -0
  82. package/dist/db/run-context.d.ts.map +1 -0
  83. package/dist/db/run-context.js +224 -0
  84. package/dist/db/run-dlq.d.ts +100 -0
  85. package/dist/db/run-dlq.d.ts.map +1 -0
  86. package/dist/db/run-dlq.js +191 -0
  87. package/dist/db/run-resume.d.ts +5 -2
  88. package/dist/db/run-resume.d.ts.map +1 -1
  89. package/dist/db/run-resume.js +30 -11
  90. package/dist/db/runs-repo.d.ts +13 -5
  91. package/dist/db/runs-repo.d.ts.map +1 -1
  92. package/dist/db/runs-repo.js +28 -5
  93. package/dist/db/schema.d.ts +2 -2
  94. package/dist/db/schema.d.ts.map +1 -1
  95. package/dist/db/schema.js +154 -2
  96. package/dist/db/settings-repo.d.ts +11 -0
  97. package/dist/db/settings-repo.d.ts.map +1 -1
  98. package/dist/db/settings-repo.js +25 -0
  99. package/dist/db/step-idempotency.d.ts +51 -0
  100. package/dist/db/step-idempotency.d.ts.map +1 -0
  101. package/dist/db/step-idempotency.js +136 -0
  102. package/dist/index.d.ts +4 -4
  103. package/dist/index.d.ts.map +1 -1
  104. package/dist/index.js +102 -4
  105. package/dist/rpc.d.ts +678 -0
  106. package/dist/rpc.d.ts.map +1 -1
  107. package/dist/rpc.js +235 -0
  108. package/dist/server.d.ts +31 -0
  109. package/dist/server.d.ts.map +1 -1
  110. package/dist/server.js +95 -35
  111. package/dist/types.d.ts.map +1 -1
  112. package/dist/types.js +7 -0
  113. package/dist/workspaces.d.ts +25 -3
  114. package/dist/workspaces.d.ts.map +1 -1
  115. package/dist/workspaces.js +43 -8
  116. package/docs/ARCHITECTURE.md +229 -5
  117. package/docs/CONCEPT.md +171 -91
  118. package/docs/EXECUTION-LOOP.md +196 -0
  119. package/docs/README.ru.md +2 -2
  120. package/docs/README.zh.md +3 -3
  121. package/docs/SAFETY.md +122 -0
  122. package/docs/SAVINGS.md +29 -0
  123. package/docs/SAVINGS.ru.md +29 -0
  124. package/docs/SAVINGS.zh.md +18 -0
  125. package/gui-experimental.cjs +8 -8
  126. package/locales/en.json +67 -0
  127. package/locales/ru.json +67 -0
  128. package/locales/zh.json +67 -0
  129. package/package.json +28 -3
  130. package/scripts/audit-bundle.mjs +215 -0
  131. package/src/core/dlq-api.ts +98 -0
  132. package/src/core/dry-run.ts +25 -1
  133. package/src/core/lock.ts +95 -22
  134. package/src/core/one-shot.ts +36 -8
  135. package/src/core/opencode-cli.ts +103 -0
  136. package/src/core/opencode-models.ts +315 -0
  137. package/src/core/ps-wrapper.ts +11 -1
  138. package/src/core/record-history.ts +75 -37
  139. package/src/core/router/dispatch.ts +94 -0
  140. package/src/core/router/escalation.ts +129 -0
  141. package/src/core/router/planner.ts +166 -0
  142. package/src/core/router/rules.ts +109 -0
  143. package/src/core/run-panel-api.ts +262 -0
  144. package/src/core/schedule-gate.ts +6 -2
  145. package/src/core/schedule-v2.ts +114 -5
  146. package/src/core/scheduler/at-fallback.ts +190 -5
  147. package/src/core/scheduler/linux.ts +32 -10
  148. package/src/core/scheduler/posix.ts +20 -1
  149. package/src/core/scheduler/registry.ts +107 -26
  150. package/src/core/scheduler/run-now.ts +32 -0
  151. package/src/core/secrets.ts +127 -27
  152. package/src/core/session.ts +23 -10
  153. package/src/core/task-name.ts +67 -0
  154. package/src/core/wrappers/bash.ts +49 -4
  155. package/src/db/capability-repo.ts +285 -0
  156. package/src/db/history-repo.ts +22 -0
  157. package/src/db/index.ts +37 -1
  158. package/src/db/migrate.ts +3 -1
  159. package/src/db/run-context.ts +370 -0
  160. package/src/db/run-dlq.ts +310 -0
  161. package/src/db/run-resume.ts +48 -12
  162. package/src/db/runs-repo.ts +30 -7
  163. package/src/db/schema.ts +154 -2
  164. package/src/db/settings-repo.ts +31 -0
  165. package/src/db/step-idempotency.ts +185 -0
  166. package/src/gui.tsx +515 -0
  167. package/src/index.ts +124 -4
  168. package/src/rpc.ts +251 -0
  169. package/src/server.ts +112 -36
  170. package/src/types.ts +9 -0
  171. package/src/workspaces.ts +58 -9
@@ -1,6 +1,7 @@
1
1
  import fs from "node:fs/promises";
2
2
  import path from "node:path";
3
3
  import { getProfileDir, getProfileName } from "../../profiles.js";
4
+ import { LockManager, withLockWait } from "../lock.js";
4
5
  import type { TriggerType } from "./types.js";
5
6
 
6
7
  /**
@@ -35,10 +36,16 @@ export interface RegistryEntry {
35
36
  export class TaskRegistry {
36
37
  private readonly file: string;
37
38
  private readonly dir: string;
39
+ private readonly backendId: string;
40
+ private readonly lock: LockManager;
38
41
 
39
42
  constructor(backendId: string, profile: string = getProfileName()) {
43
+ this.backendId = backendId;
40
44
  this.dir = getProfileDir(profile);
41
45
  this.file = path.join(this.dir, `scheduler-${backendId}.json`);
46
+ // P2-16: мутации реестра — read-modify-write. Лок сериализует их между
47
+ // процессами (хост OpenCode, CLI, detached record-history).
48
+ this.lock = new LockManager(path.join(this.dir, "locks"));
42
49
  }
43
50
 
44
51
  /** Путь к файлу реестра (для диагностики). */
@@ -46,18 +53,69 @@ export class TaskRegistry {
46
53
  return this.file;
47
54
  }
48
55
 
56
+ /** Маркер того, что реестр был повреждён и перемещён в карантин. */
57
+ private get blockedPath(): string {
58
+ return `${this.file}.blocked`;
59
+ }
60
+
49
61
  async load(): Promise<RegistryEntry[]> {
62
+ let raw: string;
50
63
  try {
51
- const raw = await fs.readFile(this.file, "utf8");
52
- const parsed = JSON.parse(raw);
53
- if (!Array.isArray(parsed)) return [];
54
- return parsed.filter(
55
- (entry): entry is RegistryEntry =>
56
- entry && typeof entry.name === "string" && typeof entry.command === "string",
64
+ raw = await fs.readFile(this.file, "utf8");
65
+ } catch (err: any) {
66
+ if (err?.code === "ENOENT") {
67
+ // Карантин уже переместил файл. Пустой реестр нельзя выдавать за
68
+ // «задач нет»: rebuildCrontab вычистил бы все cron-строки плагина.
69
+ const blocked = await fs.readFile(this.blockedPath, "utf8").catch(() => null);
70
+ if (blocked) {
71
+ throw new Error(
72
+ `Реестр задач повреждён (карантин: ${blocked.trim()}). ` +
73
+ `Восстановите ${this.file} вручную или удалите маркер ${this.blockedPath}.`,
74
+ );
75
+ }
76
+ return [];
77
+ }
78
+ throw err;
79
+ }
80
+
81
+ let parsed: unknown;
82
+ try {
83
+ parsed = JSON.parse(raw);
84
+ } catch (err) {
85
+ return this.quarantineCorrupt(err);
86
+ }
87
+ if (!Array.isArray(parsed)) {
88
+ return this.quarantineCorrupt(new Error("expected an array of registry entries"));
89
+ }
90
+ return parsed.filter(
91
+ (entry): entry is RegistryEntry =>
92
+ entry && typeof entry.name === "string" && typeof entry.command === "string",
93
+ );
94
+ }
95
+
96
+ /** Перемещает повреждённый файл в карантин и блокирует дальнейшие записи. */
97
+ private async quarantineCorrupt(err: unknown): Promise<never> {
98
+ const stamp = new Date().toISOString().replace(/[:.]/g, "-");
99
+ const target = `${this.file}.corrupt-${stamp}`;
100
+ let moved = "";
101
+ try {
102
+ await fs.rename(this.file, target);
103
+ await fs.writeFile(this.blockedPath, target, "utf8");
104
+ moved = ` Файл перемещён в ${target}.`;
105
+ console.warn(
106
+ `[scheduler] Реестр ${path.basename(this.file)} повреждён и перемещён в ${target}. ` +
107
+ `Запись заблокирована маркером ${this.blockedPath}.`,
108
+ err,
109
+ );
110
+ } catch (renameErr) {
111
+ console.error(
112
+ `[scheduler] Не удалось переместить повреждённый реестр ${this.file} в ${target}.`,
113
+ renameErr,
57
114
  );
58
- } catch {
59
- return [];
60
115
  }
116
+ throw new Error(
117
+ `Реестр задач повреждён.${moved} Восстановите ${this.file} вручную или удалите маркер ${this.blockedPath}.`,
118
+ );
61
119
  }
62
120
 
63
121
  async save(entries: RegistryEntry[]): Promise<void> {
@@ -65,6 +123,28 @@ export class TaskRegistry {
65
123
  const tmp = `${this.file}.tmp`;
66
124
  await fs.writeFile(tmp, JSON.stringify(entries, null, 2), "utf8");
67
125
  await fs.rename(tmp, this.file);
126
+ await fs.rm(this.blockedPath, { force: true }).catch(() => {
127
+ /* маркера могло не быть */
128
+ });
129
+ }
130
+
131
+ /**
132
+ * Read-modify-write под межпроцессной блокировкой: два процесса на одном
133
+ * профиле не должны терять чужие записи (P2-16).
134
+ */
135
+ private async mutate<T>(fn: (entries: RegistryEntry[]) => T | Promise<T>): Promise<T> {
136
+ await this.lock.initialize();
137
+ return withLockWait(
138
+ this.lock,
139
+ `registry-${this.backendId}`,
140
+ async () => {
141
+ const entries = await this.load();
142
+ const result = await fn(entries);
143
+ await this.save(entries);
144
+ return result;
145
+ },
146
+ { timeoutMs: 15000, staleMs: 60000 },
147
+ );
68
148
  }
69
149
 
70
150
  async find(name: string): Promise<RegistryEntry | undefined> {
@@ -73,29 +153,30 @@ export class TaskRegistry {
73
153
  }
74
154
 
75
155
  async upsert(entry: RegistryEntry): Promise<void> {
76
- const entries = await this.load();
77
- const index = entries.findIndex(
78
- (e) => e.name.toLowerCase() === entry.name.toLowerCase(),
79
- );
80
- if (index === -1) entries.push(entry);
81
- else entries[index] = entry;
82
- await this.save(entries);
156
+ await this.mutate((entries) => {
157
+ const index = entries.findIndex(
158
+ (e) => e.name.toLowerCase() === entry.name.toLowerCase(),
159
+ );
160
+ if (index === -1) entries.push(entry);
161
+ else entries[index] = entry;
162
+ });
83
163
  }
84
164
 
85
165
  async remove(name: string): Promise<void> {
86
- const entries = await this.load();
87
- await this.save(
88
- entries.filter((e) => e.name.toLowerCase() !== name.toLowerCase()),
89
- );
166
+ await this.mutate((entries) => {
167
+ const index = entries.findIndex(
168
+ (e) => e.name.toLowerCase() === name.toLowerCase(),
169
+ );
170
+ if (index !== -1) entries.splice(index, 1);
171
+ });
90
172
  }
91
173
 
92
174
  async setPaused(name: string, paused: boolean): Promise<void> {
93
- const entries = await this.load();
94
- const entry = entries.find(
95
- (e) => e.name.toLowerCase() === name.toLowerCase(),
96
- );
97
- if (!entry) return;
98
- entry.paused = paused;
99
- await this.save(entries);
175
+ await this.mutate((entries) => {
176
+ const entry = entries.find(
177
+ (e) => e.name.toLowerCase() === name.toLowerCase(),
178
+ );
179
+ if (entry) entry.paused = paused;
180
+ });
100
181
  }
101
182
  }
@@ -0,0 +1,32 @@
1
+ import fs from "node:fs/promises";
2
+ import { requestImmediateRun } from "../ps-wrapper.js";
3
+ import { createSchedulerBackend } from "./index.js";
4
+ import type { RunTaskResult, SchedulerBackend } from "./types.js";
5
+
6
+ /**
7
+ * Немедленный запуск задачи в обход schedule-gate.
8
+ *
9
+ * Зачем: для poll-режима (расширенный cron / чужая IANA-таймзона / окно
10
+ * запуска) обёртка всегда прогоняет schedule-gate, и запуск вне cron-окна
11
+ * молча завершается с exit 3. Это касается не только `run_task_now`, но и
12
+ * цепочек (nextTaskOnSuccess / nextTaskOnError), DAG-зависимостей и retry:
13
+ * они тоже запускают задачу «сейчас», а не «по расписанию».
14
+ *
15
+ * Маркер `requestImmediateRun` снимает проверку расписания внутри обёртки.
16
+ * Если планировщик не принял запуск, маркер удаляется, чтобы он не «разрешил»
17
+ * следующий плановый тик в обход расписания.
18
+ */
19
+ export async function runTaskNow(
20
+ taskName: string,
21
+ backend: SchedulerBackend = createSchedulerBackend(),
22
+ ): Promise<RunTaskResult> {
23
+ const forceFile = await requestImmediateRun(taskName);
24
+ try {
25
+ return await backend.runTask(taskName);
26
+ } catch (err) {
27
+ await fs.unlink(forceFile).catch(() => {
28
+ /* маркер мог быть уже поглощён gate'ом или удалён по TTL */
29
+ });
30
+ throw err;
31
+ }
32
+ }
@@ -4,6 +4,7 @@ import os from "node:os";
4
4
  import path from "node:path";
5
5
  import { spawnSync } from "node:child_process";
6
6
  import { PLUGIN_DIR } from "../types.js";
7
+ import { isProcessAlive } from "./lock.js";
7
8
 
8
9
  /**
9
10
  * Зашифрованное хранилище секретов (Спринт 26).
@@ -26,6 +27,85 @@ export const SECRET_REF_RE = /\$\{secret:([A-Za-z0-9_.-]{1,64})\}/g;
26
27
  const SECRET_NAME_RE = /^[A-Za-z0-9_.-]{1,64}$/;
27
28
  const KEY_BYTES = 32;
28
29
 
30
+ /**
31
+ * P2-20: межпроцессная блокировка записи секретов.
32
+ *
33
+ * setSecret/deleteSecret — это read-modify-write одного JSON. Каждое завершение
34
+ * задачи может быть отдельным процессом, поэтому без лока параллельные записи
35
+ * теряли секреты. Лок синхронный: API setSecret/deleteSecret синхронный и
36
+ * используется из CLI/GUI/плагина, переписывать его на async нельзя.
37
+ */
38
+ const SECRETS_LOCK_FILE = `${SECRETS_FILE}.lock`;
39
+ const SECRETS_LOCK_STALE_MS = 10_000;
40
+ const SECRETS_LOCK_TIMEOUT_MS = 5_000;
41
+ let secretsLockDepth = 0;
42
+
43
+ function sleepSync(ms: number): void {
44
+ Atomics.wait(new Int32Array(new SharedArrayBuffer(4)), 0, 0, ms);
45
+ }
46
+
47
+ function withSecretsLock<T>(fn: () => T): T {
48
+ // Реентерабельность: loadKey()/readFileSafe() вызываются внутри setSecret.
49
+ if (secretsLockDepth > 0) {
50
+ secretsLockDepth += 1;
51
+ try {
52
+ return fn();
53
+ } finally {
54
+ secretsLockDepth -= 1;
55
+ }
56
+ }
57
+
58
+ ensureDir();
59
+ const deadline = Date.now() + SECRETS_LOCK_TIMEOUT_MS;
60
+ for (;;) {
61
+ try {
62
+ const fd = fs.openSync(SECRETS_LOCK_FILE, "wx");
63
+ try {
64
+ fs.writeFileSync(fd, String(process.pid));
65
+ } finally {
66
+ fs.closeSync(fd);
67
+ }
68
+ secretsLockDepth = 1;
69
+ break;
70
+ } catch (err: any) {
71
+ if (err?.code !== "EEXIST") throw err;
72
+ try {
73
+ const stat = fs.statSync(SECRETS_LOCK_FILE);
74
+ if (Date.now() - stat.mtimeMs > SECRETS_LOCK_STALE_MS) {
75
+ const owner = Number.parseInt(
76
+ fs.readFileSync(SECRETS_LOCK_FILE, "utf8").trim(),
77
+ 10,
78
+ );
79
+ if (!Number.isInteger(owner) || !isProcessAlive(owner)) {
80
+ fs.rmSync(SECRETS_LOCK_FILE, { force: true });
81
+ continue;
82
+ }
83
+ }
84
+ } catch {
85
+ // Лок исчез между stat и read — повторяем попытку.
86
+ }
87
+ if (Date.now() >= deadline) {
88
+ throw new Error(
89
+ "Не удалось получить блокировку хранилища секретов за " +
90
+ `${SECRETS_LOCK_TIMEOUT_MS} мс.`,
91
+ );
92
+ }
93
+ sleepSync(25);
94
+ }
95
+ }
96
+
97
+ try {
98
+ return fn();
99
+ } finally {
100
+ secretsLockDepth = 0;
101
+ try {
102
+ fs.rmSync(SECRETS_LOCK_FILE, { force: true });
103
+ } catch {
104
+ // Не критично: лок всё равно станет stale.
105
+ }
106
+ }
107
+ }
108
+
29
109
  interface StoredSecret {
30
110
  /** IV в base64 (12 байт). */
31
111
  iv: string;
@@ -161,11 +241,28 @@ function loadKey(): Buffer {
161
241
  return raw;
162
242
  } catch (err: any) {
163
243
  if (err?.code !== "ENOENT") throw err;
164
- const key = crypto.randomBytes(KEY_BYTES);
165
- fs.writeFileSync(SECRETS_KEY_FILE, key, { mode: 0o600 });
166
- chmodPrivate(SECRETS_KEY_FILE);
167
- keyCache = { stamp: `${fs.statSync(SECRETS_KEY_FILE).mtimeMs}:${KEY_BYTES}`, key };
168
- return key;
244
+ // Два процесса могли одновременно не найти ключ и сгенерировать разный.
245
+ // Под локом перечитываем файл: побеждает первый, остальные используют его ключ.
246
+ return withSecretsLock(() => {
247
+ try {
248
+ const raw = fs.readFileSync(SECRETS_KEY_FILE);
249
+ if (raw.length !== KEY_BYTES) {
250
+ throw new Error("повреждён файл ключа секретов");
251
+ }
252
+ keyCache = {
253
+ stamp: `${fs.statSync(SECRETS_KEY_FILE).mtimeMs}:${raw.length}`,
254
+ key: raw,
255
+ };
256
+ return raw;
257
+ } catch (readErr: any) {
258
+ if (readErr?.code !== "ENOENT") throw readErr;
259
+ }
260
+ const key = crypto.randomBytes(KEY_BYTES);
261
+ fs.writeFileSync(SECRETS_KEY_FILE, key, { mode: 0o600 });
262
+ chmodPrivate(SECRETS_KEY_FILE);
263
+ keyCache = { stamp: `${fs.statSync(SECRETS_KEY_FILE).mtimeMs}:${KEY_BYTES}`, key };
264
+ return key;
265
+ });
169
266
  }
170
267
  }
171
268
 
@@ -251,13 +348,11 @@ function readFileSafe(): SecretsFile {
251
348
  /** Атомарная запись: temp + rename, права 0600. */
252
349
  function writeFileSafe(file: SecretsFile): void {
253
350
  ensureDir();
254
- const tmp = `${SECRETS_FILE}.tmp`;
351
+ // Уникальный temp: два процесса не должны писать в один и тот же файл.
352
+ const tmp = `${SECRETS_FILE}.${process.pid}.${Date.now()}.tmp`;
255
353
  fs.writeFileSync(tmp, JSON.stringify(file, null, 2), { encoding: "utf8", mode: 0o600 });
256
- try {
257
- fs.rmSync(SECRETS_FILE, { force: true });
258
- } catch {
259
- // файла нет — не ошибка
260
- }
354
+ // Без предварительного rm: rename на POSIX и Windows атомарно заменяет файл,
355
+ // а rm открывал окно, в котором secrets.json отсутствовал при краше.
261
356
  fs.renameSync(tmp, SECRETS_FILE);
262
357
  chmodPrivate(SECRETS_FILE);
263
358
  try {
@@ -305,15 +400,17 @@ export function setSecret(name: string, value: string): SecretListItem {
305
400
  }
306
401
  const secretName = validateSecretName(name);
307
402
  const text = String(value ?? "");
308
- const key = loadKey();
309
- const file = readFileSafe();
310
- file.secrets[secretName] = encryptValue(secretName, text, key);
311
- writeFileSafe(file);
312
- return {
313
- name: secretName,
314
- preview: previewOf(text),
315
- updatedAt: file.secrets[secretName].updatedAt,
316
- };
403
+ return withSecretsLock(() => {
404
+ const key = loadKey();
405
+ const file = readFileSafe();
406
+ file.secrets[secretName] = encryptValue(secretName, text, key);
407
+ writeFileSafe(file);
408
+ return {
409
+ name: secretName,
410
+ preview: previewOf(text),
411
+ updatedAt: file.secrets[secretName].updatedAt,
412
+ };
413
+ });
317
414
  }
318
415
 
319
416
  /** Читает секрет; undefined, если его нет или он не расшифровывается. */
@@ -338,11 +435,13 @@ export function hasSecret(name: string): boolean {
338
435
  /** Удаляет секрет; true — запись была. */
339
436
  export function deleteSecret(name: string): boolean {
340
437
  const secretName = validateSecretName(name);
341
- const file = readFileSafe();
342
- if (!(secretName in file.secrets)) return false;
343
- delete file.secrets[secretName];
344
- writeFileSafe(file);
345
- return true;
438
+ return withSecretsLock(() => {
439
+ const file = readFileSafe();
440
+ if (!(secretName in file.secrets)) return false;
441
+ delete file.secrets[secretName];
442
+ writeFileSafe(file);
443
+ return true;
444
+ });
346
445
  }
347
446
 
348
447
  function previewOf(value: string): string {
@@ -465,8 +564,9 @@ export function redactSecretsInText(text: unknown): string {
465
564
  }
466
565
 
467
566
  result = result.replace(
468
- /\b([A-Za-z0-9_]*(?:TOKEN|SECRET|PASSWORD|PASSWD|API_KEY|APIKEY|CREDENTIAL|AUTH)[A-Za-z0-9_]*)\b(\s*[=:]\s*)(["']?)([^\s"',;]+)\3/gi,
469
- (_match: string, key: string, sep: string, quote: string) => `${key}${sep}${quote}***${quote}`,
567
+ /(["']?)\b([A-Za-z0-9_]*(?:TOKEN|SECRET|PASSWORD|PASSWD|API_KEY|APIKEY|CREDENTIAL|AUTH)[A-Za-z0-9_]*)\b\1(\s*[=:]\s*)(["']?)([^\s"',;]+)\4/gi,
568
+ (_match: string, openQuote: string, key: string, sep: string, quote: string) =>
569
+ `${openQuote}${key}${openQuote}${sep}${quote}***${quote}`,
470
570
  );
471
571
 
472
572
  // Восстанавливаем защищённые ссылки.
@@ -1,7 +1,7 @@
1
1
  import crypto from "node:crypto";
2
2
  import fs from "node:fs/promises";
3
3
  import path from "node:path";
4
- import { execFile } from "node:child_process";
4
+ import { runOpencode } from "./opencode-cli.js";
5
5
  import { getTask, saveTask } from "../db/tasks-repo.js";
6
6
  import { appendStructuredLog } from "./structured-log.js";
7
7
  import { WRAPPER_DIR, sanitizeName } from "../types.js";
@@ -119,16 +119,29 @@ export async function rotateSessionIfNeeded(taskName: string): Promise<void> {
119
119
  const count = (def.sessionRunCount ?? 0) + 1;
120
120
 
121
121
  if (shouldRotateSession(count, maxRuns)) {
122
- const sessionId = def.sessionId;
123
- if (sessionId && isValidSessionId(sessionId)) {
124
- try {
125
- await new Promise<void>((resolve) => {
126
- execFile("opencode", ["session", "delete", sessionId], () => resolve());
127
- });
128
- } catch {
129
- // Удаление не должно мешать: просто фиксируем в логе ниже.
122
+ const oldSessionId = def.sessionId;
123
+ const hasOldSession = Boolean(oldSessionId && isValidSessionId(oldSessionId));
124
+ let deleteError: string | undefined;
125
+
126
+ if (hasOldSession && oldSessionId) {
127
+ // На Windows `opencode` — это `opencode.cmd`, который Node не запускает
128
+ // напрямую через execFile (ENOENT/EINVAL). Общий модуль сам выбирает
129
+ // cmd.exe на Windows, поэтому удаление действительно выполняется.
130
+ const result = await runOpencode(["session", "delete", oldSessionId]);
131
+ if (!result.ok) {
132
+ deleteError = result.error ?? "неизвестная ошибка";
133
+ console.warn(
134
+ `[session] Не удалось удалить сессию ${oldSessionId} задачи "${taskName}": ${deleteError}`,
135
+ );
130
136
  }
131
137
  }
138
+
139
+ const rotationNote = !hasOldSession
140
+ ? "старой сессии не было"
141
+ : deleteError
142
+ ? `старую сессию удалить не удалось (${deleteError})`
143
+ : "сессия удалена";
144
+
132
145
  const newSessionId = generateSessionId();
133
146
  await saveTask({
134
147
  ...def,
@@ -139,7 +152,7 @@ export async function rotateSessionIfNeeded(taskName: string): Promise<void> {
139
152
  appendStructuredLog({
140
153
  event: "session.rotated",
141
154
  task: taskName,
142
- reason: `maxRuns=${maxRuns} достигнут; сессия удалена, создана новая, счётчик сброшен`,
155
+ reason: `maxRuns=${maxRuns} достигнут; ${rotationNote}, создана новая, счётчик сброшен`,
143
156
  });
144
157
  } else {
145
158
  await saveTask({ ...def, sessionRunCount: count });
@@ -0,0 +1,67 @@
1
+ import { existsSync } from "node:fs";
2
+ import path from "node:path";
3
+ import { PLUGIN_DIR, WRAPPER_DIR, sanitizeName } from "../types.js";
4
+
5
+ /**
6
+ * P1-10: разные имена задач могут сжаться в один sanitized-идентификатор
7
+ * («my task» и «my-task» → «my-task»), после чего делят wrapper, prompt,
8
+ * lock и log. При создании новой задачи такую коллизию нужно отклонить,
9
+ * иначе вторая задача молча перезапишет файлы первой.
10
+ */
11
+ export type SanitizedConflict =
12
+ | { kind: "task"; taskName: string }
13
+ | { kind: "file"; file: string };
14
+
15
+ /**
16
+ * Ищет конфликт sanitized-имени среди существующих задач и их артефактов.
17
+ *
18
+ * @param name имя создаваемой задачи;
19
+ * @param existingNames имена уже существующих задач (без самой создаваемой);
20
+ * @param artifactExists проверка существования файла — подменяется в тестах.
21
+ */
22
+ export function findSanitizedNameConflict(
23
+ name: string,
24
+ existingNames: readonly string[],
25
+ artifactExists: (file: string) => boolean = existsSync,
26
+ ): SanitizedConflict | null {
27
+ const sanitized = sanitizeName(name);
28
+ const self = name.toLowerCase();
29
+
30
+ const dbConflict = existingNames.find(
31
+ (existing) =>
32
+ existing.toLowerCase() !== self && sanitizeName(existing) === sanitized,
33
+ );
34
+ if (dbConflict) {
35
+ return { kind: "task", taskName: dbConflict };
36
+ }
37
+
38
+ // Осиротевшие артефакты: в БД задачи уже нет, но файлы остались.
39
+ // Перезапись промпта/обёртки молча сломала бы такую задачу.
40
+ const artifacts = [
41
+ path.join(WRAPPER_DIR, `run-${sanitized}.cmd`),
42
+ path.join(WRAPPER_DIR, `run-${sanitized}.sh`),
43
+ path.join(PLUGIN_DIR, "prompts", `${sanitized}.txt`),
44
+ ];
45
+ const orphan = artifacts.find((file) => artifactExists(file));
46
+ if (orphan) {
47
+ return { kind: "file", file: orphan };
48
+ }
49
+ return null;
50
+ }
51
+
52
+ /** Человекочитаемое объяснение конфликта для ошибки создания задачи. */
53
+ export function sanitizedConflictMessage(
54
+ name: string,
55
+ conflict: SanitizedConflict,
56
+ ): string {
57
+ const sanitized = sanitizeName(name);
58
+ const reason =
59
+ conflict.kind === "task"
60
+ ? `существующая задача «${conflict.taskName}»`
61
+ : `оставшиеся файлы задачи (${conflict.file})`;
62
+ return (
63
+ `Имя задачи «${name}» приводит к тому же имени файла «${sanitized}», ` +
64
+ `что и ${reason}. Выберите другое имя` +
65
+ (conflict.kind === "file" ? " или удалите старые файлы." : ".")
66
+ );
67
+ }
@@ -140,6 +140,9 @@ export function buildBashWrapperScript(options: BashWrapperOptions): string {
140
140
  `WORKDIR=${shellQuote(workdir || process.cwd())}`,
141
141
  `WORKSPACE_NAME=${shellQuote(workspaceName ?? "")}`,
142
142
  `TIMEOUT_SECONDS=${Number.isFinite(timeoutSeconds) ? Math.max(0, Math.floor(timeoutSeconds)) : 3600}`,
143
+ // Маркер сработавшего watchdog: по нему обёртка отличает таймаут от
144
+ // обычного ненулевого кода возврата (SIGTERM/SIGKILL неотличимы от падения).
145
+ `TIMEOUT_MARKER=${shellQuote(`${lockFile}.timeout`)}`,
143
146
  `RECORDER_FILE=${shellQuote(recorderFile ?? "")}`,
144
147
  `QUALITY_GATE=${shellQuote(qualityGate ?? "")}`,
145
148
  `MODEL=${shellQuote(model ?? "")}`,
@@ -207,7 +210,18 @@ export function buildBashWrapperScript(options: BashWrapperOptions): string {
207
210
  ' "$@" &',
208
211
  " GATE_CHILD=$!",
209
212
  " set +m 2>/dev/null || true",
210
- ' ( sleep "$GATE_LIMIT"; kill -TERM -- "-$GATE_CHILD" 2>/dev/null || kill -TERM "$GATE_CHILD" 2>/dev/null; sleep 5; kill -KILL -- "-$GATE_CHILD" 2>/dev/null || kill -KILL "$GATE_CHILD" 2>/dev/null ) >/dev/null 2>&1 &',
213
+ " (",
214
+ " WD_SLEEP_PID=",
215
+ " trap 'if [ -n \"$WD_SLEEP_PID\" ]; then kill \"$WD_SLEEP_PID\" 2>/dev/null || true; fi; exit 0' TERM INT",
216
+ ' sleep "$GATE_LIMIT" &',
217
+ " WD_SLEEP_PID=$!",
218
+ ' wait "$WD_SLEEP_PID" 2>/dev/null || true',
219
+ ' kill -TERM -- "-$GATE_CHILD" 2>/dev/null || kill -TERM "$GATE_CHILD" 2>/dev/null',
220
+ " sleep 5 &",
221
+ " WD_SLEEP_PID=$!",
222
+ ' wait "$WD_SLEEP_PID" 2>/dev/null || true',
223
+ ' kill -KILL -- "-$GATE_CHILD" 2>/dev/null || kill -KILL "$GATE_CHILD" 2>/dev/null',
224
+ " ) >/dev/null 2>&1 &",
211
225
  " GATE_WATCHDOG=$!",
212
226
  ' wait "$GATE_CHILD"',
213
227
  " GATE_CODE=$?",
@@ -291,6 +305,14 @@ export function buildBashWrapperScript(options: BashWrapperOptions): string {
291
305
  ' env_value="${env_line#*=}"',
292
306
  ' case "$env_key" in *[!A-Za-z0-9_]*) continue ;; esac',
293
307
  ' case "$env_key" in [A-Za-z_]*) ;; *) continue ;; esac',
308
+ // P2-21: неразрешённая ссылка означает, что секрет удалён/переименован.
309
+ // Запускать агента с литералом "${secret:NAME}" нельзя — fail closed.
310
+ ' case "$env_value" in',
311
+ " *'${secret:'*)",
312
+ ' log "[scheduler] ОШИБКА: переменная $env_key содержит неразрешённый секрет (\\${secret:...}). Запуск отменён."',
313
+ " exit 78",
314
+ " ;;",
315
+ " esac",
294
316
  ' export "$env_key=$env_value"',
295
317
  ' done < "$ENV_FILE"',
296
318
  ' log "[scheduler] Переменные окружения workspace загружены."',
@@ -402,12 +424,26 @@ export function buildBashWrapperScript(options: BashWrapperOptions): string {
402
424
  "# T-10: как и в run_with_timeout, opencode запускается в собственной группе",
403
425
  "# процессов (exec внутри run_opencode сохраняет лидера группы), поэтому",
404
426
  "# watchdog убивает всё дерево, а внуки не переживают таймаут.",
427
+ // Маркер мог остаться от предыдущего запуска (краш до очистки).
428
+ 'rm -f "$TIMEOUT_MARKER" 2>/dev/null || true',
405
429
  "set -m 2>/dev/null || true",
406
430
  'run_opencode >> "$LOG_FILE" 2>&1 &',
407
431
  "CHILD=$!",
408
432
  "set +m 2>/dev/null || true",
409
433
  'if [ "$TIMEOUT_SECONDS" -gt 0 ] 2>/dev/null; then',
410
- ' ( sleep "$TIMEOUT_SECONDS"; kill -TERM -- "-$CHILD" 2>/dev/null || kill -TERM "$CHILD" 2>/dev/null; sleep 5; kill -KILL -- "-$CHILD" 2>/dev/null || kill -KILL "$CHILD" 2>/dev/null ) &',
434
+ " (",
435
+ " WD_SLEEP_PID=",
436
+ " trap 'if [ -n \"$WD_SLEEP_PID\" ]; then kill \"$WD_SLEEP_PID\" 2>/dev/null || true; fi; exit 0' TERM INT",
437
+ ' sleep "$TIMEOUT_SECONDS" &',
438
+ " WD_SLEEP_PID=$!",
439
+ ' wait "$WD_SLEEP_PID" 2>/dev/null || true',
440
+ ' : > "$TIMEOUT_MARKER" 2>/dev/null || true',
441
+ ' kill -TERM -- "-$CHILD" 2>/dev/null || kill -TERM "$CHILD" 2>/dev/null',
442
+ " sleep 5 &",
443
+ " WD_SLEEP_PID=$!",
444
+ ' wait "$WD_SLEEP_PID" 2>/dev/null || true',
445
+ ' kill -KILL -- "-$CHILD" 2>/dev/null || kill -KILL "$CHILD" 2>/dev/null',
446
+ " ) &",
411
447
  " WATCHDOG=$!",
412
448
  "fi",
413
449
  'wait "$CHILD"',
@@ -419,7 +455,15 @@ export function buildBashWrapperScript(options: BashWrapperOptions): string {
419
455
  "",
420
456
  "# Конфиг прав живёт только в переменной окружения — файл не создаётся.",
421
457
  "",
422
- 'if [ "$EXIT_CODE" -ne 0 ]; then',
458
+ "TIMED_OUT=0",
459
+ 'if [ -f "$TIMEOUT_MARKER" ]; then',
460
+ " TIMED_OUT=1",
461
+ " EXIT_CODE=124",
462
+ // 124 — общепринятый код coreutils timeout; маркер нужен, потому что
463
+ // SIGTERM/SIGKILL сами по себе неотличимы от обычного падения.
464
+ ' ERROR_MESSAGE="Таймаут: превышено ${TIMEOUT_SECONDS} с"',
465
+ ' log "[scheduler] Задача \'$TASK_NAME\' прервана по таймауту (${TIMEOUT_SECONDS} с)."',
466
+ 'elif [ "$EXIT_CODE" -ne 0 ]; then',
423
467
  ' log "[scheduler] Задача \'$TASK_NAME\' завершилась с кодом $EXIT_CODE."',
424
468
  ' ERROR_MESSAGE="Код возврата $EXIT_CODE"',
425
469
  "else",
@@ -462,7 +506,8 @@ export function buildBashWrapperScript(options: BashWrapperOptions): string {
462
506
  'END_EPOCH="$(date +%s)"',
463
507
  "DURATION_MS=$(( (END_EPOCH - START_EPOCH) * 1000 ))",
464
508
  'STATUS="error"',
465
- 'if [ "$EXIT_CODE" -eq 0 ]; then STATUS="success"; fi',
509
+ 'if [ "$TIMED_OUT" -eq 1 ]; then STATUS="timeout"; elif [ "$EXIT_CODE" -eq 0 ]; then STATUS="success"; fi',
510
+ 'rm -f "$TIMEOUT_MARKER" 2>/dev/null || true',
466
511
  "",
467
512
  'if [ -n "$RECORDER_FILE" ] && command -v node >/dev/null 2>&1; then',
468
513
  ' if [ -n "$RUN_ID" ]; then',