agent-steward 0.0.4 → 0.0.6
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 +309 -2
- package/CROSS_PLATFORM.md +19 -0
- package/README.md +55 -8
- package/ROADMAP-STRATEGY.md +22 -19
- package/ROADMAP.md +230 -159
- package/dist/cli.d.ts +3 -0
- package/dist/cli.d.ts.map +1 -0
- package/dist/cli.js +356 -0
- package/dist/core/analytics.d.ts +6 -0
- package/dist/core/analytics.d.ts.map +1 -1
- package/dist/core/analytics.js +20 -3
- package/dist/core/audit.d.ts +6 -0
- package/dist/core/audit.d.ts.map +1 -1
- package/dist/core/audit.js +24 -0
- package/dist/core/budget.d.ts +118 -0
- package/dist/core/budget.d.ts.map +1 -0
- package/dist/core/budget.js +206 -0
- package/dist/core/cron-to-schtasks.d.ts.map +1 -1
- package/dist/core/cron-to-schtasks.js +38 -0
- package/dist/core/dry-run.d.ts +26 -1
- package/dist/core/dry-run.d.ts.map +1 -1
- package/dist/core/dry-run.js +199 -8
- 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/feedback.d.ts +192 -0
- package/dist/core/feedback.d.ts.map +1 -0
- package/dist/core/feedback.js +426 -0
- package/dist/core/gate-integrity.d.ts +71 -0
- package/dist/core/gate-integrity.d.ts.map +1 -0
- package/dist/core/gate-integrity.js +275 -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/local-ai.d.ts.map +1 -1
- package/dist/core/local-ai.js +7 -3
- package/dist/core/lock.d.ts +41 -0
- package/dist/core/lock.d.ts.map +1 -1
- package/dist/core/lock.js +141 -29
- package/dist/core/matrix.d.ts +8 -0
- package/dist/core/matrix.d.ts.map +1 -1
- package/dist/core/matrix.js +132 -17
- package/dist/core/mission.d.ts +103 -0
- package/dist/core/mission.d.ts.map +1 -0
- package/dist/core/mission.js +374 -0
- package/dist/core/opencode-models.d.ts +2 -2
- package/dist/core/opencode-models.d.ts.map +1 -1
- package/dist/core/opencode-models.js +28 -21
- package/dist/core/opencode-usage.d.ts +35 -0
- package/dist/core/opencode-usage.d.ts.map +1 -0
- package/dist/core/opencode-usage.js +132 -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 +78 -0
- package/dist/core/pipeline-map.d.ts +52 -0
- package/dist/core/pipeline-map.d.ts.map +1 -0
- package/dist/core/pipeline-map.js +208 -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 +27 -2
- package/dist/core/ps-wrapper.d.ts.map +1 -1
- package/dist/core/ps-wrapper.js +424 -65
- package/dist/core/record-history.d.ts.map +1 -1
- package/dist/core/record-history.js +206 -33
- package/dist/core/router/rules.d.ts.map +1 -1
- package/dist/core/router/rules.js +6 -0
- package/dist/core/run-mode.d.ts +12 -0
- package/dist/core/run-mode.d.ts.map +1 -0
- package/dist/core/run-mode.js +17 -0
- package/dist/core/scheduler/linux.d.ts +8 -1
- package/dist/core/scheduler/linux.d.ts.map +1 -1
- package/dist/core/scheduler/linux.js +34 -9
- package/dist/core/scheduler/logs.d.ts +4 -0
- package/dist/core/scheduler/logs.d.ts.map +1 -1
- package/dist/core/scheduler/logs.js +25 -1
- 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/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 +18 -8
- package/dist/core/self-analysis.d.ts +32 -2
- package/dist/core/self-analysis.d.ts.map +1 -1
- package/dist/core/self-analysis.js +38 -27
- package/dist/core/shutdown.d.ts +33 -2
- package/dist/core/shutdown.d.ts.map +1 -1
- package/dist/core/shutdown.js +58 -2
- package/dist/core/structured-log.d.ts +37 -1
- package/dist/core/structured-log.d.ts.map +1 -1
- package/dist/core/structured-log.js +37 -0
- package/dist/core/usage-surface.d.ts +25 -0
- package/dist/core/usage-surface.d.ts.map +1 -0
- package/dist/core/usage-surface.js +41 -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 +19 -0
- package/dist/core/wrappers/bash.d.ts.map +1 -1
- package/dist/core/wrappers/bash.js +230 -27
- package/dist/db/capability-repo.d.ts +43 -2
- package/dist/db/capability-repo.d.ts.map +1 -1
- package/dist/db/capability-repo.js +96 -11
- package/dist/db/history-repo.d.ts +70 -5
- package/dist/db/history-repo.d.ts.map +1 -1
- package/dist/db/history-repo.js +170 -29
- package/dist/db/metrics-repo.d.ts +20 -2
- package/dist/db/metrics-repo.d.ts.map +1 -1
- package/dist/db/metrics-repo.js +35 -13
- package/dist/db/migrate.d.ts.map +1 -1
- package/dist/db/migrate.js +37 -17
- package/dist/db/recovery.d.ts +3 -1
- package/dist/db/recovery.d.ts.map +1 -1
- package/dist/db/recovery.js +11 -5
- 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 +5 -0
- package/dist/db/run-resume.d.ts.map +1 -1
- package/dist/db/run-resume.js +9 -2
- package/dist/db/runs-repo.d.ts +19 -2
- package/dist/db/runs-repo.d.ts.map +1 -1
- package/dist/db/runs-repo.js +91 -60
- package/dist/db/schema.d.ts +2 -2
- package/dist/db/schema.d.ts.map +1 -1
- package/dist/db/schema.js +132 -2
- package/dist/db/templates-repo.d.ts +2 -2
- package/dist/db/templates-repo.d.ts.map +1 -1
- package/dist/db/templates-repo.js +5 -3
- package/dist/history.d.ts +7 -2
- package/dist/history.d.ts.map +1 -1
- package/dist/history.js +4 -2
- package/dist/hook-output.d.ts +2 -0
- package/dist/hook-output.d.ts.map +1 -0
- package/dist/hook-output.js +31 -0
- 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 +375 -47
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +1344 -192
- package/dist/notifications.d.ts +53 -2
- package/dist/notifications.d.ts.map +1 -1
- package/dist/notifications.js +168 -21
- package/dist/profiles.d.ts.map +1 -1
- package/dist/profiles.js +82 -10
- package/dist/rpc.d.ts +354 -0
- package/dist/rpc.d.ts.map +1 -1
- package/dist/rpc.js +145 -0
- package/dist/server.d.ts +32 -2
- package/dist/server.d.ts.map +1 -1
- package/dist/server.js +154 -30
- package/dist/settings.d.ts +44 -2
- package/dist/settings.d.ts.map +1 -1
- package/dist/settings.js +85 -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 +21 -0
- package/dist/task-transfer.d.ts.map +1 -1
- package/dist/task-transfer.js +64 -3
- package/dist/templates.d.ts +2 -2
- package/dist/templates.d.ts.map +1 -1
- package/dist/templates.js +3 -3
- package/dist/types.d.ts +22 -2
- package/dist/types.d.ts.map +1 -1
- package/dist/workspaces.d.ts.map +1 -1
- package/dist/workspaces.js +34 -11
- package/docs/ARCHITECTURE.md +319 -66
- package/docs/COMPATIBILITY.md +2 -2
- package/docs/CONCEPT.md +18 -4
- package/docs/CROSS_PLATFORM.ru.md +20 -0
- package/docs/CROSS_PLATFORM.zh.md +18 -0
- package/docs/EXECUTION-LOOP.md +28 -10
- package/docs/FEATURES.md +129 -7
- package/docs/FEATURES.zh.md +97 -6
- package/docs/MIGRATION.md +2 -2
- package/docs/PIPELINE.md +293 -0
- package/docs/QA-A2-GUI-TUI.md +205 -0
- package/docs/README.ru.md +43 -4
- package/docs/README.zh.md +44 -4
- package/docs/SAFETY.md +23 -3
- package/gui-experimental.cjs +9 -8
- package/locales/en.json +58 -3
- package/locales/ru.json +58 -3
- package/locales/zh.json +58 -3
- package/opencode.pipeline.yaml +35 -0
- package/package.json +36 -4
- package/scripts/check-eslint-baseline.mjs +139 -0
- package/scripts/gen-test-plan-counters.mjs +117 -0
- package/scripts/github-ci-fetch.ps1 +37 -0
- package/scripts/pl-commit.ps1 +112 -0
- package/scripts/qa-a2-commit.ps1 +104 -0
- package/scripts/test-home.mjs +107 -0
- package/skills/scheduled-job-best-practices/SKILL.md +95 -1
- package/skills/scheduled-job-best-practices/references/recipes.md +139 -0
- package/src/cli.ts +417 -0
- package/src/core/analytics.ts +27 -4
- package/src/core/audit.ts +25 -0
- package/src/core/budget.ts +340 -0
- package/src/core/cron-to-schtasks.ts +42 -0
- package/src/core/dry-run.ts +235 -12
- package/src/core/execution.ts +538 -0
- package/src/core/feedback.ts +582 -0
- package/src/core/file-watcher.ts +2 -2
- package/src/core/gate-integrity.ts +330 -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/local-ai.ts +7 -3
- package/src/core/lock.ts +178 -37
- package/src/core/matrix.ts +158 -52
- package/src/core/mission.ts +531 -0
- package/src/core/native-notify.ts +1 -1
- package/src/core/opencode-models.ts +30 -21
- package/src/core/opencode-usage.ts +182 -0
- package/src/core/pipeline-apply.ts +158 -0
- package/src/core/pipeline-io.ts +96 -0
- package/src/core/pipeline-map.ts +283 -0
- package/src/core/pipeline-spec.ts +775 -0
- package/src/core/ps-wrapper.ts +435 -66
- package/src/core/record-history.ts +258 -81
- package/src/core/router/rules.ts +6 -0
- package/src/core/run-mode.ts +19 -0
- package/src/core/schedule-gate.ts +1 -1
- package/src/core/scheduler/at-fallback.ts +1 -1
- package/src/core/scheduler/linux.ts +40 -11
- package/src/core/scheduler/logs.ts +34 -3
- package/src/core/scheduler/mac.ts +174 -14
- package/src/core/scheduler/registry.ts +2 -2
- package/src/core/scheduler/windows.ts +19 -15
- package/src/core/secrets.ts +26 -19
- package/src/core/self-analysis.ts +75 -29
- package/src/core/shutdown.ts +90 -4
- package/src/core/structured-log.ts +89 -5
- 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/usage-surface.ts +70 -0
- package/src/core/worktree-run.ts +199 -0
- package/src/core/worktree.ts +600 -0
- package/src/core/wrappers/bash.ts +248 -26
- package/src/db/capability-repo.ts +127 -10
- package/src/db/history-repo.ts +281 -40
- package/src/db/metrics-repo.ts +40 -13
- package/src/db/migrate.ts +57 -32
- package/src/db/recovery.ts +12 -5
- package/src/db/run-journal.ts +100 -13
- package/src/db/run-resume.ts +17 -1
- package/src/db/runs-repo.ts +147 -65
- package/src/db/schema.ts +134 -2
- package/src/db/templates-repo.ts +5 -3
- package/src/gui.tsx +438 -18
- package/src/history.ts +11 -4
- package/src/hook-output.ts +39 -0
- package/src/i18n.ts +12 -4
- package/src/index.ts +1902 -320
- package/src/notifications.ts +227 -47
- package/src/profiles.ts +88 -10
- package/src/rpc.ts +158 -0
- package/src/server.ts +201 -41
- package/src/settings.ts +125 -5
- package/src/shared/jobs-view.ts +3 -1
- package/src/task-transfer.ts +90 -6
- package/src/templates.ts +3 -3
- package/src/types.ts +23 -2
- package/src/workspaces.ts +37 -14
package/dist/core/lock.js
CHANGED
|
@@ -2,6 +2,16 @@ import fs from "node:fs/promises";
|
|
|
2
2
|
import path from "node:path";
|
|
3
3
|
import { randomUUID } from "node:crypto";
|
|
4
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
|
+
}
|
|
5
15
|
/**
|
|
6
16
|
* Проверяет, жив ли процесс-владелец lock-файла.
|
|
7
17
|
*
|
|
@@ -23,13 +33,85 @@ export function isProcessAlive(pid) {
|
|
|
23
33
|
return true;
|
|
24
34
|
}
|
|
25
35
|
}
|
|
26
|
-
/**
|
|
27
|
-
function
|
|
28
|
-
const
|
|
29
|
-
|
|
30
|
-
|
|
31
|
-
|
|
32
|
-
|
|
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);
|
|
33
115
|
}
|
|
34
116
|
/**
|
|
35
117
|
* Менеджер файловых блокировок для предотвращения наложения запусков одной задачи.
|
|
@@ -76,22 +158,21 @@ export class LockManager {
|
|
|
76
158
|
// Артефакт предыдущего вытеснения валидным lock быть не может,
|
|
77
159
|
// поэтому убираем его независимо от возраста.
|
|
78
160
|
if (isStaleArtifact) {
|
|
79
|
-
await fs.rm(fullPath, { recursive: true, force: true }).catch(() =>
|
|
161
|
+
await fs.rm(fullPath, { recursive: true, force: true }).catch((err) => warnCleanupFailure(fullPath, err));
|
|
80
162
|
continue;
|
|
81
163
|
}
|
|
82
164
|
const stat = await fs.stat(fullPath);
|
|
83
165
|
const age = now - stat.mtimeMs;
|
|
84
166
|
if (age > STALE_LOCK_MAX_AGE_MS) {
|
|
85
|
-
// P2-18: возраст — только повод проверить владельца. Задача может
|
|
167
|
+
// P2-18/B7: возраст — только повод проверить владельца. Задача может
|
|
86
168
|
// легально работать дольше 24 ч (timeoutSeconds: 0), поэтому живой
|
|
87
169
|
// процесс не вытесняем: иначе после рестарта плагина появится дубль.
|
|
88
|
-
|
|
89
|
-
|
|
90
|
-
|
|
91
|
-
|
|
92
|
-
|
|
93
|
-
|
|
94
|
-
}
|
|
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;
|
|
95
176
|
}
|
|
96
177
|
// T-03: не удаляем lock напрямую. Два воркера могли одновременно
|
|
97
178
|
// снести один и тот же файл, после чего один из них удалял свежий
|
|
@@ -105,7 +186,7 @@ export class LockManager {
|
|
|
105
186
|
catch {
|
|
106
187
|
continue;
|
|
107
188
|
}
|
|
108
|
-
await fs.rm(stalePath, { recursive: true, force: true }).catch(() =>
|
|
189
|
+
await fs.rm(stalePath, { recursive: true, force: true }).catch((err) => warnCleanupFailure(stalePath, err));
|
|
109
190
|
console.log(`[agent-steward] Вытеснен зависший lock: ${file} (возраст ${Math.round(age / 1000)} с)`);
|
|
110
191
|
}
|
|
111
192
|
}
|
|
@@ -125,19 +206,56 @@ export class LockManager {
|
|
|
125
206
|
async acquire(taskName) {
|
|
126
207
|
await fs.mkdir(this.lockDir, { recursive: true });
|
|
127
208
|
const lockPath = this.lockFilePath(taskName);
|
|
128
|
-
|
|
209
|
+
// B6: единый формат `<pid>-<iso>` (+ uuid для уникальности токена).
|
|
210
|
+
// PS-обёртка пишет тот же префикс, поэтому её stale-проверка видит PID,
|
|
211
|
+
// а не год из даты, и не вытесняет живой Node-лок.
|
|
212
|
+
const token = `${process.pid}-${new Date().toISOString()}-${randomUUID()}`;
|
|
129
213
|
try {
|
|
130
214
|
// 'wx' — exclusive create: ошибка если файл уже существует.
|
|
131
215
|
await fs.writeFile(lockPath, token, { flag: "wx" });
|
|
132
216
|
return token;
|
|
133
217
|
}
|
|
134
218
|
catch (err) {
|
|
135
|
-
|
|
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") {
|
|
136
227
|
return null;
|
|
137
228
|
}
|
|
138
229
|
throw err;
|
|
139
230
|
}
|
|
140
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
|
+
}
|
|
141
259
|
/**
|
|
142
260
|
* Освобождает блокировку задачи (удаляет lock-файл).
|
|
143
261
|
*
|
|
@@ -159,15 +277,9 @@ export class LockManager {
|
|
|
159
277
|
}
|
|
160
278
|
if (current !== token)
|
|
161
279
|
return false;
|
|
162
|
-
|
|
163
|
-
|
|
164
|
-
|
|
165
|
-
}
|
|
166
|
-
catch (err) {
|
|
167
|
-
if (err.code === "ENOENT")
|
|
168
|
-
return false;
|
|
169
|
-
throw err;
|
|
170
|
-
}
|
|
280
|
+
// P3-39: на Windows unlink может кратковременно упасть EPERM, пока
|
|
281
|
+
// другие процессы читают lock для проверки владельца.
|
|
282
|
+
return this.unlinkWithRetry(lockPath);
|
|
171
283
|
}
|
|
172
284
|
/**
|
|
173
285
|
* Проверяет, удерживается ли блокировка задачей в данный момент.
|
|
@@ -240,7 +352,7 @@ export async function withLockWait(lockManager, taskName, fn, options = {}) {
|
|
|
240
352
|
const stalePath = `${lockPath}.stale-${process.pid}-${Date.now()}`;
|
|
241
353
|
try {
|
|
242
354
|
await fs.rename(lockPath, stalePath);
|
|
243
|
-
await fs.rm(stalePath, { force: true }).catch(() =>
|
|
355
|
+
await fs.rm(stalePath, { force: true }).catch((err) => warnCleanupFailure(stalePath, err));
|
|
244
356
|
}
|
|
245
357
|
catch {
|
|
246
358
|
// Кто-то успел раньше — просто повторяем acquire.
|
package/dist/core/matrix.d.ts
CHANGED
|
@@ -12,6 +12,14 @@ export declare function isMatrixCompleteName(name: string): boolean;
|
|
|
12
12
|
* Бросает ошибку, если workspace не найден или список пуст.
|
|
13
13
|
*/
|
|
14
14
|
export declare function expandMatrixTask(task: TaskDefinition): TaskDefinition[];
|
|
15
|
+
/**
|
|
16
|
+
* QA-P3.7: задача считается матрицей, если у неё есть конфиг `matrix` либо
|
|
17
|
+
* в истории есть записи с каноническим префиксом клона `<name>-matrix-`
|
|
18
|
+
* (включая агрегатор `-matrix-complete`). Проверка истории важна для QA-P1.2:
|
|
19
|
+
* определение родителя могло быть удалено, но запуски клонов остались, и
|
|
20
|
+
* matrix_control должен продолжать их показывать.
|
|
21
|
+
*/
|
|
22
|
+
export declare function isKnownMatrix(name: string): boolean;
|
|
15
23
|
export interface MatrixCloneResult {
|
|
16
24
|
name: string;
|
|
17
25
|
workspaceId: string | null;
|
|
@@ -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
|
@@ -11,11 +11,29 @@
|
|
|
11
11
|
*/
|
|
12
12
|
import { sanitizeName } from "../types.js";
|
|
13
13
|
import { getTask, listMatrixClones, listTasks, saveTask, } from "../db/tasks-repo.js";
|
|
14
|
-
import { getHistory, recordRun } from "../db/history-repo.js";
|
|
14
|
+
import { getHistory, getLatestHistoryByTask, 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>. */
|
|
@@ -120,10 +138,65 @@ function latestCloneStatus(cloneName) {
|
|
|
120
138
|
finishedAt: last.finishedAt ?? null,
|
|
121
139
|
};
|
|
122
140
|
}
|
|
141
|
+
/**
|
|
142
|
+
* QA-F.2: клон матрицы может остаться только в истории — определение удаляется
|
|
143
|
+
* при реконфигурации матрицы (`syncMatrixFamily`) или `cleanup`, но аналитика
|
|
144
|
+
* продолжает показывать задачу по имени. История не хранит `matrixParentId`,
|
|
145
|
+
* поэтому родитель восстанавливается из канонического префикса имени клона
|
|
146
|
+
* `<parent>-matrix-<workspace>` (тот же, что порождает `matrixCloneName`).
|
|
147
|
+
*/
|
|
148
|
+
function listMatrixClonesFromHistory(parentId) {
|
|
149
|
+
const prefix = `${parentId.trim()}-matrix-`.toLowerCase();
|
|
150
|
+
const clones = [];
|
|
151
|
+
const seen = new Set();
|
|
152
|
+
for (const record of getLatestHistoryByTask(5000)) {
|
|
153
|
+
const name = record.taskName?.trim();
|
|
154
|
+
if (!name)
|
|
155
|
+
continue;
|
|
156
|
+
const key = name.toLowerCase();
|
|
157
|
+
// Агрегатор `-matrix-complete` тоже содержит префикс, но это не клон.
|
|
158
|
+
if (!key.startsWith(prefix) || isMatrixCompleteName(name) || seen.has(key))
|
|
159
|
+
continue;
|
|
160
|
+
seen.add(key);
|
|
161
|
+
clones.push({ name, workspaceId: record.workspaceId ?? null });
|
|
162
|
+
}
|
|
163
|
+
return clones;
|
|
164
|
+
}
|
|
165
|
+
/**
|
|
166
|
+
* QA-P3.7: задача считается матрицей, если у неё есть конфиг `matrix` либо
|
|
167
|
+
* в истории есть записи с каноническим префиксом клона `<name>-matrix-`
|
|
168
|
+
* (включая агрегатор `-matrix-complete`). Проверка истории важна для QA-P1.2:
|
|
169
|
+
* определение родителя могло быть удалено, но запуски клонов остались, и
|
|
170
|
+
* matrix_control должен продолжать их показывать.
|
|
171
|
+
*/
|
|
172
|
+
export function isKnownMatrix(name) {
|
|
173
|
+
const trimmed = name.trim();
|
|
174
|
+
if (!trimmed)
|
|
175
|
+
return false;
|
|
176
|
+
if (getTask(trimmed)?.matrix)
|
|
177
|
+
return true;
|
|
178
|
+
const prefix = `${trimmed}-matrix-`.toLowerCase();
|
|
179
|
+
return getLatestHistoryByTask(5000).some((record) => (record.taskName ?? "").trim().toLowerCase().startsWith(prefix));
|
|
180
|
+
}
|
|
123
181
|
/** Собирает результаты клонов и вычисляет агрегированный статус. */
|
|
124
182
|
export function aggregateMatrixResults(parentId) {
|
|
125
183
|
const parent = getTask(parentId);
|
|
126
|
-
const
|
|
184
|
+
const definedClones = listMatrixClones(parentId);
|
|
185
|
+
// QA-F.2 / QA-P1.2: объединяем определения с клонами, оставшимися только
|
|
186
|
+
// в истории, чтобы matrix_control показывал тот же набор, что и аналитика.
|
|
187
|
+
// История — независимый источник:definition родителя может быть удалён
|
|
188
|
+
// (например, при чистке сирот), но запуски клонов остаются в истории, и
|
|
189
|
+
// аналитика по-прежнему их видит. Раньше здесь стоял guard `parent ? … : []`,
|
|
190
|
+
// из-за которого live-матрица __matrixprobe__ показывала «нет клонов», хотя
|
|
191
|
+
// история содержала __matrixprobe__-matrix-__mw__. Пустой агрегат остаётся
|
|
192
|
+
// только когда нет ни определений, ни записей истории с каноническим
|
|
193
|
+
// префиксом <parent>-matrix-.
|
|
194
|
+
const historyClones = listMatrixClonesFromHistory(parentId);
|
|
195
|
+
const known = new Set(definedClones.map((clone) => clone.name.toLowerCase()));
|
|
196
|
+
const clones = [
|
|
197
|
+
...definedClones,
|
|
198
|
+
...historyClones.filter((clone) => !known.has(clone.name.toLowerCase())),
|
|
199
|
+
];
|
|
127
200
|
const failureMode = parent?.matrix?.failureMode ?? "continue";
|
|
128
201
|
const results = clones.map((clone) => {
|
|
129
202
|
const workspace = clone.workspaceId ? getWorkspace(clone.workspaceId) : undefined;
|
|
@@ -249,6 +322,7 @@ export async function runMatrix(task) {
|
|
|
249
322
|
catch (err) {
|
|
250
323
|
const message = err instanceof Error ? err.message : String(err);
|
|
251
324
|
errors.push(`${clone.name}: ${message}`);
|
|
325
|
+
logMatrixEvent(task.name, "start_failed", { cloneName: clone.name, error: message });
|
|
252
326
|
if (failureMode === "stop") {
|
|
253
327
|
const rest = clones
|
|
254
328
|
.slice(clones.indexOf(clone) + 1)
|
|
@@ -264,11 +338,16 @@ export async function runMatrix(task) {
|
|
|
264
338
|
saveTask({ ...task, matrixQueue: queueToSave.length > 0 ? queueToSave : undefined });
|
|
265
339
|
}
|
|
266
340
|
catch (err) {
|
|
267
|
-
|
|
341
|
+
logMatrixEvent(task.name, "queue_save_failed", {
|
|
342
|
+
error: err instanceof Error ? err.message : String(err),
|
|
343
|
+
});
|
|
268
344
|
}
|
|
269
|
-
|
|
270
|
-
|
|
271
|
-
`
|
|
345
|
+
logMatrixEvent(task.name, "started", {
|
|
346
|
+
status: started.length > 0 ? "running" : "error",
|
|
347
|
+
reason: `strategy=${strategy}, failureMode=${failureMode}, ` +
|
|
348
|
+
`concurrency=${concurrency}, started=${started.length}, skipped=${skipped.length}, ` +
|
|
349
|
+
`queued=${queueToSave.length}, errors=${errors.length}`,
|
|
350
|
+
});
|
|
272
351
|
return {
|
|
273
352
|
success: errors.length === 0 || failureMode === "continue",
|
|
274
353
|
parent: task.name,
|
|
@@ -309,7 +388,10 @@ export async function advanceSequentialMatrix(cloneName) {
|
|
|
309
388
|
if ((parent.matrix.failureMode ?? "continue") === "stop") {
|
|
310
389
|
const latest = latestCloneStatus(cloneName);
|
|
311
390
|
if (latest.status === "error") {
|
|
312
|
-
|
|
391
|
+
logMatrixEvent(parent.name, "sequential_stopped", {
|
|
392
|
+
cloneName,
|
|
393
|
+
status: "error",
|
|
394
|
+
});
|
|
313
395
|
return undefined;
|
|
314
396
|
}
|
|
315
397
|
}
|
|
@@ -320,12 +402,16 @@ export async function advanceSequentialMatrix(cloneName) {
|
|
|
320
402
|
const result = await createSchedulerBackend().runTask(next.name);
|
|
321
403
|
if (result.alreadyRunning)
|
|
322
404
|
return undefined;
|
|
323
|
-
|
|
405
|
+
logMatrixEvent(parent.name, "advanced", {
|
|
406
|
+
cloneName: next.name,
|
|
407
|
+
status: "running",
|
|
408
|
+
reason: "sequential",
|
|
409
|
+
});
|
|
324
410
|
return next.name;
|
|
325
411
|
}
|
|
326
412
|
catch (err) {
|
|
327
413
|
const message = err instanceof Error ? err.message : String(err);
|
|
328
|
-
|
|
414
|
+
logMatrixEvent(parent.name, "start_failed", { cloneName: next.name, error: message });
|
|
329
415
|
return undefined;
|
|
330
416
|
}
|
|
331
417
|
}
|
|
@@ -369,11 +455,17 @@ export async function advanceMatrixAfterClone(cloneName) {
|
|
|
369
455
|
slots -= 1;
|
|
370
456
|
if (result.alreadyRunning)
|
|
371
457
|
slots += 0; // слот уже занят этим клоном
|
|
372
|
-
|
|
458
|
+
logMatrixEvent(parent.name, "queue_started", {
|
|
459
|
+
cloneName: nextName,
|
|
460
|
+
status: "running",
|
|
461
|
+
});
|
|
373
462
|
}
|
|
374
463
|
catch (err) {
|
|
375
464
|
const message = err instanceof Error ? err.message : String(err);
|
|
376
|
-
|
|
465
|
+
logMatrixEvent(parent.name, "queue_start_failed", {
|
|
466
|
+
cloneName: nextName,
|
|
467
|
+
error: message,
|
|
468
|
+
});
|
|
377
469
|
// Попытка запуска «съедает» слот: иначе при недоступном бэкенде
|
|
378
470
|
// цикл уйдёт по всей очереди, проигнорировав лимит.
|
|
379
471
|
slots -= 1;
|
|
@@ -387,7 +479,9 @@ export async function advanceMatrixAfterClone(cloneName) {
|
|
|
387
479
|
saveTask({ ...parent, matrixQueue: queue.length > 0 ? queue : undefined });
|
|
388
480
|
}
|
|
389
481
|
catch (err) {
|
|
390
|
-
|
|
482
|
+
logMatrixEvent(parent.name, "queue_save_failed", {
|
|
483
|
+
error: err instanceof Error ? err.message : String(err),
|
|
484
|
+
});
|
|
391
485
|
}
|
|
392
486
|
return started;
|
|
393
487
|
}
|
|
@@ -617,7 +711,9 @@ export async function cancelPendingMatrixClones(parentName, reason = t("matrix.c
|
|
|
617
711
|
saveTask({ ...parent, matrixQueue: undefined });
|
|
618
712
|
}
|
|
619
713
|
catch (err) {
|
|
620
|
-
|
|
714
|
+
logMatrixEvent(parent.name, "queue_clear_failed", {
|
|
715
|
+
error: err instanceof Error ? err.message : String(err),
|
|
716
|
+
});
|
|
621
717
|
}
|
|
622
718
|
}
|
|
623
719
|
for (const clone of clones) {
|
|
@@ -637,7 +733,11 @@ export async function cancelPendingMatrixClones(parentName, reason = t("matrix.c
|
|
|
637
733
|
cancelled.push(clone.name);
|
|
638
734
|
}
|
|
639
735
|
catch (err) {
|
|
640
|
-
|
|
736
|
+
logMatrixEvent(parent.name, "cancelled", {
|
|
737
|
+
cloneName: clone.name,
|
|
738
|
+
status: "error",
|
|
739
|
+
error: err instanceof Error ? err.message : String(err),
|
|
740
|
+
});
|
|
641
741
|
}
|
|
642
742
|
}
|
|
643
743
|
if (cancelled.length > 0 && clones.length > 0) {
|
|
@@ -704,19 +804,34 @@ export async function finalizeMatrixIfComplete(cloneName) {
|
|
|
704
804
|
error: aggregate.errorCount,
|
|
705
805
|
message: aggregate.message,
|
|
706
806
|
});
|
|
807
|
+
const aggregateRunId = getHistory(parent.name, 1)[0]?.id;
|
|
808
|
+
logMatrixEvent(parent.name, "aggregated", {
|
|
809
|
+
status: finalStatus,
|
|
810
|
+
runId: aggregateRunId,
|
|
811
|
+
reason: `total=${aggregate.totalCount}, success=${aggregate.successCount}, ` +
|
|
812
|
+
`error=${aggregate.errorCount}`,
|
|
813
|
+
});
|
|
707
814
|
}
|
|
708
815
|
catch (err) {
|
|
709
|
-
|
|
816
|
+
logMatrixEvent(parent.name, "aggregate_failed", {
|
|
817
|
+
error: err instanceof Error ? err.message : String(err),
|
|
818
|
+
});
|
|
710
819
|
}
|
|
711
820
|
if (parent.matrix.createAggregator) {
|
|
712
821
|
const aggregator = getTask(matrixCompleteName(parent.name));
|
|
713
822
|
if (aggregator) {
|
|
714
823
|
try {
|
|
715
824
|
await createSchedulerBackend().runTask(aggregator.name);
|
|
716
|
-
|
|
825
|
+
logMatrixEvent(parent.name, "aggregator_started", {
|
|
826
|
+
cloneName: aggregator.name,
|
|
827
|
+
status: "running",
|
|
828
|
+
});
|
|
717
829
|
}
|
|
718
830
|
catch (err) {
|
|
719
|
-
|
|
831
|
+
logMatrixEvent(parent.name, "aggregator_start_failed", {
|
|
832
|
+
cloneName: aggregator.name,
|
|
833
|
+
error: err instanceof Error ? err.message : String(err),
|
|
834
|
+
});
|
|
720
835
|
}
|
|
721
836
|
}
|
|
722
837
|
}
|
|
@@ -0,0 +1,103 @@
|
|
|
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
|
+
/**
|
|
13
|
+
* Маркер начала прогона в логе задачи/миссии.
|
|
14
|
+
*
|
|
15
|
+
* Лог НЕ очищается перед запуском: при падении до первого вывода обёртки он
|
|
16
|
+
* остался бы пустым и диагностировать причину было бы невозможно. Маркер
|
|
17
|
+
* разделяет прогоны в общем файле и подтверждает, что запуск действительно
|
|
18
|
+
* дошёл до подготовки обёртки.
|
|
19
|
+
*/
|
|
20
|
+
export declare function formatLogRunMarker(kind: "run" | "mission" | "prepare", taskName: string, now?: Date): string;
|
|
21
|
+
/**
|
|
22
|
+
* Возвращает часть лога, относящуюся только к последнему запуску.
|
|
23
|
+
*
|
|
24
|
+
* Лог намеренно дописывается, а не очищается (иначе при падении до первого
|
|
25
|
+
* вывода обёртки диагностировать причину было бы невозможно). Маркеры
|
|
26
|
+
* `Run started`/`Mission started` разделяют прогоны: потребителям лога
|
|
27
|
+
* нужно показывать и разбирать только последний сегмент. `Task prepared`
|
|
28
|
+
* маркером запуска НЕ считается — он пишется при создании/редактировании
|
|
29
|
+
* задачи, когда реального прогона ещё не было.
|
|
30
|
+
*/
|
|
31
|
+
export declare function extractLastRunLog(content: string): string;
|
|
32
|
+
/** AB-8.1: спецификация ad-hoc миссии (цель + safety-контракт). */
|
|
33
|
+
export interface MissionSpec {
|
|
34
|
+
/** Цель миссии — тот же промпт, что получил бы OpenCode. */
|
|
35
|
+
prompt: string;
|
|
36
|
+
/** Рабочая директория; по умолчанию — cwd процесса. */
|
|
37
|
+
cwd?: string;
|
|
38
|
+
/** Имя запуска в ledger; по умолчанию генерируется `ad-hoc-*`. */
|
|
39
|
+
taskName?: string;
|
|
40
|
+
/** Тип задачи для маршрутизатора; по умолчанию `mission` (local/direct). */
|
|
41
|
+
taskType?: string;
|
|
42
|
+
/** Модель OpenCode (пусто — модель по умолчанию). */
|
|
43
|
+
model?: string;
|
|
44
|
+
/** Режим сессии OpenCode. */
|
|
45
|
+
session?: SessionMode;
|
|
46
|
+
/** Идентификатор сессии для `session=reuse`. */
|
|
47
|
+
sessionId?: string;
|
|
48
|
+
/** Таймаут исполнения в секундах (по умолчанию 3600). */
|
|
49
|
+
timeoutSeconds?: number;
|
|
50
|
+
/** Quality Gate: команда, ненулевой код которой проваливает миссию. */
|
|
51
|
+
gate?: string;
|
|
52
|
+
/** Таймаут Quality Gate в секундах (по умолчанию 300). */
|
|
53
|
+
gateTimeoutSeconds?: number;
|
|
54
|
+
/** Политика прав: hybrid (по умолчанию), secure, legacy. */
|
|
55
|
+
policy?: RunPermissionPolicy;
|
|
56
|
+
/** Allowlist инструментов; непустой список блокирует остальные. */
|
|
57
|
+
allowedTools?: string[];
|
|
58
|
+
/** Denylist инструментов; выигрывает у allowlist. */
|
|
59
|
+
deniedTools?: string[];
|
|
60
|
+
/** Только построить план и показать трассировку, не исполняя. */
|
|
61
|
+
dryRun?: boolean;
|
|
62
|
+
}
|
|
63
|
+
/** Результат ad-hoc миссии. */
|
|
64
|
+
export interface MissionResult {
|
|
65
|
+
success: boolean;
|
|
66
|
+
dryRun: boolean;
|
|
67
|
+
runId: string | null;
|
|
68
|
+
status: ExecutionResult["status"] | "planned";
|
|
69
|
+
plan: ExecutionPlan;
|
|
70
|
+
description: string;
|
|
71
|
+
steps: ExecutionResult["steps"];
|
|
72
|
+
error: string | null;
|
|
73
|
+
logFile: string | null;
|
|
74
|
+
}
|
|
75
|
+
/** Зависимости для тестов: позволяют подменить исполнение без OpenCode. */
|
|
76
|
+
export interface MissionDependencies {
|
|
77
|
+
executor?: StepExecutor;
|
|
78
|
+
/** Хук после подготовки: тест может проверить отсутствие задач в ОС. */
|
|
79
|
+
onPrepared?: (info: {
|
|
80
|
+
taskName: string;
|
|
81
|
+
cwd: string;
|
|
82
|
+
}) => void;
|
|
83
|
+
}
|
|
84
|
+
/**
|
|
85
|
+
* AB-8.1: валидирует и нормализует вход. Возвращает безопасную копию спеки,
|
|
86
|
+
* чтобы CLI/RPC/GUI не могли передать нестроковые поля в обёртку.
|
|
87
|
+
*/
|
|
88
|
+
export declare function normalizeMissionSpec(input: MissionSpec): MissionSpec;
|
|
89
|
+
/** Создаёт RunContext ad-hoc миссии (без task definition). */
|
|
90
|
+
export declare function createMissionContext(spec: MissionSpec): RunContext;
|
|
91
|
+
/**
|
|
92
|
+
* AB-8: единая точка входа ad-hoc миссии для CLI, RPC и GUI.
|
|
93
|
+
*
|
|
94
|
+
* Инварианты EXECUTION-LOOP §2.1: нет записи в планировщике ОС, работают
|
|
95
|
+
* GATE, политика прав, ledger (`runs`/`run_steps`) и аудит; параллельные
|
|
96
|
+
* обычные миссии в одном workspace не допускаются.
|
|
97
|
+
*
|
|
98
|
+
* W-3 (контракт dryRun): `dryRun: true` строит план и описание, но не захватывает
|
|
99
|
+
* `activeWorkspaces` и не пишет ledger (`runs`/`run_steps`) — это контракт, а не
|
|
100
|
+
* утечка контекста. Поэтому несколько dry-run в одном `cwd` проходят параллельно.
|
|
101
|
+
*/
|
|
102
|
+
export declare function runMission(input: MissionSpec, dependencies?: MissionDependencies): Promise<MissionResult>;
|
|
103
|
+
//# 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;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,KAAK,GAAG,SAAS,GAAG,SAAS,EACnC,QAAQ,EAAE,MAAM,EAChB,GAAG,GAAE,IAAiB,GACrB,MAAM,CAUR;AAED;;;;;;;;;GASG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CASzD;AAED,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;AAoLD;;;;;;;;;;GAUG;AACH,wBAAsB,UAAU,CAC9B,KAAK,EAAE,WAAW,EAClB,YAAY,GAAE,mBAAwB,GACrC,OAAO,CAAC,aAAa,CAAC,CAkExB"}
|