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.
Files changed (190) hide show
  1. package/CHANGELOG.md +134 -2
  2. package/CROSS_PLATFORM.md +19 -0
  3. package/README.md +52 -7
  4. package/ROADMAP-STRATEGY.md +21 -18
  5. package/ROADMAP.md +140 -159
  6. package/dist/cli.d.ts +3 -0
  7. package/dist/cli.d.ts.map +1 -0
  8. package/dist/cli.js +351 -0
  9. package/dist/core/execution.d.ts +203 -0
  10. package/dist/core/execution.d.ts.map +1 -0
  11. package/dist/core/execution.js +309 -0
  12. package/dist/core/gate-integrity.d.ts +35 -0
  13. package/dist/core/gate-integrity.d.ts.map +1 -0
  14. package/dist/core/gate-integrity.js +132 -0
  15. package/dist/core/git-trigger.d.ts.map +1 -1
  16. package/dist/core/git-trigger.js +14 -2
  17. package/dist/core/guard-run.d.ts +4 -0
  18. package/dist/core/guard-run.d.ts.map +1 -0
  19. package/dist/core/guard-run.js +101 -0
  20. package/dist/core/guard.d.ts +52 -0
  21. package/dist/core/guard.d.ts.map +1 -0
  22. package/dist/core/guard.js +362 -0
  23. package/dist/core/lock.d.ts +41 -0
  24. package/dist/core/lock.d.ts.map +1 -1
  25. package/dist/core/lock.js +141 -29
  26. package/dist/core/matrix.d.ts.map +1 -1
  27. package/dist/core/matrix.js +75 -15
  28. package/dist/core/mission.d.ts +83 -0
  29. package/dist/core/mission.d.ts.map +1 -0
  30. package/dist/core/mission.js +334 -0
  31. package/dist/core/pipeline-apply.d.ts +38 -0
  32. package/dist/core/pipeline-apply.d.ts.map +1 -0
  33. package/dist/core/pipeline-apply.js +117 -0
  34. package/dist/core/pipeline-io.d.ts +13 -0
  35. package/dist/core/pipeline-io.d.ts.map +1 -0
  36. package/dist/core/pipeline-io.js +64 -0
  37. package/dist/core/pipeline-map.d.ts +46 -0
  38. package/dist/core/pipeline-map.d.ts.map +1 -0
  39. package/dist/core/pipeline-map.js +196 -0
  40. package/dist/core/pipeline-spec.d.ts +109 -0
  41. package/dist/core/pipeline-spec.d.ts.map +1 -0
  42. package/dist/core/pipeline-spec.js +554 -0
  43. package/dist/core/ps-wrapper.d.ts +19 -2
  44. package/dist/core/ps-wrapper.d.ts.map +1 -1
  45. package/dist/core/ps-wrapper.js +250 -62
  46. package/dist/core/record-history.d.ts.map +1 -1
  47. package/dist/core/record-history.js +130 -29
  48. package/dist/core/router/rules.d.ts.map +1 -1
  49. package/dist/core/router/rules.js +6 -0
  50. package/dist/core/scheduler/linux.d.ts +8 -1
  51. package/dist/core/scheduler/linux.d.ts.map +1 -1
  52. package/dist/core/scheduler/linux.js +34 -9
  53. package/dist/core/scheduler/mac.d.ts +44 -2
  54. package/dist/core/scheduler/mac.d.ts.map +1 -1
  55. package/dist/core/scheduler/mac.js +126 -15
  56. package/dist/core/scheduler/windows.d.ts.map +1 -1
  57. package/dist/core/scheduler/windows.js +15 -12
  58. package/dist/core/structured-log.d.ts +7 -1
  59. package/dist/core/structured-log.d.ts.map +1 -1
  60. package/dist/core/worktree-run.d.ts +4 -0
  61. package/dist/core/worktree-run.d.ts.map +1 -0
  62. package/dist/core/worktree-run.js +164 -0
  63. package/dist/core/worktree.d.ts +115 -0
  64. package/dist/core/worktree.d.ts.map +1 -0
  65. package/dist/core/worktree.js +462 -0
  66. package/dist/core/wrappers/bash.d.ts +17 -0
  67. package/dist/core/wrappers/bash.d.ts.map +1 -1
  68. package/dist/core/wrappers/bash.js +175 -24
  69. package/dist/db/capability-repo.d.ts +43 -2
  70. package/dist/db/capability-repo.d.ts.map +1 -1
  71. package/dist/db/capability-repo.js +96 -11
  72. package/dist/db/history-repo.d.ts +38 -5
  73. package/dist/db/history-repo.d.ts.map +1 -1
  74. package/dist/db/history-repo.js +88 -25
  75. package/dist/db/metrics-repo.js +2 -2
  76. package/dist/db/recovery.d.ts.map +1 -1
  77. package/dist/db/recovery.js +5 -4
  78. package/dist/db/run-journal.d.ts +33 -5
  79. package/dist/db/run-journal.d.ts.map +1 -1
  80. package/dist/db/run-journal.js +78 -14
  81. package/dist/db/run-resume.d.ts +5 -0
  82. package/dist/db/run-resume.d.ts.map +1 -1
  83. package/dist/db/run-resume.js +9 -2
  84. package/dist/db/runs-repo.d.ts +19 -2
  85. package/dist/db/runs-repo.d.ts.map +1 -1
  86. package/dist/db/runs-repo.js +22 -6
  87. package/dist/db/schema.d.ts +2 -2
  88. package/dist/db/schema.d.ts.map +1 -1
  89. package/dist/db/schema.js +63 -2
  90. package/dist/history.d.ts +1 -1
  91. package/dist/history.d.ts.map +1 -1
  92. package/dist/i18n.d.ts +5 -0
  93. package/dist/i18n.d.ts.map +1 -1
  94. package/dist/i18n.js +11 -4
  95. package/dist/index.d.ts +136 -2
  96. package/dist/index.d.ts.map +1 -1
  97. package/dist/index.js +378 -14
  98. package/dist/notifications.d.ts +22 -0
  99. package/dist/notifications.d.ts.map +1 -1
  100. package/dist/notifications.js +36 -8
  101. package/dist/profiles.d.ts.map +1 -1
  102. package/dist/profiles.js +25 -4
  103. package/dist/rpc.d.ts +246 -0
  104. package/dist/rpc.d.ts.map +1 -1
  105. package/dist/rpc.js +117 -0
  106. package/dist/server.d.ts +15 -0
  107. package/dist/server.d.ts.map +1 -1
  108. package/dist/server.js +77 -18
  109. package/dist/settings.d.ts +2 -2
  110. package/dist/settings.d.ts.map +1 -1
  111. package/dist/settings.js +3 -3
  112. package/dist/shared/jobs-view.d.ts +1 -1
  113. package/dist/shared/jobs-view.d.ts.map +1 -1
  114. package/dist/shared/jobs-view.js +2 -0
  115. package/dist/task-transfer.d.ts +16 -0
  116. package/dist/task-transfer.d.ts.map +1 -1
  117. package/dist/task-transfer.js +16 -0
  118. package/docs/ARCHITECTURE.md +281 -65
  119. package/docs/COMPATIBILITY.md +2 -2
  120. package/docs/CONCEPT.md +18 -4
  121. package/docs/CROSS_PLATFORM.ru.md +20 -0
  122. package/docs/CROSS_PLATFORM.zh.md +18 -0
  123. package/docs/EXECUTION-LOOP.md +22 -7
  124. package/docs/FEATURES.md +65 -4
  125. package/docs/FEATURES.zh.md +52 -4
  126. package/docs/MIGRATION.md +2 -2
  127. package/docs/PIPELINE.md +293 -0
  128. package/docs/README.ru.md +42 -3
  129. package/docs/README.zh.md +43 -3
  130. package/docs/SAFETY.md +23 -3
  131. package/gui-experimental.cjs +9 -8
  132. package/locales/en.json +17 -1
  133. package/locales/ru.json +17 -1
  134. package/locales/zh.json +17 -1
  135. package/opencode.pipeline.yaml +35 -0
  136. package/package.json +23 -4
  137. package/scripts/test-home.mjs +83 -0
  138. package/src/cli.ts +412 -0
  139. package/src/core/dry-run.ts +2 -2
  140. package/src/core/execution.ts +538 -0
  141. package/src/core/file-watcher.ts +2 -2
  142. package/src/core/gate-integrity.ts +160 -0
  143. package/src/core/git-trigger.ts +18 -5
  144. package/src/core/guard-run.ts +119 -0
  145. package/src/core/guard.ts +431 -0
  146. package/src/core/lock.ts +178 -37
  147. package/src/core/matrix.ts +95 -50
  148. package/src/core/mission.ts +485 -0
  149. package/src/core/native-notify.ts +1 -1
  150. package/src/core/pipeline-apply.ts +158 -0
  151. package/src/core/pipeline-io.ts +79 -0
  152. package/src/core/pipeline-map.ts +264 -0
  153. package/src/core/pipeline-spec.ts +775 -0
  154. package/src/core/ps-wrapper.ts +263 -63
  155. package/src/core/record-history.ts +164 -77
  156. package/src/core/router/rules.ts +6 -0
  157. package/src/core/schedule-gate.ts +1 -1
  158. package/src/core/scheduler/at-fallback.ts +1 -1
  159. package/src/core/scheduler/linux.ts +40 -11
  160. package/src/core/scheduler/logs.ts +2 -2
  161. package/src/core/scheduler/mac.ts +174 -14
  162. package/src/core/scheduler/registry.ts +2 -2
  163. package/src/core/scheduler/windows.ts +19 -15
  164. package/src/core/secrets.ts +8 -8
  165. package/src/core/structured-log.ts +22 -5
  166. package/src/core/telegram.ts +2 -2
  167. package/src/core/triage-worker.ts +7 -7
  168. package/src/core/triage.ts +2 -2
  169. package/src/core/worktree-run.ts +199 -0
  170. package/src/core/worktree.ts +600 -0
  171. package/src/core/wrappers/bash.ts +190 -23
  172. package/src/db/capability-repo.ts +127 -10
  173. package/src/db/history-repo.ts +129 -22
  174. package/src/db/metrics-repo.ts +2 -2
  175. package/src/db/recovery.ts +5 -4
  176. package/src/db/run-journal.ts +100 -13
  177. package/src/db/run-resume.ts +17 -1
  178. package/src/db/runs-repo.ts +36 -6
  179. package/src/db/schema.ts +65 -2
  180. package/src/gui.tsx +177 -13
  181. package/src/history.ts +1 -1
  182. package/src/i18n.ts +12 -4
  183. package/src/index.ts +524 -4
  184. package/src/notifications.ts +38 -8
  185. package/src/profiles.ts +26 -4
  186. package/src/rpc.ts +128 -0
  187. package/src/server.ts +94 -18
  188. package/src/settings.ts +5 -5
  189. package/src/shared/jobs-view.ts +3 -1
  190. package/src/task-transfer.ts +31 -0
@@ -0,0 +1,334 @@
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 { spawn } from "node:child_process";
11
+ import crypto from "node:crypto";
12
+ import fs from "node:fs/promises";
13
+ import { createRequire } from "node:module";
14
+ import path from "node:path";
15
+ import { LOG_DIR, sanitizeName } from "../types.js";
16
+ import { buildExecutionPlan, createAdHocRunContext, describeExecutionPlan, executeExecutionPlan, } from "./execution.js";
17
+ import { buildOpencodeConfig } from "./permissions.js";
18
+ import { ensureWrapper, lockFilePath, writePromptFile, writeWrapperCmd, } from "./ps-wrapper.js";
19
+ import { generateSessionId, normalizeSessionMode, sessionStatePath, writeSessionStateFile, } from "./session.js";
20
+ import { writeBashWrapper } from "./wrappers/bash.js";
21
+ const DEFAULT_TIMEOUT_SECONDS = 3600;
22
+ const MAX_TIMEOUT_SECONDS = 24 * 60 * 60;
23
+ /** Активные ad-hoc миссии по workspace — защита от двух миссий в одном репо. */
24
+ const activeWorkspaces = new Map();
25
+ const requireFromCore = createRequire(import.meta.url);
26
+ /** Путь к скомпилированному record-history.js (как в index.ts). */
27
+ function recorderPath() {
28
+ const resolved = requireFromCore.resolve("./record-history.js");
29
+ if (!resolved.endsWith(".ts"))
30
+ return resolved;
31
+ return resolved
32
+ .replace(/([\\/])src([\\/])/, "$1dist$2")
33
+ .replace(/\.ts$/, ".js");
34
+ }
35
+ function assertNonEmpty(value, label) {
36
+ if (typeof value !== "string" || value.trim() === "") {
37
+ throw new Error(`Пустое поле миссии: ${label}.`);
38
+ }
39
+ return value.trim();
40
+ }
41
+ function positiveInt(value, label, fallback) {
42
+ if (value === undefined || value === null)
43
+ return fallback;
44
+ if (typeof value !== "number" || !Number.isInteger(value) || value <= 0) {
45
+ throw new Error(`Поле миссии "${label}" должно быть целым положительным числом.`);
46
+ }
47
+ return Math.min(value, MAX_TIMEOUT_SECONDS);
48
+ }
49
+ function normalizeTools(value, label) {
50
+ if (value === undefined)
51
+ return undefined;
52
+ if (!Array.isArray(value)) {
53
+ throw new Error(`Поле миссии "${label}" должно быть массивом строк.`);
54
+ }
55
+ const list = value
56
+ .filter((item) => typeof item === "string")
57
+ .map((item) => item.trim())
58
+ .filter(Boolean);
59
+ return list.length > 0 ? list : undefined;
60
+ }
61
+ function newMissionName() {
62
+ const stamp = Date.now().toString(36);
63
+ const random = crypto.randomBytes(4).toString("hex");
64
+ return `ad-hoc-${stamp}-${random}`;
65
+ }
66
+ /**
67
+ * AB-8.1: валидирует и нормализует вход. Возвращает безопасную копию спеки,
68
+ * чтобы CLI/RPC/GUI не могли передать нестроковые поля в обёртку.
69
+ */
70
+ export function normalizeMissionSpec(input) {
71
+ if (!input || typeof input !== "object") {
72
+ throw new Error("Спецификация миссии должна быть объектом.");
73
+ }
74
+ const prompt = assertNonEmpty(input.prompt, "prompt");
75
+ const cwd = input.cwd?.trim() ? path.resolve(input.cwd.trim()) : process.cwd();
76
+ const taskName = input.taskName?.trim() ? input.taskName.trim() : undefined;
77
+ if (taskName && taskName.length > 200) {
78
+ throw new Error("Имя миссии длиннее 200 символов.");
79
+ }
80
+ const session = normalizeSessionMode(input.session);
81
+ if (!session) {
82
+ throw new Error('Поле "session" должно быть new, reuse или last.');
83
+ }
84
+ if (session === "reuse" && input.sessionId !== undefined && !/^ses_[A-Za-z0-9]{10,64}$/.test(input.sessionId)) {
85
+ throw new Error('Поле "sessionId" должно иметь формат ses_<id>.');
86
+ }
87
+ const policy = input.policy ?? "hybrid";
88
+ if (policy !== "hybrid" && policy !== "secure" && policy !== "legacy") {
89
+ throw new Error('Поле "policy" должно быть hybrid, secure или legacy.');
90
+ }
91
+ const allowedTools = normalizeTools(input.allowedTools, "allowedTools");
92
+ const deniedTools = normalizeTools(input.deniedTools, "deniedTools");
93
+ const denied = new Set((deniedTools ?? []).map((tool) => tool.toLowerCase()));
94
+ const conflict = (allowedTools ?? []).find((tool) => denied.has(tool.toLowerCase()));
95
+ if (conflict) {
96
+ throw new Error(`Инструмент "${conflict}" одновременно разрешён и запрещён.`);
97
+ }
98
+ return {
99
+ prompt,
100
+ cwd,
101
+ taskName,
102
+ taskType: input.taskType?.trim() || undefined,
103
+ model: input.model?.trim() || undefined,
104
+ session,
105
+ sessionId: input.sessionId?.trim() || undefined,
106
+ timeoutSeconds: positiveInt(input.timeoutSeconds, "timeoutSeconds", DEFAULT_TIMEOUT_SECONDS),
107
+ gate: input.gate?.trim() || undefined,
108
+ gateTimeoutSeconds: input.gateTimeoutSeconds === undefined
109
+ ? undefined
110
+ : positiveInt(input.gateTimeoutSeconds, "gateTimeoutSeconds", 300),
111
+ policy,
112
+ allowedTools,
113
+ deniedTools,
114
+ dryRun: input.dryRun === true,
115
+ };
116
+ }
117
+ /** Создаёт RunContext ad-hoc миссии (без task definition). */
118
+ export function createMissionContext(spec) {
119
+ return createAdHocRunContext(spec.prompt, {
120
+ cwd: spec.cwd,
121
+ taskName: spec.taskName,
122
+ taskType: spec.taskType ?? "mission",
123
+ policy: spec.policy ?? "hybrid",
124
+ profile: {
125
+ model: spec.model,
126
+ session: spec.session ?? "new",
127
+ sessionId: spec.sessionId,
128
+ },
129
+ safety: {
130
+ policy: spec.policy ?? "hybrid",
131
+ allowedTools: spec.allowedTools,
132
+ deniedTools: spec.deniedTools,
133
+ },
134
+ metadata: {
135
+ mission: true,
136
+ gate: spec.gate ?? null,
137
+ timeoutSeconds: spec.timeoutSeconds ?? DEFAULT_TIMEOUT_SECONDS,
138
+ },
139
+ });
140
+ }
141
+ /** Готовит обёртку с lock/таймаутом/политикой/Quality Gate, но без ОС. */
142
+ async function prepareWrapper(spec, context, taskName) {
143
+ const sanitized = sanitizeName(taskName);
144
+ const logFile = path.join(LOG_DIR, `${sanitized}.log`);
145
+ const promptFile = await writePromptFile(taskName, spec.prompt);
146
+ await fs.mkdir(LOG_DIR, { recursive: true });
147
+ try {
148
+ await fs.writeFile(logFile, "", "utf8");
149
+ }
150
+ catch (error) {
151
+ // Обёртки пишут лог через >> и создают файл сами: предварительная очистка
152
+ // нужна только чтобы убрать лог прошлого прогона. Не срываем миссию из-за
153
+ // прав доступа к каталогу логов.
154
+ console.warn(`[agent-steward] Не удалось очистить лог миссии (${logFile}): ${error instanceof Error ? error.message : String(error)}`);
155
+ }
156
+ const lockFile = lockFilePath(taskName);
157
+ const sessionMode = spec.session ?? "new";
158
+ let sessionId = spec.sessionId;
159
+ if (sessionMode === "reuse" && !sessionId) {
160
+ sessionId = generateSessionId();
161
+ }
162
+ if (sessionMode === "reuse") {
163
+ await writeSessionStateFile(taskName, sessionId);
164
+ }
165
+ const sessionFile = sessionMode === "reuse" ? sessionStatePath(taskName) : undefined;
166
+ const timeoutSeconds = spec.timeoutSeconds ?? DEFAULT_TIMEOUT_SECONDS;
167
+ if (process.platform === "win32") {
168
+ const permissionsConfig = buildOpencodeConfig({
169
+ policy: context.safety.policy,
170
+ allowedTools: spec.allowedTools,
171
+ deniedTools: spec.deniedTools,
172
+ });
173
+ await ensureWrapper();
174
+ const wrapperPath = await writeWrapperCmd(sanitized, taskName, promptFile, timeoutSeconds, lockFile, context.cwd, logFile, recorderPath(), spec.gate, spec.model, undefined, undefined, undefined, spec.allowedTools, spec.deniedTools, undefined, undefined, sessionMode, sessionId, spec.gateTimeoutSeconds, permissionsConfig, { policy: context.safety.policy, legacyShell: false }, sessionFile);
175
+ return { wrapperPath, logFile };
176
+ }
177
+ const wrapperPath = await writeBashWrapper({
178
+ sanitizedName: sanitized,
179
+ taskName,
180
+ promptFile,
181
+ timeoutSeconds,
182
+ lockFile,
183
+ workdir: context.cwd,
184
+ logFile,
185
+ recorderFile: recorderPath(),
186
+ qualityGate: spec.gate,
187
+ model: spec.model,
188
+ policy: context.safety.policy,
189
+ allowedTools: spec.allowedTools,
190
+ deniedTools: spec.deniedTools,
191
+ sessionMode,
192
+ sessionId,
193
+ sessionFile,
194
+ gateTimeoutSeconds: spec.gateTimeoutSeconds,
195
+ });
196
+ return { wrapperPath, logFile };
197
+ }
198
+ /** Прямой запуск обёртки: ОС-задача не создаётся, процесс ждём здесь. */
199
+ async function runWrapperProcess(wrapperPath, cwd, timeoutSeconds) {
200
+ const timeoutMs = (timeoutSeconds + 120) * 1000;
201
+ return new Promise((resolve) => {
202
+ const child = process.platform === "win32"
203
+ ? spawn(process.env.ComSpec ?? "cmd.exe", ["/d", "/s", "/c", `"${wrapperPath}"`], {
204
+ cwd,
205
+ windowsHide: true,
206
+ env: process.env,
207
+ })
208
+ : spawn("bash", [wrapperPath], {
209
+ cwd,
210
+ windowsHide: true,
211
+ env: process.env,
212
+ });
213
+ let stdout = "";
214
+ let stderr = "";
215
+ let settled = false;
216
+ const append = (target, chunk) => {
217
+ const text = chunk.toString("utf8");
218
+ if (target === "out")
219
+ stdout = (stdout + text).slice(-200000);
220
+ else
221
+ stderr = (stderr + text).slice(-200000);
222
+ };
223
+ child.stdout?.on("data", (chunk) => append("out", chunk));
224
+ child.stderr?.on("data", (chunk) => append("err", chunk));
225
+ const timer = setTimeout(() => {
226
+ if (settled)
227
+ return;
228
+ settled = true;
229
+ child.kill("SIGKILL");
230
+ resolve({
231
+ output: stdout,
232
+ error: `Миссия превысила внешний таймаут ${timeoutSeconds + 120} с.`,
233
+ });
234
+ }, timeoutMs);
235
+ timer.unref?.();
236
+ const finish = (error) => {
237
+ if (settled)
238
+ return;
239
+ settled = true;
240
+ clearTimeout(timer);
241
+ resolve({ output: [stdout.trim(), stderr.trim()].filter(Boolean).join("\n"), error });
242
+ };
243
+ child.on("error", (error) => finish(error.message));
244
+ child.on("close", (code, signal) => {
245
+ if (code === 0) {
246
+ finish(null);
247
+ return;
248
+ }
249
+ finish(`Обёртка миссии завершилась с кодом ${code ?? "null"}${signal ? ` (сигнал ${signal})` : ""}.`);
250
+ });
251
+ });
252
+ }
253
+ function createWrapperExecutor(wrapperPath, spec) {
254
+ return {
255
+ id: "mission-wrapper",
256
+ supports: (route) => route.executor !== null,
257
+ async execute() {
258
+ const { output, error } = await runWrapperProcess(wrapperPath, spec.cwd ?? process.cwd(), spec.timeoutSeconds ?? DEFAULT_TIMEOUT_SECONDS);
259
+ return error ? { output, error } : { output };
260
+ },
261
+ };
262
+ }
263
+ /**
264
+ * AB-8: единая точка входа ad-hoc миссии для CLI, RPC и GUI.
265
+ *
266
+ * Инварианты EXECUTION-LOOP §2.1: нет записи в планировщике ОС, работают
267
+ * GATE, политика прав, ledger (`runs`/`run_steps`) и аудит; параллельные
268
+ * обычные миссии в одном workspace не допускаются.
269
+ *
270
+ * W-3 (контракт dryRun): `dryRun: true` строит план и описание, но не захватывает
271
+ * `activeWorkspaces` и не пишет ledger (`runs`/`run_steps`) — это контракт, а не
272
+ * утечка контекста. Поэтому несколько dry-run в одном `cwd` проходят параллельно.
273
+ */
274
+ export async function runMission(input, dependencies = {}) {
275
+ const spec = normalizeMissionSpec(input);
276
+ const taskName = spec.taskName ?? newMissionName();
277
+ spec.taskName = taskName;
278
+ const context = createMissionContext(spec);
279
+ const plan = await buildExecutionPlan(context);
280
+ const description = describeExecutionPlan(plan);
281
+ if (spec.dryRun) {
282
+ dependencies.onPrepared?.({ taskName, cwd: context.cwd });
283
+ return {
284
+ success: true,
285
+ dryRun: true,
286
+ runId: null,
287
+ status: "planned",
288
+ plan,
289
+ description,
290
+ steps: [],
291
+ error: null,
292
+ logFile: null,
293
+ };
294
+ }
295
+ const workspaceKey = path.resolve(context.cwd);
296
+ const running = activeWorkspaces.get(workspaceKey);
297
+ if (running) {
298
+ throw new Error(`В workspace ${workspaceKey} уже выполняется миссия "${running}". Дождитесь её завершения.`);
299
+ }
300
+ activeWorkspaces.set(workspaceKey, taskName);
301
+ try {
302
+ let executor = dependencies.executor;
303
+ let logFile = null;
304
+ if (!executor) {
305
+ const prepared = await prepareWrapper(spec, context, taskName);
306
+ logFile = prepared.logFile;
307
+ executor = createWrapperExecutor(prepared.wrapperPath, spec);
308
+ }
309
+ dependencies.onPrepared?.({ taskName, cwd: context.cwd });
310
+ const result = await executeExecutionPlan(plan, {
311
+ executors: [executor],
312
+ stopOnError: true,
313
+ metadata: {
314
+ adHoc: true,
315
+ gate: spec.gate ?? null,
316
+ timeoutSeconds: spec.timeoutSeconds ?? DEFAULT_TIMEOUT_SECONDS,
317
+ },
318
+ });
319
+ return {
320
+ success: result.status === "passed",
321
+ dryRun: false,
322
+ runId: result.runId,
323
+ status: result.status,
324
+ plan,
325
+ description,
326
+ steps: result.steps,
327
+ error: result.error,
328
+ logFile,
329
+ };
330
+ }
331
+ finally {
332
+ activeWorkspaces.delete(workspaceKey);
333
+ }
334
+ }
@@ -0,0 +1,38 @@
1
+ import type { TaskDefinition } from "../task-transfer.js";
2
+ import type { PipelineSpec } from "./pipeline-spec.js";
3
+ export interface PipelineApplyPlan {
4
+ /** Задачи, которых ещё нет в БД. */
5
+ creates: TaskDefinition[];
6
+ /** Задачи с изменённым определением. */
7
+ updates: {
8
+ task: TaskDefinition;
9
+ previous: TaskDefinition;
10
+ }[];
11
+ /** Задачи, определение не изменилось. */
12
+ unchanged: TaskDefinition[];
13
+ /** Задачи этого pipeline, которых больше нет в YAML (не удаляются автоматически). */
14
+ stale: TaskDefinition[];
15
+ warnings: string[];
16
+ }
17
+ export interface PipelineApplyResult {
18
+ created: number;
19
+ updated: number;
20
+ unchanged: number;
21
+ stale: number;
22
+ }
23
+ export interface PipelineApplyHandlers {
24
+ create(task: TaskDefinition): Promise<void> | void;
25
+ update(task: TaskDefinition): Promise<void> | void;
26
+ }
27
+ /** Стабильная подпись значимых полей задачи — для сравнения create/update/unchanged. */
28
+ export declare function pipelineTaskSignature(task: TaskDefinition): string;
29
+ /**
30
+ * Чистый diff: сравнивает желаемые задачи pipeline с существующими.
31
+ * Задачи без маркеров pipelineName/pipelineStepId не трогаются никогда.
32
+ */
33
+ export declare function planPipelineApply(spec: PipelineSpec, existing: TaskDefinition[], options?: {
34
+ resolveWorkspaceId?: (value: string) => string | undefined;
35
+ }): PipelineApplyPlan;
36
+ /** Применяет план через переданные обработчики (БД/планировщик) и считает итог. */
37
+ export declare function executePipelineApply(plan: PipelineApplyPlan, handlers: PipelineApplyHandlers): Promise<PipelineApplyResult>;
38
+ //# sourceMappingURL=pipeline-apply.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"pipeline-apply.d.ts","sourceRoot":"","sources":["../../src/core/pipeline-apply.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAC1D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAGvD,MAAM,WAAW,iBAAiB;IAChC,oCAAoC;IACpC,OAAO,EAAE,cAAc,EAAE,CAAC;IAC1B,wCAAwC;IACxC,OAAO,EAAE;QAAE,IAAI,EAAE,cAAc,CAAC;QAAC,QAAQ,EAAE,cAAc,CAAA;KAAE,EAAE,CAAC;IAC9D,yCAAyC;IACzC,SAAS,EAAE,cAAc,EAAE,CAAC;IAC5B,qFAAqF;IACrF,KAAK,EAAE,cAAc,EAAE,CAAC;IACxB,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,qBAAqB;IACpC,MAAM,CAAC,IAAI,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;IACnD,MAAM,CAAC,IAAI,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;CACpD;AA6CD,wFAAwF;AACxF,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,cAAc,GAAG,MAAM,CAOlE;AASD;;;GAGG;AACH,wBAAgB,iBAAiB,CAC/B,IAAI,EAAE,YAAY,EAClB,QAAQ,EAAE,cAAc,EAAE,EAC1B,OAAO,GAAE;IAAE,kBAAkB,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM,GAAG,SAAS,CAAA;CAAO,GAC3E,iBAAiB,CAsCnB;AAED,mFAAmF;AACnF,wBAAsB,oBAAoB,CACxC,IAAI,EAAE,iBAAiB,EACvB,QAAQ,EAAE,qBAAqB,GAC9B,OAAO,CAAC,mBAAmB,CAAC,CAiB9B"}
@@ -0,0 +1,117 @@
1
+ import { pipelineSpecToTasks } from "./pipeline-map.js";
2
+ const SIGNATURE_FIELDS = [
3
+ "name",
4
+ "schedule",
5
+ "prompt",
6
+ "triggerType",
7
+ "dependsOn",
8
+ "model",
9
+ "priority",
10
+ "timeoutSeconds",
11
+ "workingDirectory",
12
+ "workspaceId",
13
+ "retryCount",
14
+ "retryDelay",
15
+ "qualityGate",
16
+ "beforeScript",
17
+ "afterScript",
18
+ "guards",
19
+ "allowedTools",
20
+ "deniedTools",
21
+ "matrix",
22
+ "timezone",
23
+ "notBefore",
24
+ "notAfter",
25
+ "activeDays",
26
+ "windowPolicy",
27
+ "runAt",
28
+ "pipelineName",
29
+ "pipelineStepId",
30
+ ];
31
+ function normalizeValue(value) {
32
+ if (Array.isArray(value))
33
+ return value.map(normalizeValue);
34
+ if (value && typeof value === "object") {
35
+ const source = value;
36
+ const result = {};
37
+ for (const key of Object.keys(source).sort()) {
38
+ if (source[key] !== undefined)
39
+ result[key] = normalizeValue(source[key]);
40
+ }
41
+ return result;
42
+ }
43
+ return value;
44
+ }
45
+ /** Стабильная подпись значимых полей задачи — для сравнения create/update/unchanged. */
46
+ export function pipelineTaskSignature(task) {
47
+ const picked = {};
48
+ const source = task;
49
+ for (const field of SIGNATURE_FIELDS) {
50
+ if (source[field] !== undefined)
51
+ picked[field] = normalizeValue(source[field]);
52
+ }
53
+ return JSON.stringify(picked);
54
+ }
55
+ function samePipeline(task, pipelineName) {
56
+ return (typeof task.pipelineName === "string" &&
57
+ task.pipelineName.toLowerCase() === pipelineName.toLowerCase());
58
+ }
59
+ /**
60
+ * Чистый diff: сравнивает желаемые задачи pipeline с существующими.
61
+ * Задачи без маркеров pipelineName/pipelineStepId не трогаются никогда.
62
+ */
63
+ export function planPipelineApply(spec, existing, options = {}) {
64
+ const mapped = pipelineSpecToTasks(spec, options);
65
+ const create = [];
66
+ const updates = [];
67
+ const unchanged = [];
68
+ const byStep = new Map();
69
+ for (const task of existing) {
70
+ if (!samePipeline(task, spec.name))
71
+ continue;
72
+ const stepId = task.pipelineStepId;
73
+ if (typeof stepId !== "string" || !stepId)
74
+ continue;
75
+ byStep.set(stepId.toLowerCase(), task);
76
+ }
77
+ for (const task of mapped.tasks) {
78
+ const previous = byStep.get((task.pipelineStepId ?? "").toLowerCase());
79
+ if (!previous) {
80
+ create.push(task);
81
+ continue;
82
+ }
83
+ if (pipelineTaskSignature(previous) === pipelineTaskSignature(task)) {
84
+ unchanged.push(task);
85
+ }
86
+ else {
87
+ updates.push({ task, previous });
88
+ }
89
+ byStep.delete((task.pipelineStepId ?? "").toLowerCase());
90
+ }
91
+ const stale = [...byStep.values()];
92
+ const warnings = [...mapped.warnings];
93
+ if (stale.length > 0) {
94
+ warnings.push(`В YAML больше нет шагов: ${stale.map((task) => task.name).join(", ")}. ` +
95
+ "Они не удалены автоматически — удалите вручную или верните шаг.");
96
+ }
97
+ return { creates: create, updates, unchanged, stale, warnings };
98
+ }
99
+ /** Применяет план через переданные обработчики (БД/планировщик) и считает итог. */
100
+ export async function executePipelineApply(plan, handlers) {
101
+ let created = 0;
102
+ for (const task of plan.creates) {
103
+ await handlers.create(task);
104
+ created += 1;
105
+ }
106
+ let updated = 0;
107
+ for (const entry of plan.updates) {
108
+ await handlers.update(entry.task);
109
+ updated += 1;
110
+ }
111
+ return {
112
+ created,
113
+ updated,
114
+ unchanged: plan.unchanged.length,
115
+ stale: plan.stale.length,
116
+ };
117
+ }
@@ -0,0 +1,13 @@
1
+ import { type PipelineSpec, type PipelineValidationResult } from "./pipeline-spec.js";
2
+ /** Результат разбора YAML: спека возвращается только при успешной валидации. */
3
+ export interface PipelineParseResult extends PipelineValidationResult {
4
+ spec?: PipelineSpec;
5
+ }
6
+ /**
7
+ * Разбирает YAML-текст в `PipelineSpec` и сразу валидирует его.
8
+ * Функция не бросает: синтаксические и смысловые ошибки возвращаются в `errors`.
9
+ */
10
+ export declare function parsePipelineYaml(source: string): PipelineParseResult;
11
+ /** Читает YAML-файл и валидирует его. Ошибки ввода-вывода также попадают в `errors`. */
12
+ export declare function loadPipelineFile(filePath: string): Promise<PipelineParseResult>;
13
+ //# sourceMappingURL=pipeline-io.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"pipeline-io.d.ts","sourceRoot":"","sources":["../../src/core/pipeline-io.ts"],"names":[],"mappings":"AAEA,OAAO,EAGL,KAAK,YAAY,EACjB,KAAK,wBAAwB,EAC9B,MAAM,oBAAoB,CAAC;AAE5B,gFAAgF;AAChF,MAAM,WAAW,mBAAoB,SAAQ,wBAAwB;IACnE,IAAI,CAAC,EAAE,YAAY,CAAC;CACrB;AASD;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,GAAG,mBAAmB,CAsCrE;AAED,wFAAwF;AACxF,wBAAsB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAYrF"}
@@ -0,0 +1,64 @@
1
+ import { readFile } from "node:fs/promises";
2
+ import { parseDocument } from "yaml";
3
+ import { validatePipelineSpec, } from "./pipeline-spec.js";
4
+ const MAX_YAML_BYTES = 1024 * 1024;
5
+ const MAX_ALIAS_COUNT = 100;
6
+ function issueMessage(err) {
7
+ return err instanceof Error ? err.message : String(err);
8
+ }
9
+ /**
10
+ * Разбирает YAML-текст в `PipelineSpec` и сразу валидирует его.
11
+ * Функция не бросает: синтаксические и смысловые ошибки возвращаются в `errors`.
12
+ */
13
+ export function parsePipelineYaml(source) {
14
+ const errors = [];
15
+ const warnings = [];
16
+ if (source.length > MAX_YAML_BYTES) {
17
+ return {
18
+ ok: false,
19
+ errors: [{ path: "$", message: `YAML больше ${MAX_YAML_BYTES} байт` }],
20
+ warnings,
21
+ };
22
+ }
23
+ let data;
24
+ try {
25
+ const doc = parseDocument(source, {
26
+ prettyErrors: true,
27
+ uniqueKeys: true,
28
+ strict: true,
29
+ });
30
+ if (doc.errors.length > 0) {
31
+ for (const err of doc.errors) {
32
+ errors.push({ path: "$", message: err.message });
33
+ }
34
+ return { ok: false, errors, warnings };
35
+ }
36
+ data = doc.toJS({ maxAliasCount: MAX_ALIAS_COUNT });
37
+ }
38
+ catch (err) {
39
+ return {
40
+ ok: false,
41
+ errors: [{ path: "$", message: issueMessage(err) }],
42
+ warnings,
43
+ };
44
+ }
45
+ const result = validatePipelineSpec(data);
46
+ if (!result.ok)
47
+ return result;
48
+ return { ...result, spec: data };
49
+ }
50
+ /** Читает YAML-файл и валидирует его. Ошибки ввода-вывода также попадают в `errors`. */
51
+ export async function loadPipelineFile(filePath) {
52
+ let source;
53
+ try {
54
+ source = await readFile(filePath, "utf8");
55
+ }
56
+ catch (err) {
57
+ return {
58
+ ok: false,
59
+ errors: [{ path: filePath, message: `Не удалось прочитать файл: ${issueMessage(err)}` }],
60
+ warnings: [],
61
+ };
62
+ }
63
+ return parsePipelineYaml(source);
64
+ }
@@ -0,0 +1,46 @@
1
+ /**
2
+ * Спринт 32 (Pipeline-as-code, 0.0.5): маппинг `PipelineSpec` → `TaskDefinition[]`.
3
+ *
4
+ * Модуль чистый: не читает БД и не трогает планировщик. Всё, что требует
5
+ * состояния (разрешение имён workspace в id), передаётся через опции.
6
+ * Маркеры `pipelineName` / `pipelineStepId` сохраняются в definition_json,
7
+ * чтобы идемпотентный apply мог отличать шаги pipeline от «чужих» задач.
8
+ */
9
+ import type { TaskDefinition } from "../task-transfer.js";
10
+ import { type PipelineSpec } from "./pipeline-spec.js";
11
+ export interface PipelineMapOptions {
12
+ /**
13
+ * Разрешение имени workspace в id. Если не задано, значения
14
+ * `matrix.workspaces` считаются уже id. Apply передаёт резолвер из БД.
15
+ */
16
+ resolveWorkspaceId?: (nameOrId: string) => string | undefined;
17
+ }
18
+ export interface PipelineTaskMapping {
19
+ tasks: TaskDefinition[];
20
+ warnings: string[];
21
+ }
22
+ /**
23
+ * Преобразует провалидированный pipeline в определения задач.
24
+ *
25
+ * Правила:
26
+ * - `trigger: dag` → задача без собственного триггера (`triggerType: "file"`),
27
+ * как матричные родители: её запускает только DAG-движок по `dependsOn`;
28
+ * - `needs` → `dependsOn` с именами задач (`<pipeline> <step>`);
29
+ * - `defaults` наследуются шагом;
30
+ * - матрица `workspaces` переносится в `matrix.workspaceIds`.
31
+ */
32
+ export declare function pipelineSpecToTasks(spec: PipelineSpec, options?: PipelineMapOptions): PipelineTaskMapping;
33
+ export interface PipelineExportResult {
34
+ spec: PipelineSpec;
35
+ warnings: string[];
36
+ }
37
+ /**
38
+ * Обратный маппинг: задачи одного pipeline из БД → `PipelineSpec` для export.
39
+ *
40
+ * Восстанавливает `needs` по `dependsOn`, `matrix.workspaces` по
41
+ * `matrix.workspaceIds`, trigger по `triggerType`. Шаг `dag` неотличим от
42
+ * ручного `file`-шага с зависимостями, поэтому восстанавливается эвристикой:
43
+ * `file`, без cron и watchPath, но с `dependsOn` → `dag`.
44
+ */
45
+ export declare function tasksToPipelineSpec(tasks: TaskDefinition[], pipelineName: string): PipelineExportResult;
46
+ //# sourceMappingURL=pipeline-map.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"pipeline-map.d.ts","sourceRoot":"","sources":["../../src/core/pipeline-map.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,KAAK,EAAgB,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACxE,OAAO,EAIL,KAAK,YAAY,EAIlB,MAAM,oBAAoB,CAAC;AAE5B,MAAM,WAAW,kBAAkB;IACjC;;;OAGG;IACH,kBAAkB,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,MAAM,GAAG,SAAS,CAAC;CAC/D;AAED,MAAM,WAAW,mBAAmB;IAClC,KAAK,EAAE,cAAc,EAAE,CAAC;IACxB,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED;;;;;;;;;GASG;AACH,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,YAAY,EAClB,OAAO,GAAE,kBAAuB,GAC/B,mBAAmB,CA2ErB;AA4BD,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,YAAY,CAAC;IACnB,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,cAAc,EAAE,EACvB,YAAY,EAAE,MAAM,GACnB,oBAAoB,CAsFtB"}