agent-steward 0.0.2 → 0.0.4

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (263) hide show
  1. package/CHANGELOG.md +45 -2
  2. package/CROSS_PLATFORM.md +11 -9
  3. package/README.md +11 -10
  4. package/ROADMAP-STRATEGY.md +93 -44
  5. package/ROADMAP.md +148 -1017
  6. package/dist/core/cron-to-schtasks.d.ts +0 -8
  7. package/dist/core/cron-to-schtasks.d.ts.map +1 -1
  8. package/dist/core/cron-to-schtasks.js +11 -86
  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 +19 -2
  14. package/dist/core/file-watcher.js +9 -9
  15. package/dist/core/git-trigger.js +4 -4
  16. package/dist/core/lock.d.ts +20 -4
  17. package/dist/core/lock.d.ts.map +1 -1
  18. package/dist/core/lock.js +99 -26
  19. package/dist/core/one-shot.d.ts +31 -5
  20. package/dist/core/one-shot.d.ts.map +1 -1
  21. package/dist/core/one-shot.js +78 -10
  22. package/dist/core/opencode-cli.d.ts +28 -0
  23. package/dist/core/opencode-cli.d.ts.map +1 -0
  24. package/dist/core/opencode-cli.js +74 -0
  25. package/dist/core/opencode-models.d.ts +62 -0
  26. package/dist/core/opencode-models.d.ts.map +1 -0
  27. package/dist/core/opencode-models.js +277 -0
  28. package/dist/core/otel.js +2 -2
  29. package/dist/core/ps-wrapper.d.ts +1 -1
  30. package/dist/core/ps-wrapper.d.ts.map +1 -1
  31. package/dist/core/ps-wrapper.js +66 -36
  32. package/dist/core/record-history.d.ts +15 -0
  33. package/dist/core/record-history.d.ts.map +1 -1
  34. package/dist/core/record-history.js +78 -54
  35. package/dist/core/router/dispatch.d.ts +36 -0
  36. package/dist/core/router/dispatch.d.ts.map +1 -0
  37. package/dist/core/router/dispatch.js +59 -0
  38. package/dist/core/router/escalation.d.ts +47 -0
  39. package/dist/core/router/escalation.d.ts.map +1 -0
  40. package/dist/core/router/escalation.js +87 -0
  41. package/dist/core/router/planner.d.ts +53 -0
  42. package/dist/core/router/planner.d.ts.map +1 -0
  43. package/dist/core/router/planner.js +113 -0
  44. package/dist/core/router/rules.d.ts +46 -0
  45. package/dist/core/router/rules.d.ts.map +1 -0
  46. package/dist/core/router/rules.js +85 -0
  47. package/dist/core/run-panel-api.d.ts +94 -0
  48. package/dist/core/run-panel-api.d.ts.map +1 -0
  49. package/dist/core/run-panel-api.js +169 -0
  50. package/dist/core/schedule-gate.js +5 -1
  51. package/dist/core/schedule-v2.d.ts +36 -2
  52. package/dist/core/schedule-v2.d.ts.map +1 -1
  53. package/dist/core/schedule-v2.js +98 -12
  54. package/dist/core/scheduler/at-fallback.d.ts +95 -0
  55. package/dist/core/scheduler/at-fallback.d.ts.map +1 -0
  56. package/dist/core/scheduler/at-fallback.js +200 -0
  57. package/dist/core/scheduler/linux.d.ts +13 -2
  58. package/dist/core/scheduler/linux.d.ts.map +1 -1
  59. package/dist/core/scheduler/linux.js +67 -13
  60. package/dist/core/scheduler/mac.d.ts +14 -8
  61. package/dist/core/scheduler/mac.d.ts.map +1 -1
  62. package/dist/core/scheduler/mac.js +71 -22
  63. package/dist/core/scheduler/posix.d.ts.map +1 -1
  64. package/dist/core/scheduler/posix.js +37 -2
  65. package/dist/core/scheduler/registry.d.ts +13 -0
  66. package/dist/core/scheduler/registry.d.ts.map +1 -1
  67. package/dist/core/scheduler/registry.js +83 -21
  68. package/dist/core/scheduler/run-now.d.ts +16 -0
  69. package/dist/core/scheduler/run-now.d.ts.map +1 -0
  70. package/dist/core/scheduler/run-now.js +28 -0
  71. package/dist/core/scheduler/windows.d.ts +16 -3
  72. package/dist/core/scheduler/windows.d.ts.map +1 -1
  73. package/dist/core/scheduler/windows.js +249 -96
  74. package/dist/core/secrets.d.ts.map +1 -1
  75. package/dist/core/secrets.js +127 -30
  76. package/dist/core/self-analysis.js +55 -55
  77. package/dist/core/session.d.ts.map +1 -1
  78. package/dist/core/session.js +18 -11
  79. package/dist/core/summary.js +1 -1
  80. package/dist/core/task-name.d.ts +24 -0
  81. package/dist/core/task-name.d.ts.map +1 -0
  82. package/dist/core/task-name.js +40 -0
  83. package/dist/core/triage-chain.js +1 -1
  84. package/dist/core/triage-worker.js +2 -2
  85. package/dist/core/triage.js +1 -1
  86. package/dist/core/wrappers/bash.d.ts.map +1 -1
  87. package/dist/core/wrappers/bash.js +82 -37
  88. package/dist/db/capability-repo.d.ts +83 -0
  89. package/dist/db/capability-repo.d.ts.map +1 -0
  90. package/dist/db/capability-repo.js +182 -0
  91. package/dist/db/history-repo.d.ts +8 -0
  92. package/dist/db/history-repo.d.ts.map +1 -1
  93. package/dist/db/history-repo.js +19 -0
  94. package/dist/db/index.d.ts +6 -0
  95. package/dist/db/index.d.ts.map +1 -1
  96. package/dist/db/index.js +48 -2
  97. package/dist/db/migrate.d.ts.map +1 -1
  98. package/dist/db/migrate.js +3 -1
  99. package/dist/db/run-context.d.ts +103 -0
  100. package/dist/db/run-context.d.ts.map +1 -0
  101. package/dist/db/run-context.js +224 -0
  102. package/dist/db/run-dlq.d.ts +100 -0
  103. package/dist/db/run-dlq.d.ts.map +1 -0
  104. package/dist/db/run-dlq.js +191 -0
  105. package/dist/db/run-journal.d.ts +60 -0
  106. package/dist/db/run-journal.d.ts.map +1 -0
  107. package/dist/db/run-journal.js +143 -0
  108. package/dist/db/run-resume.d.ts +51 -0
  109. package/dist/db/run-resume.d.ts.map +1 -0
  110. package/dist/db/run-resume.js +156 -0
  111. package/dist/db/runs-repo.d.ts +128 -0
  112. package/dist/db/runs-repo.d.ts.map +1 -0
  113. package/dist/db/runs-repo.js +342 -0
  114. package/dist/db/schema.d.ts +16 -2
  115. package/dist/db/schema.d.ts.map +1 -1
  116. package/dist/db/schema.js +342 -35
  117. package/dist/db/settings-repo.d.ts +11 -0
  118. package/dist/db/settings-repo.d.ts.map +1 -1
  119. package/dist/db/settings-repo.js +25 -0
  120. package/dist/db/step-idempotency.d.ts +51 -0
  121. package/dist/db/step-idempotency.d.ts.map +1 -0
  122. package/dist/db/step-idempotency.js +136 -0
  123. package/dist/index.d.ts +5 -5
  124. package/dist/index.d.ts.map +1 -1
  125. package/dist/index.js +168 -40
  126. package/dist/notifications.js +18 -18
  127. package/dist/profiles.d.ts +7 -3
  128. package/dist/profiles.d.ts.map +1 -1
  129. package/dist/profiles.js +85 -7
  130. package/dist/rpc.d.ts +787 -0
  131. package/dist/rpc.d.ts.map +1 -1
  132. package/dist/rpc.js +324 -0
  133. package/dist/server.d.ts +33 -2
  134. package/dist/server.d.ts.map +1 -1
  135. package/dist/server.js +115 -54
  136. package/dist/shared/jobs-view.d.ts.map +1 -1
  137. package/dist/skill.js +1 -1
  138. package/dist/task-transfer.d.ts +1 -1
  139. package/dist/task-transfer.d.ts.map +1 -1
  140. package/dist/task-transfer.js +14 -10
  141. package/dist/types.d.ts +20 -4
  142. package/dist/types.d.ts.map +1 -1
  143. package/dist/types.js +44 -9
  144. package/dist/workspaces.d.ts +25 -3
  145. package/dist/workspaces.d.ts.map +1 -1
  146. package/dist/workspaces.js +44 -9
  147. package/docs/ARCHITECTURE.md +335 -9
  148. package/docs/COMPATIBILITY.md +10 -6
  149. package/docs/CONCEPT.md +183 -91
  150. package/docs/CROSS_PLATFORM.ru.md +11 -9
  151. package/docs/CROSS_PLATFORM.zh.md +11 -9
  152. package/docs/EXECUTION-LOOP.md +196 -0
  153. package/docs/FAQ.md +2 -2
  154. package/docs/FAQ.ru.md +2 -2
  155. package/docs/FAQ.zh.md +2 -2
  156. package/docs/FEATURES.md +5 -4
  157. package/docs/FEATURES.zh.md +5 -4
  158. package/docs/MIGRATION.md +34 -26
  159. package/docs/README.ru.md +27 -8
  160. package/docs/README.zh.md +11 -10
  161. package/docs/SAFETY.md +122 -0
  162. package/docs/SAVINGS.md +29 -0
  163. package/docs/SAVINGS.ru.md +29 -0
  164. package/docs/SAVINGS.zh.md +18 -0
  165. package/docs/V1-V2-COMPATIBILITY-PLAN.md +6 -6
  166. package/gui-experimental.cjs +8 -8
  167. package/index.js +1 -0
  168. package/locales/en.json +68 -0
  169. package/locales/ru.json +68 -0
  170. package/locales/zh.json +68 -0
  171. package/package.json +57 -11
  172. package/scripts/audit-bundle.mjs +215 -0
  173. package/src/core/analytics.ts +2 -2
  174. package/src/core/audit.ts +17 -17
  175. package/src/core/cron-to-schtasks.ts +14 -93
  176. package/src/core/dlq-api.ts +98 -0
  177. package/src/core/dry-run.ts +51 -27
  178. package/src/core/file-watcher.ts +17 -17
  179. package/src/core/git-trigger.ts +9 -9
  180. package/src/core/glob.ts +1 -1
  181. package/src/core/local-ai.ts +2 -2
  182. package/src/core/lock.ts +104 -31
  183. package/src/core/matrix.ts +31 -31
  184. package/src/core/native-notify.ts +2 -2
  185. package/src/core/one-shot.ts +91 -13
  186. package/src/core/opencode-cli.ts +103 -0
  187. package/src/core/opencode-models.ts +315 -0
  188. package/src/core/otel.ts +4 -4
  189. package/src/core/permissions.ts +5 -5
  190. package/src/core/prometheus.ts +17 -17
  191. package/src/core/ps-wrapper.ts +68 -38
  192. package/src/core/record-history.ts +114 -76
  193. package/src/core/retention.ts +3 -3
  194. package/src/core/router/dispatch.ts +94 -0
  195. package/src/core/router/escalation.ts +129 -0
  196. package/src/core/router/planner.ts +166 -0
  197. package/src/core/router/rules.ts +109 -0
  198. package/src/core/run-panel-api.ts +262 -0
  199. package/src/core/savings.ts +1 -1
  200. package/src/core/schedule-gate.ts +17 -13
  201. package/src/core/schedule-v2.ts +138 -29
  202. package/src/core/scheduler/at-fallback.ts +298 -0
  203. package/src/core/scheduler/index.ts +3 -3
  204. package/src/core/scheduler/linux.ts +92 -19
  205. package/src/core/scheduler/logs.ts +1 -1
  206. package/src/core/scheduler/mac.ts +112 -60
  207. package/src/core/scheduler/posix.ts +35 -2
  208. package/src/core/scheduler/registry.ts +109 -26
  209. package/src/core/scheduler/run-now.ts +32 -0
  210. package/src/core/scheduler/windows.ts +295 -125
  211. package/src/core/secrets.ts +139 -39
  212. package/src/core/self-analysis.ts +61 -61
  213. package/src/core/session.ts +26 -13
  214. package/src/core/structured-log.ts +3 -3
  215. package/src/core/summary.ts +25 -25
  216. package/src/core/task-name.ts +67 -0
  217. package/src/core/telegram.ts +16 -16
  218. package/src/core/triage-chain.ts +4 -4
  219. package/src/core/triage-compare.ts +8 -8
  220. package/src/core/triage-rules.ts +4 -4
  221. package/src/core/triage-shadow.ts +7 -7
  222. package/src/core/triage-worker.ts +6 -6
  223. package/src/core/triage.ts +23 -23
  224. package/src/core/watch-paths.ts +1 -1
  225. package/src/core/wrappers/bash.ts +90 -45
  226. package/src/db/capability-repo.ts +285 -0
  227. package/src/db/git-state-repo.ts +1 -1
  228. package/src/db/history-repo.ts +44 -22
  229. package/src/db/index.ts +53 -7
  230. package/src/db/metrics-repo.ts +10 -10
  231. package/src/db/migrate.ts +13 -11
  232. package/src/db/recovery.ts +3 -3
  233. package/src/db/run-context.ts +370 -0
  234. package/src/db/run-dlq.ts +310 -0
  235. package/src/db/run-journal.ts +212 -0
  236. package/src/db/run-resume.ts +256 -0
  237. package/src/db/runs-repo.ts +504 -0
  238. package/src/db/schema.ts +357 -44
  239. package/src/db/settings-repo.ts +33 -2
  240. package/src/db/step-idempotency.ts +185 -0
  241. package/src/db/tasks-repo.ts +10 -10
  242. package/src/db/templates-repo.ts +7 -7
  243. package/src/gui.tsx +516 -1
  244. package/src/history.ts +4 -4
  245. package/src/i18n.ts +7 -7
  246. package/src/index.ts +465 -308
  247. package/src/integrations.ts +6 -6
  248. package/src/notifications.ts +76 -76
  249. package/src/profiles.ts +98 -7
  250. package/src/rpc.ts +347 -1
  251. package/src/schtasks.ts +2 -2
  252. package/src/server.ts +155 -78
  253. package/src/settings.ts +44 -44
  254. package/src/shared/jobs-view.ts +60 -60
  255. package/src/skill.ts +1 -1
  256. package/src/task-transfer.ts +58 -56
  257. package/src/templates.ts +1 -1
  258. package/src/types.ts +54 -10
  259. package/src/workspaces.ts +73 -24
  260. package/dist/core/self-analysis.test.d.ts +0 -2
  261. package/dist/core/self-analysis.test.d.ts.map +0 -1
  262. package/dist/core/self-analysis.test.js +0 -219
  263. package/dist/gui-experimental.cjs +0 -1
@@ -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
+ }
@@ -0,0 +1,60 @@
1
+ import { type RunRecord, type RunStepRecord } from "./runs-repo.js";
2
+ /**
3
+ * Журнал выполнения шагов (Sprint 36.1.b).
4
+ *
5
+ * Каждый переход шага пишется отдельной транзакцией и фиксируется в WAL
6
+ * **до** запуска тела шага и **после** него. Если процесс убьют посреди шага,
7
+ * в БД останется строка `running` с номером попытки `attempt`: её помечает
8
+ * `recoverInterruptedSteps()`, а повтор идёт через `retryStep()` с `attempt + 1`.
9
+ */
10
+ /** Текст ошибки, которым помечается шаг, прерванный падением процесса. */
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
+ export interface BeginStepOptions {
14
+ /** Начать запуск, если он ещё в статусе pending (по умолчанию true). */
15
+ startRun?: boolean;
16
+ }
17
+ /** Результат выполнения шага через `runStepStatefully`. */
18
+ export interface StepExecution<T> {
19
+ /** Состояние шага после завершения. */
20
+ step: RunStepRecord;
21
+ /** Значение, которое вернуло тело шага. */
22
+ result: T;
23
+ /** Номер попытки, с которым выполнялся шаг. */
24
+ attempt: number;
25
+ }
26
+ /**
27
+ * Открывает попытку шага: run pending → running (если нужно), шаг pending → running.
28
+ *
29
+ * Запись коммитится до возврата управления, поэтому вызывающий код может
30
+ * безопасно запускать побочные эффекты: факт старта уже на диске.
31
+ *
32
+ * Если шаг остался `failed` после падения — выполняется `retryStep`, и номер
33
+ * попытки увеличивается, а не начинается заново.
34
+ */
35
+ export declare function beginStepAttempt(runId: string, stepName: string, options?: BeginStepOptions): RunStepRecord;
36
+ /** Закрывает попытку успехом: running → passed, сохраняет output. */
37
+ export declare function recordStepSuccess(runId: string, stepName: string, output?: unknown): RunStepRecord;
38
+ /** Закрывает попытку ошибкой: running → failed, сохраняет текст ошибки. */
39
+ export declare function recordStepFailure(runId: string, stepName: string, error: unknown): RunStepRecord;
40
+ /**
41
+ * Выполняет шаг с журналированием: состояние `running` фиксируется до вызова
42
+ * `body`, результат (`passed`/`failed`) — после. Ошибка тела не теряется:
43
+ * шаг помечается failed, исключение пробрасывается дальше.
44
+ */
45
+ export declare function runStepStatefully<T>(runId: string, stepName: string, body: () => T, options?: BeginStepOptions): StepExecution<T>;
46
+ /** Асинхронный вариант `runStepStatefully` для шагов с I/O. */
47
+ export declare function runStepStatefullyAsync<T>(runId: string, stepName: string, body: () => Promise<T> | T, options?: BeginStepOptions): Promise<StepExecution<T>>;
48
+ /**
49
+ * Помечает все зависшие `running`-шаги как failed, сохраняя `attempt`.
50
+ *
51
+ * Возвращает обновлённые записи. `attempt` не сбрасывается — следующая попытка
52
+ * получит `attempt + 1` через `retryStep`, поэтому номер попытки переживает
53
+ * падение процесса и восстановление.
54
+ */
55
+ export declare function recoverInterruptedSteps(runId?: string): RunStepRecord[];
56
+ /** Список шагов в статусе running (для диагностики и восстановления). */
57
+ export declare function listRunningSteps(runId?: string): RunStepRecord[];
58
+ /** Запуск по id либо ошибка (удобно для журнала и тестов). */
59
+ export declare function requireRun(runId: string): RunRecord;
60
+ //# sourceMappingURL=run-journal.d.ts.map
@@ -0,0 +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"}
@@ -0,0 +1,143 @@
1
+ import { getDb, withTransaction } from "./index.js";
2
+ import { finishStep, getRun, getStep, retryStep, startRun, startStep, } from "./runs-repo.js";
3
+ /**
4
+ * Журнал выполнения шагов (Sprint 36.1.b).
5
+ *
6
+ * Каждый переход шага пишется отдельной транзакцией и фиксируется в WAL
7
+ * **до** запуска тела шага и **после** него. Если процесс убьют посреди шага,
8
+ * в БД останется строка `running` с номером попытки `attempt`: её помечает
9
+ * `recoverInterruptedSteps()`, а повтор идёт через `retryStep()` с `attempt + 1`.
10
+ */
11
+ /** Текст ошибки, которым помечается шаг, прерванный падением процесса. */
12
+ export const STEP_INTERRUPTED_ERROR = "Прервано падением процесса";
13
+ function nowIso() {
14
+ return new Date().toISOString();
15
+ }
16
+ function errorMessage(err) {
17
+ if (err instanceof Error)
18
+ return err.message;
19
+ return String(err);
20
+ }
21
+ /**
22
+ * Открывает попытку шага: run pending → running (если нужно), шаг pending → running.
23
+ *
24
+ * Запись коммитится до возврата управления, поэтому вызывающий код может
25
+ * безопасно запускать побочные эффекты: факт старта уже на диске.
26
+ *
27
+ * Если шаг остался `failed` после падения — выполняется `retryStep`, и номер
28
+ * попытки увеличивается, а не начинается заново.
29
+ */
30
+ export function beginStepAttempt(runId, stepName, options = {}) {
31
+ if (options.startRun !== false) {
32
+ const run = requireRun(runId);
33
+ if (run.status === "pending")
34
+ startRun(runId);
35
+ }
36
+ const step = requireStep(runId, stepName);
37
+ if (step.status === "failed") {
38
+ retryStep(step.id);
39
+ }
40
+ else {
41
+ startStep(step.id);
42
+ }
43
+ return requireStep(runId, stepName);
44
+ }
45
+ /** Закрывает попытку успехом: running → passed, сохраняет output. */
46
+ export function recordStepSuccess(runId, stepName, output) {
47
+ completeStep(runId, stepName, "passed", { output });
48
+ return requireStep(runId, stepName);
49
+ }
50
+ /** Закрывает попытку ошибкой: running → failed, сохраняет текст ошибки. */
51
+ export function recordStepFailure(runId, stepName, error) {
52
+ completeStep(runId, stepName, "failed", { error: errorMessage(error) });
53
+ return requireStep(runId, stepName);
54
+ }
55
+ /**
56
+ * Выполняет шаг с журналированием: состояние `running` фиксируется до вызова
57
+ * `body`, результат (`passed`/`failed`) — после. Ошибка тела не теряется:
58
+ * шаг помечается failed, исключение пробрасывается дальше.
59
+ */
60
+ export function runStepStatefully(runId, stepName, body, options = {}) {
61
+ const attempt = beginStepAttempt(runId, stepName, options).attempt;
62
+ let result;
63
+ try {
64
+ result = body();
65
+ }
66
+ catch (err) {
67
+ recordStepFailure(runId, stepName, err);
68
+ throw err;
69
+ }
70
+ const step = recordStepSuccess(runId, stepName, result);
71
+ return { step, result, attempt };
72
+ }
73
+ /** Асинхронный вариант `runStepStatefully` для шагов с I/O. */
74
+ export async function runStepStatefullyAsync(runId, stepName, body, options = {}) {
75
+ const attempt = beginStepAttempt(runId, stepName, options).attempt;
76
+ let result;
77
+ try {
78
+ result = await body();
79
+ }
80
+ catch (err) {
81
+ recordStepFailure(runId, stepName, err);
82
+ throw err;
83
+ }
84
+ const step = recordStepSuccess(runId, stepName, result);
85
+ return { step, result, attempt };
86
+ }
87
+ /**
88
+ * Помечает все зависшие `running`-шаги как failed, сохраняя `attempt`.
89
+ *
90
+ * Возвращает обновлённые записи. `attempt` не сбрасывается — следующая попытка
91
+ * получит `attempt + 1` через `retryStep`, поэтому номер попытки переживает
92
+ * падение процесса и восстановление.
93
+ */
94
+ export function recoverInterruptedSteps(runId) {
95
+ const running = listRunningSteps(runId);
96
+ if (running.length === 0)
97
+ return [];
98
+ return withTransaction(() => {
99
+ const timestamp = nowIso();
100
+ const update = getDb().prepare(`UPDATE run_steps SET status = 'failed', error = ?, finished_at = ?,
101
+ updated_at = ? WHERE id = ? AND status = 'running'`);
102
+ for (const step of running) {
103
+ update.run(STEP_INTERRUPTED_ERROR, timestamp, timestamp, step.id);
104
+ }
105
+ return running.map((step) => requireStep(step.runId, step.stepName));
106
+ });
107
+ }
108
+ /** Список шагов в статусе running (для диагностики и восстановления). */
109
+ export function listRunningSteps(runId) {
110
+ const sql = runId
111
+ ? "SELECT run_id, step_name FROM run_steps WHERE status = 'running' AND run_id = ? ORDER BY created_at"
112
+ : "SELECT run_id, step_name FROM run_steps WHERE status = 'running' ORDER BY created_at";
113
+ const statement = getDb().prepare(sql);
114
+ const rows = (runId ? statement.all(runId) : statement.all());
115
+ const steps = [];
116
+ for (const row of rows) {
117
+ const step = getStep(String(row.run_id), String(row.step_name));
118
+ if (step && step.status === "running")
119
+ steps.push(step);
120
+ }
121
+ return steps;
122
+ }
123
+ /** Запуск по id либо ошибка (удобно для журнала и тестов). */
124
+ export function requireRun(runId) {
125
+ const run = getRun(runId);
126
+ if (!run)
127
+ throw new Error(`Запуск не найден: ${runId}`);
128
+ return run;
129
+ }
130
+ function requireStep(runId, stepName) {
131
+ const step = getStep(runId, stepName);
132
+ if (!step)
133
+ throw new Error(`Шаг не найден: ${runId}/${stepName}`);
134
+ return step;
135
+ }
136
+ function completeStep(runId, stepName, status, options) {
137
+ const step = requireStep(runId, stepName);
138
+ if (step.status !== "running") {
139
+ // Повторная запись результата — ошибка вызывающего кода, а не «тихий» пропуск.
140
+ throw new Error(`Шаг ${runId}/${stepName} не выполняется (статус ${step.status}), запись ${status} невозможна.`);
141
+ }
142
+ finishStep(step.id, status, options);
143
+ }
@@ -0,0 +1,51 @@
1
+ import { type RunRecord, type RunStepRecord } from "./runs-repo.js";
2
+ import { type StepContext } from "./run-context.js";
3
+ /**
4
+ * Resume с середины (Sprint 36.2).
5
+ *
6
+ * Линейная цепочка шагов хранится в `run_steps` в порядке создания. Возобновление
7
+ * находит первый незавершённый шаг (не `passed`/`skipped`), помечает зависшие
8
+ * `running` как прерванные и выполняет остаток цепочки через журнал 36.1.b.
9
+ * Уже успешные шаги повторно не запускаются, а `attempt` упавших растёт.
10
+ */
11
+ /** Обработчик тела шага. Получает актуальную запись шага и контекст паузы. */
12
+ export type StepHandler = (step: RunStepRecord, context: StepContext) => unknown;
13
+ /** Опции возобновления. */
14
+ export interface ResumeOptions {
15
+ /** Тела шагов по имени. Отсутствие обработчика — ошибка до запуска цепочки. */
16
+ handlers: Record<string, StepHandler>;
17
+ /** Восстанавливать зависшие `running`-шаги перед продолжением (по умолчанию true). */
18
+ recover?: boolean;
19
+ /** Останавливаться на первой ошибке (по умолчанию true). */
20
+ stopOnError?: boolean;
21
+ }
22
+ /** Результат возобновления прогона. */
23
+ export interface ResumeResult {
24
+ /** Состояние запуска после возобновления. */
25
+ run: RunRecord;
26
+ /** С какого шага продолжили (`null`, если продолжать нечего). */
27
+ resumedFrom: string | null;
28
+ /** Номер попытки, с которым выполнялся первый возобновлённый шаг. */
29
+ resumedFromAttempt: number | null;
30
+ /** Шаги, выполненные в этот раз. */
31
+ executed: string[];
32
+ /** Шаги, пропущенные как уже завершённые. */
33
+ skipped: string[];
34
+ /** Идентификаторы вставок контекста, переданных шагам в этот раз. */
35
+ injected: string[];
36
+ /** Первый упавший шаг, если цепочка остановилась. */
37
+ failedStep: string | null;
38
+ /** Текст ошибки упавшего шага. */
39
+ error: string | null;
40
+ }
41
+ /** Первый незавершённый шаг цепочки либо null. Без восстановления состояния. */
42
+ export declare function findResumeStep(runId: string): RunStepRecord | null;
43
+ /**
44
+ * Возобновляет линейную цепочку шагов синхронно.
45
+ *
46
+ * Все проверки (наличие обработчиков) выполняются до первого побочного эффекта.
47
+ */
48
+ export declare function resumeRunSync(runId: string, options: ResumeOptions): ResumeResult;
49
+ /** Асинхронный вариант `resumeRunSync` для шагов с I/O. */
50
+ export declare function resumeRun(runId: string, options: ResumeOptions): Promise<ResumeResult>;
51
+ //# sourceMappingURL=run-resume.d.ts.map
@@ -0,0 +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;AAOxB,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,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;AAkCD;;;;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"}
@@ -0,0 +1,156 @@
1
+ import { finishRun, listRunSteps, reopenRun, startRun, } from "./runs-repo.js";
2
+ import { recoverInterruptedSteps, requireRun, runStepStatefully, runStepStatefullyAsync, } from "./run-journal.js";
3
+ import { consumeInjections, consumeOrphanInjections, pendingInjectionsForStep, } from "./run-context.js";
4
+ /** Завершён ли шаг успешно (повторять не нужно). */
5
+ function isStepDone(status) {
6
+ return status === "passed" || status === "skipped";
7
+ }
8
+ /** Первый незавершённый шаг цепочки либо null. Без восстановления состояния. */
9
+ export function findResumeStep(runId) {
10
+ const steps = listRunSteps(runId);
11
+ return steps.find((step) => !isStepDone(step.status)) ?? null;
12
+ }
13
+ function prepareResume(runId, options) {
14
+ const run = requireRun(runId);
15
+ if (run.status === "cancelled") {
16
+ throw new Error(`Запуск отменён, возобновление невозможно: ${runId}`);
17
+ }
18
+ if (options.recover !== false)
19
+ recoverInterruptedSteps(runId);
20
+ const steps = listRunSteps(runId);
21
+ const startIndex = steps.findIndex((step) => !isStepDone(step.status));
22
+ if (startIndex >= 0) {
23
+ for (const step of steps.slice(startIndex)) {
24
+ if (isStepDone(step.status))
25
+ continue;
26
+ if (typeof options.handlers[step.stepName] !== "function") {
27
+ throw new Error(`Нет обработчика шага: ${step.stepName}`);
28
+ }
29
+ }
30
+ // Упавший запуск открываем заново: шаги можно перезапускать, attempt не сбрасывается.
31
+ // Паузу снимаем тем же переходом paused → running (36.7).
32
+ const current = requireRun(runId);
33
+ if (current.status === "failed" || current.status === "paused")
34
+ reopenRun(runId);
35
+ }
36
+ return { steps, startIndex };
37
+ }
38
+ /**
39
+ * Возобновляет линейную цепочку шагов синхронно.
40
+ *
41
+ * Все проверки (наличие обработчиков) выполняются до первого побочного эффекта.
42
+ */
43
+ export function resumeRunSync(runId, options) {
44
+ const { steps, startIndex } = prepareResume(runId, options);
45
+ if (startIndex === -1) {
46
+ return finalize(runId, null, null, [], steps.map((step) => step.stepName), []);
47
+ }
48
+ const resumedFrom = steps[startIndex].stepName;
49
+ const executed = [];
50
+ const skipped = steps
51
+ .slice(0, startIndex)
52
+ .filter((step) => isStepDone(step.status))
53
+ .map((step) => step.stepName);
54
+ const injected = [];
55
+ let resumedFromAttempt = null;
56
+ for (let index = startIndex; index < steps.length; index += 1) {
57
+ const step = steps[index];
58
+ if (isStepDone(step.status)) {
59
+ skipped.push(step.stepName);
60
+ continue;
61
+ }
62
+ executed.push(step.stepName);
63
+ const context = pendingInjectionsForStep(runId, step.stepName);
64
+ try {
65
+ const execution = runStepStatefully(runId, step.stepName, () => options.handlers[step.stepName](step, { injections: context }));
66
+ if (resumedFromAttempt === null)
67
+ resumedFromAttempt = execution.attempt;
68
+ if (context.length > 0) {
69
+ consumeInjections(context.map((injection) => injection.id), step.stepName, execution.attempt);
70
+ injected.push(...context.map((injection) => injection.id));
71
+ }
72
+ }
73
+ catch {
74
+ if (options.stopOnError === false)
75
+ continue;
76
+ return finalize(runId, resumedFrom, resumedFromAttempt, executed, skipped, injected);
77
+ }
78
+ }
79
+ return finalize(runId, resumedFrom, resumedFromAttempt, executed, skipped, injected);
80
+ }
81
+ /** Асинхронный вариант `resumeRunSync` для шагов с I/O. */
82
+ export async function resumeRun(runId, options) {
83
+ const { steps, startIndex } = prepareResume(runId, options);
84
+ if (startIndex === -1) {
85
+ return finalize(runId, null, null, [], steps.map((step) => step.stepName), []);
86
+ }
87
+ const resumedFrom = steps[startIndex].stepName;
88
+ const executed = [];
89
+ const skipped = steps
90
+ .slice(0, startIndex)
91
+ .filter((step) => isStepDone(step.status))
92
+ .map((step) => step.stepName);
93
+ const injected = [];
94
+ let resumedFromAttempt = null;
95
+ for (let index = startIndex; index < steps.length; index += 1) {
96
+ const step = steps[index];
97
+ if (isStepDone(step.status)) {
98
+ skipped.push(step.stepName);
99
+ continue;
100
+ }
101
+ executed.push(step.stepName);
102
+ const context = pendingInjectionsForStep(runId, step.stepName);
103
+ try {
104
+ const execution = await runStepStatefullyAsync(runId, step.stepName, () => options.handlers[step.stepName](step, { injections: context }));
105
+ if (resumedFromAttempt === null)
106
+ resumedFromAttempt = execution.attempt;
107
+ if (context.length > 0) {
108
+ consumeInjections(context.map((injection) => injection.id), step.stepName, execution.attempt);
109
+ injected.push(...context.map((injection) => injection.id));
110
+ }
111
+ }
112
+ catch {
113
+ if (options.stopOnError === false)
114
+ continue;
115
+ return finalize(runId, resumedFrom, resumedFromAttempt, executed, skipped, injected);
116
+ }
117
+ }
118
+ return finalize(runId, resumedFrom, resumedFromAttempt, executed, skipped, injected);
119
+ }
120
+ /** Закрывает прогон по фактическому состоянию шагов и собирает результат. */
121
+ function finalize(runId, resumedFrom, resumedFromAttempt, executed, skipped, injected) {
122
+ // Вставки, адресованные уже завершённым шагам, не должны висеть в истории.
123
+ consumeOrphanInjections(runId);
124
+ let steps = listRunSteps(runId);
125
+ const failed = steps.find((step) => step.status === "failed") ?? null;
126
+ const unfinished = steps.some((step) => step.status === "pending" || step.status === "running");
127
+ let run = requireRun(runId);
128
+ if (!failed && !unfinished) {
129
+ if (run.status === "pending") {
130
+ startRun(runId);
131
+ run = requireRun(runId);
132
+ }
133
+ // Пауза после последнего шага: продолжать нечего, запуск успешен.
134
+ if (run.status === "running" || run.status === "paused") {
135
+ finishRun(runId, "passed");
136
+ run = requireRun(runId);
137
+ }
138
+ }
139
+ else if (failed && run.status === "running") {
140
+ finishRun(runId, "failed", {
141
+ error: failed.error ?? `Шаг ${failed.stepName} завершился ошибкой`,
142
+ });
143
+ run = requireRun(runId);
144
+ }
145
+ steps = listRunSteps(runId);
146
+ return {
147
+ run,
148
+ resumedFrom,
149
+ resumedFromAttempt,
150
+ executed,
151
+ skipped,
152
+ injected,
153
+ failedStep: failed?.stepName ?? null,
154
+ error: failed?.error ?? null,
155
+ };
156
+ }