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
@@ -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 {
@@ -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
+ }
@@ -1 +1 @@
1
- {"version":3,"file":"bash.d.ts","sourceRoot":"","sources":["../../../src/core/wrappers/bash.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAC1D,OAAO,EAIL,KAAK,gBAAgB,EACtB,MAAM,mBAAmB,CAAC;AAE3B,wCAAwC;AACxC,MAAM,WAAW,kBAAkB;IACjC,wDAAwD;IACxD,aAAa,EAAE,MAAM,CAAC;IACtB,uDAAuD;IACvD,QAAQ,EAAE,MAAM,CAAC;IACjB,0CAA0C;IAC1C,UAAU,EAAE,MAAM,CAAC;IACnB,6CAA6C;IAC7C,cAAc,EAAE,MAAM,CAAC;IACvB,uEAAuE;IACvE,QAAQ,EAAE,MAAM,CAAC;IACjB,iCAAiC;IACjC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,2DAA2D;IAC3D,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,mFAAmF;IACnF,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,mFAAmF;IACnF,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB,yDAAyD;IACzD,MAAM,CAAC,EAAE,gBAAgB,CAAC;IAC1B,2DAA2D;IAC3D,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,yBAAyB;IACzB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,kDAAkD;IAClD,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,wCAAwC;IACxC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,oFAAoF;IACpF,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,0DAA0D;IAC1D,WAAW,CAAC,EAAE,OAAO,eAAe,EAAE,WAAW,CAAC;IAClD,+CAA+C;IAC/C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,8EAA8E;IAC9E,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,gEAAgE;IAChE,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,wEAAwE;IACxE,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;OAGG;IACH,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B;;;OAGG;IACH,YAAY,CAAC,EAAE,gBAAgB,GAAG;QAChC,QAAQ,EAAE,MAAM,CAAC;QACjB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,SAAS,CAAC,EAAE,MAAM,CAAC;KACpB,CAAC;IACF;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;;OAGG;IACH,kBAAkB,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,kBAAkB,GAAG,MAAM,CAuY1E;AAED;;;GAGG;AACH,wBAAsB,gBAAgB,CACpC,OAAO,EAAE,kBAAkB,GAC1B,OAAO,CAAC,MAAM,CAAC,CAYjB;AAED,2DAA2D;AAC3D,wBAAgB,eAAe,CAAC,aAAa,EAAE,MAAM,GAAG,MAAM,CAE7D;AAYD,wBAAgB,mBAAmB,CACjC,YAAY,CAAC,EAAE,MAAM,EAAE,EACvB,WAAW,CAAC,EAAE,MAAM,EAAE,EACtB,MAAM,CAAC,EAAE,gBAAgB,EACzB,WAAW,CAAC,EAAE,OAAO,GACpB,MAAM,CAER"}
1
+ {"version":3,"file":"bash.d.ts","sourceRoot":"","sources":["../../../src/core/wrappers/bash.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAC1D,OAAO,EAIL,KAAK,gBAAgB,EACtB,MAAM,mBAAmB,CAAC;AAE3B,wCAAwC;AACxC,MAAM,WAAW,kBAAkB;IACjC,wDAAwD;IACxD,aAAa,EAAE,MAAM,CAAC;IACtB,uDAAuD;IACvD,QAAQ,EAAE,MAAM,CAAC;IACjB,0CAA0C;IAC1C,UAAU,EAAE,MAAM,CAAC;IACnB,6CAA6C;IAC7C,cAAc,EAAE,MAAM,CAAC;IACvB,uEAAuE;IACvE,QAAQ,EAAE,MAAM,CAAC;IACjB,iCAAiC;IACjC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,2DAA2D;IAC3D,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,mFAAmF;IACnF,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,mFAAmF;IACnF,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB,yDAAyD;IACzD,MAAM,CAAC,EAAE,gBAAgB,CAAC;IAC1B,2DAA2D;IAC3D,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,yBAAyB;IACzB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,kDAAkD;IAClD,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,wCAAwC;IACxC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,oFAAoF;IACpF,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,0DAA0D;IAC1D,WAAW,CAAC,EAAE,OAAO,eAAe,EAAE,WAAW,CAAC;IAClD,+CAA+C;IAC/C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,8EAA8E;IAC9E,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,gEAAgE;IAChE,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,wEAAwE;IACxE,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;OAGG;IACH,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B;;;OAGG;IACH,YAAY,CAAC,EAAE,gBAAgB,GAAG;QAChC,QAAQ,EAAE,MAAM,CAAC;QACjB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,SAAS,CAAC,EAAE,MAAM,CAAC;KACpB,CAAC;IACF;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;;OAGG;IACH,kBAAkB,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,kBAAkB,GAAG,MAAM,CAob1E;AAED;;;GAGG;AACH,wBAAsB,gBAAgB,CACpC,OAAO,EAAE,kBAAkB,GAC1B,OAAO,CAAC,MAAM,CAAC,CAYjB;AAED,2DAA2D;AAC3D,wBAAgB,eAAe,CAAC,aAAa,EAAE,MAAM,GAAG,MAAM,CAE7D;AAYD,wBAAgB,mBAAmB,CACjC,YAAY,CAAC,EAAE,MAAM,EAAE,EACvB,WAAW,CAAC,EAAE,MAAM,EAAE,EACtB,MAAM,CAAC,EAAE,gBAAgB,EACzB,WAAW,CAAC,EAAE,OAAO,GACpB,MAAM,CAER"}
@@ -40,6 +40,9 @@ export function buildBashWrapperScript(options) {
40
40
  `WORKDIR=${shellQuote(workdir || process.cwd())}`,
41
41
  `WORKSPACE_NAME=${shellQuote(workspaceName ?? "")}`,
42
42
  `TIMEOUT_SECONDS=${Number.isFinite(timeoutSeconds) ? Math.max(0, Math.floor(timeoutSeconds)) : 3600}`,
43
+ // Маркер сработавшего watchdog: по нему обёртка отличает таймаут от
44
+ // обычного ненулевого кода возврата (SIGTERM/SIGKILL неотличимы от падения).
45
+ `TIMEOUT_MARKER=${shellQuote(`${lockFile}.timeout`)}`,
43
46
  `RECORDER_FILE=${shellQuote(recorderFile ?? "")}`,
44
47
  `QUALITY_GATE=${shellQuote(qualityGate ?? "")}`,
45
48
  `MODEL=${shellQuote(model ?? "")}`,
@@ -102,7 +105,18 @@ export function buildBashWrapperScript(options) {
102
105
  ' "$@" &',
103
106
  " GATE_CHILD=$!",
104
107
  " set +m 2>/dev/null || true",
105
- ' ( 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 &',
108
+ " (",
109
+ " WD_SLEEP_PID=",
110
+ " trap 'if [ -n \"$WD_SLEEP_PID\" ]; then kill \"$WD_SLEEP_PID\" 2>/dev/null || true; fi; exit 0' TERM INT",
111
+ ' sleep "$GATE_LIMIT" &',
112
+ " WD_SLEEP_PID=$!",
113
+ ' wait "$WD_SLEEP_PID" 2>/dev/null || true',
114
+ ' kill -TERM -- "-$GATE_CHILD" 2>/dev/null || kill -TERM "$GATE_CHILD" 2>/dev/null',
115
+ " sleep 5 &",
116
+ " WD_SLEEP_PID=$!",
117
+ ' wait "$WD_SLEEP_PID" 2>/dev/null || true',
118
+ ' kill -KILL -- "-$GATE_CHILD" 2>/dev/null || kill -KILL "$GATE_CHILD" 2>/dev/null',
119
+ " ) >/dev/null 2>&1 &",
106
120
  " GATE_WATCHDOG=$!",
107
121
  ' wait "$GATE_CHILD"',
108
122
  " GATE_CODE=$?",
@@ -186,6 +200,14 @@ export function buildBashWrapperScript(options) {
186
200
  ' env_value="${env_line#*=}"',
187
201
  ' case "$env_key" in *[!A-Za-z0-9_]*) continue ;; esac',
188
202
  ' case "$env_key" in [A-Za-z_]*) ;; *) continue ;; esac',
203
+ // P2-21: неразрешённая ссылка означает, что секрет удалён/переименован.
204
+ // Запускать агента с литералом "${secret:NAME}" нельзя — fail closed.
205
+ ' case "$env_value" in',
206
+ " *'${secret:'*)",
207
+ ' log "[scheduler] ОШИБКА: переменная $env_key содержит неразрешённый секрет (\\${secret:...}). Запуск отменён."',
208
+ " exit 78",
209
+ " ;;",
210
+ " esac",
189
211
  ' export "$env_key=$env_value"',
190
212
  ' done < "$ENV_FILE"',
191
213
  ' log "[scheduler] Переменные окружения workspace загружены."',
@@ -297,12 +319,26 @@ export function buildBashWrapperScript(options) {
297
319
  "# T-10: как и в run_with_timeout, opencode запускается в собственной группе",
298
320
  "# процессов (exec внутри run_opencode сохраняет лидера группы), поэтому",
299
321
  "# watchdog убивает всё дерево, а внуки не переживают таймаут.",
322
+ // Маркер мог остаться от предыдущего запуска (краш до очистки).
323
+ 'rm -f "$TIMEOUT_MARKER" 2>/dev/null || true',
300
324
  "set -m 2>/dev/null || true",
301
325
  'run_opencode >> "$LOG_FILE" 2>&1 &',
302
326
  "CHILD=$!",
303
327
  "set +m 2>/dev/null || true",
304
328
  'if [ "$TIMEOUT_SECONDS" -gt 0 ] 2>/dev/null; then',
305
- ' ( 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 ) &',
329
+ " (",
330
+ " WD_SLEEP_PID=",
331
+ " trap 'if [ -n \"$WD_SLEEP_PID\" ]; then kill \"$WD_SLEEP_PID\" 2>/dev/null || true; fi; exit 0' TERM INT",
332
+ ' sleep "$TIMEOUT_SECONDS" &',
333
+ " WD_SLEEP_PID=$!",
334
+ ' wait "$WD_SLEEP_PID" 2>/dev/null || true',
335
+ ' : > "$TIMEOUT_MARKER" 2>/dev/null || true',
336
+ ' kill -TERM -- "-$CHILD" 2>/dev/null || kill -TERM "$CHILD" 2>/dev/null',
337
+ " sleep 5 &",
338
+ " WD_SLEEP_PID=$!",
339
+ ' wait "$WD_SLEEP_PID" 2>/dev/null || true',
340
+ ' kill -KILL -- "-$CHILD" 2>/dev/null || kill -KILL "$CHILD" 2>/dev/null',
341
+ " ) &",
306
342
  " WATCHDOG=$!",
307
343
  "fi",
308
344
  'wait "$CHILD"',
@@ -314,7 +350,15 @@ export function buildBashWrapperScript(options) {
314
350
  "",
315
351
  "# Конфиг прав живёт только в переменной окружения — файл не создаётся.",
316
352
  "",
317
- 'if [ "$EXIT_CODE" -ne 0 ]; then',
353
+ "TIMED_OUT=0",
354
+ 'if [ -f "$TIMEOUT_MARKER" ]; then',
355
+ " TIMED_OUT=1",
356
+ " EXIT_CODE=124",
357
+ // 124 — общепринятый код coreutils timeout; маркер нужен, потому что
358
+ // SIGTERM/SIGKILL сами по себе неотличимы от обычного падения.
359
+ ' ERROR_MESSAGE="Таймаут: превышено ${TIMEOUT_SECONDS} с"',
360
+ ' log "[scheduler] Задача \'$TASK_NAME\' прервана по таймауту (${TIMEOUT_SECONDS} с)."',
361
+ 'elif [ "$EXIT_CODE" -ne 0 ]; then',
318
362
  ' log "[scheduler] Задача \'$TASK_NAME\' завершилась с кодом $EXIT_CODE."',
319
363
  ' ERROR_MESSAGE="Код возврата $EXIT_CODE"',
320
364
  "else",
@@ -357,7 +401,8 @@ export function buildBashWrapperScript(options) {
357
401
  'END_EPOCH="$(date +%s)"',
358
402
  "DURATION_MS=$(( (END_EPOCH - START_EPOCH) * 1000 ))",
359
403
  'STATUS="error"',
360
- 'if [ "$EXIT_CODE" -eq 0 ]; then STATUS="success"; fi',
404
+ 'if [ "$TIMED_OUT" -eq 1 ]; then STATUS="timeout"; elif [ "$EXIT_CODE" -eq 0 ]; then STATUS="success"; fi',
405
+ 'rm -f "$TIMEOUT_MARKER" 2>/dev/null || true',
361
406
  "",
362
407
  'if [ -n "$RECORDER_FILE" ] && command -v node >/dev/null 2>&1; then',
363
408
  ' if [ -n "$RUN_ID" ]; then',
@@ -0,0 +1,83 @@
1
+ /**
2
+ * Capability Map — слой 2 роутера (Спринт 36.5.b).
3
+ *
4
+ * Таблица `capability_map` хранит, как исполнитель справлялся с типом задачи:
5
+ * сколько запусков было, сколько прошло гейт, среднюю стоимость и время, а
6
+ * также последние 10 исходов. Роутер читает карту и выбирает маршрут
7
+ * (local / cloud / review) по порогам — без вызова модели, то есть 0 токенов
8
+ * на само решение.
9
+ *
10
+ * Карта обучается на исходах гейта: каждый прогон шага вызывает
11
+ * {@link recordCapabilityOutcome}, статистика обновляется скользящим средним.
12
+ * Данных мало — карта честно говорит «не знаю» и отдаёт решение слою 3
13
+ * (Explore-режим).
14
+ */
15
+ /** Куда исполнять шаг. `review` — данных достаточно, но успех нестабилен. */
16
+ export type CapabilityTarget = "local" | "cloud" | "review" | "explore";
17
+ /** Порог, выше которого шаг считается надёжным для локали. */
18
+ export declare const LOCAL_SUCCESS_THRESHOLD = 0.85;
19
+ /** Порог, ниже которого локальный исполнитель считается безнадёжным. */
20
+ export declare const CLOUD_FAILURE_THRESHOLD = 0.3;
21
+ /** Минимум исходов, чтобы карта вообще бралась судить. */
22
+ export declare const MIN_RUNS_FOR_DECISION = 3;
23
+ /** Сколько последних исходов хранить (1 — гейт пройден, 0 — провал). */
24
+ export declare const RECENT_RUNS_LIMIT = 10;
25
+ export interface CapabilityRecord {
26
+ taskType: string;
27
+ /** Исполнитель, который последним обрабатывал тип задачи. */
28
+ model: string;
29
+ runsTotal: number;
30
+ runsPassed: number;
31
+ successRate: number;
32
+ avgCostUsd: number;
33
+ avgTimeMs: number;
34
+ /** Последние исходы, старые слева, новые справа, максимум 10. */
35
+ last10Runs: number[];
36
+ createdAt: string;
37
+ updatedAt: string;
38
+ }
39
+ /** Один исход гейта: пройден/провален + необязательные стоимость и время. */
40
+ export interface CapabilityOutcome {
41
+ taskType: string;
42
+ model?: string;
43
+ passed: boolean;
44
+ costUsd?: number;
45
+ timeMs?: number;
46
+ }
47
+ export interface CapabilityThresholds {
48
+ localSuccess?: number;
49
+ cloudFailure?: number;
50
+ minRuns?: number;
51
+ }
52
+ export interface CapabilityDecision {
53
+ taskType: string;
54
+ target: CapabilityTarget;
55
+ /** Машиночитаемая причина: no-data | local-reliable | escalate | review. */
56
+ reason: "no-data" | "local-reliable" | "escalate" | "review";
57
+ successRate: number;
58
+ runsTotal: number;
59
+ capability: CapabilityRecord | null;
60
+ }
61
+ /** Читает статистику по типу задачи или `null`, если данных ещё нет. */
62
+ export declare function getCapability(taskType: string): CapabilityRecord | null;
63
+ /** Все известные типы задач, сначала самые надёжные. */
64
+ export declare function listCapabilities(limit?: number): CapabilityRecord[];
65
+ /**
66
+ * Записывает исход гейта и обновляет статистику скользящим средним.
67
+ *
68
+ * Возвращает актуальную запись карты — её же удобно логировать вместе с
69
+ * решением роутера, чтобы видеть, на каких данных он остановился.
70
+ */
71
+ export declare function recordCapabilityOutcome(outcome: CapabilityOutcome): CapabilityRecord;
72
+ /**
73
+ * Решение слоя 2 по порогам (0 токенов).
74
+ *
75
+ * - данных меньше `minRuns` → `explore` (решает слой 3);
76
+ * - `success_rate ≥ 0.85` → `local`;
77
+ * - `success_rate ≤ 0.30` → `cloud` (эскалация);
78
+ * - между порогами → `review` (нужен человек или облачный ревьюер).
79
+ */
80
+ export declare function decideCapabilityRoute(taskType: string, thresholds?: CapabilityThresholds): CapabilityDecision;
81
+ /** Готова ли таблица карты (для диагностики и тестов миграции). */
82
+ export declare function isCapabilityMapReady(): boolean;
83
+ //# sourceMappingURL=capability-repo.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"capability-repo.d.ts","sourceRoot":"","sources":["../../src/db/capability-repo.ts"],"names":[],"mappings":"AAGA;;;;;;;;;;;;;GAaG;AAEH,6EAA6E;AAC7E,MAAM,MAAM,gBAAgB,GAAG,OAAO,GAAG,OAAO,GAAG,QAAQ,GAAG,SAAS,CAAC;AAExE,8DAA8D;AAC9D,eAAO,MAAM,uBAAuB,OAAO,CAAC;AAE5C,wEAAwE;AACxE,eAAO,MAAM,uBAAuB,MAAM,CAAC;AAE3C,0DAA0D;AAC1D,eAAO,MAAM,qBAAqB,IAAI,CAAC;AAEvC,wEAAwE;AACxE,eAAO,MAAM,iBAAiB,KAAK,CAAC;AAEpC,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,MAAM,CAAC;IACjB,6DAA6D;IAC7D,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,iEAAiE;IACjE,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,6EAA6E;AAC7E,MAAM,WAAW,iBAAiB;IAChC,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,OAAO,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,oBAAoB;IACnC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,gBAAgB,CAAC;IACzB,4EAA4E;IAC5E,MAAM,EAAE,SAAS,GAAG,gBAAgB,GAAG,UAAU,GAAG,QAAQ,CAAC;IAC7D,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,gBAAgB,GAAG,IAAI,CAAC;CACrC;AAyDD,wEAAwE;AACxE,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,gBAAgB,GAAG,IAAI,CAMvE;AAED,wDAAwD;AACxD,wBAAgB,gBAAgB,CAAC,KAAK,SAAM,GAAG,gBAAgB,EAAE,CAMhE;AAED;;;;;GAKG;AACH,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,iBAAiB,GAAG,gBAAgB,CA4DpF;AAED;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,CACnC,QAAQ,EAAE,MAAM,EAChB,UAAU,GAAE,oBAAyB,GACpC,kBAAkB,CAmDpB;AAED,mEAAmE;AACnE,wBAAgB,oBAAoB,IAAI,OAAO,CAK9C"}