agent-steward 0.0.3 → 0.0.5

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (287) hide show
  1. package/CHANGELOG.md +154 -2
  2. package/CROSS_PLATFORM.md +19 -0
  3. package/README.md +54 -9
  4. package/ROADMAP-STRATEGY.md +23 -20
  5. package/ROADMAP.md +140 -143
  6. package/dist/cli.d.ts +3 -0
  7. package/dist/cli.d.ts.map +1 -0
  8. package/dist/cli.js +351 -0
  9. package/dist/core/dlq-api.d.ts +44 -0
  10. package/dist/core/dlq-api.d.ts.map +1 -0
  11. package/dist/core/dlq-api.js +68 -0
  12. package/dist/core/dry-run.d.ts.map +1 -1
  13. package/dist/core/dry-run.js +18 -1
  14. package/dist/core/execution.d.ts +203 -0
  15. package/dist/core/execution.d.ts.map +1 -0
  16. package/dist/core/execution.js +309 -0
  17. package/dist/core/gate-integrity.d.ts +35 -0
  18. package/dist/core/gate-integrity.d.ts.map +1 -0
  19. package/dist/core/gate-integrity.js +132 -0
  20. package/dist/core/git-trigger.d.ts.map +1 -1
  21. package/dist/core/git-trigger.js +14 -2
  22. package/dist/core/guard-run.d.ts +4 -0
  23. package/dist/core/guard-run.d.ts.map +1 -0
  24. package/dist/core/guard-run.js +101 -0
  25. package/dist/core/guard.d.ts +52 -0
  26. package/dist/core/guard.d.ts.map +1 -0
  27. package/dist/core/guard.js +362 -0
  28. package/dist/core/lock.d.ts +61 -4
  29. package/dist/core/lock.d.ts.map +1 -1
  30. package/dist/core/lock.js +213 -26
  31. package/dist/core/matrix.d.ts.map +1 -1
  32. package/dist/core/matrix.js +75 -15
  33. package/dist/core/mission.d.ts +83 -0
  34. package/dist/core/mission.d.ts.map +1 -0
  35. package/dist/core/mission.js +334 -0
  36. package/dist/core/one-shot.d.ts +5 -1
  37. package/dist/core/one-shot.d.ts.map +1 -1
  38. package/dist/core/one-shot.js +33 -8
  39. package/dist/core/opencode-cli.d.ts +28 -0
  40. package/dist/core/opencode-cli.d.ts.map +1 -0
  41. package/dist/core/opencode-cli.js +74 -0
  42. package/dist/core/opencode-models.d.ts +62 -0
  43. package/dist/core/opencode-models.d.ts.map +1 -0
  44. package/dist/core/opencode-models.js +277 -0
  45. package/dist/core/pipeline-apply.d.ts +38 -0
  46. package/dist/core/pipeline-apply.d.ts.map +1 -0
  47. package/dist/core/pipeline-apply.js +117 -0
  48. package/dist/core/pipeline-io.d.ts +13 -0
  49. package/dist/core/pipeline-io.d.ts.map +1 -0
  50. package/dist/core/pipeline-io.js +64 -0
  51. package/dist/core/pipeline-map.d.ts +46 -0
  52. package/dist/core/pipeline-map.d.ts.map +1 -0
  53. package/dist/core/pipeline-map.js +196 -0
  54. package/dist/core/pipeline-spec.d.ts +109 -0
  55. package/dist/core/pipeline-spec.d.ts.map +1 -0
  56. package/dist/core/pipeline-spec.js +554 -0
  57. package/dist/core/ps-wrapper.d.ts +19 -2
  58. package/dist/core/ps-wrapper.d.ts.map +1 -1
  59. package/dist/core/ps-wrapper.js +261 -63
  60. package/dist/core/record-history.d.ts +15 -0
  61. package/dist/core/record-history.d.ts.map +1 -1
  62. package/dist/core/record-history.js +183 -58
  63. package/dist/core/router/dispatch.d.ts +36 -0
  64. package/dist/core/router/dispatch.d.ts.map +1 -0
  65. package/dist/core/router/dispatch.js +59 -0
  66. package/dist/core/router/escalation.d.ts +47 -0
  67. package/dist/core/router/escalation.d.ts.map +1 -0
  68. package/dist/core/router/escalation.js +87 -0
  69. package/dist/core/router/planner.d.ts +53 -0
  70. package/dist/core/router/planner.d.ts.map +1 -0
  71. package/dist/core/router/planner.js +113 -0
  72. package/dist/core/router/rules.d.ts +46 -0
  73. package/dist/core/router/rules.d.ts.map +1 -0
  74. package/dist/core/router/rules.js +91 -0
  75. package/dist/core/run-panel-api.d.ts +94 -0
  76. package/dist/core/run-panel-api.d.ts.map +1 -0
  77. package/dist/core/run-panel-api.js +169 -0
  78. package/dist/core/schedule-gate.js +5 -1
  79. package/dist/core/schedule-v2.d.ts +34 -0
  80. package/dist/core/schedule-v2.d.ts.map +1 -1
  81. package/dist/core/schedule-v2.js +91 -5
  82. package/dist/core/scheduler/at-fallback.d.ts +55 -2
  83. package/dist/core/scheduler/at-fallback.d.ts.map +1 -1
  84. package/dist/core/scheduler/at-fallback.js +135 -5
  85. package/dist/core/scheduler/linux.d.ts +18 -2
  86. package/dist/core/scheduler/linux.d.ts.map +1 -1
  87. package/dist/core/scheduler/linux.js +63 -20
  88. package/dist/core/scheduler/mac.d.ts +44 -2
  89. package/dist/core/scheduler/mac.d.ts.map +1 -1
  90. package/dist/core/scheduler/mac.js +126 -15
  91. package/dist/core/scheduler/posix.d.ts.map +1 -1
  92. package/dist/core/scheduler/posix.js +25 -1
  93. package/dist/core/scheduler/registry.d.ts +11 -0
  94. package/dist/core/scheduler/registry.d.ts.map +1 -1
  95. package/dist/core/scheduler/registry.js +83 -21
  96. package/dist/core/scheduler/run-now.d.ts +16 -0
  97. package/dist/core/scheduler/run-now.d.ts.map +1 -0
  98. package/dist/core/scheduler/run-now.js +28 -0
  99. package/dist/core/scheduler/windows.d.ts.map +1 -1
  100. package/dist/core/scheduler/windows.js +15 -12
  101. package/dist/core/secrets.d.ts.map +1 -1
  102. package/dist/core/secrets.js +125 -28
  103. package/dist/core/session.d.ts.map +1 -1
  104. package/dist/core/session.js +18 -11
  105. package/dist/core/structured-log.d.ts +7 -1
  106. package/dist/core/structured-log.d.ts.map +1 -1
  107. package/dist/core/task-name.d.ts +24 -0
  108. package/dist/core/task-name.d.ts.map +1 -0
  109. package/dist/core/task-name.js +40 -0
  110. package/dist/core/worktree-run.d.ts +4 -0
  111. package/dist/core/worktree-run.d.ts.map +1 -0
  112. package/dist/core/worktree-run.js +164 -0
  113. package/dist/core/worktree.d.ts +115 -0
  114. package/dist/core/worktree.d.ts.map +1 -0
  115. package/dist/core/worktree.js +462 -0
  116. package/dist/core/wrappers/bash.d.ts +17 -0
  117. package/dist/core/wrappers/bash.d.ts.map +1 -1
  118. package/dist/core/wrappers/bash.js +224 -28
  119. package/dist/db/capability-repo.d.ts +124 -0
  120. package/dist/db/capability-repo.d.ts.map +1 -0
  121. package/dist/db/capability-repo.js +267 -0
  122. package/dist/db/history-repo.d.ts +46 -5
  123. package/dist/db/history-repo.d.ts.map +1 -1
  124. package/dist/db/history-repo.js +107 -25
  125. package/dist/db/index.d.ts +4 -0
  126. package/dist/db/index.d.ts.map +1 -1
  127. package/dist/db/index.js +39 -1
  128. package/dist/db/metrics-repo.js +2 -2
  129. package/dist/db/migrate.d.ts.map +1 -1
  130. package/dist/db/migrate.js +3 -1
  131. package/dist/db/recovery.d.ts.map +1 -1
  132. package/dist/db/recovery.js +5 -4
  133. package/dist/db/run-context.d.ts +103 -0
  134. package/dist/db/run-context.d.ts.map +1 -0
  135. package/dist/db/run-context.js +224 -0
  136. package/dist/db/run-dlq.d.ts +100 -0
  137. package/dist/db/run-dlq.d.ts.map +1 -0
  138. package/dist/db/run-dlq.js +191 -0
  139. package/dist/db/run-journal.d.ts +33 -5
  140. package/dist/db/run-journal.d.ts.map +1 -1
  141. package/dist/db/run-journal.js +78 -14
  142. package/dist/db/run-resume.d.ts +10 -2
  143. package/dist/db/run-resume.d.ts.map +1 -1
  144. package/dist/db/run-resume.js +39 -13
  145. package/dist/db/runs-repo.d.ts +32 -7
  146. package/dist/db/runs-repo.d.ts.map +1 -1
  147. package/dist/db/runs-repo.js +50 -11
  148. package/dist/db/schema.d.ts +2 -2
  149. package/dist/db/schema.d.ts.map +1 -1
  150. package/dist/db/schema.js +216 -3
  151. package/dist/db/settings-repo.d.ts +11 -0
  152. package/dist/db/settings-repo.d.ts.map +1 -1
  153. package/dist/db/settings-repo.js +25 -0
  154. package/dist/db/step-idempotency.d.ts +51 -0
  155. package/dist/db/step-idempotency.d.ts.map +1 -0
  156. package/dist/db/step-idempotency.js +136 -0
  157. package/dist/history.d.ts +1 -1
  158. package/dist/history.d.ts.map +1 -1
  159. package/dist/i18n.d.ts +5 -0
  160. package/dist/i18n.d.ts.map +1 -1
  161. package/dist/i18n.js +11 -4
  162. package/dist/index.d.ts +140 -6
  163. package/dist/index.d.ts.map +1 -1
  164. package/dist/index.js +480 -18
  165. package/dist/notifications.d.ts +22 -0
  166. package/dist/notifications.d.ts.map +1 -1
  167. package/dist/notifications.js +36 -8
  168. package/dist/profiles.d.ts.map +1 -1
  169. package/dist/profiles.js +25 -4
  170. package/dist/rpc.d.ts +924 -0
  171. package/dist/rpc.d.ts.map +1 -1
  172. package/dist/rpc.js +352 -0
  173. package/dist/server.d.ts +46 -0
  174. package/dist/server.d.ts.map +1 -1
  175. package/dist/server.js +172 -53
  176. package/dist/settings.d.ts +2 -2
  177. package/dist/settings.d.ts.map +1 -1
  178. package/dist/settings.js +3 -3
  179. package/dist/shared/jobs-view.d.ts +1 -1
  180. package/dist/shared/jobs-view.d.ts.map +1 -1
  181. package/dist/shared/jobs-view.js +2 -0
  182. package/dist/task-transfer.d.ts +16 -0
  183. package/dist/task-transfer.d.ts.map +1 -1
  184. package/dist/task-transfer.js +16 -0
  185. package/dist/types.d.ts.map +1 -1
  186. package/dist/types.js +7 -0
  187. package/dist/workspaces.d.ts +25 -3
  188. package/dist/workspaces.d.ts.map +1 -1
  189. package/dist/workspaces.js +43 -8
  190. package/docs/ARCHITECTURE.md +498 -58
  191. package/docs/COMPATIBILITY.md +2 -2
  192. package/docs/CONCEPT.md +185 -91
  193. package/docs/CROSS_PLATFORM.ru.md +20 -0
  194. package/docs/CROSS_PLATFORM.zh.md +18 -0
  195. package/docs/EXECUTION-LOOP.md +211 -0
  196. package/docs/FEATURES.md +65 -4
  197. package/docs/FEATURES.zh.md +52 -4
  198. package/docs/MIGRATION.md +2 -2
  199. package/docs/PIPELINE.md +293 -0
  200. package/docs/README.ru.md +44 -5
  201. package/docs/README.zh.md +46 -6
  202. package/docs/SAFETY.md +142 -0
  203. package/docs/SAVINGS.md +29 -0
  204. package/docs/SAVINGS.ru.md +29 -0
  205. package/docs/SAVINGS.zh.md +18 -0
  206. package/gui-experimental.cjs +9 -8
  207. package/locales/en.json +84 -1
  208. package/locales/ru.json +84 -1
  209. package/locales/zh.json +84 -1
  210. package/opencode.pipeline.yaml +35 -0
  211. package/package.json +46 -2
  212. package/scripts/audit-bundle.mjs +215 -0
  213. package/scripts/test-home.mjs +83 -0
  214. package/src/cli.ts +412 -0
  215. package/src/core/dlq-api.ts +98 -0
  216. package/src/core/dry-run.ts +27 -3
  217. package/src/core/execution.ts +538 -0
  218. package/src/core/file-watcher.ts +2 -2
  219. package/src/core/gate-integrity.ts +160 -0
  220. package/src/core/git-trigger.ts +18 -5
  221. package/src/core/guard-run.ts +119 -0
  222. package/src/core/guard.ts +431 -0
  223. package/src/core/lock.ts +244 -30
  224. package/src/core/matrix.ts +95 -50
  225. package/src/core/mission.ts +485 -0
  226. package/src/core/native-notify.ts +1 -1
  227. package/src/core/one-shot.ts +36 -8
  228. package/src/core/opencode-cli.ts +103 -0
  229. package/src/core/opencode-models.ts +315 -0
  230. package/src/core/pipeline-apply.ts +158 -0
  231. package/src/core/pipeline-io.ts +79 -0
  232. package/src/core/pipeline-map.ts +264 -0
  233. package/src/core/pipeline-spec.ts +775 -0
  234. package/src/core/ps-wrapper.ts +274 -64
  235. package/src/core/record-history.ts +229 -104
  236. package/src/core/router/dispatch.ts +94 -0
  237. package/src/core/router/escalation.ts +129 -0
  238. package/src/core/router/planner.ts +166 -0
  239. package/src/core/router/rules.ts +115 -0
  240. package/src/core/run-panel-api.ts +262 -0
  241. package/src/core/schedule-gate.ts +7 -3
  242. package/src/core/schedule-v2.ts +114 -5
  243. package/src/core/scheduler/at-fallback.ts +190 -5
  244. package/src/core/scheduler/linux.ts +72 -21
  245. package/src/core/scheduler/logs.ts +2 -2
  246. package/src/core/scheduler/mac.ts +174 -14
  247. package/src/core/scheduler/posix.ts +20 -1
  248. package/src/core/scheduler/registry.ts +107 -26
  249. package/src/core/scheduler/run-now.ts +32 -0
  250. package/src/core/scheduler/windows.ts +19 -15
  251. package/src/core/secrets.ts +131 -31
  252. package/src/core/session.ts +23 -10
  253. package/src/core/structured-log.ts +22 -5
  254. package/src/core/task-name.ts +67 -0
  255. package/src/core/telegram.ts +2 -2
  256. package/src/core/triage-worker.ts +7 -7
  257. package/src/core/triage.ts +2 -2
  258. package/src/core/worktree-run.ts +199 -0
  259. package/src/core/worktree.ts +600 -0
  260. package/src/core/wrappers/bash.ts +239 -27
  261. package/src/db/capability-repo.ts +402 -0
  262. package/src/db/history-repo.ts +151 -22
  263. package/src/db/index.ts +37 -1
  264. package/src/db/metrics-repo.ts +2 -2
  265. package/src/db/migrate.ts +3 -1
  266. package/src/db/recovery.ts +5 -4
  267. package/src/db/run-context.ts +370 -0
  268. package/src/db/run-dlq.ts +310 -0
  269. package/src/db/run-journal.ts +100 -13
  270. package/src/db/run-resume.ts +65 -13
  271. package/src/db/runs-repo.ts +66 -13
  272. package/src/db/schema.ts +218 -3
  273. package/src/db/settings-repo.ts +31 -0
  274. package/src/db/step-idempotency.ts +185 -0
  275. package/src/gui.tsx +692 -13
  276. package/src/history.ts +1 -1
  277. package/src/i18n.ts +12 -4
  278. package/src/index.ts +648 -8
  279. package/src/notifications.ts +38 -8
  280. package/src/profiles.ts +26 -4
  281. package/src/rpc.ts +379 -0
  282. package/src/server.ts +206 -54
  283. package/src/settings.ts +5 -5
  284. package/src/shared/jobs-view.ts +3 -1
  285. package/src/task-transfer.ts +31 -0
  286. package/src/types.ts +9 -0
  287. package/src/workspaces.ts +58 -9
@@ -0,0 +1,402 @@
1
+ import { normalizeTaskType } from "../core/router/rules.js";
2
+ import { getDb, withTransaction } from "./index.js";
3
+
4
+ /**
5
+ * Capability Map — слой 2 роутера (Спринт 36.5.b).
6
+ *
7
+ * Таблица `capability_map` хранит, как исполнитель справлялся с типом задачи:
8
+ * сколько запусков было, сколько прошло гейт, среднюю стоимость и время, а
9
+ * также последние 10 исходов. Роутер читает карту и выбирает маршрут
10
+ * (local / cloud / review) по порогам — без вызова модели, то есть 0 токенов
11
+ * на само решение.
12
+ *
13
+ * Карта обучается на исходах гейта: каждый прогон шага вызывает
14
+ * {@link recordCapabilityOutcome}, статистика обновляется скользящим средним.
15
+ * Данных мало — карта честно говорит «не знаю» и отдаёт решение слою 3
16
+ * (Explore-режим).
17
+ */
18
+
19
+ /** Куда исполнять шаг. `review` — данных достаточно, но успех нестабилен. */
20
+ export type CapabilityTarget = "local" | "cloud" | "review" | "explore";
21
+
22
+ /** Порог, выше которого шаг считается надёжным для локали. */
23
+ export const LOCAL_SUCCESS_THRESHOLD = 0.85;
24
+
25
+ /** Порог, ниже которого локальный исполнитель считается безнадёжным. */
26
+ export const CLOUD_FAILURE_THRESHOLD = 0.3;
27
+
28
+ /** Минимум исходов, чтобы карта вообще бралась судить. */
29
+ export const MIN_RUNS_FOR_DECISION = 3;
30
+
31
+ /** Сколько последних исходов хранить (1 — гейт пройден, 0 — провал). */
32
+ export const RECENT_RUNS_LIMIT = 10;
33
+
34
+ /**
35
+ * B13: полураспад веса исхода в последних прогонах. Исход давностью
36
+ * `SUCCESS_HALF_LIFE_RUNS` прогонов весит вдвое меньше свежего.
37
+ */
38
+ export const SUCCESS_HALF_LIFE_RUNS = 8;
39
+
40
+ /** B13: доля затухающего success rate в итоговой надёжности. */
41
+ export const DECAY_WEIGHT = 0.7;
42
+
43
+ /** B13: доля first-pass rate в итоговой надёжности. */
44
+ export const FIRST_PASS_WEIGHT = 0.3;
45
+
46
+ export interface CapabilityRecord {
47
+ taskType: string;
48
+ /** Исполнитель, который последним обрабатывал тип задачи. */
49
+ model: string;
50
+ runsTotal: number;
51
+ runsPassed: number;
52
+ /** B13: сколько успехов получено с первой попытки. */
53
+ firstPassCount: number;
54
+ /** B13: first_pass_count / runs_total. */
55
+ firstPassRate: number;
56
+ successRate: number;
57
+ /** B13: success rate последних прогонов с экспоненциальным затуханием. */
58
+ decayedSuccessRate: number;
59
+ /** B13: 0.7 * decayedSuccessRate + 0.3 * firstPassRate — вход маршрутизации. */
60
+ effectiveSuccessRate: number;
61
+ avgCostUsd: number;
62
+ avgTimeMs: number;
63
+ /** Последние исходы, старые слева, новые справа, максимум 10. */
64
+ last10Runs: number[];
65
+ createdAt: string;
66
+ updatedAt: string;
67
+ }
68
+
69
+ /** Один исход гейта: пройден/провален + необязательные стоимость и время. */
70
+ export interface CapabilityOutcome {
71
+ taskType: string;
72
+ model?: string;
73
+ passed: boolean;
74
+ costUsd?: number;
75
+ timeMs?: number;
76
+ /** B13: число попыток до исхода (1 — с первой). */
77
+ attempts?: number;
78
+ /** B13: явный признак first-pass; по умолчанию passed && attempts <= 1. */
79
+ firstPass?: boolean;
80
+ }
81
+
82
+ export interface CapabilityThresholds {
83
+ localSuccess?: number;
84
+ cloudFailure?: number;
85
+ minRuns?: number;
86
+ }
87
+
88
+ export interface CapabilityDecision {
89
+ taskType: string;
90
+ target: CapabilityTarget;
91
+ /** Машиночитаемая причина: no-data | local-reliable | escalate | review. */
92
+ reason: "no-data" | "local-reliable" | "escalate" | "review";
93
+ successRate: number;
94
+ /** B13: надёжность с учётом затухания и first-pass, по ней принимается решение. */
95
+ effectiveSuccessRate: number;
96
+ /** B13: затухающий success rate последних прогонов. */
97
+ decayedSuccessRate: number;
98
+ /** B13: доля успехов с первой попытки. */
99
+ firstPassRate: number;
100
+ runsTotal: number;
101
+ capability: CapabilityRecord | null;
102
+ }
103
+
104
+ const DEFAULT_MODEL = "local";
105
+
106
+ function nowIso(): string {
107
+ return new Date().toISOString();
108
+ }
109
+
110
+ function requireTaskType(taskType: string): string {
111
+ if (typeof taskType !== "string" || taskType.trim() === "") {
112
+ throw new Error("Пустой тип задачи: Capability Map требует непустой taskType.");
113
+ }
114
+ return normalizeTaskType(taskType);
115
+ }
116
+
117
+ function requireNonNegative(value: number, field: string): number {
118
+ if (!Number.isFinite(value) || value < 0) {
119
+ throw new Error(`Некорректное значение ${field}: ожидалось неотрицательное число, получено ${value}.`);
120
+ }
121
+ return value;
122
+ }
123
+
124
+ /** B13: номер попытки — целое ≥ 1. */
125
+ function requireAttempts(value: number): number {
126
+ if (!Number.isInteger(value) || value < 1) {
127
+ throw new Error(`Некорректное значение attempts: ожидалось целое ≥ 1, получено ${value}.`);
128
+ }
129
+ return value;
130
+ }
131
+
132
+ function parseRecentRuns(raw: unknown): number[] {
133
+ if (typeof raw !== "string" || raw.trim() === "") {
134
+ return [];
135
+ }
136
+ try {
137
+ const parsed: unknown = JSON.parse(raw);
138
+ if (!Array.isArray(parsed)) {
139
+ return [];
140
+ }
141
+ return parsed
142
+ .map((value) => (typeof value === "number" ? value : Number(value)))
143
+ .filter((value) => value === 0 || value === 1)
144
+ .slice(-RECENT_RUNS_LIMIT);
145
+ } catch {
146
+ return [];
147
+ }
148
+ }
149
+
150
+ /**
151
+ * B13: экспоненциально взвешенный success rate последних исходов.
152
+ *
153
+ * Свежий исход весит 1, исход давностью `halfLife` прогонов — 0.5.
154
+ * Так старые успехи не перевешивают свежие провалы, а `last_10_runs`
155
+ * участвует в решении, а не только хранится для отчёта.
156
+ */
157
+ export function decayedSuccessRate(
158
+ runs: number[],
159
+ halfLife: number = SUCCESS_HALF_LIFE_RUNS,
160
+ ): number {
161
+ const recent = runs
162
+ .filter((value) => value === 0 || value === 1)
163
+ .slice(-RECENT_RUNS_LIMIT);
164
+ if (recent.length === 0) return 0;
165
+ const hl = Number.isFinite(halfLife) && halfLife > 0 ? halfLife : SUCCESS_HALF_LIFE_RUNS;
166
+ let weighted = 0;
167
+ let weights = 0;
168
+ recent.forEach((value, index) => {
169
+ const age = recent.length - 1 - index;
170
+ const weight = Math.pow(0.5, age / hl);
171
+ weighted += weight * value;
172
+ weights += weight;
173
+ });
174
+ return weights > 0 ? weighted / weights : 0;
175
+ }
176
+
177
+ /** B13: надёжность для маршрутизации — затухание плюс успех с первой попытки. */
178
+ export function effectiveReliability(decayedRate: number, firstPassRate: number): number {
179
+ const decayed = Math.min(1, Math.max(0, decayedRate));
180
+ const firstPass = Math.min(1, Math.max(0, firstPassRate));
181
+ return DECAY_WEIGHT * decayed + FIRST_PASS_WEIGHT * firstPass;
182
+ }
183
+
184
+ function rowToRecord(row: Record<string, unknown>): CapabilityRecord {
185
+ const runsTotal = Number(row.runs_total) || 0;
186
+ const runsPassed = Number(row.runs_passed) || 0;
187
+ const successRate =
188
+ Number(row.success_rate) || (runsTotal > 0 ? runsPassed / runsTotal : 0);
189
+ const firstPassCount = Number(row.first_pass_count) || 0;
190
+ const firstPassRate =
191
+ runsTotal > 0 ? Math.min(1, firstPassCount / runsTotal) : 0;
192
+ const last10Runs = parseRecentRuns(row.last_10_runs);
193
+ const decayed =
194
+ last10Runs.length > 0 ? decayedSuccessRate(last10Runs) : successRate;
195
+ return {
196
+ taskType: String(row.task_type),
197
+ model: String(row.model ?? DEFAULT_MODEL),
198
+ runsTotal,
199
+ runsPassed,
200
+ firstPassCount,
201
+ firstPassRate,
202
+ successRate,
203
+ decayedSuccessRate: decayed,
204
+ effectiveSuccessRate: effectiveReliability(decayed, firstPassRate),
205
+ avgCostUsd: Number(row.avg_cost_usd) || 0,
206
+ avgTimeMs: Number(row.avg_time_ms) || 0,
207
+ last10Runs,
208
+ createdAt: String(row.created_at),
209
+ updatedAt: String(row.updated_at),
210
+ };
211
+ }
212
+
213
+ /** Читает статистику по типу задачи или `null`, если данных ещё нет. */
214
+ export function getCapability(taskType: string): CapabilityRecord | null {
215
+ const key = requireTaskType(taskType);
216
+ const row = getDb()
217
+ .prepare("SELECT * FROM capability_map WHERE task_type = ?")
218
+ .get(key) as Record<string, unknown> | undefined;
219
+ return row ? rowToRecord(row) : null;
220
+ }
221
+
222
+ /** Все известные типы задач, сначала самые надёжные. */
223
+ export function listCapabilities(limit = 100): CapabilityRecord[] {
224
+ const capped = Math.max(1, Math.floor(limit));
225
+ const rows = getDb()
226
+ .prepare("SELECT * FROM capability_map ORDER BY success_rate DESC, runs_total DESC, task_type ASC LIMIT ?")
227
+ .all(capped) as Record<string, unknown>[];
228
+ return rows.map(rowToRecord);
229
+ }
230
+
231
+ /**
232
+ * Записывает исход гейта и обновляет статистику скользящим средним.
233
+ *
234
+ * Возвращает актуальную запись карты — её же удобно логировать вместе с
235
+ * решением роутера, чтобы видеть, на каких данных он остановился.
236
+ */
237
+ export function recordCapabilityOutcome(outcome: CapabilityOutcome): CapabilityRecord {
238
+ const key = requireTaskType(outcome.taskType);
239
+ if (typeof outcome.passed !== "boolean") {
240
+ throw new Error("Исход гейта должен быть boolean (passed).");
241
+ }
242
+ const cost = outcome.costUsd === undefined ? 0 : requireNonNegative(outcome.costUsd, "costUsd");
243
+ const time = outcome.timeMs === undefined ? 0 : requireNonNegative(outcome.timeMs, "timeMs");
244
+ const model = (outcome.model ?? DEFAULT_MODEL).trim() || DEFAULT_MODEL;
245
+ const passed = outcome.passed ? 1 : 0;
246
+ const attempts = outcome.attempts === undefined ? undefined : requireAttempts(outcome.attempts);
247
+ if (outcome.firstPass !== undefined && typeof outcome.firstPass !== "boolean") {
248
+ throw new Error("Признак firstPass должен быть boolean.");
249
+ }
250
+ // B13: без явного признака успех считается первым, если попытка одна
251
+ // (или число попыток не передано — обратная совместимость).
252
+ const firstPass =
253
+ passed === 1 &&
254
+ (outcome.firstPass ?? (attempts === undefined || attempts === 1));
255
+ const firstPassIncrement = firstPass ? 1 : 0;
256
+
257
+ return withTransaction(() => {
258
+ const db = getDb();
259
+ const timestamp = nowIso();
260
+ const existing = getCapability(key);
261
+ if (!existing) {
262
+ db.prepare(
263
+ `INSERT INTO capability_map (
264
+ task_type, model, runs_total, runs_passed, first_pass_count, success_rate,
265
+ avg_cost_usd, avg_time_ms, last_10_runs, created_at, updated_at
266
+ ) VALUES (?, ?, 1, ?, ?, ?, ?, ?, ?, ?, ?)`,
267
+ ).run(
268
+ key,
269
+ model,
270
+ passed,
271
+ firstPassIncrement,
272
+ passed,
273
+ cost,
274
+ time,
275
+ JSON.stringify([passed]),
276
+ timestamp,
277
+ timestamp,
278
+ );
279
+ } else {
280
+ const runsTotal = existing.runsTotal + 1;
281
+ const runsPassed = existing.runsPassed + passed;
282
+ const avgCost = (existing.avgCostUsd * existing.runsTotal + cost) / runsTotal;
283
+ const avgTime = (existing.avgTimeMs * existing.runsTotal + time) / runsTotal;
284
+ const recent = [...existing.last10Runs, passed].slice(-RECENT_RUNS_LIMIT);
285
+ db.prepare(
286
+ `UPDATE capability_map
287
+ SET model = ?, runs_total = ?, runs_passed = ?,
288
+ first_pass_count = COALESCE(first_pass_count, 0) + ?,
289
+ success_rate = ?, avg_cost_usd = ?, avg_time_ms = ?,
290
+ last_10_runs = ?, updated_at = ?
291
+ WHERE task_type = ?`,
292
+ ).run(
293
+ model,
294
+ runsTotal,
295
+ runsPassed,
296
+ firstPassIncrement,
297
+ runsPassed / runsTotal,
298
+ avgCost,
299
+ avgTime,
300
+ JSON.stringify(recent),
301
+ timestamp,
302
+ key,
303
+ );
304
+ }
305
+ const record = getCapability(key);
306
+ if (!record) {
307
+ throw new Error(`Capability Map: запись для ${key} не сохранилась.`);
308
+ }
309
+ return record;
310
+ });
311
+ }
312
+
313
+ /**
314
+ * Решение слоя 2 по порогам (0 токенов).
315
+ *
316
+ * Пороги применяются к `effectiveSuccessRate` — 0.7 затухающего success rate
317
+ * последних прогонов плюс 0.3 first-pass rate (B13), а не к кумулятивному
318
+ * success rate. Поэтому старые успехи не перевешивают свежие провалы.
319
+ *
320
+ * - данных меньше `minRuns` → `explore` (решает слой 3);
321
+ * - `effectiveSuccessRate ≥ 0.85` → `local`;
322
+ * - `effectiveSuccessRate ≤ 0.30` → `cloud` (эскалация);
323
+ * - между порогами → `review` (нужен человек или облачный ревьюер).
324
+ */
325
+ export function decideCapabilityRoute(
326
+ taskType: string,
327
+ thresholds: CapabilityThresholds = {},
328
+ ): CapabilityDecision {
329
+ const key = requireTaskType(taskType);
330
+ const localSuccess = thresholds.localSuccess ?? LOCAL_SUCCESS_THRESHOLD;
331
+ const cloudFailure = thresholds.cloudFailure ?? CLOUD_FAILURE_THRESHOLD;
332
+ const minRuns = thresholds.minRuns ?? MIN_RUNS_FOR_DECISION;
333
+ if (localSuccess <= cloudFailure) {
334
+ throw new Error("Порог localSuccess должен быть больше cloudFailure.");
335
+ }
336
+
337
+ const capability = getCapability(key);
338
+ const effectiveSuccessRate = capability?.effectiveSuccessRate ?? 0;
339
+ const decayedSuccessRate = capability?.decayedSuccessRate ?? 0;
340
+ const firstPassRate = capability?.firstPassRate ?? 0;
341
+ if (!capability || capability.runsTotal < minRuns) {
342
+ return {
343
+ taskType: key,
344
+ target: "explore",
345
+ reason: "no-data",
346
+ successRate: capability?.successRate ?? 0,
347
+ effectiveSuccessRate,
348
+ decayedSuccessRate,
349
+ firstPassRate,
350
+ runsTotal: capability?.runsTotal ?? 0,
351
+ capability,
352
+ };
353
+ }
354
+
355
+ if (effectiveSuccessRate >= localSuccess) {
356
+ return {
357
+ taskType: key,
358
+ target: "local",
359
+ reason: "local-reliable",
360
+ successRate: capability.successRate,
361
+ effectiveSuccessRate,
362
+ decayedSuccessRate,
363
+ firstPassRate,
364
+ runsTotal: capability.runsTotal,
365
+ capability,
366
+ };
367
+ }
368
+
369
+ if (effectiveSuccessRate <= cloudFailure) {
370
+ return {
371
+ taskType: key,
372
+ target: "cloud",
373
+ reason: "escalate",
374
+ successRate: capability.successRate,
375
+ effectiveSuccessRate,
376
+ decayedSuccessRate,
377
+ firstPassRate,
378
+ runsTotal: capability.runsTotal,
379
+ capability,
380
+ };
381
+ }
382
+
383
+ return {
384
+ taskType: key,
385
+ target: "review",
386
+ reason: "review",
387
+ successRate: capability.successRate,
388
+ effectiveSuccessRate,
389
+ decayedSuccessRate,
390
+ firstPassRate,
391
+ runsTotal: capability.runsTotal,
392
+ capability,
393
+ };
394
+ }
395
+
396
+ /** Готова ли таблица карты (для диагностики и тестов миграции). */
397
+ export function isCapabilityMapReady(): boolean {
398
+ const rows = getDb()
399
+ .prepare("SELECT name FROM sqlite_master WHERE type = 'table' AND name = 'capability_map'")
400
+ .all() as { name?: string }[];
401
+ return rows.length > 0;
402
+ }
@@ -1,6 +1,7 @@
1
1
  import { getDb, withTransaction } from "./index.js";
2
2
  import { incrementMetricsUnsafe } from "./metrics-repo.js";
3
3
  import { appendStructuredLog } from "../core/structured-log.js";
4
+ import os from "node:os";
4
5
  import type { TaskStatus } from "../history.js";
5
6
 
6
7
  /**
@@ -30,6 +31,10 @@ export interface StoredHistoryRecord {
30
31
  workspaceId?: string | null;
31
32
  allowedTools?: string[] | null;
32
33
  deniedTools?: string[] | null;
34
+ /** Владелец незавершённого запуска (схема v8). */
35
+ ownerPid?: number | null;
36
+ ownerHost?: string | null;
37
+ ownerStartedAt?: string | null;
33
38
  }
34
39
 
35
40
  /** Поля, которые пишутся в history при завершении запуска. */
@@ -73,14 +78,17 @@ function rowToRecord(row: any): StoredHistoryRecord {
73
78
  workspaceId: row.workspace_id == null ? null : String(row.workspace_id),
74
79
  allowedTools: row.allowed_tools == null ? null : JSON.parse(String(row.allowed_tools)),
75
80
  deniedTools: row.denied_tools == null ? null : JSON.parse(String(row.denied_tools)),
81
+ ownerPid: row.owner_pid == null ? null : Number(row.owner_pid),
82
+ ownerHost: row.owner_host == null ? null : String(row.owner_host),
83
+ ownerStartedAt: row.owner_started_at == null ? null : String(row.owner_started_at),
76
84
  };
77
85
  }
78
86
 
79
87
  const INSERT_SQL = `INSERT INTO history (
80
88
  task_name, status, started_at, finished_at, duration_ms, error,
81
89
  tokens, cost_usd, model, pre_flight_status, post_flight_status, next_task,
82
- workspace_id, allowed_tools, denied_tools
83
- ) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`;
90
+ workspace_id, allowed_tools, denied_tools, owner_pid, owner_host, owner_started_at
91
+ ) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`;
84
92
 
85
93
  function lastId(result: { lastInsertRowid: number | bigint }): number {
86
94
  return Number(result.lastInsertRowid) || 0;
@@ -106,6 +114,9 @@ export function insertHistory(record: StoredHistoryRecord): number {
106
114
  record.workspaceId ?? null,
107
115
  record.allowedTools == null ? null : JSON.stringify(record.allowedTools),
108
116
  record.deniedTools == null ? null : JSON.stringify(record.deniedTools),
117
+ record.ownerPid ?? null,
118
+ record.ownerHost ?? null,
119
+ record.ownerStartedAt ?? null,
109
120
  );
110
121
  return lastId(result);
111
122
  }
@@ -117,6 +128,7 @@ export function startRun(
117
128
  workspaceId?: string | null,
118
129
  allowedTools?: string[] | null,
119
130
  deniedTools?: string[] | null,
131
+ owner?: { pid?: number | null; host?: string | null; startedAt?: string | null },
120
132
  ): number {
121
133
  const id = insertHistory({
122
134
  taskName,
@@ -126,6 +138,9 @@ export function startRun(
126
138
  workspaceId,
127
139
  allowedTools,
128
140
  deniedTools,
141
+ ownerPid: owner?.pid ?? null,
142
+ ownerHost: owner?.host ?? null,
143
+ ownerStartedAt: owner?.startedAt ?? null,
129
144
  });
130
145
  appendStructuredLog({
131
146
  event: "run.started",
@@ -262,6 +277,10 @@ export function recordRun(
262
277
  workspaceId ?? null,
263
278
  allowedTools == null ? null : JSON.stringify(allowedTools),
264
279
  deniedTools == null ? null : JSON.stringify(deniedTools),
280
+ // owner-колонки относятся только к незавершённым запускам (startRun).
281
+ null,
282
+ null,
283
+ null,
265
284
  );
266
285
  incrementMetricsUnsafe(taskName, status, tokens, costUsd);
267
286
  return lastId(result);
@@ -326,6 +345,28 @@ export function getHistory(
326
345
  return rows.map(rowToRecord);
327
346
  }
328
347
 
348
+ /**
349
+ * Последняя запись по каждой задаче (P2-29).
350
+ *
351
+ * DAG-зависимости нельзя проверять по «последним N записям»: на частой задаче
352
+ * успех зависимости вымывается из окна, и зависимая задача не стартует.
353
+ * Здесь SQL сам выбирает по одной самой свежей записи на задачу.
354
+ */
355
+ export function getLatestHistoryByTask(limit = 5000): StoredHistoryRecord[] {
356
+ const safeLimit = Math.max(1, Math.min(100000, Math.floor(limit) || 1));
357
+ const rows = getDb()
358
+ .prepare(
359
+ `SELECT * FROM history
360
+ WHERE id IN (
361
+ SELECT MAX(id) FROM history GROUP BY lower(task_name)
362
+ )
363
+ ORDER BY started_at DESC, id DESC
364
+ LIMIT ?`,
365
+ )
366
+ .all(safeLimit);
367
+ return rows.map(rowToRecord);
368
+ }
369
+
329
370
  /** История запусков, начатых не раньше timestamp (ISO-строка). */
330
371
  export function getHistorySince(
331
372
  timestamp: string,
@@ -344,29 +385,117 @@ export function getHistorySince(
344
385
  }
345
386
 
346
387
  /**
347
- * Crash recovery: все незавершённые записи (finished_at IS NULL) помечаются
348
- * как error. Длительность считается от started_at до текущего момента.
349
- * Возвращает количество восстановленных записей.
388
+ * Crash recovery для истории.
389
+ *
390
+ * Незавершённая запись (finished_at IS NULL) финализируется как error, только
391
+ * если её владелец больше не может её завершить:
392
+ * - владелец известен, жив и на этом же хосте → запись оставляем (B1);
393
+ * - владелец известен и мёртв → финализируем сразу;
394
+ * - владелец неизвестен (legacy-строка или другой хост) → финализируем,
395
+ * только когда запись старше `maxUnverifiableAgeMs`.
350
396
  */
351
- export function recoverInterrupted(): number {
352
- const now = new Date().toISOString();
353
- const result = getDb()
397
+
398
+ /** Возраст, после которого запись с непроверяемым владельцем считается осиротевшей. */
399
+ export const UNVERIFIABLE_OWNER_MAX_AGE_MS = 24 * 60 * 60 * 1000;
400
+
401
+ export interface RecoverInterruptedResult {
402
+ /** Сколько записей финализировано как error. */
403
+ recovered: number;
404
+ /** Сколько записей оставлено живым владельцам. */
405
+ keptAlive: number;
406
+ }
407
+
408
+ export interface RecoverInterruptedOptions {
409
+ /** Текущий момент (для тестов). */
410
+ now?: Date;
411
+ /** Порог возраста для записей с непроверяемым владельцем. */
412
+ maxUnverifiableAgeMs?: number;
413
+ /** Имя текущего хоста (для тестов). */
414
+ hostname?: string;
415
+ /** Проверка живости PID (для тестов). */
416
+ isAlive?: (pid: number) => boolean;
417
+ }
418
+
419
+ /** Проверяет существование процесса: signal 0 не убивает, только пробует. */
420
+ export function isProcessAlive(pid: number): boolean {
421
+ if (!Number.isInteger(pid) || pid <= 0) return false;
422
+ try {
423
+ process.kill(pid, 0);
424
+ return true;
425
+ } catch (error) {
426
+ // EPERM — процесс существует, но сигнал запрещён; ESRCH — процесса нет.
427
+ return (error as NodeJS.ErrnoException)?.code === "EPERM";
428
+ }
429
+ }
430
+
431
+ export function recoverInterrupted(
432
+ options: RecoverInterruptedOptions = {},
433
+ ): RecoverInterruptedResult {
434
+ const now = options.now ?? new Date();
435
+ const nowIso = now.toISOString();
436
+ const maxAge =
437
+ typeof options.maxUnverifiableAgeMs === "number" &&
438
+ Number.isFinite(options.maxUnverifiableAgeMs)
439
+ ? Math.max(0, options.maxUnverifiableAgeMs)
440
+ : UNVERIFIABLE_OWNER_MAX_AGE_MS;
441
+ const hostname = options.hostname ?? os.hostname();
442
+ const isAlive = options.isAlive ?? isProcessAlive;
443
+ const db = getDb();
444
+ interface InterruptedHistoryRow {
445
+ id: number;
446
+ started_at: string | null;
447
+ owner_pid: number | null;
448
+ owner_host: string | null;
449
+ owner_started_at: string | null;
450
+ }
451
+ const rows = db
354
452
  .prepare(
355
- `UPDATE history SET
356
- status = 'error',
357
- error = CASE
358
- WHEN error IS NULL OR error = '' THEN 'Прервано (сбой/перезагрузка)'
359
- ELSE error
360
- END,
361
- finished_at = COALESCE(finished_at, ?),
362
- duration_ms = COALESCE(
363
- duration_ms,
364
- CAST((julianday(?) - julianday(started_at)) * 86400000 AS INTEGER)
365
- )
366
- WHERE finished_at IS NULL`,
453
+ `SELECT id, started_at, owner_pid, owner_host, owner_started_at
454
+ FROM history WHERE finished_at IS NULL`,
367
455
  )
368
- .run(now, now);
369
- return Number(result.changes) || 0;
456
+ .all() as unknown as InterruptedHistoryRow[];
457
+ const update = db.prepare(
458
+ `UPDATE history SET
459
+ status = 'error',
460
+ error = CASE
461
+ WHEN error IS NULL OR error = '' THEN 'Прервано (сбой/перезагрузка)'
462
+ ELSE error
463
+ END,
464
+ finished_at = COALESCE(finished_at, ?),
465
+ duration_ms = COALESCE(
466
+ duration_ms,
467
+ CAST((julianday(?) - julianday(started_at)) * 86400000 AS INTEGER)
468
+ )
469
+ WHERE id = ? AND finished_at IS NULL`,
470
+ );
471
+
472
+ let recovered = 0;
473
+ let keptAlive = 0;
474
+ withTransaction(() => {
475
+ for (const row of rows) {
476
+ const ownerPid = row.owner_pid == null ? null : Number(row.owner_pid);
477
+ const ownerHost = row.owner_host == null ? null : String(row.owner_host);
478
+ const verifiable =
479
+ ownerPid != null && ownerPid > 0 && ownerHost != null && ownerHost === hostname;
480
+
481
+ if (verifiable && ownerPid != null && isAlive(ownerPid)) {
482
+ keptAlive += 1;
483
+ continue;
484
+ }
485
+ if (!verifiable) {
486
+ const since = Date.parse(String(row.owner_started_at ?? row.started_at ?? ""));
487
+ const age = Number.isFinite(since) ? now.getTime() - since : Infinity;
488
+ if (age < maxAge) {
489
+ keptAlive += 1;
490
+ continue;
491
+ }
492
+ }
493
+
494
+ const result = update.run(nowIso, nowIso, row.id);
495
+ if (Number(result.changes) > 0) recovered += 1;
496
+ }
497
+ });
498
+ return { recovered, keptAlive };
370
499
  }
371
500
 
372
501
  /** Количество записей истории (для миграции и тестов). */