agent-steward 0.0.4 → 0.0.6

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 (279) hide show
  1. package/CHANGELOG.md +309 -2
  2. package/CROSS_PLATFORM.md +19 -0
  3. package/README.md +55 -8
  4. package/ROADMAP-STRATEGY.md +22 -19
  5. package/ROADMAP.md +230 -159
  6. package/dist/cli.d.ts +3 -0
  7. package/dist/cli.d.ts.map +1 -0
  8. package/dist/cli.js +356 -0
  9. package/dist/core/analytics.d.ts +6 -0
  10. package/dist/core/analytics.d.ts.map +1 -1
  11. package/dist/core/analytics.js +20 -3
  12. package/dist/core/audit.d.ts +6 -0
  13. package/dist/core/audit.d.ts.map +1 -1
  14. package/dist/core/audit.js +24 -0
  15. package/dist/core/budget.d.ts +118 -0
  16. package/dist/core/budget.d.ts.map +1 -0
  17. package/dist/core/budget.js +206 -0
  18. package/dist/core/cron-to-schtasks.d.ts.map +1 -1
  19. package/dist/core/cron-to-schtasks.js +38 -0
  20. package/dist/core/dry-run.d.ts +26 -1
  21. package/dist/core/dry-run.d.ts.map +1 -1
  22. package/dist/core/dry-run.js +199 -8
  23. package/dist/core/execution.d.ts +203 -0
  24. package/dist/core/execution.d.ts.map +1 -0
  25. package/dist/core/execution.js +309 -0
  26. package/dist/core/feedback.d.ts +192 -0
  27. package/dist/core/feedback.d.ts.map +1 -0
  28. package/dist/core/feedback.js +426 -0
  29. package/dist/core/gate-integrity.d.ts +71 -0
  30. package/dist/core/gate-integrity.d.ts.map +1 -0
  31. package/dist/core/gate-integrity.js +275 -0
  32. package/dist/core/git-trigger.d.ts.map +1 -1
  33. package/dist/core/git-trigger.js +14 -2
  34. package/dist/core/guard-run.d.ts +4 -0
  35. package/dist/core/guard-run.d.ts.map +1 -0
  36. package/dist/core/guard-run.js +101 -0
  37. package/dist/core/guard.d.ts +52 -0
  38. package/dist/core/guard.d.ts.map +1 -0
  39. package/dist/core/guard.js +362 -0
  40. package/dist/core/local-ai.d.ts.map +1 -1
  41. package/dist/core/local-ai.js +7 -3
  42. package/dist/core/lock.d.ts +41 -0
  43. package/dist/core/lock.d.ts.map +1 -1
  44. package/dist/core/lock.js +141 -29
  45. package/dist/core/matrix.d.ts +8 -0
  46. package/dist/core/matrix.d.ts.map +1 -1
  47. package/dist/core/matrix.js +132 -17
  48. package/dist/core/mission.d.ts +103 -0
  49. package/dist/core/mission.d.ts.map +1 -0
  50. package/dist/core/mission.js +374 -0
  51. package/dist/core/opencode-models.d.ts +2 -2
  52. package/dist/core/opencode-models.d.ts.map +1 -1
  53. package/dist/core/opencode-models.js +28 -21
  54. package/dist/core/opencode-usage.d.ts +35 -0
  55. package/dist/core/opencode-usage.d.ts.map +1 -0
  56. package/dist/core/opencode-usage.js +132 -0
  57. package/dist/core/pipeline-apply.d.ts +38 -0
  58. package/dist/core/pipeline-apply.d.ts.map +1 -0
  59. package/dist/core/pipeline-apply.js +117 -0
  60. package/dist/core/pipeline-io.d.ts +13 -0
  61. package/dist/core/pipeline-io.d.ts.map +1 -0
  62. package/dist/core/pipeline-io.js +78 -0
  63. package/dist/core/pipeline-map.d.ts +52 -0
  64. package/dist/core/pipeline-map.d.ts.map +1 -0
  65. package/dist/core/pipeline-map.js +208 -0
  66. package/dist/core/pipeline-spec.d.ts +109 -0
  67. package/dist/core/pipeline-spec.d.ts.map +1 -0
  68. package/dist/core/pipeline-spec.js +554 -0
  69. package/dist/core/ps-wrapper.d.ts +27 -2
  70. package/dist/core/ps-wrapper.d.ts.map +1 -1
  71. package/dist/core/ps-wrapper.js +424 -65
  72. package/dist/core/record-history.d.ts.map +1 -1
  73. package/dist/core/record-history.js +206 -33
  74. package/dist/core/router/rules.d.ts.map +1 -1
  75. package/dist/core/router/rules.js +6 -0
  76. package/dist/core/run-mode.d.ts +12 -0
  77. package/dist/core/run-mode.d.ts.map +1 -0
  78. package/dist/core/run-mode.js +17 -0
  79. package/dist/core/scheduler/linux.d.ts +8 -1
  80. package/dist/core/scheduler/linux.d.ts.map +1 -1
  81. package/dist/core/scheduler/linux.js +34 -9
  82. package/dist/core/scheduler/logs.d.ts +4 -0
  83. package/dist/core/scheduler/logs.d.ts.map +1 -1
  84. package/dist/core/scheduler/logs.js +25 -1
  85. package/dist/core/scheduler/mac.d.ts +44 -2
  86. package/dist/core/scheduler/mac.d.ts.map +1 -1
  87. package/dist/core/scheduler/mac.js +126 -15
  88. package/dist/core/scheduler/windows.d.ts.map +1 -1
  89. package/dist/core/scheduler/windows.js +15 -12
  90. package/dist/core/secrets.d.ts.map +1 -1
  91. package/dist/core/secrets.js +18 -8
  92. package/dist/core/self-analysis.d.ts +32 -2
  93. package/dist/core/self-analysis.d.ts.map +1 -1
  94. package/dist/core/self-analysis.js +38 -27
  95. package/dist/core/shutdown.d.ts +33 -2
  96. package/dist/core/shutdown.d.ts.map +1 -1
  97. package/dist/core/shutdown.js +58 -2
  98. package/dist/core/structured-log.d.ts +37 -1
  99. package/dist/core/structured-log.d.ts.map +1 -1
  100. package/dist/core/structured-log.js +37 -0
  101. package/dist/core/usage-surface.d.ts +25 -0
  102. package/dist/core/usage-surface.d.ts.map +1 -0
  103. package/dist/core/usage-surface.js +41 -0
  104. package/dist/core/worktree-run.d.ts +4 -0
  105. package/dist/core/worktree-run.d.ts.map +1 -0
  106. package/dist/core/worktree-run.js +164 -0
  107. package/dist/core/worktree.d.ts +115 -0
  108. package/dist/core/worktree.d.ts.map +1 -0
  109. package/dist/core/worktree.js +462 -0
  110. package/dist/core/wrappers/bash.d.ts +19 -0
  111. package/dist/core/wrappers/bash.d.ts.map +1 -1
  112. package/dist/core/wrappers/bash.js +230 -27
  113. package/dist/db/capability-repo.d.ts +43 -2
  114. package/dist/db/capability-repo.d.ts.map +1 -1
  115. package/dist/db/capability-repo.js +96 -11
  116. package/dist/db/history-repo.d.ts +70 -5
  117. package/dist/db/history-repo.d.ts.map +1 -1
  118. package/dist/db/history-repo.js +170 -29
  119. package/dist/db/metrics-repo.d.ts +20 -2
  120. package/dist/db/metrics-repo.d.ts.map +1 -1
  121. package/dist/db/metrics-repo.js +35 -13
  122. package/dist/db/migrate.d.ts.map +1 -1
  123. package/dist/db/migrate.js +37 -17
  124. package/dist/db/recovery.d.ts +3 -1
  125. package/dist/db/recovery.d.ts.map +1 -1
  126. package/dist/db/recovery.js +11 -5
  127. package/dist/db/run-journal.d.ts +33 -5
  128. package/dist/db/run-journal.d.ts.map +1 -1
  129. package/dist/db/run-journal.js +78 -14
  130. package/dist/db/run-resume.d.ts +5 -0
  131. package/dist/db/run-resume.d.ts.map +1 -1
  132. package/dist/db/run-resume.js +9 -2
  133. package/dist/db/runs-repo.d.ts +19 -2
  134. package/dist/db/runs-repo.d.ts.map +1 -1
  135. package/dist/db/runs-repo.js +91 -60
  136. package/dist/db/schema.d.ts +2 -2
  137. package/dist/db/schema.d.ts.map +1 -1
  138. package/dist/db/schema.js +132 -2
  139. package/dist/db/templates-repo.d.ts +2 -2
  140. package/dist/db/templates-repo.d.ts.map +1 -1
  141. package/dist/db/templates-repo.js +5 -3
  142. package/dist/history.d.ts +7 -2
  143. package/dist/history.d.ts.map +1 -1
  144. package/dist/history.js +4 -2
  145. package/dist/hook-output.d.ts +2 -0
  146. package/dist/hook-output.d.ts.map +1 -0
  147. package/dist/hook-output.js +31 -0
  148. package/dist/i18n.d.ts +5 -0
  149. package/dist/i18n.d.ts.map +1 -1
  150. package/dist/i18n.js +11 -4
  151. package/dist/index.d.ts +375 -47
  152. package/dist/index.d.ts.map +1 -1
  153. package/dist/index.js +1344 -192
  154. package/dist/notifications.d.ts +53 -2
  155. package/dist/notifications.d.ts.map +1 -1
  156. package/dist/notifications.js +168 -21
  157. package/dist/profiles.d.ts.map +1 -1
  158. package/dist/profiles.js +82 -10
  159. package/dist/rpc.d.ts +354 -0
  160. package/dist/rpc.d.ts.map +1 -1
  161. package/dist/rpc.js +145 -0
  162. package/dist/server.d.ts +32 -2
  163. package/dist/server.d.ts.map +1 -1
  164. package/dist/server.js +154 -30
  165. package/dist/settings.d.ts +44 -2
  166. package/dist/settings.d.ts.map +1 -1
  167. package/dist/settings.js +85 -3
  168. package/dist/shared/jobs-view.d.ts +1 -1
  169. package/dist/shared/jobs-view.d.ts.map +1 -1
  170. package/dist/shared/jobs-view.js +2 -0
  171. package/dist/task-transfer.d.ts +21 -0
  172. package/dist/task-transfer.d.ts.map +1 -1
  173. package/dist/task-transfer.js +64 -3
  174. package/dist/templates.d.ts +2 -2
  175. package/dist/templates.d.ts.map +1 -1
  176. package/dist/templates.js +3 -3
  177. package/dist/types.d.ts +22 -2
  178. package/dist/types.d.ts.map +1 -1
  179. package/dist/workspaces.d.ts.map +1 -1
  180. package/dist/workspaces.js +34 -11
  181. package/docs/ARCHITECTURE.md +319 -66
  182. package/docs/COMPATIBILITY.md +2 -2
  183. package/docs/CONCEPT.md +18 -4
  184. package/docs/CROSS_PLATFORM.ru.md +20 -0
  185. package/docs/CROSS_PLATFORM.zh.md +18 -0
  186. package/docs/EXECUTION-LOOP.md +28 -10
  187. package/docs/FEATURES.md +129 -7
  188. package/docs/FEATURES.zh.md +97 -6
  189. package/docs/MIGRATION.md +2 -2
  190. package/docs/PIPELINE.md +293 -0
  191. package/docs/QA-A2-GUI-TUI.md +205 -0
  192. package/docs/README.ru.md +43 -4
  193. package/docs/README.zh.md +44 -4
  194. package/docs/SAFETY.md +23 -3
  195. package/gui-experimental.cjs +9 -8
  196. package/locales/en.json +58 -3
  197. package/locales/ru.json +58 -3
  198. package/locales/zh.json +58 -3
  199. package/opencode.pipeline.yaml +35 -0
  200. package/package.json +36 -4
  201. package/scripts/check-eslint-baseline.mjs +139 -0
  202. package/scripts/gen-test-plan-counters.mjs +117 -0
  203. package/scripts/github-ci-fetch.ps1 +37 -0
  204. package/scripts/pl-commit.ps1 +112 -0
  205. package/scripts/qa-a2-commit.ps1 +104 -0
  206. package/scripts/test-home.mjs +107 -0
  207. package/skills/scheduled-job-best-practices/SKILL.md +95 -1
  208. package/skills/scheduled-job-best-practices/references/recipes.md +139 -0
  209. package/src/cli.ts +417 -0
  210. package/src/core/analytics.ts +27 -4
  211. package/src/core/audit.ts +25 -0
  212. package/src/core/budget.ts +340 -0
  213. package/src/core/cron-to-schtasks.ts +42 -0
  214. package/src/core/dry-run.ts +235 -12
  215. package/src/core/execution.ts +538 -0
  216. package/src/core/feedback.ts +582 -0
  217. package/src/core/file-watcher.ts +2 -2
  218. package/src/core/gate-integrity.ts +330 -0
  219. package/src/core/git-trigger.ts +18 -5
  220. package/src/core/guard-run.ts +119 -0
  221. package/src/core/guard.ts +431 -0
  222. package/src/core/local-ai.ts +7 -3
  223. package/src/core/lock.ts +178 -37
  224. package/src/core/matrix.ts +158 -52
  225. package/src/core/mission.ts +531 -0
  226. package/src/core/native-notify.ts +1 -1
  227. package/src/core/opencode-models.ts +30 -21
  228. package/src/core/opencode-usage.ts +182 -0
  229. package/src/core/pipeline-apply.ts +158 -0
  230. package/src/core/pipeline-io.ts +96 -0
  231. package/src/core/pipeline-map.ts +283 -0
  232. package/src/core/pipeline-spec.ts +775 -0
  233. package/src/core/ps-wrapper.ts +435 -66
  234. package/src/core/record-history.ts +258 -81
  235. package/src/core/router/rules.ts +6 -0
  236. package/src/core/run-mode.ts +19 -0
  237. package/src/core/schedule-gate.ts +1 -1
  238. package/src/core/scheduler/at-fallback.ts +1 -1
  239. package/src/core/scheduler/linux.ts +40 -11
  240. package/src/core/scheduler/logs.ts +34 -3
  241. package/src/core/scheduler/mac.ts +174 -14
  242. package/src/core/scheduler/registry.ts +2 -2
  243. package/src/core/scheduler/windows.ts +19 -15
  244. package/src/core/secrets.ts +26 -19
  245. package/src/core/self-analysis.ts +75 -29
  246. package/src/core/shutdown.ts +90 -4
  247. package/src/core/structured-log.ts +89 -5
  248. package/src/core/telegram.ts +2 -2
  249. package/src/core/triage-worker.ts +7 -7
  250. package/src/core/triage.ts +2 -2
  251. package/src/core/usage-surface.ts +70 -0
  252. package/src/core/worktree-run.ts +199 -0
  253. package/src/core/worktree.ts +600 -0
  254. package/src/core/wrappers/bash.ts +248 -26
  255. package/src/db/capability-repo.ts +127 -10
  256. package/src/db/history-repo.ts +281 -40
  257. package/src/db/metrics-repo.ts +40 -13
  258. package/src/db/migrate.ts +57 -32
  259. package/src/db/recovery.ts +12 -5
  260. package/src/db/run-journal.ts +100 -13
  261. package/src/db/run-resume.ts +17 -1
  262. package/src/db/runs-repo.ts +147 -65
  263. package/src/db/schema.ts +134 -2
  264. package/src/db/templates-repo.ts +5 -3
  265. package/src/gui.tsx +438 -18
  266. package/src/history.ts +11 -4
  267. package/src/hook-output.ts +39 -0
  268. package/src/i18n.ts +12 -4
  269. package/src/index.ts +1902 -320
  270. package/src/notifications.ts +227 -47
  271. package/src/profiles.ts +88 -10
  272. package/src/rpc.ts +158 -0
  273. package/src/server.ts +201 -41
  274. package/src/settings.ts +125 -5
  275. package/src/shared/jobs-view.ts +3 -1
  276. package/src/task-transfer.ts +90 -6
  277. package/src/templates.ts +3 -3
  278. package/src/types.ts +23 -2
  279. package/src/workspaces.ts +37 -14
@@ -79,7 +79,12 @@ export interface RunStepRecord {
79
79
  position: number;
80
80
  status: StepStatus;
81
81
  attempt: number;
82
+ /** Ключ идемпотентности (36.3); уникален в пределах запуска. */
82
83
  idempotencyKey: string | null;
84
+ /** B12: идентификатор процесса-владельца шага (`host:pid:startedAt`). */
85
+ ownerId: string | null;
86
+ /** B12: момент, до которого владелец обязан продлить lease (ISO). */
87
+ leaseUntil: string | null;
83
88
  startedAt: string | null;
84
89
  finishedAt: string | null;
85
90
  error: string | null;
@@ -115,16 +120,70 @@ export interface FinishOptions {
115
120
  output?: unknown;
116
121
  }
117
122
 
123
+ /** B12: владелец шага и срок его lease. */
124
+ export interface StepLease {
125
+ ownerId: string;
126
+ leaseUntil: string;
127
+ }
128
+
129
+ /**
130
+ * QA-A2-T4: граница `node:sqlite`. Драйвер через `SqliteStatement.get()/all()`
131
+ * возвращает `any`; в колонках runs/run_steps реально лежат только TEXT
132
+ * (string), INTEGER (number|bigint) и SQL NULL. Сужаем `any` до `unknown`, затем
133
+ * type guard-ом до `SqliteRow` — так каскад no-unsafe-* не расползается по файлу.
134
+ */
135
+ type SqliteCell = string | number | bigint | null;
136
+ type SqliteRow = Record<string, SqliteCell>;
137
+
138
+ function isRecord(value: unknown): value is Record<string, unknown> {
139
+ return typeof value === "object" && value !== null && !Array.isArray(value);
140
+ }
141
+
142
+ function isSqliteRow(value: unknown): value is SqliteRow {
143
+ if (!isRecord(value)) return false;
144
+ return Object.values(value).every(
145
+ (cell) =>
146
+ cell === null ||
147
+ typeof cell === "string" ||
148
+ typeof cell === "number" ||
149
+ typeof cell === "bigint",
150
+ );
151
+ }
152
+
153
+ /** Строковое представление ячейки — то же, что давал `String(row.col)` раньше. */
154
+ function asText(cell: SqliteCell): string {
155
+ if (cell === null) return "null";
156
+ return typeof cell === "string" ? cell : String(cell);
157
+ }
158
+
159
+ /** Nullable TEXT-колонка: SQL NULL → null, иначе строковое представление. */
160
+ function nullableText(cell: SqliteCell): string | null {
161
+ return cell === null ? null : asText(cell);
162
+ }
163
+
164
+ /** Одна строка результата или undefined (SELECT ... WHERE id = ?). */
165
+ function queryRow(sql: string, ...params: unknown[]): SqliteRow | undefined {
166
+ const raw: unknown = getDb().prepare(sql).get(...params);
167
+ return isSqliteRow(raw) ? raw : undefined;
168
+ }
169
+
170
+ /** Все строки результата (SELECT ... с several строками). */
171
+ function queryRows(sql: string, ...params: unknown[]): SqliteRow[] {
172
+ const raw: unknown = getDb().prepare(sql).all(...params);
173
+ return Array.isArray(raw) ? raw.filter(isSqliteRow) : [];
174
+ }
175
+
118
176
  function nowIso(): string {
119
177
  return new Date().toISOString();
120
178
  }
121
179
 
122
- function parseJson(value: unknown): unknown {
180
+ /** JSON-колонка хранит текст (результат serializeJson) или SQL NULL. */
181
+ function parseJson(value: string | null): unknown {
123
182
  if (value == null) return null;
124
183
  try {
125
- return JSON.parse(String(value));
184
+ return JSON.parse(value);
126
185
  } catch {
127
- return String(value);
186
+ return value;
128
187
  }
129
188
  }
130
189
 
@@ -137,37 +196,41 @@ function serializeJson(value: unknown): string | null {
137
196
  }
138
197
  }
139
198
 
140
- function runRowToRecord(row: any): RunRecord {
199
+ function runRowToRecord(row: SqliteRow): RunRecord {
141
200
  return {
142
- id: String(row.id),
143
- taskName: String(row.task_name),
144
- status: String(row.status) as RunStatus,
145
- parentRunId: row.parent_run_id == null ? null : String(row.parent_run_id),
146
- workspaceId: row.workspace_id == null ? null : String(row.workspace_id),
147
- startedAt: row.started_at == null ? null : String(row.started_at),
148
- finishedAt: row.finished_at == null ? null : String(row.finished_at),
149
- error: row.error == null ? null : String(row.error),
150
- metadata: parseJson(row.metadata_json),
151
- createdAt: String(row.created_at),
152
- updatedAt: String(row.updated_at),
201
+ id: asText(row.id),
202
+ taskName: asText(row.task_name),
203
+ // Доменное приведение: значения приходят из CHECK-ограниченых наших же записей.
204
+ status: asText(row.status) as RunStatus,
205
+ parentRunId: nullableText(row.parent_run_id),
206
+ workspaceId: nullableText(row.workspace_id),
207
+ startedAt: nullableText(row.started_at),
208
+ finishedAt: nullableText(row.finished_at),
209
+ error: nullableText(row.error),
210
+ metadata: parseJson(nullableText(row.metadata_json)),
211
+ createdAt: asText(row.created_at),
212
+ updatedAt: asText(row.updated_at),
153
213
  };
154
214
  }
155
215
 
156
- function stepRowToRecord(row: any): RunStepRecord {
216
+ function stepRowToRecord(row: SqliteRow): RunStepRecord {
157
217
  return {
158
- id: String(row.id),
159
- runId: String(row.run_id),
160
- stepName: String(row.step_name),
218
+ id: asText(row.id),
219
+ runId: asText(row.run_id),
220
+ stepName: asText(row.step_name),
161
221
  position: Number(row.position) || 0,
162
- status: String(row.status) as StepStatus,
222
+ // Доменное приведение: см. комментарий в runRowToRecord.
223
+ status: asText(row.status) as StepStatus,
163
224
  attempt: Number(row.attempt) || 1,
164
- idempotencyKey: row.idempotency_key == null ? null : String(row.idempotency_key),
165
- startedAt: row.started_at == null ? null : String(row.started_at),
166
- finishedAt: row.finished_at == null ? null : String(row.finished_at),
167
- error: row.error == null ? null : String(row.error),
168
- output: parseJson(row.output_json),
169
- createdAt: String(row.created_at),
170
- updatedAt: String(row.updated_at),
225
+ idempotencyKey: nullableText(row.idempotency_key),
226
+ ownerId: nullableText(row.owner_id),
227
+ leaseUntil: nullableText(row.lease_until),
228
+ startedAt: nullableText(row.started_at),
229
+ finishedAt: nullableText(row.finished_at),
230
+ error: nullableText(row.error),
231
+ output: parseJson(nullableText(row.output_json)),
232
+ createdAt: asText(row.created_at),
233
+ updatedAt: asText(row.updated_at),
171
234
  };
172
235
  }
173
236
 
@@ -254,9 +317,10 @@ function insertStepUnsafe(
254
317
 
255
318
  /** Следующая позиция шага в цепочке запуска. */
256
319
  function nextStepPosition(runId: string): number {
257
- const row = getDb()
258
- .prepare("SELECT COALESCE(MAX(position), -1) + 1 AS next FROM run_steps WHERE run_id = ?")
259
- .get(runId) as { next?: number } | undefined;
320
+ const row = queryRow(
321
+ "SELECT COALESCE(MAX(position), -1) + 1 AS next FROM run_steps WHERE run_id = ?",
322
+ runId,
323
+ );
260
324
  return Number(row?.next) || 0;
261
325
  }
262
326
 
@@ -282,7 +346,7 @@ export function createSteps(runId: string, steps: CreateStepOptions[]): RunStepR
282
346
  }
283
347
 
284
348
  export function getRun(id: string): RunRecord | undefined {
285
- const row = getDb().prepare("SELECT * FROM runs WHERE id = ?").get(id);
349
+ const row = queryRow("SELECT * FROM runs WHERE id = ?", id);
286
350
  return row ? runRowToRecord(row) : undefined;
287
351
  }
288
352
 
@@ -290,18 +354,17 @@ export function getRun(id: string): RunRecord | undefined {
290
354
  export function listRuns(taskName?: string | null, limit = 100): RunRecord[] {
291
355
  const safeLimit = Math.max(1, Math.min(10000, Math.floor(limit) || 1));
292
356
  if (taskName) {
293
- return getDb()
294
- .prepare(
295
- `SELECT * FROM runs WHERE lower(task_name) = lower(?)
296
- ORDER BY created_at DESC, id DESC LIMIT ?`,
297
- )
298
- .all(taskName, safeLimit)
299
- .map(runRowToRecord);
357
+ return queryRows(
358
+ `SELECT * FROM runs WHERE lower(task_name) = lower(?)
359
+ ORDER BY created_at DESC, id DESC LIMIT ?`,
360
+ taskName,
361
+ safeLimit,
362
+ ).map(runRowToRecord);
300
363
  }
301
- return getDb()
302
- .prepare("SELECT * FROM runs ORDER BY created_at DESC, id DESC LIMIT ?")
303
- .all(safeLimit)
304
- .map(runRowToRecord);
364
+ return queryRows(
365
+ "SELECT * FROM runs ORDER BY created_at DESC, id DESC LIMIT ?",
366
+ safeLimit,
367
+ ).map(runRowToRecord);
305
368
  }
306
369
 
307
370
  /** pending → running. Возвращает false, если запуск не найден. */
@@ -378,24 +441,26 @@ export function reopenRun(id: string, startedAt = nowIso()): boolean {
378
441
  }
379
442
 
380
443
  export function getStepById(id: string): RunStepRecord | undefined {
381
- const row = getDb().prepare("SELECT * FROM run_steps WHERE id = ?").get(id);
444
+ const row = queryRow("SELECT * FROM run_steps WHERE id = ?", id);
382
445
  return row ? stepRowToRecord(row) : undefined;
383
446
  }
384
447
 
385
448
  /** Шаг по имени внутри запуска (имя уникально). */
386
449
  export function getStep(runId: string, stepName: string): RunStepRecord | undefined {
387
- const row = getDb()
388
- .prepare("SELECT * FROM run_steps WHERE run_id = ? AND step_name = ?")
389
- .get(runId, stepName);
450
+ const row = queryRow(
451
+ "SELECT * FROM run_steps WHERE run_id = ? AND step_name = ?",
452
+ runId,
453
+ stepName,
454
+ );
390
455
  return row ? stepRowToRecord(row) : undefined;
391
456
  }
392
457
 
393
458
  /** Все шаги запуска в порядке создания. */
394
459
  export function listRunSteps(runId: string): RunStepRecord[] {
395
- return getDb()
396
- .prepare("SELECT * FROM run_steps WHERE run_id = ? ORDER BY position ASC, rowid ASC")
397
- .all(runId)
398
- .map(stepRowToRecord);
460
+ return queryRows(
461
+ "SELECT * FROM run_steps WHERE run_id = ? ORDER BY position ASC, rowid ASC",
462
+ runId,
463
+ ).map(stepRowToRecord);
399
464
  }
400
465
 
401
466
  /** Поиск шага по ключу идемпотентности (36.3) в пределах запуска. */
@@ -403,14 +468,16 @@ export function findStepByIdempotencyKey(
403
468
  runId: string,
404
469
  idempotencyKey: string,
405
470
  ): RunStepRecord | undefined {
406
- const row = getDb()
407
- .prepare("SELECT * FROM run_steps WHERE run_id = ? AND idempotency_key = ? LIMIT 1")
408
- .get(runId, idempotencyKey);
471
+ const row = queryRow(
472
+ "SELECT * FROM run_steps WHERE run_id = ? AND idempotency_key = ? LIMIT 1",
473
+ runId,
474
+ idempotencyKey,
475
+ );
409
476
  return row ? stepRowToRecord(row) : undefined;
410
477
  }
411
478
 
412
479
  /** pending → running. Возвращает false, если шаг не найден. */
413
- export function startStep(id: string, startedAt = nowIso()): boolean {
480
+ export function startStep(id: string, startedAt = nowIso(), lease?: StepLease): boolean {
414
481
  return withTransaction(() => {
415
482
  const step = getStepById(id);
416
483
  if (!step) return false;
@@ -418,9 +485,9 @@ export function startStep(id: string, startedAt = nowIso()): boolean {
418
485
  getDb()
419
486
  .prepare(
420
487
  `UPDATE run_steps SET status = 'running', started_at = ?, finished_at = NULL,
421
- error = NULL, updated_at = ? WHERE id = ?`,
488
+ error = NULL, owner_id = ?, lease_until = ?, updated_at = ? WHERE id = ?`,
422
489
  )
423
- .run(startedAt, nowIso(), id);
490
+ .run(startedAt, lease?.ownerId ?? null, lease?.leaseUntil ?? null, nowIso(), id);
424
491
  return true;
425
492
  });
426
493
  }
@@ -459,7 +526,7 @@ export function finishStep(
459
526
  * Это единственный переход из финального статуса шага. Предыдущая попытка
460
527
  * остаётся видимой в счётчике attempt; для 36.4 (DLQ) здесь появится лимит.
461
528
  */
462
- export function retryStep(id: string, startedAt = nowIso()): boolean {
529
+ export function retryStep(id: string, startedAt = nowIso(), lease?: StepLease): boolean {
463
530
  return withTransaction(() => {
464
531
  const step = getStepById(id);
465
532
  if (!step) return false;
@@ -469,18 +536,33 @@ export function retryStep(id: string, startedAt = nowIso()): boolean {
469
536
  getDb()
470
537
  .prepare(
471
538
  `UPDATE run_steps SET status = 'running', attempt = attempt + 1,
472
- started_at = ?, finished_at = NULL, error = NULL, updated_at = ? WHERE id = ?`,
539
+ started_at = ?, finished_at = NULL, error = NULL,
540
+ owner_id = ?, lease_until = ?, updated_at = ? WHERE id = ?`,
473
541
  )
474
- .run(startedAt, nowIso(), id);
542
+ .run(startedAt, lease?.ownerId ?? null, lease?.leaseUntil ?? null, nowIso(), id);
475
543
  return true;
476
544
  });
477
545
  }
478
546
 
547
+ /**
548
+ * B12: продлевает lease выполняющегося шага.
549
+ *
550
+ * Возвращает false, если шаг уже не `running` (например, recovery успел
551
+ * финализировать его после истечения lease): продлевать нечего.
552
+ */
553
+ export function renewStepLease(id: string, lease: StepLease): boolean {
554
+ const result = getDb()
555
+ .prepare(
556
+ `UPDATE run_steps SET owner_id = ?, lease_until = ?, updated_at = ?
557
+ WHERE id = ? AND status = 'running'`,
558
+ )
559
+ .run(lease.ownerId, lease.leaseUntil, nowIso(), id);
560
+ return Number(result.changes) > 0;
561
+ }
562
+
479
563
  /** Количество шагов запуска (для health/отчётов). */
480
564
  export function countRunSteps(runId: string): number {
481
- const row = getDb()
482
- .prepare("SELECT COUNT(*) AS count FROM run_steps WHERE run_id = ?")
483
- .get(runId);
565
+ const row = queryRow("SELECT COUNT(*) AS count FROM run_steps WHERE run_id = ?", runId);
484
566
  return Number(row?.count) || 0;
485
567
  }
486
568
 
@@ -492,9 +574,9 @@ export function deleteRun(id: string): boolean {
492
574
 
493
575
  /** Готова ли схема к работе с durable DAG (runs + run_steps). */
494
576
  export function isRunStateReady(): boolean {
495
- const rows = getDb()
496
- .prepare("SELECT name FROM sqlite_master WHERE type = 'table' AND name IN ('runs', 'run_steps')")
497
- .all();
577
+ const rows = queryRows(
578
+ "SELECT name FROM sqlite_master WHERE type = 'table' AND name IN ('runs', 'run_steps')",
579
+ );
498
580
  return rows.length === 2;
499
581
  }
500
582
 
package/src/db/schema.ts CHANGED
@@ -31,10 +31,20 @@ CREATE TABLE IF NOT EXISTS history (
31
31
  next_task TEXT,
32
32
  workspace_id TEXT,
33
33
  allowed_tools TEXT,
34
- denied_tools TEXT
34
+ denied_tools TEXT,
35
+ -- Схема v8: владелец незавершённого запуска. Нужен recovery, чтобы не
36
+ -- финализировать прогон, чей процесс ещё жив (B1).
37
+ owner_pid INTEGER,
38
+ owner_host TEXT,
39
+ owner_started_at TEXT
35
40
  );
36
41
 
37
42
  CREATE INDEX IF NOT EXISTS idx_history_task ON history(task_name, started_at DESC);
43
+ -- QA-A3 / BP-D08-1: getHistory() фильтрует через lower(task_name)/lower(status),
44
+ -- поэтому обычный индекс по task_name не используется — нужен functional index.
45
+ -- Без них EXPLAIN QUERY PLAN даёт SCAN history на 100K+ записей.
46
+ CREATE INDEX IF NOT EXISTS idx_history_task_lower ON history(lower(task_name), started_at DESC);
47
+ CREATE INDEX IF NOT EXISTS idx_history_status_lower ON history(lower(status), started_at DESC);
38
48
 
39
49
  CREATE TABLE IF NOT EXISTS metrics (
40
50
  task_name TEXT PRIMARY KEY,
@@ -57,6 +67,27 @@ CREATE TABLE IF NOT EXISTS settings (
57
67
  value_json TEXT NOT NULL
58
68
  );
59
69
 
70
+ -- Деталь 3.8 (F-1.6): локальный outbox отчётов, когда приёмник недоступен.
71
+ -- Отправка повторяется при старте плагина, попытки ограничены.
72
+ CREATE TABLE IF NOT EXISTS feedback_outbox (
73
+ id TEXT PRIMARY KEY,
74
+ report_id TEXT NOT NULL UNIQUE,
75
+ payload_json TEXT NOT NULL,
76
+ attempts INTEGER NOT NULL DEFAULT 0,
77
+ last_error TEXT,
78
+ created_at TEXT NOT NULL,
79
+ last_attempt_at TEXT
80
+ );
81
+ CREATE INDEX IF NOT EXISTS idx_feedback_outbox_created ON feedback_outbox(created_at);
82
+
83
+ -- Деталь 3.8 (F-1.7): антиспам — только хеш описания и время, без PII.
84
+ CREATE TABLE IF NOT EXISTS feedback_spam (
85
+ id INTEGER PRIMARY KEY AUTOINCREMENT,
86
+ hash TEXT NOT NULL,
87
+ at TEXT NOT NULL
88
+ );
89
+ CREATE INDEX IF NOT EXISTS idx_feedback_spam_at ON feedback_spam(at DESC);
90
+
60
91
  CREATE TABLE IF NOT EXISTS workspaces (
61
92
  id TEXT PRIMARY KEY,
62
93
  name TEXT NOT NULL,
@@ -154,6 +185,10 @@ CREATE TABLE IF NOT EXISTS run_steps (
154
185
  status TEXT NOT NULL,
155
186
  attempt INTEGER NOT NULL DEFAULT 1,
156
187
  idempotency_key TEXT,
188
+ -- B12: владелец и lease шага. Живой процесс продлевает lease; recovery
189
+ -- финализирует только шаги с истёкшим lease, не трогая чужие живые.
190
+ owner_id TEXT,
191
+ lease_until TEXT,
157
192
  started_at TEXT,
158
193
  finished_at TEXT,
159
194
  error TEXT,
@@ -217,6 +252,7 @@ CREATE TABLE IF NOT EXISTS capability_map (
217
252
  model TEXT NOT NULL,
218
253
  runs_total INTEGER NOT NULL DEFAULT 0,
219
254
  runs_passed INTEGER NOT NULL DEFAULT 0,
255
+ first_pass_count INTEGER,
220
256
  success_rate REAL NOT NULL DEFAULT 0,
221
257
  avg_cost_usd REAL NOT NULL DEFAULT 0,
222
258
  avg_time_ms REAL NOT NULL DEFAULT 0,
@@ -241,7 +277,7 @@ interface SchemaDb {
241
277
  * миграций. Увеличивайте при добавлении новой ступени в {@link MIGRATIONS}
242
278
  * и добавляйте соответствующую запись в массив.
243
279
  */
244
- export const SCHEMA_VERSION = 7;
280
+ export const SCHEMA_VERSION = 12;
245
281
 
246
282
  /** Возвращает сохранённую версию схемы (0 у legacy-БД без user_version). */
247
283
  export function getSchemaVersion(db: SchemaDb): number {
@@ -461,6 +497,102 @@ const MIGRATIONS: { to: number; migrate: (db: SchemaDb) => void }[] = [
461
497
  `);
462
498
  },
463
499
  },
500
+ {
501
+ // Ступень 8 — владелец незавершённого запуска (B1). Recovery должен
502
+ // отличать живой прогон от осиротевшего: PID процесса-обёртки, метка
503
+ // хоста и время старта владельца. Колонки аддитивные, поэтому ступень
504
+ // идемпотентна и безопасна для старых БД.
505
+ to: 8,
506
+ migrate(db) {
507
+ const columnNames = tableColumns(db, "history");
508
+ if (!columnNames.includes("owner_pid")) {
509
+ db.exec("ALTER TABLE history ADD COLUMN owner_pid INTEGER");
510
+ }
511
+ if (!columnNames.includes("owner_host")) {
512
+ db.exec("ALTER TABLE history ADD COLUMN owner_host TEXT");
513
+ }
514
+ if (!columnNames.includes("owner_started_at")) {
515
+ db.exec("ALTER TABLE history ADD COLUMN owner_started_at TEXT");
516
+ }
517
+ },
518
+ },
519
+ {
520
+ // Ступень 9 — lease/владелец шага (B12). Recovery больше не убивает
521
+ // `running`-шаги вслепую: у шага есть owner_id и lease_until, а живой
522
+ // процесс продлевает lease. Колонки аддитивные — ступень идемпотентна.
523
+ to: 9,
524
+ migrate(db) {
525
+ const columnNames = tableColumns(db, "run_steps");
526
+ if (!columnNames.includes("owner_id")) {
527
+ db.exec("ALTER TABLE run_steps ADD COLUMN owner_id TEXT");
528
+ }
529
+ if (!columnNames.includes("lease_until")) {
530
+ db.exec("ALTER TABLE run_steps ADD COLUMN lease_until TEXT");
531
+ }
532
+ },
533
+ },
534
+ {
535
+ // Ступень 10 — first-pass статистика Capability Map (B13). Успех с первой
536
+ // попытки нельзя восстановить из runs_passed, поэтому для legacy-строк
537
+ // считаем все прошлые успехи первыми (first_pass_count = runs_passed).
538
+ // NULL отличает «не заполнено миграцией» от честного нуля.
539
+ to: 10,
540
+ migrate(db) {
541
+ const columnNames = tableColumns(db, "capability_map");
542
+ if (!columnNames.includes("first_pass_count")) {
543
+ db.exec("ALTER TABLE capability_map ADD COLUMN first_pass_count INTEGER");
544
+ }
545
+ const columnsAfter = tableColumns(db, "capability_map");
546
+ if (columnsAfter.includes("first_pass_count")) {
547
+ db.exec(
548
+ "UPDATE capability_map SET first_pass_count = runs_passed WHERE first_pass_count IS NULL",
549
+ );
550
+ }
551
+ },
552
+ },
553
+ {
554
+ // Ступень 11 — QA-A3 / BP-D08-1: functional-индексы под lower()-фильтры
555
+ // getHistory(). Обычный idx_history_task не работает с lower(task_name),
556
+ // а по status индекса не было вовсе — на 100K записей план давал SCAN.
557
+ // CREATE INDEX IF NOT EXISTS идемпотентен, ступень безопасна для старых БД.
558
+ to: 11,
559
+ migrate(db) {
560
+ db.exec(`
561
+ CREATE INDEX IF NOT EXISTS idx_history_task_lower
562
+ ON history(lower(task_name), started_at DESC);
563
+ CREATE INDEX IF NOT EXISTS idx_history_status_lower
564
+ ON history(lower(status), started_at DESC);
565
+ `);
566
+ },
567
+ },
568
+ {
569
+ // Ступень 12 — Деталь 3.8: outbox и антиспам для обратной связи.
570
+ // CREATE TABLE IF NOT EXISTS идемпотентен: legacy-БД получает таблицы
571
+ // и здесь, и через SCHEMA_SQL — повтор безопасен.
572
+ to: 12,
573
+ migrate(db) {
574
+ db.exec(`
575
+ CREATE TABLE IF NOT EXISTS feedback_outbox (
576
+ id TEXT PRIMARY KEY,
577
+ report_id TEXT NOT NULL UNIQUE,
578
+ payload_json TEXT NOT NULL,
579
+ attempts INTEGER NOT NULL DEFAULT 0,
580
+ last_error TEXT,
581
+ created_at TEXT NOT NULL,
582
+ last_attempt_at TEXT
583
+ );
584
+ CREATE INDEX IF NOT EXISTS idx_feedback_outbox_created
585
+ ON feedback_outbox(created_at);
586
+ CREATE TABLE IF NOT EXISTS feedback_spam (
587
+ id INTEGER PRIMARY KEY AUTOINCREMENT,
588
+ hash TEXT NOT NULL,
589
+ at TEXT NOT NULL
590
+ );
591
+ CREATE INDEX IF NOT EXISTS idx_feedback_spam_at
592
+ ON feedback_spam(at DESC);
593
+ `);
594
+ },
595
+ },
464
596
  ];
465
597
 
466
598
  /** Имена колонок таблицы (пустой массив, если таблицы нет). */
@@ -65,9 +65,11 @@ export function saveTemplate(
65
65
  return normalized;
66
66
  }
67
67
 
68
- /** Удаляет шаблон по id. */
69
- export function deleteTemplate(id: string): void {
70
- getDb().prepare("DELETE FROM templates WHERE id = ?").run(id);
68
+ /** Удаляет шаблон по id или имени (QA-P3.3). */
69
+ export function deleteTemplate(idOrName: string): void {
70
+ getDb()
71
+ .prepare("DELETE FROM templates WHERE id = ? OR name = ?")
72
+ .run(idOrName, idOrName);
71
73
  }
72
74
 
73
75
  /** Количество шаблонов (для миграции и тестов). */