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/schema.js
CHANGED
|
@@ -121,50 +121,357 @@ CREATE TABLE IF NOT EXISTS notification_embeddings (
|
|
|
121
121
|
|
|
122
122
|
CREATE INDEX IF NOT EXISTS idx_notification_embeddings_task ON notification_embeddings(task_name, created_at DESC);
|
|
123
123
|
CREATE INDEX IF NOT EXISTS idx_notification_embeddings_created ON notification_embeddings(created_at DESC);
|
|
124
|
+
|
|
125
|
+
-- Спринт 36.1 (durable DAG): запуск как единица выполнения.
|
|
126
|
+
-- Строка создаётся до старта шагов и переживает сбой процесса — это основа
|
|
127
|
+
-- для resume в 36.2. Статусы: pending → running → passed/failed/cancelled.
|
|
128
|
+
CREATE TABLE IF NOT EXISTS runs (
|
|
129
|
+
id TEXT PRIMARY KEY,
|
|
130
|
+
task_name TEXT NOT NULL,
|
|
131
|
+
status TEXT NOT NULL,
|
|
132
|
+
parent_run_id TEXT,
|
|
133
|
+
workspace_id TEXT,
|
|
134
|
+
started_at TEXT,
|
|
135
|
+
finished_at TEXT,
|
|
136
|
+
error TEXT,
|
|
137
|
+
metadata_json TEXT,
|
|
138
|
+
created_at TEXT NOT NULL,
|
|
139
|
+
updated_at TEXT NOT NULL
|
|
140
|
+
);
|
|
141
|
+
|
|
142
|
+
CREATE INDEX IF NOT EXISTS idx_runs_task ON runs(task_name, started_at DESC);
|
|
143
|
+
CREATE INDEX IF NOT EXISTS idx_runs_status ON runs(status, started_at DESC);
|
|
144
|
+
|
|
145
|
+
-- Спринт 36.1: шаг запуска. Поле attempt позволяет повторить шаг, не теряя
|
|
146
|
+
-- историю предыдущих попыток; idempotency_key защищает от повторного
|
|
147
|
+
-- выполнения того же шага (36.3). Статусы: pending → running → passed/failed/skipped.
|
|
148
|
+
CREATE TABLE IF NOT EXISTS run_steps (
|
|
149
|
+
id TEXT PRIMARY KEY,
|
|
150
|
+
run_id TEXT NOT NULL REFERENCES runs(id) ON DELETE CASCADE,
|
|
151
|
+
step_name TEXT NOT NULL,
|
|
152
|
+
-- Порядок шага в линейной цепочке (36.2): 0, 1, 2... Стабилен для resume.
|
|
153
|
+
position INTEGER NOT NULL DEFAULT 0,
|
|
154
|
+
status TEXT NOT NULL,
|
|
155
|
+
attempt INTEGER NOT NULL DEFAULT 1,
|
|
156
|
+
idempotency_key TEXT,
|
|
157
|
+
started_at TEXT,
|
|
158
|
+
finished_at TEXT,
|
|
159
|
+
error TEXT,
|
|
160
|
+
output_json TEXT,
|
|
161
|
+
created_at TEXT NOT NULL,
|
|
162
|
+
updated_at TEXT NOT NULL,
|
|
163
|
+
UNIQUE(run_id, step_name)
|
|
164
|
+
);
|
|
165
|
+
|
|
166
|
+
CREATE INDEX IF NOT EXISTS idx_run_steps_run ON run_steps(run_id, created_at);
|
|
167
|
+
CREATE INDEX IF NOT EXISTS idx_run_steps_status ON run_steps(status);
|
|
168
|
+
|
|
169
|
+
-- Спринт 36.4 (DLQ): шаги, которые упали детерминированно (исчерпали попытки),
|
|
170
|
+
-- ждут ручного retry или отказа. Открытая запись на шаг может быть только одна,
|
|
171
|
+
-- поэтому ручной retry не создаёт дублей.
|
|
172
|
+
CREATE TABLE IF NOT EXISTS run_dlq (
|
|
173
|
+
id TEXT PRIMARY KEY,
|
|
174
|
+
run_id TEXT NOT NULL REFERENCES runs(id) ON DELETE CASCADE,
|
|
175
|
+
step_name TEXT NOT NULL,
|
|
176
|
+
status TEXT NOT NULL,
|
|
177
|
+
reason TEXT,
|
|
178
|
+
error TEXT,
|
|
179
|
+
attempts INTEGER NOT NULL DEFAULT 0,
|
|
180
|
+
created_at TEXT NOT NULL,
|
|
181
|
+
updated_at TEXT NOT NULL,
|
|
182
|
+
resolved_at TEXT,
|
|
183
|
+
resolution TEXT
|
|
184
|
+
);
|
|
185
|
+
|
|
186
|
+
CREATE INDEX IF NOT EXISTS idx_run_dlq_status ON run_dlq(status, created_at DESC);
|
|
187
|
+
CREATE UNIQUE INDEX IF NOT EXISTS idx_run_dlq_open_unique
|
|
188
|
+
ON run_dlq(run_id, step_name) WHERE status = 'open';
|
|
189
|
+
|
|
190
|
+
-- Спринт 36.7 (пауза с инъекцией контекста): комментарий, файл или
|
|
191
|
+
-- структурированный артефакт, оставленный на паузе. Запись адресована
|
|
192
|
+
-- конкретному шагу и передаётся ему при resume ровно один раз.
|
|
193
|
+
CREATE TABLE IF NOT EXISTS run_injections (
|
|
194
|
+
id TEXT PRIMARY KEY,
|
|
195
|
+
run_id TEXT NOT NULL REFERENCES runs(id) ON DELETE CASCADE,
|
|
196
|
+
step_name TEXT NOT NULL,
|
|
197
|
+
kind TEXT NOT NULL,
|
|
198
|
+
content TEXT NOT NULL,
|
|
199
|
+
author TEXT NOT NULL,
|
|
200
|
+
metadata_json TEXT,
|
|
201
|
+
created_at TEXT NOT NULL,
|
|
202
|
+
consumed_at TEXT,
|
|
203
|
+
consumed_by_step TEXT,
|
|
204
|
+
consumed_attempt INTEGER
|
|
205
|
+
);
|
|
206
|
+
|
|
207
|
+
CREATE INDEX IF NOT EXISTS idx_run_injections_run
|
|
208
|
+
ON run_injections(run_id, created_at);
|
|
209
|
+
CREATE INDEX IF NOT EXISTS idx_run_injections_pending
|
|
210
|
+
ON run_injections(run_id, step_name) WHERE consumed_at IS NULL;
|
|
211
|
+
|
|
212
|
+
-- Спринт 36.5.b (Capability Map): исходы гейта по типам задач.
|
|
213
|
+
-- Слой 2 роутера читает success_rate и avg_* и выбирает local/cloud/review
|
|
214
|
+
-- без вызова модели. last_10_runs — JSON-массив 1 (гейт пройден) / 0 (провал).
|
|
215
|
+
CREATE TABLE IF NOT EXISTS capability_map (
|
|
216
|
+
task_type TEXT PRIMARY KEY,
|
|
217
|
+
model TEXT NOT NULL,
|
|
218
|
+
runs_total INTEGER NOT NULL DEFAULT 0,
|
|
219
|
+
runs_passed INTEGER NOT NULL DEFAULT 0,
|
|
220
|
+
success_rate REAL NOT NULL DEFAULT 0,
|
|
221
|
+
avg_cost_usd REAL NOT NULL DEFAULT 0,
|
|
222
|
+
avg_time_ms REAL NOT NULL DEFAULT 0,
|
|
223
|
+
last_10_runs TEXT NOT NULL DEFAULT '[]',
|
|
224
|
+
created_at TEXT NOT NULL,
|
|
225
|
+
updated_at TEXT NOT NULL
|
|
226
|
+
);
|
|
227
|
+
|
|
228
|
+
CREATE INDEX IF NOT EXISTS idx_capability_success ON capability_map(success_rate DESC);
|
|
124
229
|
`;
|
|
230
|
+
/**
|
|
231
|
+
* Текущая версия схемы БД (`PRAGMA user_version`).
|
|
232
|
+
*
|
|
233
|
+
* Версия пишется в заголовок SQLite-файла без отдельной таблицы, поэтому
|
|
234
|
+
* переживает пересоздание соединения и видна до применения каких-либо
|
|
235
|
+
* миграций. Увеличивайте при добавлении новой ступени в {@link MIGRATIONS}
|
|
236
|
+
* и добавляйте соответствующую запись в массив.
|
|
237
|
+
*/
|
|
238
|
+
export const SCHEMA_VERSION = 7;
|
|
239
|
+
/** Возвращает сохранённую версию схемы (0 у legacy-БД без user_version). */
|
|
240
|
+
export function getSchemaVersion(db) {
|
|
241
|
+
const rows = db.prepare("PRAGMA user_version").all();
|
|
242
|
+
const value = rows[0]?.user_version;
|
|
243
|
+
return typeof value === "number" ? value : 0;
|
|
244
|
+
}
|
|
245
|
+
/**
|
|
246
|
+
* Ступени миграции: `to` — целевая версия, `migrate` — изменения.
|
|
247
|
+
*
|
|
248
|
+
* Каждая ступень идемпотентна (проверяет PRAGMA table_info), поэтому её
|
|
249
|
+
* безопасно повторно прогонять на legacy-БД, где user_version ещё равен 0,
|
|
250
|
+
* но колонки уже добавлены прошлыми запусками.
|
|
251
|
+
*/
|
|
252
|
+
const MIGRATIONS = [
|
|
253
|
+
{
|
|
254
|
+
// Ступень 1 — состояние Спринта 25: колонки, добавленные ad-hoc ALTER'ами
|
|
255
|
+
// до появления версионирования (Спринты 12/15/21/25).
|
|
256
|
+
to: 1,
|
|
257
|
+
migrate(db) {
|
|
258
|
+
const columns = db.prepare("PRAGMA table_info(history)").all();
|
|
259
|
+
const columnNames = columns.map((c) => c.name).filter(Boolean);
|
|
260
|
+
if (!columnNames.includes("workspace_id")) {
|
|
261
|
+
db.exec("ALTER TABLE history ADD COLUMN workspace_id TEXT");
|
|
262
|
+
}
|
|
263
|
+
if (!columnNames.includes("allowed_tools")) {
|
|
264
|
+
db.exec("ALTER TABLE history ADD COLUMN allowed_tools TEXT");
|
|
265
|
+
}
|
|
266
|
+
if (!columnNames.includes("denied_tools")) {
|
|
267
|
+
db.exec("ALTER TABLE history ADD COLUMN denied_tools TEXT");
|
|
268
|
+
}
|
|
269
|
+
// Спринт 15: флаги matrix на tasks (клоны и родитель-шаблон).
|
|
270
|
+
const taskColumns = db.prepare("PRAGMA table_info(tasks)").all();
|
|
271
|
+
const taskColumnNames = taskColumns.map((c) => c.name).filter(Boolean);
|
|
272
|
+
if (!taskColumnNames.includes("matrix_parent_id")) {
|
|
273
|
+
db.exec("ALTER TABLE tasks ADD COLUMN matrix_parent_id TEXT");
|
|
274
|
+
}
|
|
275
|
+
if (!taskColumnNames.includes("is_matrix_parent")) {
|
|
276
|
+
db.exec("ALTER TABLE tasks ADD COLUMN is_matrix_parent INTEGER DEFAULT 0");
|
|
277
|
+
}
|
|
278
|
+
// Спринт 21: env-переменные на workspace (пары ключ-значение и .env-файл).
|
|
279
|
+
const workspaceColumns = db.prepare("PRAGMA table_info(workspaces)").all();
|
|
280
|
+
const workspaceColumnNames = workspaceColumns.map((c) => c.name).filter(Boolean);
|
|
281
|
+
if (!workspaceColumnNames.includes("env_json")) {
|
|
282
|
+
db.exec("ALTER TABLE workspaces ADD COLUMN env_json TEXT");
|
|
283
|
+
}
|
|
284
|
+
if (!workspaceColumnNames.includes("env_file")) {
|
|
285
|
+
db.exec("ALTER TABLE workspaces ADD COLUMN env_file TEXT");
|
|
286
|
+
}
|
|
287
|
+
// Спринт 25: partial вынесен из error, чтобы дашборд не смешивал
|
|
288
|
+
// частичные выполнения с ошибками и таймаутами.
|
|
289
|
+
const metricsColumns = db.prepare("PRAGMA table_info(metrics)").all();
|
|
290
|
+
const metricsColumnNames = metricsColumns.map((c) => c.name).filter(Boolean);
|
|
291
|
+
if (!metricsColumnNames.includes("partial")) {
|
|
292
|
+
db.exec("ALTER TABLE metrics ADD COLUMN partial INTEGER DEFAULT 0");
|
|
293
|
+
}
|
|
294
|
+
},
|
|
295
|
+
},
|
|
296
|
+
{
|
|
297
|
+
// Ступень 2 — Спринт 36.1: durable DAG. Таблицы создаются идемпотентно,
|
|
298
|
+
// чтобы legacy-БД (user_version = 0/1) получила их и индексы при обновлении,
|
|
299
|
+
// а не только при создании файла с нуля.
|
|
300
|
+
to: 2,
|
|
301
|
+
migrate(db) {
|
|
302
|
+
db.exec(`
|
|
303
|
+
CREATE TABLE IF NOT EXISTS runs (
|
|
304
|
+
id TEXT PRIMARY KEY,
|
|
305
|
+
task_name TEXT NOT NULL,
|
|
306
|
+
status TEXT NOT NULL,
|
|
307
|
+
parent_run_id TEXT,
|
|
308
|
+
workspace_id TEXT,
|
|
309
|
+
started_at TEXT,
|
|
310
|
+
finished_at TEXT,
|
|
311
|
+
error TEXT,
|
|
312
|
+
metadata_json TEXT,
|
|
313
|
+
created_at TEXT NOT NULL,
|
|
314
|
+
updated_at TEXT NOT NULL
|
|
315
|
+
);
|
|
316
|
+
CREATE INDEX IF NOT EXISTS idx_runs_task ON runs(task_name, started_at DESC);
|
|
317
|
+
CREATE INDEX IF NOT EXISTS idx_runs_status ON runs(status, started_at DESC);
|
|
318
|
+
|
|
319
|
+
CREATE TABLE IF NOT EXISTS run_steps (
|
|
320
|
+
id TEXT PRIMARY KEY,
|
|
321
|
+
run_id TEXT NOT NULL REFERENCES runs(id) ON DELETE CASCADE,
|
|
322
|
+
step_name TEXT NOT NULL,
|
|
323
|
+
status TEXT NOT NULL,
|
|
324
|
+
attempt INTEGER NOT NULL DEFAULT 1,
|
|
325
|
+
idempotency_key TEXT,
|
|
326
|
+
started_at TEXT,
|
|
327
|
+
finished_at TEXT,
|
|
328
|
+
error TEXT,
|
|
329
|
+
output_json TEXT,
|
|
330
|
+
created_at TEXT NOT NULL,
|
|
331
|
+
updated_at TEXT NOT NULL,
|
|
332
|
+
UNIQUE(run_id, step_name)
|
|
333
|
+
);
|
|
334
|
+
CREATE INDEX IF NOT EXISTS idx_run_steps_run ON run_steps(run_id, created_at);
|
|
335
|
+
CREATE INDEX IF NOT EXISTS idx_run_steps_status ON run_steps(status);
|
|
336
|
+
CREATE INDEX IF NOT EXISTS idx_run_steps_key ON run_steps(run_id, idempotency_key);
|
|
337
|
+
`);
|
|
338
|
+
},
|
|
339
|
+
},
|
|
340
|
+
{
|
|
341
|
+
// Ступень 3 — Спринт 36.2: явный порядок шага в линейной цепочке.
|
|
342
|
+
// created_at может совпасть у шагов одной транзакции, поэтому resume
|
|
343
|
+
// не может опираться на время; position фиксирует порядок создания.
|
|
344
|
+
to: 3,
|
|
345
|
+
migrate(db) {
|
|
346
|
+
if (!tableColumns(db, "run_steps").includes("position")) {
|
|
347
|
+
db.exec("ALTER TABLE run_steps ADD COLUMN position INTEGER NOT NULL DEFAULT 0");
|
|
348
|
+
// Для уже существующих строк порядок = порядок вставки (rowid).
|
|
349
|
+
db.exec("UPDATE run_steps SET position = rowid");
|
|
350
|
+
}
|
|
351
|
+
},
|
|
352
|
+
},
|
|
353
|
+
{
|
|
354
|
+
// Ступень 4 — Спринт 36.3: ключ идемпотентности уникален в пределах запуска.
|
|
355
|
+
// Дубли (если были) обнуляются, оставляем первый по rowid; затем старый
|
|
356
|
+
// неуникальный индекс заменяется частичным уникальным.
|
|
357
|
+
to: 4,
|
|
358
|
+
migrate(db) {
|
|
359
|
+
db.exec(`UPDATE run_steps SET idempotency_key = NULL
|
|
360
|
+
WHERE idempotency_key IS NOT NULL
|
|
361
|
+
AND rowid NOT IN (
|
|
362
|
+
SELECT MIN(rowid) FROM run_steps
|
|
363
|
+
WHERE idempotency_key IS NOT NULL
|
|
364
|
+
GROUP BY run_id, idempotency_key
|
|
365
|
+
)`);
|
|
366
|
+
db.exec("DROP INDEX IF EXISTS idx_run_steps_key");
|
|
367
|
+
db.exec(`CREATE UNIQUE INDEX IF NOT EXISTS idx_run_steps_key_unique
|
|
368
|
+
ON run_steps(run_id, idempotency_key) WHERE idempotency_key IS NOT NULL`);
|
|
369
|
+
},
|
|
370
|
+
},
|
|
371
|
+
{
|
|
372
|
+
// Ступень 5 — Спринт 36.4: DLQ для детерминированно упавших шагов.
|
|
373
|
+
// Таблица и индексы идемпотентны; уникальный открытый индекс не даёт
|
|
374
|
+
// завести вторую запись на тот же шаг после ручного retry.
|
|
375
|
+
to: 5,
|
|
376
|
+
migrate(db) {
|
|
377
|
+
db.exec(`
|
|
378
|
+
CREATE TABLE IF NOT EXISTS run_dlq (
|
|
379
|
+
id TEXT PRIMARY KEY,
|
|
380
|
+
run_id TEXT NOT NULL REFERENCES runs(id) ON DELETE CASCADE,
|
|
381
|
+
step_name TEXT NOT NULL,
|
|
382
|
+
status TEXT NOT NULL,
|
|
383
|
+
reason TEXT,
|
|
384
|
+
error TEXT,
|
|
385
|
+
attempts INTEGER NOT NULL DEFAULT 0,
|
|
386
|
+
created_at TEXT NOT NULL,
|
|
387
|
+
updated_at TEXT NOT NULL,
|
|
388
|
+
resolved_at TEXT,
|
|
389
|
+
resolution TEXT
|
|
390
|
+
);
|
|
391
|
+
CREATE INDEX IF NOT EXISTS idx_run_dlq_status ON run_dlq(status, created_at DESC);
|
|
392
|
+
CREATE UNIQUE INDEX IF NOT EXISTS idx_run_dlq_open_unique
|
|
393
|
+
ON run_dlq(run_id, step_name) WHERE status = 'open';
|
|
394
|
+
`);
|
|
395
|
+
},
|
|
396
|
+
},
|
|
397
|
+
{
|
|
398
|
+
// Ступень 6 — Спринт 36.5.b: Capability Map роутера. Таблица только
|
|
399
|
+
// добавляется, поэтому ступень идемпотентна и безопасна для старых БД.
|
|
400
|
+
to: 6,
|
|
401
|
+
migrate(db) {
|
|
402
|
+
db.exec(`
|
|
403
|
+
CREATE TABLE IF NOT EXISTS capability_map (
|
|
404
|
+
task_type TEXT PRIMARY KEY,
|
|
405
|
+
model TEXT NOT NULL,
|
|
406
|
+
runs_total INTEGER NOT NULL DEFAULT 0,
|
|
407
|
+
runs_passed INTEGER NOT NULL DEFAULT 0,
|
|
408
|
+
success_rate REAL NOT NULL DEFAULT 0,
|
|
409
|
+
avg_cost_usd REAL NOT NULL DEFAULT 0,
|
|
410
|
+
avg_time_ms REAL NOT NULL DEFAULT 0,
|
|
411
|
+
last_10_runs TEXT NOT NULL DEFAULT '[]',
|
|
412
|
+
created_at TEXT NOT NULL,
|
|
413
|
+
updated_at TEXT NOT NULL
|
|
414
|
+
);
|
|
415
|
+
CREATE INDEX IF NOT EXISTS idx_capability_success ON capability_map(success_rate DESC);
|
|
416
|
+
`);
|
|
417
|
+
},
|
|
418
|
+
},
|
|
419
|
+
{
|
|
420
|
+
// Ступень 7 — Спринт 36.7: контекст паузы. Таблица только добавляется,
|
|
421
|
+
// поэтому ступень идемпотентна и безопасна для старых БД.
|
|
422
|
+
to: 7,
|
|
423
|
+
migrate(db) {
|
|
424
|
+
db.exec(`
|
|
425
|
+
CREATE TABLE IF NOT EXISTS run_injections (
|
|
426
|
+
id TEXT PRIMARY KEY,
|
|
427
|
+
run_id TEXT NOT NULL REFERENCES runs(id) ON DELETE CASCADE,
|
|
428
|
+
step_name TEXT NOT NULL,
|
|
429
|
+
kind TEXT NOT NULL,
|
|
430
|
+
content TEXT NOT NULL,
|
|
431
|
+
author TEXT NOT NULL,
|
|
432
|
+
metadata_json TEXT,
|
|
433
|
+
created_at TEXT NOT NULL,
|
|
434
|
+
consumed_at TEXT,
|
|
435
|
+
consumed_by_step TEXT,
|
|
436
|
+
consumed_attempt INTEGER
|
|
437
|
+
);
|
|
438
|
+
CREATE INDEX IF NOT EXISTS idx_run_injections_run
|
|
439
|
+
ON run_injections(run_id, created_at);
|
|
440
|
+
CREATE INDEX IF NOT EXISTS idx_run_injections_pending
|
|
441
|
+
ON run_injections(run_id, step_name) WHERE consumed_at IS NULL;
|
|
442
|
+
`);
|
|
443
|
+
},
|
|
444
|
+
},
|
|
445
|
+
];
|
|
446
|
+
/** Имена колонок таблицы (пустой массив, если таблицы нет). */
|
|
447
|
+
function tableColumns(db, table) {
|
|
448
|
+
const columns = db.prepare(`PRAGMA table_info(${table})`).all();
|
|
449
|
+
return columns.map((column) => column.name).filter((name) => Boolean(name));
|
|
450
|
+
}
|
|
125
451
|
/**
|
|
126
452
|
* Применяет схему к открытому соединению.
|
|
127
453
|
*
|
|
128
454
|
* CREATE TABLE IF NOT EXISTS не добавляет новые колонки в уже существующие
|
|
129
|
-
* таблицы, поэтому
|
|
455
|
+
* таблицы, поэтому структурные изменения идут отдельными ступенями миграции
|
|
130
456
|
* после проверки PRAGMA table_info. Это безопасно и для старых БД Спринта 12.
|
|
457
|
+
*
|
|
458
|
+
* После успешных миграций версия фиксируется в `PRAGMA user_version`, чтобы
|
|
459
|
+
* будущие ступени могли выполняться инкрементально, а не перебирать колонки.
|
|
131
460
|
*/
|
|
132
461
|
export function applySchema(db) {
|
|
133
462
|
db.exec(SCHEMA_SQL);
|
|
134
|
-
const
|
|
135
|
-
const
|
|
136
|
-
|
|
137
|
-
|
|
138
|
-
|
|
139
|
-
if (!columnNames.includes("allowed_tools")) {
|
|
140
|
-
db.exec("ALTER TABLE history ADD COLUMN allowed_tools TEXT");
|
|
141
|
-
}
|
|
142
|
-
if (!columnNames.includes("denied_tools")) {
|
|
143
|
-
db.exec("ALTER TABLE history ADD COLUMN denied_tools TEXT");
|
|
144
|
-
}
|
|
145
|
-
// Спринт 15: флаги matrix на tasks (клоны и родитель-шаблон).
|
|
146
|
-
const taskColumns = db.prepare("PRAGMA table_info(tasks)").all();
|
|
147
|
-
const taskColumnNames = taskColumns.map((c) => c.name).filter(Boolean);
|
|
148
|
-
if (!taskColumnNames.includes("matrix_parent_id")) {
|
|
149
|
-
db.exec("ALTER TABLE tasks ADD COLUMN matrix_parent_id TEXT");
|
|
150
|
-
}
|
|
151
|
-
if (!taskColumnNames.includes("is_matrix_parent")) {
|
|
152
|
-
db.exec("ALTER TABLE tasks ADD COLUMN is_matrix_parent INTEGER DEFAULT 0");
|
|
153
|
-
}
|
|
154
|
-
// Спринт 21: env-переменные на workspace (пары ключ-значение и .env-файл).
|
|
155
|
-
const workspaceColumns = db.prepare("PRAGMA table_info(workspaces)").all();
|
|
156
|
-
const workspaceColumnNames = workspaceColumns.map((c) => c.name).filter(Boolean);
|
|
157
|
-
if (!workspaceColumnNames.includes("env_json")) {
|
|
158
|
-
db.exec("ALTER TABLE workspaces ADD COLUMN env_json TEXT");
|
|
159
|
-
}
|
|
160
|
-
if (!workspaceColumnNames.includes("env_file")) {
|
|
161
|
-
db.exec("ALTER TABLE workspaces ADD COLUMN env_file TEXT");
|
|
463
|
+
const fromVersion = getSchemaVersion(db);
|
|
464
|
+
for (const step of MIGRATIONS) {
|
|
465
|
+
if (fromVersion < step.to) {
|
|
466
|
+
step.migrate(db);
|
|
467
|
+
}
|
|
162
468
|
}
|
|
163
|
-
//
|
|
164
|
-
//
|
|
165
|
-
|
|
166
|
-
|
|
167
|
-
if (
|
|
168
|
-
|
|
469
|
+
// Индекс по position нельзя объявлять в SCHEMA_SQL: на старой БД таблица
|
|
470
|
+
// run_steps ещё без этой колонки, и CREATE INDEX упал бы до миграции.
|
|
471
|
+
// Поэтому создаём его после миграций — заодно лечим БД, где индекс потерян.
|
|
472
|
+
db.exec("CREATE INDEX IF NOT EXISTS idx_run_steps_position ON run_steps(run_id, position)");
|
|
473
|
+
if (fromVersion !== SCHEMA_VERSION) {
|
|
474
|
+
// PRAGMA не принимает параметры — подставляем проверенное число.
|
|
475
|
+
db.exec(`PRAGMA user_version = ${SCHEMA_VERSION}`);
|
|
169
476
|
}
|
|
170
477
|
}
|
|
@@ -5,4 +5,15 @@
|
|
|
5
5
|
export declare function getSetting<T>(key: string, fallback: T): T;
|
|
6
6
|
export declare function setSetting(key: string, value: unknown): void;
|
|
7
7
|
export declare function deleteSetting(key: string): void;
|
|
8
|
+
/**
|
|
9
|
+
* Атомарно уменьшает целочисленный счётчик в settings.
|
|
10
|
+
*
|
|
11
|
+
* P2-30: раньше retry_state был одним JSON-объектом, который читали и
|
|
12
|
+
* перезаписывали целиком разные процессы record-history. При параллельных
|
|
13
|
+
* завершениях задач декременты терялись. Здесь счётчик живёт отдельной
|
|
14
|
+
* строкой, а уменьшение делает один UPDATE — гонки между процессами нет.
|
|
15
|
+
*
|
|
16
|
+
* Возвращает новое значение или null, если счётчик уже исчерпан.
|
|
17
|
+
*/
|
|
18
|
+
export declare function decrementCounterSetting(key: string, initial: number): number | null;
|
|
8
19
|
//# sourceMappingURL=settings-repo.d.ts.map
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"settings-repo.d.ts","sourceRoot":"","sources":["../../src/db/settings-repo.ts"],"names":[],"mappings":"AAEA;;;GAGG;AAEH,wBAAgB,UAAU,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,GAAG,CAAC,CAUzD;AAED,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,IAAI,CAO5D;AAED,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAE/C"}
|
|
1
|
+
{"version":3,"file":"settings-repo.d.ts","sourceRoot":"","sources":["../../src/db/settings-repo.ts"],"names":[],"mappings":"AAEA;;;GAGG;AAEH,wBAAgB,UAAU,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,GAAG,CAAC,CAUzD;AAED,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,IAAI,CAO5D;AAED,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAE/C;AAED;;;;;;;;;GASG;AACH,wBAAgB,uBAAuB,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAmBnF"}
|
package/dist/db/settings-repo.js
CHANGED
|
@@ -25,3 +25,28 @@ export function setSetting(key, value) {
|
|
|
25
25
|
export function deleteSetting(key) {
|
|
26
26
|
getDb().prepare("DELETE FROM settings WHERE key = ?").run(key);
|
|
27
27
|
}
|
|
28
|
+
/**
|
|
29
|
+
* Атомарно уменьшает целочисленный счётчик в settings.
|
|
30
|
+
*
|
|
31
|
+
* P2-30: раньше retry_state был одним JSON-объектом, который читали и
|
|
32
|
+
* перезаписывали целиком разные процессы record-history. При параллельных
|
|
33
|
+
* завершениях задач декременты терялись. Здесь счётчик живёт отдельной
|
|
34
|
+
* строкой, а уменьшение делает один UPDATE — гонки между процессами нет.
|
|
35
|
+
*
|
|
36
|
+
* Возвращает новое значение или null, если счётчик уже исчерпан.
|
|
37
|
+
*/
|
|
38
|
+
export function decrementCounterSetting(key, initial) {
|
|
39
|
+
const db = getDb();
|
|
40
|
+
db.prepare(`INSERT INTO settings (key, value_json) VALUES (?, ?)
|
|
41
|
+
ON CONFLICT(key) DO NOTHING`).run(key, JSON.stringify(Math.max(0, Math.floor(initial))));
|
|
42
|
+
const row = db
|
|
43
|
+
.prepare(`UPDATE settings
|
|
44
|
+
SET value_json = CAST(CAST(value_json AS INTEGER) - 1 AS TEXT)
|
|
45
|
+
WHERE key = ?
|
|
46
|
+
AND CAST(value_json AS INTEGER) > 0
|
|
47
|
+
RETURNING CAST(value_json AS INTEGER) AS value`)
|
|
48
|
+
.get(key);
|
|
49
|
+
if (!row)
|
|
50
|
+
return null;
|
|
51
|
+
return Number(row.value);
|
|
52
|
+
}
|
|
@@ -0,0 +1,51 @@
|
|
|
1
|
+
import { type RunStepRecord } from "./runs-repo.js";
|
|
2
|
+
/**
|
|
3
|
+
* Идемпотентное выполнение шага (Sprint 36.3).
|
|
4
|
+
*
|
|
5
|
+
* Ключ идемпотентности уникален в пределах запуска (частичный UNIQUE-индекс
|
|
6
|
+
* `idx_run_steps_key_unique`). Повторный вызов с тем же ключом не выполняет
|
|
7
|
+
* тело шага второй раз: возвращается сохранённый `output_json` с
|
|
8
|
+
* `replayed: true`. Это защищает от дублей побочных эффектов при ретраях,
|
|
9
|
+
* resume и параллельных вызовах.
|
|
10
|
+
*/
|
|
11
|
+
/** Ключ уже занят другим шагом запуска. */
|
|
12
|
+
export declare class IdempotencyConflictError extends Error {
|
|
13
|
+
constructor(runId: string, key: string, stepName?: string);
|
|
14
|
+
}
|
|
15
|
+
/** Шаг с этим ключом выполняется прямо сейчас (параллельный дубль). */
|
|
16
|
+
export declare class StepInFlightError extends Error {
|
|
17
|
+
constructor(runId: string, key: string);
|
|
18
|
+
}
|
|
19
|
+
/** Опции идемпотентного шага. */
|
|
20
|
+
export interface StepOnceOptions {
|
|
21
|
+
/** Обязательный ключ; уникален в пределах запуска. */
|
|
22
|
+
idempotencyKey: string;
|
|
23
|
+
/** Начать запуск, если он pending (по умолчанию true). */
|
|
24
|
+
startRun?: boolean;
|
|
25
|
+
}
|
|
26
|
+
/** Результат `runStepOnce`. */
|
|
27
|
+
export interface StepOnceExecution<T> {
|
|
28
|
+
/** Актуальное состояние шага. */
|
|
29
|
+
step: RunStepRecord;
|
|
30
|
+
/** Результат тела либо сохранённый output при повторе. */
|
|
31
|
+
result: T | null;
|
|
32
|
+
/** true — тело не вызывалось, результат взят из БД. */
|
|
33
|
+
replayed: boolean;
|
|
34
|
+
/** true — тело шага действительно выполнялось. */
|
|
35
|
+
executed: boolean;
|
|
36
|
+
/** Номер попытки, с которым шаг выполнен (или был выполнен раньше). */
|
|
37
|
+
attempt: number;
|
|
38
|
+
}
|
|
39
|
+
/**
|
|
40
|
+
* Выполняет шаг ровно один раз на ключ.
|
|
41
|
+
*
|
|
42
|
+
* - новый ключ → шаг создаётся и выполняется;
|
|
43
|
+
* - шаг уже `passed`/`skipped` → тело не вызывается, возвращается кэш;
|
|
44
|
+
* - шаг `failed` → повтор с `attempt + 1` (осознанный ретрай);
|
|
45
|
+
* - шаг `running` или параллельный вызов в этом процессе → `StepInFlightError`;
|
|
46
|
+
* - ключ принадлежит другому шагу → `IdempotencyConflictError`.
|
|
47
|
+
*/
|
|
48
|
+
export declare function runStepOnce<T>(runId: string, stepName: string, options: StepOnceOptions, body: () => T): StepOnceExecution<T>;
|
|
49
|
+
/** Асинхронный вариант `runStepOnce` для шагов с I/O. */
|
|
50
|
+
export declare function runStepOnceAsync<T>(runId: string, stepName: string, options: StepOnceOptions, body: () => Promise<T> | T): Promise<StepOnceExecution<T>>;
|
|
51
|
+
//# sourceMappingURL=step-idempotency.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"step-idempotency.d.ts","sourceRoot":"","sources":["../../src/db/step-idempotency.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,KAAK,aAAa,EACnB,MAAM,gBAAgB,CAAC;AAOxB;;;;;;;;GAQG;AAEH,2CAA2C;AAC3C,qBAAa,wBAAyB,SAAQ,KAAK;gBACrC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM;CAQ1D;AAED,uEAAuE;AACvE,qBAAa,iBAAkB,SAAQ,KAAK;gBAC9B,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM;CAIvC;AAED,iCAAiC;AACjC,MAAM,WAAW,eAAe;IAC9B,sDAAsD;IACtD,cAAc,EAAE,MAAM,CAAC;IACvB,0DAA0D;IAC1D,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,+BAA+B;AAC/B,MAAM,WAAW,iBAAiB,CAAC,CAAC;IAClC,iCAAiC;IACjC,IAAI,EAAE,aAAa,CAAC;IACpB,0DAA0D;IAC1D,MAAM,EAAE,CAAC,GAAG,IAAI,CAAC;IACjB,uDAAuD;IACvD,QAAQ,EAAE,OAAO,CAAC;IAClB,kDAAkD;IAClD,QAAQ,EAAE,OAAO,CAAC;IAClB,uEAAuE;IACvE,OAAO,EAAE,MAAM,CAAC;CACjB;AAeD;;;;;;;;GAQG;AACH,wBAAgB,WAAW,CAAC,CAAC,EAC3B,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,eAAe,EACxB,IAAI,EAAE,MAAM,CAAC,GACZ,iBAAiB,CAAC,CAAC,CAAC,CA2CtB;AAED,yDAAyD;AACzD,wBAAsB,gBAAgB,CAAC,CAAC,EACtC,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,eAAe,EACxB,IAAI,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,GACzB,OAAO,CAAC,iBAAiB,CAAC,CAAC,CAAC,CAAC,CA2C/B"}
|
|
@@ -0,0 +1,136 @@
|
|
|
1
|
+
import { createStep, findStepByIdempotencyKey, } from "./runs-repo.js";
|
|
2
|
+
import { beginStepAttempt, recordStepFailure, recordStepSuccess, } from "./run-journal.js";
|
|
3
|
+
/**
|
|
4
|
+
* Идемпотентное выполнение шага (Sprint 36.3).
|
|
5
|
+
*
|
|
6
|
+
* Ключ идемпотентности уникален в пределах запуска (частичный UNIQUE-индекс
|
|
7
|
+
* `idx_run_steps_key_unique`). Повторный вызов с тем же ключом не выполняет
|
|
8
|
+
* тело шага второй раз: возвращается сохранённый `output_json` с
|
|
9
|
+
* `replayed: true`. Это защищает от дублей побочных эффектов при ретраях,
|
|
10
|
+
* resume и параллельных вызовах.
|
|
11
|
+
*/
|
|
12
|
+
/** Ключ уже занят другим шагом запуска. */
|
|
13
|
+
export class IdempotencyConflictError extends Error {
|
|
14
|
+
constructor(runId, key, stepName) {
|
|
15
|
+
super(stepName
|
|
16
|
+
? `Ключ идемпотентности "${key}" в запуске ${runId} уже принадлежит шагу "${stepName}".`
|
|
17
|
+
: `Ключ идемпотентности "${key}" в запуске ${runId} уже используется.`);
|
|
18
|
+
this.name = "IdempotencyConflictError";
|
|
19
|
+
}
|
|
20
|
+
}
|
|
21
|
+
/** Шаг с этим ключом выполняется прямо сейчас (параллельный дубль). */
|
|
22
|
+
export class StepInFlightError extends Error {
|
|
23
|
+
constructor(runId, key) {
|
|
24
|
+
super(`Шаг с ключом идемпотентности "${key}" уже выполняется в запуске ${runId}.`);
|
|
25
|
+
this.name = "StepInFlightError";
|
|
26
|
+
}
|
|
27
|
+
}
|
|
28
|
+
/** Ключи, выполняющиеся в этом процессе: `runId\u0000key`. */
|
|
29
|
+
const inFlight = new Set();
|
|
30
|
+
function normalizeKey(key) {
|
|
31
|
+
const value = String(key ?? "").trim();
|
|
32
|
+
if (!value)
|
|
33
|
+
throw new Error("idempotencyKey обязателен для идемпотентного шага.");
|
|
34
|
+
return value;
|
|
35
|
+
}
|
|
36
|
+
function flightKey(runId, key) {
|
|
37
|
+
return `${runId}\u0000${key}`;
|
|
38
|
+
}
|
|
39
|
+
/**
|
|
40
|
+
* Выполняет шаг ровно один раз на ключ.
|
|
41
|
+
*
|
|
42
|
+
* - новый ключ → шаг создаётся и выполняется;
|
|
43
|
+
* - шаг уже `passed`/`skipped` → тело не вызывается, возвращается кэш;
|
|
44
|
+
* - шаг `failed` → повтор с `attempt + 1` (осознанный ретрай);
|
|
45
|
+
* - шаг `running` или параллельный вызов в этом процессе → `StepInFlightError`;
|
|
46
|
+
* - ключ принадлежит другому шагу → `IdempotencyConflictError`.
|
|
47
|
+
*/
|
|
48
|
+
export function runStepOnce(runId, stepName, options, body) {
|
|
49
|
+
const key = normalizeKey(options.idempotencyKey);
|
|
50
|
+
const flight = flightKey(runId, key);
|
|
51
|
+
if (inFlight.has(flight))
|
|
52
|
+
throw new StepInFlightError(runId, key);
|
|
53
|
+
inFlight.add(flight);
|
|
54
|
+
try {
|
|
55
|
+
const existing = findStepByIdempotencyKey(runId, key);
|
|
56
|
+
if (existing && existing.stepName !== stepName) {
|
|
57
|
+
throw new IdempotencyConflictError(runId, key, existing.stepName);
|
|
58
|
+
}
|
|
59
|
+
if (existing && (existing.status === "passed" || existing.status === "skipped")) {
|
|
60
|
+
return {
|
|
61
|
+
step: existing,
|
|
62
|
+
result: existing.output ?? null,
|
|
63
|
+
replayed: true,
|
|
64
|
+
executed: false,
|
|
65
|
+
attempt: existing.attempt,
|
|
66
|
+
};
|
|
67
|
+
}
|
|
68
|
+
if (existing && existing.status === "running") {
|
|
69
|
+
throw new StepInFlightError(runId, key);
|
|
70
|
+
}
|
|
71
|
+
if (!existing) {
|
|
72
|
+
createStep(runId, { stepName, idempotencyKey: key });
|
|
73
|
+
}
|
|
74
|
+
const attempt = beginStepAttempt(runId, stepName, {
|
|
75
|
+
startRun: options.startRun,
|
|
76
|
+
}).attempt;
|
|
77
|
+
let result;
|
|
78
|
+
try {
|
|
79
|
+
result = body();
|
|
80
|
+
}
|
|
81
|
+
catch (err) {
|
|
82
|
+
recordStepFailure(runId, stepName, err);
|
|
83
|
+
throw err;
|
|
84
|
+
}
|
|
85
|
+
const step = recordStepSuccess(runId, stepName, result);
|
|
86
|
+
return { step, result, replayed: false, executed: true, attempt };
|
|
87
|
+
}
|
|
88
|
+
finally {
|
|
89
|
+
inFlight.delete(flight);
|
|
90
|
+
}
|
|
91
|
+
}
|
|
92
|
+
/** Асинхронный вариант `runStepOnce` для шагов с I/O. */
|
|
93
|
+
export async function runStepOnceAsync(runId, stepName, options, body) {
|
|
94
|
+
const key = normalizeKey(options.idempotencyKey);
|
|
95
|
+
const flight = flightKey(runId, key);
|
|
96
|
+
if (inFlight.has(flight))
|
|
97
|
+
throw new StepInFlightError(runId, key);
|
|
98
|
+
inFlight.add(flight);
|
|
99
|
+
try {
|
|
100
|
+
const existing = findStepByIdempotencyKey(runId, key);
|
|
101
|
+
if (existing && existing.stepName !== stepName) {
|
|
102
|
+
throw new IdempotencyConflictError(runId, key, existing.stepName);
|
|
103
|
+
}
|
|
104
|
+
if (existing && (existing.status === "passed" || existing.status === "skipped")) {
|
|
105
|
+
return {
|
|
106
|
+
step: existing,
|
|
107
|
+
result: existing.output ?? null,
|
|
108
|
+
replayed: true,
|
|
109
|
+
executed: false,
|
|
110
|
+
attempt: existing.attempt,
|
|
111
|
+
};
|
|
112
|
+
}
|
|
113
|
+
if (existing && existing.status === "running") {
|
|
114
|
+
throw new StepInFlightError(runId, key);
|
|
115
|
+
}
|
|
116
|
+
if (!existing) {
|
|
117
|
+
createStep(runId, { stepName, idempotencyKey: key });
|
|
118
|
+
}
|
|
119
|
+
const attempt = beginStepAttempt(runId, stepName, {
|
|
120
|
+
startRun: options.startRun,
|
|
121
|
+
}).attempt;
|
|
122
|
+
let result;
|
|
123
|
+
try {
|
|
124
|
+
result = await body();
|
|
125
|
+
}
|
|
126
|
+
catch (err) {
|
|
127
|
+
recordStepFailure(runId, stepName, err);
|
|
128
|
+
throw err;
|
|
129
|
+
}
|
|
130
|
+
const step = recordStepSuccess(runId, stepName, result);
|
|
131
|
+
return { step, result, replayed: false, executed: true, attempt };
|
|
132
|
+
}
|
|
133
|
+
finally {
|
|
134
|
+
inFlight.delete(flight);
|
|
135
|
+
}
|
|
136
|
+
}
|