agent-steward 0.0.2 → 0.0.3

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 (180) hide show
  1. package/CHANGELOG.md +25 -2
  2. package/CROSS_PLATFORM.md +11 -9
  3. package/README.md +9 -8
  4. package/ROADMAP-STRATEGY.md +93 -44
  5. package/ROADMAP.md +114 -999
  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/dry-run.js +1 -1
  10. package/dist/core/file-watcher.js +9 -9
  11. package/dist/core/git-trigger.js +4 -4
  12. package/dist/core/lock.js +2 -4
  13. package/dist/core/one-shot.d.ts +27 -5
  14. package/dist/core/one-shot.d.ts.map +1 -1
  15. package/dist/core/one-shot.js +53 -10
  16. package/dist/core/otel.js +2 -2
  17. package/dist/core/ps-wrapper.d.ts +1 -1
  18. package/dist/core/ps-wrapper.d.ts.map +1 -1
  19. package/dist/core/ps-wrapper.js +55 -35
  20. package/dist/core/record-history.js +22 -22
  21. package/dist/core/schedule-v2.d.ts +2 -2
  22. package/dist/core/schedule-v2.d.ts.map +1 -1
  23. package/dist/core/schedule-v2.js +7 -7
  24. package/dist/core/scheduler/at-fallback.d.ts +42 -0
  25. package/dist/core/scheduler/at-fallback.d.ts.map +1 -0
  26. package/dist/core/scheduler/at-fallback.js +70 -0
  27. package/dist/core/scheduler/linux.d.ts +3 -1
  28. package/dist/core/scheduler/linux.d.ts.map +1 -1
  29. package/dist/core/scheduler/linux.js +43 -7
  30. package/dist/core/scheduler/mac.d.ts +14 -8
  31. package/dist/core/scheduler/mac.d.ts.map +1 -1
  32. package/dist/core/scheduler/mac.js +71 -22
  33. package/dist/core/scheduler/posix.d.ts.map +1 -1
  34. package/dist/core/scheduler/posix.js +12 -1
  35. package/dist/core/scheduler/registry.d.ts +2 -0
  36. package/dist/core/scheduler/registry.d.ts.map +1 -1
  37. package/dist/core/scheduler/windows.d.ts +16 -3
  38. package/dist/core/scheduler/windows.d.ts.map +1 -1
  39. package/dist/core/scheduler/windows.js +249 -96
  40. package/dist/core/secrets.js +2 -2
  41. package/dist/core/self-analysis.js +55 -55
  42. package/dist/core/summary.js +1 -1
  43. package/dist/core/triage-chain.js +1 -1
  44. package/dist/core/triage-worker.js +2 -2
  45. package/dist/core/triage.js +1 -1
  46. package/dist/core/wrappers/bash.js +33 -33
  47. package/dist/db/index.d.ts +2 -0
  48. package/dist/db/index.d.ts.map +1 -1
  49. package/dist/db/index.js +9 -1
  50. package/dist/db/run-journal.d.ts +60 -0
  51. package/dist/db/run-journal.d.ts.map +1 -0
  52. package/dist/db/run-journal.js +143 -0
  53. package/dist/db/run-resume.d.ts +48 -0
  54. package/dist/db/run-resume.d.ts.map +1 -0
  55. package/dist/db/run-resume.js +137 -0
  56. package/dist/db/runs-repo.d.ts +120 -0
  57. package/dist/db/runs-repo.d.ts.map +1 -0
  58. package/dist/db/runs-repo.js +319 -0
  59. package/dist/db/schema.d.ts +16 -2
  60. package/dist/db/schema.d.ts.map +1 -1
  61. package/dist/db/schema.js +190 -35
  62. package/dist/index.d.ts +1 -1
  63. package/dist/index.d.ts.map +1 -1
  64. package/dist/index.js +66 -36
  65. package/dist/notifications.js +18 -18
  66. package/dist/profiles.d.ts +7 -3
  67. package/dist/profiles.d.ts.map +1 -1
  68. package/dist/profiles.js +85 -7
  69. package/dist/rpc.d.ts +109 -0
  70. package/dist/rpc.d.ts.map +1 -1
  71. package/dist/rpc.js +89 -0
  72. package/dist/server.d.ts +2 -2
  73. package/dist/server.d.ts.map +1 -1
  74. package/dist/server.js +20 -19
  75. package/dist/shared/jobs-view.d.ts.map +1 -1
  76. package/dist/skill.js +1 -1
  77. package/dist/task-transfer.d.ts +1 -1
  78. package/dist/task-transfer.d.ts.map +1 -1
  79. package/dist/task-transfer.js +14 -10
  80. package/dist/types.d.ts +20 -4
  81. package/dist/types.d.ts.map +1 -1
  82. package/dist/types.js +37 -9
  83. package/dist/workspaces.js +1 -1
  84. package/docs/ARCHITECTURE.md +110 -8
  85. package/docs/COMPATIBILITY.md +10 -6
  86. package/docs/CONCEPT.md +15 -3
  87. package/docs/CROSS_PLATFORM.ru.md +11 -9
  88. package/docs/CROSS_PLATFORM.zh.md +11 -9
  89. package/docs/FAQ.md +2 -2
  90. package/docs/FAQ.ru.md +2 -2
  91. package/docs/FAQ.zh.md +2 -2
  92. package/docs/FEATURES.md +5 -4
  93. package/docs/FEATURES.zh.md +5 -4
  94. package/docs/MIGRATION.md +34 -26
  95. package/docs/README.ru.md +26 -7
  96. package/docs/README.zh.md +9 -8
  97. package/docs/V1-V2-COMPATIBILITY-PLAN.md +6 -6
  98. package/gui-experimental.cjs +8 -8
  99. package/index.js +1 -0
  100. package/locales/en.json +1 -0
  101. package/locales/ru.json +1 -0
  102. package/locales/zh.json +1 -0
  103. package/package.json +31 -10
  104. package/src/core/analytics.ts +2 -2
  105. package/src/core/audit.ts +17 -17
  106. package/src/core/cron-to-schtasks.ts +14 -93
  107. package/src/core/dry-run.ts +26 -26
  108. package/src/core/file-watcher.ts +17 -17
  109. package/src/core/git-trigger.ts +9 -9
  110. package/src/core/glob.ts +1 -1
  111. package/src/core/local-ai.ts +2 -2
  112. package/src/core/lock.ts +9 -9
  113. package/src/core/matrix.ts +31 -31
  114. package/src/core/native-notify.ts +2 -2
  115. package/src/core/one-shot.ts +63 -13
  116. package/src/core/otel.ts +4 -4
  117. package/src/core/permissions.ts +5 -5
  118. package/src/core/prometheus.ts +17 -17
  119. package/src/core/ps-wrapper.ts +57 -37
  120. package/src/core/record-history.ts +40 -40
  121. package/src/core/retention.ts +3 -3
  122. package/src/core/savings.ts +1 -1
  123. package/src/core/schedule-gate.ts +12 -12
  124. package/src/core/schedule-v2.ts +24 -24
  125. package/src/core/scheduler/at-fallback.ts +113 -0
  126. package/src/core/scheduler/index.ts +3 -3
  127. package/src/core/scheduler/linux.ts +64 -13
  128. package/src/core/scheduler/logs.ts +1 -1
  129. package/src/core/scheduler/mac.ts +112 -60
  130. package/src/core/scheduler/posix.ts +15 -1
  131. package/src/core/scheduler/registry.ts +6 -4
  132. package/src/core/scheduler/windows.ts +295 -125
  133. package/src/core/secrets.ts +13 -13
  134. package/src/core/self-analysis.ts +61 -61
  135. package/src/core/session.ts +3 -3
  136. package/src/core/structured-log.ts +3 -3
  137. package/src/core/summary.ts +25 -25
  138. package/src/core/telegram.ts +16 -16
  139. package/src/core/triage-chain.ts +4 -4
  140. package/src/core/triage-compare.ts +8 -8
  141. package/src/core/triage-rules.ts +4 -4
  142. package/src/core/triage-shadow.ts +7 -7
  143. package/src/core/triage-worker.ts +6 -6
  144. package/src/core/triage.ts +23 -23
  145. package/src/core/watch-paths.ts +1 -1
  146. package/src/core/wrappers/bash.ts +41 -41
  147. package/src/db/git-state-repo.ts +1 -1
  148. package/src/db/history-repo.ts +22 -22
  149. package/src/db/index.ts +16 -6
  150. package/src/db/metrics-repo.ts +10 -10
  151. package/src/db/migrate.ts +10 -10
  152. package/src/db/recovery.ts +3 -3
  153. package/src/db/run-journal.ts +212 -0
  154. package/src/db/run-resume.ts +220 -0
  155. package/src/db/runs-repo.ts +481 -0
  156. package/src/db/schema.ts +205 -44
  157. package/src/db/settings-repo.ts +2 -2
  158. package/src/db/tasks-repo.ts +10 -10
  159. package/src/db/templates-repo.ts +7 -7
  160. package/src/gui.tsx +1 -1
  161. package/src/history.ts +4 -4
  162. package/src/i18n.ts +7 -7
  163. package/src/index.ts +341 -304
  164. package/src/integrations.ts +6 -6
  165. package/src/notifications.ts +76 -76
  166. package/src/profiles.ts +98 -7
  167. package/src/rpc.ts +96 -1
  168. package/src/schtasks.ts +2 -2
  169. package/src/server.ts +43 -42
  170. package/src/settings.ts +44 -44
  171. package/src/shared/jobs-view.ts +60 -60
  172. package/src/skill.ts +1 -1
  173. package/src/task-transfer.ts +58 -56
  174. package/src/templates.ts +1 -1
  175. package/src/types.ts +45 -10
  176. package/src/workspaces.ts +16 -16
  177. package/dist/core/self-analysis.test.d.ts +0 -2
  178. package/dist/core/self-analysis.test.d.ts.map +0 -1
  179. package/dist/core/self-analysis.test.js +0 -219
  180. package/dist/gui-experimental.cjs +0 -1
@@ -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,48 @@
1
+ import { type RunRecord, type RunStepRecord } from "./runs-repo.js";
2
+ /**
3
+ * Resume с середины (Sprint 36.2).
4
+ *
5
+ * Линейная цепочка шагов хранится в `run_steps` в порядке создания. Возобновление
6
+ * находит первый незавершённый шаг (не `passed`/`skipped`), помечает зависшие
7
+ * `running` как прерванные и выполняет остаток цепочки через журнал 36.1.b.
8
+ * Уже успешные шаги повторно не запускаются, а `attempt` упавших растёт.
9
+ */
10
+ /** Обработчик тела шага. Получает актуальную запись шага. */
11
+ export type StepHandler = (step: RunStepRecord) => unknown;
12
+ /** Опции возобновления. */
13
+ export interface ResumeOptions {
14
+ /** Тела шагов по имени. Отсутствие обработчика — ошибка до запуска цепочки. */
15
+ handlers: Record<string, StepHandler>;
16
+ /** Восстанавливать зависшие `running`-шаги перед продолжением (по умолчанию true). */
17
+ recover?: boolean;
18
+ /** Останавливаться на первой ошибке (по умолчанию true). */
19
+ stopOnError?: boolean;
20
+ }
21
+ /** Результат возобновления прогона. */
22
+ export interface ResumeResult {
23
+ /** Состояние запуска после возобновления. */
24
+ run: RunRecord;
25
+ /** С какого шага продолжили (`null`, если продолжать нечего). */
26
+ resumedFrom: string | null;
27
+ /** Номер попытки, с которым выполнялся первый возобновлённый шаг. */
28
+ resumedFromAttempt: number | null;
29
+ /** Шаги, выполненные в этот раз. */
30
+ executed: string[];
31
+ /** Шаги, пропущенные как уже завершённые. */
32
+ skipped: string[];
33
+ /** Первый упавший шаг, если цепочка остановилась. */
34
+ failedStep: string | null;
35
+ /** Текст ошибки упавшего шага. */
36
+ error: string | null;
37
+ }
38
+ /** Первый незавершённый шаг цепочки либо null. Без восстановления состояния. */
39
+ export declare function findResumeStep(runId: string): RunStepRecord | null;
40
+ /**
41
+ * Возобновляет линейную цепочку шагов синхронно.
42
+ *
43
+ * Все проверки (наличие обработчиков) выполняются до первого побочного эффекта.
44
+ */
45
+ export declare function resumeRunSync(runId: string, options: ResumeOptions): ResumeResult;
46
+ /** Асинхронный вариант `resumeRunSync` для шагов с I/O. */
47
+ export declare function resumeRun(runId: string, options: ResumeOptions): Promise<ResumeResult>;
48
+ //# 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;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"}
@@ -0,0 +1,137 @@
1
+ import { finishRun, listRunSteps, reopenRun, startRun, } from "./runs-repo.js";
2
+ import { recoverInterruptedSteps, requireRun, runStepStatefully, runStepStatefullyAsync, } from "./run-journal.js";
3
+ /** Завершён ли шаг успешно (повторять не нужно). */
4
+ function isStepDone(status) {
5
+ return status === "passed" || status === "skipped";
6
+ }
7
+ /** Первый незавершённый шаг цепочки либо null. Без восстановления состояния. */
8
+ export function findResumeStep(runId) {
9
+ const steps = listRunSteps(runId);
10
+ return steps.find((step) => !isStepDone(step.status)) ?? null;
11
+ }
12
+ function prepareResume(runId, options) {
13
+ const run = requireRun(runId);
14
+ if (run.status === "cancelled") {
15
+ throw new Error(`Запуск отменён, возобновление невозможно: ${runId}`);
16
+ }
17
+ if (options.recover !== false)
18
+ recoverInterruptedSteps(runId);
19
+ const steps = listRunSteps(runId);
20
+ const startIndex = steps.findIndex((step) => !isStepDone(step.status));
21
+ if (startIndex >= 0) {
22
+ for (const step of steps.slice(startIndex)) {
23
+ if (isStepDone(step.status))
24
+ continue;
25
+ if (typeof options.handlers[step.stepName] !== "function") {
26
+ throw new Error(`Нет обработчика шага: ${step.stepName}`);
27
+ }
28
+ }
29
+ // Упавший запуск открываем заново: шаги можно перезапускать, attempt не сбрасывается.
30
+ if (requireRun(runId).status === "failed")
31
+ reopenRun(runId);
32
+ }
33
+ return { steps, startIndex };
34
+ }
35
+ /**
36
+ * Возобновляет линейную цепочку шагов синхронно.
37
+ *
38
+ * Все проверки (наличие обработчиков) выполняются до первого побочного эффекта.
39
+ */
40
+ export function resumeRunSync(runId, options) {
41
+ const { steps, startIndex } = prepareResume(runId, options);
42
+ if (startIndex === -1) {
43
+ return finalize(runId, null, null, [], steps.map((step) => step.stepName));
44
+ }
45
+ const resumedFrom = steps[startIndex].stepName;
46
+ const executed = [];
47
+ const skipped = steps
48
+ .slice(0, startIndex)
49
+ .filter((step) => isStepDone(step.status))
50
+ .map((step) => step.stepName);
51
+ let resumedFromAttempt = null;
52
+ for (let index = startIndex; index < steps.length; index += 1) {
53
+ const step = steps[index];
54
+ if (isStepDone(step.status)) {
55
+ skipped.push(step.stepName);
56
+ continue;
57
+ }
58
+ executed.push(step.stepName);
59
+ try {
60
+ const execution = runStepStatefully(runId, step.stepName, () => options.handlers[step.stepName](step));
61
+ if (resumedFromAttempt === null)
62
+ resumedFromAttempt = execution.attempt;
63
+ }
64
+ catch {
65
+ if (options.stopOnError === false)
66
+ continue;
67
+ return finalize(runId, resumedFrom, resumedFromAttempt, executed, skipped);
68
+ }
69
+ }
70
+ return finalize(runId, resumedFrom, resumedFromAttempt, executed, skipped);
71
+ }
72
+ /** Асинхронный вариант `resumeRunSync` для шагов с I/O. */
73
+ export async function resumeRun(runId, options) {
74
+ const { steps, startIndex } = prepareResume(runId, options);
75
+ if (startIndex === -1) {
76
+ return finalize(runId, null, null, [], steps.map((step) => step.stepName));
77
+ }
78
+ const resumedFrom = steps[startIndex].stepName;
79
+ const executed = [];
80
+ const skipped = steps
81
+ .slice(0, startIndex)
82
+ .filter((step) => isStepDone(step.status))
83
+ .map((step) => step.stepName);
84
+ let resumedFromAttempt = null;
85
+ for (let index = startIndex; index < steps.length; index += 1) {
86
+ const step = steps[index];
87
+ if (isStepDone(step.status)) {
88
+ skipped.push(step.stepName);
89
+ continue;
90
+ }
91
+ executed.push(step.stepName);
92
+ try {
93
+ const execution = await runStepStatefullyAsync(runId, step.stepName, () => options.handlers[step.stepName](step));
94
+ if (resumedFromAttempt === null)
95
+ resumedFromAttempt = execution.attempt;
96
+ }
97
+ catch {
98
+ if (options.stopOnError === false)
99
+ continue;
100
+ return finalize(runId, resumedFrom, resumedFromAttempt, executed, skipped);
101
+ }
102
+ }
103
+ return finalize(runId, resumedFrom, resumedFromAttempt, executed, skipped);
104
+ }
105
+ /** Закрывает прогон по фактическому состоянию шагов и собирает результат. */
106
+ function finalize(runId, resumedFrom, resumedFromAttempt, executed, skipped) {
107
+ let steps = listRunSteps(runId);
108
+ const failed = steps.find((step) => step.status === "failed") ?? null;
109
+ const unfinished = steps.some((step) => step.status === "pending" || step.status === "running");
110
+ let run = requireRun(runId);
111
+ if (!failed && !unfinished) {
112
+ if (run.status === "pending") {
113
+ startRun(runId);
114
+ run = requireRun(runId);
115
+ }
116
+ if (run.status === "running") {
117
+ finishRun(runId, "passed");
118
+ run = requireRun(runId);
119
+ }
120
+ }
121
+ else if (failed && run.status === "running") {
122
+ finishRun(runId, "failed", {
123
+ error: failed.error ?? `Шаг ${failed.stepName} завершился ошибкой`,
124
+ });
125
+ run = requireRun(runId);
126
+ }
127
+ steps = listRunSteps(runId);
128
+ return {
129
+ run,
130
+ resumedFrom,
131
+ resumedFromAttempt,
132
+ executed,
133
+ skipped,
134
+ failedStep: failed?.stepName ?? null,
135
+ error: failed?.error ?? null,
136
+ };
137
+ }
@@ -0,0 +1,120 @@
1
+ /**
2
+ * Репозиторий durable-состояния запуска (Спринт 36.1).
3
+ *
4
+ * `runs` — единица выполнения, `run_steps` — её шаги. Строки создаются до
5
+ * старта работы и обновляются на каждом переходе, поэтому после сбоя процесса
6
+ * можно понять, где именно остановился запуск (основа resume в 36.2).
7
+ *
8
+ * Переходы статусов проверяются здесь, а не в SQL: CHECK-ограничения в SQLite
9
+ * пришлось бы переписывать при каждом новом статусе (например, DLQ в 36.4).
10
+ */
11
+ /** Статусы запуска: pending → running → passed/failed; отмена возможна до финала. */
12
+ export type RunStatus = "pending" | "running" | "passed" | "failed" | "cancelled";
13
+ /** Статусы шага: pending → running → passed/failed; skipped — осознанный пропуск. */
14
+ export type StepStatus = "pending" | "running" | "passed" | "failed" | "skipped";
15
+ export declare class InvalidTransitionError extends Error {
16
+ readonly entity: "run" | "step";
17
+ readonly from: string;
18
+ readonly to: string;
19
+ constructor(entity: "run" | "step", from: string, to: string);
20
+ }
21
+ export interface RunRecord {
22
+ id: string;
23
+ taskName: string;
24
+ status: RunStatus;
25
+ parentRunId: string | null;
26
+ workspaceId: string | null;
27
+ startedAt: string | null;
28
+ finishedAt: string | null;
29
+ error: string | null;
30
+ metadata: unknown;
31
+ createdAt: string;
32
+ updatedAt: string;
33
+ }
34
+ export interface RunStepRecord {
35
+ id: string;
36
+ runId: string;
37
+ stepName: string;
38
+ /** Порядок шага в линейной цепочке (0, 1, 2...). */
39
+ position: number;
40
+ status: StepStatus;
41
+ attempt: number;
42
+ idempotencyKey: string | null;
43
+ startedAt: string | null;
44
+ finishedAt: string | null;
45
+ error: string | null;
46
+ output: unknown;
47
+ createdAt: string;
48
+ updatedAt: string;
49
+ }
50
+ export interface CreateRunOptions {
51
+ /** Имя задачи; для ручного/DAG-запуска может быть синтетическим. */
52
+ taskName: string;
53
+ parentRunId?: string | null;
54
+ workspaceId?: string | null;
55
+ metadata?: unknown;
56
+ /** Начальный статус; по умолчанию pending. */
57
+ status?: Extract<RunStatus, "pending" | "running">;
58
+ /** Момент старта; по умолчанию now, если статус running. */
59
+ startedAt?: string;
60
+ /** Шаги создаются в той же транзакции, что и запуск. */
61
+ steps?: CreateStepOptions[];
62
+ }
63
+ export interface CreateStepOptions {
64
+ stepName: string;
65
+ idempotencyKey?: string | null;
66
+ status?: StepStatus;
67
+ /** Полезная нагрузка (JSON-сериализуемая). */
68
+ output?: unknown;
69
+ }
70
+ export interface FinishOptions {
71
+ error?: string | null;
72
+ output?: unknown;
73
+ }
74
+ /** Создаёт запуск и (опционально) его шаги одной транзакцией. */
75
+ export declare function createRun(options: CreateRunOptions): RunRecord;
76
+ /** Добавляет шаг в существующий запуск. Имя шага уникально внутри запуска. */
77
+ export declare function createStep(runId: string, options: CreateStepOptions): RunStepRecord;
78
+ /** Создаёт все шаги запуска в одной транзакции (для DAG-описания). */
79
+ export declare function createSteps(runId: string, steps: CreateStepOptions[]): RunStepRecord[];
80
+ export declare function getRun(id: string): RunRecord | undefined;
81
+ /** Список запусков (новые сверху). Без taskName — по всем задачам. */
82
+ export declare function listRuns(taskName?: string | null, limit?: number): RunRecord[];
83
+ /** pending → running. Возвращает false, если запуск не найден. */
84
+ export declare function startRun(id: string, startedAt?: string): boolean;
85
+ /** Завершает запуск (passed/failed/cancelled) и фиксирует finished_at. */
86
+ export declare function finishRun(id: string, status: Extract<RunStatus, "passed" | "failed" | "cancelled">, options?: FinishOptions): boolean;
87
+ /**
88
+ * failed → running: возобновление прогона после краха (36.2).
89
+ *
90
+ * Разрешено только из failed и не сбрасывает номера попыток шагов —
91
+ * они растут через `retryStep` при повторе конкретного шага.
92
+ */
93
+ export declare function reopenRun(id: string, startedAt?: string): boolean;
94
+ export declare function getStepById(id: string): RunStepRecord | undefined;
95
+ /** Шаг по имени внутри запуска (имя уникально). */
96
+ export declare function getStep(runId: string, stepName: string): RunStepRecord | undefined;
97
+ /** Все шаги запуска в порядке создания. */
98
+ export declare function listRunSteps(runId: string): RunStepRecord[];
99
+ /** Поиск шага по ключу идемпотентности (36.3) в пределах запуска. */
100
+ export declare function findStepByIdempotencyKey(runId: string, idempotencyKey: string): RunStepRecord | undefined;
101
+ /** pending → running. Возвращает false, если шаг не найден. */
102
+ export declare function startStep(id: string, startedAt?: string): boolean;
103
+ /** running → passed/failed; pending → skipped допустим. */
104
+ export declare function finishStep(id: string, status: Extract<StepStatus, "passed" | "failed" | "skipped">, options?: FinishOptions): boolean;
105
+ /**
106
+ * Повтор упавшего шага: failed → running, attempt + 1.
107
+ *
108
+ * Это единственный переход из финального статуса шага. Предыдущая попытка
109
+ * остаётся видимой в счётчике attempt; для 36.4 (DLQ) здесь появится лимит.
110
+ */
111
+ export declare function retryStep(id: string, startedAt?: string): boolean;
112
+ /** Количество шагов запуска (для health/отчётов). */
113
+ export declare function countRunSteps(runId: string): number;
114
+ /** Удаляет запуск; шаги удаляются каскадом (ON DELETE CASCADE). */
115
+ export declare function deleteRun(id: string): boolean;
116
+ /** Готова ли схема к работе с durable DAG (runs + run_steps). */
117
+ export declare function isRunStateReady(): boolean;
118
+ /** Терминальный ли статус шага (для resume/cleanup в следующих подзадачах). */
119
+ export declare function isTerminalStepStatus(status: StepStatus): boolean;
120
+ //# sourceMappingURL=runs-repo.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"runs-repo.d.ts","sourceRoot":"","sources":["../../src/db/runs-repo.ts"],"names":[],"mappings":"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"}