agent-steward 0.0.3 → 0.0.5

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 (287) hide show
  1. package/CHANGELOG.md +154 -2
  2. package/CROSS_PLATFORM.md +19 -0
  3. package/README.md +54 -9
  4. package/ROADMAP-STRATEGY.md +23 -20
  5. package/ROADMAP.md +140 -143
  6. package/dist/cli.d.ts +3 -0
  7. package/dist/cli.d.ts.map +1 -0
  8. package/dist/cli.js +351 -0
  9. package/dist/core/dlq-api.d.ts +44 -0
  10. package/dist/core/dlq-api.d.ts.map +1 -0
  11. package/dist/core/dlq-api.js +68 -0
  12. package/dist/core/dry-run.d.ts.map +1 -1
  13. package/dist/core/dry-run.js +18 -1
  14. package/dist/core/execution.d.ts +203 -0
  15. package/dist/core/execution.d.ts.map +1 -0
  16. package/dist/core/execution.js +309 -0
  17. package/dist/core/gate-integrity.d.ts +35 -0
  18. package/dist/core/gate-integrity.d.ts.map +1 -0
  19. package/dist/core/gate-integrity.js +132 -0
  20. package/dist/core/git-trigger.d.ts.map +1 -1
  21. package/dist/core/git-trigger.js +14 -2
  22. package/dist/core/guard-run.d.ts +4 -0
  23. package/dist/core/guard-run.d.ts.map +1 -0
  24. package/dist/core/guard-run.js +101 -0
  25. package/dist/core/guard.d.ts +52 -0
  26. package/dist/core/guard.d.ts.map +1 -0
  27. package/dist/core/guard.js +362 -0
  28. package/dist/core/lock.d.ts +61 -4
  29. package/dist/core/lock.d.ts.map +1 -1
  30. package/dist/core/lock.js +213 -26
  31. package/dist/core/matrix.d.ts.map +1 -1
  32. package/dist/core/matrix.js +75 -15
  33. package/dist/core/mission.d.ts +83 -0
  34. package/dist/core/mission.d.ts.map +1 -0
  35. package/dist/core/mission.js +334 -0
  36. package/dist/core/one-shot.d.ts +5 -1
  37. package/dist/core/one-shot.d.ts.map +1 -1
  38. package/dist/core/one-shot.js +33 -8
  39. package/dist/core/opencode-cli.d.ts +28 -0
  40. package/dist/core/opencode-cli.d.ts.map +1 -0
  41. package/dist/core/opencode-cli.js +74 -0
  42. package/dist/core/opencode-models.d.ts +62 -0
  43. package/dist/core/opencode-models.d.ts.map +1 -0
  44. package/dist/core/opencode-models.js +277 -0
  45. package/dist/core/pipeline-apply.d.ts +38 -0
  46. package/dist/core/pipeline-apply.d.ts.map +1 -0
  47. package/dist/core/pipeline-apply.js +117 -0
  48. package/dist/core/pipeline-io.d.ts +13 -0
  49. package/dist/core/pipeline-io.d.ts.map +1 -0
  50. package/dist/core/pipeline-io.js +64 -0
  51. package/dist/core/pipeline-map.d.ts +46 -0
  52. package/dist/core/pipeline-map.d.ts.map +1 -0
  53. package/dist/core/pipeline-map.js +196 -0
  54. package/dist/core/pipeline-spec.d.ts +109 -0
  55. package/dist/core/pipeline-spec.d.ts.map +1 -0
  56. package/dist/core/pipeline-spec.js +554 -0
  57. package/dist/core/ps-wrapper.d.ts +19 -2
  58. package/dist/core/ps-wrapper.d.ts.map +1 -1
  59. package/dist/core/ps-wrapper.js +261 -63
  60. package/dist/core/record-history.d.ts +15 -0
  61. package/dist/core/record-history.d.ts.map +1 -1
  62. package/dist/core/record-history.js +183 -58
  63. package/dist/core/router/dispatch.d.ts +36 -0
  64. package/dist/core/router/dispatch.d.ts.map +1 -0
  65. package/dist/core/router/dispatch.js +59 -0
  66. package/dist/core/router/escalation.d.ts +47 -0
  67. package/dist/core/router/escalation.d.ts.map +1 -0
  68. package/dist/core/router/escalation.js +87 -0
  69. package/dist/core/router/planner.d.ts +53 -0
  70. package/dist/core/router/planner.d.ts.map +1 -0
  71. package/dist/core/router/planner.js +113 -0
  72. package/dist/core/router/rules.d.ts +46 -0
  73. package/dist/core/router/rules.d.ts.map +1 -0
  74. package/dist/core/router/rules.js +91 -0
  75. package/dist/core/run-panel-api.d.ts +94 -0
  76. package/dist/core/run-panel-api.d.ts.map +1 -0
  77. package/dist/core/run-panel-api.js +169 -0
  78. package/dist/core/schedule-gate.js +5 -1
  79. package/dist/core/schedule-v2.d.ts +34 -0
  80. package/dist/core/schedule-v2.d.ts.map +1 -1
  81. package/dist/core/schedule-v2.js +91 -5
  82. package/dist/core/scheduler/at-fallback.d.ts +55 -2
  83. package/dist/core/scheduler/at-fallback.d.ts.map +1 -1
  84. package/dist/core/scheduler/at-fallback.js +135 -5
  85. package/dist/core/scheduler/linux.d.ts +18 -2
  86. package/dist/core/scheduler/linux.d.ts.map +1 -1
  87. package/dist/core/scheduler/linux.js +63 -20
  88. package/dist/core/scheduler/mac.d.ts +44 -2
  89. package/dist/core/scheduler/mac.d.ts.map +1 -1
  90. package/dist/core/scheduler/mac.js +126 -15
  91. package/dist/core/scheduler/posix.d.ts.map +1 -1
  92. package/dist/core/scheduler/posix.js +25 -1
  93. package/dist/core/scheduler/registry.d.ts +11 -0
  94. package/dist/core/scheduler/registry.d.ts.map +1 -1
  95. package/dist/core/scheduler/registry.js +83 -21
  96. package/dist/core/scheduler/run-now.d.ts +16 -0
  97. package/dist/core/scheduler/run-now.d.ts.map +1 -0
  98. package/dist/core/scheduler/run-now.js +28 -0
  99. package/dist/core/scheduler/windows.d.ts.map +1 -1
  100. package/dist/core/scheduler/windows.js +15 -12
  101. package/dist/core/secrets.d.ts.map +1 -1
  102. package/dist/core/secrets.js +125 -28
  103. package/dist/core/session.d.ts.map +1 -1
  104. package/dist/core/session.js +18 -11
  105. package/dist/core/structured-log.d.ts +7 -1
  106. package/dist/core/structured-log.d.ts.map +1 -1
  107. package/dist/core/task-name.d.ts +24 -0
  108. package/dist/core/task-name.d.ts.map +1 -0
  109. package/dist/core/task-name.js +40 -0
  110. package/dist/core/worktree-run.d.ts +4 -0
  111. package/dist/core/worktree-run.d.ts.map +1 -0
  112. package/dist/core/worktree-run.js +164 -0
  113. package/dist/core/worktree.d.ts +115 -0
  114. package/dist/core/worktree.d.ts.map +1 -0
  115. package/dist/core/worktree.js +462 -0
  116. package/dist/core/wrappers/bash.d.ts +17 -0
  117. package/dist/core/wrappers/bash.d.ts.map +1 -1
  118. package/dist/core/wrappers/bash.js +224 -28
  119. package/dist/db/capability-repo.d.ts +124 -0
  120. package/dist/db/capability-repo.d.ts.map +1 -0
  121. package/dist/db/capability-repo.js +267 -0
  122. package/dist/db/history-repo.d.ts +46 -5
  123. package/dist/db/history-repo.d.ts.map +1 -1
  124. package/dist/db/history-repo.js +107 -25
  125. package/dist/db/index.d.ts +4 -0
  126. package/dist/db/index.d.ts.map +1 -1
  127. package/dist/db/index.js +39 -1
  128. package/dist/db/metrics-repo.js +2 -2
  129. package/dist/db/migrate.d.ts.map +1 -1
  130. package/dist/db/migrate.js +3 -1
  131. package/dist/db/recovery.d.ts.map +1 -1
  132. package/dist/db/recovery.js +5 -4
  133. package/dist/db/run-context.d.ts +103 -0
  134. package/dist/db/run-context.d.ts.map +1 -0
  135. package/dist/db/run-context.js +224 -0
  136. package/dist/db/run-dlq.d.ts +100 -0
  137. package/dist/db/run-dlq.d.ts.map +1 -0
  138. package/dist/db/run-dlq.js +191 -0
  139. package/dist/db/run-journal.d.ts +33 -5
  140. package/dist/db/run-journal.d.ts.map +1 -1
  141. package/dist/db/run-journal.js +78 -14
  142. package/dist/db/run-resume.d.ts +10 -2
  143. package/dist/db/run-resume.d.ts.map +1 -1
  144. package/dist/db/run-resume.js +39 -13
  145. package/dist/db/runs-repo.d.ts +32 -7
  146. package/dist/db/runs-repo.d.ts.map +1 -1
  147. package/dist/db/runs-repo.js +50 -11
  148. package/dist/db/schema.d.ts +2 -2
  149. package/dist/db/schema.d.ts.map +1 -1
  150. package/dist/db/schema.js +216 -3
  151. package/dist/db/settings-repo.d.ts +11 -0
  152. package/dist/db/settings-repo.d.ts.map +1 -1
  153. package/dist/db/settings-repo.js +25 -0
  154. package/dist/db/step-idempotency.d.ts +51 -0
  155. package/dist/db/step-idempotency.d.ts.map +1 -0
  156. package/dist/db/step-idempotency.js +136 -0
  157. package/dist/history.d.ts +1 -1
  158. package/dist/history.d.ts.map +1 -1
  159. package/dist/i18n.d.ts +5 -0
  160. package/dist/i18n.d.ts.map +1 -1
  161. package/dist/i18n.js +11 -4
  162. package/dist/index.d.ts +140 -6
  163. package/dist/index.d.ts.map +1 -1
  164. package/dist/index.js +480 -18
  165. package/dist/notifications.d.ts +22 -0
  166. package/dist/notifications.d.ts.map +1 -1
  167. package/dist/notifications.js +36 -8
  168. package/dist/profiles.d.ts.map +1 -1
  169. package/dist/profiles.js +25 -4
  170. package/dist/rpc.d.ts +924 -0
  171. package/dist/rpc.d.ts.map +1 -1
  172. package/dist/rpc.js +352 -0
  173. package/dist/server.d.ts +46 -0
  174. package/dist/server.d.ts.map +1 -1
  175. package/dist/server.js +172 -53
  176. package/dist/settings.d.ts +2 -2
  177. package/dist/settings.d.ts.map +1 -1
  178. package/dist/settings.js +3 -3
  179. package/dist/shared/jobs-view.d.ts +1 -1
  180. package/dist/shared/jobs-view.d.ts.map +1 -1
  181. package/dist/shared/jobs-view.js +2 -0
  182. package/dist/task-transfer.d.ts +16 -0
  183. package/dist/task-transfer.d.ts.map +1 -1
  184. package/dist/task-transfer.js +16 -0
  185. package/dist/types.d.ts.map +1 -1
  186. package/dist/types.js +7 -0
  187. package/dist/workspaces.d.ts +25 -3
  188. package/dist/workspaces.d.ts.map +1 -1
  189. package/dist/workspaces.js +43 -8
  190. package/docs/ARCHITECTURE.md +498 -58
  191. package/docs/COMPATIBILITY.md +2 -2
  192. package/docs/CONCEPT.md +185 -91
  193. package/docs/CROSS_PLATFORM.ru.md +20 -0
  194. package/docs/CROSS_PLATFORM.zh.md +18 -0
  195. package/docs/EXECUTION-LOOP.md +211 -0
  196. package/docs/FEATURES.md +65 -4
  197. package/docs/FEATURES.zh.md +52 -4
  198. package/docs/MIGRATION.md +2 -2
  199. package/docs/PIPELINE.md +293 -0
  200. package/docs/README.ru.md +44 -5
  201. package/docs/README.zh.md +46 -6
  202. package/docs/SAFETY.md +142 -0
  203. package/docs/SAVINGS.md +29 -0
  204. package/docs/SAVINGS.ru.md +29 -0
  205. package/docs/SAVINGS.zh.md +18 -0
  206. package/gui-experimental.cjs +9 -8
  207. package/locales/en.json +84 -1
  208. package/locales/ru.json +84 -1
  209. package/locales/zh.json +84 -1
  210. package/opencode.pipeline.yaml +35 -0
  211. package/package.json +46 -2
  212. package/scripts/audit-bundle.mjs +215 -0
  213. package/scripts/test-home.mjs +83 -0
  214. package/src/cli.ts +412 -0
  215. package/src/core/dlq-api.ts +98 -0
  216. package/src/core/dry-run.ts +27 -3
  217. package/src/core/execution.ts +538 -0
  218. package/src/core/file-watcher.ts +2 -2
  219. package/src/core/gate-integrity.ts +160 -0
  220. package/src/core/git-trigger.ts +18 -5
  221. package/src/core/guard-run.ts +119 -0
  222. package/src/core/guard.ts +431 -0
  223. package/src/core/lock.ts +244 -30
  224. package/src/core/matrix.ts +95 -50
  225. package/src/core/mission.ts +485 -0
  226. package/src/core/native-notify.ts +1 -1
  227. package/src/core/one-shot.ts +36 -8
  228. package/src/core/opencode-cli.ts +103 -0
  229. package/src/core/opencode-models.ts +315 -0
  230. package/src/core/pipeline-apply.ts +158 -0
  231. package/src/core/pipeline-io.ts +79 -0
  232. package/src/core/pipeline-map.ts +264 -0
  233. package/src/core/pipeline-spec.ts +775 -0
  234. package/src/core/ps-wrapper.ts +274 -64
  235. package/src/core/record-history.ts +229 -104
  236. package/src/core/router/dispatch.ts +94 -0
  237. package/src/core/router/escalation.ts +129 -0
  238. package/src/core/router/planner.ts +166 -0
  239. package/src/core/router/rules.ts +115 -0
  240. package/src/core/run-panel-api.ts +262 -0
  241. package/src/core/schedule-gate.ts +7 -3
  242. package/src/core/schedule-v2.ts +114 -5
  243. package/src/core/scheduler/at-fallback.ts +190 -5
  244. package/src/core/scheduler/linux.ts +72 -21
  245. package/src/core/scheduler/logs.ts +2 -2
  246. package/src/core/scheduler/mac.ts +174 -14
  247. package/src/core/scheduler/posix.ts +20 -1
  248. package/src/core/scheduler/registry.ts +107 -26
  249. package/src/core/scheduler/run-now.ts +32 -0
  250. package/src/core/scheduler/windows.ts +19 -15
  251. package/src/core/secrets.ts +131 -31
  252. package/src/core/session.ts +23 -10
  253. package/src/core/structured-log.ts +22 -5
  254. package/src/core/task-name.ts +67 -0
  255. package/src/core/telegram.ts +2 -2
  256. package/src/core/triage-worker.ts +7 -7
  257. package/src/core/triage.ts +2 -2
  258. package/src/core/worktree-run.ts +199 -0
  259. package/src/core/worktree.ts +600 -0
  260. package/src/core/wrappers/bash.ts +239 -27
  261. package/src/db/capability-repo.ts +402 -0
  262. package/src/db/history-repo.ts +151 -22
  263. package/src/db/index.ts +37 -1
  264. package/src/db/metrics-repo.ts +2 -2
  265. package/src/db/migrate.ts +3 -1
  266. package/src/db/recovery.ts +5 -4
  267. package/src/db/run-context.ts +370 -0
  268. package/src/db/run-dlq.ts +310 -0
  269. package/src/db/run-journal.ts +100 -13
  270. package/src/db/run-resume.ts +65 -13
  271. package/src/db/runs-repo.ts +66 -13
  272. package/src/db/schema.ts +218 -3
  273. package/src/db/settings-repo.ts +31 -0
  274. package/src/db/step-idempotency.ts +185 -0
  275. package/src/gui.tsx +692 -13
  276. package/src/history.ts +1 -1
  277. package/src/i18n.ts +12 -4
  278. package/src/index.ts +648 -8
  279. package/src/notifications.ts +38 -8
  280. package/src/profiles.ts +26 -4
  281. package/src/rpc.ts +379 -0
  282. package/src/server.ts +206 -54
  283. package/src/settings.ts +5 -5
  284. package/src/shared/jobs-view.ts +3 -1
  285. package/src/task-transfer.ts +31 -0
  286. package/src/types.ts +9 -0
  287. package/src/workspaces.ts +58 -9
@@ -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
  * Зашифрованное хранилище секретов (Спринт 26).
9
10
  *
@@ -23,6 +24,82 @@ export const SECRETS_KEY_FILE = path.join(PLUGIN_DIR, "secrets.key");
23
24
  export const SECRET_REF_RE = /\$\{secret:([A-Za-z0-9_.-]{1,64})\}/g;
24
25
  const SECRET_NAME_RE = /^[A-Za-z0-9_.-]{1,64}$/;
25
26
  const KEY_BYTES = 32;
27
+ /**
28
+ * P2-20: межпроцессная блокировка записи секретов.
29
+ *
30
+ * setSecret/deleteSecret — это read-modify-write одного JSON. Каждое завершение
31
+ * задачи может быть отдельным процессом, поэтому без лока параллельные записи
32
+ * теряли секреты. Лок синхронный: API setSecret/deleteSecret синхронный и
33
+ * используется из CLI/GUI/плагина, переписывать его на async нельзя.
34
+ */
35
+ const SECRETS_LOCK_FILE = `${SECRETS_FILE}.lock`;
36
+ const SECRETS_LOCK_STALE_MS = 10000;
37
+ const SECRETS_LOCK_TIMEOUT_MS = 5000;
38
+ let secretsLockDepth = 0;
39
+ function sleepSync(ms) {
40
+ Atomics.wait(new Int32Array(new SharedArrayBuffer(4)), 0, 0, ms);
41
+ }
42
+ function withSecretsLock(fn) {
43
+ // Реентерабельность: loadKey()/readFileSafe() вызываются внутри setSecret.
44
+ if (secretsLockDepth > 0) {
45
+ secretsLockDepth += 1;
46
+ try {
47
+ return fn();
48
+ }
49
+ finally {
50
+ secretsLockDepth -= 1;
51
+ }
52
+ }
53
+ ensureDir();
54
+ const deadline = Date.now() + SECRETS_LOCK_TIMEOUT_MS;
55
+ for (;;) {
56
+ try {
57
+ const fd = fs.openSync(SECRETS_LOCK_FILE, "wx");
58
+ try {
59
+ fs.writeFileSync(fd, String(process.pid));
60
+ }
61
+ finally {
62
+ fs.closeSync(fd);
63
+ }
64
+ secretsLockDepth = 1;
65
+ break;
66
+ }
67
+ catch (err) {
68
+ if (err?.code !== "EEXIST")
69
+ throw err;
70
+ try {
71
+ const stat = fs.statSync(SECRETS_LOCK_FILE);
72
+ if (Date.now() - stat.mtimeMs > SECRETS_LOCK_STALE_MS) {
73
+ const owner = Number.parseInt(fs.readFileSync(SECRETS_LOCK_FILE, "utf8").trim(), 10);
74
+ if (!Number.isInteger(owner) || !isProcessAlive(owner)) {
75
+ fs.rmSync(SECRETS_LOCK_FILE, { force: true });
76
+ continue;
77
+ }
78
+ }
79
+ }
80
+ catch {
81
+ // Лок исчез между stat и read — повторяем попытку.
82
+ }
83
+ if (Date.now() >= deadline) {
84
+ throw new Error("Не удалось получить блокировку хранилища секретов за " +
85
+ `${SECRETS_LOCK_TIMEOUT_MS} мс.`);
86
+ }
87
+ sleepSync(25);
88
+ }
89
+ }
90
+ try {
91
+ return fn();
92
+ }
93
+ finally {
94
+ secretsLockDepth = 0;
95
+ try {
96
+ fs.rmSync(SECRETS_LOCK_FILE, { force: true });
97
+ }
98
+ catch {
99
+ // Не критично: лок всё равно станет stale.
100
+ }
101
+ }
102
+ }
26
103
  let cache = null;
27
104
  let keyCache = null;
28
105
  function warn(message, err) {
@@ -118,11 +195,30 @@ function loadKey() {
118
195
  catch (err) {
119
196
  if (err?.code !== "ENOENT")
120
197
  throw err;
121
- const key = crypto.randomBytes(KEY_BYTES);
122
- fs.writeFileSync(SECRETS_KEY_FILE, key, { mode: 0o600 });
123
- chmodPrivate(SECRETS_KEY_FILE);
124
- keyCache = { stamp: `${fs.statSync(SECRETS_KEY_FILE).mtimeMs}:${KEY_BYTES}`, key };
125
- return key;
198
+ // Два процесса могли одновременно не найти ключ и сгенерировать разный.
199
+ // Под локом перечитываем файл: побеждает первый, остальные используют его ключ.
200
+ return withSecretsLock(() => {
201
+ try {
202
+ const raw = fs.readFileSync(SECRETS_KEY_FILE);
203
+ if (raw.length !== KEY_BYTES) {
204
+ throw new Error("повреждён файл ключа секретов");
205
+ }
206
+ keyCache = {
207
+ stamp: `${fs.statSync(SECRETS_KEY_FILE).mtimeMs}:${raw.length}`,
208
+ key: raw,
209
+ };
210
+ return raw;
211
+ }
212
+ catch (readErr) {
213
+ if (readErr?.code !== "ENOENT")
214
+ throw readErr;
215
+ }
216
+ const key = crypto.randomBytes(KEY_BYTES);
217
+ fs.writeFileSync(SECRETS_KEY_FILE, key, { mode: 0o600 });
218
+ chmodPrivate(SECRETS_KEY_FILE);
219
+ keyCache = { stamp: `${fs.statSync(SECRETS_KEY_FILE).mtimeMs}:${KEY_BYTES}`, key };
220
+ return key;
221
+ });
126
222
  }
127
223
  }
128
224
  function emptyFile() {
@@ -201,14 +297,11 @@ function readFileSafe() {
201
297
  /** Атомарная запись: temp + rename, права 0600. */
202
298
  function writeFileSafe(file) {
203
299
  ensureDir();
204
- const tmp = `${SECRETS_FILE}.tmp`;
300
+ // Уникальный temp: два процесса не должны писать в один и тот же файл.
301
+ const tmp = `${SECRETS_FILE}.${process.pid}.${Date.now()}.tmp`;
205
302
  fs.writeFileSync(tmp, JSON.stringify(file, null, 2), { encoding: "utf8", mode: 0o600 });
206
- try {
207
- fs.rmSync(SECRETS_FILE, { force: true });
208
- }
209
- catch {
210
- // файла нет — не ошибка
211
- }
303
+ // Без предварительного rm: rename на POSIX и Windows атомарно заменяет файл,
304
+ // а rm открывал окно, в котором secrets.json отсутствовал при краше.
212
305
  fs.renameSync(tmp, SECRETS_FILE);
213
306
  chmodPrivate(SECRETS_FILE);
214
307
  try {
@@ -248,15 +341,17 @@ export function setSecret(name, value) {
248
341
  }
249
342
  const secretName = validateSecretName(name);
250
343
  const text = String(value ?? "");
251
- const key = loadKey();
252
- const file = readFileSafe();
253
- file.secrets[secretName] = encryptValue(secretName, text, key);
254
- writeFileSafe(file);
255
- return {
256
- name: secretName,
257
- preview: previewOf(text),
258
- updatedAt: file.secrets[secretName].updatedAt,
259
- };
344
+ return withSecretsLock(() => {
345
+ const key = loadKey();
346
+ const file = readFileSafe();
347
+ file.secrets[secretName] = encryptValue(secretName, text, key);
348
+ writeFileSafe(file);
349
+ return {
350
+ name: secretName,
351
+ preview: previewOf(text),
352
+ updatedAt: file.secrets[secretName].updatedAt,
353
+ };
354
+ });
260
355
  }
261
356
  /** Читает секрет; undefined, если его нет или он не расшифровывается. */
262
357
  export function getSecret(name) {
@@ -280,12 +375,14 @@ export function hasSecret(name) {
280
375
  /** Удаляет секрет; true — запись была. */
281
376
  export function deleteSecret(name) {
282
377
  const secretName = validateSecretName(name);
283
- const file = readFileSafe();
284
- if (!(secretName in file.secrets))
285
- return false;
286
- delete file.secrets[secretName];
287
- writeFileSafe(file);
288
- return true;
378
+ return withSecretsLock(() => {
379
+ const file = readFileSafe();
380
+ if (!(secretName in file.secrets))
381
+ return false;
382
+ delete file.secrets[secretName];
383
+ writeFileSafe(file);
384
+ return true;
385
+ });
289
386
  }
290
387
  function previewOf(value) {
291
388
  const text = String(value ?? "");
@@ -400,7 +497,7 @@ export function redactSecretsInText(text) {
400
497
  continue;
401
498
  result = result.split(value).join("***");
402
499
  }
403
- 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}`);
500
+ result = result.replace(/(["']?)\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, (_match, openQuote, key, sep, quote) => `${openQuote}${key}${openQuote}${sep}${quote}***${quote}`);
404
501
  // Восстанавливаем защищённые ссылки.
405
502
  for (let i = 0; i < protectedRefs.length; i++) {
406
503
  result = result.split(`\u0000SECRET_REF_${i}\u0000`).join(protectedRefs[i]);
@@ -1 +1 @@
1
- {"version":3,"file":"session.d.ts","sourceRoot":"","sources":["../../src/core/session.ts"],"names":[],"mappings":"AAQA,eAAO,MAAM,aAAa,mCAAoC,CAAC;AAC/D,MAAM,MAAM,WAAW,GAAG,CAAC,OAAO,aAAa,CAAC,CAAC,MAAM,CAAC,CAAC;AAIzD,wDAAwD;AACxD,wBAAgB,iBAAiB,IAAI,MAAM,CAU1C;AAED,kCAAkC;AAClC,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAEhE;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,OAAO,GAAG,WAAW,GAAG,SAAS,CAI5E;AAED,4DAA4D;AAC5D,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,WAAW,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAShF;AAED,iEAAiE;AACjE,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAE9E;AAED;;;;;GAKG;AACH,wBAAgB,wBAAwB,CACtC,QAAQ,EACJ;IAAE,OAAO,CAAC,EAAE,WAAW,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAAC,eAAe,CAAC,EAAE,MAAM,CAAA;CAAE,GACvE,SAAS,EACb,OAAO,EAAE,WAAW,EACpB,SAAS,EAAE,MAAM,GAAG,SAAS,GAC5B,MAAM,CAIR;AAED,0DAA0D;AAC1D,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAEzD;AAED;;;;GAIG;AACH,wBAAsB,qBAAqB,CACzC,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,MAAM,GAAG,SAAS,GAC5B,OAAO,CAAC,IAAI,CAAC,CAef;AAED;;;;;GAKG;AACH,wBAAsB,qBAAqB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAqC3E"}
1
+ {"version":3,"file":"session.d.ts","sourceRoot":"","sources":["../../src/core/session.ts"],"names":[],"mappings":"AAQA,eAAO,MAAM,aAAa,mCAAoC,CAAC;AAC/D,MAAM,MAAM,WAAW,GAAG,CAAC,OAAO,aAAa,CAAC,CAAC,MAAM,CAAC,CAAC;AAIzD,wDAAwD;AACxD,wBAAgB,iBAAiB,IAAI,MAAM,CAU1C;AAED,kCAAkC;AAClC,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAEhE;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,OAAO,GAAG,WAAW,GAAG,SAAS,CAI5E;AAED,4DAA4D;AAC5D,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,WAAW,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAShF;AAED,iEAAiE;AACjE,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAE9E;AAED;;;;;GAKG;AACH,wBAAgB,wBAAwB,CACtC,QAAQ,EACJ;IAAE,OAAO,CAAC,EAAE,WAAW,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAAC,eAAe,CAAC,EAAE,MAAM,CAAA;CAAE,GACvE,SAAS,EACb,OAAO,EAAE,WAAW,EACpB,SAAS,EAAE,MAAM,GAAG,SAAS,GAC5B,MAAM,CAIR;AAED,0DAA0D;AAC1D,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAEzD;AAED;;;;GAIG;AACH,wBAAsB,qBAAqB,CACzC,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,MAAM,GAAG,SAAS,GAC5B,OAAO,CAAC,IAAI,CAAC,CAef;AAED;;;;;GAKG;AACH,wBAAsB,qBAAqB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAkD3E"}
@@ -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";
@@ -100,17 +100,24 @@ export async function rotateSessionIfNeeded(taskName) {
100
100
  const maxRuns = def.sessionMaxRuns ?? 0;
101
101
  const count = (def.sessionRunCount ?? 0) + 1;
102
102
  if (shouldRotateSession(count, maxRuns)) {
103
- const sessionId = def.sessionId;
104
- if (sessionId && isValidSessionId(sessionId)) {
105
- try {
106
- await new Promise((resolve) => {
107
- execFile("opencode", ["session", "delete", sessionId], () => resolve());
108
- });
109
- }
110
- catch {
111
- // Удаление не должно мешать: просто фиксируем в логе ниже.
103
+ const oldSessionId = def.sessionId;
104
+ const hasOldSession = Boolean(oldSessionId && isValidSessionId(oldSessionId));
105
+ let deleteError;
106
+ if (hasOldSession && oldSessionId) {
107
+ // На Windows `opencode` — это `opencode.cmd`, который Node не запускает
108
+ // напрямую через execFile (ENOENT/EINVAL). Общий модуль сам выбирает
109
+ // cmd.exe на Windows, поэтому удаление действительно выполняется.
110
+ const result = await runOpencode(["session", "delete", oldSessionId]);
111
+ if (!result.ok) {
112
+ deleteError = result.error ?? "неизвестная ошибка";
113
+ console.warn(`[session] Не удалось удалить сессию ${oldSessionId} задачи "${taskName}": ${deleteError}`);
112
114
  }
113
115
  }
116
+ const rotationNote = !hasOldSession
117
+ ? "старой сессии не было"
118
+ : deleteError
119
+ ? `старую сессию удалить не удалось (${deleteError})`
120
+ : "сессия удалена";
114
121
  const newSessionId = generateSessionId();
115
122
  await saveTask({
116
123
  ...def,
@@ -121,7 +128,7 @@ export async function rotateSessionIfNeeded(taskName) {
121
128
  appendStructuredLog({
122
129
  event: "session.rotated",
123
130
  task: taskName,
124
- reason: `maxRuns=${maxRuns} достигнут; сессия удалена, создана новая, счётчик сброшен`,
131
+ reason: `maxRuns=${maxRuns} достигнут; ${rotationNote}, создана новая, счётчик сброшен`,
125
132
  });
126
133
  }
127
134
  else {
@@ -12,7 +12,7 @@
12
12
  * запуск задачи: наблюдаемость не должна влиять на планировщик.
13
13
  */
14
14
  /** События структурированного лога. */
15
- export type StructuredLogEvent = "run.started" | "run.finished" | "hook.received" | string;
15
+ export type StructuredLogEvent = "run.started" | "run.finished" | "hook.received" | "matrix.started" | "matrix.advanced" | "matrix.queue_started" | "matrix.cancelled" | "matrix.aggregated" | "matrix.aggregator_started" | "matrix.error" | string;
16
16
  export interface StructuredLogRecord {
17
17
  /** Время записи (ISO). */
18
18
  ts: string;
@@ -42,6 +42,12 @@ export interface StructuredLogRecord {
42
42
  payloadBytes?: number;
43
43
  /** Причина отказа/пропуска. */
44
44
  reason?: string;
45
+ /** Родительская задача матрицы (matrixId === task для событий matrix.*). */
46
+ matrixId?: string;
47
+ /** Имя клона матрицы, к которому относится событие. */
48
+ cloneName?: string;
49
+ /** Шаг матричного сценария: started, advanced, cancelled, aggregated и т.п. */
50
+ step?: string;
45
51
  }
46
52
  export interface ReadStructuredLogsFilter {
47
53
  task?: string;
@@ -1 +1 @@
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
+ {"version":3,"file":"structured-log.d.ts","sourceRoot":"","sources":["../../src/core/structured-log.ts"],"names":[],"mappings":"AAKA;;;;;;;;;;;;GAYG;AAEH,uCAAuC;AACvC,MAAM,MAAM,kBAAkB,GAC1B,aAAa,GACb,cAAc,GACd,eAAe,GACf,gBAAgB,GAChB,iBAAiB,GACjB,sBAAsB,GACtB,kBAAkB,GAClB,mBAAmB,GACnB,2BAA2B,GAC3B,cAAc,GACd,MAAM,CAAC;AAEX,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;IAChB,4EAA4E;IAC5E,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,uDAAuD;IACvD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,+EAA+E;IAC/E,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;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"}
@@ -0,0 +1,24 @@
1
+ /**
2
+ * P1-10: разные имена задач могут сжаться в один sanitized-идентификатор
3
+ * («my task» и «my-task» → «my-task»), после чего делят wrapper, prompt,
4
+ * lock и log. При создании новой задачи такую коллизию нужно отклонить,
5
+ * иначе вторая задача молча перезапишет файлы первой.
6
+ */
7
+ export type SanitizedConflict = {
8
+ kind: "task";
9
+ taskName: string;
10
+ } | {
11
+ kind: "file";
12
+ file: string;
13
+ };
14
+ /**
15
+ * Ищет конфликт sanitized-имени среди существующих задач и их артефактов.
16
+ *
17
+ * @param name имя создаваемой задачи;
18
+ * @param existingNames имена уже существующих задач (без самой создаваемой);
19
+ * @param artifactExists проверка существования файла — подменяется в тестах.
20
+ */
21
+ export declare function findSanitizedNameConflict(name: string, existingNames: readonly string[], artifactExists?: (file: string) => boolean): SanitizedConflict | null;
22
+ /** Человекочитаемое объяснение конфликта для ошибки создания задачи. */
23
+ export declare function sanitizedConflictMessage(name: string, conflict: SanitizedConflict): string;
24
+ //# sourceMappingURL=task-name.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"task-name.d.ts","sourceRoot":"","sources":["../../src/core/task-name.ts"],"names":[],"mappings":"AAIA;;;;;GAKG;AACH,MAAM,MAAM,iBAAiB,GACzB;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,GAClC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC;AAEnC;;;;;;GAMG;AACH,wBAAgB,yBAAyB,CACvC,IAAI,EAAE,MAAM,EACZ,aAAa,EAAE,SAAS,MAAM,EAAE,EAChC,cAAc,GAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAoB,GACrD,iBAAiB,GAAG,IAAI,CAwB1B;AAED,wEAAwE;AACxE,wBAAgB,wBAAwB,CACtC,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,iBAAiB,GAC1B,MAAM,CAWR"}
@@ -0,0 +1,40 @@
1
+ import { existsSync } from "node:fs";
2
+ import path from "node:path";
3
+ import { PLUGIN_DIR, WRAPPER_DIR, sanitizeName } from "../types.js";
4
+ /**
5
+ * Ищет конфликт sanitized-имени среди существующих задач и их артефактов.
6
+ *
7
+ * @param name имя создаваемой задачи;
8
+ * @param existingNames имена уже существующих задач (без самой создаваемой);
9
+ * @param artifactExists проверка существования файла — подменяется в тестах.
10
+ */
11
+ export function findSanitizedNameConflict(name, existingNames, artifactExists = existsSync) {
12
+ const sanitized = sanitizeName(name);
13
+ const self = name.toLowerCase();
14
+ const dbConflict = existingNames.find((existing) => existing.toLowerCase() !== self && sanitizeName(existing) === sanitized);
15
+ if (dbConflict) {
16
+ return { kind: "task", taskName: dbConflict };
17
+ }
18
+ // Осиротевшие артефакты: в БД задачи уже нет, но файлы остались.
19
+ // Перезапись промпта/обёртки молча сломала бы такую задачу.
20
+ const artifacts = [
21
+ path.join(WRAPPER_DIR, `run-${sanitized}.cmd`),
22
+ path.join(WRAPPER_DIR, `run-${sanitized}.sh`),
23
+ path.join(PLUGIN_DIR, "prompts", `${sanitized}.txt`),
24
+ ];
25
+ const orphan = artifacts.find((file) => artifactExists(file));
26
+ if (orphan) {
27
+ return { kind: "file", file: orphan };
28
+ }
29
+ return null;
30
+ }
31
+ /** Человекочитаемое объяснение конфликта для ошибки создания задачи. */
32
+ export function sanitizedConflictMessage(name, conflict) {
33
+ const sanitized = sanitizeName(name);
34
+ const reason = conflict.kind === "task"
35
+ ? `существующая задача «${conflict.taskName}»`
36
+ : `оставшиеся файлы задачи (${conflict.file})`;
37
+ return (`Имя задачи «${name}» приводит к тому же имени файла «${sanitized}», ` +
38
+ `что и ${reason}. Выберите другое имя` +
39
+ (conflict.kind === "file" ? " или удалите старые файлы." : "."));
40
+ }
@@ -0,0 +1,4 @@
1
+ #!/usr/bin/env node
2
+ /** Точка входа для тестов: возвращает exit code, ничего не завершает. */
3
+ export declare function main(argv?: string[]): Promise<number>;
4
+ //# sourceMappingURL=worktree-run.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"worktree-run.d.ts","sourceRoot":"","sources":["../../src/core/worktree-run.ts"],"names":[],"mappings":";AAiLA,yEAAyE;AACzE,wBAAsB,IAAI,CAAC,IAAI,GAAE,MAAM,EAA0B,GAAG,OAAO,CAAC,MAAM,CAAC,CAOlF"}
@@ -0,0 +1,164 @@
1
+ #!/usr/bin/env node
2
+ /**
3
+ * W-1/W-2 (0.0.6): CLI-помощник обёртки для одноразовых git worktree.
4
+ *
5
+ * Создание (вызывается из сгенерированного .cmd/.sh):
6
+ * node worktree-run.js --repo "<workdir>" --task "<task name>" [--root <dir>] [--json]
7
+ * node worktree-run.js create --repo ... --task ...
8
+ *
9
+ * Очистка (после прогона и для остатков):
10
+ * node worktree-run.js cleanup --path "<worktree>" [--repo <root>] [--root <dir>] [--keep-branch] [--json]
11
+ * node worktree-run.js cleanup --stale [--root <dir>] [--max-age-hours <n>] [--json]
12
+ *
13
+ * При создании в stdout печатается только путь к worktree (одна строка) —
14
+ * обёртка ловит его и переходит туда. Диагностика и ошибки идут в stderr.
15
+ * При ошибке exit 1: обёртка обязана упасть fail-closed, а не работать в
16
+ * основном дереве.
17
+ */
18
+ import path from "node:path";
19
+ import { pathToFileURL } from "node:url";
20
+ import { cleanupStaleWorktrees, createRunWorktree, DEFAULT_STALE_AFTER_MS, removeRunWorktree, } from "./worktree.js";
21
+ function parseArgs(argv) {
22
+ const args = { mode: "create", keepBranch: false, stale: false, json: false };
23
+ let index = 0;
24
+ // Подкоманда необязательна: старые обёртки вызывают помощник без неё.
25
+ if (argv[0] === "create" || argv[0] === "cleanup") {
26
+ args.mode = argv[0];
27
+ index = 1;
28
+ }
29
+ for (; index < argv.length; index += 1) {
30
+ const flag = argv[index];
31
+ const value = argv[index + 1];
32
+ switch (flag) {
33
+ case "--json":
34
+ args.json = true;
35
+ break;
36
+ case "--keep-branch":
37
+ args.keepBranch = true;
38
+ break;
39
+ case "--stale":
40
+ args.stale = true;
41
+ break;
42
+ case "--repo":
43
+ case "--task":
44
+ case "--root":
45
+ case "--path":
46
+ case "--branch":
47
+ case "--max-age-hours": {
48
+ if (!value || value.startsWith("--")) {
49
+ return { args, error: `Флаг ${flag} требует значение.` };
50
+ }
51
+ if (flag === "--repo")
52
+ args.repo = value;
53
+ if (flag === "--task")
54
+ args.task = value;
55
+ if (flag === "--root")
56
+ args.root = value;
57
+ if (flag === "--path")
58
+ args.path = value;
59
+ if (flag === "--branch")
60
+ args.branch = value;
61
+ if (flag === "--max-age-hours") {
62
+ const hours = Number(value);
63
+ if (!Number.isFinite(hours) || hours < 0) {
64
+ return { args, error: "Флаг --max-age-hours требует неотрицательное число." };
65
+ }
66
+ args.maxAgeHours = hours;
67
+ }
68
+ index += 1;
69
+ break;
70
+ }
71
+ default:
72
+ return { args, error: `Неизвестный аргумент: ${flag}` };
73
+ }
74
+ }
75
+ return { args };
76
+ }
77
+ function usage() {
78
+ return [
79
+ "Использование:",
80
+ " worktree-run.js --repo <dir> --task <name> [--root <dir>] [--json]",
81
+ " worktree-run.js create --repo <dir> --task <name> [--root <dir>] [--json]",
82
+ " worktree-run.js cleanup --path <worktree> [--repo <root>] [--root <dir>] [--keep-branch] [--json]",
83
+ " worktree-run.js cleanup --stale [--root <dir>] [--max-age-hours <n>] [--json]",
84
+ ].join("\n");
85
+ }
86
+ async function runCreate(args) {
87
+ if (!args.repo || !args.task) {
88
+ process.stderr.write(`[worktree] ${usage()}\n`);
89
+ return 1;
90
+ }
91
+ // W-2.2: попутная уборка остатков. Не влияет на создание: ошибки уборки
92
+ // игнорируются, свежие worktree не трогаются.
93
+ await cleanupStaleWorktrees({ rootDir: args.root }).catch(() => undefined);
94
+ const result = await createRunWorktree({
95
+ repoDir: args.repo,
96
+ taskName: args.task,
97
+ rootDir: args.root,
98
+ });
99
+ if (!result.ok) {
100
+ process.stderr.write(`[worktree] ${result.error}\n`);
101
+ return 1;
102
+ }
103
+ process.stdout.write(args.json ? `${JSON.stringify(result.worktree)}\n` : `${result.worktree.path}\n`);
104
+ return 0;
105
+ }
106
+ async function runCleanup(args) {
107
+ if (args.stale && args.path) {
108
+ process.stderr.write("[worktree] Нельзя совмещать --stale и --path.\n");
109
+ return 1;
110
+ }
111
+ if (args.stale) {
112
+ const summary = await cleanupStaleWorktrees({
113
+ rootDir: args.root,
114
+ maxAgeMs: args.maxAgeHours === undefined
115
+ ? DEFAULT_STALE_AFTER_MS
116
+ : args.maxAgeHours * 60 * 60 * 1000,
117
+ });
118
+ process.stdout.write(args.json
119
+ ? `${JSON.stringify(summary)}\n`
120
+ : `[worktree] Удалено: ${summary.removed.length}, пропущено: ${summary.skipped.length}, sidecar: ${summary.pruned.length}, ошибок: ${summary.errors.length}${summary.locked ? " (уборка уже выполняется)" : ""}\n`);
121
+ if (summary.errors.length > 0) {
122
+ for (const error of summary.errors)
123
+ process.stderr.write(`[worktree] ${error}\n`);
124
+ return 1;
125
+ }
126
+ return 0;
127
+ }
128
+ if (!args.path) {
129
+ process.stderr.write(`[worktree] ${usage()}\n`);
130
+ return 1;
131
+ }
132
+ const result = await removeRunWorktree({
133
+ path: args.path,
134
+ repoRoot: args.repo,
135
+ branch: args.branch,
136
+ rootDir: args.root,
137
+ deleteBranch: !args.keepBranch,
138
+ });
139
+ if (!result.ok) {
140
+ process.stderr.write(`[worktree] ${result.error}\n`);
141
+ return 1;
142
+ }
143
+ if (args.json)
144
+ process.stdout.write(`${JSON.stringify({ ok: true, path: args.path })}\n`);
145
+ return 0;
146
+ }
147
+ /** Точка входа для тестов: возвращает exit code, ничего не завершает. */
148
+ export async function main(argv = process.argv.slice(2)) {
149
+ const parsed = parseArgs(argv);
150
+ if (parsed.error) {
151
+ process.stderr.write(`[worktree] ${parsed.error}\n`);
152
+ return 1;
153
+ }
154
+ return parsed.args.mode === "cleanup" ? runCleanup(parsed.args) : runCreate(parsed.args);
155
+ }
156
+ const invokedPath = process.argv[1] ? pathToFileURL(path.resolve(process.argv[1])).href : "";
157
+ if (import.meta.url === invokedPath) {
158
+ main().then((code) => {
159
+ process.exitCode = code;
160
+ }, (err) => {
161
+ process.stderr.write(`[worktree] ${err instanceof Error ? err.message : String(err)}\n`);
162
+ process.exitCode = 1;
163
+ });
164
+ }
@@ -0,0 +1,115 @@
1
+ /** Каталог одноразовых worktree. Лежит рядом с prompts/logs и вне репозитория. */
2
+ export declare const WORKTREE_ROOT_DIR: string;
3
+ /** Описание созданного worktree. */
4
+ export interface RunWorktree {
5
+ /** Абсолютный путь рабочей копии. */
6
+ path: string;
7
+ /** Ветка, созданная под запуск. */
8
+ branch: string;
9
+ /** Корень основного репозитория. */
10
+ repoRoot: string;
11
+ /** Коммит, от которого создан worktree. */
12
+ baseCommit: string;
13
+ /** Время создания (ISO-8601). */
14
+ createdAt: string;
15
+ /** Корень, в котором создан worktree (для безопасной очистки). */
16
+ rootDir: string;
17
+ }
18
+ export type CreateWorktreeResult = {
19
+ ok: true;
20
+ worktree: RunWorktree;
21
+ } | {
22
+ ok: false;
23
+ error: string;
24
+ };
25
+ export interface CreateWorktreeOptions {
26
+ /** Рабочая директория задачи: репозиторий (или его подкаталог). */
27
+ repoDir: string;
28
+ /** Имя задачи — основа для пути и ветки. */
29
+ taskName: string;
30
+ /** Куда создавать worktree. По умолчанию PLUGIN_DIR/worktrees. */
31
+ rootDir?: string;
32
+ /** Базовая ссылка (ветка/коммит). По умолчанию HEAD. */
33
+ baseRef?: string;
34
+ }
35
+ /**
36
+ * Возвращает корень git-репозитория для `dir` или null, если это не репозиторий.
37
+ * Работает и для подкаталога, и для уже связанного worktree.
38
+ */
39
+ export declare function isGitRepository(dir: string): Promise<string | null>;
40
+ /**
41
+ * Ошибки, которые стоит перепробовать: гонки lock-файлов и ANTIVIRUS/FS.
42
+ *
43
+ * W-2: общий `No such file` убран из списка. Он маскировал отсутствующий
44
+ * `baseRef` и повреждённый репозиторий под транзиентную гонку: `addWorktree`
45
+ * делал 3 попытки с задержками 50 + 100 мс, а затем возвращал ту же ошибку.
46
+ * Гонки lock-файлов по-прежнему распознаются по `index.lock`, `cannot lock ref`
47
+ * и `Unable to create` — `No such file` может встречаться внутри их текста,
48
+ * но сам по себе больше не является признаком транзиентности.
49
+ */
50
+ export declare function isTransientGitError(message: string): boolean;
51
+ /**
52
+ * Создаёт одноразовый worktree под запуск задачи.
53
+ *
54
+ * Никогда не бросает: ошибки git и файловой системы возвращаются как
55
+ * `{ok:false, error}` — обёртка должна упасть fail-closed с понятным сообщением.
56
+ */
57
+ export declare function createRunWorktree(options: CreateWorktreeOptions): Promise<CreateWorktreeResult>;
58
+ /** Результат удаления одного worktree. */
59
+ export type RemoveWorktreeResult = {
60
+ ok: true;
61
+ } | {
62
+ ok: false;
63
+ error: string;
64
+ };
65
+ export interface RemoveWorktreeOptions {
66
+ /** Абсолютный путь рабочей копии. */
67
+ path: string;
68
+ /** Корень основного репозитория (иначе берётся из sidecar). */
69
+ repoRoot?: string;
70
+ /** Ветка запуска (иначе берётся из sidecar). */
71
+ branch?: string;
72
+ /** Корень worktree (иначе берётся из sidecar или WORKTREE_ROOT_DIR). */
73
+ rootDir?: string;
74
+ /** Удалять ли ветку запуска. По умолчанию true. */
75
+ deleteBranch?: boolean;
76
+ }
77
+ /**
78
+ * Удаляет созданный плагином worktree и его ветку.
79
+ *
80
+ * Защита W-2.2: удаляется только путь внутри каталога worktree, только
81
+ * зарегистрированный в git (или оставшийся каталог со sidecar) и только
82
+ * ветка с префиксом `agent-steward/`. Повторный вызов идемпотентен.
83
+ */
84
+ export declare function removeRunWorktree(options: RemoveWorktreeOptions): Promise<RemoveWorktreeResult>;
85
+ /** Сколько живёт lock уборки, прежде чем считать его осиротевшим. */
86
+ export declare const CLEANUP_LOCK_STALE_MS: number;
87
+ /** По умолчанию осиротевшим считается worktree старше суток. */
88
+ export declare const DEFAULT_STALE_AFTER_MS: number;
89
+ export interface StaleCleanupOptions {
90
+ rootDir?: string;
91
+ /** Возраст, после которого worktree считается остатком. */
92
+ maxAgeMs?: number;
93
+ /** Текущее время (для тестов). */
94
+ now?: number;
95
+ }
96
+ export interface StaleCleanupResult {
97
+ /** Удалённые рабочие копии. */
98
+ removed: string[];
99
+ /** Свежие worktree, которые трогать нельзя. */
100
+ skipped: string[];
101
+ /** Sidecar без рабочей копии — убраны. */
102
+ pruned: string[];
103
+ errors: string[];
104
+ /** Уборку уже выполняет другой процесс. */
105
+ locked: boolean;
106
+ }
107
+ /**
108
+ * Убирает осиротевшие worktree старше `maxAgeMs` и sidecar без рабочей копии.
109
+ *
110
+ * Гонки W-2.2: уборка сериализуется каталогом `.cleanup-lock`; свежие worktree
111
+ * (моложе порога) не трогаются, поэтому активный запуск не будет удалён.
112
+ * Каталоги без sidecar не удаляются — это чужие данные.
113
+ */
114
+ export declare function cleanupStaleWorktrees(options?: StaleCleanupOptions): Promise<StaleCleanupResult>;
115
+ //# sourceMappingURL=worktree.d.ts.map