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/dist/core/lock.js
CHANGED
|
@@ -1,6 +1,118 @@
|
|
|
1
1
|
import fs from "node:fs/promises";
|
|
2
2
|
import path from "node:path";
|
|
3
|
+
import { randomUUID } from "node:crypto";
|
|
3
4
|
import { LOCK_DIR, STALE_LOCK_MAX_AGE_MS } from "../types.js";
|
|
5
|
+
/**
|
|
6
|
+
* O-2: ошибки очистки больше не проглатываются молча. Прямой импорт
|
|
7
|
+
* `structured-log.ts` создал бы цикл (structured-log → secrets → lock), поэтому
|
|
8
|
+
* здесь используется `console.warn` — предупреждение всё равно видно в логе
|
|
9
|
+
* процесса и не ломает основной сценарий.
|
|
10
|
+
*/
|
|
11
|
+
function warnCleanupFailure(target, error) {
|
|
12
|
+
const reason = error instanceof Error ? error.message : String(error);
|
|
13
|
+
console.warn(`[agent-steward] Не удалось удалить lock-артефакт «${target}»: ${reason}`);
|
|
14
|
+
}
|
|
15
|
+
/**
|
|
16
|
+
* Проверяет, жив ли процесс-владелец lock-файла.
|
|
17
|
+
*
|
|
18
|
+
* `process.kill(pid, 0)` не посылает сигнал, а только проверяет существование.
|
|
19
|
+
* EPERM означает, что процесс есть, но у нас нет прав на сигнал — считаем живым.
|
|
20
|
+
* Остальные ошибки трактуем консервативно как «жив», чтобы не вытеснить
|
|
21
|
+
* чужую критическую секцию.
|
|
22
|
+
*/
|
|
23
|
+
export function isProcessAlive(pid) {
|
|
24
|
+
if (!Number.isInteger(pid) || pid <= 0)
|
|
25
|
+
return false;
|
|
26
|
+
try {
|
|
27
|
+
process.kill(pid, 0);
|
|
28
|
+
return true;
|
|
29
|
+
}
|
|
30
|
+
catch (err) {
|
|
31
|
+
if (err?.code === "ESRCH")
|
|
32
|
+
return false;
|
|
33
|
+
return true;
|
|
34
|
+
}
|
|
35
|
+
}
|
|
36
|
+
/** Достаёт ISO-время из первой части legacy PS-токена (`ISO|PID`). */
|
|
37
|
+
function parseIsoOrNull(value) {
|
|
38
|
+
const text = String(value ?? "").trim();
|
|
39
|
+
return /^\d{4}-\d{2}-\d{2}T/.test(text) ? text : null;
|
|
40
|
+
}
|
|
41
|
+
/**
|
|
42
|
+
* Разбирает содержимое lock-файла в едином для Node/PS/bash виде.
|
|
43
|
+
*
|
|
44
|
+
* Поддерживаемые форматы:
|
|
45
|
+
* `<pid>-<iso>` — единый формат (Node и PS, B6);
|
|
46
|
+
* `<pid>-<epoch>-<uuid>` — старый Node-токен;
|
|
47
|
+
* `<iso>|<pid>` — старый PS-токен (ISO|PID);
|
|
48
|
+
* `<pid>` — голый PID (pid-файл bash-обёртки).
|
|
49
|
+
*
|
|
50
|
+
* Порядок важен: legacy PS проверяется до `<pid>-…`, иначе год из ISO
|
|
51
|
+
* (`2026`) принимался за PID — именно это ломало межпроцессную совместимость.
|
|
52
|
+
*/
|
|
53
|
+
export function parseLockToken(content) {
|
|
54
|
+
const text = String(content ?? "").trim();
|
|
55
|
+
if (!text)
|
|
56
|
+
return { pid: null, createdAt: null, format: "unknown" };
|
|
57
|
+
const withPipe = text.indexOf("|");
|
|
58
|
+
if (withPipe !== -1) {
|
|
59
|
+
const pid = Number.parseInt(text.slice(withPipe + 1).trim(), 10);
|
|
60
|
+
return {
|
|
61
|
+
pid: Number.isInteger(pid) && pid > 0 ? pid : null,
|
|
62
|
+
createdAt: parseIsoOrNull(text.slice(0, withPipe)),
|
|
63
|
+
format: "ps-legacy",
|
|
64
|
+
};
|
|
65
|
+
}
|
|
66
|
+
const unified = /^(\d+)-(\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}(?:\.\d+)?Z)(?:-.*)?$/i.exec(text);
|
|
67
|
+
if (unified) {
|
|
68
|
+
const pid = Number.parseInt(unified[1], 10);
|
|
69
|
+
return {
|
|
70
|
+
pid: Number.isInteger(pid) && pid > 0 ? pid : null,
|
|
71
|
+
createdAt: unified[2],
|
|
72
|
+
format: "unified",
|
|
73
|
+
};
|
|
74
|
+
}
|
|
75
|
+
// Старый Node мог добавить любой суффикс после epoch (`-live-owner`, uuid).
|
|
76
|
+
const legacyNode = /^(\d+)-(\d{10,})(?:-.*)?$/i.exec(text);
|
|
77
|
+
if (legacyNode) {
|
|
78
|
+
const pid = Number.parseInt(legacyNode[1], 10);
|
|
79
|
+
return {
|
|
80
|
+
pid: Number.isInteger(pid) && pid > 0 ? pid : null,
|
|
81
|
+
createdAt: null,
|
|
82
|
+
format: "node-legacy",
|
|
83
|
+
};
|
|
84
|
+
}
|
|
85
|
+
if (/^\d+$/.test(text)) {
|
|
86
|
+
const pid = Number.parseInt(text, 10);
|
|
87
|
+
// Голое число — PID (pid-файл bash), но не epoch из старого тестового
|
|
88
|
+
// lock: 1.7e12 не может быть PID и раньше не распознавалось владельцем.
|
|
89
|
+
return {
|
|
90
|
+
pid: Number.isInteger(pid) && pid > 0 && pid <= 2147483647 ? pid : null,
|
|
91
|
+
createdAt: null,
|
|
92
|
+
format: "pid",
|
|
93
|
+
};
|
|
94
|
+
}
|
|
95
|
+
return { pid: null, createdAt: null, format: "unknown" };
|
|
96
|
+
}
|
|
97
|
+
/** PID владельца из токена lock-файла (любой поддерживаемый формат). */
|
|
98
|
+
export function ownerPidFromToken(content) {
|
|
99
|
+
return parseLockToken(content).pid;
|
|
100
|
+
}
|
|
101
|
+
/**
|
|
102
|
+
* PID владельца lock-артефакта.
|
|
103
|
+
*
|
|
104
|
+
* B7: файловый lock Node/PS хранит токен в самом файле, а POSIX-обёртка
|
|
105
|
+
* держит каталог `<lock>.d` и пишет `<pid>-<iso>` в `<lock>.d/pid`.
|
|
106
|
+
* Раньше каталог вытеснялся только по возрасту, без чтения этого файла,
|
|
107
|
+
* поэтому легально долгая задача (> 24 ч) после рестарта плагина
|
|
108
|
+
* дублировалась. Нет pid-файла/не разобрался — возвращаем null,
|
|
109
|
+
* и решение принимает возраст (fallback).
|
|
110
|
+
*/
|
|
111
|
+
export async function readLockOwnerPid(lockPath, isDir) {
|
|
112
|
+
const tokenPath = isDir ? path.join(lockPath, "pid") : lockPath;
|
|
113
|
+
const content = await fs.readFile(tokenPath, "utf8").catch(() => "");
|
|
114
|
+
return ownerPidFromToken(content);
|
|
115
|
+
}
|
|
4
116
|
/**
|
|
5
117
|
* Менеджер файловых блокировок для предотвращения наложения запусков одной задачи.
|
|
6
118
|
*
|
|
@@ -46,12 +158,22 @@ export class LockManager {
|
|
|
46
158
|
// Артефакт предыдущего вытеснения валидным lock быть не может,
|
|
47
159
|
// поэтому убираем его независимо от возраста.
|
|
48
160
|
if (isStaleArtifact) {
|
|
49
|
-
await fs.rm(fullPath, { recursive: true, force: true }).catch(() =>
|
|
161
|
+
await fs.rm(fullPath, { recursive: true, force: true }).catch((err) => warnCleanupFailure(fullPath, err));
|
|
50
162
|
continue;
|
|
51
163
|
}
|
|
52
164
|
const stat = await fs.stat(fullPath);
|
|
53
165
|
const age = now - stat.mtimeMs;
|
|
54
166
|
if (age > STALE_LOCK_MAX_AGE_MS) {
|
|
167
|
+
// P2-18/B7: возраст — только повод проверить владельца. Задача может
|
|
168
|
+
// легально работать дольше 24 ч (timeoutSeconds: 0), поэтому живой
|
|
169
|
+
// процесс не вытесняем: иначе после рестарта плагина появится дубль.
|
|
170
|
+
// B7: для каталога `.lock.d` владелец лежит в `<dir>/pid`, а не в
|
|
171
|
+
// самом файле; без этого проверка смотрела только на `.lock`.
|
|
172
|
+
const ownerPid = await readLockOwnerPid(fullPath, isLockDir);
|
|
173
|
+
if (ownerPid !== null && isProcessAlive(ownerPid)) {
|
|
174
|
+
console.log(`[agent-steward] Lock ${file} старше ${Math.round(age / 1000)} с, но процесс ${ownerPid} жив — оставляем.`);
|
|
175
|
+
continue;
|
|
176
|
+
}
|
|
55
177
|
// T-03: не удаляем lock напрямую. Два воркера могли одновременно
|
|
56
178
|
// снести один и тот же файл, после чего один из них удалял свежий
|
|
57
179
|
// lock, созданный другим, и задача запускалась повторно. Атомарный
|
|
@@ -64,7 +186,7 @@ export class LockManager {
|
|
|
64
186
|
catch {
|
|
65
187
|
continue;
|
|
66
188
|
}
|
|
67
|
-
await fs.rm(stalePath, { recursive: true, force: true }).catch(() =>
|
|
189
|
+
await fs.rm(stalePath, { recursive: true, force: true }).catch((err) => warnCleanupFailure(stalePath, err));
|
|
68
190
|
console.log(`[agent-steward] Вытеснен зависший lock: ${file} (возраст ${Math.round(age / 1000)} с)`);
|
|
69
191
|
}
|
|
70
192
|
}
|
|
@@ -75,37 +197,89 @@ export class LockManager {
|
|
|
75
197
|
}
|
|
76
198
|
/**
|
|
77
199
|
* Пытается захватить блокировку для задачи.
|
|
78
|
-
* Возвращает
|
|
79
|
-
*
|
|
200
|
+
* Возвращает уникальный токен владельца (он же содержимое lock-файла) или
|
|
201
|
+
* null, если блокировка уже удерживается другим запуском.
|
|
202
|
+
*
|
|
203
|
+
* Токен нужен release(): процесс, чей lock был вытеснен по stale-таймауту,
|
|
204
|
+
* не должен удалять файл нового владельца.
|
|
80
205
|
*/
|
|
81
206
|
async acquire(taskName) {
|
|
82
207
|
await fs.mkdir(this.lockDir, { recursive: true });
|
|
83
208
|
const lockPath = this.lockFilePath(taskName);
|
|
209
|
+
// B6: единый формат `<pid>-<iso>` (+ uuid для уникальности токена).
|
|
210
|
+
// PS-обёртка пишет тот же префикс, поэтому её stale-проверка видит PID,
|
|
211
|
+
// а не год из даты, и не вытесняет живой Node-лок.
|
|
212
|
+
const token = `${process.pid}-${new Date().toISOString()}-${randomUUID()}`;
|
|
84
213
|
try {
|
|
85
214
|
// 'wx' — exclusive create: ошибка если файл уже существует.
|
|
86
|
-
await fs.writeFile(lockPath,
|
|
87
|
-
return
|
|
215
|
+
await fs.writeFile(lockPath, token, { flag: "wx" });
|
|
216
|
+
return token;
|
|
88
217
|
}
|
|
89
218
|
catch (err) {
|
|
90
|
-
|
|
91
|
-
|
|
219
|
+
// P3-39: на Windows конкурентный create/delete того же lock-файла
|
|
220
|
+
// возвращает EPERM/EACCES/EBUSY вместо EEXIST. Это тот же случай
|
|
221
|
+
// «блокировка занята», а не ошибка прав: отдаём null, а withLockWait
|
|
222
|
+
// повторит попытку (withLock корректно пропустит запуск).
|
|
223
|
+
if (err.code === "EEXIST" ||
|
|
224
|
+
err.code === "EPERM" ||
|
|
225
|
+
err.code === "EACCES" ||
|
|
226
|
+
err.code === "EBUSY") {
|
|
227
|
+
return null;
|
|
92
228
|
}
|
|
93
229
|
throw err;
|
|
94
230
|
}
|
|
95
231
|
}
|
|
232
|
+
/**
|
|
233
|
+
* Удаляет lock-файл, переживая кратковременные Windows-блокировки.
|
|
234
|
+
*
|
|
235
|
+
* На Windows unlink может вернуть EPERM/EACCES/EBUSY, пока другой процесс
|
|
236
|
+
* читает файл (проверка владельца в withLockWait) или файл ещё «висящий»
|
|
237
|
+
* после создания. Несколько коротких повторов решают гонку; ENOENT — уже
|
|
238
|
+
* удалён, это не ошибка.
|
|
239
|
+
*/
|
|
240
|
+
async unlinkWithRetry(lockPath, attempts = 6) {
|
|
241
|
+
for (let i = 0; i < attempts; i += 1) {
|
|
242
|
+
try {
|
|
243
|
+
await fs.unlink(lockPath);
|
|
244
|
+
return true;
|
|
245
|
+
}
|
|
246
|
+
catch (err) {
|
|
247
|
+
if (err.code === "ENOENT")
|
|
248
|
+
return false;
|
|
249
|
+
const transient = err.code === "EPERM" || err.code === "EACCES" || err.code === "EBUSY";
|
|
250
|
+
if (transient && i < attempts - 1) {
|
|
251
|
+
await new Promise((resolve) => setTimeout(resolve, 10 * (i + 1)));
|
|
252
|
+
continue;
|
|
253
|
+
}
|
|
254
|
+
throw err;
|
|
255
|
+
}
|
|
256
|
+
}
|
|
257
|
+
return false;
|
|
258
|
+
}
|
|
96
259
|
/**
|
|
97
260
|
* Освобождает блокировку задачи (удаляет lock-файл).
|
|
261
|
+
*
|
|
262
|
+
* Удаляет файл только если в нём лежит токен этого владельца. Если lock
|
|
263
|
+
* успели вытеснить и перехватить, release ничего не трогает и возвращает
|
|
264
|
+
* false — иначе старый процесс снёс бы чужую критическую секцию.
|
|
98
265
|
* Не выбрасывает ошибку, если файл уже удалён.
|
|
99
266
|
*/
|
|
100
|
-
async release(taskName) {
|
|
267
|
+
async release(taskName, token) {
|
|
101
268
|
const lockPath = this.lockFilePath(taskName);
|
|
269
|
+
let current;
|
|
102
270
|
try {
|
|
103
|
-
await fs.
|
|
271
|
+
current = await fs.readFile(lockPath, "utf8");
|
|
104
272
|
}
|
|
105
273
|
catch (err) {
|
|
106
|
-
if (err.code
|
|
107
|
-
|
|
274
|
+
if (err.code === "ENOENT")
|
|
275
|
+
return false;
|
|
276
|
+
throw err;
|
|
108
277
|
}
|
|
278
|
+
if (current !== token)
|
|
279
|
+
return false;
|
|
280
|
+
// P3-39: на Windows unlink может кратковременно упасть EPERM, пока
|
|
281
|
+
// другие процессы читают lock для проверки владельца.
|
|
282
|
+
return this.unlinkWithRetry(lockPath);
|
|
109
283
|
}
|
|
110
284
|
/**
|
|
111
285
|
* Проверяет, удерживается ли блокировка задачей в данный момент.
|
|
@@ -129,8 +303,8 @@ export class LockManager {
|
|
|
129
303
|
* Гарантирует освобождение блокировки в finally (включая при ошибках).
|
|
130
304
|
*/
|
|
131
305
|
export async function withLock(lockManager, taskName, fn) {
|
|
132
|
-
const
|
|
133
|
-
if (!
|
|
306
|
+
const token = await lockManager.acquire(taskName);
|
|
307
|
+
if (!token) {
|
|
134
308
|
console.log(`[agent-steward] Запуск задачи "${taskName}" пропущен: удерживается активная блокировка.`);
|
|
135
309
|
return null;
|
|
136
310
|
}
|
|
@@ -138,7 +312,7 @@ export async function withLock(lockManager, taskName, fn) {
|
|
|
138
312
|
return await fn();
|
|
139
313
|
}
|
|
140
314
|
finally {
|
|
141
|
-
await lockManager.release(taskName);
|
|
315
|
+
await lockManager.release(taskName, token);
|
|
142
316
|
}
|
|
143
317
|
}
|
|
144
318
|
/**
|
|
@@ -154,25 +328,37 @@ export async function withLockWait(lockManager, taskName, fn, options = {}) {
|
|
|
154
328
|
const staleMs = options.staleMs ?? 60000;
|
|
155
329
|
const deadline = Date.now() + timeoutMs;
|
|
156
330
|
const lockPath = lockManager.pathFor(taskName);
|
|
331
|
+
let token = null;
|
|
157
332
|
for (;;) {
|
|
158
|
-
|
|
333
|
+
token = await lockManager.acquire(taskName);
|
|
334
|
+
if (token)
|
|
159
335
|
break;
|
|
160
336
|
// Осиротевший lock: короткая операция не может длиться дольше staleMs.
|
|
161
337
|
if (staleMs > 0) {
|
|
162
338
|
try {
|
|
163
339
|
const stat = await fs.stat(lockPath);
|
|
164
340
|
if (Date.now() - stat.mtimeMs > staleMs) {
|
|
165
|
-
//
|
|
166
|
-
//
|
|
167
|
-
|
|
168
|
-
|
|
169
|
-
|
|
170
|
-
|
|
341
|
+
// P2-18: staleMs — не приговор. Если владелец ещё жив, его
|
|
342
|
+
// критическая секция может быть легально долгой (crontab RMW,
|
|
343
|
+
// длинная задача). Вытесняем только мёртвый/неизвестный lock.
|
|
344
|
+
const content = await fs.readFile(lockPath, "utf8").catch(() => "");
|
|
345
|
+
const ownerPid = ownerPidFromToken(content);
|
|
346
|
+
if (ownerPid !== null && isProcessAlive(ownerPid)) {
|
|
347
|
+
// Ждём дальше; по deadline вернём понятную ошибку.
|
|
171
348
|
}
|
|
172
|
-
|
|
173
|
-
//
|
|
349
|
+
else {
|
|
350
|
+
// T-03-совместимое вытеснение: атомарный rename выигрывает ровно
|
|
351
|
+
// один процесс, остальные получают ENOENT и повторяют попытку.
|
|
352
|
+
const stalePath = `${lockPath}.stale-${process.pid}-${Date.now()}`;
|
|
353
|
+
try {
|
|
354
|
+
await fs.rename(lockPath, stalePath);
|
|
355
|
+
await fs.rm(stalePath, { force: true }).catch((err) => warnCleanupFailure(stalePath, err));
|
|
356
|
+
}
|
|
357
|
+
catch {
|
|
358
|
+
// Кто-то успел раньше — просто повторяем acquire.
|
|
359
|
+
}
|
|
360
|
+
continue;
|
|
174
361
|
}
|
|
175
|
-
continue;
|
|
176
362
|
}
|
|
177
363
|
}
|
|
178
364
|
catch {
|
|
@@ -188,6 +374,7 @@ export async function withLockWait(lockManager, taskName, fn, options = {}) {
|
|
|
188
374
|
return await fn();
|
|
189
375
|
}
|
|
190
376
|
finally {
|
|
191
|
-
|
|
377
|
+
if (token)
|
|
378
|
+
await lockManager.release(taskName, token);
|
|
192
379
|
}
|
|
193
380
|
}
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"matrix.d.ts","sourceRoot":"","sources":["../../src/core/matrix.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;
|
|
1
|
+
{"version":3,"file":"matrix.d.ts","sourceRoot":"","sources":["../../src/core/matrix.ts"],"names":[],"mappings":"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"}
|
package/dist/core/matrix.js
CHANGED
|
@@ -15,7 +15,25 @@ import { getHistory, recordRun } from "../db/history-repo.js";
|
|
|
15
15
|
import { notifyMatrixCompletion } from "../notifications.js";
|
|
16
16
|
import { getWorkspace } from "../workspaces.js";
|
|
17
17
|
import { createSchedulerBackend } from "./scheduler/index.js";
|
|
18
|
+
import { appendStructuredLog } from "./structured-log.js";
|
|
18
19
|
import { t } from "../i18n.js";
|
|
20
|
+
/**
|
|
21
|
+
* Матричные события идут в machine-readable runs.jsonl: человекочитаемый
|
|
22
|
+
* вывод планировщика не позволяет связать клон с родителем и запуском.
|
|
23
|
+
*/
|
|
24
|
+
function logMatrixEvent(parentName, step, details = {}) {
|
|
25
|
+
appendStructuredLog({
|
|
26
|
+
event: `matrix.${step}`,
|
|
27
|
+
task: parentName,
|
|
28
|
+
matrixId: parentName,
|
|
29
|
+
cloneName: details.cloneName,
|
|
30
|
+
step,
|
|
31
|
+
status: details.status,
|
|
32
|
+
reason: details.reason,
|
|
33
|
+
error: details.error,
|
|
34
|
+
runId: details.runId,
|
|
35
|
+
});
|
|
36
|
+
}
|
|
19
37
|
/** Суффикс агрегирующей задачи, запускаемой после всех клонов. */
|
|
20
38
|
export const MATRIX_COMPLETE_SUFFIX = "-matrix-complete";
|
|
21
39
|
/** Имя клона: <родитель>-matrix-<workspace>. */
|
|
@@ -249,6 +267,7 @@ export async function runMatrix(task) {
|
|
|
249
267
|
catch (err) {
|
|
250
268
|
const message = err instanceof Error ? err.message : String(err);
|
|
251
269
|
errors.push(`${clone.name}: ${message}`);
|
|
270
|
+
logMatrixEvent(task.name, "start_failed", { cloneName: clone.name, error: message });
|
|
252
271
|
if (failureMode === "stop") {
|
|
253
272
|
const rest = clones
|
|
254
273
|
.slice(clones.indexOf(clone) + 1)
|
|
@@ -264,11 +283,16 @@ export async function runMatrix(task) {
|
|
|
264
283
|
saveTask({ ...task, matrixQueue: queueToSave.length > 0 ? queueToSave : undefined });
|
|
265
284
|
}
|
|
266
285
|
catch (err) {
|
|
267
|
-
|
|
286
|
+
logMatrixEvent(task.name, "queue_save_failed", {
|
|
287
|
+
error: err instanceof Error ? err.message : String(err),
|
|
288
|
+
});
|
|
268
289
|
}
|
|
269
|
-
|
|
270
|
-
|
|
271
|
-
`
|
|
290
|
+
logMatrixEvent(task.name, "started", {
|
|
291
|
+
status: started.length > 0 ? "running" : "error",
|
|
292
|
+
reason: `strategy=${strategy}, failureMode=${failureMode}, ` +
|
|
293
|
+
`concurrency=${concurrency}, started=${started.length}, skipped=${skipped.length}, ` +
|
|
294
|
+
`queued=${queueToSave.length}, errors=${errors.length}`,
|
|
295
|
+
});
|
|
272
296
|
return {
|
|
273
297
|
success: errors.length === 0 || failureMode === "continue",
|
|
274
298
|
parent: task.name,
|
|
@@ -309,7 +333,10 @@ export async function advanceSequentialMatrix(cloneName) {
|
|
|
309
333
|
if ((parent.matrix.failureMode ?? "continue") === "stop") {
|
|
310
334
|
const latest = latestCloneStatus(cloneName);
|
|
311
335
|
if (latest.status === "error") {
|
|
312
|
-
|
|
336
|
+
logMatrixEvent(parent.name, "sequential_stopped", {
|
|
337
|
+
cloneName,
|
|
338
|
+
status: "error",
|
|
339
|
+
});
|
|
313
340
|
return undefined;
|
|
314
341
|
}
|
|
315
342
|
}
|
|
@@ -320,12 +347,16 @@ export async function advanceSequentialMatrix(cloneName) {
|
|
|
320
347
|
const result = await createSchedulerBackend().runTask(next.name);
|
|
321
348
|
if (result.alreadyRunning)
|
|
322
349
|
return undefined;
|
|
323
|
-
|
|
350
|
+
logMatrixEvent(parent.name, "advanced", {
|
|
351
|
+
cloneName: next.name,
|
|
352
|
+
status: "running",
|
|
353
|
+
reason: "sequential",
|
|
354
|
+
});
|
|
324
355
|
return next.name;
|
|
325
356
|
}
|
|
326
357
|
catch (err) {
|
|
327
358
|
const message = err instanceof Error ? err.message : String(err);
|
|
328
|
-
|
|
359
|
+
logMatrixEvent(parent.name, "start_failed", { cloneName: next.name, error: message });
|
|
329
360
|
return undefined;
|
|
330
361
|
}
|
|
331
362
|
}
|
|
@@ -369,11 +400,17 @@ export async function advanceMatrixAfterClone(cloneName) {
|
|
|
369
400
|
slots -= 1;
|
|
370
401
|
if (result.alreadyRunning)
|
|
371
402
|
slots += 0; // слот уже занят этим клоном
|
|
372
|
-
|
|
403
|
+
logMatrixEvent(parent.name, "queue_started", {
|
|
404
|
+
cloneName: nextName,
|
|
405
|
+
status: "running",
|
|
406
|
+
});
|
|
373
407
|
}
|
|
374
408
|
catch (err) {
|
|
375
409
|
const message = err instanceof Error ? err.message : String(err);
|
|
376
|
-
|
|
410
|
+
logMatrixEvent(parent.name, "queue_start_failed", {
|
|
411
|
+
cloneName: nextName,
|
|
412
|
+
error: message,
|
|
413
|
+
});
|
|
377
414
|
// Попытка запуска «съедает» слот: иначе при недоступном бэкенде
|
|
378
415
|
// цикл уйдёт по всей очереди, проигнорировав лимит.
|
|
379
416
|
slots -= 1;
|
|
@@ -387,7 +424,9 @@ export async function advanceMatrixAfterClone(cloneName) {
|
|
|
387
424
|
saveTask({ ...parent, matrixQueue: queue.length > 0 ? queue : undefined });
|
|
388
425
|
}
|
|
389
426
|
catch (err) {
|
|
390
|
-
|
|
427
|
+
logMatrixEvent(parent.name, "queue_save_failed", {
|
|
428
|
+
error: err instanceof Error ? err.message : String(err),
|
|
429
|
+
});
|
|
391
430
|
}
|
|
392
431
|
return started;
|
|
393
432
|
}
|
|
@@ -617,7 +656,9 @@ export async function cancelPendingMatrixClones(parentName, reason = t("matrix.c
|
|
|
617
656
|
saveTask({ ...parent, matrixQueue: undefined });
|
|
618
657
|
}
|
|
619
658
|
catch (err) {
|
|
620
|
-
|
|
659
|
+
logMatrixEvent(parent.name, "queue_clear_failed", {
|
|
660
|
+
error: err instanceof Error ? err.message : String(err),
|
|
661
|
+
});
|
|
621
662
|
}
|
|
622
663
|
}
|
|
623
664
|
for (const clone of clones) {
|
|
@@ -637,7 +678,11 @@ export async function cancelPendingMatrixClones(parentName, reason = t("matrix.c
|
|
|
637
678
|
cancelled.push(clone.name);
|
|
638
679
|
}
|
|
639
680
|
catch (err) {
|
|
640
|
-
|
|
681
|
+
logMatrixEvent(parent.name, "cancelled", {
|
|
682
|
+
cloneName: clone.name,
|
|
683
|
+
status: "error",
|
|
684
|
+
error: err instanceof Error ? err.message : String(err),
|
|
685
|
+
});
|
|
641
686
|
}
|
|
642
687
|
}
|
|
643
688
|
if (cancelled.length > 0 && clones.length > 0) {
|
|
@@ -704,19 +749,34 @@ export async function finalizeMatrixIfComplete(cloneName) {
|
|
|
704
749
|
error: aggregate.errorCount,
|
|
705
750
|
message: aggregate.message,
|
|
706
751
|
});
|
|
752
|
+
const aggregateRunId = getHistory(parent.name, 1)[0]?.id;
|
|
753
|
+
logMatrixEvent(parent.name, "aggregated", {
|
|
754
|
+
status: finalStatus,
|
|
755
|
+
runId: aggregateRunId,
|
|
756
|
+
reason: `total=${aggregate.totalCount}, success=${aggregate.successCount}, ` +
|
|
757
|
+
`error=${aggregate.errorCount}`,
|
|
758
|
+
});
|
|
707
759
|
}
|
|
708
760
|
catch (err) {
|
|
709
|
-
|
|
761
|
+
logMatrixEvent(parent.name, "aggregate_failed", {
|
|
762
|
+
error: err instanceof Error ? err.message : String(err),
|
|
763
|
+
});
|
|
710
764
|
}
|
|
711
765
|
if (parent.matrix.createAggregator) {
|
|
712
766
|
const aggregator = getTask(matrixCompleteName(parent.name));
|
|
713
767
|
if (aggregator) {
|
|
714
768
|
try {
|
|
715
769
|
await createSchedulerBackend().runTask(aggregator.name);
|
|
716
|
-
|
|
770
|
+
logMatrixEvent(parent.name, "aggregator_started", {
|
|
771
|
+
cloneName: aggregator.name,
|
|
772
|
+
status: "running",
|
|
773
|
+
});
|
|
717
774
|
}
|
|
718
775
|
catch (err) {
|
|
719
|
-
|
|
776
|
+
logMatrixEvent(parent.name, "aggregator_start_failed", {
|
|
777
|
+
cloneName: aggregator.name,
|
|
778
|
+
error: err instanceof Error ? err.message : String(err),
|
|
779
|
+
});
|
|
720
780
|
}
|
|
721
781
|
}
|
|
722
782
|
}
|
|
@@ -0,0 +1,83 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* AB-8: ad-hoc миссия (`run_mission`) — полоса B execution model.
|
|
3
|
+
*
|
|
4
|
+
* Миссия проходит тот же путь, что и зарегистрированная задача:
|
|
5
|
+
* `createRun → план → маршрут → исполнение → GATE → ledger`. Отличие только
|
|
6
|
+
* в источнике входа: задача не создаётся и не регистрируется в планировщике
|
|
7
|
+
* ОС. Исполнение идёт через обёртку (lock, таймаут, политика прав, Quality
|
|
8
|
+
* Gate, запись истории), но без `schtasks`/`crontab`/`launchd`.
|
|
9
|
+
*/
|
|
10
|
+
import { type ExecutionPlan, type ExecutionResult, type RunContext, type RunPermissionPolicy, type StepExecutor } from "./execution.js";
|
|
11
|
+
import { type SessionMode } from "./session.js";
|
|
12
|
+
/** AB-8.1: спецификация ad-hoc миссии (цель + safety-контракт). */
|
|
13
|
+
export interface MissionSpec {
|
|
14
|
+
/** Цель миссии — тот же промпт, что получил бы OpenCode. */
|
|
15
|
+
prompt: string;
|
|
16
|
+
/** Рабочая директория; по умолчанию — cwd процесса. */
|
|
17
|
+
cwd?: string;
|
|
18
|
+
/** Имя запуска в ledger; по умолчанию генерируется `ad-hoc-*`. */
|
|
19
|
+
taskName?: string;
|
|
20
|
+
/** Тип задачи для маршрутизатора; по умолчанию `mission` (local/direct). */
|
|
21
|
+
taskType?: string;
|
|
22
|
+
/** Модель OpenCode (пусто — модель по умолчанию). */
|
|
23
|
+
model?: string;
|
|
24
|
+
/** Режим сессии OpenCode. */
|
|
25
|
+
session?: SessionMode;
|
|
26
|
+
/** Идентификатор сессии для `session=reuse`. */
|
|
27
|
+
sessionId?: string;
|
|
28
|
+
/** Таймаут исполнения в секундах (по умолчанию 3600). */
|
|
29
|
+
timeoutSeconds?: number;
|
|
30
|
+
/** Quality Gate: команда, ненулевой код которой проваливает миссию. */
|
|
31
|
+
gate?: string;
|
|
32
|
+
/** Таймаут Quality Gate в секундах (по умолчанию 300). */
|
|
33
|
+
gateTimeoutSeconds?: number;
|
|
34
|
+
/** Политика прав: hybrid (по умолчанию), secure, legacy. */
|
|
35
|
+
policy?: RunPermissionPolicy;
|
|
36
|
+
/** Allowlist инструментов; непустой список блокирует остальные. */
|
|
37
|
+
allowedTools?: string[];
|
|
38
|
+
/** Denylist инструментов; выигрывает у allowlist. */
|
|
39
|
+
deniedTools?: string[];
|
|
40
|
+
/** Только построить план и показать трассировку, не исполняя. */
|
|
41
|
+
dryRun?: boolean;
|
|
42
|
+
}
|
|
43
|
+
/** Результат ad-hoc миссии. */
|
|
44
|
+
export interface MissionResult {
|
|
45
|
+
success: boolean;
|
|
46
|
+
dryRun: boolean;
|
|
47
|
+
runId: string | null;
|
|
48
|
+
status: ExecutionResult["status"] | "planned";
|
|
49
|
+
plan: ExecutionPlan;
|
|
50
|
+
description: string;
|
|
51
|
+
steps: ExecutionResult["steps"];
|
|
52
|
+
error: string | null;
|
|
53
|
+
logFile: string | null;
|
|
54
|
+
}
|
|
55
|
+
/** Зависимости для тестов: позволяют подменить исполнение без OpenCode. */
|
|
56
|
+
export interface MissionDependencies {
|
|
57
|
+
executor?: StepExecutor;
|
|
58
|
+
/** Хук после подготовки: тест может проверить отсутствие задач в ОС. */
|
|
59
|
+
onPrepared?: (info: {
|
|
60
|
+
taskName: string;
|
|
61
|
+
cwd: string;
|
|
62
|
+
}) => void;
|
|
63
|
+
}
|
|
64
|
+
/**
|
|
65
|
+
* AB-8.1: валидирует и нормализует вход. Возвращает безопасную копию спеки,
|
|
66
|
+
* чтобы CLI/RPC/GUI не могли передать нестроковые поля в обёртку.
|
|
67
|
+
*/
|
|
68
|
+
export declare function normalizeMissionSpec(input: MissionSpec): MissionSpec;
|
|
69
|
+
/** Создаёт RunContext ad-hoc миссии (без task definition). */
|
|
70
|
+
export declare function createMissionContext(spec: MissionSpec): RunContext;
|
|
71
|
+
/**
|
|
72
|
+
* AB-8: единая точка входа ad-hoc миссии для CLI, RPC и GUI.
|
|
73
|
+
*
|
|
74
|
+
* Инварианты EXECUTION-LOOP §2.1: нет записи в планировщике ОС, работают
|
|
75
|
+
* GATE, политика прав, ledger (`runs`/`run_steps`) и аудит; параллельные
|
|
76
|
+
* обычные миссии в одном workspace не допускаются.
|
|
77
|
+
*
|
|
78
|
+
* W-3 (контракт dryRun): `dryRun: true` строит план и описание, но не захватывает
|
|
79
|
+
* `activeWorkspaces` и не пишет ledger (`runs`/`run_steps`) — это контракт, а не
|
|
80
|
+
* утечка контекста. Поэтому несколько dry-run в одном `cwd` проходят параллельно.
|
|
81
|
+
*/
|
|
82
|
+
export declare function runMission(input: MissionSpec, dependencies?: MissionDependencies): Promise<MissionResult>;
|
|
83
|
+
//# sourceMappingURL=mission.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"mission.d.ts","sourceRoot":"","sources":["../../src/core/mission.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAQH,OAAO,EAKL,KAAK,aAAa,EAClB,KAAK,eAAe,EACpB,KAAK,UAAU,EACf,KAAK,mBAAmB,EACxB,KAAK,YAAY,EAClB,MAAM,gBAAgB,CAAC;AAQxB,OAAO,EAKL,KAAK,WAAW,EACjB,MAAM,cAAc,CAAC;AAGtB,mEAAmE;AACnE,MAAM,WAAW,WAAW;IAC1B,4DAA4D;IAC5D,MAAM,EAAE,MAAM,CAAC;IACf,uDAAuD;IACvD,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,kEAAkE;IAClE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,4EAA4E;IAC5E,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,qDAAqD;IACrD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,6BAA6B;IAC7B,OAAO,CAAC,EAAE,WAAW,CAAC;IACtB,gDAAgD;IAChD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,yDAAyD;IACzD,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,uEAAuE;IACvE,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,0DAA0D;IAC1D,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,4DAA4D;IAC5D,MAAM,CAAC,EAAE,mBAAmB,CAAC;IAC7B,mEAAmE;IACnE,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,qDAAqD;IACrD,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB,iEAAiE;IACjE,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,+BAA+B;AAC/B,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,OAAO,CAAC;IAChB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,MAAM,EAAE,eAAe,CAAC,QAAQ,CAAC,GAAG,SAAS,CAAC;IAC9C,IAAI,EAAE,aAAa,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,eAAe,CAAC,OAAO,CAAC,CAAC;IAChC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;CACxB;AAED,2EAA2E;AAC3E,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,EAAE,YAAY,CAAC;IACxB,wEAAwE;IACxE,UAAU,CAAC,EAAE,CAAC,IAAI,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,KAAK,IAAI,CAAC;CAChE;AAoDD;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,WAAW,GAAG,WAAW,CAmDpE;AAED,8DAA8D;AAC9D,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,WAAW,GAAG,UAAU,CAsBlE;AAmLD;;;;;;;;;;GAUG;AACH,wBAAsB,UAAU,CAC9B,KAAK,EAAE,WAAW,EAClB,YAAY,GAAE,mBAAwB,GACrC,OAAO,CAAC,aAAa,CAAC,CAkExB"}
|