agent-steward 0.0.4 → 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 +134 -2
- package/CROSS_PLATFORM.md +19 -0
- package/README.md +52 -7
- package/ROADMAP-STRATEGY.md +21 -18
- package/ROADMAP.md +140 -159
- package/dist/cli.d.ts +3 -0
- package/dist/cli.d.ts.map +1 -0
- package/dist/cli.js +351 -0
- 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 +41 -0
- package/dist/core/lock.d.ts.map +1 -1
- package/dist/core/lock.js +141 -29
- 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/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 +250 -62
- package/dist/core/record-history.d.ts.map +1 -1
- package/dist/core/record-history.js +130 -29
- package/dist/core/router/rules.d.ts.map +1 -1
- package/dist/core/router/rules.js +6 -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/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/structured-log.d.ts +7 -1
- package/dist/core/structured-log.d.ts.map +1 -1
- 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 +175 -24
- 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 +38 -5
- package/dist/db/history-repo.d.ts.map +1 -1
- package/dist/db/history-repo.js +88 -25
- package/dist/db/metrics-repo.js +2 -2
- package/dist/db/recovery.d.ts.map +1 -1
- package/dist/db/recovery.js +5 -4
- 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 +22 -6
- package/dist/db/schema.d.ts +2 -2
- package/dist/db/schema.d.ts.map +1 -1
- package/dist/db/schema.js +63 -2
- 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 +136 -2
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +378 -14
- 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 +246 -0
- package/dist/rpc.d.ts.map +1 -1
- package/dist/rpc.js +117 -0
- package/dist/server.d.ts +15 -0
- package/dist/server.d.ts.map +1 -1
- package/dist/server.js +77 -18
- 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/docs/ARCHITECTURE.md +281 -65
- 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 +22 -7
- 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 +42 -3
- package/docs/README.zh.md +43 -3
- package/docs/SAFETY.md +23 -3
- package/gui-experimental.cjs +9 -8
- package/locales/en.json +17 -1
- package/locales/ru.json +17 -1
- package/locales/zh.json +17 -1
- package/opencode.pipeline.yaml +35 -0
- package/package.json +23 -4
- package/scripts/test-home.mjs +83 -0
- package/src/cli.ts +412 -0
- package/src/core/dry-run.ts +2 -2
- 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 +178 -37
- 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/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 +263 -63
- package/src/core/record-history.ts +164 -77
- package/src/core/router/rules.ts +6 -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 +2 -2
- 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 +8 -8
- package/src/core/structured-log.ts +22 -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/worktree-run.ts +199 -0
- package/src/core/worktree.ts +600 -0
- package/src/core/wrappers/bash.ts +190 -23
- package/src/db/capability-repo.ts +127 -10
- package/src/db/history-repo.ts +129 -22
- package/src/db/metrics-repo.ts +2 -2
- package/src/db/recovery.ts +5 -4
- package/src/db/run-journal.ts +100 -13
- package/src/db/run-resume.ts +17 -1
- package/src/db/runs-repo.ts +36 -6
- package/src/db/schema.ts +65 -2
- package/src/gui.tsx +177 -13
- package/src/history.ts +1 -1
- package/src/i18n.ts +12 -4
- package/src/index.ts +524 -4
- package/src/notifications.ts +38 -8
- package/src/profiles.ts +26 -4
- package/src/rpc.ts +128 -0
- package/src/server.ts +94 -18
- package/src/settings.ts +5 -5
- package/src/shared/jobs-view.ts +3 -1
- package/src/task-transfer.ts +31 -0
|
@@ -0,0 +1,485 @@
|
|
|
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
|
+
|
|
11
|
+
import { spawn } from "node:child_process";
|
|
12
|
+
import crypto from "node:crypto";
|
|
13
|
+
import fs from "node:fs/promises";
|
|
14
|
+
import { createRequire } from "node:module";
|
|
15
|
+
import path from "node:path";
|
|
16
|
+
import { LOG_DIR, sanitizeName } from "../types.js";
|
|
17
|
+
import {
|
|
18
|
+
buildExecutionPlan,
|
|
19
|
+
createAdHocRunContext,
|
|
20
|
+
describeExecutionPlan,
|
|
21
|
+
executeExecutionPlan,
|
|
22
|
+
type ExecutionPlan,
|
|
23
|
+
type ExecutionResult,
|
|
24
|
+
type RunContext,
|
|
25
|
+
type RunPermissionPolicy,
|
|
26
|
+
type StepExecutor,
|
|
27
|
+
} from "./execution.js";
|
|
28
|
+
import { buildOpencodeConfig } from "./permissions.js";
|
|
29
|
+
import {
|
|
30
|
+
ensureWrapper,
|
|
31
|
+
lockFilePath,
|
|
32
|
+
writePromptFile,
|
|
33
|
+
writeWrapperCmd,
|
|
34
|
+
} from "./ps-wrapper.js";
|
|
35
|
+
import {
|
|
36
|
+
generateSessionId,
|
|
37
|
+
normalizeSessionMode,
|
|
38
|
+
sessionStatePath,
|
|
39
|
+
writeSessionStateFile,
|
|
40
|
+
type SessionMode,
|
|
41
|
+
} from "./session.js";
|
|
42
|
+
import { writeBashWrapper } from "./wrappers/bash.js";
|
|
43
|
+
|
|
44
|
+
/** AB-8.1: спецификация ad-hoc миссии (цель + safety-контракт). */
|
|
45
|
+
export interface MissionSpec {
|
|
46
|
+
/** Цель миссии — тот же промпт, что получил бы OpenCode. */
|
|
47
|
+
prompt: string;
|
|
48
|
+
/** Рабочая директория; по умолчанию — cwd процесса. */
|
|
49
|
+
cwd?: string;
|
|
50
|
+
/** Имя запуска в ledger; по умолчанию генерируется `ad-hoc-*`. */
|
|
51
|
+
taskName?: string;
|
|
52
|
+
/** Тип задачи для маршрутизатора; по умолчанию `mission` (local/direct). */
|
|
53
|
+
taskType?: string;
|
|
54
|
+
/** Модель OpenCode (пусто — модель по умолчанию). */
|
|
55
|
+
model?: string;
|
|
56
|
+
/** Режим сессии OpenCode. */
|
|
57
|
+
session?: SessionMode;
|
|
58
|
+
/** Идентификатор сессии для `session=reuse`. */
|
|
59
|
+
sessionId?: string;
|
|
60
|
+
/** Таймаут исполнения в секундах (по умолчанию 3600). */
|
|
61
|
+
timeoutSeconds?: number;
|
|
62
|
+
/** Quality Gate: команда, ненулевой код которой проваливает миссию. */
|
|
63
|
+
gate?: string;
|
|
64
|
+
/** Таймаут Quality Gate в секундах (по умолчанию 300). */
|
|
65
|
+
gateTimeoutSeconds?: number;
|
|
66
|
+
/** Политика прав: hybrid (по умолчанию), secure, legacy. */
|
|
67
|
+
policy?: RunPermissionPolicy;
|
|
68
|
+
/** Allowlist инструментов; непустой список блокирует остальные. */
|
|
69
|
+
allowedTools?: string[];
|
|
70
|
+
/** Denylist инструментов; выигрывает у allowlist. */
|
|
71
|
+
deniedTools?: string[];
|
|
72
|
+
/** Только построить план и показать трассировку, не исполняя. */
|
|
73
|
+
dryRun?: boolean;
|
|
74
|
+
}
|
|
75
|
+
|
|
76
|
+
/** Результат ad-hoc миссии. */
|
|
77
|
+
export interface MissionResult {
|
|
78
|
+
success: boolean;
|
|
79
|
+
dryRun: boolean;
|
|
80
|
+
runId: string | null;
|
|
81
|
+
status: ExecutionResult["status"] | "planned";
|
|
82
|
+
plan: ExecutionPlan;
|
|
83
|
+
description: string;
|
|
84
|
+
steps: ExecutionResult["steps"];
|
|
85
|
+
error: string | null;
|
|
86
|
+
logFile: string | null;
|
|
87
|
+
}
|
|
88
|
+
|
|
89
|
+
/** Зависимости для тестов: позволяют подменить исполнение без OpenCode. */
|
|
90
|
+
export interface MissionDependencies {
|
|
91
|
+
executor?: StepExecutor;
|
|
92
|
+
/** Хук после подготовки: тест может проверить отсутствие задач в ОС. */
|
|
93
|
+
onPrepared?: (info: { taskName: string; cwd: string }) => void;
|
|
94
|
+
}
|
|
95
|
+
|
|
96
|
+
const DEFAULT_TIMEOUT_SECONDS = 3600;
|
|
97
|
+
const MAX_TIMEOUT_SECONDS = 24 * 60 * 60;
|
|
98
|
+
|
|
99
|
+
/** Активные ad-hoc миссии по workspace — защита от двух миссий в одном репо. */
|
|
100
|
+
const activeWorkspaces = new Map<string, string>();
|
|
101
|
+
|
|
102
|
+
const requireFromCore = createRequire(import.meta.url);
|
|
103
|
+
|
|
104
|
+
/** Путь к скомпилированному record-history.js (как в index.ts). */
|
|
105
|
+
function recorderPath(): string {
|
|
106
|
+
const resolved = requireFromCore.resolve("./record-history.js");
|
|
107
|
+
if (!resolved.endsWith(".ts")) return resolved;
|
|
108
|
+
return resolved
|
|
109
|
+
.replace(/([\\/])src([\\/])/, "$1dist$2")
|
|
110
|
+
.replace(/\.ts$/, ".js");
|
|
111
|
+
}
|
|
112
|
+
|
|
113
|
+
function assertNonEmpty(value: unknown, label: string): string {
|
|
114
|
+
if (typeof value !== "string" || value.trim() === "") {
|
|
115
|
+
throw new Error(`Пустое поле миссии: ${label}.`);
|
|
116
|
+
}
|
|
117
|
+
return value.trim();
|
|
118
|
+
}
|
|
119
|
+
|
|
120
|
+
function positiveInt(value: unknown, label: string, fallback: number): number {
|
|
121
|
+
if (value === undefined || value === null) return fallback;
|
|
122
|
+
if (typeof value !== "number" || !Number.isInteger(value) || value <= 0) {
|
|
123
|
+
throw new Error(`Поле миссии "${label}" должно быть целым положительным числом.`);
|
|
124
|
+
}
|
|
125
|
+
return Math.min(value, MAX_TIMEOUT_SECONDS);
|
|
126
|
+
}
|
|
127
|
+
|
|
128
|
+
function normalizeTools(value: unknown, label: string): string[] | undefined {
|
|
129
|
+
if (value === undefined) return undefined;
|
|
130
|
+
if (!Array.isArray(value)) {
|
|
131
|
+
throw new Error(`Поле миссии "${label}" должно быть массивом строк.`);
|
|
132
|
+
}
|
|
133
|
+
const list = value
|
|
134
|
+
.filter((item): item is string => typeof item === "string")
|
|
135
|
+
.map((item) => item.trim())
|
|
136
|
+
.filter(Boolean);
|
|
137
|
+
return list.length > 0 ? list : undefined;
|
|
138
|
+
}
|
|
139
|
+
|
|
140
|
+
function newMissionName(): string {
|
|
141
|
+
const stamp = Date.now().toString(36);
|
|
142
|
+
const random = crypto.randomBytes(4).toString("hex");
|
|
143
|
+
return `ad-hoc-${stamp}-${random}`;
|
|
144
|
+
}
|
|
145
|
+
|
|
146
|
+
/**
|
|
147
|
+
* AB-8.1: валидирует и нормализует вход. Возвращает безопасную копию спеки,
|
|
148
|
+
* чтобы CLI/RPC/GUI не могли передать нестроковые поля в обёртку.
|
|
149
|
+
*/
|
|
150
|
+
export function normalizeMissionSpec(input: MissionSpec): MissionSpec {
|
|
151
|
+
if (!input || typeof input !== "object") {
|
|
152
|
+
throw new Error("Спецификация миссии должна быть объектом.");
|
|
153
|
+
}
|
|
154
|
+
const prompt = assertNonEmpty(input.prompt, "prompt");
|
|
155
|
+
const cwd = input.cwd?.trim() ? path.resolve(input.cwd.trim()) : process.cwd();
|
|
156
|
+
const taskName = input.taskName?.trim() ? input.taskName.trim() : undefined;
|
|
157
|
+
if (taskName && taskName.length > 200) {
|
|
158
|
+
throw new Error("Имя миссии длиннее 200 символов.");
|
|
159
|
+
}
|
|
160
|
+
const session = normalizeSessionMode(input.session);
|
|
161
|
+
if (!session) {
|
|
162
|
+
throw new Error('Поле "session" должно быть new, reuse или last.');
|
|
163
|
+
}
|
|
164
|
+
if (session === "reuse" && input.sessionId !== undefined && !/^ses_[A-Za-z0-9]{10,64}$/.test(input.sessionId)) {
|
|
165
|
+
throw new Error('Поле "sessionId" должно иметь формат ses_<id>.');
|
|
166
|
+
}
|
|
167
|
+
const policy = input.policy ?? "hybrid";
|
|
168
|
+
if (policy !== "hybrid" && policy !== "secure" && policy !== "legacy") {
|
|
169
|
+
throw new Error('Поле "policy" должно быть hybrid, secure или legacy.');
|
|
170
|
+
}
|
|
171
|
+
const allowedTools = normalizeTools(input.allowedTools, "allowedTools");
|
|
172
|
+
const deniedTools = normalizeTools(input.deniedTools, "deniedTools");
|
|
173
|
+
const denied = new Set((deniedTools ?? []).map((tool) => tool.toLowerCase()));
|
|
174
|
+
const conflict = (allowedTools ?? []).find((tool) => denied.has(tool.toLowerCase()));
|
|
175
|
+
if (conflict) {
|
|
176
|
+
throw new Error(`Инструмент "${conflict}" одновременно разрешён и запрещён.`);
|
|
177
|
+
}
|
|
178
|
+
return {
|
|
179
|
+
prompt,
|
|
180
|
+
cwd,
|
|
181
|
+
taskName,
|
|
182
|
+
taskType: input.taskType?.trim() || undefined,
|
|
183
|
+
model: input.model?.trim() || undefined,
|
|
184
|
+
session,
|
|
185
|
+
sessionId: input.sessionId?.trim() || undefined,
|
|
186
|
+
timeoutSeconds: positiveInt(
|
|
187
|
+
input.timeoutSeconds,
|
|
188
|
+
"timeoutSeconds",
|
|
189
|
+
DEFAULT_TIMEOUT_SECONDS,
|
|
190
|
+
),
|
|
191
|
+
gate: input.gate?.trim() || undefined,
|
|
192
|
+
gateTimeoutSeconds:
|
|
193
|
+
input.gateTimeoutSeconds === undefined
|
|
194
|
+
? undefined
|
|
195
|
+
: positiveInt(input.gateTimeoutSeconds, "gateTimeoutSeconds", 300),
|
|
196
|
+
policy,
|
|
197
|
+
allowedTools,
|
|
198
|
+
deniedTools,
|
|
199
|
+
dryRun: input.dryRun === true,
|
|
200
|
+
};
|
|
201
|
+
}
|
|
202
|
+
|
|
203
|
+
/** Создаёт RunContext ad-hoc миссии (без task definition). */
|
|
204
|
+
export function createMissionContext(spec: MissionSpec): RunContext {
|
|
205
|
+
return createAdHocRunContext(spec.prompt, {
|
|
206
|
+
cwd: spec.cwd,
|
|
207
|
+
taskName: spec.taskName,
|
|
208
|
+
taskType: spec.taskType ?? "mission",
|
|
209
|
+
policy: spec.policy ?? "hybrid",
|
|
210
|
+
profile: {
|
|
211
|
+
model: spec.model,
|
|
212
|
+
session: spec.session ?? "new",
|
|
213
|
+
sessionId: spec.sessionId,
|
|
214
|
+
},
|
|
215
|
+
safety: {
|
|
216
|
+
policy: spec.policy ?? "hybrid",
|
|
217
|
+
allowedTools: spec.allowedTools,
|
|
218
|
+
deniedTools: spec.deniedTools,
|
|
219
|
+
},
|
|
220
|
+
metadata: {
|
|
221
|
+
mission: true,
|
|
222
|
+
gate: spec.gate ?? null,
|
|
223
|
+
timeoutSeconds: spec.timeoutSeconds ?? DEFAULT_TIMEOUT_SECONDS,
|
|
224
|
+
},
|
|
225
|
+
});
|
|
226
|
+
}
|
|
227
|
+
|
|
228
|
+
interface WrapperPlan {
|
|
229
|
+
wrapperPath: string;
|
|
230
|
+
logFile: string;
|
|
231
|
+
}
|
|
232
|
+
|
|
233
|
+
/** Готовит обёртку с lock/таймаутом/политикой/Quality Gate, но без ОС. */
|
|
234
|
+
async function prepareWrapper(
|
|
235
|
+
spec: MissionSpec,
|
|
236
|
+
context: RunContext,
|
|
237
|
+
taskName: string,
|
|
238
|
+
): Promise<WrapperPlan> {
|
|
239
|
+
const sanitized = sanitizeName(taskName);
|
|
240
|
+
const logFile = path.join(LOG_DIR, `${sanitized}.log`);
|
|
241
|
+
const promptFile = await writePromptFile(taskName, spec.prompt);
|
|
242
|
+
await fs.mkdir(LOG_DIR, { recursive: true });
|
|
243
|
+
try {
|
|
244
|
+
await fs.writeFile(logFile, "", "utf8");
|
|
245
|
+
} catch (error) {
|
|
246
|
+
// Обёртки пишут лог через >> и создают файл сами: предварительная очистка
|
|
247
|
+
// нужна только чтобы убрать лог прошлого прогона. Не срываем миссию из-за
|
|
248
|
+
// прав доступа к каталогу логов.
|
|
249
|
+
console.warn(
|
|
250
|
+
`[agent-steward] Не удалось очистить лог миссии (${logFile}): ${error instanceof Error ? error.message : String(error)}`,
|
|
251
|
+
);
|
|
252
|
+
}
|
|
253
|
+
const lockFile = lockFilePath(taskName);
|
|
254
|
+
const sessionMode = spec.session ?? "new";
|
|
255
|
+
let sessionId = spec.sessionId;
|
|
256
|
+
if (sessionMode === "reuse" && !sessionId) {
|
|
257
|
+
sessionId = generateSessionId();
|
|
258
|
+
}
|
|
259
|
+
if (sessionMode === "reuse") {
|
|
260
|
+
await writeSessionStateFile(taskName, sessionId);
|
|
261
|
+
}
|
|
262
|
+
const sessionFile = sessionMode === "reuse" ? sessionStatePath(taskName) : undefined;
|
|
263
|
+
const timeoutSeconds = spec.timeoutSeconds ?? DEFAULT_TIMEOUT_SECONDS;
|
|
264
|
+
|
|
265
|
+
if (process.platform === "win32") {
|
|
266
|
+
const permissionsConfig = buildOpencodeConfig({
|
|
267
|
+
policy: context.safety.policy,
|
|
268
|
+
allowedTools: spec.allowedTools,
|
|
269
|
+
deniedTools: spec.deniedTools,
|
|
270
|
+
});
|
|
271
|
+
await ensureWrapper();
|
|
272
|
+
const wrapperPath = await writeWrapperCmd(
|
|
273
|
+
sanitized,
|
|
274
|
+
taskName,
|
|
275
|
+
promptFile,
|
|
276
|
+
timeoutSeconds,
|
|
277
|
+
lockFile,
|
|
278
|
+
context.cwd,
|
|
279
|
+
logFile,
|
|
280
|
+
recorderPath(),
|
|
281
|
+
spec.gate,
|
|
282
|
+
spec.model,
|
|
283
|
+
undefined,
|
|
284
|
+
undefined,
|
|
285
|
+
undefined,
|
|
286
|
+
spec.allowedTools,
|
|
287
|
+
spec.deniedTools,
|
|
288
|
+
undefined,
|
|
289
|
+
undefined,
|
|
290
|
+
sessionMode,
|
|
291
|
+
sessionId,
|
|
292
|
+
spec.gateTimeoutSeconds,
|
|
293
|
+
permissionsConfig,
|
|
294
|
+
{ policy: context.safety.policy, legacyShell: false },
|
|
295
|
+
sessionFile,
|
|
296
|
+
);
|
|
297
|
+
return { wrapperPath, logFile };
|
|
298
|
+
}
|
|
299
|
+
|
|
300
|
+
const wrapperPath = await writeBashWrapper({
|
|
301
|
+
sanitizedName: sanitized,
|
|
302
|
+
taskName,
|
|
303
|
+
promptFile,
|
|
304
|
+
timeoutSeconds,
|
|
305
|
+
lockFile,
|
|
306
|
+
workdir: context.cwd,
|
|
307
|
+
logFile,
|
|
308
|
+
recorderFile: recorderPath(),
|
|
309
|
+
qualityGate: spec.gate,
|
|
310
|
+
model: spec.model,
|
|
311
|
+
policy: context.safety.policy,
|
|
312
|
+
allowedTools: spec.allowedTools,
|
|
313
|
+
deniedTools: spec.deniedTools,
|
|
314
|
+
sessionMode,
|
|
315
|
+
sessionId,
|
|
316
|
+
sessionFile,
|
|
317
|
+
gateTimeoutSeconds: spec.gateTimeoutSeconds,
|
|
318
|
+
});
|
|
319
|
+
return { wrapperPath, logFile };
|
|
320
|
+
}
|
|
321
|
+
|
|
322
|
+
/** Прямой запуск обёртки: ОС-задача не создаётся, процесс ждём здесь. */
|
|
323
|
+
async function runWrapperProcess(
|
|
324
|
+
wrapperPath: string,
|
|
325
|
+
cwd: string,
|
|
326
|
+
timeoutSeconds: number,
|
|
327
|
+
): Promise<{ output: string; error: string | null }> {
|
|
328
|
+
const timeoutMs = (timeoutSeconds + 120) * 1000;
|
|
329
|
+
return new Promise((resolve) => {
|
|
330
|
+
const child =
|
|
331
|
+
process.platform === "win32"
|
|
332
|
+
? spawn(process.env.ComSpec ?? "cmd.exe", ["/d", "/s", "/c", `"${wrapperPath}"`], {
|
|
333
|
+
cwd,
|
|
334
|
+
windowsHide: true,
|
|
335
|
+
env: process.env,
|
|
336
|
+
})
|
|
337
|
+
: spawn("bash", [wrapperPath], {
|
|
338
|
+
cwd,
|
|
339
|
+
windowsHide: true,
|
|
340
|
+
env: process.env,
|
|
341
|
+
});
|
|
342
|
+
|
|
343
|
+
let stdout = "";
|
|
344
|
+
let stderr = "";
|
|
345
|
+
let settled = false;
|
|
346
|
+
const append = (target: "out" | "err", chunk: Buffer) => {
|
|
347
|
+
const text = chunk.toString("utf8");
|
|
348
|
+
if (target === "out") stdout = (stdout + text).slice(-200_000);
|
|
349
|
+
else stderr = (stderr + text).slice(-200_000);
|
|
350
|
+
};
|
|
351
|
+
child.stdout?.on("data", (chunk: Buffer) => append("out", chunk));
|
|
352
|
+
child.stderr?.on("data", (chunk: Buffer) => append("err", chunk));
|
|
353
|
+
|
|
354
|
+
const timer = setTimeout(() => {
|
|
355
|
+
if (settled) return;
|
|
356
|
+
settled = true;
|
|
357
|
+
child.kill("SIGKILL");
|
|
358
|
+
resolve({
|
|
359
|
+
output: stdout,
|
|
360
|
+
error: `Миссия превысила внешний таймаут ${timeoutSeconds + 120} с.`,
|
|
361
|
+
});
|
|
362
|
+
}, timeoutMs);
|
|
363
|
+
timer.unref?.();
|
|
364
|
+
|
|
365
|
+
const finish = (error: string | null) => {
|
|
366
|
+
if (settled) return;
|
|
367
|
+
settled = true;
|
|
368
|
+
clearTimeout(timer);
|
|
369
|
+
resolve({ output: [stdout.trim(), stderr.trim()].filter(Boolean).join("\n"), error });
|
|
370
|
+
};
|
|
371
|
+
|
|
372
|
+
child.on("error", (error) => finish(error.message));
|
|
373
|
+
child.on("close", (code, signal) => {
|
|
374
|
+
if (code === 0) {
|
|
375
|
+
finish(null);
|
|
376
|
+
return;
|
|
377
|
+
}
|
|
378
|
+
finish(
|
|
379
|
+
`Обёртка миссии завершилась с кодом ${code ?? "null"}${
|
|
380
|
+
signal ? ` (сигнал ${signal})` : ""
|
|
381
|
+
}.`,
|
|
382
|
+
);
|
|
383
|
+
});
|
|
384
|
+
});
|
|
385
|
+
}
|
|
386
|
+
|
|
387
|
+
function createWrapperExecutor(
|
|
388
|
+
wrapperPath: string,
|
|
389
|
+
spec: MissionSpec,
|
|
390
|
+
): StepExecutor {
|
|
391
|
+
return {
|
|
392
|
+
id: "mission-wrapper",
|
|
393
|
+
supports: (route) => route.executor !== null,
|
|
394
|
+
async execute() {
|
|
395
|
+
const { output, error } = await runWrapperProcess(
|
|
396
|
+
wrapperPath,
|
|
397
|
+
spec.cwd ?? process.cwd(),
|
|
398
|
+
spec.timeoutSeconds ?? DEFAULT_TIMEOUT_SECONDS,
|
|
399
|
+
);
|
|
400
|
+
return error ? { output, error } : { output };
|
|
401
|
+
},
|
|
402
|
+
};
|
|
403
|
+
}
|
|
404
|
+
|
|
405
|
+
/**
|
|
406
|
+
* AB-8: единая точка входа ad-hoc миссии для CLI, RPC и GUI.
|
|
407
|
+
*
|
|
408
|
+
* Инварианты EXECUTION-LOOP §2.1: нет записи в планировщике ОС, работают
|
|
409
|
+
* GATE, политика прав, ledger (`runs`/`run_steps`) и аудит; параллельные
|
|
410
|
+
* обычные миссии в одном workspace не допускаются.
|
|
411
|
+
*
|
|
412
|
+
* W-3 (контракт dryRun): `dryRun: true` строит план и описание, но не захватывает
|
|
413
|
+
* `activeWorkspaces` и не пишет ledger (`runs`/`run_steps`) — это контракт, а не
|
|
414
|
+
* утечка контекста. Поэтому несколько dry-run в одном `cwd` проходят параллельно.
|
|
415
|
+
*/
|
|
416
|
+
export async function runMission(
|
|
417
|
+
input: MissionSpec,
|
|
418
|
+
dependencies: MissionDependencies = {},
|
|
419
|
+
): Promise<MissionResult> {
|
|
420
|
+
const spec = normalizeMissionSpec(input);
|
|
421
|
+
const taskName = spec.taskName ?? newMissionName();
|
|
422
|
+
spec.taskName = taskName;
|
|
423
|
+
const context = createMissionContext(spec);
|
|
424
|
+
const plan = await buildExecutionPlan(context);
|
|
425
|
+
const description = describeExecutionPlan(plan);
|
|
426
|
+
|
|
427
|
+
if (spec.dryRun) {
|
|
428
|
+
dependencies.onPrepared?.({ taskName, cwd: context.cwd });
|
|
429
|
+
return {
|
|
430
|
+
success: true,
|
|
431
|
+
dryRun: true,
|
|
432
|
+
runId: null,
|
|
433
|
+
status: "planned",
|
|
434
|
+
plan,
|
|
435
|
+
description,
|
|
436
|
+
steps: [],
|
|
437
|
+
error: null,
|
|
438
|
+
logFile: null,
|
|
439
|
+
};
|
|
440
|
+
}
|
|
441
|
+
|
|
442
|
+
const workspaceKey = path.resolve(context.cwd);
|
|
443
|
+
const running = activeWorkspaces.get(workspaceKey);
|
|
444
|
+
if (running) {
|
|
445
|
+
throw new Error(
|
|
446
|
+
`В workspace ${workspaceKey} уже выполняется миссия "${running}". Дождитесь её завершения.`,
|
|
447
|
+
);
|
|
448
|
+
}
|
|
449
|
+
activeWorkspaces.set(workspaceKey, taskName);
|
|
450
|
+
|
|
451
|
+
try {
|
|
452
|
+
let executor = dependencies.executor;
|
|
453
|
+
let logFile: string | null = null;
|
|
454
|
+
if (!executor) {
|
|
455
|
+
const prepared = await prepareWrapper(spec, context, taskName);
|
|
456
|
+
logFile = prepared.logFile;
|
|
457
|
+
executor = createWrapperExecutor(prepared.wrapperPath, spec);
|
|
458
|
+
}
|
|
459
|
+
dependencies.onPrepared?.({ taskName, cwd: context.cwd });
|
|
460
|
+
|
|
461
|
+
const result = await executeExecutionPlan(plan, {
|
|
462
|
+
executors: [executor],
|
|
463
|
+
stopOnError: true,
|
|
464
|
+
metadata: {
|
|
465
|
+
adHoc: true,
|
|
466
|
+
gate: spec.gate ?? null,
|
|
467
|
+
timeoutSeconds: spec.timeoutSeconds ?? DEFAULT_TIMEOUT_SECONDS,
|
|
468
|
+
},
|
|
469
|
+
});
|
|
470
|
+
|
|
471
|
+
return {
|
|
472
|
+
success: result.status === "passed",
|
|
473
|
+
dryRun: false,
|
|
474
|
+
runId: result.runId,
|
|
475
|
+
status: result.status,
|
|
476
|
+
plan,
|
|
477
|
+
description,
|
|
478
|
+
steps: result.steps,
|
|
479
|
+
error: result.error,
|
|
480
|
+
logFile,
|
|
481
|
+
};
|
|
482
|
+
} finally {
|
|
483
|
+
activeWorkspaces.delete(workspaceKey);
|
|
484
|
+
}
|
|
485
|
+
}
|
|
@@ -0,0 +1,158 @@
|
|
|
1
|
+
import type { TaskDefinition } from "../task-transfer.js";
|
|
2
|
+
import type { PipelineSpec } from "./pipeline-spec.js";
|
|
3
|
+
import { pipelineSpecToTasks } from "./pipeline-map.js";
|
|
4
|
+
|
|
5
|
+
export interface PipelineApplyPlan {
|
|
6
|
+
/** Задачи, которых ещё нет в БД. */
|
|
7
|
+
creates: TaskDefinition[];
|
|
8
|
+
/** Задачи с изменённым определением. */
|
|
9
|
+
updates: { task: TaskDefinition; previous: TaskDefinition }[];
|
|
10
|
+
/** Задачи, определение не изменилось. */
|
|
11
|
+
unchanged: TaskDefinition[];
|
|
12
|
+
/** Задачи этого pipeline, которых больше нет в YAML (не удаляются автоматически). */
|
|
13
|
+
stale: TaskDefinition[];
|
|
14
|
+
warnings: string[];
|
|
15
|
+
}
|
|
16
|
+
|
|
17
|
+
export interface PipelineApplyResult {
|
|
18
|
+
created: number;
|
|
19
|
+
updated: number;
|
|
20
|
+
unchanged: number;
|
|
21
|
+
stale: number;
|
|
22
|
+
}
|
|
23
|
+
|
|
24
|
+
export interface PipelineApplyHandlers {
|
|
25
|
+
create(task: TaskDefinition): Promise<void> | void;
|
|
26
|
+
update(task: TaskDefinition): Promise<void> | void;
|
|
27
|
+
}
|
|
28
|
+
|
|
29
|
+
const SIGNATURE_FIELDS = [
|
|
30
|
+
"name",
|
|
31
|
+
"schedule",
|
|
32
|
+
"prompt",
|
|
33
|
+
"triggerType",
|
|
34
|
+
"dependsOn",
|
|
35
|
+
"model",
|
|
36
|
+
"priority",
|
|
37
|
+
"timeoutSeconds",
|
|
38
|
+
"workingDirectory",
|
|
39
|
+
"workspaceId",
|
|
40
|
+
"retryCount",
|
|
41
|
+
"retryDelay",
|
|
42
|
+
"qualityGate",
|
|
43
|
+
"beforeScript",
|
|
44
|
+
"afterScript",
|
|
45
|
+
"guards",
|
|
46
|
+
"allowedTools",
|
|
47
|
+
"deniedTools",
|
|
48
|
+
"matrix",
|
|
49
|
+
"timezone",
|
|
50
|
+
"notBefore",
|
|
51
|
+
"notAfter",
|
|
52
|
+
"activeDays",
|
|
53
|
+
"windowPolicy",
|
|
54
|
+
"runAt",
|
|
55
|
+
"pipelineName",
|
|
56
|
+
"pipelineStepId",
|
|
57
|
+
] as const;
|
|
58
|
+
|
|
59
|
+
function normalizeValue(value: unknown): unknown {
|
|
60
|
+
if (Array.isArray(value)) return value.map(normalizeValue);
|
|
61
|
+
if (value && typeof value === "object") {
|
|
62
|
+
const source = value as Record<string, unknown>;
|
|
63
|
+
const result: Record<string, unknown> = {};
|
|
64
|
+
for (const key of Object.keys(source).sort()) {
|
|
65
|
+
if (source[key] !== undefined) result[key] = normalizeValue(source[key]);
|
|
66
|
+
}
|
|
67
|
+
return result;
|
|
68
|
+
}
|
|
69
|
+
return value;
|
|
70
|
+
}
|
|
71
|
+
|
|
72
|
+
/** Стабильная подпись значимых полей задачи — для сравнения create/update/unchanged. */
|
|
73
|
+
export function pipelineTaskSignature(task: TaskDefinition): string {
|
|
74
|
+
const picked: Record<string, unknown> = {};
|
|
75
|
+
const source = task as unknown as Record<string, unknown>;
|
|
76
|
+
for (const field of SIGNATURE_FIELDS) {
|
|
77
|
+
if (source[field] !== undefined) picked[field] = normalizeValue(source[field]);
|
|
78
|
+
}
|
|
79
|
+
return JSON.stringify(picked);
|
|
80
|
+
}
|
|
81
|
+
|
|
82
|
+
function samePipeline(task: TaskDefinition, pipelineName: string): boolean {
|
|
83
|
+
return (
|
|
84
|
+
typeof task.pipelineName === "string" &&
|
|
85
|
+
task.pipelineName.toLowerCase() === pipelineName.toLowerCase()
|
|
86
|
+
);
|
|
87
|
+
}
|
|
88
|
+
|
|
89
|
+
/**
|
|
90
|
+
* Чистый diff: сравнивает желаемые задачи pipeline с существующими.
|
|
91
|
+
* Задачи без маркеров pipelineName/pipelineStepId не трогаются никогда.
|
|
92
|
+
*/
|
|
93
|
+
export function planPipelineApply(
|
|
94
|
+
spec: PipelineSpec,
|
|
95
|
+
existing: TaskDefinition[],
|
|
96
|
+
options: { resolveWorkspaceId?: (value: string) => string | undefined } = {},
|
|
97
|
+
): PipelineApplyPlan {
|
|
98
|
+
const mapped = pipelineSpecToTasks(spec, options);
|
|
99
|
+
const create: TaskDefinition[] = [];
|
|
100
|
+
const updates: { task: TaskDefinition; previous: TaskDefinition }[] = [];
|
|
101
|
+
const unchanged: TaskDefinition[] = [];
|
|
102
|
+
|
|
103
|
+
const byStep = new Map<string, TaskDefinition>();
|
|
104
|
+
for (const task of existing) {
|
|
105
|
+
if (!samePipeline(task, spec.name)) continue;
|
|
106
|
+
const stepId = task.pipelineStepId;
|
|
107
|
+
if (typeof stepId !== "string" || !stepId) continue;
|
|
108
|
+
byStep.set(stepId.toLowerCase(), task);
|
|
109
|
+
}
|
|
110
|
+
|
|
111
|
+
for (const task of mapped.tasks) {
|
|
112
|
+
const previous = byStep.get((task.pipelineStepId ?? "").toLowerCase());
|
|
113
|
+
if (!previous) {
|
|
114
|
+
create.push(task);
|
|
115
|
+
continue;
|
|
116
|
+
}
|
|
117
|
+
if (pipelineTaskSignature(previous) === pipelineTaskSignature(task)) {
|
|
118
|
+
unchanged.push(task);
|
|
119
|
+
} else {
|
|
120
|
+
updates.push({ task, previous });
|
|
121
|
+
}
|
|
122
|
+
byStep.delete((task.pipelineStepId ?? "").toLowerCase());
|
|
123
|
+
}
|
|
124
|
+
|
|
125
|
+
const stale = [...byStep.values()];
|
|
126
|
+
const warnings = [...mapped.warnings];
|
|
127
|
+
if (stale.length > 0) {
|
|
128
|
+
warnings.push(
|
|
129
|
+
`В YAML больше нет шагов: ${stale.map((task) => task.name).join(", ")}. ` +
|
|
130
|
+
"Они не удалены автоматически — удалите вручную или верните шаг.",
|
|
131
|
+
);
|
|
132
|
+
}
|
|
133
|
+
|
|
134
|
+
return { creates: create, updates, unchanged, stale, warnings };
|
|
135
|
+
}
|
|
136
|
+
|
|
137
|
+
/** Применяет план через переданные обработчики (БД/планировщик) и считает итог. */
|
|
138
|
+
export async function executePipelineApply(
|
|
139
|
+
plan: PipelineApplyPlan,
|
|
140
|
+
handlers: PipelineApplyHandlers,
|
|
141
|
+
): Promise<PipelineApplyResult> {
|
|
142
|
+
let created = 0;
|
|
143
|
+
for (const task of plan.creates) {
|
|
144
|
+
await handlers.create(task);
|
|
145
|
+
created += 1;
|
|
146
|
+
}
|
|
147
|
+
let updated = 0;
|
|
148
|
+
for (const entry of plan.updates) {
|
|
149
|
+
await handlers.update(entry.task);
|
|
150
|
+
updated += 1;
|
|
151
|
+
}
|
|
152
|
+
return {
|
|
153
|
+
created,
|
|
154
|
+
updated,
|
|
155
|
+
unchanged: plan.unchanged.length,
|
|
156
|
+
stale: plan.stale.length,
|
|
157
|
+
};
|
|
158
|
+
}
|