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.
- package/CHANGELOG.md +309 -2
- package/CROSS_PLATFORM.md +19 -0
- package/README.md +55 -8
- package/ROADMAP-STRATEGY.md +22 -19
- package/ROADMAP.md +230 -159
- package/dist/cli.d.ts +3 -0
- package/dist/cli.d.ts.map +1 -0
- package/dist/cli.js +356 -0
- package/dist/core/analytics.d.ts +6 -0
- package/dist/core/analytics.d.ts.map +1 -1
- package/dist/core/analytics.js +20 -3
- package/dist/core/audit.d.ts +6 -0
- package/dist/core/audit.d.ts.map +1 -1
- package/dist/core/audit.js +24 -0
- package/dist/core/budget.d.ts +118 -0
- package/dist/core/budget.d.ts.map +1 -0
- package/dist/core/budget.js +206 -0
- package/dist/core/cron-to-schtasks.d.ts.map +1 -1
- package/dist/core/cron-to-schtasks.js +38 -0
- package/dist/core/dry-run.d.ts +26 -1
- package/dist/core/dry-run.d.ts.map +1 -1
- package/dist/core/dry-run.js +199 -8
- package/dist/core/execution.d.ts +203 -0
- package/dist/core/execution.d.ts.map +1 -0
- package/dist/core/execution.js +309 -0
- package/dist/core/feedback.d.ts +192 -0
- package/dist/core/feedback.d.ts.map +1 -0
- package/dist/core/feedback.js +426 -0
- package/dist/core/gate-integrity.d.ts +71 -0
- package/dist/core/gate-integrity.d.ts.map +1 -0
- package/dist/core/gate-integrity.js +275 -0
- package/dist/core/git-trigger.d.ts.map +1 -1
- package/dist/core/git-trigger.js +14 -2
- package/dist/core/guard-run.d.ts +4 -0
- package/dist/core/guard-run.d.ts.map +1 -0
- package/dist/core/guard-run.js +101 -0
- package/dist/core/guard.d.ts +52 -0
- package/dist/core/guard.d.ts.map +1 -0
- package/dist/core/guard.js +362 -0
- package/dist/core/local-ai.d.ts.map +1 -1
- package/dist/core/local-ai.js +7 -3
- package/dist/core/lock.d.ts +41 -0
- package/dist/core/lock.d.ts.map +1 -1
- package/dist/core/lock.js +141 -29
- package/dist/core/matrix.d.ts +8 -0
- package/dist/core/matrix.d.ts.map +1 -1
- package/dist/core/matrix.js +132 -17
- package/dist/core/mission.d.ts +103 -0
- package/dist/core/mission.d.ts.map +1 -0
- package/dist/core/mission.js +374 -0
- package/dist/core/opencode-models.d.ts +2 -2
- package/dist/core/opencode-models.d.ts.map +1 -1
- package/dist/core/opencode-models.js +28 -21
- package/dist/core/opencode-usage.d.ts +35 -0
- package/dist/core/opencode-usage.d.ts.map +1 -0
- package/dist/core/opencode-usage.js +132 -0
- package/dist/core/pipeline-apply.d.ts +38 -0
- package/dist/core/pipeline-apply.d.ts.map +1 -0
- package/dist/core/pipeline-apply.js +117 -0
- package/dist/core/pipeline-io.d.ts +13 -0
- package/dist/core/pipeline-io.d.ts.map +1 -0
- package/dist/core/pipeline-io.js +78 -0
- package/dist/core/pipeline-map.d.ts +52 -0
- package/dist/core/pipeline-map.d.ts.map +1 -0
- package/dist/core/pipeline-map.js +208 -0
- package/dist/core/pipeline-spec.d.ts +109 -0
- package/dist/core/pipeline-spec.d.ts.map +1 -0
- package/dist/core/pipeline-spec.js +554 -0
- package/dist/core/ps-wrapper.d.ts +27 -2
- package/dist/core/ps-wrapper.d.ts.map +1 -1
- package/dist/core/ps-wrapper.js +424 -65
- package/dist/core/record-history.d.ts.map +1 -1
- package/dist/core/record-history.js +206 -33
- package/dist/core/router/rules.d.ts.map +1 -1
- package/dist/core/router/rules.js +6 -0
- package/dist/core/run-mode.d.ts +12 -0
- package/dist/core/run-mode.d.ts.map +1 -0
- package/dist/core/run-mode.js +17 -0
- package/dist/core/scheduler/linux.d.ts +8 -1
- package/dist/core/scheduler/linux.d.ts.map +1 -1
- package/dist/core/scheduler/linux.js +34 -9
- package/dist/core/scheduler/logs.d.ts +4 -0
- package/dist/core/scheduler/logs.d.ts.map +1 -1
- package/dist/core/scheduler/logs.js +25 -1
- package/dist/core/scheduler/mac.d.ts +44 -2
- package/dist/core/scheduler/mac.d.ts.map +1 -1
- package/dist/core/scheduler/mac.js +126 -15
- package/dist/core/scheduler/windows.d.ts.map +1 -1
- package/dist/core/scheduler/windows.js +15 -12
- package/dist/core/secrets.d.ts.map +1 -1
- package/dist/core/secrets.js +18 -8
- package/dist/core/self-analysis.d.ts +32 -2
- package/dist/core/self-analysis.d.ts.map +1 -1
- package/dist/core/self-analysis.js +38 -27
- package/dist/core/shutdown.d.ts +33 -2
- package/dist/core/shutdown.d.ts.map +1 -1
- package/dist/core/shutdown.js +58 -2
- package/dist/core/structured-log.d.ts +37 -1
- package/dist/core/structured-log.d.ts.map +1 -1
- package/dist/core/structured-log.js +37 -0
- package/dist/core/usage-surface.d.ts +25 -0
- package/dist/core/usage-surface.d.ts.map +1 -0
- package/dist/core/usage-surface.js +41 -0
- package/dist/core/worktree-run.d.ts +4 -0
- package/dist/core/worktree-run.d.ts.map +1 -0
- package/dist/core/worktree-run.js +164 -0
- package/dist/core/worktree.d.ts +115 -0
- package/dist/core/worktree.d.ts.map +1 -0
- package/dist/core/worktree.js +462 -0
- package/dist/core/wrappers/bash.d.ts +19 -0
- package/dist/core/wrappers/bash.d.ts.map +1 -1
- package/dist/core/wrappers/bash.js +230 -27
- package/dist/db/capability-repo.d.ts +43 -2
- package/dist/db/capability-repo.d.ts.map +1 -1
- package/dist/db/capability-repo.js +96 -11
- package/dist/db/history-repo.d.ts +70 -5
- package/dist/db/history-repo.d.ts.map +1 -1
- package/dist/db/history-repo.js +170 -29
- package/dist/db/metrics-repo.d.ts +20 -2
- package/dist/db/metrics-repo.d.ts.map +1 -1
- package/dist/db/metrics-repo.js +35 -13
- package/dist/db/migrate.d.ts.map +1 -1
- package/dist/db/migrate.js +37 -17
- package/dist/db/recovery.d.ts +3 -1
- package/dist/db/recovery.d.ts.map +1 -1
- package/dist/db/recovery.js +11 -5
- package/dist/db/run-journal.d.ts +33 -5
- package/dist/db/run-journal.d.ts.map +1 -1
- package/dist/db/run-journal.js +78 -14
- package/dist/db/run-resume.d.ts +5 -0
- package/dist/db/run-resume.d.ts.map +1 -1
- package/dist/db/run-resume.js +9 -2
- package/dist/db/runs-repo.d.ts +19 -2
- package/dist/db/runs-repo.d.ts.map +1 -1
- package/dist/db/runs-repo.js +91 -60
- package/dist/db/schema.d.ts +2 -2
- package/dist/db/schema.d.ts.map +1 -1
- package/dist/db/schema.js +132 -2
- package/dist/db/templates-repo.d.ts +2 -2
- package/dist/db/templates-repo.d.ts.map +1 -1
- package/dist/db/templates-repo.js +5 -3
- package/dist/history.d.ts +7 -2
- package/dist/history.d.ts.map +1 -1
- package/dist/history.js +4 -2
- package/dist/hook-output.d.ts +2 -0
- package/dist/hook-output.d.ts.map +1 -0
- package/dist/hook-output.js +31 -0
- package/dist/i18n.d.ts +5 -0
- package/dist/i18n.d.ts.map +1 -1
- package/dist/i18n.js +11 -4
- package/dist/index.d.ts +375 -47
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +1344 -192
- package/dist/notifications.d.ts +53 -2
- package/dist/notifications.d.ts.map +1 -1
- package/dist/notifications.js +168 -21
- package/dist/profiles.d.ts.map +1 -1
- package/dist/profiles.js +82 -10
- package/dist/rpc.d.ts +354 -0
- package/dist/rpc.d.ts.map +1 -1
- package/dist/rpc.js +145 -0
- package/dist/server.d.ts +32 -2
- package/dist/server.d.ts.map +1 -1
- package/dist/server.js +154 -30
- package/dist/settings.d.ts +44 -2
- package/dist/settings.d.ts.map +1 -1
- package/dist/settings.js +85 -3
- package/dist/shared/jobs-view.d.ts +1 -1
- package/dist/shared/jobs-view.d.ts.map +1 -1
- package/dist/shared/jobs-view.js +2 -0
- package/dist/task-transfer.d.ts +21 -0
- package/dist/task-transfer.d.ts.map +1 -1
- package/dist/task-transfer.js +64 -3
- package/dist/templates.d.ts +2 -2
- package/dist/templates.d.ts.map +1 -1
- package/dist/templates.js +3 -3
- package/dist/types.d.ts +22 -2
- package/dist/types.d.ts.map +1 -1
- package/dist/workspaces.d.ts.map +1 -1
- package/dist/workspaces.js +34 -11
- package/docs/ARCHITECTURE.md +319 -66
- package/docs/COMPATIBILITY.md +2 -2
- package/docs/CONCEPT.md +18 -4
- package/docs/CROSS_PLATFORM.ru.md +20 -0
- package/docs/CROSS_PLATFORM.zh.md +18 -0
- package/docs/EXECUTION-LOOP.md +28 -10
- package/docs/FEATURES.md +129 -7
- package/docs/FEATURES.zh.md +97 -6
- package/docs/MIGRATION.md +2 -2
- package/docs/PIPELINE.md +293 -0
- package/docs/QA-A2-GUI-TUI.md +205 -0
- package/docs/README.ru.md +43 -4
- package/docs/README.zh.md +44 -4
- package/docs/SAFETY.md +23 -3
- package/gui-experimental.cjs +9 -8
- package/locales/en.json +58 -3
- package/locales/ru.json +58 -3
- package/locales/zh.json +58 -3
- package/opencode.pipeline.yaml +35 -0
- package/package.json +36 -4
- package/scripts/check-eslint-baseline.mjs +139 -0
- package/scripts/gen-test-plan-counters.mjs +117 -0
- package/scripts/github-ci-fetch.ps1 +37 -0
- package/scripts/pl-commit.ps1 +112 -0
- package/scripts/qa-a2-commit.ps1 +104 -0
- package/scripts/test-home.mjs +107 -0
- package/skills/scheduled-job-best-practices/SKILL.md +95 -1
- package/skills/scheduled-job-best-practices/references/recipes.md +139 -0
- package/src/cli.ts +417 -0
- package/src/core/analytics.ts +27 -4
- package/src/core/audit.ts +25 -0
- package/src/core/budget.ts +340 -0
- package/src/core/cron-to-schtasks.ts +42 -0
- package/src/core/dry-run.ts +235 -12
- package/src/core/execution.ts +538 -0
- package/src/core/feedback.ts +582 -0
- package/src/core/file-watcher.ts +2 -2
- package/src/core/gate-integrity.ts +330 -0
- package/src/core/git-trigger.ts +18 -5
- package/src/core/guard-run.ts +119 -0
- package/src/core/guard.ts +431 -0
- package/src/core/local-ai.ts +7 -3
- package/src/core/lock.ts +178 -37
- package/src/core/matrix.ts +158 -52
- package/src/core/mission.ts +531 -0
- package/src/core/native-notify.ts +1 -1
- package/src/core/opencode-models.ts +30 -21
- package/src/core/opencode-usage.ts +182 -0
- package/src/core/pipeline-apply.ts +158 -0
- package/src/core/pipeline-io.ts +96 -0
- package/src/core/pipeline-map.ts +283 -0
- package/src/core/pipeline-spec.ts +775 -0
- package/src/core/ps-wrapper.ts +435 -66
- package/src/core/record-history.ts +258 -81
- package/src/core/router/rules.ts +6 -0
- package/src/core/run-mode.ts +19 -0
- package/src/core/schedule-gate.ts +1 -1
- package/src/core/scheduler/at-fallback.ts +1 -1
- package/src/core/scheduler/linux.ts +40 -11
- package/src/core/scheduler/logs.ts +34 -3
- package/src/core/scheduler/mac.ts +174 -14
- package/src/core/scheduler/registry.ts +2 -2
- package/src/core/scheduler/windows.ts +19 -15
- package/src/core/secrets.ts +26 -19
- package/src/core/self-analysis.ts +75 -29
- package/src/core/shutdown.ts +90 -4
- package/src/core/structured-log.ts +89 -5
- package/src/core/telegram.ts +2 -2
- package/src/core/triage-worker.ts +7 -7
- package/src/core/triage.ts +2 -2
- package/src/core/usage-surface.ts +70 -0
- package/src/core/worktree-run.ts +199 -0
- package/src/core/worktree.ts +600 -0
- package/src/core/wrappers/bash.ts +248 -26
- package/src/db/capability-repo.ts +127 -10
- package/src/db/history-repo.ts +281 -40
- package/src/db/metrics-repo.ts +40 -13
- package/src/db/migrate.ts +57 -32
- package/src/db/recovery.ts +12 -5
- package/src/db/run-journal.ts +100 -13
- package/src/db/run-resume.ts +17 -1
- package/src/db/runs-repo.ts +147 -65
- package/src/db/schema.ts +134 -2
- package/src/db/templates-repo.ts +5 -3
- package/src/gui.tsx +438 -18
- package/src/history.ts +11 -4
- package/src/hook-output.ts +39 -0
- package/src/i18n.ts +12 -4
- package/src/index.ts +1902 -320
- package/src/notifications.ts +227 -47
- package/src/profiles.ts +88 -10
- package/src/rpc.ts +158 -0
- package/src/server.ts +201 -41
- package/src/settings.ts +125 -5
- package/src/shared/jobs-view.ts +3 -1
- package/src/task-transfer.ts +90 -6
- package/src/templates.ts +3 -3
- package/src/types.ts +23 -2
- package/src/workspaces.ts +37 -14
package/src/db/runs-repo.ts
CHANGED
|
@@ -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
|
-
|
|
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(
|
|
184
|
+
return JSON.parse(value);
|
|
126
185
|
} catch {
|
|
127
|
-
return
|
|
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:
|
|
199
|
+
function runRowToRecord(row: SqliteRow): RunRecord {
|
|
141
200
|
return {
|
|
142
|
-
id:
|
|
143
|
-
taskName:
|
|
144
|
-
|
|
145
|
-
|
|
146
|
-
|
|
147
|
-
|
|
148
|
-
|
|
149
|
-
|
|
150
|
-
|
|
151
|
-
|
|
152
|
-
|
|
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:
|
|
216
|
+
function stepRowToRecord(row: SqliteRow): RunStepRecord {
|
|
157
217
|
return {
|
|
158
|
-
id:
|
|
159
|
-
runId:
|
|
160
|
-
stepName:
|
|
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
|
-
|
|
222
|
+
// Доменное приведение: см. комментарий в runRowToRecord.
|
|
223
|
+
status: asText(row.status) as StepStatus,
|
|
163
224
|
attempt: Number(row.attempt) || 1,
|
|
164
|
-
idempotencyKey:
|
|
165
|
-
|
|
166
|
-
|
|
167
|
-
|
|
168
|
-
|
|
169
|
-
|
|
170
|
-
|
|
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 =
|
|
258
|
-
|
|
259
|
-
|
|
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 =
|
|
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
|
|
294
|
-
|
|
295
|
-
|
|
296
|
-
|
|
297
|
-
|
|
298
|
-
|
|
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
|
|
302
|
-
|
|
303
|
-
|
|
304
|
-
|
|
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 =
|
|
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 =
|
|
388
|
-
|
|
389
|
-
|
|
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
|
|
396
|
-
|
|
397
|
-
|
|
398
|
-
|
|
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 =
|
|
407
|
-
|
|
408
|
-
|
|
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,
|
|
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 =
|
|
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 =
|
|
496
|
-
|
|
497
|
-
|
|
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 =
|
|
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
|
/** Имена колонок таблицы (пустой массив, если таблицы нет). */
|
package/src/db/templates-repo.ts
CHANGED
|
@@ -65,9 +65,11 @@ export function saveTemplate(
|
|
|
65
65
|
return normalized;
|
|
66
66
|
}
|
|
67
67
|
|
|
68
|
-
/** Удаляет шаблон по id. */
|
|
69
|
-
export function deleteTemplate(
|
|
70
|
-
getDb()
|
|
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
|
/** Количество шаблонов (для миграции и тестов). */
|