agent-steward 0.0.2 → 0.0.4
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 +45 -2
- package/CROSS_PLATFORM.md +11 -9
- package/README.md +11 -10
- package/ROADMAP-STRATEGY.md +93 -44
- package/ROADMAP.md +148 -1017
- package/dist/core/cron-to-schtasks.d.ts +0 -8
- package/dist/core/cron-to-schtasks.d.ts.map +1 -1
- package/dist/core/cron-to-schtasks.js +11 -86
- package/dist/core/dlq-api.d.ts +44 -0
- package/dist/core/dlq-api.d.ts.map +1 -0
- package/dist/core/dlq-api.js +68 -0
- package/dist/core/dry-run.d.ts.map +1 -1
- package/dist/core/dry-run.js +19 -2
- package/dist/core/file-watcher.js +9 -9
- package/dist/core/git-trigger.js +4 -4
- package/dist/core/lock.d.ts +20 -4
- package/dist/core/lock.d.ts.map +1 -1
- package/dist/core/lock.js +99 -26
- package/dist/core/one-shot.d.ts +31 -5
- package/dist/core/one-shot.d.ts.map +1 -1
- package/dist/core/one-shot.js +78 -10
- package/dist/core/opencode-cli.d.ts +28 -0
- package/dist/core/opencode-cli.d.ts.map +1 -0
- package/dist/core/opencode-cli.js +74 -0
- package/dist/core/opencode-models.d.ts +62 -0
- package/dist/core/opencode-models.d.ts.map +1 -0
- package/dist/core/opencode-models.js +277 -0
- package/dist/core/otel.js +2 -2
- package/dist/core/ps-wrapper.d.ts +1 -1
- package/dist/core/ps-wrapper.d.ts.map +1 -1
- package/dist/core/ps-wrapper.js +66 -36
- package/dist/core/record-history.d.ts +15 -0
- package/dist/core/record-history.d.ts.map +1 -1
- package/dist/core/record-history.js +78 -54
- package/dist/core/router/dispatch.d.ts +36 -0
- package/dist/core/router/dispatch.d.ts.map +1 -0
- package/dist/core/router/dispatch.js +59 -0
- package/dist/core/router/escalation.d.ts +47 -0
- package/dist/core/router/escalation.d.ts.map +1 -0
- package/dist/core/router/escalation.js +87 -0
- package/dist/core/router/planner.d.ts +53 -0
- package/dist/core/router/planner.d.ts.map +1 -0
- package/dist/core/router/planner.js +113 -0
- package/dist/core/router/rules.d.ts +46 -0
- package/dist/core/router/rules.d.ts.map +1 -0
- package/dist/core/router/rules.js +85 -0
- package/dist/core/run-panel-api.d.ts +94 -0
- package/dist/core/run-panel-api.d.ts.map +1 -0
- package/dist/core/run-panel-api.js +169 -0
- package/dist/core/schedule-gate.js +5 -1
- package/dist/core/schedule-v2.d.ts +36 -2
- package/dist/core/schedule-v2.d.ts.map +1 -1
- package/dist/core/schedule-v2.js +98 -12
- package/dist/core/scheduler/at-fallback.d.ts +95 -0
- package/dist/core/scheduler/at-fallback.d.ts.map +1 -0
- package/dist/core/scheduler/at-fallback.js +200 -0
- package/dist/core/scheduler/linux.d.ts +13 -2
- package/dist/core/scheduler/linux.d.ts.map +1 -1
- package/dist/core/scheduler/linux.js +67 -13
- package/dist/core/scheduler/mac.d.ts +14 -8
- package/dist/core/scheduler/mac.d.ts.map +1 -1
- package/dist/core/scheduler/mac.js +71 -22
- package/dist/core/scheduler/posix.d.ts.map +1 -1
- package/dist/core/scheduler/posix.js +37 -2
- package/dist/core/scheduler/registry.d.ts +13 -0
- package/dist/core/scheduler/registry.d.ts.map +1 -1
- package/dist/core/scheduler/registry.js +83 -21
- package/dist/core/scheduler/run-now.d.ts +16 -0
- package/dist/core/scheduler/run-now.d.ts.map +1 -0
- package/dist/core/scheduler/run-now.js +28 -0
- package/dist/core/scheduler/windows.d.ts +16 -3
- package/dist/core/scheduler/windows.d.ts.map +1 -1
- package/dist/core/scheduler/windows.js +249 -96
- package/dist/core/secrets.d.ts.map +1 -1
- package/dist/core/secrets.js +127 -30
- package/dist/core/self-analysis.js +55 -55
- package/dist/core/session.d.ts.map +1 -1
- package/dist/core/session.js +18 -11
- package/dist/core/summary.js +1 -1
- package/dist/core/task-name.d.ts +24 -0
- package/dist/core/task-name.d.ts.map +1 -0
- package/dist/core/task-name.js +40 -0
- package/dist/core/triage-chain.js +1 -1
- package/dist/core/triage-worker.js +2 -2
- package/dist/core/triage.js +1 -1
- package/dist/core/wrappers/bash.d.ts.map +1 -1
- package/dist/core/wrappers/bash.js +82 -37
- package/dist/db/capability-repo.d.ts +83 -0
- package/dist/db/capability-repo.d.ts.map +1 -0
- package/dist/db/capability-repo.js +182 -0
- package/dist/db/history-repo.d.ts +8 -0
- package/dist/db/history-repo.d.ts.map +1 -1
- package/dist/db/history-repo.js +19 -0
- package/dist/db/index.d.ts +6 -0
- package/dist/db/index.d.ts.map +1 -1
- package/dist/db/index.js +48 -2
- package/dist/db/migrate.d.ts.map +1 -1
- package/dist/db/migrate.js +3 -1
- package/dist/db/run-context.d.ts +103 -0
- package/dist/db/run-context.d.ts.map +1 -0
- package/dist/db/run-context.js +224 -0
- package/dist/db/run-dlq.d.ts +100 -0
- package/dist/db/run-dlq.d.ts.map +1 -0
- package/dist/db/run-dlq.js +191 -0
- package/dist/db/run-journal.d.ts +60 -0
- package/dist/db/run-journal.d.ts.map +1 -0
- package/dist/db/run-journal.js +143 -0
- package/dist/db/run-resume.d.ts +51 -0
- package/dist/db/run-resume.d.ts.map +1 -0
- package/dist/db/run-resume.js +156 -0
- package/dist/db/runs-repo.d.ts +128 -0
- package/dist/db/runs-repo.d.ts.map +1 -0
- package/dist/db/runs-repo.js +342 -0
- package/dist/db/schema.d.ts +16 -2
- package/dist/db/schema.d.ts.map +1 -1
- package/dist/db/schema.js +342 -35
- package/dist/db/settings-repo.d.ts +11 -0
- package/dist/db/settings-repo.d.ts.map +1 -1
- package/dist/db/settings-repo.js +25 -0
- package/dist/db/step-idempotency.d.ts +51 -0
- package/dist/db/step-idempotency.d.ts.map +1 -0
- package/dist/db/step-idempotency.js +136 -0
- package/dist/index.d.ts +5 -5
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +168 -40
- package/dist/notifications.js +18 -18
- package/dist/profiles.d.ts +7 -3
- package/dist/profiles.d.ts.map +1 -1
- package/dist/profiles.js +85 -7
- package/dist/rpc.d.ts +787 -0
- package/dist/rpc.d.ts.map +1 -1
- package/dist/rpc.js +324 -0
- package/dist/server.d.ts +33 -2
- package/dist/server.d.ts.map +1 -1
- package/dist/server.js +115 -54
- package/dist/shared/jobs-view.d.ts.map +1 -1
- package/dist/skill.js +1 -1
- package/dist/task-transfer.d.ts +1 -1
- package/dist/task-transfer.d.ts.map +1 -1
- package/dist/task-transfer.js +14 -10
- package/dist/types.d.ts +20 -4
- package/dist/types.d.ts.map +1 -1
- package/dist/types.js +44 -9
- package/dist/workspaces.d.ts +25 -3
- package/dist/workspaces.d.ts.map +1 -1
- package/dist/workspaces.js +44 -9
- package/docs/ARCHITECTURE.md +335 -9
- package/docs/COMPATIBILITY.md +10 -6
- package/docs/CONCEPT.md +183 -91
- package/docs/CROSS_PLATFORM.ru.md +11 -9
- package/docs/CROSS_PLATFORM.zh.md +11 -9
- package/docs/EXECUTION-LOOP.md +196 -0
- package/docs/FAQ.md +2 -2
- package/docs/FAQ.ru.md +2 -2
- package/docs/FAQ.zh.md +2 -2
- package/docs/FEATURES.md +5 -4
- package/docs/FEATURES.zh.md +5 -4
- package/docs/MIGRATION.md +34 -26
- package/docs/README.ru.md +27 -8
- package/docs/README.zh.md +11 -10
- package/docs/SAFETY.md +122 -0
- package/docs/SAVINGS.md +29 -0
- package/docs/SAVINGS.ru.md +29 -0
- package/docs/SAVINGS.zh.md +18 -0
- package/docs/V1-V2-COMPATIBILITY-PLAN.md +6 -6
- package/gui-experimental.cjs +8 -8
- package/index.js +1 -0
- package/locales/en.json +68 -0
- package/locales/ru.json +68 -0
- package/locales/zh.json +68 -0
- package/package.json +57 -11
- package/scripts/audit-bundle.mjs +215 -0
- package/src/core/analytics.ts +2 -2
- package/src/core/audit.ts +17 -17
- package/src/core/cron-to-schtasks.ts +14 -93
- package/src/core/dlq-api.ts +98 -0
- package/src/core/dry-run.ts +51 -27
- package/src/core/file-watcher.ts +17 -17
- package/src/core/git-trigger.ts +9 -9
- package/src/core/glob.ts +1 -1
- package/src/core/local-ai.ts +2 -2
- package/src/core/lock.ts +104 -31
- package/src/core/matrix.ts +31 -31
- package/src/core/native-notify.ts +2 -2
- package/src/core/one-shot.ts +91 -13
- package/src/core/opencode-cli.ts +103 -0
- package/src/core/opencode-models.ts +315 -0
- package/src/core/otel.ts +4 -4
- package/src/core/permissions.ts +5 -5
- package/src/core/prometheus.ts +17 -17
- package/src/core/ps-wrapper.ts +68 -38
- package/src/core/record-history.ts +114 -76
- package/src/core/retention.ts +3 -3
- package/src/core/router/dispatch.ts +94 -0
- package/src/core/router/escalation.ts +129 -0
- package/src/core/router/planner.ts +166 -0
- package/src/core/router/rules.ts +109 -0
- package/src/core/run-panel-api.ts +262 -0
- package/src/core/savings.ts +1 -1
- package/src/core/schedule-gate.ts +17 -13
- package/src/core/schedule-v2.ts +138 -29
- package/src/core/scheduler/at-fallback.ts +298 -0
- package/src/core/scheduler/index.ts +3 -3
- package/src/core/scheduler/linux.ts +92 -19
- package/src/core/scheduler/logs.ts +1 -1
- package/src/core/scheduler/mac.ts +112 -60
- package/src/core/scheduler/posix.ts +35 -2
- package/src/core/scheduler/registry.ts +109 -26
- package/src/core/scheduler/run-now.ts +32 -0
- package/src/core/scheduler/windows.ts +295 -125
- package/src/core/secrets.ts +139 -39
- package/src/core/self-analysis.ts +61 -61
- package/src/core/session.ts +26 -13
- package/src/core/structured-log.ts +3 -3
- package/src/core/summary.ts +25 -25
- package/src/core/task-name.ts +67 -0
- package/src/core/telegram.ts +16 -16
- package/src/core/triage-chain.ts +4 -4
- package/src/core/triage-compare.ts +8 -8
- package/src/core/triage-rules.ts +4 -4
- package/src/core/triage-shadow.ts +7 -7
- package/src/core/triage-worker.ts +6 -6
- package/src/core/triage.ts +23 -23
- package/src/core/watch-paths.ts +1 -1
- package/src/core/wrappers/bash.ts +90 -45
- package/src/db/capability-repo.ts +285 -0
- package/src/db/git-state-repo.ts +1 -1
- package/src/db/history-repo.ts +44 -22
- package/src/db/index.ts +53 -7
- package/src/db/metrics-repo.ts +10 -10
- package/src/db/migrate.ts +13 -11
- package/src/db/recovery.ts +3 -3
- package/src/db/run-context.ts +370 -0
- package/src/db/run-dlq.ts +310 -0
- package/src/db/run-journal.ts +212 -0
- package/src/db/run-resume.ts +256 -0
- package/src/db/runs-repo.ts +504 -0
- package/src/db/schema.ts +357 -44
- package/src/db/settings-repo.ts +33 -2
- package/src/db/step-idempotency.ts +185 -0
- package/src/db/tasks-repo.ts +10 -10
- package/src/db/templates-repo.ts +7 -7
- package/src/gui.tsx +516 -1
- package/src/history.ts +4 -4
- package/src/i18n.ts +7 -7
- package/src/index.ts +465 -308
- package/src/integrations.ts +6 -6
- package/src/notifications.ts +76 -76
- package/src/profiles.ts +98 -7
- package/src/rpc.ts +347 -1
- package/src/schtasks.ts +2 -2
- package/src/server.ts +155 -78
- package/src/settings.ts +44 -44
- package/src/shared/jobs-view.ts +60 -60
- package/src/skill.ts +1 -1
- package/src/task-transfer.ts +58 -56
- package/src/templates.ts +1 -1
- package/src/types.ts +54 -10
- package/src/workspaces.ts +73 -24
- package/dist/core/self-analysis.test.d.ts +0 -2
- package/dist/core/self-analysis.test.d.ts.map +0 -1
- package/dist/core/self-analysis.test.js +0 -219
- package/dist/gui-experimental.cjs +0 -1
package/dist/db/history-repo.js
CHANGED
|
@@ -181,6 +181,25 @@ export function getHistory(taskName, limit = 200, status) {
|
|
|
181
181
|
.all(...params);
|
|
182
182
|
return rows.map(rowToRecord);
|
|
183
183
|
}
|
|
184
|
+
/**
|
|
185
|
+
* Последняя запись по каждой задаче (P2-29).
|
|
186
|
+
*
|
|
187
|
+
* DAG-зависимости нельзя проверять по «последним N записям»: на частой задаче
|
|
188
|
+
* успех зависимости вымывается из окна, и зависимая задача не стартует.
|
|
189
|
+
* Здесь SQL сам выбирает по одной самой свежей записи на задачу.
|
|
190
|
+
*/
|
|
191
|
+
export function getLatestHistoryByTask(limit = 5000) {
|
|
192
|
+
const safeLimit = Math.max(1, Math.min(100000, Math.floor(limit) || 1));
|
|
193
|
+
const rows = getDb()
|
|
194
|
+
.prepare(`SELECT * FROM history
|
|
195
|
+
WHERE id IN (
|
|
196
|
+
SELECT MAX(id) FROM history GROUP BY lower(task_name)
|
|
197
|
+
)
|
|
198
|
+
ORDER BY started_at DESC, id DESC
|
|
199
|
+
LIMIT ?`)
|
|
200
|
+
.all(safeLimit);
|
|
201
|
+
return rows.map(rowToRecord);
|
|
202
|
+
}
|
|
184
203
|
/** История запусков, начатых не раньше timestamp (ISO-строка). */
|
|
185
204
|
export function getHistorySince(timestamp, limit = 5000) {
|
|
186
205
|
const safeLimit = Math.max(1, Math.min(100000, Math.floor(limit) || 1));
|
package/dist/db/index.d.ts
CHANGED
|
@@ -36,10 +36,16 @@ export declare function getDbStatus(): {
|
|
|
36
36
|
file: string;
|
|
37
37
|
journalMode: string;
|
|
38
38
|
wal: boolean;
|
|
39
|
+
schemaVersion: number;
|
|
40
|
+
expectedSchemaVersion: number;
|
|
39
41
|
};
|
|
40
42
|
/**
|
|
41
43
|
* Выполняет функцию в транзакции BEGIN IMMEDIATE.
|
|
42
44
|
* При любой ошибке откатывает изменения и пробрасывает исключение дальше.
|
|
45
|
+
*
|
|
46
|
+
* Вложенный вызов не открывает вторую транзакцию (SQLite это запрещает), а
|
|
47
|
+
* создаёт SAVEPOINT: так композиция вроде «retry из DLQ → reopenRun → retryStep»
|
|
48
|
+
* остаётся атомарной, а внутренний откат не рушит внешнюю транзакцию.
|
|
43
49
|
*/
|
|
44
50
|
export declare function withTransaction<T>(fn: () => T): T;
|
|
45
51
|
/** Пуста ли БД (не считая служебных настроек вроде retry_state). */
|
package/dist/db/index.d.ts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/db/index.ts"],"names":[],"mappings":"AAMA;;;;;;GAMG;AACH,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,MAAM,GAAG,MAAM,CAAC;IACzB,eAAe,EAAE,MAAM,GAAG,MAAM,CAAC;CAClC;AAED,MAAM,WAAW,eAAe;IAC9B,GAAG,CAAC,GAAG,MAAM,EAAE,GAAG,EAAE,GAAG,eAAe,CAAC;IACvC,GAAG,CAAC,GAAG,MAAM,EAAE,GAAG,EAAE,GAAG,GAAG,CAAC;IAC3B,GAAG,CAAC,GAAG,MAAM,EAAE,GAAG,EAAE,GAAG,GAAG,EAAE,CAAC;IAC7B,OAAO,CAAC,GAAG,MAAM,EAAE,GAAG,EAAE,GAAG,gBAAgB,CAAC,GAAG,CAAC,CAAC;CAClD;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,eAAe,CAAC;IACtC,KAAK,IAAI,IAAI,CAAC;CACf;
|
|
1
|
+
{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/db/index.ts"],"names":[],"mappings":"AAMA;;;;;;GAMG;AACH,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,MAAM,GAAG,MAAM,CAAC;IACzB,eAAe,EAAE,MAAM,GAAG,MAAM,CAAC;CAClC;AAED,MAAM,WAAW,eAAe;IAC9B,GAAG,CAAC,GAAG,MAAM,EAAE,GAAG,EAAE,GAAG,eAAe,CAAC;IACvC,GAAG,CAAC,GAAG,MAAM,EAAE,GAAG,EAAE,GAAG,GAAG,CAAC;IAC3B,GAAG,CAAC,GAAG,MAAM,EAAE,GAAG,EAAE,GAAG,GAAG,EAAE,CAAC;IAC7B,OAAO,CAAC,GAAG,MAAM,EAAE,GAAG,EAAE,GAAG,gBAAgB,CAAC,GAAG,CAAC,CAAC;CAClD;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,eAAe,CAAC;IACtC,KAAK,IAAI,IAAI,CAAC;CACf;AA+BD,kEAAkE;AAClE,wBAAgB,MAAM,CAAC,IAAI,GAAE,MAAe,GAAG,cAAc,CA0B5D;AAED,mEAAmE;AACnE,wBAAgB,KAAK,IAAI,cAAc,CAEtC;AAED,8DAA8D;AAC9D,wBAAgB,OAAO,IAAI,IAAI,CAc9B;AAED,+BAA+B;AAC/B,wBAAgB,SAAS,IAAI,MAAM,CAElC;AAED,uEAAuE;AACvE,wBAAgB,YAAY,IAAI,IAAI,CAEnC;AAED,gEAAgE;AAChE,wBAAgB,WAAW,IAAI;IAC7B,MAAM,EAAE,QAAQ,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,GAAG,EAAE,OAAO,CAAC;IACb,aAAa,EAAE,MAAM,CAAC;IACtB,qBAAqB,EAAE,MAAM,CAAC;CAC7B,CAkBF;AAED;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,CAAC,GAAG,CAAC,CAwCjD;AAED,oEAAoE;AACpE,wBAAgB,eAAe,IAAI,OAAO,CAWzC"}
|
package/dist/db/index.js
CHANGED
|
@@ -2,7 +2,7 @@ import fs from "node:fs";
|
|
|
2
2
|
import path from "node:path";
|
|
3
3
|
import { createRequire } from "node:module";
|
|
4
4
|
import { PLUGIN_DIR } from "../types.js";
|
|
5
|
-
import { applySchema } from "./schema.js";
|
|
5
|
+
import { applySchema, getSchemaVersion, SCHEMA_VERSION } from "./schema.js";
|
|
6
6
|
const nodeRequire = createRequire(import.meta.url);
|
|
7
7
|
function loadSqlite() {
|
|
8
8
|
try {
|
|
@@ -20,6 +20,8 @@ const DEFAULT_DB_FILE = process.env.OPENCODE_SCHEDULER_DB?.trim()
|
|
|
20
20
|
: path.join(PLUGIN_DIR, "scheduler.db");
|
|
21
21
|
let dbFile = DEFAULT_DB_FILE;
|
|
22
22
|
let db = null;
|
|
23
|
+
/** Глубина вложенности withTransaction: 0 — транзакции нет, >0 — SAVEPOINT. */
|
|
24
|
+
let transactionDepth = 0;
|
|
23
25
|
/** Открывает (или переоткрывает) соединение и применяет схему. */
|
|
24
26
|
export function initDb(file = dbFile) {
|
|
25
27
|
if (db && file === dbFile)
|
|
@@ -30,10 +32,18 @@ export function initDb(file = dbFile) {
|
|
|
30
32
|
fs.mkdirSync(path.dirname(file), { recursive: true });
|
|
31
33
|
const DatabaseSync = loadSqlite();
|
|
32
34
|
const instance = new DatabaseSync(file);
|
|
35
|
+
// busy_timeout ДОЛЖЕН быть установлен до WAL: при одновременном старте
|
|
36
|
+
// нескольких процессов (каждое завершение задачи — отдельный
|
|
37
|
+
// `node record-history`) переключение journal_mode требует эксклюзивной
|
|
38
|
+
// блокировки. Без таймаута SQLite сразу падает с "database is locked".
|
|
39
|
+
instance.exec("PRAGMA busy_timeout = 5000;");
|
|
33
40
|
// WAL — конкурентное чтение во время записи и устойчивость к сбоям.
|
|
41
|
+
// synchronous = NORMAL в WAL гарантирует, что закоммиченная транзакция
|
|
42
|
+
// переживает падение процесса (шаг 36.1.b); при потере питания может
|
|
43
|
+
// потеряться только последний коммит — это осознанный компромисс.
|
|
34
44
|
instance.exec("PRAGMA journal_mode = WAL;");
|
|
45
|
+
instance.exec("PRAGMA synchronous = NORMAL;");
|
|
35
46
|
instance.exec("PRAGMA foreign_keys = ON;");
|
|
36
|
-
instance.exec("PRAGMA busy_timeout = 5000;");
|
|
37
47
|
applySchema(instance);
|
|
38
48
|
db = instance;
|
|
39
49
|
return instance;
|
|
@@ -44,6 +54,7 @@ export function getDb() {
|
|
|
44
54
|
}
|
|
45
55
|
/** Закрывает соединение (вызывается при выгрузке плагина). */
|
|
46
56
|
export function closeDb() {
|
|
57
|
+
transactionDepth = 0;
|
|
47
58
|
if (!db)
|
|
48
59
|
return;
|
|
49
60
|
try {
|
|
@@ -71,9 +82,11 @@ export function checkpointDb() {
|
|
|
71
82
|
/** Информация о хранилище для /api/health и футера дашборда. */
|
|
72
83
|
export function getDbStatus() {
|
|
73
84
|
let journalMode = "unknown";
|
|
85
|
+
let schemaVersion = 0;
|
|
74
86
|
try {
|
|
75
87
|
const row = getDb().prepare("PRAGMA journal_mode;").get();
|
|
76
88
|
journalMode = String(row?.journal_mode ?? "unknown");
|
|
89
|
+
schemaVersion = getSchemaVersion(getDb());
|
|
77
90
|
}
|
|
78
91
|
catch {
|
|
79
92
|
// Если БД ещё не открыта — не роняем health-check.
|
|
@@ -83,15 +96,45 @@ export function getDbStatus() {
|
|
|
83
96
|
file: dbFile,
|
|
84
97
|
journalMode,
|
|
85
98
|
wal: journalMode.toLowerCase() === "wal",
|
|
99
|
+
schemaVersion,
|
|
100
|
+
expectedSchemaVersion: SCHEMA_VERSION,
|
|
86
101
|
};
|
|
87
102
|
}
|
|
88
103
|
/**
|
|
89
104
|
* Выполняет функцию в транзакции BEGIN IMMEDIATE.
|
|
90
105
|
* При любой ошибке откатывает изменения и пробрасывает исключение дальше.
|
|
106
|
+
*
|
|
107
|
+
* Вложенный вызов не открывает вторую транзакцию (SQLite это запрещает), а
|
|
108
|
+
* создаёт SAVEPOINT: так композиция вроде «retry из DLQ → reopenRun → retryStep»
|
|
109
|
+
* остаётся атомарной, а внутренний откат не рушит внешнюю транзакцию.
|
|
91
110
|
*/
|
|
92
111
|
export function withTransaction(fn) {
|
|
93
112
|
const instance = getDb();
|
|
113
|
+
if (transactionDepth > 0) {
|
|
114
|
+
const savepoint = `sp_nested_${transactionDepth}`;
|
|
115
|
+
instance.exec(`SAVEPOINT ${savepoint};`);
|
|
116
|
+
transactionDepth += 1;
|
|
117
|
+
try {
|
|
118
|
+
const result = fn();
|
|
119
|
+
instance.exec(`RELEASE ${savepoint};`);
|
|
120
|
+
return result;
|
|
121
|
+
}
|
|
122
|
+
catch (err) {
|
|
123
|
+
try {
|
|
124
|
+
instance.exec(`ROLLBACK TO ${savepoint};`);
|
|
125
|
+
instance.exec(`RELEASE ${savepoint};`);
|
|
126
|
+
}
|
|
127
|
+
catch {
|
|
128
|
+
// SAVEPOINT уже снят вместе с внешней транзакцией.
|
|
129
|
+
}
|
|
130
|
+
throw err;
|
|
131
|
+
}
|
|
132
|
+
finally {
|
|
133
|
+
transactionDepth -= 1;
|
|
134
|
+
}
|
|
135
|
+
}
|
|
94
136
|
instance.exec("BEGIN IMMEDIATE;");
|
|
137
|
+
transactionDepth = 1;
|
|
95
138
|
try {
|
|
96
139
|
const result = fn();
|
|
97
140
|
instance.exec("COMMIT;");
|
|
@@ -106,6 +149,9 @@ export function withTransaction(fn) {
|
|
|
106
149
|
}
|
|
107
150
|
throw err;
|
|
108
151
|
}
|
|
152
|
+
finally {
|
|
153
|
+
transactionDepth = 0;
|
|
154
|
+
}
|
|
109
155
|
}
|
|
110
156
|
/** Пуста ли БД (не считая служебных настроек вроде retry_state). */
|
|
111
157
|
export function isDatabaseEmpty() {
|
package/dist/db/migrate.d.ts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"migrate.d.ts","sourceRoot":"","sources":["../../src/db/migrate.ts"],"names":[],"mappings":"AAWA;;;;;;;;;GASG;AAEH,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,OAAO,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB;
|
|
1
|
+
{"version":3,"file":"migrate.d.ts","sourceRoot":"","sources":["../../src/db/migrate.ts"],"names":[],"mappings":"AAWA;;;;;;;;;GASG;AAEH,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,OAAO,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB;AAmFD;;;GAGG;AACH,wBAAsB,eAAe,CACnC,SAAS,GAAE,MAAmB,GAC7B,OAAO,CAAC,eAAe,CAAC,CAmN1B"}
|
package/dist/db/migrate.js
CHANGED
|
@@ -54,7 +54,9 @@ function normalizeHistoryRow(raw) {
|
|
|
54
54
|
const startedAt = typeof raw.startedAt === "string" ? raw.startedAt : "";
|
|
55
55
|
if (!taskName || !startedAt)
|
|
56
56
|
return null;
|
|
57
|
-
const status = raw.status === "success" || raw.status === "
|
|
57
|
+
const status = raw.status === "success" || raw.status === "partial" || raw.status === "timeout"
|
|
58
|
+
? raw.status
|
|
59
|
+
: "error";
|
|
58
60
|
return {
|
|
59
61
|
taskName,
|
|
60
62
|
status,
|
|
@@ -0,0 +1,103 @@
|
|
|
1
|
+
import { type RunRecord } from "./runs-repo.js";
|
|
2
|
+
/**
|
|
3
|
+
* Пауза с инъекцией контекста (Спринт 36.7).
|
|
4
|
+
*
|
|
5
|
+
* На паузе пользователь может оставить комментарий, файл или
|
|
6
|
+
* структурированный артефакт. Запись адресуется конкретному шагу — первому
|
|
7
|
+
* незавершённому на момент паузы либо указанному явно — и передаётся его
|
|
8
|
+
* обработчику при resume ровно один раз. Секреты маскируются при записи,
|
|
9
|
+
* поэтому история контекста безопасна для показа в GUI.
|
|
10
|
+
*/
|
|
11
|
+
/** Вид вложенного контекста. */
|
|
12
|
+
export type InjectionKind = "comment" | "file" | "artifact";
|
|
13
|
+
/** Сохранённая инъекция контекста. */
|
|
14
|
+
export interface RunInjection {
|
|
15
|
+
id: string;
|
|
16
|
+
runId: string;
|
|
17
|
+
/** Шаг, который получит вставку при resume. */
|
|
18
|
+
stepName: string;
|
|
19
|
+
kind: InjectionKind;
|
|
20
|
+
/** Текст комментария, содержимое файла или JSON артефакта (маскировано). */
|
|
21
|
+
content: string;
|
|
22
|
+
/** Кто оставил вставку. */
|
|
23
|
+
author: string;
|
|
24
|
+
/** Дополнительные данные: путь файла, имя артефакта и т.п. */
|
|
25
|
+
metadata: unknown;
|
|
26
|
+
createdAt: string;
|
|
27
|
+
/** Момент передачи шагу; null — вставка ещё ждёт resume. */
|
|
28
|
+
consumedAt: string | null;
|
|
29
|
+
consumedByStep: string | null;
|
|
30
|
+
consumedAttempt: number | null;
|
|
31
|
+
}
|
|
32
|
+
/** Файл, приложенный к паузе. */
|
|
33
|
+
export interface PauseFileInput {
|
|
34
|
+
/** Путь к файлу (обязателен; маскируется как текст). */
|
|
35
|
+
path: string;
|
|
36
|
+
/** Содержимое файла. Без него шаг получает только путь. */
|
|
37
|
+
content?: string;
|
|
38
|
+
/** Человекочитаемое название для истории. */
|
|
39
|
+
title?: string;
|
|
40
|
+
}
|
|
41
|
+
/** Структурированный артефакт, приложенный к паузе. */
|
|
42
|
+
export interface PauseArtifactInput {
|
|
43
|
+
/** Имя артефакта для истории. */
|
|
44
|
+
name?: string;
|
|
45
|
+
/** Любое JSON-сериализуемое значение. */
|
|
46
|
+
content: unknown;
|
|
47
|
+
}
|
|
48
|
+
/** Данные паузы. Все поля необязательны: можно просто приостановить запуск. */
|
|
49
|
+
export interface PauseRunInput {
|
|
50
|
+
/** Явный шаг-получатель. По умолчанию — первый незавершённый. */
|
|
51
|
+
stepName?: string;
|
|
52
|
+
/** Комментарий пользователя. */
|
|
53
|
+
comment?: string;
|
|
54
|
+
/** Приложенный файл. */
|
|
55
|
+
file?: PauseFileInput;
|
|
56
|
+
/** Структурированный артефакт. */
|
|
57
|
+
artifact?: PauseArtifactInput;
|
|
58
|
+
/** Автор вставки; по умолчанию `local-user`. */
|
|
59
|
+
author?: string;
|
|
60
|
+
}
|
|
61
|
+
/** Результат паузы. */
|
|
62
|
+
export interface PauseRunResult {
|
|
63
|
+
run: RunRecord;
|
|
64
|
+
/** Шаг, который получит контекст при resume. */
|
|
65
|
+
stepName: string;
|
|
66
|
+
/** Созданные вставки (может быть пусто при паузе без контекста). */
|
|
67
|
+
injections: RunInjection[];
|
|
68
|
+
}
|
|
69
|
+
/** Контекст, который получает обработчик шага при resume. */
|
|
70
|
+
export interface StepContext {
|
|
71
|
+
/** Непотреблённые вставки, адресованные этому шагу. */
|
|
72
|
+
injections: RunInjection[];
|
|
73
|
+
}
|
|
74
|
+
/** Максимальная длина одной вставки — защита БД и логов от гигантских файлов. */
|
|
75
|
+
export declare const MAX_INJECTION_CONTENT = 100000;
|
|
76
|
+
/** Все вставки запуска в хронологическом порядке (история контекста). */
|
|
77
|
+
export declare function listRunInjections(runId: string, options?: {
|
|
78
|
+
pendingOnly?: boolean;
|
|
79
|
+
}): RunInjection[];
|
|
80
|
+
/** Непотреблённые вставки, адресованные шагу. */
|
|
81
|
+
export declare function pendingInjectionsForStep(runId: string, stepName: string): RunInjection[];
|
|
82
|
+
/** Одна вставка по id (для GUI/диагностики). */
|
|
83
|
+
export declare function getRunInjection(id: string): RunInjection | undefined;
|
|
84
|
+
/**
|
|
85
|
+
* Помечает вставки переданными шагу. Повторный вызов безопасен: уже
|
|
86
|
+
* потреблённые записи не меняются.
|
|
87
|
+
*/
|
|
88
|
+
export declare function consumeInjections(ids: string[], stepName: string, attempt: number, consumedAt?: string): number;
|
|
89
|
+
/**
|
|
90
|
+
* Ставит запуск на паузу и сохраняет контекст.
|
|
91
|
+
*
|
|
92
|
+
* Пауза возможна только между шагами: если какой-то шаг уже выполняется,
|
|
93
|
+
* бросается ошибка — вызывающий код должен дождаться его завершения
|
|
94
|
+
* (в GUI об этом предупреждает 36.8). Контекст адресуется первому
|
|
95
|
+
* незавершённому шагу либо явно указанному `stepName`.
|
|
96
|
+
*/
|
|
97
|
+
export declare function pauseRun(runId: string, input?: PauseRunInput): PauseRunResult;
|
|
98
|
+
/**
|
|
99
|
+
* Помечает вставки завершённых шагов потреблёнными. Вызывается при финале
|
|
100
|
+
* resume, чтобы «зависшая» вставка не выглядела ожидающей в истории.
|
|
101
|
+
*/
|
|
102
|
+
export declare function consumeOrphanInjections(runId: string): number;
|
|
103
|
+
//# sourceMappingURL=run-context.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"run-context.d.ts","sourceRoot":"","sources":["../../src/db/run-context.ts"],"names":[],"mappings":"AAGA,OAAO,EAGL,KAAK,SAAS,EAEf,MAAM,gBAAgB,CAAC;AAGxB;;;;;;;;GAQG;AAEH,gCAAgC;AAChC,MAAM,MAAM,aAAa,GAAG,SAAS,GAAG,MAAM,GAAG,UAAU,CAAC;AAE5D,sCAAsC;AACtC,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,+CAA+C;IAC/C,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,aAAa,CAAC;IACpB,4EAA4E;IAC5E,OAAO,EAAE,MAAM,CAAC;IAChB,2BAA2B;IAC3B,MAAM,EAAE,MAAM,CAAC;IACf,8DAA8D;IAC9D,QAAQ,EAAE,OAAO,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,4DAA4D;IAC5D,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;CAChC;AAED,iCAAiC;AACjC,MAAM,WAAW,cAAc;IAC7B,wDAAwD;IACxD,IAAI,EAAE,MAAM,CAAC;IACb,2DAA2D;IAC3D,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,6CAA6C;IAC7C,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,uDAAuD;AACvD,MAAM,WAAW,kBAAkB;IACjC,iCAAiC;IACjC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,yCAAyC;IACzC,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,+EAA+E;AAC/E,MAAM,WAAW,aAAa;IAC5B,iEAAiE;IACjE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,gCAAgC;IAChC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,wBAAwB;IACxB,IAAI,CAAC,EAAE,cAAc,CAAC;IACtB,kCAAkC;IAClC,QAAQ,CAAC,EAAE,kBAAkB,CAAC;IAC9B,gDAAgD;IAChD,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,uBAAuB;AACvB,MAAM,WAAW,cAAc;IAC7B,GAAG,EAAE,SAAS,CAAC;IACf,gDAAgD;IAChD,QAAQ,EAAE,MAAM,CAAC;IACjB,oEAAoE;IACpE,UAAU,EAAE,YAAY,EAAE,CAAC;CAC5B;AAED,6DAA6D;AAC7D,MAAM,WAAW,WAAW;IAC1B,uDAAuD;IACvD,UAAU,EAAE,YAAY,EAAE,CAAC;CAC5B;AAED,iFAAiF;AACjF,eAAO,MAAM,qBAAqB,SAAU,CAAC;AA2J7C,yEAAyE;AACzE,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,MAAM,EACb,OAAO,GAAE;IAAE,WAAW,CAAC,EAAE,OAAO,CAAA;CAAO,GACtC,YAAY,EAAE,CAOhB;AAED,iDAAiD;AACjD,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,YAAY,EAAE,CAUxF;AAED,gDAAgD;AAChD,wBAAgB,eAAe,CAAC,EAAE,EAAE,MAAM,GAAG,YAAY,GAAG,SAAS,CAGpE;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAC/B,GAAG,EAAE,MAAM,EAAE,EACb,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,EACf,UAAU,SAAW,GACpB,MAAM,CAaR;AAED;;;;;;;GAOG;AACH,wBAAgB,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,GAAE,aAAkB,GAAG,cAAc,CAkCjF;AAED;;;GAGG;AACH,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAkB7D"}
|
|
@@ -0,0 +1,224 @@
|
|
|
1
|
+
import { randomUUID } from "node:crypto";
|
|
2
|
+
import { getDb, withTransaction } from "./index.js";
|
|
3
|
+
import { redactSecretsInText } from "../core/secrets.js";
|
|
4
|
+
import { listRunSteps, pauseRunRecord, } from "./runs-repo.js";
|
|
5
|
+
import { requireRun } from "./run-journal.js";
|
|
6
|
+
/** Максимальная длина одной вставки — защита БД и логов от гигантских файлов. */
|
|
7
|
+
export const MAX_INJECTION_CONTENT = 100000;
|
|
8
|
+
const DEFAULT_AUTHOR = "local-user";
|
|
9
|
+
function nowIso() {
|
|
10
|
+
return new Date().toISOString();
|
|
11
|
+
}
|
|
12
|
+
function parseJson(value) {
|
|
13
|
+
if (value == null)
|
|
14
|
+
return null;
|
|
15
|
+
try {
|
|
16
|
+
return JSON.parse(String(value));
|
|
17
|
+
}
|
|
18
|
+
catch {
|
|
19
|
+
return String(value);
|
|
20
|
+
}
|
|
21
|
+
}
|
|
22
|
+
function isStepDone(status) {
|
|
23
|
+
return status === "passed" || status === "skipped";
|
|
24
|
+
}
|
|
25
|
+
function rowToInjection(row) {
|
|
26
|
+
return {
|
|
27
|
+
id: String(row.id),
|
|
28
|
+
runId: String(row.run_id),
|
|
29
|
+
stepName: String(row.step_name),
|
|
30
|
+
kind: String(row.kind),
|
|
31
|
+
content: String(row.content ?? ""),
|
|
32
|
+
author: String(row.author ?? DEFAULT_AUTHOR),
|
|
33
|
+
metadata: parseJson(row.metadata_json),
|
|
34
|
+
createdAt: String(row.created_at),
|
|
35
|
+
consumedAt: row.consumed_at == null ? null : String(row.consumed_at),
|
|
36
|
+
consumedByStep: row.consumed_by_step == null ? null : String(row.consumed_by_step),
|
|
37
|
+
consumedAttempt: row.consumed_attempt == null ? null : Number(row.consumed_attempt),
|
|
38
|
+
};
|
|
39
|
+
}
|
|
40
|
+
/** Ключ JSON-объекта, значение которого нужно скрыть целиком. */
|
|
41
|
+
const SENSITIVE_KEY_RE = /(?:^|_|[a-z0-9])(?:TOKEN|SECRET|PASSWORD|PASSWD|API_KEY|APIKEY|CREDENTIAL|AUTH)(?:$|_|[A-Z0-9])/i;
|
|
42
|
+
/** Рекурсивно маскирует строки в JSON-значении (для артефактов и metadata). */
|
|
43
|
+
function redactValue(value, depth = 0, seen = new WeakSet()) {
|
|
44
|
+
if (typeof value === "string")
|
|
45
|
+
return redactSecretsInText(value);
|
|
46
|
+
if (value == null || typeof value === "number" || typeof value === "boolean") {
|
|
47
|
+
return value;
|
|
48
|
+
}
|
|
49
|
+
if (depth >= 20)
|
|
50
|
+
return "[truncated]";
|
|
51
|
+
if (typeof value === "object") {
|
|
52
|
+
if (seen.has(value))
|
|
53
|
+
return "[circular]";
|
|
54
|
+
seen.add(value);
|
|
55
|
+
if (Array.isArray(value)) {
|
|
56
|
+
return value.map((item) => redactValue(item, depth + 1, seen));
|
|
57
|
+
}
|
|
58
|
+
const result = {};
|
|
59
|
+
for (const [key, item] of Object.entries(value)) {
|
|
60
|
+
result[key] =
|
|
61
|
+
item != null && SENSITIVE_KEY_RE.test(key) ? "***" : redactValue(item, depth + 1, seen);
|
|
62
|
+
}
|
|
63
|
+
return result;
|
|
64
|
+
}
|
|
65
|
+
return String(value);
|
|
66
|
+
}
|
|
67
|
+
function maskText(value) {
|
|
68
|
+
return redactSecretsInText(value);
|
|
69
|
+
}
|
|
70
|
+
function checkLength(kind, content) {
|
|
71
|
+
if (content.length > MAX_INJECTION_CONTENT) {
|
|
72
|
+
throw new Error(`Контекст паузы (${kind}) слишком длинный: ${content.length} > ${MAX_INJECTION_CONTENT}`);
|
|
73
|
+
}
|
|
74
|
+
return content;
|
|
75
|
+
}
|
|
76
|
+
/** Собирает строки вставок из входных данных, маскируя секреты. */
|
|
77
|
+
function buildInjectionRows(input, stepName) {
|
|
78
|
+
const author = maskText(String(input.author ?? DEFAULT_AUTHOR)).trim() || DEFAULT_AUTHOR;
|
|
79
|
+
const rows = [];
|
|
80
|
+
if (input.comment != null && String(input.comment).length > 0) {
|
|
81
|
+
const content = checkLength("comment", maskText(String(input.comment)));
|
|
82
|
+
rows.push({ stepName, kind: "comment", content, author, metadata: null });
|
|
83
|
+
}
|
|
84
|
+
if (input.file) {
|
|
85
|
+
const filePath = maskText(String(input.file.path ?? "")).trim();
|
|
86
|
+
if (!filePath)
|
|
87
|
+
throw new Error("Путь файла не может быть пустым");
|
|
88
|
+
const content = checkLength("file", maskText(String(input.file.content ?? "")));
|
|
89
|
+
const metadata = redactValue({
|
|
90
|
+
path: filePath,
|
|
91
|
+
...(input.file.title ? { title: maskText(String(input.file.title)) } : {}),
|
|
92
|
+
...(input.file.content != null ? { size: String(input.file.content).length } : {}),
|
|
93
|
+
});
|
|
94
|
+
rows.push({ stepName, kind: "file", content, author, metadata });
|
|
95
|
+
}
|
|
96
|
+
if (input.artifact) {
|
|
97
|
+
if (input.artifact.content === undefined) {
|
|
98
|
+
throw new Error("У артефакта отсутствует content");
|
|
99
|
+
}
|
|
100
|
+
let serialized;
|
|
101
|
+
try {
|
|
102
|
+
serialized = JSON.stringify(redactValue(input.artifact.content));
|
|
103
|
+
}
|
|
104
|
+
catch {
|
|
105
|
+
throw new Error("Артефакт не сериализуется в JSON");
|
|
106
|
+
}
|
|
107
|
+
const content = checkLength("artifact", serialized);
|
|
108
|
+
const metadata = redactValue(input.artifact.name ? { name: maskText(String(input.artifact.name)) } : null);
|
|
109
|
+
rows.push({ stepName, kind: "artifact", content, author, metadata });
|
|
110
|
+
}
|
|
111
|
+
return rows;
|
|
112
|
+
}
|
|
113
|
+
function insertInjection(runId, row, createdAt) {
|
|
114
|
+
const id = randomUUID();
|
|
115
|
+
getDb()
|
|
116
|
+
.prepare(`INSERT INTO run_injections (
|
|
117
|
+
id, run_id, step_name, kind, content, author, metadata_json, created_at
|
|
118
|
+
) VALUES (?, ?, ?, ?, ?, ?, ?, ?)`)
|
|
119
|
+
.run(id, runId, row.stepName, row.kind, row.content, row.author, row.metadata == null ? null : JSON.stringify(row.metadata), createdAt);
|
|
120
|
+
return requireInjection(id);
|
|
121
|
+
}
|
|
122
|
+
function requireInjection(id) {
|
|
123
|
+
const row = getDb().prepare("SELECT * FROM run_injections WHERE id = ?").get(id);
|
|
124
|
+
if (!row)
|
|
125
|
+
throw new Error(`Вставка контекста не найдена: ${id}`);
|
|
126
|
+
return rowToInjection(row);
|
|
127
|
+
}
|
|
128
|
+
/** Все вставки запуска в хронологическом порядке (история контекста). */
|
|
129
|
+
export function listRunInjections(runId, options = {}) {
|
|
130
|
+
const sql = options.pendingOnly
|
|
131
|
+
? `SELECT * FROM run_injections WHERE run_id = ? AND consumed_at IS NULL
|
|
132
|
+
ORDER BY created_at ASC, rowid ASC`
|
|
133
|
+
: `SELECT * FROM run_injections WHERE run_id = ?
|
|
134
|
+
ORDER BY created_at ASC, rowid ASC`;
|
|
135
|
+
return getDb().prepare(sql).all(runId).map(rowToInjection);
|
|
136
|
+
}
|
|
137
|
+
/** Непотреблённые вставки, адресованные шагу. */
|
|
138
|
+
export function pendingInjectionsForStep(runId, stepName) {
|
|
139
|
+
return (getDb()
|
|
140
|
+
.prepare(`SELECT * FROM run_injections
|
|
141
|
+
WHERE run_id = ? AND step_name = ? AND consumed_at IS NULL
|
|
142
|
+
ORDER BY created_at ASC, rowid ASC`)
|
|
143
|
+
.all(runId, stepName)).map(rowToInjection);
|
|
144
|
+
}
|
|
145
|
+
/** Одна вставка по id (для GUI/диагностики). */
|
|
146
|
+
export function getRunInjection(id) {
|
|
147
|
+
const row = getDb().prepare("SELECT * FROM run_injections WHERE id = ?").get(id);
|
|
148
|
+
return row ? rowToInjection(row) : undefined;
|
|
149
|
+
}
|
|
150
|
+
/**
|
|
151
|
+
* Помечает вставки переданными шагу. Повторный вызов безопасен: уже
|
|
152
|
+
* потреблённые записи не меняются.
|
|
153
|
+
*/
|
|
154
|
+
export function consumeInjections(ids, stepName, attempt, consumedAt = nowIso()) {
|
|
155
|
+
if (ids.length === 0)
|
|
156
|
+
return 0;
|
|
157
|
+
const placeholders = ids.map(() => "?").join(", ");
|
|
158
|
+
return withTransaction(() => {
|
|
159
|
+
const result = getDb()
|
|
160
|
+
.prepare(`UPDATE run_injections
|
|
161
|
+
SET consumed_at = ?, consumed_by_step = ?, consumed_attempt = ?
|
|
162
|
+
WHERE consumed_at IS NULL AND id IN (${placeholders})`)
|
|
163
|
+
.run(consumedAt, stepName, attempt, ...ids);
|
|
164
|
+
return Number(result.changes ?? 0);
|
|
165
|
+
});
|
|
166
|
+
}
|
|
167
|
+
/**
|
|
168
|
+
* Ставит запуск на паузу и сохраняет контекст.
|
|
169
|
+
*
|
|
170
|
+
* Пауза возможна только между шагами: если какой-то шаг уже выполняется,
|
|
171
|
+
* бросается ошибка — вызывающий код должен дождаться его завершения
|
|
172
|
+
* (в GUI об этом предупреждает 36.8). Контекст адресуется первому
|
|
173
|
+
* незавершённому шагу либо явно указанному `stepName`.
|
|
174
|
+
*/
|
|
175
|
+
export function pauseRun(runId, input = {}) {
|
|
176
|
+
const run = requireRun(runId);
|
|
177
|
+
if (run.status !== "pending" && run.status !== "running" && run.status !== "paused") {
|
|
178
|
+
throw new Error(`Запуск в статусе ${run.status} нельзя поставить на паузу: ${runId}`);
|
|
179
|
+
}
|
|
180
|
+
const steps = listRunSteps(runId);
|
|
181
|
+
const running = steps.find((step) => step.status === "running");
|
|
182
|
+
if (running) {
|
|
183
|
+
throw new Error(`Шаг ${running.stepName} уже выполняется — пауза возможна после его завершения`);
|
|
184
|
+
}
|
|
185
|
+
let target;
|
|
186
|
+
if (input.stepName != null) {
|
|
187
|
+
target = steps.find((step) => step.stepName === input.stepName);
|
|
188
|
+
if (!target)
|
|
189
|
+
throw new Error(`Шаг не найден: ${runId}/${input.stepName}`);
|
|
190
|
+
if (isStepDone(target.status)) {
|
|
191
|
+
throw new Error(`Шаг ${target.stepName} уже завершён — контекст некуда передать`);
|
|
192
|
+
}
|
|
193
|
+
}
|
|
194
|
+
else {
|
|
195
|
+
target = steps.find((step) => !isStepDone(step.status));
|
|
196
|
+
if (!target)
|
|
197
|
+
throw new Error(`В запуске нет незавершённых шагов: ${runId}`);
|
|
198
|
+
}
|
|
199
|
+
const rows = buildInjectionRows(input, target.stepName);
|
|
200
|
+
const createdAt = nowIso();
|
|
201
|
+
return withTransaction(() => {
|
|
202
|
+
const injections = rows.map((row) => insertInjection(runId, row, createdAt));
|
|
203
|
+
if (run.status !== "paused")
|
|
204
|
+
pauseRunRecord(runId);
|
|
205
|
+
return { run: requireRun(runId), stepName: target.stepName, injections };
|
|
206
|
+
});
|
|
207
|
+
}
|
|
208
|
+
/**
|
|
209
|
+
* Помечает вставки завершённых шагов потреблёнными. Вызывается при финале
|
|
210
|
+
* resume, чтобы «зависшая» вставка не выглядела ожидающей в истории.
|
|
211
|
+
*/
|
|
212
|
+
export function consumeOrphanInjections(runId) {
|
|
213
|
+
const steps = listRunSteps(runId);
|
|
214
|
+
const done = new Set(steps.filter((step) => isStepDone(step.status)).map((step) => step.stepName));
|
|
215
|
+
const pending = listRunInjections(runId, { pendingOnly: true });
|
|
216
|
+
let consumed = 0;
|
|
217
|
+
for (const injection of pending) {
|
|
218
|
+
if (!done.has(injection.stepName))
|
|
219
|
+
continue;
|
|
220
|
+
const step = steps.find((item) => item.stepName === injection.stepName);
|
|
221
|
+
consumed += consumeInjections([injection.id], injection.stepName, step?.attempt ?? 1, injection.createdAt);
|
|
222
|
+
}
|
|
223
|
+
return consumed;
|
|
224
|
+
}
|
|
@@ -0,0 +1,100 @@
|
|
|
1
|
+
import { type RunRecord, type RunStepRecord } from "./runs-repo.js";
|
|
2
|
+
/**
|
|
3
|
+
* Dead-letter queue для durable DAG (Спринт 36.4).
|
|
4
|
+
*
|
|
5
|
+
* DLQ — это не «ещё одна таблица истории», а рабочая очередь: сюда попадают
|
|
6
|
+
* шаги, которые упали не случайно, а исчерпали попытки (по умолчанию три).
|
|
7
|
+
* Дальше человек либо повторяет шаг вручную, либо осознанно отказывается от
|
|
8
|
+
* него — в обоих случаях запись закрывается и больше не висит в очереди.
|
|
9
|
+
*
|
|
10
|
+
* Запись создаётся идемпотентно: на один шаг может быть только одна открытая
|
|
11
|
+
* запись (`idx_run_dlq_open_unique`), поэтому повторный скан не плодит дубли,
|
|
12
|
+
* а ручной retry не оставляет «фантомную» открытую запись.
|
|
13
|
+
*/
|
|
14
|
+
/** Статусы записи DLQ: open → retried/discarded. */
|
|
15
|
+
export type DlqStatus = "open" | "retried" | "discarded";
|
|
16
|
+
/** Почему шаг попал в DLQ. */
|
|
17
|
+
export type DlqReason = "attempts-exhausted" | "manual";
|
|
18
|
+
/** Сколько попыток считается детерминированным падением по умолчанию. */
|
|
19
|
+
export declare const DEFAULT_DLQ_MIN_ATTEMPTS = 3;
|
|
20
|
+
export interface DlqEntry {
|
|
21
|
+
id: string;
|
|
22
|
+
runId: string;
|
|
23
|
+
stepName: string;
|
|
24
|
+
status: DlqStatus;
|
|
25
|
+
reason: DlqReason | string | null;
|
|
26
|
+
error: string | null;
|
|
27
|
+
/** Номер попытки на момент постановки в очередь. */
|
|
28
|
+
attempts: number;
|
|
29
|
+
createdAt: string;
|
|
30
|
+
updatedAt: string;
|
|
31
|
+
resolvedAt: string | null;
|
|
32
|
+
/** Что сделали с записью: manual-retry, discarded и т.п. */
|
|
33
|
+
resolution: string | null;
|
|
34
|
+
}
|
|
35
|
+
export interface EnqueueResult {
|
|
36
|
+
entry: DlqEntry;
|
|
37
|
+
/** false, если открытая запись на этот шаг уже была. */
|
|
38
|
+
created: boolean;
|
|
39
|
+
}
|
|
40
|
+
export interface ScanOptions {
|
|
41
|
+
/** Ограничить скан одним запуском. */
|
|
42
|
+
runId?: string | null;
|
|
43
|
+
/** Порог попыток; по умолчанию {@link DEFAULT_DLQ_MIN_ATTEMPTS}. */
|
|
44
|
+
minAttempts?: number;
|
|
45
|
+
/** Максимум шагов за один скан. */
|
|
46
|
+
limit?: number;
|
|
47
|
+
}
|
|
48
|
+
export interface ListDlqOptions {
|
|
49
|
+
/** open (по умолчанию), конкретный статус или все записи. */
|
|
50
|
+
status?: DlqStatus | "all";
|
|
51
|
+
limit?: number;
|
|
52
|
+
}
|
|
53
|
+
export interface RetryDeadLetterResult {
|
|
54
|
+
entry: DlqEntry;
|
|
55
|
+
step: RunStepRecord;
|
|
56
|
+
run: RunRecord;
|
|
57
|
+
/** true, если запуск был в failed и его пришлось переоткрыть. */
|
|
58
|
+
runReopened: boolean;
|
|
59
|
+
}
|
|
60
|
+
/** Шаг исчерпал попытки и больше не будет повторён автоматически? */
|
|
61
|
+
export declare function isDeadLetterStep(step: Pick<RunStepRecord, "status" | "attempt">, minAttempts?: number): boolean;
|
|
62
|
+
/** Открытая запись DLQ на конкретный шаг (или undefined). */
|
|
63
|
+
export declare function findOpenDeadLetter(runId: string, stepName: string): DlqEntry | undefined;
|
|
64
|
+
/**
|
|
65
|
+
* Ставит шаг в DLQ. Идемпотентно: если открытая запись уже есть, возвращает её
|
|
66
|
+
* с `created: false`. Ошибка шага сохраняется как снимок на момент постановки.
|
|
67
|
+
*/
|
|
68
|
+
export declare function enqueueDeadLetter(runId: string, stepName: string, options?: {
|
|
69
|
+
reason?: DlqReason;
|
|
70
|
+
error?: string | null;
|
|
71
|
+
attempts?: number;
|
|
72
|
+
}): EnqueueResult;
|
|
73
|
+
/**
|
|
74
|
+
* Ищет детерминированно упавшие шаги и ставит их в очередь.
|
|
75
|
+
*
|
|
76
|
+
* Детерминированность здесь прагматичная: шаг в `failed` и `attempt` достиг
|
|
77
|
+
* порога. Автоматические повторы уже не помогут — нужен человек.
|
|
78
|
+
* Возвращает только новые записи, поэтому скан можно вызывать по расписанию.
|
|
79
|
+
*/
|
|
80
|
+
export declare function scanDeadLetters(options?: ScanOptions): DlqEntry[];
|
|
81
|
+
export declare function getDeadLetter(id: string): DlqEntry | undefined;
|
|
82
|
+
/** Записи очереди, новые сверху. По умолчанию — только открытые. */
|
|
83
|
+
export declare function listDeadLetters(options?: ListDlqOptions): DlqEntry[];
|
|
84
|
+
/** Сколько записей в статусе (по умолчанию открытых). */
|
|
85
|
+
export declare function countDeadLetters(status?: DlqStatus): number;
|
|
86
|
+
/**
|
|
87
|
+
* Ручной retry из DLQ.
|
|
88
|
+
*
|
|
89
|
+
* Готовит шаг к повторному выполнению: переоткрывает упавший запуск, переводит
|
|
90
|
+
* шаг в `running` с `attempt + 1` и закрывает запись DLQ как `retried`.
|
|
91
|
+
* Сам обработчик не вызывается — дальше шаг подхватывает `resumeRun`.
|
|
92
|
+
*/
|
|
93
|
+
export declare function retryDeadLetter(id: string, options?: {
|
|
94
|
+
startedAt?: string;
|
|
95
|
+
}): RetryDeadLetterResult;
|
|
96
|
+
/** Осознанный отказ: запись закрывается, шаг остаётся failed. */
|
|
97
|
+
export declare function discardDeadLetter(id: string, resolution?: string): DlqEntry;
|
|
98
|
+
/** Готова ли схема к работе с DLQ (таблица из миграции v5). */
|
|
99
|
+
export declare function isDlqReady(): boolean;
|
|
100
|
+
//# sourceMappingURL=run-dlq.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"run-dlq.d.ts","sourceRoot":"","sources":["../../src/db/run-dlq.ts"],"names":[],"mappings":"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"}
|