agent-steward 0.0.3 → 0.0.5
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +154 -2
- package/CROSS_PLATFORM.md +19 -0
- package/README.md +54 -9
- package/ROADMAP-STRATEGY.md +23 -20
- package/ROADMAP.md +140 -143
- package/dist/cli.d.ts +3 -0
- package/dist/cli.d.ts.map +1 -0
- package/dist/cli.js +351 -0
- 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 +18 -1
- 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/gate-integrity.d.ts +35 -0
- package/dist/core/gate-integrity.d.ts.map +1 -0
- package/dist/core/gate-integrity.js +132 -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/lock.d.ts +61 -4
- package/dist/core/lock.d.ts.map +1 -1
- package/dist/core/lock.js +213 -26
- package/dist/core/matrix.d.ts.map +1 -1
- package/dist/core/matrix.js +75 -15
- package/dist/core/mission.d.ts +83 -0
- package/dist/core/mission.d.ts.map +1 -0
- package/dist/core/mission.js +334 -0
- package/dist/core/one-shot.d.ts +5 -1
- package/dist/core/one-shot.d.ts.map +1 -1
- package/dist/core/one-shot.js +33 -8
- 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/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 +64 -0
- package/dist/core/pipeline-map.d.ts +46 -0
- package/dist/core/pipeline-map.d.ts.map +1 -0
- package/dist/core/pipeline-map.js +196 -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 +19 -2
- package/dist/core/ps-wrapper.d.ts.map +1 -1
- package/dist/core/ps-wrapper.js +261 -63
- 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 +183 -58
- 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 +91 -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 +34 -0
- package/dist/core/schedule-v2.d.ts.map +1 -1
- package/dist/core/schedule-v2.js +91 -5
- package/dist/core/scheduler/at-fallback.d.ts +55 -2
- package/dist/core/scheduler/at-fallback.d.ts.map +1 -1
- package/dist/core/scheduler/at-fallback.js +135 -5
- package/dist/core/scheduler/linux.d.ts +18 -2
- package/dist/core/scheduler/linux.d.ts.map +1 -1
- package/dist/core/scheduler/linux.js +63 -20
- 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/posix.d.ts.map +1 -1
- package/dist/core/scheduler/posix.js +25 -1
- package/dist/core/scheduler/registry.d.ts +11 -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.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 +125 -28
- package/dist/core/session.d.ts.map +1 -1
- package/dist/core/session.js +18 -11
- package/dist/core/structured-log.d.ts +7 -1
- package/dist/core/structured-log.d.ts.map +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/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 +17 -0
- package/dist/core/wrappers/bash.d.ts.map +1 -1
- package/dist/core/wrappers/bash.js +224 -28
- package/dist/db/capability-repo.d.ts +124 -0
- package/dist/db/capability-repo.d.ts.map +1 -0
- package/dist/db/capability-repo.js +267 -0
- package/dist/db/history-repo.d.ts +46 -5
- package/dist/db/history-repo.d.ts.map +1 -1
- package/dist/db/history-repo.js +107 -25
- package/dist/db/index.d.ts +4 -0
- package/dist/db/index.d.ts.map +1 -1
- package/dist/db/index.js +39 -1
- package/dist/db/metrics-repo.js +2 -2
- package/dist/db/migrate.d.ts.map +1 -1
- package/dist/db/migrate.js +3 -1
- package/dist/db/recovery.d.ts.map +1 -1
- package/dist/db/recovery.js +5 -4
- 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 +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 +10 -2
- package/dist/db/run-resume.d.ts.map +1 -1
- package/dist/db/run-resume.js +39 -13
- package/dist/db/runs-repo.d.ts +32 -7
- package/dist/db/runs-repo.d.ts.map +1 -1
- package/dist/db/runs-repo.js +50 -11
- package/dist/db/schema.d.ts +2 -2
- package/dist/db/schema.d.ts.map +1 -1
- package/dist/db/schema.js +216 -3
- 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/history.d.ts +1 -1
- package/dist/history.d.ts.map +1 -1
- 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 +140 -6
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +480 -18
- package/dist/notifications.d.ts +22 -0
- package/dist/notifications.d.ts.map +1 -1
- package/dist/notifications.js +36 -8
- package/dist/profiles.d.ts.map +1 -1
- package/dist/profiles.js +25 -4
- package/dist/rpc.d.ts +924 -0
- package/dist/rpc.d.ts.map +1 -1
- package/dist/rpc.js +352 -0
- package/dist/server.d.ts +46 -0
- package/dist/server.d.ts.map +1 -1
- package/dist/server.js +172 -53
- package/dist/settings.d.ts +2 -2
- package/dist/settings.d.ts.map +1 -1
- package/dist/settings.js +3 -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 +16 -0
- package/dist/task-transfer.d.ts.map +1 -1
- package/dist/task-transfer.js +16 -0
- package/dist/types.d.ts.map +1 -1
- package/dist/types.js +7 -0
- package/dist/workspaces.d.ts +25 -3
- package/dist/workspaces.d.ts.map +1 -1
- package/dist/workspaces.js +43 -8
- package/docs/ARCHITECTURE.md +498 -58
- package/docs/COMPATIBILITY.md +2 -2
- package/docs/CONCEPT.md +185 -91
- package/docs/CROSS_PLATFORM.ru.md +20 -0
- package/docs/CROSS_PLATFORM.zh.md +18 -0
- package/docs/EXECUTION-LOOP.md +211 -0
- package/docs/FEATURES.md +65 -4
- package/docs/FEATURES.zh.md +52 -4
- package/docs/MIGRATION.md +2 -2
- package/docs/PIPELINE.md +293 -0
- package/docs/README.ru.md +44 -5
- package/docs/README.zh.md +46 -6
- package/docs/SAFETY.md +142 -0
- package/docs/SAVINGS.md +29 -0
- package/docs/SAVINGS.ru.md +29 -0
- package/docs/SAVINGS.zh.md +18 -0
- package/gui-experimental.cjs +9 -8
- package/locales/en.json +84 -1
- package/locales/ru.json +84 -1
- package/locales/zh.json +84 -1
- package/opencode.pipeline.yaml +35 -0
- package/package.json +46 -2
- package/scripts/audit-bundle.mjs +215 -0
- package/scripts/test-home.mjs +83 -0
- package/src/cli.ts +412 -0
- package/src/core/dlq-api.ts +98 -0
- package/src/core/dry-run.ts +27 -3
- package/src/core/execution.ts +538 -0
- package/src/core/file-watcher.ts +2 -2
- package/src/core/gate-integrity.ts +160 -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/lock.ts +244 -30
- package/src/core/matrix.ts +95 -50
- package/src/core/mission.ts +485 -0
- package/src/core/native-notify.ts +1 -1
- package/src/core/one-shot.ts +36 -8
- package/src/core/opencode-cli.ts +103 -0
- package/src/core/opencode-models.ts +315 -0
- package/src/core/pipeline-apply.ts +158 -0
- package/src/core/pipeline-io.ts +79 -0
- package/src/core/pipeline-map.ts +264 -0
- package/src/core/pipeline-spec.ts +775 -0
- package/src/core/ps-wrapper.ts +274 -64
- package/src/core/record-history.ts +229 -104
- 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 +115 -0
- package/src/core/run-panel-api.ts +262 -0
- package/src/core/schedule-gate.ts +7 -3
- package/src/core/schedule-v2.ts +114 -5
- package/src/core/scheduler/at-fallback.ts +190 -5
- package/src/core/scheduler/linux.ts +72 -21
- package/src/core/scheduler/logs.ts +2 -2
- package/src/core/scheduler/mac.ts +174 -14
- package/src/core/scheduler/posix.ts +20 -1
- package/src/core/scheduler/registry.ts +107 -26
- package/src/core/scheduler/run-now.ts +32 -0
- package/src/core/scheduler/windows.ts +19 -15
- package/src/core/secrets.ts +131 -31
- package/src/core/session.ts +23 -10
- package/src/core/structured-log.ts +22 -5
- package/src/core/task-name.ts +67 -0
- 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/worktree-run.ts +199 -0
- package/src/core/worktree.ts +600 -0
- package/src/core/wrappers/bash.ts +239 -27
- package/src/db/capability-repo.ts +402 -0
- package/src/db/history-repo.ts +151 -22
- package/src/db/index.ts +37 -1
- package/src/db/metrics-repo.ts +2 -2
- package/src/db/migrate.ts +3 -1
- package/src/db/recovery.ts +5 -4
- package/src/db/run-context.ts +370 -0
- package/src/db/run-dlq.ts +310 -0
- package/src/db/run-journal.ts +100 -13
- package/src/db/run-resume.ts +65 -13
- package/src/db/runs-repo.ts +66 -13
- package/src/db/schema.ts +218 -3
- package/src/db/settings-repo.ts +31 -0
- package/src/db/step-idempotency.ts +185 -0
- package/src/gui.tsx +692 -13
- package/src/history.ts +1 -1
- package/src/i18n.ts +12 -4
- package/src/index.ts +648 -8
- package/src/notifications.ts +38 -8
- package/src/profiles.ts +26 -4
- package/src/rpc.ts +379 -0
- package/src/server.ts +206 -54
- package/src/settings.ts +5 -5
- package/src/shared/jobs-view.ts +3 -1
- package/src/task-transfer.ts +31 -0
- package/src/types.ts +9 -0
- package/src/workspaces.ts +58 -9
package/src/db/index.ts
CHANGED
|
@@ -55,6 +55,8 @@ const DEFAULT_DB_FILE = process.env.OPENCODE_SCHEDULER_DB?.trim()
|
|
|
55
55
|
|
|
56
56
|
let dbFile = DEFAULT_DB_FILE;
|
|
57
57
|
let db: SqliteDatabase | null = null;
|
|
58
|
+
/** Глубина вложенности withTransaction: 0 — транзакции нет, >0 — SAVEPOINT. */
|
|
59
|
+
let transactionDepth = 0;
|
|
58
60
|
|
|
59
61
|
/** Открывает (или переоткрывает) соединение и применяет схему. */
|
|
60
62
|
export function initDb(file: string = dbFile): SqliteDatabase {
|
|
@@ -67,6 +69,11 @@ export function initDb(file: string = dbFile): SqliteDatabase {
|
|
|
67
69
|
const DatabaseSync = loadSqlite();
|
|
68
70
|
const instance = new DatabaseSync(file);
|
|
69
71
|
|
|
72
|
+
// busy_timeout ДОЛЖЕН быть установлен до WAL: при одновременном старте
|
|
73
|
+
// нескольких процессов (каждое завершение задачи — отдельный
|
|
74
|
+
// `node record-history`) переключение journal_mode требует эксклюзивной
|
|
75
|
+
// блокировки. Без таймаута SQLite сразу падает с "database is locked".
|
|
76
|
+
instance.exec("PRAGMA busy_timeout = 5000;");
|
|
70
77
|
// WAL — конкурентное чтение во время записи и устойчивость к сбоям.
|
|
71
78
|
// synchronous = NORMAL в WAL гарантирует, что закоммиченная транзакция
|
|
72
79
|
// переживает падение процесса (шаг 36.1.b); при потере питания может
|
|
@@ -74,7 +81,6 @@ export function initDb(file: string = dbFile): SqliteDatabase {
|
|
|
74
81
|
instance.exec("PRAGMA journal_mode = WAL;");
|
|
75
82
|
instance.exec("PRAGMA synchronous = NORMAL;");
|
|
76
83
|
instance.exec("PRAGMA foreign_keys = ON;");
|
|
77
|
-
instance.exec("PRAGMA busy_timeout = 5000;");
|
|
78
84
|
applySchema(instance);
|
|
79
85
|
|
|
80
86
|
db = instance;
|
|
@@ -88,6 +94,7 @@ export function getDb(): SqliteDatabase {
|
|
|
88
94
|
|
|
89
95
|
/** Закрывает соединение (вызывается при выгрузке плагина). */
|
|
90
96
|
export function closeDb(): void {
|
|
97
|
+
transactionDepth = 0;
|
|
91
98
|
if (!db) return;
|
|
92
99
|
try {
|
|
93
100
|
db.exec("PRAGMA wal_checkpoint(TRUNCATE);");
|
|
@@ -143,10 +150,37 @@ export function getDbStatus(): {
|
|
|
143
150
|
/**
|
|
144
151
|
* Выполняет функцию в транзакции BEGIN IMMEDIATE.
|
|
145
152
|
* При любой ошибке откатывает изменения и пробрасывает исключение дальше.
|
|
153
|
+
*
|
|
154
|
+
* Вложенный вызов не открывает вторую транзакцию (SQLite это запрещает), а
|
|
155
|
+
* создаёт SAVEPOINT: так композиция вроде «retry из DLQ → reopenRun → retryStep»
|
|
156
|
+
* остаётся атомарной, а внутренний откат не рушит внешнюю транзакцию.
|
|
146
157
|
*/
|
|
147
158
|
export function withTransaction<T>(fn: () => T): T {
|
|
148
159
|
const instance = getDb();
|
|
160
|
+
|
|
161
|
+
if (transactionDepth > 0) {
|
|
162
|
+
const savepoint = `sp_nested_${transactionDepth}`;
|
|
163
|
+
instance.exec(`SAVEPOINT ${savepoint};`);
|
|
164
|
+
transactionDepth += 1;
|
|
165
|
+
try {
|
|
166
|
+
const result = fn();
|
|
167
|
+
instance.exec(`RELEASE ${savepoint};`);
|
|
168
|
+
return result;
|
|
169
|
+
} catch (err) {
|
|
170
|
+
try {
|
|
171
|
+
instance.exec(`ROLLBACK TO ${savepoint};`);
|
|
172
|
+
instance.exec(`RELEASE ${savepoint};`);
|
|
173
|
+
} catch {
|
|
174
|
+
// SAVEPOINT уже снят вместе с внешней транзакцией.
|
|
175
|
+
}
|
|
176
|
+
throw err;
|
|
177
|
+
} finally {
|
|
178
|
+
transactionDepth -= 1;
|
|
179
|
+
}
|
|
180
|
+
}
|
|
181
|
+
|
|
149
182
|
instance.exec("BEGIN IMMEDIATE;");
|
|
183
|
+
transactionDepth = 1;
|
|
150
184
|
try {
|
|
151
185
|
const result = fn();
|
|
152
186
|
instance.exec("COMMIT;");
|
|
@@ -158,6 +192,8 @@ export function withTransaction<T>(fn: () => T): T {
|
|
|
158
192
|
// Откат мог не понадобиться (например, SQLite уже откатил сам).
|
|
159
193
|
}
|
|
160
194
|
throw err;
|
|
195
|
+
} finally {
|
|
196
|
+
transactionDepth = 0;
|
|
161
197
|
}
|
|
162
198
|
}
|
|
163
199
|
|
package/src/db/metrics-repo.ts
CHANGED
|
@@ -57,8 +57,8 @@ export function incrementMetricsUnsafe(
|
|
|
57
57
|
tokens = 0,
|
|
58
58
|
costUsd = 0,
|
|
59
59
|
): void {
|
|
60
|
-
// error — только ошибки и таймауты; partial
|
|
61
|
-
//
|
|
60
|
+
// error — только ошибки и таймауты; partial и skipped хранятся отдельно
|
|
61
|
+
// (skipped увеличивает только total: запуск не расходовал токены и не завершился).
|
|
62
62
|
const success = status === "success" ? 1 : 0;
|
|
63
63
|
const partial = status === "partial" ? 1 : 0;
|
|
64
64
|
const error = status === "error" || status === "timeout" ? 1 : 0;
|
package/src/db/migrate.ts
CHANGED
|
@@ -90,7 +90,9 @@ function normalizeHistoryRow(raw: any): any | null {
|
|
|
90
90
|
if (!taskName || !startedAt) return null;
|
|
91
91
|
|
|
92
92
|
const status =
|
|
93
|
-
raw.status === "success" || raw.status === "
|
|
93
|
+
raw.status === "success" || raw.status === "partial" || raw.status === "timeout"
|
|
94
|
+
? raw.status
|
|
95
|
+
: "error";
|
|
94
96
|
|
|
95
97
|
return {
|
|
96
98
|
taskName,
|
package/src/db/recovery.ts
CHANGED
|
@@ -12,13 +12,14 @@ const JSON_FILES = ["tasks.json", "history.json", "metrics.json", "templates.jso
|
|
|
12
12
|
* Вызывается при setup() до запуска catch-up и файловых триггеров.
|
|
13
13
|
*/
|
|
14
14
|
export function recoverInterruptedRuns(): number {
|
|
15
|
-
const
|
|
16
|
-
if (
|
|
15
|
+
const { recovered, keptAlive } = recoverInterrupted();
|
|
16
|
+
if (recovered > 0 || keptAlive > 0) {
|
|
17
17
|
console.log(
|
|
18
|
-
`[recovery] Восстановлено ${
|
|
18
|
+
`[recovery] Восстановлено ${recovered} незавершённых записей истории — помечены как error.` +
|
|
19
|
+
(keptAlive > 0 ? ` Оставлено живым владельцам: ${keptAlive}.` : ""),
|
|
19
20
|
);
|
|
20
21
|
}
|
|
21
|
-
return
|
|
22
|
+
return recovered;
|
|
22
23
|
}
|
|
23
24
|
|
|
24
25
|
/**
|
|
@@ -0,0 +1,370 @@
|
|
|
1
|
+
import { randomUUID } from "node:crypto";
|
|
2
|
+
import { getDb, withTransaction } from "./index.js";
|
|
3
|
+
import { redactSecretsInText } from "../core/secrets.js";
|
|
4
|
+
import {
|
|
5
|
+
listRunSteps,
|
|
6
|
+
pauseRunRecord,
|
|
7
|
+
type RunRecord,
|
|
8
|
+
type RunStepRecord,
|
|
9
|
+
} from "./runs-repo.js";
|
|
10
|
+
import { requireRun } from "./run-journal.js";
|
|
11
|
+
|
|
12
|
+
/**
|
|
13
|
+
* Пауза с инъекцией контекста (Спринт 36.7).
|
|
14
|
+
*
|
|
15
|
+
* На паузе пользователь может оставить комментарий, файл или
|
|
16
|
+
* структурированный артефакт. Запись адресуется конкретному шагу — первому
|
|
17
|
+
* незавершённому на момент паузы либо указанному явно — и передаётся его
|
|
18
|
+
* обработчику при resume ровно один раз. Секреты маскируются при записи,
|
|
19
|
+
* поэтому история контекста безопасна для показа в GUI.
|
|
20
|
+
*/
|
|
21
|
+
|
|
22
|
+
/** Вид вложенного контекста. */
|
|
23
|
+
export type InjectionKind = "comment" | "file" | "artifact";
|
|
24
|
+
|
|
25
|
+
/** Сохранённая инъекция контекста. */
|
|
26
|
+
export interface RunInjection {
|
|
27
|
+
id: string;
|
|
28
|
+
runId: string;
|
|
29
|
+
/** Шаг, который получит вставку при resume. */
|
|
30
|
+
stepName: string;
|
|
31
|
+
kind: InjectionKind;
|
|
32
|
+
/** Текст комментария, содержимое файла или JSON артефакта (маскировано). */
|
|
33
|
+
content: string;
|
|
34
|
+
/** Кто оставил вставку. */
|
|
35
|
+
author: string;
|
|
36
|
+
/** Дополнительные данные: путь файла, имя артефакта и т.п. */
|
|
37
|
+
metadata: unknown;
|
|
38
|
+
createdAt: string;
|
|
39
|
+
/** Момент передачи шагу; null — вставка ещё ждёт resume. */
|
|
40
|
+
consumedAt: string | null;
|
|
41
|
+
consumedByStep: string | null;
|
|
42
|
+
consumedAttempt: number | null;
|
|
43
|
+
}
|
|
44
|
+
|
|
45
|
+
/** Файл, приложенный к паузе. */
|
|
46
|
+
export interface PauseFileInput {
|
|
47
|
+
/** Путь к файлу (обязателен; маскируется как текст). */
|
|
48
|
+
path: string;
|
|
49
|
+
/** Содержимое файла. Без него шаг получает только путь. */
|
|
50
|
+
content?: string;
|
|
51
|
+
/** Человекочитаемое название для истории. */
|
|
52
|
+
title?: string;
|
|
53
|
+
}
|
|
54
|
+
|
|
55
|
+
/** Структурированный артефакт, приложенный к паузе. */
|
|
56
|
+
export interface PauseArtifactInput {
|
|
57
|
+
/** Имя артефакта для истории. */
|
|
58
|
+
name?: string;
|
|
59
|
+
/** Любое JSON-сериализуемое значение. */
|
|
60
|
+
content: unknown;
|
|
61
|
+
}
|
|
62
|
+
|
|
63
|
+
/** Данные паузы. Все поля необязательны: можно просто приостановить запуск. */
|
|
64
|
+
export interface PauseRunInput {
|
|
65
|
+
/** Явный шаг-получатель. По умолчанию — первый незавершённый. */
|
|
66
|
+
stepName?: string;
|
|
67
|
+
/** Комментарий пользователя. */
|
|
68
|
+
comment?: string;
|
|
69
|
+
/** Приложенный файл. */
|
|
70
|
+
file?: PauseFileInput;
|
|
71
|
+
/** Структурированный артефакт. */
|
|
72
|
+
artifact?: PauseArtifactInput;
|
|
73
|
+
/** Автор вставки; по умолчанию `local-user`. */
|
|
74
|
+
author?: string;
|
|
75
|
+
}
|
|
76
|
+
|
|
77
|
+
/** Результат паузы. */
|
|
78
|
+
export interface PauseRunResult {
|
|
79
|
+
run: RunRecord;
|
|
80
|
+
/** Шаг, который получит контекст при resume. */
|
|
81
|
+
stepName: string;
|
|
82
|
+
/** Созданные вставки (может быть пусто при паузе без контекста). */
|
|
83
|
+
injections: RunInjection[];
|
|
84
|
+
}
|
|
85
|
+
|
|
86
|
+
/** Контекст, который получает обработчик шага при resume. */
|
|
87
|
+
export interface StepContext {
|
|
88
|
+
/** Непотреблённые вставки, адресованные этому шагу. */
|
|
89
|
+
injections: RunInjection[];
|
|
90
|
+
}
|
|
91
|
+
|
|
92
|
+
/** Максимальная длина одной вставки — защита БД и логов от гигантских файлов. */
|
|
93
|
+
export const MAX_INJECTION_CONTENT = 100_000;
|
|
94
|
+
|
|
95
|
+
const DEFAULT_AUTHOR = "local-user";
|
|
96
|
+
|
|
97
|
+
function nowIso(): string {
|
|
98
|
+
return new Date().toISOString();
|
|
99
|
+
}
|
|
100
|
+
|
|
101
|
+
function parseJson(value: unknown): unknown {
|
|
102
|
+
if (value == null) return null;
|
|
103
|
+
try {
|
|
104
|
+
return JSON.parse(String(value));
|
|
105
|
+
} catch {
|
|
106
|
+
return String(value);
|
|
107
|
+
}
|
|
108
|
+
}
|
|
109
|
+
|
|
110
|
+
function isStepDone(status: RunStepRecord["status"]): boolean {
|
|
111
|
+
return status === "passed" || status === "skipped";
|
|
112
|
+
}
|
|
113
|
+
|
|
114
|
+
function rowToInjection(row: any): RunInjection {
|
|
115
|
+
return {
|
|
116
|
+
id: String(row.id),
|
|
117
|
+
runId: String(row.run_id),
|
|
118
|
+
stepName: String(row.step_name),
|
|
119
|
+
kind: String(row.kind) as InjectionKind,
|
|
120
|
+
content: String(row.content ?? ""),
|
|
121
|
+
author: String(row.author ?? DEFAULT_AUTHOR),
|
|
122
|
+
metadata: parseJson(row.metadata_json),
|
|
123
|
+
createdAt: String(row.created_at),
|
|
124
|
+
consumedAt: row.consumed_at == null ? null : String(row.consumed_at),
|
|
125
|
+
consumedByStep: row.consumed_by_step == null ? null : String(row.consumed_by_step),
|
|
126
|
+
consumedAttempt:
|
|
127
|
+
row.consumed_attempt == null ? null : Number(row.consumed_attempt),
|
|
128
|
+
};
|
|
129
|
+
}
|
|
130
|
+
|
|
131
|
+
/** Ключ JSON-объекта, значение которого нужно скрыть целиком. */
|
|
132
|
+
const SENSITIVE_KEY_RE =
|
|
133
|
+
/(?:^|_|[a-z0-9])(?:TOKEN|SECRET|PASSWORD|PASSWD|API_KEY|APIKEY|CREDENTIAL|AUTH)(?:$|_|[A-Z0-9])/i;
|
|
134
|
+
|
|
135
|
+
/** Рекурсивно маскирует строки в JSON-значении (для артефактов и metadata). */
|
|
136
|
+
function redactValue(value: unknown, depth = 0, seen = new WeakSet<object>()): unknown {
|
|
137
|
+
if (typeof value === "string") return redactSecretsInText(value);
|
|
138
|
+
if (value == null || typeof value === "number" || typeof value === "boolean") {
|
|
139
|
+
return value;
|
|
140
|
+
}
|
|
141
|
+
if (depth >= 20) return "[truncated]";
|
|
142
|
+
if (typeof value === "object") {
|
|
143
|
+
if (seen.has(value)) return "[circular]";
|
|
144
|
+
seen.add(value);
|
|
145
|
+
if (Array.isArray(value)) {
|
|
146
|
+
return value.map((item) => redactValue(item, depth + 1, seen));
|
|
147
|
+
}
|
|
148
|
+
const result: Record<string, unknown> = {};
|
|
149
|
+
for (const [key, item] of Object.entries(value as Record<string, unknown>)) {
|
|
150
|
+
result[key] =
|
|
151
|
+
item != null && SENSITIVE_KEY_RE.test(key) ? "***" : redactValue(item, depth + 1, seen);
|
|
152
|
+
}
|
|
153
|
+
return result;
|
|
154
|
+
}
|
|
155
|
+
return String(value);
|
|
156
|
+
}
|
|
157
|
+
|
|
158
|
+
function maskText(value: string): string {
|
|
159
|
+
return redactSecretsInText(value);
|
|
160
|
+
}
|
|
161
|
+
|
|
162
|
+
function checkLength(kind: InjectionKind, content: string): string {
|
|
163
|
+
if (content.length > MAX_INJECTION_CONTENT) {
|
|
164
|
+
throw new Error(
|
|
165
|
+
`Контекст паузы (${kind}) слишком длинный: ${content.length} > ${MAX_INJECTION_CONTENT}`,
|
|
166
|
+
);
|
|
167
|
+
}
|
|
168
|
+
return content;
|
|
169
|
+
}
|
|
170
|
+
|
|
171
|
+
interface InjectionRow {
|
|
172
|
+
stepName: string;
|
|
173
|
+
kind: InjectionKind;
|
|
174
|
+
content: string;
|
|
175
|
+
author: string;
|
|
176
|
+
metadata: unknown;
|
|
177
|
+
}
|
|
178
|
+
|
|
179
|
+
/** Собирает строки вставок из входных данных, маскируя секреты. */
|
|
180
|
+
function buildInjectionRows(input: PauseRunInput, stepName: string): InjectionRow[] {
|
|
181
|
+
const author = maskText(String(input.author ?? DEFAULT_AUTHOR)).trim() || DEFAULT_AUTHOR;
|
|
182
|
+
const rows: InjectionRow[] = [];
|
|
183
|
+
|
|
184
|
+
if (input.comment != null && String(input.comment).length > 0) {
|
|
185
|
+
const content = checkLength("comment", maskText(String(input.comment)));
|
|
186
|
+
rows.push({ stepName, kind: "comment", content, author, metadata: null });
|
|
187
|
+
}
|
|
188
|
+
|
|
189
|
+
if (input.file) {
|
|
190
|
+
const filePath = maskText(String(input.file.path ?? "")).trim();
|
|
191
|
+
if (!filePath) throw new Error("Путь файла не может быть пустым");
|
|
192
|
+
const content = checkLength("file", maskText(String(input.file.content ?? "")));
|
|
193
|
+
const metadata = redactValue({
|
|
194
|
+
path: filePath,
|
|
195
|
+
...(input.file.title ? { title: maskText(String(input.file.title)) } : {}),
|
|
196
|
+
...(input.file.content != null ? { size: String(input.file.content).length } : {}),
|
|
197
|
+
});
|
|
198
|
+
rows.push({ stepName, kind: "file", content, author, metadata });
|
|
199
|
+
}
|
|
200
|
+
|
|
201
|
+
if (input.artifact) {
|
|
202
|
+
if (input.artifact.content === undefined) {
|
|
203
|
+
throw new Error("У артефакта отсутствует content");
|
|
204
|
+
}
|
|
205
|
+
let serialized: string;
|
|
206
|
+
try {
|
|
207
|
+
serialized = JSON.stringify(redactValue(input.artifact.content));
|
|
208
|
+
} catch {
|
|
209
|
+
throw new Error("Артефакт не сериализуется в JSON");
|
|
210
|
+
}
|
|
211
|
+
const content = checkLength("artifact", serialized);
|
|
212
|
+
const metadata = redactValue(
|
|
213
|
+
input.artifact.name ? { name: maskText(String(input.artifact.name)) } : null,
|
|
214
|
+
);
|
|
215
|
+
rows.push({ stepName, kind: "artifact", content, author, metadata });
|
|
216
|
+
}
|
|
217
|
+
|
|
218
|
+
return rows;
|
|
219
|
+
}
|
|
220
|
+
|
|
221
|
+
function insertInjection(runId: string, row: InjectionRow, createdAt: string): RunInjection {
|
|
222
|
+
const id = randomUUID();
|
|
223
|
+
getDb()
|
|
224
|
+
.prepare(
|
|
225
|
+
`INSERT INTO run_injections (
|
|
226
|
+
id, run_id, step_name, kind, content, author, metadata_json, created_at
|
|
227
|
+
) VALUES (?, ?, ?, ?, ?, ?, ?, ?)`,
|
|
228
|
+
)
|
|
229
|
+
.run(
|
|
230
|
+
id,
|
|
231
|
+
runId,
|
|
232
|
+
row.stepName,
|
|
233
|
+
row.kind,
|
|
234
|
+
row.content,
|
|
235
|
+
row.author,
|
|
236
|
+
row.metadata == null ? null : JSON.stringify(row.metadata),
|
|
237
|
+
createdAt,
|
|
238
|
+
);
|
|
239
|
+
return requireInjection(id);
|
|
240
|
+
}
|
|
241
|
+
|
|
242
|
+
function requireInjection(id: string): RunInjection {
|
|
243
|
+
const row = getDb().prepare("SELECT * FROM run_injections WHERE id = ?").get(id);
|
|
244
|
+
if (!row) throw new Error(`Вставка контекста не найдена: ${id}`);
|
|
245
|
+
return rowToInjection(row);
|
|
246
|
+
}
|
|
247
|
+
|
|
248
|
+
/** Все вставки запуска в хронологическом порядке (история контекста). */
|
|
249
|
+
export function listRunInjections(
|
|
250
|
+
runId: string,
|
|
251
|
+
options: { pendingOnly?: boolean } = {},
|
|
252
|
+
): RunInjection[] {
|
|
253
|
+
const sql = options.pendingOnly
|
|
254
|
+
? `SELECT * FROM run_injections WHERE run_id = ? AND consumed_at IS NULL
|
|
255
|
+
ORDER BY created_at ASC, rowid ASC`
|
|
256
|
+
: `SELECT * FROM run_injections WHERE run_id = ?
|
|
257
|
+
ORDER BY created_at ASC, rowid ASC`;
|
|
258
|
+
return getDb().prepare(sql).all(runId).map(rowToInjection);
|
|
259
|
+
}
|
|
260
|
+
|
|
261
|
+
/** Непотреблённые вставки, адресованные шагу. */
|
|
262
|
+
export function pendingInjectionsForStep(runId: string, stepName: string): RunInjection[] {
|
|
263
|
+
return (
|
|
264
|
+
getDb()
|
|
265
|
+
.prepare(
|
|
266
|
+
`SELECT * FROM run_injections
|
|
267
|
+
WHERE run_id = ? AND step_name = ? AND consumed_at IS NULL
|
|
268
|
+
ORDER BY created_at ASC, rowid ASC`,
|
|
269
|
+
)
|
|
270
|
+
.all(runId, stepName)
|
|
271
|
+
).map(rowToInjection);
|
|
272
|
+
}
|
|
273
|
+
|
|
274
|
+
/** Одна вставка по id (для GUI/диагностики). */
|
|
275
|
+
export function getRunInjection(id: string): RunInjection | undefined {
|
|
276
|
+
const row = getDb().prepare("SELECT * FROM run_injections WHERE id = ?").get(id);
|
|
277
|
+
return row ? rowToInjection(row) : undefined;
|
|
278
|
+
}
|
|
279
|
+
|
|
280
|
+
/**
|
|
281
|
+
* Помечает вставки переданными шагу. Повторный вызов безопасен: уже
|
|
282
|
+
* потреблённые записи не меняются.
|
|
283
|
+
*/
|
|
284
|
+
export function consumeInjections(
|
|
285
|
+
ids: string[],
|
|
286
|
+
stepName: string,
|
|
287
|
+
attempt: number,
|
|
288
|
+
consumedAt = nowIso(),
|
|
289
|
+
): number {
|
|
290
|
+
if (ids.length === 0) return 0;
|
|
291
|
+
const placeholders = ids.map(() => "?").join(", ");
|
|
292
|
+
return withTransaction(() => {
|
|
293
|
+
const result = getDb()
|
|
294
|
+
.prepare(
|
|
295
|
+
`UPDATE run_injections
|
|
296
|
+
SET consumed_at = ?, consumed_by_step = ?, consumed_attempt = ?
|
|
297
|
+
WHERE consumed_at IS NULL AND id IN (${placeholders})`,
|
|
298
|
+
)
|
|
299
|
+
.run(consumedAt, stepName, attempt, ...ids) as { changes?: number };
|
|
300
|
+
return Number(result.changes ?? 0);
|
|
301
|
+
});
|
|
302
|
+
}
|
|
303
|
+
|
|
304
|
+
/**
|
|
305
|
+
* Ставит запуск на паузу и сохраняет контекст.
|
|
306
|
+
*
|
|
307
|
+
* Пауза возможна только между шагами: если какой-то шаг уже выполняется,
|
|
308
|
+
* бросается ошибка — вызывающий код должен дождаться его завершения
|
|
309
|
+
* (в GUI об этом предупреждает 36.8). Контекст адресуется первому
|
|
310
|
+
* незавершённому шагу либо явно указанному `stepName`.
|
|
311
|
+
*/
|
|
312
|
+
export function pauseRun(runId: string, input: PauseRunInput = {}): PauseRunResult {
|
|
313
|
+
const run = requireRun(runId);
|
|
314
|
+
if (run.status !== "pending" && run.status !== "running" && run.status !== "paused") {
|
|
315
|
+
throw new Error(`Запуск в статусе ${run.status} нельзя поставить на паузу: ${runId}`);
|
|
316
|
+
}
|
|
317
|
+
|
|
318
|
+
const steps = listRunSteps(runId);
|
|
319
|
+
const running = steps.find((step) => step.status === "running");
|
|
320
|
+
if (running) {
|
|
321
|
+
throw new Error(
|
|
322
|
+
`Шаг ${running.stepName} уже выполняется — пауза возможна после его завершения`,
|
|
323
|
+
);
|
|
324
|
+
}
|
|
325
|
+
|
|
326
|
+
let target: RunStepRecord | undefined;
|
|
327
|
+
if (input.stepName != null) {
|
|
328
|
+
target = steps.find((step) => step.stepName === input.stepName);
|
|
329
|
+
if (!target) throw new Error(`Шаг не найден: ${runId}/${input.stepName}`);
|
|
330
|
+
if (isStepDone(target.status)) {
|
|
331
|
+
throw new Error(`Шаг ${target.stepName} уже завершён — контекст некуда передать`);
|
|
332
|
+
}
|
|
333
|
+
} else {
|
|
334
|
+
target = steps.find((step) => !isStepDone(step.status));
|
|
335
|
+
if (!target) throw new Error(`В запуске нет незавершённых шагов: ${runId}`);
|
|
336
|
+
}
|
|
337
|
+
|
|
338
|
+
const rows = buildInjectionRows(input, target.stepName);
|
|
339
|
+
const createdAt = nowIso();
|
|
340
|
+
|
|
341
|
+
return withTransaction(() => {
|
|
342
|
+
const injections = rows.map((row) => insertInjection(runId, row, createdAt));
|
|
343
|
+
if (run.status !== "paused") pauseRunRecord(runId);
|
|
344
|
+
return { run: requireRun(runId), stepName: target.stepName, injections };
|
|
345
|
+
});
|
|
346
|
+
}
|
|
347
|
+
|
|
348
|
+
/**
|
|
349
|
+
* Помечает вставки завершённых шагов потреблёнными. Вызывается при финале
|
|
350
|
+
* resume, чтобы «зависшая» вставка не выглядела ожидающей в истории.
|
|
351
|
+
*/
|
|
352
|
+
export function consumeOrphanInjections(runId: string): number {
|
|
353
|
+
const steps = listRunSteps(runId);
|
|
354
|
+
const done = new Set(
|
|
355
|
+
steps.filter((step) => isStepDone(step.status)).map((step) => step.stepName),
|
|
356
|
+
);
|
|
357
|
+
const pending = listRunInjections(runId, { pendingOnly: true });
|
|
358
|
+
let consumed = 0;
|
|
359
|
+
for (const injection of pending) {
|
|
360
|
+
if (!done.has(injection.stepName)) continue;
|
|
361
|
+
const step = steps.find((item) => item.stepName === injection.stepName);
|
|
362
|
+
consumed += consumeInjections(
|
|
363
|
+
[injection.id],
|
|
364
|
+
injection.stepName,
|
|
365
|
+
step?.attempt ?? 1,
|
|
366
|
+
injection.createdAt,
|
|
367
|
+
);
|
|
368
|
+
}
|
|
369
|
+
return consumed;
|
|
370
|
+
}
|