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
@@ -0,0 +1,191 @@
1
+ import { randomUUID } from "node:crypto";
2
+ import { getDb, withTransaction } from "./index.js";
3
+ import { getRun, getStep, reopenRun, retryStep, startRun, } from "./runs-repo.js";
4
+ /** Сколько попыток считается детерминированным падением по умолчанию. */
5
+ export const DEFAULT_DLQ_MIN_ATTEMPTS = 3;
6
+ function nowIso() {
7
+ return new Date().toISOString();
8
+ }
9
+ function normalizeLimit(limit, fallback) {
10
+ const value = Math.floor(limit ?? fallback);
11
+ if (!Number.isFinite(value) || value < 1)
12
+ return fallback;
13
+ return Math.min(10000, value);
14
+ }
15
+ function dlqRowToEntry(row) {
16
+ return {
17
+ id: String(row.id),
18
+ runId: String(row.run_id),
19
+ stepName: String(row.step_name),
20
+ status: String(row.status),
21
+ reason: row.reason == null ? null : String(row.reason),
22
+ error: row.error == null ? null : String(row.error),
23
+ attempts: Number(row.attempts) || 0,
24
+ createdAt: String(row.created_at),
25
+ updatedAt: String(row.updated_at),
26
+ resolvedAt: row.resolved_at == null ? null : String(row.resolved_at),
27
+ resolution: row.resolution == null ? null : String(row.resolution),
28
+ };
29
+ }
30
+ /** Шаг исчерпал попытки и больше не будет повторён автоматически? */
31
+ export function isDeadLetterStep(step, minAttempts = DEFAULT_DLQ_MIN_ATTEMPTS) {
32
+ const threshold = Math.max(1, Math.floor(minAttempts) || DEFAULT_DLQ_MIN_ATTEMPTS);
33
+ return step.status === "failed" && step.attempt >= threshold;
34
+ }
35
+ /** Открытая запись DLQ на конкретный шаг (или undefined). */
36
+ export function findOpenDeadLetter(runId, stepName) {
37
+ const row = getDb()
38
+ .prepare("SELECT * FROM run_dlq WHERE run_id = ? AND step_name = ? AND status = 'open' LIMIT 1")
39
+ .get(runId, stepName);
40
+ return row ? dlqRowToEntry(row) : undefined;
41
+ }
42
+ /**
43
+ * Ставит шаг в DLQ. Идемпотентно: если открытая запись уже есть, возвращает её
44
+ * с `created: false`. Ошибка шага сохраняется как снимок на момент постановки.
45
+ */
46
+ export function enqueueDeadLetter(runId, stepName, options = {}) {
47
+ return withTransaction(() => {
48
+ const existing = findOpenDeadLetter(runId, stepName);
49
+ if (existing)
50
+ return { entry: existing, created: false };
51
+ const step = getStep(runId, stepName);
52
+ if (!step) {
53
+ throw new Error(`Шаг не найден: ${runId}/${stepName}`);
54
+ }
55
+ const id = `dlq_${randomUUID()}`;
56
+ const timestamp = nowIso();
57
+ getDb()
58
+ .prepare(`INSERT INTO run_dlq
59
+ (id, run_id, step_name, status, reason, error, attempts, created_at, updated_at,
60
+ resolved_at, resolution)
61
+ VALUES (?, ?, ?, 'open', ?, ?, ?, ?, ?, NULL, NULL)`)
62
+ .run(id, runId, stepName, options.reason ?? "attempts-exhausted", options.error ?? step.error ?? null, Math.max(1, Math.floor(options.attempts ?? step.attempt) || 1), timestamp, timestamp);
63
+ return { entry: getDeadLetter(id), created: true };
64
+ });
65
+ }
66
+ /**
67
+ * Ищет детерминированно упавшие шаги и ставит их в очередь.
68
+ *
69
+ * Детерминированность здесь прагматичная: шаг в `failed` и `attempt` достиг
70
+ * порога. Автоматические повторы уже не помогут — нужен человек.
71
+ * Возвращает только новые записи, поэтому скан можно вызывать по расписанию.
72
+ */
73
+ export function scanDeadLetters(options = {}) {
74
+ const minAttempts = Math.max(1, Math.floor(options.minAttempts ?? DEFAULT_DLQ_MIN_ATTEMPTS) || DEFAULT_DLQ_MIN_ATTEMPTS);
75
+ const limit = normalizeLimit(options.limit, 100);
76
+ const params = [minAttempts];
77
+ let where = "status = 'failed' AND attempt >= ?";
78
+ if (options.runId) {
79
+ where += " AND run_id = ?";
80
+ params.push(options.runId);
81
+ }
82
+ params.push(limit);
83
+ const rows = getDb()
84
+ .prepare(`SELECT run_id, step_name FROM run_steps WHERE ${where}
85
+ ORDER BY updated_at ASC, rowid ASC LIMIT ?`)
86
+ .all(...params);
87
+ const created = [];
88
+ for (const row of rows) {
89
+ const result = enqueueDeadLetter(String(row.run_id), String(row.step_name));
90
+ if (result.created)
91
+ created.push(result.entry);
92
+ }
93
+ return created;
94
+ }
95
+ export function getDeadLetter(id) {
96
+ const row = getDb().prepare("SELECT * FROM run_dlq WHERE id = ?").get(id);
97
+ return row ? dlqRowToEntry(row) : undefined;
98
+ }
99
+ /** Записи очереди, новые сверху. По умолчанию — только открытые. */
100
+ export function listDeadLetters(options = {}) {
101
+ const limit = normalizeLimit(options.limit, 100);
102
+ const status = options.status ?? "open";
103
+ if (status === "all") {
104
+ return getDb()
105
+ .prepare("SELECT * FROM run_dlq ORDER BY created_at DESC, rowid DESC LIMIT ?")
106
+ .all(limit)
107
+ .map((row) => dlqRowToEntry(row));
108
+ }
109
+ return getDb()
110
+ .prepare("SELECT * FROM run_dlq WHERE status = ? ORDER BY created_at DESC, rowid DESC LIMIT ?")
111
+ .all(status, limit)
112
+ .map((row) => dlqRowToEntry(row));
113
+ }
114
+ /** Сколько записей в статусе (по умолчанию открытых). */
115
+ export function countDeadLetters(status = "open") {
116
+ const row = getDb().prepare("SELECT COUNT(*) AS count FROM run_dlq WHERE status = ?").get(status);
117
+ return Number(row?.count) || 0;
118
+ }
119
+ /**
120
+ * Ручной retry из DLQ.
121
+ *
122
+ * Готовит шаг к повторному выполнению: переоткрывает упавший запуск, переводит
123
+ * шаг в `running` с `attempt + 1` и закрывает запись DLQ как `retried`.
124
+ * Сам обработчик не вызывается — дальше шаг подхватывает `resumeRun`.
125
+ */
126
+ export function retryDeadLetter(id, options = {}) {
127
+ return withTransaction(() => {
128
+ const entry = getDeadLetter(id);
129
+ if (!entry)
130
+ throw new Error(`Запись DLQ не найдена: ${id}`);
131
+ if (entry.status !== "open") {
132
+ throw new Error(`Запись DLQ уже обработана: ${entry.status}`);
133
+ }
134
+ const run = getRun(entry.runId);
135
+ if (!run)
136
+ throw new Error(`Запуск не найден: ${entry.runId}`);
137
+ const step = getStep(entry.runId, entry.stepName);
138
+ if (!step)
139
+ throw new Error(`Шаг не найден: ${entry.runId}/${entry.stepName}`);
140
+ if (step.status !== "failed") {
141
+ throw new Error(`Шаг ${entry.stepName} в статусе ${step.status}, повтор невозможен`);
142
+ }
143
+ let runReopened = false;
144
+ if (run.status === "failed") {
145
+ reopenRun(run.id, options.startedAt);
146
+ runReopened = true;
147
+ }
148
+ else if (run.status === "pending") {
149
+ startRun(run.id, options.startedAt);
150
+ }
151
+ else if (run.status !== "running") {
152
+ throw new Error(`Запуск ${run.id} в статусе ${run.status}, повтор невозможен`);
153
+ }
154
+ retryStep(step.id, options.startedAt);
155
+ const timestamp = nowIso();
156
+ getDb()
157
+ .prepare(`UPDATE run_dlq SET status = 'retried', resolved_at = ?, resolution = 'manual-retry',
158
+ updated_at = ? WHERE id = ?`)
159
+ .run(timestamp, timestamp, id);
160
+ return {
161
+ entry: getDeadLetter(id),
162
+ step: getStep(entry.runId, entry.stepName),
163
+ run: getRun(run.id),
164
+ runReopened,
165
+ };
166
+ });
167
+ }
168
+ /** Осознанный отказ: запись закрывается, шаг остаётся failed. */
169
+ export function discardDeadLetter(id, resolution = "discarded") {
170
+ return withTransaction(() => {
171
+ const entry = getDeadLetter(id);
172
+ if (!entry)
173
+ throw new Error(`Запись DLQ не найдена: ${id}`);
174
+ if (entry.status !== "open") {
175
+ throw new Error(`Запись DLQ уже обработана: ${entry.status}`);
176
+ }
177
+ const timestamp = nowIso();
178
+ getDb()
179
+ .prepare(`UPDATE run_dlq SET status = 'discarded', resolved_at = ?, resolution = ?,
180
+ updated_at = ? WHERE id = ?`)
181
+ .run(timestamp, resolution, timestamp, id);
182
+ return getDeadLetter(id);
183
+ });
184
+ }
185
+ /** Готова ли схема к работе с DLQ (таблица из миграции v5). */
186
+ export function isDlqReady() {
187
+ const row = getDb()
188
+ .prepare("SELECT name FROM sqlite_master WHERE type = 'table' AND name = 'run_dlq'")
189
+ .get();
190
+ return Boolean(row);
191
+ }
@@ -9,10 +9,20 @@ import { type RunRecord, type RunStepRecord } from "./runs-repo.js";
9
9
  */
10
10
  /** Текст ошибки, которым помечается шаг, прерванный падением процесса. */
11
11
  export declare const STEP_INTERRUPTED_ERROR = "\u041F\u0440\u0435\u0440\u0432\u0430\u043D\u043E \u043F\u0430\u0434\u0435\u043D\u0438\u0435\u043C \u043F\u0440\u043E\u0446\u0435\u0441\u0441\u0430";
12
+ /**
13
+ * B12: срок lease шага по умолчанию. Живой процесс продлевает lease
14
+ * (heartbeat в `runStepStatefullyAsync` или явный `renewStepLease`), поэтому
15
+ * recovery финализирует шаг только после истечения этого срока.
16
+ */
17
+ export declare const STEP_LEASE_MS = 60000;
18
+ /** B12: идентификатор текущего процесса — `host:pid:startedAt`. */
19
+ export declare function getStepOwnerId(): string;
12
20
  /** Опции начала попытки. */
13
21
  export interface BeginStepOptions {
14
22
  /** Начать запуск, если он ещё в статусе pending (по умолчанию true). */
15
23
  startRun?: boolean;
24
+ /** B12: срок lease в миллисекундах (по умолчанию {@link STEP_LEASE_MS}). */
25
+ leaseMs?: number;
16
26
  }
17
27
  /** Результат выполнения шага через `runStepStatefully`. */
18
28
  export interface StepExecution<T> {
@@ -33,6 +43,14 @@ export interface StepExecution<T> {
33
43
  * попытки увеличивается, а не начинается заново.
34
44
  */
35
45
  export declare function beginStepAttempt(runId: string, stepName: string, options?: BeginStepOptions): RunStepRecord;
46
+ /**
47
+ * B12: продлевает lease шага текущего процесса.
48
+ *
49
+ * Нужен долгим синхронным шагам: без продления recovery сочтёт шаг
50
+ * осиротевшим после {@link STEP_LEASE_MS}. Возвращает false, если шаг уже
51
+ * не `running`.
52
+ */
53
+ export declare function renewStepLease(runId: string, stepName: string, leaseMs?: number): boolean;
36
54
  /** Закрывает попытку успехом: running → passed, сохраняет output. */
37
55
  export declare function recordStepSuccess(runId: string, stepName: string, output?: unknown): RunStepRecord;
38
56
  /** Закрывает попытку ошибкой: running → failed, сохраняет текст ошибки. */
@@ -45,14 +63,24 @@ export declare function recordStepFailure(runId: string, stepName: string, error
45
63
  export declare function runStepStatefully<T>(runId: string, stepName: string, body: () => T, options?: BeginStepOptions): StepExecution<T>;
46
64
  /** Асинхронный вариант `runStepStatefully` для шагов с I/O. */
47
65
  export declare function runStepStatefullyAsync<T>(runId: string, stepName: string, body: () => Promise<T> | T, options?: BeginStepOptions): Promise<StepExecution<T>>;
66
+ export interface RecoverStepsOptions {
67
+ /**
68
+ * B12: текущий момент для проверки lease. По умолчанию now; тесты и
69
+ * отложенный recovery передают «будущее», чтобы lease считался истёкшим.
70
+ */
71
+ now?: string | Date;
72
+ }
48
73
  /**
49
- * Помечает все зависшие `running`-шаги как failed, сохраняя `attempt`.
74
+ * Помечает осиротевшие `running`-шаги как failed, сохраняя `attempt`.
75
+ *
76
+ * B12: шаг финализируется только при отсутствии lease (legacy-строки) или
77
+ * истёкшем `lease_until`. Шаг с живым lease принадлежит работающему процессу
78
+ * и не трогается. Возвращает обновлённые записи.
50
79
  *
51
- * Возвращает обновлённые записи. `attempt` не сбрасывается — следующая попытка
52
- * получит `attempt + 1` через `retryStep`, поэтому номер попытки переживает
53
- * падение процесса и восстановление.
80
+ * `attempt` не сбрасывается — следующая попытка получит `attempt + 1` через
81
+ * `retryStep`, поэтому номер попытки переживает падение процесса и восстановление.
54
82
  */
55
- export declare function recoverInterruptedSteps(runId?: string): RunStepRecord[];
83
+ export declare function recoverInterruptedSteps(runId?: string, options?: RecoverStepsOptions): RunStepRecord[];
56
84
  /** Список шагов в статусе running (для диагностики и восстановления). */
57
85
  export declare function listRunningSteps(runId?: string): RunStepRecord[];
58
86
  /** Запуск по id либо ошибка (удобно для журнала и тестов). */
@@ -1 +1 @@
1
- {"version":3,"file":"run-journal.d.ts","sourceRoot":"","sources":["../../src/db/run-journal.ts"],"names":[],"mappings":"AACA,OAAO,EAQL,KAAK,SAAS,EACd,KAAK,aAAa,EACnB,MAAM,gBAAgB,CAAC;AAExB;;;;;;;GAOG;AAEH,0EAA0E;AAC1E,eAAO,MAAM,sBAAsB,uJAA+B,CAAC;AAEnE,4BAA4B;AAC5B,MAAM,WAAW,gBAAgB;IAC/B,wEAAwE;IACxE,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,2DAA2D;AAC3D,MAAM,WAAW,aAAa,CAAC,CAAC;IAC9B,uCAAuC;IACvC,IAAI,EAAE,aAAa,CAAC;IACpB,2CAA2C;IAC3C,MAAM,EAAE,CAAC,CAAC;IACV,+CAA+C;IAC/C,OAAO,EAAE,MAAM,CAAC;CACjB;AAWD;;;;;;;;GAQG;AACH,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,MAAM,EAChB,OAAO,GAAE,gBAAqB,GAC7B,aAAa,CAcf;AAED,qEAAqE;AACrE,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,MAAM,EAChB,MAAM,CAAC,EAAE,OAAO,GACf,aAAa,CAGf;AAED,2EAA2E;AAC3E,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,OAAO,GACb,aAAa,CAGf;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,CAAC,EACjC,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,MAAM,CAAC,EACb,OAAO,GAAE,gBAAqB,GAC7B,aAAa,CAAC,CAAC,CAAC,CAWlB;AAED,+DAA+D;AAC/D,wBAAsB,sBAAsB,CAAC,CAAC,EAC5C,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,EAC1B,OAAO,GAAE,gBAAqB,GAC7B,OAAO,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,CAW3B;AAED;;;;;;GAMG;AACH,wBAAgB,uBAAuB,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,aAAa,EAAE,CAevE;AAED,yEAAyE;AACzE,wBAAgB,gBAAgB,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,aAAa,EAAE,CAgBhE;AAED,8DAA8D;AAC9D,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,CAInD"}
1
+ {"version":3,"file":"run-journal.d.ts","sourceRoot":"","sources":["../../src/db/run-journal.ts"],"names":[],"mappings":"AAEA,OAAO,EASL,KAAK,SAAS,EACd,KAAK,aAAa,EAEnB,MAAM,gBAAgB,CAAC;AAExB;;;;;;;GAOG;AAEH,0EAA0E;AAC1E,eAAO,MAAM,sBAAsB,uJAA+B,CAAC;AAEnE;;;;GAIG;AACH,eAAO,MAAM,aAAa,QAAS,CAAC;AAIpC,mEAAmE;AACnE,wBAAgB,cAAc,IAAI,MAAM,CAKvC;AAED,4BAA4B;AAC5B,MAAM,WAAW,gBAAgB;IAC/B,wEAAwE;IACxE,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,4EAA4E;IAC5E,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,2DAA2D;AAC3D,MAAM,WAAW,aAAa,CAAC,CAAC;IAC9B,uCAAuC;IACvC,IAAI,EAAE,aAAa,CAAC;IACpB,2CAA2C;IAC3C,MAAM,EAAE,CAAC,CAAC;IACV,+CAA+C;IAC/C,OAAO,EAAE,MAAM,CAAC;CACjB;AAWD;;;;;;;;GAQG;AACH,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,MAAM,EAChB,OAAO,GAAE,gBAAqB,GAC7B,aAAa,CAef;AAED;;;;;;GAMG;AACH,wBAAgB,cAAc,CAC5B,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,MAAM,EAChB,OAAO,GAAE,MAAsB,GAC9B,OAAO,CAIT;AAUD,qEAAqE;AACrE,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,MAAM,EAChB,MAAM,CAAC,EAAE,OAAO,GACf,aAAa,CAGf;AAED,2EAA2E;AAC3E,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,OAAO,GACb,aAAa,CAGf;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,CAAC,EACjC,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,MAAM,CAAC,EACb,OAAO,GAAE,gBAAqB,GAC7B,aAAa,CAAC,CAAC,CAAC,CAWlB;AAED,+DAA+D;AAC/D,wBAAsB,sBAAsB,CAAC,CAAC,EAC5C,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,EAC1B,OAAO,GAAE,gBAAqB,GAC7B,OAAO,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,CA4B3B;AAED,MAAM,WAAW,mBAAmB;IAClC;;;OAGG;IACH,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACrB;AAED;;;;;;;;;GASG;AACH,wBAAgB,uBAAuB,CACrC,KAAK,CAAC,EAAE,MAAM,EACd,OAAO,GAAE,mBAAwB,GAChC,aAAa,EAAE,CAuBjB;AAED,yEAAyE;AACzE,wBAAgB,gBAAgB,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,aAAa,EAAE,CAgBhE;AAED,8DAA8D;AAC9D,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,CAInD"}
@@ -1,5 +1,6 @@
1
+ import os from "node:os";
1
2
  import { getDb, withTransaction } from "./index.js";
2
- import { finishStep, getRun, getStep, retryStep, startRun, startStep, } from "./runs-repo.js";
3
+ import { finishStep, getRun, getStep, renewStepLease as renewStepLeaseRow, retryStep, startRun, startStep, } from "./runs-repo.js";
3
4
  /**
4
5
  * Журнал выполнения шагов (Sprint 36.1.b).
5
6
  *
@@ -10,6 +11,20 @@ import { finishStep, getRun, getStep, retryStep, startRun, startStep, } from "./
10
11
  */
11
12
  /** Текст ошибки, которым помечается шаг, прерванный падением процесса. */
12
13
  export const STEP_INTERRUPTED_ERROR = "Прервано падением процесса";
14
+ /**
15
+ * B12: срок lease шага по умолчанию. Живой процесс продлевает lease
16
+ * (heartbeat в `runStepStatefullyAsync` или явный `renewStepLease`), поэтому
17
+ * recovery финализирует шаг только после истечения этого срока.
18
+ */
19
+ export const STEP_LEASE_MS = 60000;
20
+ let cachedOwnerId = null;
21
+ /** B12: идентификатор текущего процесса — `host:pid:startedAt`. */
22
+ export function getStepOwnerId() {
23
+ if (!cachedOwnerId) {
24
+ cachedOwnerId = `${os.hostname()}:${process.pid}:${nowIso()}`;
25
+ }
26
+ return cachedOwnerId;
27
+ }
13
28
  function nowIso() {
14
29
  return new Date().toISOString();
15
30
  }
@@ -34,14 +49,35 @@ export function beginStepAttempt(runId, stepName, options = {}) {
34
49
  startRun(runId);
35
50
  }
36
51
  const step = requireStep(runId, stepName);
52
+ const lease = buildLease(options.leaseMs);
37
53
  if (step.status === "failed") {
38
- retryStep(step.id);
54
+ retryStep(step.id, undefined, lease);
39
55
  }
40
56
  else {
41
- startStep(step.id);
57
+ startStep(step.id, undefined, lease);
42
58
  }
43
59
  return requireStep(runId, stepName);
44
60
  }
61
+ /**
62
+ * B12: продлевает lease шага текущего процесса.
63
+ *
64
+ * Нужен долгим синхронным шагам: без продления recovery сочтёт шаг
65
+ * осиротевшим после {@link STEP_LEASE_MS}. Возвращает false, если шаг уже
66
+ * не `running`.
67
+ */
68
+ export function renewStepLease(runId, stepName, leaseMs = STEP_LEASE_MS) {
69
+ const step = requireStep(runId, stepName);
70
+ if (step.status !== "running")
71
+ return false;
72
+ return renewStepLeaseRow(step.id, buildLease(leaseMs));
73
+ }
74
+ function buildLease(leaseMs = STEP_LEASE_MS) {
75
+ const duration = Number.isFinite(leaseMs) && leaseMs > 0 ? leaseMs : STEP_LEASE_MS;
76
+ return {
77
+ ownerId: getStepOwnerId(),
78
+ leaseUntil: new Date(Date.now() + duration).toISOString(),
79
+ };
80
+ }
45
81
  /** Закрывает попытку успехом: running → passed, сохраняет output. */
46
82
  export function recordStepSuccess(runId, stepName, output) {
47
83
  completeStep(runId, stepName, "passed", { output });
@@ -72,37 +108,65 @@ export function runStepStatefully(runId, stepName, body, options = {}) {
72
108
  }
73
109
  /** Асинхронный вариант `runStepStatefully` для шагов с I/O. */
74
110
  export async function runStepStatefullyAsync(runId, stepName, body, options = {}) {
111
+ const leaseMs = options.leaseMs ?? STEP_LEASE_MS;
75
112
  const attempt = beginStepAttempt(runId, stepName, options).attempt;
113
+ // B12: heartbeat продлевает lease, пока тело шага реально выполняется.
114
+ const timer = setInterval(() => {
115
+ try {
116
+ renewStepLease(runId, stepName, leaseMs);
117
+ }
118
+ catch {
119
+ // Шаг уже финализирован — продлевать нечего.
120
+ }
121
+ }, Math.max(10, Math.floor(leaseMs / 3)));
122
+ timer.unref?.();
76
123
  let result;
77
124
  try {
78
- result = await body();
125
+ try {
126
+ result = await body();
127
+ }
128
+ catch (err) {
129
+ recordStepFailure(runId, stepName, err);
130
+ throw err;
131
+ }
79
132
  }
80
- catch (err) {
81
- recordStepFailure(runId, stepName, err);
82
- throw err;
133
+ finally {
134
+ clearInterval(timer);
83
135
  }
84
136
  const step = recordStepSuccess(runId, stepName, result);
85
137
  return { step, result, attempt };
86
138
  }
87
139
  /**
88
- * Помечает все зависшие `running`-шаги как failed, сохраняя `attempt`.
140
+ * Помечает осиротевшие `running`-шаги как failed, сохраняя `attempt`.
141
+ *
142
+ * B12: шаг финализируется только при отсутствии lease (legacy-строки) или
143
+ * истёкшем `lease_until`. Шаг с живым lease принадлежит работающему процессу
144
+ * и не трогается. Возвращает обновлённые записи.
89
145
  *
90
- * Возвращает обновлённые записи. `attempt` не сбрасывается — следующая попытка
91
- * получит `attempt + 1` через `retryStep`, поэтому номер попытки переживает
92
- * падение процесса и восстановление.
146
+ * `attempt` не сбрасывается — следующая попытка получит `attempt + 1` через
147
+ * `retryStep`, поэтому номер попытки переживает падение процесса и восстановление.
93
148
  */
94
- export function recoverInterruptedSteps(runId) {
149
+ export function recoverInterruptedSteps(runId, options = {}) {
95
150
  const running = listRunningSteps(runId);
96
151
  if (running.length === 0)
97
152
  return [];
153
+ const nowMs = options.now ? new Date(options.now).getTime() : Date.now();
154
+ const expired = running.filter((step) => {
155
+ if (!step.leaseUntil)
156
+ return true;
157
+ const until = Date.parse(step.leaseUntil);
158
+ return Number.isNaN(until) || until <= nowMs;
159
+ });
160
+ if (expired.length === 0)
161
+ return [];
98
162
  return withTransaction(() => {
99
163
  const timestamp = nowIso();
100
164
  const update = getDb().prepare(`UPDATE run_steps SET status = 'failed', error = ?, finished_at = ?,
101
165
  updated_at = ? WHERE id = ? AND status = 'running'`);
102
- for (const step of running) {
166
+ for (const step of expired) {
103
167
  update.run(STEP_INTERRUPTED_ERROR, timestamp, timestamp, step.id);
104
168
  }
105
- return running.map((step) => requireStep(step.runId, step.stepName));
169
+ return expired.map((step) => requireStep(step.runId, step.stepName));
106
170
  });
107
171
  }
108
172
  /** Список шагов в статусе running (для диагностики и восстановления). */
@@ -1,4 +1,5 @@
1
1
  import { type RunRecord, type RunStepRecord } from "./runs-repo.js";
2
+ import { type StepContext } from "./run-context.js";
2
3
  /**
3
4
  * Resume с середины (Sprint 36.2).
4
5
  *
@@ -7,14 +8,19 @@ import { type RunRecord, type RunStepRecord } from "./runs-repo.js";
7
8
  * `running` как прерванные и выполняет остаток цепочки через журнал 36.1.b.
8
9
  * Уже успешные шаги повторно не запускаются, а `attempt` упавших растёт.
9
10
  */
10
- /** Обработчик тела шага. Получает актуальную запись шага. */
11
- export type StepHandler = (step: RunStepRecord) => unknown;
11
+ /** Обработчик тела шага. Получает актуальную запись шага и контекст паузы. */
12
+ export type StepHandler = (step: RunStepRecord, context: StepContext) => unknown;
12
13
  /** Опции возобновления. */
13
14
  export interface ResumeOptions {
14
15
  /** Тела шагов по имени. Отсутствие обработчика — ошибка до запуска цепочки. */
15
16
  handlers: Record<string, StepHandler>;
16
17
  /** Восстанавливать зависшие `running`-шаги перед продолжением (по умолчанию true). */
17
18
  recover?: boolean;
19
+ /**
20
+ * B12: момент для проверки lease при восстановлении. По умолчанию now.
21
+ * Передавайте будущее время, чтобы считать lease зависшего шага истёкшим.
22
+ */
23
+ recoverNow?: string | Date;
18
24
  /** Останавливаться на первой ошибке (по умолчанию true). */
19
25
  stopOnError?: boolean;
20
26
  }
@@ -30,6 +36,8 @@ export interface ResumeResult {
30
36
  executed: string[];
31
37
  /** Шаги, пропущенные как уже завершённые. */
32
38
  skipped: string[];
39
+ /** Идентификаторы вставок контекста, переданных шагам в этот раз. */
40
+ injected: string[];
33
41
  /** Первый упавший шаг, если цепочка остановилась. */
34
42
  failedStep: string | null;
35
43
  /** Текст ошибки упавшего шага. */
@@ -1 +1 @@
1
- {"version":3,"file":"run-resume.d.ts","sourceRoot":"","sources":["../../src/db/run-resume.ts"],"names":[],"mappings":"AAAA,OAAO,EAML,KAAK,SAAS,EACd,KAAK,aAAa,EACnB,MAAM,gBAAgB,CAAC;AAQxB;;;;;;;GAOG;AAEH,6DAA6D;AAC7D,MAAM,MAAM,WAAW,GAAG,CAAC,IAAI,EAAE,aAAa,KAAK,OAAO,CAAC;AAE3D,2BAA2B;AAC3B,MAAM,WAAW,aAAa;IAC5B,+EAA+E;IAC/E,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;IACtC,sFAAsF;IACtF,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,4DAA4D;IAC5D,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAED,uCAAuC;AACvC,MAAM,WAAW,YAAY;IAC3B,6CAA6C;IAC7C,GAAG,EAAE,SAAS,CAAC;IACf,iEAAiE;IACjE,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,qEAAqE;IACrE,kBAAkB,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC,oCAAoC;IACpC,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,6CAA6C;IAC7C,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,qDAAqD;IACrD,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,kCAAkC;IAClC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;CACtB;AAOD,gFAAgF;AAChF,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,aAAa,GAAG,IAAI,CAGlE;AAgCD;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,aAAa,GAAG,YAAY,CAkCjF;AAED,2DAA2D;AAC3D,wBAAsB,SAAS,CAC7B,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,aAAa,GACrB,OAAO,CAAC,YAAY,CAAC,CAkCvB"}
1
+ {"version":3,"file":"run-resume.d.ts","sourceRoot":"","sources":["../../src/db/run-resume.ts"],"names":[],"mappings":"AAAA,OAAO,EAML,KAAK,SAAS,EACd,KAAK,aAAa,EACnB,MAAM,gBAAgB,CAAC;AAQxB,OAAO,EAIL,KAAK,WAAW,EACjB,MAAM,kBAAkB,CAAC;AAE1B;;;;;;;GAOG;AAEH,8EAA8E;AAC9E,MAAM,MAAM,WAAW,GAAG,CAAC,IAAI,EAAE,aAAa,EAAE,OAAO,EAAE,WAAW,KAAK,OAAO,CAAC;AAEjF,2BAA2B;AAC3B,MAAM,WAAW,aAAa;IAC5B,+EAA+E;IAC/E,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;IACtC,sFAAsF;IACtF,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB;;;OAGG;IACH,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,4DAA4D;IAC5D,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAED,uCAAuC;AACvC,MAAM,WAAW,YAAY;IAC3B,6CAA6C;IAC7C,GAAG,EAAE,SAAS,CAAC;IACf,iEAAiE;IACjE,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,qEAAqE;IACrE,kBAAkB,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC,oCAAoC;IACpC,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,6CAA6C;IAC7C,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,qEAAqE;IACrE,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,qDAAqD;IACrD,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,kCAAkC;IAClC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;CACtB;AAOD,gFAAgF;AAChF,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,aAAa,GAAG,IAAI,CAGlE;AA4CD;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,aAAa,GAAG,YAAY,CA4CjF;AAED,2DAA2D;AAC3D,wBAAsB,SAAS,CAC7B,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,aAAa,GACrB,OAAO,CAAC,YAAY,CAAC,CA4CvB"}
@@ -1,5 +1,6 @@
1
1
  import { finishRun, listRunSteps, reopenRun, startRun, } from "./runs-repo.js";
2
- import { recoverInterruptedSteps, requireRun, runStepStatefully, runStepStatefullyAsync, } from "./run-journal.js";
2
+ import { listRunningSteps, recoverInterruptedSteps, requireRun, runStepStatefully, runStepStatefullyAsync, } from "./run-journal.js";
3
+ import { consumeInjections, consumeOrphanInjections, pendingInjectionsForStep, } from "./run-context.js";
3
4
  /** Завершён ли шаг успешно (повторять не нужно). */
4
5
  function isStepDone(status) {
5
6
  return status === "passed" || status === "skipped";
@@ -15,7 +16,14 @@ function prepareResume(runId, options) {
15
16
  throw new Error(`Запуск отменён, возобновление невозможно: ${runId}`);
16
17
  }
17
18
  if (options.recover !== false)
18
- recoverInterruptedSteps(runId);
19
+ recoverInterruptedSteps(runId, { now: options.recoverNow });
20
+ // B12: шаг с живым lease принадлежит работающему процессу. Возобновлять его
21
+ // здесь нельзя — иначе два исполнителя возьмут один шаг.
22
+ const active = listRunningSteps(runId);
23
+ if (active.length > 0) {
24
+ const step = active[0];
25
+ throw new Error(`Шаг ${step.stepName} выполняется другим процессом (lease до ${step.leaseUntil ?? "неизвестно"}); возобновление отложено.`);
26
+ }
19
27
  const steps = listRunSteps(runId);
20
28
  const startIndex = steps.findIndex((step) => !isStepDone(step.status));
21
29
  if (startIndex >= 0) {
@@ -27,7 +35,9 @@ function prepareResume(runId, options) {
27
35
  }
28
36
  }
29
37
  // Упавший запуск открываем заново: шаги можно перезапускать, attempt не сбрасывается.
30
- if (requireRun(runId).status === "failed")
38
+ // Паузу снимаем тем же переходом paused → running (36.7).
39
+ const current = requireRun(runId);
40
+ if (current.status === "failed" || current.status === "paused")
31
41
  reopenRun(runId);
32
42
  }
33
43
  return { steps, startIndex };
@@ -40,7 +50,7 @@ function prepareResume(runId, options) {
40
50
  export function resumeRunSync(runId, options) {
41
51
  const { steps, startIndex } = prepareResume(runId, options);
42
52
  if (startIndex === -1) {
43
- return finalize(runId, null, null, [], steps.map((step) => step.stepName));
53
+ return finalize(runId, null, null, [], steps.map((step) => step.stepName), []);
44
54
  }
45
55
  const resumedFrom = steps[startIndex].stepName;
46
56
  const executed = [];
@@ -48,6 +58,7 @@ export function resumeRunSync(runId, options) {
48
58
  .slice(0, startIndex)
49
59
  .filter((step) => isStepDone(step.status))
50
60
  .map((step) => step.stepName);
61
+ const injected = [];
51
62
  let resumedFromAttempt = null;
52
63
  for (let index = startIndex; index < steps.length; index += 1) {
53
64
  const step = steps[index];
@@ -56,24 +67,29 @@ export function resumeRunSync(runId, options) {
56
67
  continue;
57
68
  }
58
69
  executed.push(step.stepName);
70
+ const context = pendingInjectionsForStep(runId, step.stepName);
59
71
  try {
60
- const execution = runStepStatefully(runId, step.stepName, () => options.handlers[step.stepName](step));
72
+ const execution = runStepStatefully(runId, step.stepName, () => options.handlers[step.stepName](step, { injections: context }));
61
73
  if (resumedFromAttempt === null)
62
74
  resumedFromAttempt = execution.attempt;
75
+ if (context.length > 0) {
76
+ consumeInjections(context.map((injection) => injection.id), step.stepName, execution.attempt);
77
+ injected.push(...context.map((injection) => injection.id));
78
+ }
63
79
  }
64
80
  catch {
65
81
  if (options.stopOnError === false)
66
82
  continue;
67
- return finalize(runId, resumedFrom, resumedFromAttempt, executed, skipped);
83
+ return finalize(runId, resumedFrom, resumedFromAttempt, executed, skipped, injected);
68
84
  }
69
85
  }
70
- return finalize(runId, resumedFrom, resumedFromAttempt, executed, skipped);
86
+ return finalize(runId, resumedFrom, resumedFromAttempt, executed, skipped, injected);
71
87
  }
72
88
  /** Асинхронный вариант `resumeRunSync` для шагов с I/O. */
73
89
  export async function resumeRun(runId, options) {
74
90
  const { steps, startIndex } = prepareResume(runId, options);
75
91
  if (startIndex === -1) {
76
- return finalize(runId, null, null, [], steps.map((step) => step.stepName));
92
+ return finalize(runId, null, null, [], steps.map((step) => step.stepName), []);
77
93
  }
78
94
  const resumedFrom = steps[startIndex].stepName;
79
95
  const executed = [];
@@ -81,6 +97,7 @@ export async function resumeRun(runId, options) {
81
97
  .slice(0, startIndex)
82
98
  .filter((step) => isStepDone(step.status))
83
99
  .map((step) => step.stepName);
100
+ const injected = [];
84
101
  let resumedFromAttempt = null;
85
102
  for (let index = startIndex; index < steps.length; index += 1) {
86
103
  const step = steps[index];
@@ -89,21 +106,28 @@ export async function resumeRun(runId, options) {
89
106
  continue;
90
107
  }
91
108
  executed.push(step.stepName);
109
+ const context = pendingInjectionsForStep(runId, step.stepName);
92
110
  try {
93
- const execution = await runStepStatefullyAsync(runId, step.stepName, () => options.handlers[step.stepName](step));
111
+ const execution = await runStepStatefullyAsync(runId, step.stepName, () => options.handlers[step.stepName](step, { injections: context }));
94
112
  if (resumedFromAttempt === null)
95
113
  resumedFromAttempt = execution.attempt;
114
+ if (context.length > 0) {
115
+ consumeInjections(context.map((injection) => injection.id), step.stepName, execution.attempt);
116
+ injected.push(...context.map((injection) => injection.id));
117
+ }
96
118
  }
97
119
  catch {
98
120
  if (options.stopOnError === false)
99
121
  continue;
100
- return finalize(runId, resumedFrom, resumedFromAttempt, executed, skipped);
122
+ return finalize(runId, resumedFrom, resumedFromAttempt, executed, skipped, injected);
101
123
  }
102
124
  }
103
- return finalize(runId, resumedFrom, resumedFromAttempt, executed, skipped);
125
+ return finalize(runId, resumedFrom, resumedFromAttempt, executed, skipped, injected);
104
126
  }
105
127
  /** Закрывает прогон по фактическому состоянию шагов и собирает результат. */
106
- function finalize(runId, resumedFrom, resumedFromAttempt, executed, skipped) {
128
+ function finalize(runId, resumedFrom, resumedFromAttempt, executed, skipped, injected) {
129
+ // Вставки, адресованные уже завершённым шагам, не должны висеть в истории.
130
+ consumeOrphanInjections(runId);
107
131
  let steps = listRunSteps(runId);
108
132
  const failed = steps.find((step) => step.status === "failed") ?? null;
109
133
  const unfinished = steps.some((step) => step.status === "pending" || step.status === "running");
@@ -113,7 +137,8 @@ function finalize(runId, resumedFrom, resumedFromAttempt, executed, skipped) {
113
137
  startRun(runId);
114
138
  run = requireRun(runId);
115
139
  }
116
- if (run.status === "running") {
140
+ // Пауза после последнего шага: продолжать нечего, запуск успешен.
141
+ if (run.status === "running" || run.status === "paused") {
117
142
  finishRun(runId, "passed");
118
143
  run = requireRun(runId);
119
144
  }
@@ -131,6 +156,7 @@ function finalize(runId, resumedFrom, resumedFromAttempt, executed, skipped) {
131
156
  resumedFromAttempt,
132
157
  executed,
133
158
  skipped,
159
+ injected,
134
160
  failedStep: failed?.stepName ?? null,
135
161
  error: failed?.error ?? null,
136
162
  };