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,14 +1,38 @@
1
1
  import { spawn } from "node:child_process";
2
2
  import fs from "node:fs";
3
+ import os from "node:os";
3
4
  import { pathToFileURL } from "node:url";
5
+ import { runTaskNow } from "./scheduler/run-now.js";
4
6
  import { createSchedulerBackend } from "./scheduler/index.js";
5
7
  import { notifyTaskCompletion } from "../notifications.js";
6
- import { finishRun, getHistory, recordRun, startRun } from "../db/history-repo.js";
7
- import { getSetting, setSetting } from "../db/settings-repo.js";
8
+ import { finishRun, getLatestHistoryByTask, recordRun, startRun } from "../db/history-repo.js";
9
+ import { deleteSetting, decrementCounterSetting } from "../db/settings-repo.js";
8
10
  import { getTask, listTasks } from "../db/tasks-repo.js";
9
11
  import { rotateSessionIfNeeded } from "./session.js";
10
12
  import { advanceMatrixAfterClone, finalizeMatrixIfComplete, } from "./matrix.js";
11
- const RETRY_STATE_KEY = "retry_state";
13
+ import { appendStructuredLog } from "./structured-log.js";
14
+ /**
15
+ * Диагностика рекордера пишется в runs.jsonl: цепочки, DAG, повторы и
16
+ * one-shot-очистка иначе не видны в машиночитаемом логе. Human-readable
17
+ * вывод остаётся только в логе задачи; stdout `--start` не трогаем — обёртка
18
+ * читает оттуда runId.
19
+ */
20
+ function logRecorderEvent(event, task, details = {}) {
21
+ appendStructuredLog({
22
+ event,
23
+ task,
24
+ runId: details.runId,
25
+ status: details.status,
26
+ error: details.error,
27
+ reason: details.reason,
28
+ nextTask: details.nextTask,
29
+ });
30
+ }
31
+ /** Префикс ключа настроек со счётчиком повторов конкретной задачи. */
32
+ const RETRY_STATE_PREFIX = "retry_state:";
33
+ function retryStateKey(taskName) {
34
+ return `${RETRY_STATE_PREFIX}${taskName.toLowerCase()}`;
35
+ }
12
36
  /** Сколько последних строк лога сканировать при поиске токенов/стоимости. */
13
37
  const LOG_TAIL_LINES = 500;
14
38
  /**
@@ -110,29 +134,23 @@ async function loadRetryConfig(taskName) {
110
134
  */
111
135
  async function triggerTask(taskName) {
112
136
  try {
113
- await createSchedulerBackend().runTask(taskName);
137
+ await runTaskNow(taskName);
114
138
  return true;
115
139
  }
116
140
  catch (err) {
117
- console.error(`[agent-steward] Не удалось запустить задачу цепочки "${taskName}": ${err instanceof Error ? err.message : String(err)}`);
141
+ logRecorderEvent("chain.trigger_failed", taskName, {
142
+ nextTask: taskName,
143
+ error: err instanceof Error ? err.message : String(err),
144
+ });
118
145
  return false;
119
146
  }
120
147
  }
121
- async function loadRetryState() {
122
- const raw = getSetting(RETRY_STATE_KEY, {});
123
- return raw && typeof raw === "object" && !Array.isArray(raw) ? raw : {};
124
- }
125
- async function writeRetryState(state) {
126
- setSetting(RETRY_STATE_KEY, state);
127
- }
128
- async function clearRetryState(taskName) {
129
- const state = await loadRetryState();
130
- const key = Object.keys(state).find((k) => k.toLowerCase() === taskName.toLowerCase());
131
- if (!key)
132
- return;
133
- delete state[key];
134
- await writeRetryState(state);
135
- }
148
+ /*
149
+ * P2-30: раньше счётчики повторов лежали одним JSON-объектом в настройках.
150
+ * Каждое завершение задачи — отдельный процесс record-history, поэтому
151
+ * параллельные завершения перезаписывали map и теряли декременты. Теперь
152
+ * на задачу отдельный ключ и атомарный UPDATE ... RETURNING.
153
+ */
136
154
  /**
137
155
  * Планирует повторный запуск упавшей задачи.
138
156
  *
@@ -146,18 +164,13 @@ async function scheduleRetry(taskName) {
146
164
  const { count, delay } = await loadRetryConfig(taskName);
147
165
  if (count <= 0)
148
166
  return false;
149
- const state = await loadRetryState();
150
- const key = taskName.toLowerCase();
151
- const remaining = Object.prototype.hasOwnProperty.call(state, key)
152
- ? Number(state[key]) || 0
153
- : count;
154
- if (remaining <= 0) {
155
- await clearRetryState(taskName);
156
- console.log(`[agent-steward] Повторы для "${taskName}" исчерпаны.`);
167
+ const key = retryStateKey(taskName);
168
+ const remaining = decrementCounterSetting(key, count);
169
+ if (remaining === null) {
170
+ deleteSetting(key);
171
+ logRecorderEvent("retry.exhausted", taskName, { reason: "retries exhausted" });
157
172
  return false;
158
173
  }
159
- state[key] = remaining - 1;
160
- await writeRetryState(state);
161
174
  const script = process.argv[1];
162
175
  if (!script)
163
176
  return false;
@@ -169,12 +182,15 @@ async function scheduleRetry(taskName) {
169
182
  windowsHide: true,
170
183
  });
171
184
  child.unref();
172
- console.log(`[agent-steward] Задача "${taskName}" будет повторена через ${delay} с ` +
173
- `(осталось повторов: ${remaining - 1}).`);
185
+ logRecorderEvent("retry.scheduled", taskName, {
186
+ reason: `delay=${delay}s, remaining=${remaining}`,
187
+ });
174
188
  return true;
175
189
  }
176
190
  catch (err) {
177
- console.error(`[agent-steward] Не удалось запланировать повтор "${taskName}": ${err instanceof Error ? err.message : String(err)}`);
191
+ logRecorderEvent("retry.schedule_failed", taskName, {
192
+ error: err instanceof Error ? err.message : String(err),
193
+ });
178
194
  return false;
179
195
  }
180
196
  }
@@ -188,11 +204,13 @@ async function runRetry(taskName, delaySec) {
188
204
  const delay = Math.max(1, Math.floor(Number(delaySec) || 60));
189
205
  await new Promise((resolve) => setTimeout(resolve, delay * 1000));
190
206
  try {
191
- await createSchedulerBackend().runTask(taskName);
192
- console.log(`[agent-steward] Повторный запуск задачи "${taskName}".`);
207
+ await runTaskNow(taskName);
208
+ logRecorderEvent("retry.started", taskName);
193
209
  }
194
210
  catch (err) {
195
- console.error(`[agent-steward] Повторный запуск "${taskName}" не удался: ${err instanceof Error ? err.message : String(err)}`);
211
+ logRecorderEvent("retry.failed", taskName, {
212
+ error: err instanceof Error ? err.message : String(err),
213
+ });
196
214
  }
197
215
  }
198
216
  /**
@@ -280,6 +298,36 @@ async function main() {
280
298
  await runRetry(second, Number(third));
281
299
  return;
282
300
  }
301
+ /**
302
+ * W-4: режим пропуска — node record-history.js --skip "<task>" "<reasonB64>" "<logFile>" [durationMs]
303
+ * Вызывается обёртками при срабатывании guard (код 4). Причина передаётся
304
+ * base64, чтобы не подставлять произвольный текст в командную строку. Пропуск
305
+ * попадает в историю и total-метрику, но не считается ошибкой, не шлёт
306
+ * уведомление, не запускает цепочки/повторы и не запускает DAG.
307
+ */
308
+ if (first === "--skip") {
309
+ const taskName = second;
310
+ if (!taskName)
311
+ process.exit(1);
312
+ let reason = "guard conditions not met";
313
+ if (third) {
314
+ try {
315
+ const decoded = Buffer.from(third, "base64").toString("utf8").trim();
316
+ if (decoded)
317
+ reason = decoded;
318
+ }
319
+ catch {
320
+ // Битая base64 — оставляем причину по умолчанию.
321
+ }
322
+ }
323
+ const durationMs = Math.max(0, Number(fifth) || 0);
324
+ const finishedAt = new Date().toISOString();
325
+ const startedAt = new Date(Date.now() - durationMs).toISOString();
326
+ const definition = getTask(taskName);
327
+ recordRun(taskName, "skipped", startedAt, durationMs, reason, null, undefined, undefined, undefined, undefined, undefined, finishedAt, definition?.workspaceId ?? null, definition?.allowedTools ?? null, definition?.deniedTools ?? null);
328
+ await handleCompletion(taskName, "skipped", null, reason, durationMs);
329
+ return;
330
+ }
283
331
  const parseOptionalNumber = (value) => {
284
332
  if (!value || value === "-")
285
333
  return undefined;
@@ -305,7 +353,14 @@ async function main() {
305
353
  process.exit(1);
306
354
  const startedAt = third ?? new Date().toISOString();
307
355
  const definition = getTask(taskName);
308
- const runId = startRun(taskName, startedAt, definition?.workspaceId ?? null, definition?.allowedTools ?? null, definition?.deniedTools ?? null);
356
+ // Владелец — процесс-обёртка, запустивший recorder. Он живёт дольше
357
+ // короткоживущего recorder'а, поэтому именно его PID проверяет recovery.
358
+ const owner = {
359
+ pid: process.ppid && process.ppid > 0 ? process.ppid : null,
360
+ host: os.hostname(),
361
+ startedAt: new Date().toISOString(),
362
+ };
363
+ const runId = startRun(taskName, startedAt, definition?.workspaceId ?? null, definition?.allowedTools ?? null, definition?.deniedTools ?? null, owner);
309
364
  console.log(String(runId));
310
365
  return;
311
366
  }
@@ -342,14 +397,19 @@ async function main() {
342
397
  const model = ninth && ninth !== "-" ? ninth.trim() || undefined : undefined;
343
398
  const preFlightStatus = parseHookStatus(tenth);
344
399
  const postFlightStatus = parseHookStatus(eleventh);
345
- const st = status === "success" ? "success" : status === "timeout" ? "timeout" : "error";
400
+ const st = status === "success" ? "success" : status === "timeout" ? "timeout" : status === "skipped" ? "skipped" : "error";
346
401
  const definition = getTask(taskName);
347
402
  const chainTarget = st === "success"
348
403
  ? definition?.nextTaskOnSuccess || null
349
- : definition?.nextTaskOnError || null;
404
+ : st === "skipped"
405
+ ? null
406
+ : definition?.nextTaskOnError || null;
350
407
  const completed = finishRun(runId, st, durationMs, error, chainTarget, tokensResolved, costResolved, model, preFlightStatus, postFlightStatus);
351
408
  if (!completed) {
352
- console.error(`[agent-steward] record-history: запись #${runId} уже завершена или не найдена.`);
409
+ logRecorderEvent("run.finish_skipped", taskName, {
410
+ runId,
411
+ reason: "already finished or not found",
412
+ });
353
413
  return;
354
414
  }
355
415
  await handleCompletion(taskName, st, chainTarget, error, durationMs, tokensResolved, costResolved);
@@ -368,18 +428,66 @@ async function main() {
368
428
  // "-" означает «данных нет» (openCode не печатал usage в лог).
369
429
  const tokens = parseOptionalNumber(sixth);
370
430
  const costUsd = parseOptionalNumber(seventh);
431
+ // B10: 11-й аргумент — лог-файл задачи. Раньше legacy-режим его не читал,
432
+ // поэтому при "-" в токенах/стоимости usage терялся. Парсим лог так же,
433
+ // как режим --finish; отсутствие файла — graceful fallback (parseUsageFromLog
434
+ // возвращает пустой объект и не бросает).
435
+ const logFile = eleventh && eleventh !== "-" ? eleventh : undefined;
436
+ let tokensResolved = tokens;
437
+ let costResolved = costUsd;
438
+ if ((tokensResolved === undefined || costResolved === undefined) && logFile) {
439
+ const usage = parseUsageFromLog(logFile);
440
+ if (tokensResolved === undefined && usage.tokens !== undefined) {
441
+ tokensResolved = usage.tokens;
442
+ }
443
+ if (costResolved === undefined && usage.costUsd !== undefined) {
444
+ costResolved = usage.costUsd;
445
+ }
446
+ }
371
447
  // Восьмой аргумент — модель; "-" означает, что модель не задана.
372
448
  const model = eighth && eighth !== "-" ? eighth.trim() || undefined : undefined;
373
449
  // Девятый и десятый — итоги pre/post-flight хуков.
374
450
  const preFlightStatus = parseHookStatus(ninth);
375
451
  const postFlightStatus = parseHookStatus(tenth);
376
- const st = status === "success" ? "success" : status === "timeout" ? "timeout" : "error";
452
+ const st = status === "success" ? "success" : status === "timeout" ? "timeout" : status === "skipped" ? "skipped" : "error";
377
453
  const definition = getTask(taskName);
378
454
  const chainTarget = st === "success"
379
455
  ? definition?.nextTaskOnSuccess || null
380
- : definition?.nextTaskOnError || null;
381
- recordRun(taskName, st, startedAt, durationMs, error, chainTarget, tokens, costUsd, model, preFlightStatus, postFlightStatus, new Date().toISOString(), definition?.workspaceId ?? null, definition?.allowedTools ?? null, definition?.deniedTools ?? null);
382
- await handleCompletion(taskName, st, chainTarget, error, durationMs, tokens, costUsd);
456
+ : st === "skipped"
457
+ ? null
458
+ : definition?.nextTaskOnError || null;
459
+ recordRun(taskName, st, startedAt, durationMs, error, chainTarget, tokensResolved, costResolved, model, preFlightStatus, postFlightStatus, new Date().toISOString(), definition?.workspaceId ?? null, definition?.allowedTools ?? null, definition?.deniedTools ?? null);
460
+ await handleCompletion(taskName, st, chainTarget, error, durationMs, tokensResolved, costResolved);
461
+ }
462
+ /**
463
+ * Удаляет отработавшую ONCE-задачу из Планировщика Windows.
464
+ *
465
+ * `schtasks /create ... /z` должен был делать это сам, но на Win10/11
466
+ * возвращает «The task XML is missing a required element ... EndBoundary»
467
+ * и задача вообще не создаётся. Поэтому чистим после запуска вручную.
468
+ * На Linux/macOS очистка не нужна: `at` и launchd убирают one-shot сами.
469
+ */
470
+ export async function cleanupWindowsOneShotTask(taskName, deps = {}) {
471
+ const platform = deps.platform ?? process.platform;
472
+ if (platform !== "win32")
473
+ return false;
474
+ const getDefinition = deps.getDefinition ?? getTask;
475
+ const definition = getDefinition(taskName);
476
+ if (!definition || definition.triggerType !== "once")
477
+ return false;
478
+ const deleteTask = deps.deleteTask ??
479
+ ((name) => createSchedulerBackend().deleteTask(name));
480
+ try {
481
+ await deleteTask(taskName);
482
+ logRecorderEvent("oneshot.cleaned", taskName);
483
+ return true;
484
+ }
485
+ catch (err) {
486
+ logRecorderEvent("oneshot.cleanup_failed", taskName, {
487
+ error: err instanceof Error ? err.message : String(err),
488
+ });
489
+ return false;
490
+ }
383
491
  }
384
492
  /**
385
493
  * Общая пост-обработка завершённого запуска: уведомление, цепочки задач,
@@ -387,10 +495,17 @@ async function main() {
387
495
  */
388
496
  async function handleCompletion(taskName, st, chainTarget, error, durationMs, tokens, costUsd) {
389
497
  // Уведомление о завершении (webhook). Ошибки отправки логируются внутри
390
- // и не влияют на историю, цепочки и повторы.
391
- await notifyTaskCompletion(taskName, st, durationMs, error, tokens, costUsd, {
392
- asyncTriage: true,
393
- });
498
+ // и не влияют на историю, цепочки и повторы. Пропуск guard не уведомляем:
499
+ // для него нет отдельного шаблона, а шум в уведомлениях не нужен.
500
+ if (st !== "skipped") {
501
+ await notifyTaskCompletion(taskName, st, durationMs, error, tokens, costUsd, {
502
+ asyncTriage: true,
503
+ });
504
+ }
505
+ // P2-27: Windows не удаляет ONCE-задачи сам, а флаг schtasks `/z` на
506
+ // практике ломает создание задачи («task XML ... EndBoundary»).
507
+ // Поэтому снимаем отработавшую one-shot задачу из Планировщика здесь.
508
+ await cleanupWindowsOneShotTask(taskName);
394
509
  // Matrix (Спринт 15): клон завершился — двигаем sequential-цепочку или
395
510
  // очередь concurrency-лимита (Спринт 17), а когда все клоны готовы —
396
511
  // фиксируем агрегат и запускаем matrix-complete.
@@ -399,43 +514,49 @@ async function handleCompletion(taskName, st, chainTarget, error, durationMs, to
399
514
  await finalizeMatrixIfComplete(taskName);
400
515
  }
401
516
  catch (err) {
402
- console.log(`[matrix] ${taskName}: ошибка обработки матрицы: ${err instanceof Error ? err.message : String(err)}`);
517
+ logRecorderEvent("matrix.error", taskName, {
518
+ error: err instanceof Error ? err.message : String(err),
519
+ });
403
520
  }
404
521
  if (st === "success") {
405
522
  // Успешный запуск сбрасывает счётчик повторов.
406
- await clearRetryState(taskName);
523
+ await deleteSetting(retryStateKey(taskName));
407
524
  if (chainTarget) {
408
525
  const started = await triggerTask(chainTarget);
409
526
  if (started) {
410
- console.log(`[agent-steward] Запущена следующая задача в цепочке: ${chainTarget}`);
527
+ logRecorderEvent("chain.triggered", taskName, { nextTask: chainTarget });
411
528
  }
412
529
  }
413
530
  // DAG: после успеха проверяем задачи, у которых эта задача — одна из
414
531
  // зависимостей. Запускаем только если ВСЕ зависимости уже успешны и
415
532
  // зависимая задача ещё не запускалась после их завершения.
416
533
  try {
417
- const history = getHistory(null, 200);
534
+ // P2-29: по одной последней записи на задачу, а не «последние 200 строк».
535
+ const history = getLatestHistoryByTask();
418
536
  const definitions = listTasks();
419
537
  const dependents = selectDependentsToTrigger(taskName, definitions, history);
420
538
  for (const dependent of dependents) {
421
539
  const started = await triggerTask(dependent);
422
540
  if (started) {
423
- console.log(`[agent-steward] DAG: все зависимости выполнены, запущена задача "${dependent}".`);
541
+ logRecorderEvent("dag.triggered", taskName, { nextTask: dependent });
424
542
  }
425
543
  }
426
544
  }
427
545
  catch (err) {
428
- console.error(`[agent-steward] DAG: не удалось запустить зависимые задачи: ${err instanceof Error ? err.message : String(err)}`);
546
+ logRecorderEvent("dag.trigger_failed", taskName, {
547
+ error: err instanceof Error ? err.message : String(err),
548
+ });
429
549
  }
430
550
  }
431
- else {
551
+ else if (st !== "skipped") {
432
552
  // Сначала пытаемся повторить саму задачу; компенсирующая задача запускается
433
553
  // только когда повторы исчерпаны (или не настроены).
554
+ // Пропуск guard — не ошибка: повторы и компенсации не запускаются.
434
555
  const retryScheduled = await scheduleRetry(taskName);
435
556
  if (!retryScheduled && chainTarget) {
436
557
  const started = await triggerTask(chainTarget);
437
558
  if (started) {
438
- console.log(`[agent-steward] Запущена компенсирующая задача: ${chainTarget}`);
559
+ logRecorderEvent("compensation.triggered", taskName, { nextTask: chainTarget });
439
560
  }
440
561
  }
441
562
  }
@@ -445,7 +566,9 @@ async function handleCompletion(taskName, st, chainTarget, error, durationMs, to
445
566
  await rotateSessionIfNeeded(taskName);
446
567
  }
447
568
  catch (err) {
448
- console.warn(`[agent-steward] Не удалось обновить состояние сессии "${taskName}": ${err instanceof Error ? err.message : String(err)}`);
569
+ logRecorderEvent("session.rotate_failed", taskName, {
570
+ error: err instanceof Error ? err.message : String(err),
571
+ });
449
572
  }
450
573
  }
451
574
  /**
@@ -465,7 +588,9 @@ function isDirectInvocation() {
465
588
  }
466
589
  if (isDirectInvocation()) {
467
590
  main().catch((err) => {
468
- console.error(`[agent-steward] record-history: не удалось записать результат запуска: ${err instanceof Error ? err.message : String(err)}`);
591
+ logRecorderEvent("record_history.fatal", "record-history", {
592
+ error: err instanceof Error ? err.message : String(err),
593
+ });
469
594
  process.exit(1);
470
595
  });
471
596
  }
@@ -0,0 +1,36 @@
1
+ /**
2
+ * Сборка маршрута шага из слоёв 1–2 (Спринт 36.5.d).
3
+ *
4
+ * Слой 1 отвечает мгновенно по таблице правил, слой 2 — по Capability Map.
5
+ * Модель здесь не участвует: `routeStep` не импортирует planner и ничего не
6
+ * декомпозирует, поэтому известный тип задачи обходится в 0 токенов.
7
+ */
8
+ import type { CapabilityDecision, CapabilityThresholds } from "../../db/capability-repo.js";
9
+ import type { RouterExecutor, RouterTransport } from "./rules.js";
10
+ /** Откуда взято решение о маршруте. */
11
+ export type RouteSource = "static" | "capability";
12
+ /** Куда направляется шаг: исполнение или ручной разбор. */
13
+ export type RouteTarget = "local" | "cloud" | "review" | "explore";
14
+ /** Готовый маршрут шага. */
15
+ export interface StepRoute {
16
+ /** Нормализованный тип задачи. */
17
+ taskType: string;
18
+ /** Кто исполняет шаг либо почему шаг уходит человеку. */
19
+ target: RouteTarget;
20
+ /** Транспорт; `null` для `review`/`explore`, где исполнения пока нет. */
21
+ transport: RouterTransport | null;
22
+ /** Исполнитель; `null` для `review`/`explore`. */
23
+ executor: RouterExecutor | null;
24
+ /** Слой, принявший решение. */
25
+ source: RouteSource;
26
+ /** Стабильный код причины: `static-rule` либо решение Capability Map. */
27
+ reason: string;
28
+ /** Решение слоя 2, если он участвовал. */
29
+ decision?: CapabilityDecision;
30
+ }
31
+ /**
32
+ * Строит маршрут для типа задачи: статическое правило, затем Capability Map.
33
+ * Пустой тип — ошибка, а не молчаливый `explore`: маршрутизировать нечего.
34
+ */
35
+ export declare function routeStep(taskType: string, thresholds?: CapabilityThresholds): StepRoute;
36
+ //# sourceMappingURL=dispatch.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"dispatch.d.ts","sourceRoot":"","sources":["../../../src/core/router/dispatch.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,KAAK,EAAE,kBAAkB,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AAE5F,OAAO,KAAK,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAElE,uCAAuC;AACvC,MAAM,MAAM,WAAW,GAAG,QAAQ,GAAG,YAAY,CAAC;AAElD,2DAA2D;AAC3D,MAAM,MAAM,WAAW,GAAG,OAAO,GAAG,OAAO,GAAG,QAAQ,GAAG,SAAS,CAAC;AAEnE,4BAA4B;AAC5B,MAAM,WAAW,SAAS;IACxB,kCAAkC;IAClC,QAAQ,EAAE,MAAM,CAAC;IACjB,yDAAyD;IACzD,MAAM,EAAE,WAAW,CAAC;IACpB,yEAAyE;IACzE,SAAS,EAAE,eAAe,GAAG,IAAI,CAAC;IAClC,kDAAkD;IAClD,QAAQ,EAAE,cAAc,GAAG,IAAI,CAAC;IAChC,+BAA+B;IAC/B,MAAM,EAAE,WAAW,CAAC;IACpB,yEAAyE;IACzE,MAAM,EAAE,MAAM,CAAC;IACf,0CAA0C;IAC1C,QAAQ,CAAC,EAAE,kBAAkB,CAAC;CAC/B;AAED;;;GAGG;AACH,wBAAgB,SAAS,CACvB,QAAQ,EAAE,MAAM,EAChB,UAAU,GAAE,oBAAyB,GACpC,SAAS,CA6BX"}
@@ -0,0 +1,59 @@
1
+ /**
2
+ * Сборка маршрута шага из слоёв 1–2 (Спринт 36.5.d).
3
+ *
4
+ * Слой 1 отвечает мгновенно по таблице правил, слой 2 — по Capability Map.
5
+ * Модель здесь не участвует: `routeStep` не импортирует planner и ничего не
6
+ * декомпозирует, поэтому известный тип задачи обходится в 0 токенов.
7
+ */
8
+ import { decideCapabilityRoute } from "../../db/capability-repo.js";
9
+ import { normalizeTaskType, routeStaticStep } from "./rules.js";
10
+ /**
11
+ * Строит маршрут для типа задачи: статическое правило, затем Capability Map.
12
+ * Пустой тип — ошибка, а не молчаливый `explore`: маршрутизировать нечего.
13
+ */
14
+ export function routeStep(taskType, thresholds = {}) {
15
+ const key = normalizeTaskType(taskType);
16
+ if (key === "") {
17
+ throw new Error("Пустой тип задачи: маршрутизация невозможна.");
18
+ }
19
+ const rule = routeStaticStep(key);
20
+ if (rule !== undefined) {
21
+ return {
22
+ taskType: key,
23
+ target: rule.executor,
24
+ transport: rule.transport,
25
+ executor: rule.executor,
26
+ source: "static",
27
+ reason: "static-rule",
28
+ };
29
+ }
30
+ const decision = decideCapabilityRoute(key, thresholds);
31
+ const target = decision.target;
32
+ return {
33
+ taskType: key,
34
+ target,
35
+ transport: transportForTarget(target),
36
+ executor: executorForTarget(target),
37
+ source: "capability",
38
+ reason: decision.reason,
39
+ decision,
40
+ };
41
+ }
42
+ function transportForTarget(target) {
43
+ if (target === "cloud") {
44
+ return "cloud";
45
+ }
46
+ if (target === "local") {
47
+ return "direct";
48
+ }
49
+ return null;
50
+ }
51
+ function executorForTarget(target) {
52
+ if (target === "cloud") {
53
+ return "cloud";
54
+ }
55
+ if (target === "local") {
56
+ return "local";
57
+ }
58
+ return null;
59
+ }
@@ -0,0 +1,47 @@
1
+ /**
2
+ * Эскалация после провала Quality Gate (Спринт 36.5.d).
3
+ *
4
+ * Правило детерминированное и не обращается ни к БД, ни к модели, ни к сети:
5
+ * провал на локальном исполнителе ведёт в облако, провал в облаке — на ручной
6
+ * review, провал review означает, что автоматических уровней больше нет.
7
+ * Решение принимается по одному флагу `passed`, поэтому его можно вызывать
8
+ * в горячем пути без затрат токенов.
9
+ */
10
+ /** Уровень исполнения, на котором сработал Quality Gate. */
11
+ export type GateTarget = "local" | "cloud" | "review";
12
+ /** Что делать после проверки гейта. */
13
+ export type EscalationAction = "accept" | "escalate-cloud" | "escalate-review" | "blocked";
14
+ /** Результат Quality Gate, который видит роутер. */
15
+ export interface GateResult {
16
+ /** Прошёл ли шаг проверку. */
17
+ passed: boolean;
18
+ /** Свободное пояснение для журнала и уведомлений. */
19
+ reason?: string;
20
+ }
21
+ /** Решение об эскалации с текущего уровня. */
22
+ export interface EscalationDecision {
23
+ /** Уровень, на котором гейт сработал. */
24
+ from: GateTarget;
25
+ /** Куда переходим (при `accept` совпадает с `from`). */
26
+ next: GateTarget;
27
+ action: EscalationAction;
28
+ /** Почему принято решение: стабильный код, а не текст ошибки. */
29
+ reason: "gate-passed" | "local-failed" | "cloud-failed" | "review-failed";
30
+ }
31
+ /** Сколько автоматических эскалаций допускает цепочка local → cloud → review. */
32
+ export declare const MAX_ESCALATION_STEPS = 2;
33
+ /** Следующий уровень эскалации; `null` — автоматических уровней больше нет. */
34
+ export declare function nextGateTarget(current: GateTarget): GateTarget | null;
35
+ /** Исчерпаны ли автоматические уровни для текущего исполнителя. */
36
+ export declare function isEscalationExhausted(current: GateTarget): boolean;
37
+ /**
38
+ * Решает, что делать после гейта: принять результат или подняться на уровень
39
+ * выше. Модель здесь не вызывается — только таблица переходов.
40
+ */
41
+ export declare function escalateAfterGate(current: GateTarget, gate: GateResult): EscalationDecision;
42
+ /**
43
+ * Полная цепочка уровней, которые предстоит пройти начиная с текущего
44
+ * (включая его). Полезно для dry-run и объяснения решения оператору.
45
+ */
46
+ export declare function escalationChain(current: GateTarget): GateTarget[];
47
+ //# sourceMappingURL=escalation.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"escalation.d.ts","sourceRoot":"","sources":["../../../src/core/router/escalation.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,4DAA4D;AAC5D,MAAM,MAAM,UAAU,GAAG,OAAO,GAAG,OAAO,GAAG,QAAQ,CAAC;AAEtD,uCAAuC;AACvC,MAAM,MAAM,gBAAgB,GACxB,QAAQ,GACR,gBAAgB,GAChB,iBAAiB,GACjB,SAAS,CAAC;AAEd,oDAAoD;AACpD,MAAM,WAAW,UAAU;IACzB,8BAA8B;IAC9B,MAAM,EAAE,OAAO,CAAC;IAChB,qDAAqD;IACrD,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,8CAA8C;AAC9C,MAAM,WAAW,kBAAkB;IACjC,yCAAyC;IACzC,IAAI,EAAE,UAAU,CAAC;IACjB,wDAAwD;IACxD,IAAI,EAAE,UAAU,CAAC;IACjB,MAAM,EAAE,gBAAgB,CAAC;IACzB,iEAAiE;IACjE,MAAM,EAAE,aAAa,GAAG,cAAc,GAAG,cAAc,GAAG,eAAe,CAAC;CAC3E;AAWD,iFAAiF;AACjF,eAAO,MAAM,oBAAoB,IAAI,CAAC;AAiBtC,+EAA+E;AAC/E,wBAAgB,cAAc,CAAC,OAAO,EAAE,UAAU,GAAG,UAAU,GAAG,IAAI,CAGrE;AAED,mEAAmE;AACnE,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,UAAU,GAAG,OAAO,CAElE;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,UAAU,EACnB,IAAI,EAAE,UAAU,GACf,kBAAkB,CA6BpB;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,UAAU,GAAG,UAAU,EAAE,CASjE"}
@@ -0,0 +1,87 @@
1
+ /**
2
+ * Эскалация после провала Quality Gate (Спринт 36.5.d).
3
+ *
4
+ * Правило детерминированное и не обращается ни к БД, ни к модели, ни к сети:
5
+ * провал на локальном исполнителе ведёт в облако, провал в облаке — на ручной
6
+ * review, провал review означает, что автоматических уровней больше нет.
7
+ * Решение принимается по одному флагу `passed`, поэтому его можно вызывать
8
+ * в горячем пути без затрат токенов.
9
+ */
10
+ /** Следующий уровень эскалации или `null`, если уровни закончились. */
11
+ const NEXT_TARGET = Object.freeze({
12
+ local: "cloud",
13
+ cloud: "review",
14
+ review: null,
15
+ });
16
+ /** Сколько автоматических эскалаций допускает цепочка local → cloud → review. */
17
+ export const MAX_ESCALATION_STEPS = 2;
18
+ function assertTarget(target) {
19
+ if (!Object.prototype.hasOwnProperty.call(NEXT_TARGET, target)) {
20
+ throw new Error(`Неизвестный уровень гейта: ${String(target)}`);
21
+ }
22
+ }
23
+ function assertGate(gate) {
24
+ if (gate === null || typeof gate !== "object") {
25
+ throw new Error("Результат Quality Gate должен быть объектом.");
26
+ }
27
+ if (typeof gate.passed !== "boolean") {
28
+ throw new Error("Результат Quality Gate должен содержать boolean (passed).");
29
+ }
30
+ }
31
+ /** Следующий уровень эскалации; `null` — автоматических уровней больше нет. */
32
+ export function nextGateTarget(current) {
33
+ assertTarget(current);
34
+ return NEXT_TARGET[current];
35
+ }
36
+ /** Исчерпаны ли автоматические уровни для текущего исполнителя. */
37
+ export function isEscalationExhausted(current) {
38
+ return nextGateTarget(current) === null;
39
+ }
40
+ /**
41
+ * Решает, что делать после гейта: принять результат или подняться на уровень
42
+ * выше. Модель здесь не вызывается — только таблица переходов.
43
+ */
44
+ export function escalateAfterGate(current, gate) {
45
+ assertTarget(current);
46
+ assertGate(gate);
47
+ if (gate.passed) {
48
+ return { from: current, next: current, action: "accept", reason: "gate-passed" };
49
+ }
50
+ const next = NEXT_TARGET[current];
51
+ if (next === null) {
52
+ return {
53
+ from: current,
54
+ next: current,
55
+ action: "blocked",
56
+ reason: "review-failed",
57
+ };
58
+ }
59
+ if (next === "cloud") {
60
+ return {
61
+ from: current,
62
+ next,
63
+ action: "escalate-cloud",
64
+ reason: "local-failed",
65
+ };
66
+ }
67
+ return {
68
+ from: current,
69
+ next,
70
+ action: "escalate-review",
71
+ reason: "cloud-failed",
72
+ };
73
+ }
74
+ /**
75
+ * Полная цепочка уровней, которые предстоит пройти начиная с текущего
76
+ * (включая его). Полезно для dry-run и объяснения решения оператору.
77
+ */
78
+ export function escalationChain(current) {
79
+ assertTarget(current);
80
+ const chain = [];
81
+ let target = current;
82
+ while (target !== null) {
83
+ chain.push(target);
84
+ target = NEXT_TARGET[target];
85
+ }
86
+ return chain;
87
+ }