agent-steward 0.0.1 → 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 (345) hide show
  1. package/CHANGELOG.md +399 -0
  2. package/CROSS_PLATFORM.md +151 -0
  3. package/README.md +307 -15
  4. package/ROADMAP-STRATEGY.md +196 -0
  5. package/ROADMAP.md +184 -0
  6. package/dist/core/analytics.d.ts +132 -0
  7. package/dist/core/analytics.d.ts.map +1 -0
  8. package/dist/core/analytics.js +290 -0
  9. package/dist/core/audit.d.ts +96 -0
  10. package/dist/core/audit.d.ts.map +1 -0
  11. package/dist/core/audit.js +297 -0
  12. package/dist/core/cron-to-schtasks.d.ts +12 -0
  13. package/dist/core/cron-to-schtasks.d.ts.map +1 -0
  14. package/dist/core/cron-to-schtasks.js +175 -0
  15. package/dist/core/dry-run.d.ts +102 -0
  16. package/dist/core/dry-run.d.ts.map +1 -0
  17. package/dist/core/dry-run.js +447 -0
  18. package/dist/core/file-watcher.d.ts +31 -0
  19. package/dist/core/file-watcher.d.ts.map +1 -0
  20. package/dist/core/file-watcher.js +186 -0
  21. package/dist/core/git-trigger.d.ts +82 -0
  22. package/dist/core/git-trigger.d.ts.map +1 -0
  23. package/dist/core/git-trigger.js +312 -0
  24. package/dist/core/glob.d.ts +38 -0
  25. package/dist/core/glob.d.ts.map +1 -0
  26. package/dist/core/glob.js +233 -0
  27. package/dist/core/local-ai.d.ts +52 -0
  28. package/dist/core/local-ai.d.ts.map +1 -0
  29. package/dist/core/local-ai.js +119 -0
  30. package/dist/core/lock.d.ts +57 -0
  31. package/dist/core/lock.d.ts.map +1 -0
  32. package/dist/core/lock.js +193 -0
  33. package/dist/core/matrix.d.ts +167 -0
  34. package/dist/core/matrix.d.ts.map +1 -0
  35. package/dist/core/matrix.js +724 -0
  36. package/dist/core/native-notify.d.ts +36 -0
  37. package/dist/core/native-notify.d.ts.map +1 -0
  38. package/dist/core/native-notify.js +113 -0
  39. package/dist/core/one-shot.d.ts +90 -0
  40. package/dist/core/one-shot.d.ts.map +1 -0
  41. package/dist/core/one-shot.js +182 -0
  42. package/dist/core/otel.d.ts +4 -0
  43. package/dist/core/otel.d.ts.map +1 -0
  44. package/dist/core/otel.js +98 -0
  45. package/dist/core/permissions.d.ts +69 -0
  46. package/dist/core/permissions.d.ts.map +1 -0
  47. package/dist/core/permissions.js +143 -0
  48. package/dist/core/prometheus.d.ts +23 -0
  49. package/dist/core/prometheus.d.ts.map +1 -0
  50. package/dist/core/prometheus.js +146 -0
  51. package/dist/core/ps-wrapper.d.ts +73 -0
  52. package/dist/core/ps-wrapper.d.ts.map +1 -0
  53. package/dist/core/ps-wrapper.js +1091 -0
  54. package/dist/core/record-history.d.ts +25 -0
  55. package/dist/core/record-history.d.ts.map +1 -0
  56. package/dist/core/record-history.js +471 -0
  57. package/dist/core/retention.d.ts +29 -0
  58. package/dist/core/retention.d.ts.map +1 -0
  59. package/dist/core/retention.js +98 -0
  60. package/dist/core/savings.d.ts +70 -0
  61. package/dist/core/savings.d.ts.map +1 -0
  62. package/dist/core/savings.js +87 -0
  63. package/dist/core/schedule-gate.d.ts +2 -0
  64. package/dist/core/schedule-gate.d.ts.map +1 -0
  65. package/dist/core/schedule-gate.js +211 -0
  66. package/dist/core/schedule-v2.d.ts +116 -0
  67. package/dist/core/schedule-v2.d.ts.map +1 -0
  68. package/dist/core/schedule-v2.js +586 -0
  69. package/dist/core/scheduler/at-fallback.d.ts +42 -0
  70. package/dist/core/scheduler/at-fallback.d.ts.map +1 -0
  71. package/dist/core/scheduler/at-fallback.js +70 -0
  72. package/dist/core/scheduler/index.d.ts +32 -0
  73. package/dist/core/scheduler/index.d.ts.map +1 -0
  74. package/dist/core/scheduler/index.js +63 -0
  75. package/dist/core/scheduler/linux.d.ts +46 -0
  76. package/dist/core/scheduler/linux.d.ts.map +1 -0
  77. package/dist/core/scheduler/linux.js +261 -0
  78. package/dist/core/scheduler/logs.d.ts +11 -0
  79. package/dist/core/scheduler/logs.d.ts.map +1 -0
  80. package/dist/core/scheduler/logs.js +34 -0
  81. package/dist/core/scheduler/mac.d.ts +46 -0
  82. package/dist/core/scheduler/mac.d.ts.map +1 -0
  83. package/dist/core/scheduler/mac.js +256 -0
  84. package/dist/core/scheduler/posix.d.ts +40 -0
  85. package/dist/core/scheduler/posix.d.ts.map +1 -0
  86. package/dist/core/scheduler/posix.js +100 -0
  87. package/dist/core/scheduler/registry.d.ts +43 -0
  88. package/dist/core/scheduler/registry.d.ts.map +1 -0
  89. package/dist/core/scheduler/registry.js +57 -0
  90. package/dist/core/scheduler/types.d.ts +86 -0
  91. package/dist/core/scheduler/types.d.ts.map +1 -0
  92. package/dist/core/scheduler/types.js +1 -0
  93. package/dist/core/scheduler/windows.d.ts +112 -0
  94. package/dist/core/scheduler/windows.d.ts.map +1 -0
  95. package/dist/core/scheduler/windows.js +749 -0
  96. package/dist/core/secrets.d.ts +66 -0
  97. package/dist/core/secrets.d.ts.map +1 -0
  98. package/dist/core/secrets.js +433 -0
  99. package/dist/core/self-analysis.d.ts +117 -0
  100. package/dist/core/self-analysis.d.ts.map +1 -0
  101. package/dist/core/self-analysis.js +539 -0
  102. package/dist/core/session.d.ts +42 -0
  103. package/dist/core/session.d.ts.map +1 -0
  104. package/dist/core/session.js +134 -0
  105. package/dist/core/shutdown.d.ts +26 -0
  106. package/dist/core/shutdown.d.ts.map +1 -0
  107. package/dist/core/shutdown.js +49 -0
  108. package/dist/core/structured-log.d.ts +84 -0
  109. package/dist/core/structured-log.d.ts.map +1 -0
  110. package/dist/core/structured-log.js +146 -0
  111. package/dist/core/summary.d.ts +69 -0
  112. package/dist/core/summary.d.ts.map +1 -0
  113. package/dist/core/summary.js +250 -0
  114. package/dist/core/telegram.d.ts +55 -0
  115. package/dist/core/telegram.d.ts.map +1 -0
  116. package/dist/core/telegram.js +344 -0
  117. package/dist/core/triage-chain.d.ts +40 -0
  118. package/dist/core/triage-chain.d.ts.map +1 -0
  119. package/dist/core/triage-chain.js +80 -0
  120. package/dist/core/triage-compare.d.ts +68 -0
  121. package/dist/core/triage-compare.d.ts.map +1 -0
  122. package/dist/core/triage-compare.js +184 -0
  123. package/dist/core/triage-rules.d.ts +23 -0
  124. package/dist/core/triage-rules.d.ts.map +1 -0
  125. package/dist/core/triage-rules.js +196 -0
  126. package/dist/core/triage-shadow.d.ts +91 -0
  127. package/dist/core/triage-shadow.d.ts.map +1 -0
  128. package/dist/core/triage-shadow.js +160 -0
  129. package/dist/core/triage-worker.d.ts +55 -0
  130. package/dist/core/triage-worker.d.ts.map +1 -0
  131. package/dist/core/triage-worker.js +314 -0
  132. package/dist/core/triage.d.ts +76 -0
  133. package/dist/core/triage.d.ts.map +1 -0
  134. package/dist/core/triage.js +271 -0
  135. package/dist/core/watch-paths.d.ts +6 -0
  136. package/dist/core/watch-paths.d.ts.map +1 -0
  137. package/dist/core/watch-paths.js +62 -0
  138. package/dist/core/wrappers/bash.d.ts +95 -0
  139. package/dist/core/wrappers/bash.d.ts.map +1 -0
  140. package/dist/core/wrappers/bash.js +413 -0
  141. package/dist/db/git-state-repo.d.ts +16 -0
  142. package/dist/db/git-state-repo.d.ts.map +1 -0
  143. package/dist/db/git-state-repo.js +38 -0
  144. package/dist/db/history-repo.d.ts +110 -0
  145. package/dist/db/history-repo.d.ts.map +1 -0
  146. package/dist/db/history-repo.js +300 -0
  147. package/dist/db/index.d.ts +49 -0
  148. package/dist/db/index.d.ts.map +1 -0
  149. package/dist/db/index.js +128 -0
  150. package/dist/db/metrics-repo.d.ts +46 -0
  151. package/dist/db/metrics-repo.d.ts.map +1 -0
  152. package/dist/db/metrics-repo.js +103 -0
  153. package/dist/db/migrate.d.ts +24 -0
  154. package/dist/db/migrate.d.ts.map +1 -0
  155. package/dist/db/migrate.js +244 -0
  156. package/dist/db/recovery.d.ts +11 -0
  157. package/dist/db/recovery.d.ts.map +1 -0
  158. package/dist/db/recovery.js +38 -0
  159. package/dist/db/run-journal.d.ts +60 -0
  160. package/dist/db/run-journal.d.ts.map +1 -0
  161. package/dist/db/run-journal.js +143 -0
  162. package/dist/db/run-resume.d.ts +48 -0
  163. package/dist/db/run-resume.d.ts.map +1 -0
  164. package/dist/db/run-resume.js +137 -0
  165. package/dist/db/runs-repo.d.ts +120 -0
  166. package/dist/db/runs-repo.d.ts.map +1 -0
  167. package/dist/db/runs-repo.js +319 -0
  168. package/dist/db/schema.d.ts +38 -0
  169. package/dist/db/schema.d.ts.map +1 -0
  170. package/dist/db/schema.js +325 -0
  171. package/dist/db/settings-repo.d.ts +8 -0
  172. package/dist/db/settings-repo.d.ts.map +1 -0
  173. package/dist/db/settings-repo.js +27 -0
  174. package/dist/db/tasks-repo.d.ts +26 -0
  175. package/dist/db/tasks-repo.d.ts.map +1 -0
  176. package/dist/db/tasks-repo.js +120 -0
  177. package/dist/db/templates-repo.d.ts +17 -0
  178. package/dist/db/templates-repo.d.ts.map +1 -0
  179. package/dist/db/templates-repo.js +57 -0
  180. package/dist/history.d.ts +60 -0
  181. package/dist/history.d.ts.map +1 -0
  182. package/dist/history.js +70 -0
  183. package/dist/i18n.d.ts +75 -0
  184. package/dist/i18n.d.ts.map +1 -0
  185. package/dist/i18n.js +357 -0
  186. package/dist/index.d.ts +858 -0
  187. package/dist/index.d.ts.map +1 -0
  188. package/dist/index.js +5209 -0
  189. package/dist/integrations.d.ts +72 -0
  190. package/dist/integrations.d.ts.map +1 -0
  191. package/dist/integrations.js +233 -0
  192. package/dist/notifications.d.ts +199 -0
  193. package/dist/notifications.d.ts.map +1 -0
  194. package/dist/notifications.js +967 -0
  195. package/dist/profiles.d.ts +64 -0
  196. package/dist/profiles.d.ts.map +1 -0
  197. package/dist/profiles.js +305 -0
  198. package/dist/rpc.d.ts +3915 -0
  199. package/dist/rpc.d.ts.map +1 -0
  200. package/dist/rpc.js +1596 -0
  201. package/dist/schtasks.d.ts +32 -0
  202. package/dist/schtasks.d.ts.map +1 -0
  203. package/dist/schtasks.js +45 -0
  204. package/dist/server.d.ts +128 -0
  205. package/dist/server.d.ts.map +1 -0
  206. package/dist/server.js +2414 -0
  207. package/dist/settings.d.ts +389 -0
  208. package/dist/settings.d.ts.map +1 -0
  209. package/dist/settings.js +770 -0
  210. package/dist/shared/jobs-view.d.ts +59 -0
  211. package/dist/shared/jobs-view.d.ts.map +1 -0
  212. package/dist/shared/jobs-view.js +146 -0
  213. package/dist/skill.d.ts +15 -0
  214. package/dist/skill.d.ts.map +1 -0
  215. package/dist/skill.js +93 -0
  216. package/dist/task-transfer.d.ts +252 -0
  217. package/dist/task-transfer.d.ts.map +1 -0
  218. package/dist/task-transfer.js +632 -0
  219. package/dist/templates.d.ts +57 -0
  220. package/dist/templates.d.ts.map +1 -0
  221. package/dist/templates.js +16 -0
  222. package/dist/types.d.ts +112 -0
  223. package/dist/types.d.ts.map +1 -0
  224. package/dist/types.js +158 -0
  225. package/dist/version.d.ts +8 -0
  226. package/dist/version.d.ts.map +1 -0
  227. package/dist/version.js +27 -0
  228. package/dist/workspaces.d.ts +113 -0
  229. package/dist/workspaces.d.ts.map +1 -0
  230. package/dist/workspaces.js +393 -0
  231. package/docs/ARCHITECTURE.md +559 -0
  232. package/docs/COMPATIBILITY.md +237 -0
  233. package/docs/CONCEPT.md +242 -0
  234. package/docs/CROSS_PLATFORM.ru.md +152 -0
  235. package/docs/CROSS_PLATFORM.zh.md +148 -0
  236. package/docs/FAQ.md +52 -0
  237. package/docs/FAQ.ru.md +53 -0
  238. package/docs/FAQ.zh.md +43 -0
  239. package/docs/FEATURES.md +699 -0
  240. package/docs/FEATURES.zh.md +656 -0
  241. package/docs/LOCAL-AI.md +300 -0
  242. package/docs/MIGRATION.md +363 -0
  243. package/docs/README.ru.md +287 -0
  244. package/docs/README.zh.md +306 -0
  245. package/docs/SAVINGS.md +61 -0
  246. package/docs/SAVINGS.ru.md +60 -0
  247. package/docs/SAVINGS.zh.md +52 -0
  248. package/docs/V1-V2-COMPATIBILITY-PLAN.md +366 -0
  249. package/docs/ZH-LOCALE-PLAN.md +324 -0
  250. package/docs/dashboard.png +0 -0
  251. package/docs/spikes/local-model-structured-output.md +81 -0
  252. package/docs/spikes/ollama-qwen3-4b-smoke.json +28 -0
  253. package/docs/spikes/ollama-qwen3-4b.json +163 -0
  254. package/gui-experimental.cjs +9 -0
  255. package/index.js +2 -0
  256. package/locales/en.json +781 -0
  257. package/locales/ru.json +781 -0
  258. package/locales/zh.json +781 -0
  259. package/package.json +154 -13
  260. package/scripts/bench-local.mjs +321 -0
  261. package/scripts/check-zh-locale.mjs +218 -0
  262. package/scripts/demo-dashboard.mjs +209 -0
  263. package/scripts/run-tests.mjs +236 -0
  264. package/scripts/spike-local-structured.mjs +182 -0
  265. package/scripts/test-locale.mjs +45 -0
  266. package/skills/scheduled-job-best-practices/SKILL.md +158 -0
  267. package/skills/scheduled-job-best-practices/references/recipes.md +163 -0
  268. package/src/core/analytics.ts +424 -0
  269. package/src/core/audit.ts +418 -0
  270. package/src/core/cron-to-schtasks.ts +209 -0
  271. package/src/core/dry-run.ts +601 -0
  272. package/src/core/file-watcher.ts +245 -0
  273. package/src/core/git-trigger.ts +391 -0
  274. package/src/core/glob.ts +226 -0
  275. package/src/core/local-ai.ts +173 -0
  276. package/src/core/lock.ts +219 -0
  277. package/src/core/matrix.ts +947 -0
  278. package/src/core/native-notify.ts +157 -0
  279. package/src/core/one-shot.ts +239 -0
  280. package/src/core/otel.ts +128 -0
  281. package/src/core/permissions.ts +200 -0
  282. package/src/core/prometheus.ts +215 -0
  283. package/src/core/ps-wrapper.ts +1160 -0
  284. package/src/core/record-history.ts +615 -0
  285. package/src/core/retention.ts +141 -0
  286. package/src/core/savings.ts +150 -0
  287. package/src/core/schedule-gate.ts +253 -0
  288. package/src/core/schedule-v2.ts +668 -0
  289. package/src/core/scheduler/at-fallback.ts +113 -0
  290. package/src/core/scheduler/index.ts +82 -0
  291. package/src/core/scheduler/linux.ts +308 -0
  292. package/src/core/scheduler/logs.ts +37 -0
  293. package/src/core/scheduler/mac.ts +322 -0
  294. package/src/core/scheduler/posix.ts +128 -0
  295. package/src/core/scheduler/registry.ts +101 -0
  296. package/src/core/scheduler/types.ts +90 -0
  297. package/src/core/scheduler/windows.ts +881 -0
  298. package/src/core/secrets.ts +503 -0
  299. package/src/core/self-analysis.ts +744 -0
  300. package/src/core/session.ts +150 -0
  301. package/src/core/shutdown.ts +69 -0
  302. package/src/core/structured-log.ts +214 -0
  303. package/src/core/summary.ts +318 -0
  304. package/src/core/telegram.ts +436 -0
  305. package/src/core/triage-chain.ts +125 -0
  306. package/src/core/triage-compare.ts +277 -0
  307. package/src/core/triage-rules.ts +238 -0
  308. package/src/core/triage-shadow.ts +240 -0
  309. package/src/core/triage-worker.ts +344 -0
  310. package/src/core/triage.ts +366 -0
  311. package/src/core/watch-paths.ts +70 -0
  312. package/src/core/wrappers/bash.ts +532 -0
  313. package/src/db/git-state-repo.ts +62 -0
  314. package/src/db/history-repo.ts +492 -0
  315. package/src/db/index.ts +176 -0
  316. package/src/db/metrics-repo.ts +170 -0
  317. package/src/db/migrate.ts +328 -0
  318. package/src/db/recovery.ts +46 -0
  319. package/src/db/run-journal.ts +212 -0
  320. package/src/db/run-resume.ts +220 -0
  321. package/src/db/runs-repo.ts +481 -0
  322. package/src/db/schema.ts +349 -0
  323. package/src/db/settings-repo.ts +31 -0
  324. package/src/db/tasks-repo.ts +162 -0
  325. package/src/db/templates-repo.ts +77 -0
  326. package/src/gui.tsx +5222 -0
  327. package/src/history.ts +128 -0
  328. package/src/i18n.ts +413 -0
  329. package/src/index.ts +6642 -0
  330. package/src/integrations.ts +297 -0
  331. package/src/notifications.ts +1346 -0
  332. package/src/profiles.ts +345 -0
  333. package/src/rpc.ts +1704 -0
  334. package/src/schtasks.ts +75 -0
  335. package/src/server.ts +2663 -0
  336. package/src/settings.ts +1369 -0
  337. package/src/shared/jobs-view.ts +188 -0
  338. package/src/skill.ts +113 -0
  339. package/src/task-transfer.ts +946 -0
  340. package/src/templates.ts +67 -0
  341. package/src/tui-v1.tsx +341 -0
  342. package/src/tui.tsx +329 -0
  343. package/src/types.ts +226 -0
  344. package/src/version.ts +27 -0
  345. package/src/workspaces.ts +487 -0
@@ -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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"}
@@ -0,0 +1,319 @@
1
+ import { randomUUID } from "node:crypto";
2
+ import { getDb, withTransaction } from "./index.js";
3
+ /** Финальные статусы шага — из них нет переходов, кроме явного retry. */
4
+ const TERMINAL_STEP_STATUSES = new Set([
5
+ "passed",
6
+ "failed",
7
+ "skipped",
8
+ ]);
9
+ const RUN_TRANSITIONS = {
10
+ pending: ["running", "cancelled"],
11
+ running: ["passed", "failed", "cancelled"],
12
+ passed: [],
13
+ // failed → running — явное возобновление после краха (36.2), только через reopenRun.
14
+ failed: ["running"],
15
+ cancelled: [],
16
+ };
17
+ const STEP_TRANSITIONS = {
18
+ pending: ["running", "failed", "skipped"],
19
+ running: ["passed", "failed"],
20
+ passed: [],
21
+ failed: [],
22
+ skipped: [],
23
+ };
24
+ export class InvalidTransitionError extends Error {
25
+ constructor(entity, from, to) {
26
+ super(`Недопустимый переход ${entity}: ${from} → ${to}`);
27
+ this.entity = entity;
28
+ this.from = from;
29
+ this.to = to;
30
+ this.name = "InvalidTransitionError";
31
+ }
32
+ }
33
+ function nowIso() {
34
+ return new Date().toISOString();
35
+ }
36
+ function parseJson(value) {
37
+ if (value == null)
38
+ return null;
39
+ try {
40
+ return JSON.parse(String(value));
41
+ }
42
+ catch {
43
+ return String(value);
44
+ }
45
+ }
46
+ function serializeJson(value) {
47
+ if (value === undefined)
48
+ return null;
49
+ try {
50
+ return JSON.stringify(value);
51
+ }
52
+ catch {
53
+ return null;
54
+ }
55
+ }
56
+ function runRowToRecord(row) {
57
+ return {
58
+ id: String(row.id),
59
+ taskName: String(row.task_name),
60
+ status: String(row.status),
61
+ parentRunId: row.parent_run_id == null ? null : String(row.parent_run_id),
62
+ workspaceId: row.workspace_id == null ? null : String(row.workspace_id),
63
+ startedAt: row.started_at == null ? null : String(row.started_at),
64
+ finishedAt: row.finished_at == null ? null : String(row.finished_at),
65
+ error: row.error == null ? null : String(row.error),
66
+ metadata: parseJson(row.metadata_json),
67
+ createdAt: String(row.created_at),
68
+ updatedAt: String(row.updated_at),
69
+ };
70
+ }
71
+ function stepRowToRecord(row) {
72
+ return {
73
+ id: String(row.id),
74
+ runId: String(row.run_id),
75
+ stepName: String(row.step_name),
76
+ position: Number(row.position) || 0,
77
+ status: String(row.status),
78
+ attempt: Number(row.attempt) || 1,
79
+ idempotencyKey: row.idempotency_key == null ? null : String(row.idempotency_key),
80
+ startedAt: row.started_at == null ? null : String(row.started_at),
81
+ finishedAt: row.finished_at == null ? null : String(row.finished_at),
82
+ error: row.error == null ? null : String(row.error),
83
+ output: parseJson(row.output_json),
84
+ createdAt: String(row.created_at),
85
+ updatedAt: String(row.updated_at),
86
+ };
87
+ }
88
+ function assertTransition(entity, from, to, allowed) {
89
+ if (!allowed.includes(to))
90
+ throw new InvalidTransitionError(entity, from, to);
91
+ }
92
+ const INSERT_RUN_SQL = `INSERT INTO runs (
93
+ id, task_name, status, parent_run_id, workspace_id,
94
+ started_at, finished_at, error, metadata_json, created_at, updated_at
95
+ ) VALUES (?, ?, ?, ?, ?, ?, NULL, NULL, ?, ?, ?)`;
96
+ const INSERT_STEP_SQL = `INSERT INTO run_steps (
97
+ id, run_id, step_name, position, status, attempt, idempotency_key,
98
+ started_at, finished_at, error, output_json, created_at, updated_at
99
+ ) VALUES (?, ?, ?, ?, ?, ?, ?, ?, NULL, NULL, ?, ?, ?)`;
100
+ /** Создаёт запуск и (опционально) его шаги одной транзакцией. */
101
+ export function createRun(options) {
102
+ const id = randomUUID();
103
+ const timestamp = nowIso();
104
+ const status = options.status ?? "pending";
105
+ const startedAt = options.startedAt ?? (status === "running" ? timestamp : null);
106
+ withTransaction(() => {
107
+ getDb()
108
+ .prepare(INSERT_RUN_SQL)
109
+ .run(id, options.taskName, status, options.parentRunId ?? null, options.workspaceId ?? null, startedAt, serializeJson(options.metadata), timestamp, timestamp);
110
+ let position = 0;
111
+ for (const step of options.steps ?? []) {
112
+ insertStepUnsafe(id, step, timestamp, position);
113
+ position += 1;
114
+ }
115
+ });
116
+ const created = getRun(id);
117
+ if (!created)
118
+ throw new Error("Запуск не найден сразу после создания");
119
+ return created;
120
+ }
121
+ function insertStepUnsafe(runId, options, timestamp, position) {
122
+ const id = randomUUID();
123
+ const status = options.status ?? "pending";
124
+ const startedAt = status === "running" ? timestamp : null;
125
+ getDb()
126
+ .prepare(INSERT_STEP_SQL)
127
+ .run(id, runId, options.stepName, position, status, 1, options.idempotencyKey ?? null, startedAt, serializeJson(options.output), timestamp, timestamp);
128
+ return id;
129
+ }
130
+ /** Следующая позиция шага в цепочке запуска. */
131
+ function nextStepPosition(runId) {
132
+ const row = getDb()
133
+ .prepare("SELECT COALESCE(MAX(position), -1) + 1 AS next FROM run_steps WHERE run_id = ?")
134
+ .get(runId);
135
+ return Number(row?.next) || 0;
136
+ }
137
+ /** Добавляет шаг в существующий запуск. Имя шага уникально внутри запуска. */
138
+ export function createStep(runId, options) {
139
+ const id = withTransaction(() => insertStepUnsafe(runId, options, nowIso(), nextStepPosition(runId)));
140
+ const step = getStepById(id);
141
+ if (!step)
142
+ throw new Error("Шаг не найден сразу после создания");
143
+ return step;
144
+ }
145
+ /** Создаёт все шаги запуска в одной транзакции (для DAG-описания). */
146
+ export function createSteps(runId, steps) {
147
+ const timestamp = nowIso();
148
+ withTransaction(() => {
149
+ let position = nextStepPosition(runId);
150
+ for (const step of steps) {
151
+ insertStepUnsafe(runId, step, timestamp, position);
152
+ position += 1;
153
+ }
154
+ });
155
+ return listRunSteps(runId);
156
+ }
157
+ export function getRun(id) {
158
+ const row = getDb().prepare("SELECT * FROM runs WHERE id = ?").get(id);
159
+ return row ? runRowToRecord(row) : undefined;
160
+ }
161
+ /** Список запусков (новые сверху). Без taskName — по всем задачам. */
162
+ export function listRuns(taskName, limit = 100) {
163
+ const safeLimit = Math.max(1, Math.min(10000, Math.floor(limit) || 1));
164
+ if (taskName) {
165
+ return getDb()
166
+ .prepare(`SELECT * FROM runs WHERE lower(task_name) = lower(?)
167
+ ORDER BY created_at DESC, id DESC LIMIT ?`)
168
+ .all(taskName, safeLimit)
169
+ .map(runRowToRecord);
170
+ }
171
+ return getDb()
172
+ .prepare("SELECT * FROM runs ORDER BY created_at DESC, id DESC LIMIT ?")
173
+ .all(safeLimit)
174
+ .map(runRowToRecord);
175
+ }
176
+ /** pending → running. Возвращает false, если запуск не найден. */
177
+ export function startRun(id, startedAt = nowIso()) {
178
+ return withTransaction(() => {
179
+ const run = getRun(id);
180
+ if (!run)
181
+ return false;
182
+ assertTransition("run", run.status, "running", RUN_TRANSITIONS[run.status]);
183
+ getDb()
184
+ .prepare("UPDATE runs SET status = 'running', started_at = ?, updated_at = ? WHERE id = ?")
185
+ .run(startedAt, nowIso(), id);
186
+ return true;
187
+ });
188
+ }
189
+ /** Завершает запуск (passed/failed/cancelled) и фиксирует finished_at. */
190
+ export function finishRun(id, status, options = {}) {
191
+ return withTransaction(() => {
192
+ const run = getRun(id);
193
+ if (!run)
194
+ return false;
195
+ assertTransition("run", run.status, status, RUN_TRANSITIONS[run.status]);
196
+ const timestamp = nowIso();
197
+ getDb()
198
+ .prepare("UPDATE runs SET status = ?, finished_at = ?, error = ?, updated_at = ? WHERE id = ?")
199
+ .run(status, timestamp, options.error ?? null, timestamp, id);
200
+ return true;
201
+ });
202
+ }
203
+ /**
204
+ * failed → running: возобновление прогона после краха (36.2).
205
+ *
206
+ * Разрешено только из failed и не сбрасывает номера попыток шагов —
207
+ * они растут через `retryStep` при повторе конкретного шага.
208
+ */
209
+ export function reopenRun(id, startedAt = nowIso()) {
210
+ return withTransaction(() => {
211
+ const run = getRun(id);
212
+ if (!run)
213
+ return false;
214
+ assertTransition("run", run.status, "running", RUN_TRANSITIONS[run.status]);
215
+ getDb()
216
+ .prepare(`UPDATE runs SET status = 'running', started_at = COALESCE(started_at, ?),
217
+ finished_at = NULL, error = NULL, updated_at = ? WHERE id = ?`)
218
+ .run(startedAt, nowIso(), id);
219
+ return true;
220
+ });
221
+ }
222
+ export function getStepById(id) {
223
+ const row = getDb().prepare("SELECT * FROM run_steps WHERE id = ?").get(id);
224
+ return row ? stepRowToRecord(row) : undefined;
225
+ }
226
+ /** Шаг по имени внутри запуска (имя уникально). */
227
+ export function getStep(runId, stepName) {
228
+ const row = getDb()
229
+ .prepare("SELECT * FROM run_steps WHERE run_id = ? AND step_name = ?")
230
+ .get(runId, stepName);
231
+ return row ? stepRowToRecord(row) : undefined;
232
+ }
233
+ /** Все шаги запуска в порядке создания. */
234
+ export function listRunSteps(runId) {
235
+ return getDb()
236
+ .prepare("SELECT * FROM run_steps WHERE run_id = ? ORDER BY position ASC, rowid ASC")
237
+ .all(runId)
238
+ .map(stepRowToRecord);
239
+ }
240
+ /** Поиск шага по ключу идемпотентности (36.3) в пределах запуска. */
241
+ export function findStepByIdempotencyKey(runId, idempotencyKey) {
242
+ const row = getDb()
243
+ .prepare("SELECT * FROM run_steps WHERE run_id = ? AND idempotency_key = ? LIMIT 1")
244
+ .get(runId, idempotencyKey);
245
+ return row ? stepRowToRecord(row) : undefined;
246
+ }
247
+ /** pending → running. Возвращает false, если шаг не найден. */
248
+ export function startStep(id, startedAt = nowIso()) {
249
+ return withTransaction(() => {
250
+ const step = getStepById(id);
251
+ if (!step)
252
+ return false;
253
+ assertTransition("step", step.status, "running", STEP_TRANSITIONS[step.status]);
254
+ getDb()
255
+ .prepare(`UPDATE run_steps SET status = 'running', started_at = ?, finished_at = NULL,
256
+ error = NULL, updated_at = ? WHERE id = ?`)
257
+ .run(startedAt, nowIso(), id);
258
+ return true;
259
+ });
260
+ }
261
+ /** running → passed/failed; pending → skipped допустим. */
262
+ export function finishStep(id, status, options = {}) {
263
+ return withTransaction(() => {
264
+ const step = getStepById(id);
265
+ if (!step)
266
+ return false;
267
+ assertTransition("step", step.status, status, STEP_TRANSITIONS[step.status]);
268
+ const timestamp = nowIso();
269
+ getDb()
270
+ .prepare(`UPDATE run_steps SET status = ?, finished_at = ?, error = ?, output_json = ?,
271
+ updated_at = ? WHERE id = ?`)
272
+ .run(status, timestamp, options.error ?? null, options.output === undefined ? null : serializeJson(options.output), timestamp, id);
273
+ return true;
274
+ });
275
+ }
276
+ /**
277
+ * Повтор упавшего шага: failed → running, attempt + 1.
278
+ *
279
+ * Это единственный переход из финального статуса шага. Предыдущая попытка
280
+ * остаётся видимой в счётчике attempt; для 36.4 (DLQ) здесь появится лимит.
281
+ */
282
+ export function retryStep(id, startedAt = nowIso()) {
283
+ return withTransaction(() => {
284
+ const step = getStepById(id);
285
+ if (!step)
286
+ return false;
287
+ if (step.status !== "failed") {
288
+ throw new InvalidTransitionError("step", step.status, "running");
289
+ }
290
+ getDb()
291
+ .prepare(`UPDATE run_steps SET status = 'running', attempt = attempt + 1,
292
+ started_at = ?, finished_at = NULL, error = NULL, updated_at = ? WHERE id = ?`)
293
+ .run(startedAt, nowIso(), id);
294
+ return true;
295
+ });
296
+ }
297
+ /** Количество шагов запуска (для health/отчётов). */
298
+ export function countRunSteps(runId) {
299
+ const row = getDb()
300
+ .prepare("SELECT COUNT(*) AS count FROM run_steps WHERE run_id = ?")
301
+ .get(runId);
302
+ return Number(row?.count) || 0;
303
+ }
304
+ /** Удаляет запуск; шаги удаляются каскадом (ON DELETE CASCADE). */
305
+ export function deleteRun(id) {
306
+ const result = getDb().prepare("DELETE FROM runs WHERE id = ?").run(id);
307
+ return Number(result.changes) > 0;
308
+ }
309
+ /** Готова ли схема к работе с durable DAG (runs + run_steps). */
310
+ export function isRunStateReady() {
311
+ const rows = getDb()
312
+ .prepare("SELECT name FROM sqlite_master WHERE type = 'table' AND name IN ('runs', 'run_steps')")
313
+ .all();
314
+ return rows.length === 2;
315
+ }
316
+ /** Терминальный ли статус шага (для resume/cleanup в следующих подзадачах). */
317
+ export function isTerminalStepStatus(status) {
318
+ return TERMINAL_STEP_STATUSES.has(status);
319
+ }
@@ -0,0 +1,38 @@
1
+ /**
2
+ * Схема БД планировщика (Спринт 12 + workspaces из Спринта 13).
3
+ *
4
+ * Все таблицы создаются идемпотентно (IF NOT EXISTS), поэтому schema.ts можно
5
+ * безопасно выполнять при каждом открытии соединения — это же служит
6
+ * механизмом «мини-миграций» при обновлении плагина.
7
+ */
8
+ export declare const SCHEMA_SQL = "\nCREATE TABLE IF NOT EXISTS tasks (\n name TEXT PRIMARY KEY,\n definition_json TEXT NOT NULL,\n created_at TEXT NOT NULL,\n updated_at TEXT NOT NULL,\n matrix_parent_id TEXT,\n is_matrix_parent INTEGER DEFAULT 0\n);\n\nCREATE TABLE IF NOT EXISTS history (\n id INTEGER PRIMARY KEY AUTOINCREMENT,\n task_name TEXT NOT NULL,\n status TEXT NOT NULL,\n started_at TEXT NOT NULL,\n finished_at TEXT,\n duration_ms INTEGER,\n error TEXT,\n tokens INTEGER,\n cost_usd REAL,\n model TEXT,\n pre_flight_status TEXT,\n post_flight_status TEXT,\n next_task TEXT,\n workspace_id TEXT,\n allowed_tools TEXT,\n denied_tools TEXT\n);\n\nCREATE INDEX IF NOT EXISTS idx_history_task ON history(task_name, started_at DESC);\n\nCREATE TABLE IF NOT EXISTS metrics (\n task_name TEXT PRIMARY KEY,\n total INTEGER DEFAULT 0,\n success INTEGER DEFAULT 0,\n error INTEGER DEFAULT 0,\n partial INTEGER DEFAULT 0,\n total_tokens INTEGER DEFAULT 0,\n total_cost REAL DEFAULT 0\n);\n\nCREATE TABLE IF NOT EXISTS templates (\n id TEXT PRIMARY KEY,\n name TEXT NOT NULL,\n definition_json TEXT NOT NULL\n);\n\nCREATE TABLE IF NOT EXISTS settings (\n key TEXT PRIMARY KEY,\n value_json TEXT NOT NULL\n);\n\nCREATE TABLE IF NOT EXISTS workspaces (\n id TEXT PRIMARY KEY,\n name TEXT NOT NULL,\n path TEXT NOT NULL UNIQUE,\n git_remote TEXT,\n color TEXT,\n env_json TEXT,\n env_file TEXT,\n created_at TEXT NOT NULL\n);\n\nCREATE TABLE IF NOT EXISTS audit_log (\n id INTEGER PRIMARY KEY AUTOINCREMENT,\n ts TEXT NOT NULL,\n action TEXT NOT NULL,\n target_type TEXT,\n target TEXT,\n actor TEXT NOT NULL,\n source TEXT,\n details_json TEXT,\n remote TEXT\n);\n\nCREATE INDEX IF NOT EXISTS idx_audit_ts ON audit_log(ts DESC);\nCREATE INDEX IF NOT EXISTS idx_audit_action ON audit_log(action, ts DESC);\n\n-- \u0421\u043F\u0440\u0438\u043D\u0442 27: \u043F\u043E\u0441\u043B\u0435\u0434\u043D\u0438\u0439 \u043E\u0431\u0440\u0430\u0431\u043E\u0442\u0430\u043D\u043D\u044B\u0439 \u043A\u043E\u043C\u043C\u0438\u0442 \u0434\u043B\u044F git-\u0442\u0440\u0438\u0433\u0433\u0435\u0440\u043E\u0432.\nCREATE TABLE IF NOT EXISTS git_state (\n task_name TEXT PRIMARY KEY,\n commit_sha TEXT NOT NULL,\n branch TEXT,\n updated_at TEXT NOT NULL\n);\n\n-- \u0421\u043F\u0440\u0438\u043D\u0442 31.2: \u0434\u0435\u0434\u0443\u043F \u0443\u0432\u0435\u0434\u043E\u043C\u043B\u0435\u043D\u0438\u0439 (\u043E\u0442\u0441\u043B\u0435\u0436\u0438\u0432\u0430\u043D\u0438\u0435 \u043F\u043E\u0432\u0442\u043E\u0440\u043E\u0432 \u043C\u0435\u0436\u0434\u0443 \u043F\u0440\u043E\u0446\u0435\u0441\u0441\u0430\u043C\u0438).\nCREATE TABLE IF NOT EXISTS notification_dedup (\n key TEXT PRIMARY KEY,\n task_name TEXT NOT NULL,\n status TEXT NOT NULL,\n count INTEGER NOT NULL DEFAULT 1,\n first_at TEXT NOT NULL,\n last_at TEXT NOT NULL,\n window_minutes INTEGER NOT NULL DEFAULT 60\n);\n\nCREATE INDEX IF NOT EXISTS idx_notification_dedup_key ON notification_dedup(key);\nCREATE INDEX IF NOT EXISTS idx_notification_dedup_last_at ON notification_dedup(last_at);\n\n-- \u0412\u0435\u043A\u0442\u043E\u0440\u044B \u0441\u043E\u043E\u0431\u0449\u0435\u043D\u0438\u0439 \u0434\u043B\u044F \u0441\u0435\u043C\u0430\u043D\u0442\u0438\u0447\u0435\u0441\u043A\u043E\u0433\u043E \u0434\u0435\u0434\u0443\u043F\u0430 (\u0421\u043F\u0440\u0438\u043D\u0442 31.1).\n-- \u0425\u0440\u0430\u043D\u044F\u0442\u0441\u044F \u043D\u043E\u0440\u043C\u0430\u043B\u0438\u0437\u043E\u0432\u0430\u043D\u043D\u044B\u0435 \u044D\u043C\u0431\u0435\u0434\u0434\u0438\u043D\u0433\u0438 (JSON-\u043C\u0430\u0441\u0441\u0438\u0432 \u0447\u0438\u0441\u0435\u043B) \u0438 \u0442\u0435\u043A\u0441\u0442 \u0441\u043E\u043E\u0431\u0449\u0435\u043D\u0438\u044F.\n-- \u0421\u0440\u0430\u0432\u043D\u0435\u043D\u0438\u0435 \u043F\u043E \u043A\u043E\u0441\u0438\u043D\u0443\u0441\u0443 \u0431\u0440\u0443\u0442\u0444\u043E\u0440\u0441\u043E\u043C \u043F\u043E \u0432\u0441\u0435\u043C \u0432\u0435\u043A\u0442\u043E\u0440\u0430\u043C \u0432 \u043E\u043A\u043D\u0435.\nCREATE TABLE IF NOT EXISTS notification_embeddings (\n key TEXT PRIMARY KEY,\n task_name TEXT NOT NULL,\n status TEXT NOT NULL,\n message_text TEXT NOT NULL,\n embedding_json TEXT NOT NULL,\n dimension INTEGER NOT NULL,\n created_at TEXT NOT NULL,\n window_minutes INTEGER NOT NULL DEFAULT 60\n);\n\nCREATE INDEX IF NOT EXISTS idx_notification_embeddings_task ON notification_embeddings(task_name, created_at DESC);\nCREATE INDEX IF NOT EXISTS idx_notification_embeddings_created ON notification_embeddings(created_at DESC);\n\n-- \u0421\u043F\u0440\u0438\u043D\u0442 36.1 (durable DAG): \u0437\u0430\u043F\u0443\u0441\u043A \u043A\u0430\u043A \u0435\u0434\u0438\u043D\u0438\u0446\u0430 \u0432\u044B\u043F\u043E\u043B\u043D\u0435\u043D\u0438\u044F.\n-- \u0421\u0442\u0440\u043E\u043A\u0430 \u0441\u043E\u0437\u0434\u0430\u0451\u0442\u0441\u044F \u0434\u043E \u0441\u0442\u0430\u0440\u0442\u0430 \u0448\u0430\u0433\u043E\u0432 \u0438 \u043F\u0435\u0440\u0435\u0436\u0438\u0432\u0430\u0435\u0442 \u0441\u0431\u043E\u0439 \u043F\u0440\u043E\u0446\u0435\u0441\u0441\u0430 \u2014 \u044D\u0442\u043E \u043E\u0441\u043D\u043E\u0432\u0430\n-- \u0434\u043B\u044F resume \u0432 36.2. \u0421\u0442\u0430\u0442\u0443\u0441\u044B: pending \u2192 running \u2192 passed/failed/cancelled.\nCREATE TABLE IF NOT EXISTS runs (\n id TEXT PRIMARY KEY,\n task_name TEXT NOT NULL,\n status TEXT NOT NULL,\n parent_run_id TEXT,\n workspace_id TEXT,\n started_at TEXT,\n finished_at TEXT,\n error TEXT,\n metadata_json TEXT,\n created_at TEXT NOT NULL,\n updated_at TEXT NOT NULL\n);\n\nCREATE INDEX IF NOT EXISTS idx_runs_task ON runs(task_name, started_at DESC);\nCREATE INDEX IF NOT EXISTS idx_runs_status ON runs(status, started_at DESC);\n\n-- \u0421\u043F\u0440\u0438\u043D\u0442 36.1: \u0448\u0430\u0433 \u0437\u0430\u043F\u0443\u0441\u043A\u0430. \u041F\u043E\u043B\u0435 attempt \u043F\u043E\u0437\u0432\u043E\u043B\u044F\u0435\u0442 \u043F\u043E\u0432\u0442\u043E\u0440\u0438\u0442\u044C \u0448\u0430\u0433, \u043D\u0435 \u0442\u0435\u0440\u044F\u044F\n-- \u0438\u0441\u0442\u043E\u0440\u0438\u044E \u043F\u0440\u0435\u0434\u044B\u0434\u0443\u0449\u0438\u0445 \u043F\u043E\u043F\u044B\u0442\u043E\u043A; idempotency_key \u0437\u0430\u0449\u0438\u0449\u0430\u0435\u0442 \u043E\u0442 \u043F\u043E\u0432\u0442\u043E\u0440\u043D\u043E\u0433\u043E\n-- \u0432\u044B\u043F\u043E\u043B\u043D\u0435\u043D\u0438\u044F \u0442\u043E\u0433\u043E \u0436\u0435 \u0448\u0430\u0433\u0430 (36.3). \u0421\u0442\u0430\u0442\u0443\u0441\u044B: pending \u2192 running \u2192 passed/failed/skipped.\nCREATE TABLE IF NOT EXISTS run_steps (\n id TEXT PRIMARY KEY,\n run_id TEXT NOT NULL REFERENCES runs(id) ON DELETE CASCADE,\n step_name TEXT NOT NULL,\n -- \u041F\u043E\u0440\u044F\u0434\u043E\u043A \u0448\u0430\u0433\u0430 \u0432 \u043B\u0438\u043D\u0435\u0439\u043D\u043E\u0439 \u0446\u0435\u043F\u043E\u0447\u043A\u0435 (36.2): 0, 1, 2... \u0421\u0442\u0430\u0431\u0438\u043B\u0435\u043D \u0434\u043B\u044F resume.\n position INTEGER NOT NULL DEFAULT 0,\n status TEXT NOT NULL,\n attempt INTEGER NOT NULL DEFAULT 1,\n idempotency_key TEXT,\n started_at TEXT,\n finished_at TEXT,\n error TEXT,\n output_json TEXT,\n created_at TEXT NOT NULL,\n updated_at TEXT NOT NULL,\n UNIQUE(run_id, step_name)\n);\n\nCREATE INDEX IF NOT EXISTS idx_run_steps_run ON run_steps(run_id, created_at);\nCREATE INDEX IF NOT EXISTS idx_run_steps_status ON run_steps(status);\nCREATE INDEX IF NOT EXISTS idx_run_steps_key ON run_steps(run_id, idempotency_key);\n";
9
+ interface SchemaDb {
10
+ exec(sql: string): void;
11
+ prepare(sql: string): {
12
+ all(): unknown[];
13
+ };
14
+ }
15
+ /**
16
+ * Текущая версия схемы БД (`PRAGMA user_version`).
17
+ *
18
+ * Версия пишется в заголовок SQLite-файла без отдельной таблицы, поэтому
19
+ * переживает пересоздание соединения и видна до применения каких-либо
20
+ * миграций. Увеличивайте при добавлении новой ступени в {@link MIGRATIONS}
21
+ * и добавляйте соответствующую запись в массив.
22
+ */
23
+ export declare const SCHEMA_VERSION = 3;
24
+ /** Возвращает сохранённую версию схемы (0 у legacy-БД без user_version). */
25
+ export declare function getSchemaVersion(db: SchemaDb): number;
26
+ /**
27
+ * Применяет схему к открытому соединению.
28
+ *
29
+ * CREATE TABLE IF NOT EXISTS не добавляет новые колонки в уже существующие
30
+ * таблицы, поэтому структурные изменения идут отдельными ступенями миграции
31
+ * после проверки PRAGMA table_info. Это безопасно и для старых БД Спринта 12.
32
+ *
33
+ * После успешных миграций версия фиксируется в `PRAGMA user_version`, чтобы
34
+ * будущие ступени могли выполняться инкрементально, а не перебирать колонки.
35
+ */
36
+ export declare function applySchema(db: SchemaDb): void;
37
+ export {};
38
+ //# sourceMappingURL=schema.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../src/db/schema.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,eAAO,MAAM,UAAU,y5OAiKtB,CAAC;AAEF,UAAU,QAAQ;IAChB,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG;QAAE,GAAG,IAAI,OAAO,EAAE,CAAA;KAAE,CAAC;CAC5C;AAED;;;;;;;GAOG;AACH,eAAO,MAAM,cAAc,IAAI,CAAC;AAEhC,4EAA4E;AAC5E,wBAAgB,gBAAgB,CAAC,EAAE,EAAE,QAAQ,GAAG,MAAM,CAIrD;AAiID;;;;;;;;;GASG;AACH,wBAAgB,WAAW,CAAC,EAAE,EAAE,QAAQ,GAAG,IAAI,CAmB9C"}