agent-steward 0.0.1 → 0.0.3
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 +399 -0
- package/CROSS_PLATFORM.md +151 -0
- package/README.md +307 -15
- package/ROADMAP-STRATEGY.md +196 -0
- package/ROADMAP.md +184 -0
- package/dist/core/analytics.d.ts +132 -0
- package/dist/core/analytics.d.ts.map +1 -0
- package/dist/core/analytics.js +290 -0
- package/dist/core/audit.d.ts +96 -0
- package/dist/core/audit.d.ts.map +1 -0
- package/dist/core/audit.js +297 -0
- package/dist/core/cron-to-schtasks.d.ts +12 -0
- package/dist/core/cron-to-schtasks.d.ts.map +1 -0
- package/dist/core/cron-to-schtasks.js +175 -0
- package/dist/core/dry-run.d.ts +102 -0
- package/dist/core/dry-run.d.ts.map +1 -0
- package/dist/core/dry-run.js +447 -0
- package/dist/core/file-watcher.d.ts +31 -0
- package/dist/core/file-watcher.d.ts.map +1 -0
- package/dist/core/file-watcher.js +186 -0
- package/dist/core/git-trigger.d.ts +82 -0
- package/dist/core/git-trigger.d.ts.map +1 -0
- package/dist/core/git-trigger.js +312 -0
- package/dist/core/glob.d.ts +38 -0
- package/dist/core/glob.d.ts.map +1 -0
- package/dist/core/glob.js +233 -0
- package/dist/core/local-ai.d.ts +52 -0
- package/dist/core/local-ai.d.ts.map +1 -0
- package/dist/core/local-ai.js +119 -0
- package/dist/core/lock.d.ts +57 -0
- package/dist/core/lock.d.ts.map +1 -0
- package/dist/core/lock.js +193 -0
- package/dist/core/matrix.d.ts +167 -0
- package/dist/core/matrix.d.ts.map +1 -0
- package/dist/core/matrix.js +724 -0
- package/dist/core/native-notify.d.ts +36 -0
- package/dist/core/native-notify.d.ts.map +1 -0
- package/dist/core/native-notify.js +113 -0
- package/dist/core/one-shot.d.ts +90 -0
- package/dist/core/one-shot.d.ts.map +1 -0
- package/dist/core/one-shot.js +182 -0
- package/dist/core/otel.d.ts +4 -0
- package/dist/core/otel.d.ts.map +1 -0
- package/dist/core/otel.js +98 -0
- package/dist/core/permissions.d.ts +69 -0
- package/dist/core/permissions.d.ts.map +1 -0
- package/dist/core/permissions.js +143 -0
- package/dist/core/prometheus.d.ts +23 -0
- package/dist/core/prometheus.d.ts.map +1 -0
- package/dist/core/prometheus.js +146 -0
- package/dist/core/ps-wrapper.d.ts +73 -0
- package/dist/core/ps-wrapper.d.ts.map +1 -0
- package/dist/core/ps-wrapper.js +1091 -0
- package/dist/core/record-history.d.ts +25 -0
- package/dist/core/record-history.d.ts.map +1 -0
- package/dist/core/record-history.js +471 -0
- package/dist/core/retention.d.ts +29 -0
- package/dist/core/retention.d.ts.map +1 -0
- package/dist/core/retention.js +98 -0
- package/dist/core/savings.d.ts +70 -0
- package/dist/core/savings.d.ts.map +1 -0
- package/dist/core/savings.js +87 -0
- package/dist/core/schedule-gate.d.ts +2 -0
- package/dist/core/schedule-gate.d.ts.map +1 -0
- package/dist/core/schedule-gate.js +211 -0
- package/dist/core/schedule-v2.d.ts +116 -0
- package/dist/core/schedule-v2.d.ts.map +1 -0
- package/dist/core/schedule-v2.js +586 -0
- package/dist/core/scheduler/at-fallback.d.ts +42 -0
- package/dist/core/scheduler/at-fallback.d.ts.map +1 -0
- package/dist/core/scheduler/at-fallback.js +70 -0
- package/dist/core/scheduler/index.d.ts +32 -0
- package/dist/core/scheduler/index.d.ts.map +1 -0
- package/dist/core/scheduler/index.js +63 -0
- package/dist/core/scheduler/linux.d.ts +46 -0
- package/dist/core/scheduler/linux.d.ts.map +1 -0
- package/dist/core/scheduler/linux.js +261 -0
- package/dist/core/scheduler/logs.d.ts +11 -0
- package/dist/core/scheduler/logs.d.ts.map +1 -0
- package/dist/core/scheduler/logs.js +34 -0
- package/dist/core/scheduler/mac.d.ts +46 -0
- package/dist/core/scheduler/mac.d.ts.map +1 -0
- package/dist/core/scheduler/mac.js +256 -0
- package/dist/core/scheduler/posix.d.ts +40 -0
- package/dist/core/scheduler/posix.d.ts.map +1 -0
- package/dist/core/scheduler/posix.js +100 -0
- package/dist/core/scheduler/registry.d.ts +43 -0
- package/dist/core/scheduler/registry.d.ts.map +1 -0
- package/dist/core/scheduler/registry.js +57 -0
- package/dist/core/scheduler/types.d.ts +86 -0
- package/dist/core/scheduler/types.d.ts.map +1 -0
- package/dist/core/scheduler/types.js +1 -0
- package/dist/core/scheduler/windows.d.ts +112 -0
- package/dist/core/scheduler/windows.d.ts.map +1 -0
- package/dist/core/scheduler/windows.js +749 -0
- package/dist/core/secrets.d.ts +66 -0
- package/dist/core/secrets.d.ts.map +1 -0
- package/dist/core/secrets.js +433 -0
- package/dist/core/self-analysis.d.ts +117 -0
- package/dist/core/self-analysis.d.ts.map +1 -0
- package/dist/core/self-analysis.js +539 -0
- package/dist/core/session.d.ts +42 -0
- package/dist/core/session.d.ts.map +1 -0
- package/dist/core/session.js +134 -0
- package/dist/core/shutdown.d.ts +26 -0
- package/dist/core/shutdown.d.ts.map +1 -0
- package/dist/core/shutdown.js +49 -0
- package/dist/core/structured-log.d.ts +84 -0
- package/dist/core/structured-log.d.ts.map +1 -0
- package/dist/core/structured-log.js +146 -0
- package/dist/core/summary.d.ts +69 -0
- package/dist/core/summary.d.ts.map +1 -0
- package/dist/core/summary.js +250 -0
- package/dist/core/telegram.d.ts +55 -0
- package/dist/core/telegram.d.ts.map +1 -0
- package/dist/core/telegram.js +344 -0
- package/dist/core/triage-chain.d.ts +40 -0
- package/dist/core/triage-chain.d.ts.map +1 -0
- package/dist/core/triage-chain.js +80 -0
- package/dist/core/triage-compare.d.ts +68 -0
- package/dist/core/triage-compare.d.ts.map +1 -0
- package/dist/core/triage-compare.js +184 -0
- package/dist/core/triage-rules.d.ts +23 -0
- package/dist/core/triage-rules.d.ts.map +1 -0
- package/dist/core/triage-rules.js +196 -0
- package/dist/core/triage-shadow.d.ts +91 -0
- package/dist/core/triage-shadow.d.ts.map +1 -0
- package/dist/core/triage-shadow.js +160 -0
- package/dist/core/triage-worker.d.ts +55 -0
- package/dist/core/triage-worker.d.ts.map +1 -0
- package/dist/core/triage-worker.js +314 -0
- package/dist/core/triage.d.ts +76 -0
- package/dist/core/triage.d.ts.map +1 -0
- package/dist/core/triage.js +271 -0
- package/dist/core/watch-paths.d.ts +6 -0
- package/dist/core/watch-paths.d.ts.map +1 -0
- package/dist/core/watch-paths.js +62 -0
- package/dist/core/wrappers/bash.d.ts +95 -0
- package/dist/core/wrappers/bash.d.ts.map +1 -0
- package/dist/core/wrappers/bash.js +413 -0
- package/dist/db/git-state-repo.d.ts +16 -0
- package/dist/db/git-state-repo.d.ts.map +1 -0
- package/dist/db/git-state-repo.js +38 -0
- package/dist/db/history-repo.d.ts +110 -0
- package/dist/db/history-repo.d.ts.map +1 -0
- package/dist/db/history-repo.js +300 -0
- package/dist/db/index.d.ts +49 -0
- package/dist/db/index.d.ts.map +1 -0
- package/dist/db/index.js +128 -0
- package/dist/db/metrics-repo.d.ts +46 -0
- package/dist/db/metrics-repo.d.ts.map +1 -0
- package/dist/db/metrics-repo.js +103 -0
- package/dist/db/migrate.d.ts +24 -0
- package/dist/db/migrate.d.ts.map +1 -0
- package/dist/db/migrate.js +244 -0
- package/dist/db/recovery.d.ts +11 -0
- package/dist/db/recovery.d.ts.map +1 -0
- package/dist/db/recovery.js +38 -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 +48 -0
- package/dist/db/run-resume.d.ts.map +1 -0
- package/dist/db/run-resume.js +137 -0
- package/dist/db/runs-repo.d.ts +120 -0
- package/dist/db/runs-repo.d.ts.map +1 -0
- package/dist/db/runs-repo.js +319 -0
- package/dist/db/schema.d.ts +38 -0
- package/dist/db/schema.d.ts.map +1 -0
- package/dist/db/schema.js +325 -0
- package/dist/db/settings-repo.d.ts +8 -0
- package/dist/db/settings-repo.d.ts.map +1 -0
- package/dist/db/settings-repo.js +27 -0
- package/dist/db/tasks-repo.d.ts +26 -0
- package/dist/db/tasks-repo.d.ts.map +1 -0
- package/dist/db/tasks-repo.js +120 -0
- package/dist/db/templates-repo.d.ts +17 -0
- package/dist/db/templates-repo.d.ts.map +1 -0
- package/dist/db/templates-repo.js +57 -0
- package/dist/history.d.ts +60 -0
- package/dist/history.d.ts.map +1 -0
- package/dist/history.js +70 -0
- package/dist/i18n.d.ts +75 -0
- package/dist/i18n.d.ts.map +1 -0
- package/dist/i18n.js +357 -0
- package/dist/index.d.ts +858 -0
- package/dist/index.d.ts.map +1 -0
- package/dist/index.js +5209 -0
- package/dist/integrations.d.ts +72 -0
- package/dist/integrations.d.ts.map +1 -0
- package/dist/integrations.js +233 -0
- package/dist/notifications.d.ts +199 -0
- package/dist/notifications.d.ts.map +1 -0
- package/dist/notifications.js +967 -0
- package/dist/profiles.d.ts +64 -0
- package/dist/profiles.d.ts.map +1 -0
- package/dist/profiles.js +305 -0
- package/dist/rpc.d.ts +3915 -0
- package/dist/rpc.d.ts.map +1 -0
- package/dist/rpc.js +1596 -0
- package/dist/schtasks.d.ts +32 -0
- package/dist/schtasks.d.ts.map +1 -0
- package/dist/schtasks.js +45 -0
- package/dist/server.d.ts +128 -0
- package/dist/server.d.ts.map +1 -0
- package/dist/server.js +2414 -0
- package/dist/settings.d.ts +389 -0
- package/dist/settings.d.ts.map +1 -0
- package/dist/settings.js +770 -0
- package/dist/shared/jobs-view.d.ts +59 -0
- package/dist/shared/jobs-view.d.ts.map +1 -0
- package/dist/shared/jobs-view.js +146 -0
- package/dist/skill.d.ts +15 -0
- package/dist/skill.d.ts.map +1 -0
- package/dist/skill.js +93 -0
- package/dist/task-transfer.d.ts +252 -0
- package/dist/task-transfer.d.ts.map +1 -0
- package/dist/task-transfer.js +632 -0
- package/dist/templates.d.ts +57 -0
- package/dist/templates.d.ts.map +1 -0
- package/dist/templates.js +16 -0
- package/dist/types.d.ts +112 -0
- package/dist/types.d.ts.map +1 -0
- package/dist/types.js +158 -0
- package/dist/version.d.ts +8 -0
- package/dist/version.d.ts.map +1 -0
- package/dist/version.js +27 -0
- package/dist/workspaces.d.ts +113 -0
- package/dist/workspaces.d.ts.map +1 -0
- package/dist/workspaces.js +393 -0
- package/docs/ARCHITECTURE.md +559 -0
- package/docs/COMPATIBILITY.md +237 -0
- package/docs/CONCEPT.md +242 -0
- package/docs/CROSS_PLATFORM.ru.md +152 -0
- package/docs/CROSS_PLATFORM.zh.md +148 -0
- package/docs/FAQ.md +52 -0
- package/docs/FAQ.ru.md +53 -0
- package/docs/FAQ.zh.md +43 -0
- package/docs/FEATURES.md +699 -0
- package/docs/FEATURES.zh.md +656 -0
- package/docs/LOCAL-AI.md +300 -0
- package/docs/MIGRATION.md +363 -0
- package/docs/README.ru.md +287 -0
- package/docs/README.zh.md +306 -0
- package/docs/SAVINGS.md +61 -0
- package/docs/SAVINGS.ru.md +60 -0
- package/docs/SAVINGS.zh.md +52 -0
- package/docs/V1-V2-COMPATIBILITY-PLAN.md +366 -0
- package/docs/ZH-LOCALE-PLAN.md +324 -0
- package/docs/dashboard.png +0 -0
- package/docs/spikes/local-model-structured-output.md +81 -0
- package/docs/spikes/ollama-qwen3-4b-smoke.json +28 -0
- package/docs/spikes/ollama-qwen3-4b.json +163 -0
- package/gui-experimental.cjs +9 -0
- package/index.js +2 -0
- package/locales/en.json +781 -0
- package/locales/ru.json +781 -0
- package/locales/zh.json +781 -0
- package/package.json +154 -13
- package/scripts/bench-local.mjs +321 -0
- package/scripts/check-zh-locale.mjs +218 -0
- package/scripts/demo-dashboard.mjs +209 -0
- package/scripts/run-tests.mjs +236 -0
- package/scripts/spike-local-structured.mjs +182 -0
- package/scripts/test-locale.mjs +45 -0
- package/skills/scheduled-job-best-practices/SKILL.md +158 -0
- package/skills/scheduled-job-best-practices/references/recipes.md +163 -0
- package/src/core/analytics.ts +424 -0
- package/src/core/audit.ts +418 -0
- package/src/core/cron-to-schtasks.ts +209 -0
- package/src/core/dry-run.ts +601 -0
- package/src/core/file-watcher.ts +245 -0
- package/src/core/git-trigger.ts +391 -0
- package/src/core/glob.ts +226 -0
- package/src/core/local-ai.ts +173 -0
- package/src/core/lock.ts +219 -0
- package/src/core/matrix.ts +947 -0
- package/src/core/native-notify.ts +157 -0
- package/src/core/one-shot.ts +239 -0
- package/src/core/otel.ts +128 -0
- package/src/core/permissions.ts +200 -0
- package/src/core/prometheus.ts +215 -0
- package/src/core/ps-wrapper.ts +1160 -0
- package/src/core/record-history.ts +615 -0
- package/src/core/retention.ts +141 -0
- package/src/core/savings.ts +150 -0
- package/src/core/schedule-gate.ts +253 -0
- package/src/core/schedule-v2.ts +668 -0
- package/src/core/scheduler/at-fallback.ts +113 -0
- package/src/core/scheduler/index.ts +82 -0
- package/src/core/scheduler/linux.ts +308 -0
- package/src/core/scheduler/logs.ts +37 -0
- package/src/core/scheduler/mac.ts +322 -0
- package/src/core/scheduler/posix.ts +128 -0
- package/src/core/scheduler/registry.ts +101 -0
- package/src/core/scheduler/types.ts +90 -0
- package/src/core/scheduler/windows.ts +881 -0
- package/src/core/secrets.ts +503 -0
- package/src/core/self-analysis.ts +744 -0
- package/src/core/session.ts +150 -0
- package/src/core/shutdown.ts +69 -0
- package/src/core/structured-log.ts +214 -0
- package/src/core/summary.ts +318 -0
- package/src/core/telegram.ts +436 -0
- package/src/core/triage-chain.ts +125 -0
- package/src/core/triage-compare.ts +277 -0
- package/src/core/triage-rules.ts +238 -0
- package/src/core/triage-shadow.ts +240 -0
- package/src/core/triage-worker.ts +344 -0
- package/src/core/triage.ts +366 -0
- package/src/core/watch-paths.ts +70 -0
- package/src/core/wrappers/bash.ts +532 -0
- package/src/db/git-state-repo.ts +62 -0
- package/src/db/history-repo.ts +492 -0
- package/src/db/index.ts +176 -0
- package/src/db/metrics-repo.ts +170 -0
- package/src/db/migrate.ts +328 -0
- package/src/db/recovery.ts +46 -0
- package/src/db/run-journal.ts +212 -0
- package/src/db/run-resume.ts +220 -0
- package/src/db/runs-repo.ts +481 -0
- package/src/db/schema.ts +349 -0
- package/src/db/settings-repo.ts +31 -0
- package/src/db/tasks-repo.ts +162 -0
- package/src/db/templates-repo.ts +77 -0
- package/src/gui.tsx +5222 -0
- package/src/history.ts +128 -0
- package/src/i18n.ts +413 -0
- package/src/index.ts +6642 -0
- package/src/integrations.ts +297 -0
- package/src/notifications.ts +1346 -0
- package/src/profiles.ts +345 -0
- package/src/rpc.ts +1704 -0
- package/src/schtasks.ts +75 -0
- package/src/server.ts +2663 -0
- package/src/settings.ts +1369 -0
- package/src/shared/jobs-view.ts +188 -0
- package/src/skill.ts +113 -0
- package/src/task-transfer.ts +946 -0
- package/src/templates.ts +67 -0
- package/src/tui-v1.tsx +341 -0
- package/src/tui.tsx +329 -0
- package/src/types.ts +226 -0
- package/src/version.ts +27 -0
- package/src/workspaces.ts +487 -0
|
@@ -0,0 +1,244 @@
|
|
|
1
|
+
import fs from "node:fs/promises";
|
|
2
|
+
import path from "node:path";
|
|
3
|
+
import { randomUUID } from "node:crypto";
|
|
4
|
+
import { PLUGIN_DIR } from "../types.js";
|
|
5
|
+
import { getDb, isDatabaseEmpty, withTransaction } from "./index.js";
|
|
6
|
+
import { LEGACY_METRICS_TASK, upsertMetricsRow, } from "./metrics-repo.js";
|
|
7
|
+
const EMPTY_RESULT = {
|
|
8
|
+
migrated: false,
|
|
9
|
+
tasks: 0,
|
|
10
|
+
history: 0,
|
|
11
|
+
templates: 0,
|
|
12
|
+
metrics: 0,
|
|
13
|
+
backups: [],
|
|
14
|
+
};
|
|
15
|
+
const JSON_FILES = ["tasks.json", "history.json", "metrics.json", "templates.json"];
|
|
16
|
+
async function loadJsonFile(file) {
|
|
17
|
+
try {
|
|
18
|
+
const raw = await fs.readFile(file, "utf8");
|
|
19
|
+
try {
|
|
20
|
+
return { path: file, exists: true, value: JSON.parse(raw) };
|
|
21
|
+
}
|
|
22
|
+
catch (err) {
|
|
23
|
+
throw new Error(`Некорректный JSON в ${path.basename(file)}: ${err instanceof Error ? err.message : String(err)}`);
|
|
24
|
+
}
|
|
25
|
+
}
|
|
26
|
+
catch (err) {
|
|
27
|
+
if (err?.code === "ENOENT")
|
|
28
|
+
return { path: file, exists: false, value: null };
|
|
29
|
+
throw err;
|
|
30
|
+
}
|
|
31
|
+
}
|
|
32
|
+
function asArray(value) {
|
|
33
|
+
if (Array.isArray(value))
|
|
34
|
+
return value;
|
|
35
|
+
if (value && typeof value === "object" && Array.isArray(value.tasks)) {
|
|
36
|
+
return value.tasks;
|
|
37
|
+
}
|
|
38
|
+
return [];
|
|
39
|
+
}
|
|
40
|
+
function toNumber(value) {
|
|
41
|
+
if (value === null || value === undefined || value === "")
|
|
42
|
+
return null;
|
|
43
|
+
const num = Number(value);
|
|
44
|
+
return Number.isFinite(num) ? num : null;
|
|
45
|
+
}
|
|
46
|
+
function toStringOrNull(value) {
|
|
47
|
+
return typeof value === "string" && value.length > 0 ? value : null;
|
|
48
|
+
}
|
|
49
|
+
/** Приводит старую запись истории к колонкам БД. */
|
|
50
|
+
function normalizeHistoryRow(raw) {
|
|
51
|
+
if (!raw || typeof raw !== "object")
|
|
52
|
+
return null;
|
|
53
|
+
const taskName = typeof raw.taskName === "string" ? raw.taskName.trim() : "";
|
|
54
|
+
const startedAt = typeof raw.startedAt === "string" ? raw.startedAt : "";
|
|
55
|
+
if (!taskName || !startedAt)
|
|
56
|
+
return null;
|
|
57
|
+
const status = raw.status === "success" || raw.status === "timeout" ? raw.status : "error";
|
|
58
|
+
return {
|
|
59
|
+
taskName,
|
|
60
|
+
status,
|
|
61
|
+
startedAt,
|
|
62
|
+
finishedAt: toStringOrNull(raw.finishedAt),
|
|
63
|
+
durationMs: toNumber(raw.durationMs),
|
|
64
|
+
error: toStringOrNull(raw.error),
|
|
65
|
+
tokens: toNumber(raw.tokens),
|
|
66
|
+
costUsd: toNumber(raw.costUsd),
|
|
67
|
+
model: toStringOrNull(raw.model),
|
|
68
|
+
preFlightStatus: toStringOrNull(raw.preFlightStatus),
|
|
69
|
+
postFlightStatus: toStringOrNull(raw.postFlightStatus),
|
|
70
|
+
nextTask: toStringOrNull(raw.nextTask),
|
|
71
|
+
};
|
|
72
|
+
}
|
|
73
|
+
/**
|
|
74
|
+
* Выполняет миграцию. Возвращает статистику; если БД не пуста или JSON нет —
|
|
75
|
+
* migrated: false и нули.
|
|
76
|
+
*/
|
|
77
|
+
export async function migrateJsonToDb(pluginDir = PLUGIN_DIR) {
|
|
78
|
+
if (!isDatabaseEmpty())
|
|
79
|
+
return { ...EMPTY_RESULT };
|
|
80
|
+
const files = await Promise.all(JSON_FILES.map((name) => loadJsonFile(path.join(pluginDir, name))));
|
|
81
|
+
if (!files.some((file) => file.exists))
|
|
82
|
+
return { ...EMPTY_RESULT };
|
|
83
|
+
const byName = new Map();
|
|
84
|
+
for (const file of files)
|
|
85
|
+
byName.set(path.basename(file.path), file);
|
|
86
|
+
const taskItems = asArray(byName.get("tasks.json")?.value);
|
|
87
|
+
const historyItems = asArray(byName.get("history.json")?.value)
|
|
88
|
+
.map(normalizeHistoryRow)
|
|
89
|
+
.filter((row) => row !== null);
|
|
90
|
+
const templateItems = asArray(byName.get("templates.json")?.value);
|
|
91
|
+
const legacyMetrics = byName.get("metrics.json")?.value &&
|
|
92
|
+
typeof byName.get("metrics.json")?.value === "object"
|
|
93
|
+
? byName.get("metrics.json").value
|
|
94
|
+
: null;
|
|
95
|
+
const now = new Date().toISOString();
|
|
96
|
+
let insertedTasks = 0;
|
|
97
|
+
let insertedHistory = 0;
|
|
98
|
+
let insertedTemplates = 0;
|
|
99
|
+
let insertedMetrics = 0;
|
|
100
|
+
withTransaction(() => {
|
|
101
|
+
const db = getDb();
|
|
102
|
+
// --- tasks ---
|
|
103
|
+
const insertTask = db.prepare("INSERT INTO tasks (name, definition_json, created_at, updated_at) VALUES (?, ?, ?, ?)");
|
|
104
|
+
const seenTasks = new Set();
|
|
105
|
+
for (const item of taskItems) {
|
|
106
|
+
if (!item || typeof item !== "object")
|
|
107
|
+
continue;
|
|
108
|
+
const name = typeof item.name === "string" ? item.name.trim() : "";
|
|
109
|
+
if (!name || seenTasks.has(name.toLowerCase()))
|
|
110
|
+
continue;
|
|
111
|
+
seenTasks.add(name.toLowerCase());
|
|
112
|
+
// workdir → workingDirectory, как в старом loadTaskDefinitions().
|
|
113
|
+
const definition = { ...item, name };
|
|
114
|
+
if (definition.workingDirectory === undefined &&
|
|
115
|
+
typeof definition.workdir === "string" &&
|
|
116
|
+
definition.workdir.trim()) {
|
|
117
|
+
definition.workingDirectory = definition.workdir.trim();
|
|
118
|
+
}
|
|
119
|
+
delete definition.workdir;
|
|
120
|
+
const createdAt = typeof definition.createdAt === "string" && definition.createdAt
|
|
121
|
+
? definition.createdAt
|
|
122
|
+
: now;
|
|
123
|
+
definition.createdAt = createdAt;
|
|
124
|
+
insertTask.run(name, JSON.stringify(definition), createdAt, now);
|
|
125
|
+
insertedTasks += 1;
|
|
126
|
+
}
|
|
127
|
+
// --- history ---
|
|
128
|
+
const insertHistory = db.prepare(`INSERT INTO history (
|
|
129
|
+
task_name, status, started_at, finished_at, duration_ms, error,
|
|
130
|
+
tokens, cost_usd, model, pre_flight_status, post_flight_status, next_task
|
|
131
|
+
) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`);
|
|
132
|
+
for (const row of historyItems) {
|
|
133
|
+
insertHistory.run(row.taskName, row.status, row.startedAt, row.finishedAt, row.durationMs === null ? null : Math.max(0, Math.trunc(row.durationMs)), row.error, row.tokens === null ? null : Math.max(0, Math.trunc(row.tokens)), row.costUsd === null ? null : Math.max(0, row.costUsd), row.model, row.preFlightStatus, row.postFlightStatus, row.nextTask);
|
|
134
|
+
insertedHistory += 1;
|
|
135
|
+
}
|
|
136
|
+
// --- templates ---
|
|
137
|
+
const insertTemplate = db.prepare("INSERT INTO templates (id, name, definition_json) VALUES (?, ?, ?)");
|
|
138
|
+
const seenTemplates = new Set();
|
|
139
|
+
for (const item of templateItems) {
|
|
140
|
+
if (!item || typeof item !== "object")
|
|
141
|
+
continue;
|
|
142
|
+
if (typeof item.prompt !== "string")
|
|
143
|
+
continue;
|
|
144
|
+
const name = typeof item.name === "string" ? item.name.trim() : "";
|
|
145
|
+
if (!name)
|
|
146
|
+
continue;
|
|
147
|
+
const id = typeof item.id === "string" && item.id.trim() ? item.id.trim() : randomUUID();
|
|
148
|
+
const key = id.toLowerCase();
|
|
149
|
+
if (seenTemplates.has(key))
|
|
150
|
+
continue;
|
|
151
|
+
seenTemplates.add(key);
|
|
152
|
+
const template = { ...item, id, name };
|
|
153
|
+
insertTemplate.run(id, name, JSON.stringify(template));
|
|
154
|
+
insertedTemplates += 1;
|
|
155
|
+
}
|
|
156
|
+
// --- metrics ---
|
|
157
|
+
// Сначала агрегируем по истории, затем добавляем «хвост» из metrics.json:
|
|
158
|
+
// старый history.json хранил только 200 записей, а счётчики — всё время.
|
|
159
|
+
const perTask = new Map();
|
|
160
|
+
for (const row of historyItems) {
|
|
161
|
+
const key = row.taskName.toLowerCase();
|
|
162
|
+
const current = perTask.get(key) ??
|
|
163
|
+
{
|
|
164
|
+
taskName: row.taskName,
|
|
165
|
+
total: 0,
|
|
166
|
+
success: 0,
|
|
167
|
+
error: 0,
|
|
168
|
+
partial: 0,
|
|
169
|
+
tokens: 0,
|
|
170
|
+
costUsd: 0,
|
|
171
|
+
};
|
|
172
|
+
current.total += 1;
|
|
173
|
+
if (row.status === "success")
|
|
174
|
+
current.success += 1;
|
|
175
|
+
else if (row.status === "partial")
|
|
176
|
+
current.partial += 1;
|
|
177
|
+
else
|
|
178
|
+
current.error += 1;
|
|
179
|
+
current.tokens += Math.max(0, row.tokens ?? 0);
|
|
180
|
+
current.costUsd += Math.max(0, row.costUsd ?? 0);
|
|
181
|
+
perTask.set(key, current);
|
|
182
|
+
}
|
|
183
|
+
if (legacyMetrics) {
|
|
184
|
+
const migrated = [...perTask.values()].reduce((acc, row) => ({
|
|
185
|
+
total: acc.total + row.total,
|
|
186
|
+
success: acc.success + row.success,
|
|
187
|
+
error: acc.error + row.error,
|
|
188
|
+
partial: acc.partial + row.partial,
|
|
189
|
+
tokens: acc.tokens + row.tokens,
|
|
190
|
+
costUsd: acc.costUsd + row.costUsd,
|
|
191
|
+
}), { total: 0, success: 0, error: 0, partial: 0, tokens: 0, costUsd: 0 });
|
|
192
|
+
const extra = {
|
|
193
|
+
total: Math.max(0, (toNumber(legacyMetrics.total) ?? 0) - migrated.total),
|
|
194
|
+
success: Math.max(0, (toNumber(legacyMetrics.success) ?? 0) - migrated.success),
|
|
195
|
+
error: Math.max(0, (toNumber(legacyMetrics.error) ?? 0) - migrated.error),
|
|
196
|
+
// В старом metrics.json не было отдельного счётчика partial.
|
|
197
|
+
partial: 0,
|
|
198
|
+
tokens: Math.max(0, (toNumber(legacyMetrics.tokens) ?? 0) - migrated.tokens),
|
|
199
|
+
costUsd: Math.max(0, (toNumber(legacyMetrics.costUsd) ?? 0) - migrated.costUsd),
|
|
200
|
+
};
|
|
201
|
+
if (extra.total > 0 ||
|
|
202
|
+
extra.tokens > 0 ||
|
|
203
|
+
extra.costUsd > 0) {
|
|
204
|
+
perTask.set(LEGACY_METRICS_TASK, {
|
|
205
|
+
taskName: LEGACY_METRICS_TASK,
|
|
206
|
+
total: extra.total,
|
|
207
|
+
success: extra.success,
|
|
208
|
+
error: extra.error,
|
|
209
|
+
partial: extra.partial,
|
|
210
|
+
tokens: extra.tokens,
|
|
211
|
+
costUsd: extra.costUsd,
|
|
212
|
+
});
|
|
213
|
+
}
|
|
214
|
+
}
|
|
215
|
+
for (const row of perTask.values()) {
|
|
216
|
+
upsertMetricsRow(row);
|
|
217
|
+
insertedMetrics += 1;
|
|
218
|
+
}
|
|
219
|
+
});
|
|
220
|
+
// --- backups (после успешного COMMIT) ---
|
|
221
|
+
const backups = [];
|
|
222
|
+
for (const file of files) {
|
|
223
|
+
if (!file.exists)
|
|
224
|
+
continue;
|
|
225
|
+
const backup = `${file.path}.bak`;
|
|
226
|
+
try {
|
|
227
|
+
await fs.rm(backup, { force: true });
|
|
228
|
+
await fs.rename(file.path, backup);
|
|
229
|
+
backups.push(path.basename(backup));
|
|
230
|
+
}
|
|
231
|
+
catch (err) {
|
|
232
|
+
console.error(`[migrate] Не удалось переименовать ${path.basename(file.path)} в .bak: ${err instanceof Error ? err.message : String(err)}`);
|
|
233
|
+
}
|
|
234
|
+
}
|
|
235
|
+
console.log(`[migrate] Перемещено ${insertedTasks} задач, ${insertedHistory} записей истории, ${insertedTemplates} шаблонов.`);
|
|
236
|
+
return {
|
|
237
|
+
migrated: true,
|
|
238
|
+
tasks: insertedTasks,
|
|
239
|
+
history: insertedHistory,
|
|
240
|
+
templates: insertedTemplates,
|
|
241
|
+
metrics: insertedMetrics,
|
|
242
|
+
backups,
|
|
243
|
+
};
|
|
244
|
+
}
|
|
@@ -0,0 +1,11 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Crash recovery: помечает незавершённые записи истории как error.
|
|
3
|
+
* Вызывается при setup() до запуска catch-up и файловых триггеров.
|
|
4
|
+
*/
|
|
5
|
+
export declare function recoverInterruptedRuns(): number;
|
|
6
|
+
/**
|
|
7
|
+
* Если БД пуста, а .json.bak остались (миграция не удалась или БД удалили),
|
|
8
|
+
* подсказываем пользователю, что делать. Возвращает true, если бэкапы найдены.
|
|
9
|
+
*/
|
|
10
|
+
export declare function checkJsonBackups(): boolean;
|
|
11
|
+
//# sourceMappingURL=recovery.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"recovery.d.ts","sourceRoot":"","sources":["../../src/db/recovery.ts"],"names":[],"mappings":"AASA;;;GAGG;AACH,wBAAgB,sBAAsB,IAAI,MAAM,CAQ/C;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,IAAI,OAAO,CAkB1C"}
|
|
@@ -0,0 +1,38 @@
|
|
|
1
|
+
import fs from "node:fs";
|
|
2
|
+
import path from "node:path";
|
|
3
|
+
import { PLUGIN_DIR } from "../types.js";
|
|
4
|
+
import { isDatabaseEmpty } from "./index.js";
|
|
5
|
+
import { recoverInterrupted } from "./history-repo.js";
|
|
6
|
+
/** Файлы, которые миграция переименовывает в .json.bak. */
|
|
7
|
+
const JSON_FILES = ["tasks.json", "history.json", "metrics.json", "templates.json"];
|
|
8
|
+
/**
|
|
9
|
+
* Crash recovery: помечает незавершённые записи истории как error.
|
|
10
|
+
* Вызывается при setup() до запуска catch-up и файловых триггеров.
|
|
11
|
+
*/
|
|
12
|
+
export function recoverInterruptedRuns() {
|
|
13
|
+
const count = recoverInterrupted();
|
|
14
|
+
if (count > 0) {
|
|
15
|
+
console.log(`[recovery] Восстановлено ${count} незавершённых записей истории — помечены как error.`);
|
|
16
|
+
}
|
|
17
|
+
return count;
|
|
18
|
+
}
|
|
19
|
+
/**
|
|
20
|
+
* Если БД пуста, а .json.bak остались (миграция не удалась или БД удалили),
|
|
21
|
+
* подсказываем пользователю, что делать. Возвращает true, если бэкапы найдены.
|
|
22
|
+
*/
|
|
23
|
+
export function checkJsonBackups() {
|
|
24
|
+
const backups = JSON_FILES.map((name) => path.join(PLUGIN_DIR, `${name}.bak`)).filter((file) => {
|
|
25
|
+
try {
|
|
26
|
+
return fs.existsSync(file);
|
|
27
|
+
}
|
|
28
|
+
catch {
|
|
29
|
+
return false;
|
|
30
|
+
}
|
|
31
|
+
});
|
|
32
|
+
if (backups.length === 0)
|
|
33
|
+
return false;
|
|
34
|
+
if (!isDatabaseEmpty())
|
|
35
|
+
return false;
|
|
36
|
+
console.warn("[recovery] Обнаружены бэкапы JSON, БД пуста. Запустите миграцию заново.");
|
|
37
|
+
return true;
|
|
38
|
+
}
|
|
@@ -0,0 +1,60 @@
|
|
|
1
|
+
import { type RunRecord, type RunStepRecord } from "./runs-repo.js";
|
|
2
|
+
/**
|
|
3
|
+
* Журнал выполнения шагов (Sprint 36.1.b).
|
|
4
|
+
*
|
|
5
|
+
* Каждый переход шага пишется отдельной транзакцией и фиксируется в WAL
|
|
6
|
+
* **до** запуска тела шага и **после** него. Если процесс убьют посреди шага,
|
|
7
|
+
* в БД останется строка `running` с номером попытки `attempt`: её помечает
|
|
8
|
+
* `recoverInterruptedSteps()`, а повтор идёт через `retryStep()` с `attempt + 1`.
|
|
9
|
+
*/
|
|
10
|
+
/** Текст ошибки, которым помечается шаг, прерванный падением процесса. */
|
|
11
|
+
export declare const STEP_INTERRUPTED_ERROR = "\u041F\u0440\u0435\u0440\u0432\u0430\u043D\u043E \u043F\u0430\u0434\u0435\u043D\u0438\u0435\u043C \u043F\u0440\u043E\u0446\u0435\u0441\u0441\u0430";
|
|
12
|
+
/** Опции начала попытки. */
|
|
13
|
+
export interface BeginStepOptions {
|
|
14
|
+
/** Начать запуск, если он ещё в статусе pending (по умолчанию true). */
|
|
15
|
+
startRun?: boolean;
|
|
16
|
+
}
|
|
17
|
+
/** Результат выполнения шага через `runStepStatefully`. */
|
|
18
|
+
export interface StepExecution<T> {
|
|
19
|
+
/** Состояние шага после завершения. */
|
|
20
|
+
step: RunStepRecord;
|
|
21
|
+
/** Значение, которое вернуло тело шага. */
|
|
22
|
+
result: T;
|
|
23
|
+
/** Номер попытки, с которым выполнялся шаг. */
|
|
24
|
+
attempt: number;
|
|
25
|
+
}
|
|
26
|
+
/**
|
|
27
|
+
* Открывает попытку шага: run pending → running (если нужно), шаг pending → running.
|
|
28
|
+
*
|
|
29
|
+
* Запись коммитится до возврата управления, поэтому вызывающий код может
|
|
30
|
+
* безопасно запускать побочные эффекты: факт старта уже на диске.
|
|
31
|
+
*
|
|
32
|
+
* Если шаг остался `failed` после падения — выполняется `retryStep`, и номер
|
|
33
|
+
* попытки увеличивается, а не начинается заново.
|
|
34
|
+
*/
|
|
35
|
+
export declare function beginStepAttempt(runId: string, stepName: string, options?: BeginStepOptions): RunStepRecord;
|
|
36
|
+
/** Закрывает попытку успехом: running → passed, сохраняет output. */
|
|
37
|
+
export declare function recordStepSuccess(runId: string, stepName: string, output?: unknown): RunStepRecord;
|
|
38
|
+
/** Закрывает попытку ошибкой: running → failed, сохраняет текст ошибки. */
|
|
39
|
+
export declare function recordStepFailure(runId: string, stepName: string, error: unknown): RunStepRecord;
|
|
40
|
+
/**
|
|
41
|
+
* Выполняет шаг с журналированием: состояние `running` фиксируется до вызова
|
|
42
|
+
* `body`, результат (`passed`/`failed`) — после. Ошибка тела не теряется:
|
|
43
|
+
* шаг помечается failed, исключение пробрасывается дальше.
|
|
44
|
+
*/
|
|
45
|
+
export declare function runStepStatefully<T>(runId: string, stepName: string, body: () => T, options?: BeginStepOptions): StepExecution<T>;
|
|
46
|
+
/** Асинхронный вариант `runStepStatefully` для шагов с I/O. */
|
|
47
|
+
export declare function runStepStatefullyAsync<T>(runId: string, stepName: string, body: () => Promise<T> | T, options?: BeginStepOptions): Promise<StepExecution<T>>;
|
|
48
|
+
/**
|
|
49
|
+
* Помечает все зависшие `running`-шаги как failed, сохраняя `attempt`.
|
|
50
|
+
*
|
|
51
|
+
* Возвращает обновлённые записи. `attempt` не сбрасывается — следующая попытка
|
|
52
|
+
* получит `attempt + 1` через `retryStep`, поэтому номер попытки переживает
|
|
53
|
+
* падение процесса и восстановление.
|
|
54
|
+
*/
|
|
55
|
+
export declare function recoverInterruptedSteps(runId?: string): RunStepRecord[];
|
|
56
|
+
/** Список шагов в статусе running (для диагностики и восстановления). */
|
|
57
|
+
export declare function listRunningSteps(runId?: string): RunStepRecord[];
|
|
58
|
+
/** Запуск по id либо ошибка (удобно для журнала и тестов). */
|
|
59
|
+
export declare function requireRun(runId: string): RunRecord;
|
|
60
|
+
//# sourceMappingURL=run-journal.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"run-journal.d.ts","sourceRoot":"","sources":["../../src/db/run-journal.ts"],"names":[],"mappings":"AACA,OAAO,EAQL,KAAK,SAAS,EACd,KAAK,aAAa,EACnB,MAAM,gBAAgB,CAAC;AAExB;;;;;;;GAOG;AAEH,0EAA0E;AAC1E,eAAO,MAAM,sBAAsB,uJAA+B,CAAC;AAEnE,4BAA4B;AAC5B,MAAM,WAAW,gBAAgB;IAC/B,wEAAwE;IACxE,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,2DAA2D;AAC3D,MAAM,WAAW,aAAa,CAAC,CAAC;IAC9B,uCAAuC;IACvC,IAAI,EAAE,aAAa,CAAC;IACpB,2CAA2C;IAC3C,MAAM,EAAE,CAAC,CAAC;IACV,+CAA+C;IAC/C,OAAO,EAAE,MAAM,CAAC;CACjB;AAWD;;;;;;;;GAQG;AACH,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,MAAM,EAChB,OAAO,GAAE,gBAAqB,GAC7B,aAAa,CAcf;AAED,qEAAqE;AACrE,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,MAAM,EAChB,MAAM,CAAC,EAAE,OAAO,GACf,aAAa,CAGf;AAED,2EAA2E;AAC3E,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,OAAO,GACb,aAAa,CAGf;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,CAAC,EACjC,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,MAAM,CAAC,EACb,OAAO,GAAE,gBAAqB,GAC7B,aAAa,CAAC,CAAC,CAAC,CAWlB;AAED,+DAA+D;AAC/D,wBAAsB,sBAAsB,CAAC,CAAC,EAC5C,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,EAC1B,OAAO,GAAE,gBAAqB,GAC7B,OAAO,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,CAW3B;AAED;;;;;;GAMG;AACH,wBAAgB,uBAAuB,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,aAAa,EAAE,CAevE;AAED,yEAAyE;AACzE,wBAAgB,gBAAgB,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,aAAa,EAAE,CAgBhE;AAED,8DAA8D;AAC9D,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,CAInD"}
|
|
@@ -0,0 +1,143 @@
|
|
|
1
|
+
import { getDb, withTransaction } from "./index.js";
|
|
2
|
+
import { finishStep, getRun, getStep, retryStep, startRun, startStep, } from "./runs-repo.js";
|
|
3
|
+
/**
|
|
4
|
+
* Журнал выполнения шагов (Sprint 36.1.b).
|
|
5
|
+
*
|
|
6
|
+
* Каждый переход шага пишется отдельной транзакцией и фиксируется в WAL
|
|
7
|
+
* **до** запуска тела шага и **после** него. Если процесс убьют посреди шага,
|
|
8
|
+
* в БД останется строка `running` с номером попытки `attempt`: её помечает
|
|
9
|
+
* `recoverInterruptedSteps()`, а повтор идёт через `retryStep()` с `attempt + 1`.
|
|
10
|
+
*/
|
|
11
|
+
/** Текст ошибки, которым помечается шаг, прерванный падением процесса. */
|
|
12
|
+
export const STEP_INTERRUPTED_ERROR = "Прервано падением процесса";
|
|
13
|
+
function nowIso() {
|
|
14
|
+
return new Date().toISOString();
|
|
15
|
+
}
|
|
16
|
+
function errorMessage(err) {
|
|
17
|
+
if (err instanceof Error)
|
|
18
|
+
return err.message;
|
|
19
|
+
return String(err);
|
|
20
|
+
}
|
|
21
|
+
/**
|
|
22
|
+
* Открывает попытку шага: run pending → running (если нужно), шаг pending → running.
|
|
23
|
+
*
|
|
24
|
+
* Запись коммитится до возврата управления, поэтому вызывающий код может
|
|
25
|
+
* безопасно запускать побочные эффекты: факт старта уже на диске.
|
|
26
|
+
*
|
|
27
|
+
* Если шаг остался `failed` после падения — выполняется `retryStep`, и номер
|
|
28
|
+
* попытки увеличивается, а не начинается заново.
|
|
29
|
+
*/
|
|
30
|
+
export function beginStepAttempt(runId, stepName, options = {}) {
|
|
31
|
+
if (options.startRun !== false) {
|
|
32
|
+
const run = requireRun(runId);
|
|
33
|
+
if (run.status === "pending")
|
|
34
|
+
startRun(runId);
|
|
35
|
+
}
|
|
36
|
+
const step = requireStep(runId, stepName);
|
|
37
|
+
if (step.status === "failed") {
|
|
38
|
+
retryStep(step.id);
|
|
39
|
+
}
|
|
40
|
+
else {
|
|
41
|
+
startStep(step.id);
|
|
42
|
+
}
|
|
43
|
+
return requireStep(runId, stepName);
|
|
44
|
+
}
|
|
45
|
+
/** Закрывает попытку успехом: running → passed, сохраняет output. */
|
|
46
|
+
export function recordStepSuccess(runId, stepName, output) {
|
|
47
|
+
completeStep(runId, stepName, "passed", { output });
|
|
48
|
+
return requireStep(runId, stepName);
|
|
49
|
+
}
|
|
50
|
+
/** Закрывает попытку ошибкой: running → failed, сохраняет текст ошибки. */
|
|
51
|
+
export function recordStepFailure(runId, stepName, error) {
|
|
52
|
+
completeStep(runId, stepName, "failed", { error: errorMessage(error) });
|
|
53
|
+
return requireStep(runId, stepName);
|
|
54
|
+
}
|
|
55
|
+
/**
|
|
56
|
+
* Выполняет шаг с журналированием: состояние `running` фиксируется до вызова
|
|
57
|
+
* `body`, результат (`passed`/`failed`) — после. Ошибка тела не теряется:
|
|
58
|
+
* шаг помечается failed, исключение пробрасывается дальше.
|
|
59
|
+
*/
|
|
60
|
+
export function runStepStatefully(runId, stepName, body, options = {}) {
|
|
61
|
+
const attempt = beginStepAttempt(runId, stepName, options).attempt;
|
|
62
|
+
let result;
|
|
63
|
+
try {
|
|
64
|
+
result = body();
|
|
65
|
+
}
|
|
66
|
+
catch (err) {
|
|
67
|
+
recordStepFailure(runId, stepName, err);
|
|
68
|
+
throw err;
|
|
69
|
+
}
|
|
70
|
+
const step = recordStepSuccess(runId, stepName, result);
|
|
71
|
+
return { step, result, attempt };
|
|
72
|
+
}
|
|
73
|
+
/** Асинхронный вариант `runStepStatefully` для шагов с I/O. */
|
|
74
|
+
export async function runStepStatefullyAsync(runId, stepName, body, options = {}) {
|
|
75
|
+
const attempt = beginStepAttempt(runId, stepName, options).attempt;
|
|
76
|
+
let result;
|
|
77
|
+
try {
|
|
78
|
+
result = await body();
|
|
79
|
+
}
|
|
80
|
+
catch (err) {
|
|
81
|
+
recordStepFailure(runId, stepName, err);
|
|
82
|
+
throw err;
|
|
83
|
+
}
|
|
84
|
+
const step = recordStepSuccess(runId, stepName, result);
|
|
85
|
+
return { step, result, attempt };
|
|
86
|
+
}
|
|
87
|
+
/**
|
|
88
|
+
* Помечает все зависшие `running`-шаги как failed, сохраняя `attempt`.
|
|
89
|
+
*
|
|
90
|
+
* Возвращает обновлённые записи. `attempt` не сбрасывается — следующая попытка
|
|
91
|
+
* получит `attempt + 1` через `retryStep`, поэтому номер попытки переживает
|
|
92
|
+
* падение процесса и восстановление.
|
|
93
|
+
*/
|
|
94
|
+
export function recoverInterruptedSteps(runId) {
|
|
95
|
+
const running = listRunningSteps(runId);
|
|
96
|
+
if (running.length === 0)
|
|
97
|
+
return [];
|
|
98
|
+
return withTransaction(() => {
|
|
99
|
+
const timestamp = nowIso();
|
|
100
|
+
const update = getDb().prepare(`UPDATE run_steps SET status = 'failed', error = ?, finished_at = ?,
|
|
101
|
+
updated_at = ? WHERE id = ? AND status = 'running'`);
|
|
102
|
+
for (const step of running) {
|
|
103
|
+
update.run(STEP_INTERRUPTED_ERROR, timestamp, timestamp, step.id);
|
|
104
|
+
}
|
|
105
|
+
return running.map((step) => requireStep(step.runId, step.stepName));
|
|
106
|
+
});
|
|
107
|
+
}
|
|
108
|
+
/** Список шагов в статусе running (для диагностики и восстановления). */
|
|
109
|
+
export function listRunningSteps(runId) {
|
|
110
|
+
const sql = runId
|
|
111
|
+
? "SELECT run_id, step_name FROM run_steps WHERE status = 'running' AND run_id = ? ORDER BY created_at"
|
|
112
|
+
: "SELECT run_id, step_name FROM run_steps WHERE status = 'running' ORDER BY created_at";
|
|
113
|
+
const statement = getDb().prepare(sql);
|
|
114
|
+
const rows = (runId ? statement.all(runId) : statement.all());
|
|
115
|
+
const steps = [];
|
|
116
|
+
for (const row of rows) {
|
|
117
|
+
const step = getStep(String(row.run_id), String(row.step_name));
|
|
118
|
+
if (step && step.status === "running")
|
|
119
|
+
steps.push(step);
|
|
120
|
+
}
|
|
121
|
+
return steps;
|
|
122
|
+
}
|
|
123
|
+
/** Запуск по id либо ошибка (удобно для журнала и тестов). */
|
|
124
|
+
export function requireRun(runId) {
|
|
125
|
+
const run = getRun(runId);
|
|
126
|
+
if (!run)
|
|
127
|
+
throw new Error(`Запуск не найден: ${runId}`);
|
|
128
|
+
return run;
|
|
129
|
+
}
|
|
130
|
+
function requireStep(runId, stepName) {
|
|
131
|
+
const step = getStep(runId, stepName);
|
|
132
|
+
if (!step)
|
|
133
|
+
throw new Error(`Шаг не найден: ${runId}/${stepName}`);
|
|
134
|
+
return step;
|
|
135
|
+
}
|
|
136
|
+
function completeStep(runId, stepName, status, options) {
|
|
137
|
+
const step = requireStep(runId, stepName);
|
|
138
|
+
if (step.status !== "running") {
|
|
139
|
+
// Повторная запись результата — ошибка вызывающего кода, а не «тихий» пропуск.
|
|
140
|
+
throw new Error(`Шаг ${runId}/${stepName} не выполняется (статус ${step.status}), запись ${status} невозможна.`);
|
|
141
|
+
}
|
|
142
|
+
finishStep(step.id, status, options);
|
|
143
|
+
}
|
|
@@ -0,0 +1,48 @@
|
|
|
1
|
+
import { type RunRecord, type RunStepRecord } from "./runs-repo.js";
|
|
2
|
+
/**
|
|
3
|
+
* Resume с середины (Sprint 36.2).
|
|
4
|
+
*
|
|
5
|
+
* Линейная цепочка шагов хранится в `run_steps` в порядке создания. Возобновление
|
|
6
|
+
* находит первый незавершённый шаг (не `passed`/`skipped`), помечает зависшие
|
|
7
|
+
* `running` как прерванные и выполняет остаток цепочки через журнал 36.1.b.
|
|
8
|
+
* Уже успешные шаги повторно не запускаются, а `attempt` упавших растёт.
|
|
9
|
+
*/
|
|
10
|
+
/** Обработчик тела шага. Получает актуальную запись шага. */
|
|
11
|
+
export type StepHandler = (step: RunStepRecord) => unknown;
|
|
12
|
+
/** Опции возобновления. */
|
|
13
|
+
export interface ResumeOptions {
|
|
14
|
+
/** Тела шагов по имени. Отсутствие обработчика — ошибка до запуска цепочки. */
|
|
15
|
+
handlers: Record<string, StepHandler>;
|
|
16
|
+
/** Восстанавливать зависшие `running`-шаги перед продолжением (по умолчанию true). */
|
|
17
|
+
recover?: boolean;
|
|
18
|
+
/** Останавливаться на первой ошибке (по умолчанию true). */
|
|
19
|
+
stopOnError?: boolean;
|
|
20
|
+
}
|
|
21
|
+
/** Результат возобновления прогона. */
|
|
22
|
+
export interface ResumeResult {
|
|
23
|
+
/** Состояние запуска после возобновления. */
|
|
24
|
+
run: RunRecord;
|
|
25
|
+
/** С какого шага продолжили (`null`, если продолжать нечего). */
|
|
26
|
+
resumedFrom: string | null;
|
|
27
|
+
/** Номер попытки, с которым выполнялся первый возобновлённый шаг. */
|
|
28
|
+
resumedFromAttempt: number | null;
|
|
29
|
+
/** Шаги, выполненные в этот раз. */
|
|
30
|
+
executed: string[];
|
|
31
|
+
/** Шаги, пропущенные как уже завершённые. */
|
|
32
|
+
skipped: string[];
|
|
33
|
+
/** Первый упавший шаг, если цепочка остановилась. */
|
|
34
|
+
failedStep: string | null;
|
|
35
|
+
/** Текст ошибки упавшего шага. */
|
|
36
|
+
error: string | null;
|
|
37
|
+
}
|
|
38
|
+
/** Первый незавершённый шаг цепочки либо null. Без восстановления состояния. */
|
|
39
|
+
export declare function findResumeStep(runId: string): RunStepRecord | null;
|
|
40
|
+
/**
|
|
41
|
+
* Возобновляет линейную цепочку шагов синхронно.
|
|
42
|
+
*
|
|
43
|
+
* Все проверки (наличие обработчиков) выполняются до первого побочного эффекта.
|
|
44
|
+
*/
|
|
45
|
+
export declare function resumeRunSync(runId: string, options: ResumeOptions): ResumeResult;
|
|
46
|
+
/** Асинхронный вариант `resumeRunSync` для шагов с I/O. */
|
|
47
|
+
export declare function resumeRun(runId: string, options: ResumeOptions): Promise<ResumeResult>;
|
|
48
|
+
//# sourceMappingURL=run-resume.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"run-resume.d.ts","sourceRoot":"","sources":["../../src/db/run-resume.ts"],"names":[],"mappings":"AAAA,OAAO,EAML,KAAK,SAAS,EACd,KAAK,aAAa,EACnB,MAAM,gBAAgB,CAAC;AAQxB;;;;;;;GAOG;AAEH,6DAA6D;AAC7D,MAAM,MAAM,WAAW,GAAG,CAAC,IAAI,EAAE,aAAa,KAAK,OAAO,CAAC;AAE3D,2BAA2B;AAC3B,MAAM,WAAW,aAAa;IAC5B,+EAA+E;IAC/E,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;IACtC,sFAAsF;IACtF,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,4DAA4D;IAC5D,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAED,uCAAuC;AACvC,MAAM,WAAW,YAAY;IAC3B,6CAA6C;IAC7C,GAAG,EAAE,SAAS,CAAC;IACf,iEAAiE;IACjE,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,qEAAqE;IACrE,kBAAkB,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC,oCAAoC;IACpC,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,6CAA6C;IAC7C,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,qDAAqD;IACrD,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,kCAAkC;IAClC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;CACtB;AAOD,gFAAgF;AAChF,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,aAAa,GAAG,IAAI,CAGlE;AAgCD;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,aAAa,GAAG,YAAY,CAkCjF;AAED,2DAA2D;AAC3D,wBAAsB,SAAS,CAC7B,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,aAAa,GACrB,OAAO,CAAC,YAAY,CAAC,CAkCvB"}
|