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
@@ -1,8 +1,27 @@
1
1
  import fs from "node:fs/promises";
2
+ import fsSync from "node:fs";
2
3
  import path from "node:path";
3
4
  import { WRAPPER_DIR } from "../../types.js";
4
5
  import { shellQuote } from "../scheduler/posix.js";
6
+ import { createGateSnapshot } from "../gate-integrity.js";
5
7
  import { buildOpencodeConfig as buildPermissionsConfig, formatPolicyLog, resolvePermissions, } from "../permissions.js";
8
+ /**
9
+ * B6: разбор PID из lock-токена для bash-обёртки.
10
+ *
11
+ * Понимает единый `<pid>-<iso>` (Node и PS), legacy PS `<iso>|<pid>`
12
+ * и голый `<pid>` (pid-файл самой bash-обёртки). Legacy PS проверяется
13
+ * первым: иначе год из ISO был бы принят за PID.
14
+ */
15
+ export const BASH_LOCK_PID_FUNCTION = `parse_lock_pid() {
16
+ local text="$1"
17
+ case "$text" in
18
+ *"|"*) printf '%s' "\${text##*|}" ;;
19
+ [0-9][0-9][0-9][0-9]-[0-9][0-9]-[0-9][0-9]T*) printf '' ;;
20
+ [0-9]*-*) printf '%s' "\${text%%-*}" ;;
21
+ [0-9]*) printf '%s' "$text" ;;
22
+ *) printf '' ;;
23
+ esac
24
+ }`;
6
25
  /**
7
26
  * Собирает текст bash-обёртки.
8
27
  *
@@ -20,7 +39,31 @@ import { buildOpencodeConfig as buildPermissionsConfig, formatPolicyLog, resolve
20
39
  * Если задана модель, вызов превращается в `opencode run --model "<model>" <промпт>`.
21
40
  */
22
41
  export function buildBashWrapperScript(options) {
23
- const { taskName, promptFile, timeoutSeconds, lockFile, workdir, workspaceName, logFile, recorderFile, qualityGate, model, beforeScript, afterScript, sessionMode, sessionId, sessionFile, oneShotCleanupCommand, allowedTools, deniedTools, policy, legacyShell, scheduleGate, envFile, gateTimeoutSeconds, } = options;
42
+ const { sanitizedName, taskName, promptFile, timeoutSeconds, lockFile, workdir, workspaceName, logFile, recorderFile, qualityGate, model, beforeScript, afterScript, sessionMode, sessionId, sessionFile, oneShotCleanupCommand, allowedTools, deniedTools, policy, legacyShell, scheduleGate, envFile, gateTimeoutSeconds, worktree, worktreeHelper, guards, guardHelper, } = options;
43
+ // G-1.2: фиксируем входы гейта при создании обёртки и передаём путь
44
+ // snapshot'а и помощника проверки в сгенерированный скрипт.
45
+ let gateSnapshot = "";
46
+ let gateIntegrity = "";
47
+ if (qualityGate?.trim()) {
48
+ const safeGateTimeout = typeof gateTimeoutSeconds === "number" && Number.isFinite(gateTimeoutSeconds)
49
+ ? Math.max(0, Math.floor(gateTimeoutSeconds))
50
+ : 300;
51
+ let prompt = "";
52
+ try {
53
+ prompt = fsSync.readFileSync(promptFile || "", "utf8");
54
+ }
55
+ catch {
56
+ // Промпт мог быть удалён — snapshot всё равно уникален для задачи.
57
+ }
58
+ gateSnapshot = createGateSnapshot(sanitizedName || taskName, {
59
+ gate: qualityGate,
60
+ prompt,
61
+ gateTimeoutSeconds: safeGateTimeout,
62
+ });
63
+ gateIntegrity = recorderFile
64
+ ? path.join(path.dirname(recorderFile), "gate-integrity.js")
65
+ : "";
66
+ }
24
67
  const effectivePermissions = resolvePermissions({
25
68
  policy,
26
69
  legacyShell,
@@ -39,9 +82,23 @@ export function buildBashWrapperScript(options) {
39
82
  `LOCK_FILE=${shellQuote(lockFile)}`,
40
83
  `WORKDIR=${shellQuote(workdir || process.cwd())}`,
41
84
  `WORKSPACE_NAME=${shellQuote(workspaceName ?? "")}`,
85
+ // W-1 (0.0.6): одноразовый git worktree на запуск.
86
+ `WORKTREE_MODE=${worktree ? 1 : 0}`,
87
+ `WORKTREE_HELPER=${shellQuote(worktreeHelper ?? "")}`,
88
+ // W-3 (0.0.6): guard-условия. Пустая строка = guard не настроен.
89
+ `GUARD_HELPER=${shellQuote(guardHelper ?? "")}`,
90
+ `GUARD_B64=${shellQuote(guards ? Buffer.from(JSON.stringify(guards), "utf8").toString("base64") : "")}`,
91
+ // W-4 (0.0.6): причина пропуска в history (fixed, без произвольного текста из лога).
92
+ `GUARD_SKIP_B64=${shellQuote(Buffer.from("guard conditions not met", "utf8").toString("base64"))}`,
42
93
  `TIMEOUT_SECONDS=${Number.isFinite(timeoutSeconds) ? Math.max(0, Math.floor(timeoutSeconds)) : 3600}`,
94
+ // Маркер сработавшего watchdog: по нему обёртка отличает таймаут от
95
+ // обычного ненулевого кода возврата (SIGTERM/SIGKILL неотличимы от падения).
96
+ `TIMEOUT_MARKER=${shellQuote(`${lockFile}.timeout`)}`,
43
97
  `RECORDER_FILE=${shellQuote(recorderFile ?? "")}`,
44
98
  `QUALITY_GATE=${shellQuote(qualityGate ?? "")}`,
99
+ // G-1.2: путь к snapshot'у и CLI проверки целостности входов гейта.
100
+ `GATE_SNAPSHOT=${shellQuote(gateSnapshot)}`,
101
+ `GATE_INTEGRITY=${shellQuote(gateIntegrity)}`,
45
102
  `MODEL=${shellQuote(model ?? "")}`,
46
103
  // Спринт 24: режим сессии — "new" (по умолчанию), "reuse" (--session <id>), "last" (--continue).
47
104
  `SESSION_MODE=${shellQuote(sessionMode ?? "new")}`,
@@ -83,6 +140,8 @@ export function buildBashWrapperScript(options) {
83
140
  ' printf \'[%s] %s\\n\' "$(date \'+%Y-%m-%d %H:%M:%S\')" "$*" >> "$LOG_FILE" 2>/dev/null || true',
84
141
  "}",
85
142
  "",
143
+ BASH_LOCK_PID_FUNCTION,
144
+ "",
86
145
  'log "[role-scoped] opencode config passed via OPENCODE_CONFIG_CONTENT"',
87
146
  `log ${shellQuote(`[policy] ${formatPolicyLog(effectivePermissions)}`)}`,
88
147
  ...effectivePermissions.deniedByPolicy.map((entry) => `log ${shellQuote(`[policy] deny ${entry.action}: ${entry.hint}`)}`),
@@ -102,7 +161,18 @@ export function buildBashWrapperScript(options) {
102
161
  ' "$@" &',
103
162
  " GATE_CHILD=$!",
104
163
  " 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 &',
164
+ " (",
165
+ " WD_SLEEP_PID=",
166
+ " trap 'if [ -n \"$WD_SLEEP_PID\" ]; then kill \"$WD_SLEEP_PID\" 2>/dev/null || true; fi; exit 0' TERM INT",
167
+ ' sleep "$GATE_LIMIT" &',
168
+ " WD_SLEEP_PID=$!",
169
+ ' wait "$WD_SLEEP_PID" 2>/dev/null || true',
170
+ ' kill -TERM -- "-$GATE_CHILD" 2>/dev/null || kill -TERM "$GATE_CHILD" 2>/dev/null',
171
+ " sleep 5 &",
172
+ " WD_SLEEP_PID=$!",
173
+ ' wait "$WD_SLEEP_PID" 2>/dev/null || true',
174
+ ' kill -KILL -- "-$GATE_CHILD" 2>/dev/null || kill -KILL "$GATE_CHILD" 2>/dev/null',
175
+ " ) >/dev/null 2>&1 &",
106
176
  " GATE_WATCHDOG=$!",
107
177
  ' wait "$GATE_CHILD"',
108
178
  " GATE_CODE=$?",
@@ -135,8 +205,35 @@ export function buildBashWrapperScript(options) {
135
205
  "fi",
136
206
  "",
137
207
  "# Атомарная блокировка: mkdir завершается ошибкой, если каталог уже есть.",
138
- "# В каталог пишем PID: после kill -9 осиротевший lock снимается, а не",
139
- "# блокирует задачу до истечения STALE_LOCK_MAX_AGE_MS.",
208
+ "# B6: перед своим каталогом проверяем файловый lock Node/PS (<lock>):",
209
+ "# они держат файл, а bash — каталог. Без этой проверки Node-процесс и",
210
+ "# bash-обёртка могли выполнять одну задачу одновременно.",
211
+ 'if [ -f "$LOCK_FILE" ]; then',
212
+ ' LOCK_OWNER_RAW="$(cat "$LOCK_FILE" 2>/dev/null || true)"',
213
+ ' LOCK_FILE_PID="$(parse_lock_pid "$LOCK_OWNER_RAW")"',
214
+ ' if [ -z "$LOCK_FILE_PID" ]; then',
215
+ ' log "[scheduler] Не удалось определить владельца lock — пропуск запуска."',
216
+ " exit 0",
217
+ " fi",
218
+ ' if kill -0 "$LOCK_FILE_PID" 2>/dev/null; then',
219
+ ' log "[scheduler] Задача \'$TASK_NAME\' уже выполняется (pid $LOCK_FILE_PID) — пропуск запуска."',
220
+ " exit 0",
221
+ " fi",
222
+ " # Владелец мёртв: атомарно уводим файл, чтобы не удалить lock, который",
223
+ " # другой воркер успел пересоздать.",
224
+ ' STALE_LOCK_FILE="$LOCK_FILE.stale-$$-$(date +%s)"',
225
+ ' if ! mv "$LOCK_FILE" "$STALE_LOCK_FILE" 2>/dev/null; then',
226
+ ' if [ -f "$LOCK_FILE" ]; then',
227
+ ' log "[scheduler] Не удалось вытеснить осиротевший lock \'$LOCK_FILE\' — пропуск запуска."',
228
+ " exit 0",
229
+ " fi",
230
+ " else",
231
+ ' rm -f "$STALE_LOCK_FILE" 2>/dev/null || true',
232
+ " fi",
233
+ "fi",
234
+ "",
235
+ "# B6: в pid-файл пишем `<pid>-<iso>`, а не голый PID — так его читают",
236
+ "# Node и PS общим парсером. После kill -9 lock снимается по мёртвому PID.",
140
237
  'if ! mkdir "$LOCK_FILE.d" 2>/dev/null; then',
141
238
  ' if [ ! -d "$LOCK_FILE.d" ]; then',
142
239
  ' log "[scheduler] Не удалось создать lock \'$LOCK_FILE.d\' — запуск отменён."',
@@ -144,7 +241,7 @@ export function buildBashWrapperScript(options) {
144
241
  " fi",
145
242
  ' LOCK_PID=""',
146
243
  ' if [ -f "$LOCK_FILE.d/pid" ]; then',
147
- ' LOCK_PID="$(cat "$LOCK_FILE.d/pid" 2>/dev/null || true)"',
244
+ ' LOCK_PID="$(parse_lock_pid "$(cat "$LOCK_FILE.d/pid" 2>/dev/null || true)")"',
148
245
  " fi",
149
246
  " LOCK_ALIVE=1",
150
247
  ' if [ -n "$LOCK_PID" ]; then',
@@ -169,14 +266,61 @@ export function buildBashWrapperScript(options) {
169
266
  " exit 0",
170
267
  " fi",
171
268
  "fi",
172
- 'printf \'%s\\n\' "$$" > "$LOCK_FILE.d/pid" 2>/dev/null || true',
173
- 'cleanup() { rmdir "$LOCK_FILE.d" 2>/dev/null || rm -rf "$LOCK_FILE.d" 2>/dev/null; }',
269
+ 'printf \'%s\\n\' "$$-$(date -u +%Y-%m-%dT%H:%M:%SZ)" > "$LOCK_FILE.d/pid" 2>/dev/null || true',
270
+ "cleanup_worktree() {",
271
+ " if [ -n \"${AGENT_STEWARD_WORKTREE:-}\" ] && [ -n \"$WORKTREE_HELPER\" ] && command -v node >/dev/null 2>&1; then",
272
+ " cd \"$WORKDIR\" 2>/dev/null || true",
273
+ " node \"$WORKTREE_HELPER\" cleanup --path \"$AGENT_STEWARD_WORKTREE\" --repo \"$WORKDIR\" >> \"$LOG_FILE\" 2>&1 || true",
274
+ ' AGENT_STEWARD_WORKTREE=""',
275
+ " fi",
276
+ "}",
277
+ 'cleanup() { cleanup_worktree; rmdir "$LOCK_FILE.d" 2>/dev/null || rm -rf "$LOCK_FILE.d" 2>/dev/null; }',
174
278
  "trap cleanup EXIT INT TERM",
175
279
  "",
176
280
  'if [ -n "$WORKDIR" ] && [ -d "$WORKDIR" ]; then',
177
281
  ' cd "$WORKDIR" || { log "[scheduler] Не удалось перейти в $WORKDIR"; exit 1; }',
178
282
  "fi",
179
283
  "",
284
+ "# W-1 (0.0.6): одноразовый git worktree. Ошибка создания — fail-closed:",
285
+ "# задача не должна молча работать в основном дереве репозитория.",
286
+ 'if [ "$WORKTREE_MODE" = "1" ]; then',
287
+ ' if [ -z "$WORKTREE_HELPER" ] || ! command -v node >/dev/null 2>&1; then',
288
+ ' log "[scheduler] ОШИБКА: помощник worktree недоступен (нет node или worktree-run.js). Запуск отменён."',
289
+ " exit 1",
290
+ " fi",
291
+ ' AGENT_STEWARD_WORKTREE="$(node "$WORKTREE_HELPER" --repo "$WORKDIR" --task "$TASK_NAME" 2>> "$LOG_FILE" | tail -n 1)"',
292
+ ' if [ -z "$AGENT_STEWARD_WORKTREE" ]; then',
293
+ ' log "[scheduler] ОШИБКА: не удалось создать git worktree для \'$TASK_NAME\' — запуск отменён."',
294
+ " exit 1",
295
+ " fi",
296
+ " export AGENT_STEWARD_WORKTREE",
297
+ ' export AGENT_STEWARD_WORKTREE_REPO="$WORKDIR"',
298
+ ' log "[scheduler] Git worktree: $AGENT_STEWARD_WORKTREE"',
299
+ ' cd "$AGENT_STEWARD_WORKTREE" || { log "[scheduler] Не удалось перейти в worktree $AGENT_STEWARD_WORKTREE"; exit 1; }',
300
+ "fi",
301
+ "",
302
+ ...(guards
303
+ ? [
304
+ "# W-3 (0.0.6): guard-условия до запуска opencode. Код 4 — штатный skip,",
305
+ "# ненулевой код — ошибка проверки. В обоих случаях opencode не запускается,",
306
+ "# а созданный worktree убирается через trap cleanup.",
307
+ 'if [ -n "$GUARD_HELPER" ] && [ -n "$GUARD_B64" ]; then',
308
+ ' node "$GUARD_HELPER" --cwd "$PWD" --guards-b64 "$GUARD_B64" >> "$LOG_FILE" 2>&1',
309
+ " GUARD_STATUS=$?",
310
+ ' if [ "$GUARD_STATUS" -eq 4 ]; then',
311
+ ' log "[scheduler] guard: run skipped (условия не выполнены)"',
312
+ ' if [ -n "$RECORDER_FILE" ] && command -v node >/dev/null 2>&1; then',
313
+ ' node "$RECORDER_FILE" --skip "$TASK_NAME" "$GUARD_SKIP_B64" >> "$LOG_FILE" 2>&1 || true',
314
+ " fi",
315
+ " exit 0",
316
+ ' elif [ "$GUARD_STATUS" -ne 0 ]; then',
317
+ ' log "[scheduler] ОШИБКА: guard helper завершился с кодом $GUARD_STATUS — запуск отменён."',
318
+ " exit 1",
319
+ " fi",
320
+ "fi",
321
+ "",
322
+ ]
323
+ : []),
180
324
  "# Спринт 21: env-переменные workspace. Файл пишет плагин, значения не логируются.",
181
325
  'if [ -n "$ENV_FILE" ] && [ -f "$ENV_FILE" ]; then',
182
326
  ' while IFS= read -r env_line || [ -n "$env_line" ]; do',
@@ -186,6 +330,14 @@ export function buildBashWrapperScript(options) {
186
330
  ' env_value="${env_line#*=}"',
187
331
  ' case "$env_key" in *[!A-Za-z0-9_]*) continue ;; esac',
188
332
  ' case "$env_key" in [A-Za-z_]*) ;; *) continue ;; esac',
333
+ // P2-21: неразрешённая ссылка означает, что секрет удалён/переименован.
334
+ // Запускать агента с литералом "${secret:NAME}" нельзя — fail closed.
335
+ ' case "$env_value" in',
336
+ " *'${secret:'*)",
337
+ ' log "[scheduler] ОШИБКА: переменная $env_key содержит неразрешённый секрет (\\${secret:...}). Запуск отменён."',
338
+ " exit 78",
339
+ " ;;",
340
+ " esac",
189
341
  ' export "$env_key=$env_value"',
190
342
  ' done < "$ENV_FILE"',
191
343
  ' log "[scheduler] Переменные окружения workspace загружены."',
@@ -211,11 +363,17 @@ export function buildBashWrapperScript(options) {
211
363
  "fi",
212
364
  "",
213
365
  'PROMPT="$(cat "$PROMPT_FILE" 2>/dev/null || true)"',
366
+ "# W-1: сообщаем агенту, что он работает в одноразовом git worktree.",
367
+ 'if [ -n "${AGENT_STEWARD_WORKTREE:-}" ]; then',
368
+ ' PROMPT="[agent-steward] Рабочая директория запуска - одноразовый git worktree: $AGENT_STEWARD_WORKTREE',
369
+ '$PROMPT"',
370
+ "fi",
214
371
  "# T-09: backstop размера промпта на POSIX (argv ограничен MAX_ARG_STRLEN",
215
- "# 128 КиБ на аргумент в Linux). Считаем байты, а не символы.",
372
+ "# 128 КиБ на аргумент в Linux). Считаем байты, а не символы. Лимит включает",
373
+ "# завершающий NUL, поэтому максимум полезных данных — 131071 байт (B11.2).",
216
374
  'PROMPT_BYTES="$(printf %s "$PROMPT" | wc -c | tr -d \' \')"',
217
- 'if [ "$PROMPT_BYTES" -gt 131072 ] 2>/dev/null; then',
218
- ' log "[scheduler] ОШИБКА: промпт слишком длинный для argv POSIX: ${PROMPT_BYTES} байт (максимум 131072)."',
375
+ 'if [ "$PROMPT_BYTES" -ge 131072 ] 2>/dev/null; then',
376
+ ' log "[scheduler] ОШИБКА: промпт слишком длинный для argv POSIX: ${PROMPT_BYTES} байт (максимум 131071)."',
219
377
  " exit 1",
220
378
  "fi",
221
379
  'START_EPOCH="$(date +%s)"',
@@ -266,28 +424,28 @@ export function buildBashWrapperScript(options) {
266
424
  " fi",
267
425
  ' if [ -n "$SESSION_ID" ]; then',
268
426
  ' if [ -n "$MODEL" ]; then',
269
- ' exec opencode run --auto --session "$SESSION_ID" --model "$MODEL" "$PROMPT"',
427
+ ' exec opencode run --auto --session "$SESSION_ID" --model "$MODEL" -- "$PROMPT"',
270
428
  " else",
271
- ' exec opencode run --auto --session "$SESSION_ID" "$PROMPT"',
429
+ ' exec opencode run --auto --session "$SESSION_ID" -- "$PROMPT"',
272
430
  " fi",
273
431
  " else",
274
432
  ' if [ -n "$MODEL" ]; then',
275
- ' exec opencode run --auto --model "$MODEL" "$PROMPT"',
433
+ ' exec opencode run --auto --model "$MODEL" -- "$PROMPT"',
276
434
  " else",
277
- ' exec opencode run --auto "$PROMPT"',
435
+ ' exec opencode run --auto -- "$PROMPT"',
278
436
  " fi",
279
437
  " fi",
280
438
  ' elif [ "$SESSION_MODE" = "last" ]; then',
281
439
  ' if [ -n "$MODEL" ]; then',
282
- ' exec opencode run --auto --continue --model "$MODEL" "$PROMPT"',
440
+ ' exec opencode run --auto --continue --model "$MODEL" -- "$PROMPT"',
283
441
  " else",
284
- ' exec opencode run --auto --continue "$PROMPT"',
442
+ ' exec opencode run --auto --continue -- "$PROMPT"',
285
443
  " fi",
286
444
  " else",
287
445
  ' if [ -n "$MODEL" ]; then',
288
- ' exec opencode run --auto --model "$MODEL" "$PROMPT"',
446
+ ' exec opencode run --auto --model "$MODEL" -- "$PROMPT"',
289
447
  " else",
290
- ' exec opencode run --auto "$PROMPT"',
448
+ ' exec opencode run --auto -- "$PROMPT"',
291
449
  " fi",
292
450
  " fi",
293
451
  "}",
@@ -297,12 +455,26 @@ export function buildBashWrapperScript(options) {
297
455
  "# T-10: как и в run_with_timeout, opencode запускается в собственной группе",
298
456
  "# процессов (exec внутри run_opencode сохраняет лидера группы), поэтому",
299
457
  "# watchdog убивает всё дерево, а внуки не переживают таймаут.",
458
+ // Маркер мог остаться от предыдущего запуска (краш до очистки).
459
+ 'rm -f "$TIMEOUT_MARKER" 2>/dev/null || true',
300
460
  "set -m 2>/dev/null || true",
301
461
  'run_opencode >> "$LOG_FILE" 2>&1 &',
302
462
  "CHILD=$!",
303
463
  "set +m 2>/dev/null || true",
304
464
  '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 ) &',
465
+ " (",
466
+ " WD_SLEEP_PID=",
467
+ " trap 'if [ -n \"$WD_SLEEP_PID\" ]; then kill \"$WD_SLEEP_PID\" 2>/dev/null || true; fi; exit 0' TERM INT",
468
+ ' sleep "$TIMEOUT_SECONDS" &',
469
+ " WD_SLEEP_PID=$!",
470
+ ' wait "$WD_SLEEP_PID" 2>/dev/null || true',
471
+ ' : > "$TIMEOUT_MARKER" 2>/dev/null || true',
472
+ ' kill -TERM -- "-$CHILD" 2>/dev/null || kill -TERM "$CHILD" 2>/dev/null',
473
+ " sleep 5 &",
474
+ " WD_SLEEP_PID=$!",
475
+ ' wait "$WD_SLEEP_PID" 2>/dev/null || true',
476
+ ' kill -KILL -- "-$CHILD" 2>/dev/null || kill -KILL "$CHILD" 2>/dev/null',
477
+ " ) &",
306
478
  " WATCHDOG=$!",
307
479
  "fi",
308
480
  'wait "$CHILD"',
@@ -314,7 +486,15 @@ export function buildBashWrapperScript(options) {
314
486
  "",
315
487
  "# Конфиг прав живёт только в переменной окружения — файл не создаётся.",
316
488
  "",
317
- 'if [ "$EXIT_CODE" -ne 0 ]; then',
489
+ "TIMED_OUT=0",
490
+ 'if [ -f "$TIMEOUT_MARKER" ]; then',
491
+ " TIMED_OUT=1",
492
+ " EXIT_CODE=124",
493
+ // 124 — общепринятый код coreutils timeout; маркер нужен, потому что
494
+ // SIGTERM/SIGKILL сами по себе неотличимы от обычного падения.
495
+ ' ERROR_MESSAGE="Таймаут: превышено ${TIMEOUT_SECONDS} с"',
496
+ ' log "[scheduler] Задача \'$TASK_NAME\' прервана по таймауту (${TIMEOUT_SECONDS} с)."',
497
+ 'elif [ "$EXIT_CODE" -ne 0 ]; then',
318
498
  ' log "[scheduler] Задача \'$TASK_NAME\' завершилась с кодом $EXIT_CODE."',
319
499
  ' ERROR_MESSAGE="Код возврата $EXIT_CODE"',
320
500
  "else",
@@ -322,15 +502,30 @@ export function buildBashWrapperScript(options) {
322
502
  "fi",
323
503
  "",
324
504
  'if [ -n "$QUALITY_GATE" ] && [ "$EXIT_CODE" -eq 0 ]; then',
325
- ' log "[scheduler] Запуск Quality Gate: $QUALITY_GATE"',
326
- ' run_with_timeout "$GATE_TIMEOUT_SECONDS" bash -c "$QUALITY_GATE" >> "$LOG_FILE" 2>&1',
327
- " GATE_CODE=$?",
328
- ' if [ "$GATE_CODE" -ne 0 ]; then',
329
- ' log "[scheduler] ОШИБКА: Quality Gate провален. Код возврата: $GATE_CODE"',
330
- ' ERROR_MESSAGE="Quality Gate провален. Код возврата: $GATE_CODE"',
505
+ // G-1.2: сверяем входы гейта со snapshot'ом, снятым при создании задачи.
506
+ " GATE_INTEGRITY_OK=1",
507
+ ' if [ -n "$GATE_SNAPSHOT" ] && [ -n "$GATE_INTEGRITY" ] && [ -f "$GATE_SNAPSHOT" ] && [ -f "$GATE_INTEGRITY" ]; then',
508
+ ' node "$GATE_INTEGRITY" verify --snapshot "$GATE_SNAPSHOT" --gate-command "$QUALITY_GATE" --prompt-file "$PROMPT_FILE" --timeout "$GATE_TIMEOUT_SECONDS" >> "$LOG_FILE" 2>&1',
509
+ " VERIFY_CODE=$?",
510
+ ' if [ "$VERIFY_CODE" -ne 0 ]; then GATE_INTEGRITY_OK=0; fi',
511
+ " else",
512
+ " GATE_INTEGRITY_OK=0",
513
+ " fi",
514
+ ' if [ "$GATE_INTEGRITY_OK" -eq 0 ]; then',
515
+ ' log "[scheduler] ОШИБКА: целостность входов Quality Gate нарушена (snapshot mismatch)."',
516
+ ' ERROR_MESSAGE="Quality Gate: целостность входов нарушена (snapshot mismatch)"',
331
517
  " EXIT_CODE=1",
332
518
  " else",
333
- ' log "[scheduler] Quality Gate пройден."',
519
+ ' log "[scheduler] Запуск Quality Gate: $QUALITY_GATE"',
520
+ ' run_with_timeout "$GATE_TIMEOUT_SECONDS" bash -c "$QUALITY_GATE" >> "$LOG_FILE" 2>&1',
521
+ " GATE_CODE=$?",
522
+ ' if [ "$GATE_CODE" -ne 0 ]; then',
523
+ ' log "[scheduler] ОШИБКА: Quality Gate провален. Код возврата: $GATE_CODE"',
524
+ ' ERROR_MESSAGE="Quality Gate провален. Код возврата: $GATE_CODE"',
525
+ " EXIT_CODE=1",
526
+ " else",
527
+ ' log "[scheduler] Quality Gate пройден."',
528
+ " fi",
334
529
  " fi",
335
530
  "fi",
336
531
  "",
@@ -357,7 +552,8 @@ export function buildBashWrapperScript(options) {
357
552
  'END_EPOCH="$(date +%s)"',
358
553
  "DURATION_MS=$(( (END_EPOCH - START_EPOCH) * 1000 ))",
359
554
  'STATUS="error"',
360
- 'if [ "$EXIT_CODE" -eq 0 ]; then STATUS="success"; fi',
555
+ 'if [ "$TIMED_OUT" -eq 1 ]; then STATUS="timeout"; elif [ "$EXIT_CODE" -eq 0 ]; then STATUS="success"; fi',
556
+ 'rm -f "$TIMEOUT_MARKER" 2>/dev/null || true',
361
557
  "",
362
558
  'if [ -n "$RECORDER_FILE" ] && command -v node >/dev/null 2>&1; then',
363
559
  ' if [ -n "$RUN_ID" ]; then',
@@ -0,0 +1,124 @@
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
+ /**
26
+ * B13: полураспад веса исхода в последних прогонах. Исход давностью
27
+ * `SUCCESS_HALF_LIFE_RUNS` прогонов весит вдвое меньше свежего.
28
+ */
29
+ export declare const SUCCESS_HALF_LIFE_RUNS = 8;
30
+ /** B13: доля затухающего success rate в итоговой надёжности. */
31
+ export declare const DECAY_WEIGHT = 0.7;
32
+ /** B13: доля first-pass rate в итоговой надёжности. */
33
+ export declare const FIRST_PASS_WEIGHT = 0.3;
34
+ export interface CapabilityRecord {
35
+ taskType: string;
36
+ /** Исполнитель, который последним обрабатывал тип задачи. */
37
+ model: string;
38
+ runsTotal: number;
39
+ runsPassed: number;
40
+ /** B13: сколько успехов получено с первой попытки. */
41
+ firstPassCount: number;
42
+ /** B13: first_pass_count / runs_total. */
43
+ firstPassRate: number;
44
+ successRate: number;
45
+ /** B13: success rate последних прогонов с экспоненциальным затуханием. */
46
+ decayedSuccessRate: number;
47
+ /** B13: 0.7 * decayedSuccessRate + 0.3 * firstPassRate — вход маршрутизации. */
48
+ effectiveSuccessRate: number;
49
+ avgCostUsd: number;
50
+ avgTimeMs: number;
51
+ /** Последние исходы, старые слева, новые справа, максимум 10. */
52
+ last10Runs: number[];
53
+ createdAt: string;
54
+ updatedAt: string;
55
+ }
56
+ /** Один исход гейта: пройден/провален + необязательные стоимость и время. */
57
+ export interface CapabilityOutcome {
58
+ taskType: string;
59
+ model?: string;
60
+ passed: boolean;
61
+ costUsd?: number;
62
+ timeMs?: number;
63
+ /** B13: число попыток до исхода (1 — с первой). */
64
+ attempts?: number;
65
+ /** B13: явный признак first-pass; по умолчанию passed && attempts <= 1. */
66
+ firstPass?: boolean;
67
+ }
68
+ export interface CapabilityThresholds {
69
+ localSuccess?: number;
70
+ cloudFailure?: number;
71
+ minRuns?: number;
72
+ }
73
+ export interface CapabilityDecision {
74
+ taskType: string;
75
+ target: CapabilityTarget;
76
+ /** Машиночитаемая причина: no-data | local-reliable | escalate | review. */
77
+ reason: "no-data" | "local-reliable" | "escalate" | "review";
78
+ successRate: number;
79
+ /** B13: надёжность с учётом затухания и first-pass, по ней принимается решение. */
80
+ effectiveSuccessRate: number;
81
+ /** B13: затухающий success rate последних прогонов. */
82
+ decayedSuccessRate: number;
83
+ /** B13: доля успехов с первой попытки. */
84
+ firstPassRate: number;
85
+ runsTotal: number;
86
+ capability: CapabilityRecord | null;
87
+ }
88
+ /**
89
+ * B13: экспоненциально взвешенный success rate последних исходов.
90
+ *
91
+ * Свежий исход весит 1, исход давностью `halfLife` прогонов — 0.5.
92
+ * Так старые успехи не перевешивают свежие провалы, а `last_10_runs`
93
+ * участвует в решении, а не только хранится для отчёта.
94
+ */
95
+ export declare function decayedSuccessRate(runs: number[], halfLife?: number): number;
96
+ /** B13: надёжность для маршрутизации — затухание плюс успех с первой попытки. */
97
+ export declare function effectiveReliability(decayedRate: number, firstPassRate: number): number;
98
+ /** Читает статистику по типу задачи или `null`, если данных ещё нет. */
99
+ export declare function getCapability(taskType: string): CapabilityRecord | null;
100
+ /** Все известные типы задач, сначала самые надёжные. */
101
+ export declare function listCapabilities(limit?: number): CapabilityRecord[];
102
+ /**
103
+ * Записывает исход гейта и обновляет статистику скользящим средним.
104
+ *
105
+ * Возвращает актуальную запись карты — её же удобно логировать вместе с
106
+ * решением роутера, чтобы видеть, на каких данных он остановился.
107
+ */
108
+ export declare function recordCapabilityOutcome(outcome: CapabilityOutcome): CapabilityRecord;
109
+ /**
110
+ * Решение слоя 2 по порогам (0 токенов).
111
+ *
112
+ * Пороги применяются к `effectiveSuccessRate` — 0.7 затухающего success rate
113
+ * последних прогонов плюс 0.3 first-pass rate (B13), а не к кумулятивному
114
+ * success rate. Поэтому старые успехи не перевешивают свежие провалы.
115
+ *
116
+ * - данных меньше `minRuns` → `explore` (решает слой 3);
117
+ * - `effectiveSuccessRate ≥ 0.85` → `local`;
118
+ * - `effectiveSuccessRate ≤ 0.30` → `cloud` (эскалация);
119
+ * - между порогами → `review` (нужен человек или облачный ревьюер).
120
+ */
121
+ export declare function decideCapabilityRoute(taskType: string, thresholds?: CapabilityThresholds): CapabilityDecision;
122
+ /** Готова ли таблица карты (для диагностики и тестов миграции). */
123
+ export declare function isCapabilityMapReady(): boolean;
124
+ //# 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":"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"}