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.
Files changed (279) hide show
  1. package/CHANGELOG.md +309 -2
  2. package/CROSS_PLATFORM.md +19 -0
  3. package/README.md +55 -8
  4. package/ROADMAP-STRATEGY.md +22 -19
  5. package/ROADMAP.md +230 -159
  6. package/dist/cli.d.ts +3 -0
  7. package/dist/cli.d.ts.map +1 -0
  8. package/dist/cli.js +356 -0
  9. package/dist/core/analytics.d.ts +6 -0
  10. package/dist/core/analytics.d.ts.map +1 -1
  11. package/dist/core/analytics.js +20 -3
  12. package/dist/core/audit.d.ts +6 -0
  13. package/dist/core/audit.d.ts.map +1 -1
  14. package/dist/core/audit.js +24 -0
  15. package/dist/core/budget.d.ts +118 -0
  16. package/dist/core/budget.d.ts.map +1 -0
  17. package/dist/core/budget.js +206 -0
  18. package/dist/core/cron-to-schtasks.d.ts.map +1 -1
  19. package/dist/core/cron-to-schtasks.js +38 -0
  20. package/dist/core/dry-run.d.ts +26 -1
  21. package/dist/core/dry-run.d.ts.map +1 -1
  22. package/dist/core/dry-run.js +199 -8
  23. package/dist/core/execution.d.ts +203 -0
  24. package/dist/core/execution.d.ts.map +1 -0
  25. package/dist/core/execution.js +309 -0
  26. package/dist/core/feedback.d.ts +192 -0
  27. package/dist/core/feedback.d.ts.map +1 -0
  28. package/dist/core/feedback.js +426 -0
  29. package/dist/core/gate-integrity.d.ts +71 -0
  30. package/dist/core/gate-integrity.d.ts.map +1 -0
  31. package/dist/core/gate-integrity.js +275 -0
  32. package/dist/core/git-trigger.d.ts.map +1 -1
  33. package/dist/core/git-trigger.js +14 -2
  34. package/dist/core/guard-run.d.ts +4 -0
  35. package/dist/core/guard-run.d.ts.map +1 -0
  36. package/dist/core/guard-run.js +101 -0
  37. package/dist/core/guard.d.ts +52 -0
  38. package/dist/core/guard.d.ts.map +1 -0
  39. package/dist/core/guard.js +362 -0
  40. package/dist/core/local-ai.d.ts.map +1 -1
  41. package/dist/core/local-ai.js +7 -3
  42. package/dist/core/lock.d.ts +41 -0
  43. package/dist/core/lock.d.ts.map +1 -1
  44. package/dist/core/lock.js +141 -29
  45. package/dist/core/matrix.d.ts +8 -0
  46. package/dist/core/matrix.d.ts.map +1 -1
  47. package/dist/core/matrix.js +132 -17
  48. package/dist/core/mission.d.ts +103 -0
  49. package/dist/core/mission.d.ts.map +1 -0
  50. package/dist/core/mission.js +374 -0
  51. package/dist/core/opencode-models.d.ts +2 -2
  52. package/dist/core/opencode-models.d.ts.map +1 -1
  53. package/dist/core/opencode-models.js +28 -21
  54. package/dist/core/opencode-usage.d.ts +35 -0
  55. package/dist/core/opencode-usage.d.ts.map +1 -0
  56. package/dist/core/opencode-usage.js +132 -0
  57. package/dist/core/pipeline-apply.d.ts +38 -0
  58. package/dist/core/pipeline-apply.d.ts.map +1 -0
  59. package/dist/core/pipeline-apply.js +117 -0
  60. package/dist/core/pipeline-io.d.ts +13 -0
  61. package/dist/core/pipeline-io.d.ts.map +1 -0
  62. package/dist/core/pipeline-io.js +78 -0
  63. package/dist/core/pipeline-map.d.ts +52 -0
  64. package/dist/core/pipeline-map.d.ts.map +1 -0
  65. package/dist/core/pipeline-map.js +208 -0
  66. package/dist/core/pipeline-spec.d.ts +109 -0
  67. package/dist/core/pipeline-spec.d.ts.map +1 -0
  68. package/dist/core/pipeline-spec.js +554 -0
  69. package/dist/core/ps-wrapper.d.ts +27 -2
  70. package/dist/core/ps-wrapper.d.ts.map +1 -1
  71. package/dist/core/ps-wrapper.js +424 -65
  72. package/dist/core/record-history.d.ts.map +1 -1
  73. package/dist/core/record-history.js +206 -33
  74. package/dist/core/router/rules.d.ts.map +1 -1
  75. package/dist/core/router/rules.js +6 -0
  76. package/dist/core/run-mode.d.ts +12 -0
  77. package/dist/core/run-mode.d.ts.map +1 -0
  78. package/dist/core/run-mode.js +17 -0
  79. package/dist/core/scheduler/linux.d.ts +8 -1
  80. package/dist/core/scheduler/linux.d.ts.map +1 -1
  81. package/dist/core/scheduler/linux.js +34 -9
  82. package/dist/core/scheduler/logs.d.ts +4 -0
  83. package/dist/core/scheduler/logs.d.ts.map +1 -1
  84. package/dist/core/scheduler/logs.js +25 -1
  85. package/dist/core/scheduler/mac.d.ts +44 -2
  86. package/dist/core/scheduler/mac.d.ts.map +1 -1
  87. package/dist/core/scheduler/mac.js +126 -15
  88. package/dist/core/scheduler/windows.d.ts.map +1 -1
  89. package/dist/core/scheduler/windows.js +15 -12
  90. package/dist/core/secrets.d.ts.map +1 -1
  91. package/dist/core/secrets.js +18 -8
  92. package/dist/core/self-analysis.d.ts +32 -2
  93. package/dist/core/self-analysis.d.ts.map +1 -1
  94. package/dist/core/self-analysis.js +38 -27
  95. package/dist/core/shutdown.d.ts +33 -2
  96. package/dist/core/shutdown.d.ts.map +1 -1
  97. package/dist/core/shutdown.js +58 -2
  98. package/dist/core/structured-log.d.ts +37 -1
  99. package/dist/core/structured-log.d.ts.map +1 -1
  100. package/dist/core/structured-log.js +37 -0
  101. package/dist/core/usage-surface.d.ts +25 -0
  102. package/dist/core/usage-surface.d.ts.map +1 -0
  103. package/dist/core/usage-surface.js +41 -0
  104. package/dist/core/worktree-run.d.ts +4 -0
  105. package/dist/core/worktree-run.d.ts.map +1 -0
  106. package/dist/core/worktree-run.js +164 -0
  107. package/dist/core/worktree.d.ts +115 -0
  108. package/dist/core/worktree.d.ts.map +1 -0
  109. package/dist/core/worktree.js +462 -0
  110. package/dist/core/wrappers/bash.d.ts +19 -0
  111. package/dist/core/wrappers/bash.d.ts.map +1 -1
  112. package/dist/core/wrappers/bash.js +230 -27
  113. package/dist/db/capability-repo.d.ts +43 -2
  114. package/dist/db/capability-repo.d.ts.map +1 -1
  115. package/dist/db/capability-repo.js +96 -11
  116. package/dist/db/history-repo.d.ts +70 -5
  117. package/dist/db/history-repo.d.ts.map +1 -1
  118. package/dist/db/history-repo.js +170 -29
  119. package/dist/db/metrics-repo.d.ts +20 -2
  120. package/dist/db/metrics-repo.d.ts.map +1 -1
  121. package/dist/db/metrics-repo.js +35 -13
  122. package/dist/db/migrate.d.ts.map +1 -1
  123. package/dist/db/migrate.js +37 -17
  124. package/dist/db/recovery.d.ts +3 -1
  125. package/dist/db/recovery.d.ts.map +1 -1
  126. package/dist/db/recovery.js +11 -5
  127. package/dist/db/run-journal.d.ts +33 -5
  128. package/dist/db/run-journal.d.ts.map +1 -1
  129. package/dist/db/run-journal.js +78 -14
  130. package/dist/db/run-resume.d.ts +5 -0
  131. package/dist/db/run-resume.d.ts.map +1 -1
  132. package/dist/db/run-resume.js +9 -2
  133. package/dist/db/runs-repo.d.ts +19 -2
  134. package/dist/db/runs-repo.d.ts.map +1 -1
  135. package/dist/db/runs-repo.js +91 -60
  136. package/dist/db/schema.d.ts +2 -2
  137. package/dist/db/schema.d.ts.map +1 -1
  138. package/dist/db/schema.js +132 -2
  139. package/dist/db/templates-repo.d.ts +2 -2
  140. package/dist/db/templates-repo.d.ts.map +1 -1
  141. package/dist/db/templates-repo.js +5 -3
  142. package/dist/history.d.ts +7 -2
  143. package/dist/history.d.ts.map +1 -1
  144. package/dist/history.js +4 -2
  145. package/dist/hook-output.d.ts +2 -0
  146. package/dist/hook-output.d.ts.map +1 -0
  147. package/dist/hook-output.js +31 -0
  148. package/dist/i18n.d.ts +5 -0
  149. package/dist/i18n.d.ts.map +1 -1
  150. package/dist/i18n.js +11 -4
  151. package/dist/index.d.ts +375 -47
  152. package/dist/index.d.ts.map +1 -1
  153. package/dist/index.js +1344 -192
  154. package/dist/notifications.d.ts +53 -2
  155. package/dist/notifications.d.ts.map +1 -1
  156. package/dist/notifications.js +168 -21
  157. package/dist/profiles.d.ts.map +1 -1
  158. package/dist/profiles.js +82 -10
  159. package/dist/rpc.d.ts +354 -0
  160. package/dist/rpc.d.ts.map +1 -1
  161. package/dist/rpc.js +145 -0
  162. package/dist/server.d.ts +32 -2
  163. package/dist/server.d.ts.map +1 -1
  164. package/dist/server.js +154 -30
  165. package/dist/settings.d.ts +44 -2
  166. package/dist/settings.d.ts.map +1 -1
  167. package/dist/settings.js +85 -3
  168. package/dist/shared/jobs-view.d.ts +1 -1
  169. package/dist/shared/jobs-view.d.ts.map +1 -1
  170. package/dist/shared/jobs-view.js +2 -0
  171. package/dist/task-transfer.d.ts +21 -0
  172. package/dist/task-transfer.d.ts.map +1 -1
  173. package/dist/task-transfer.js +64 -3
  174. package/dist/templates.d.ts +2 -2
  175. package/dist/templates.d.ts.map +1 -1
  176. package/dist/templates.js +3 -3
  177. package/dist/types.d.ts +22 -2
  178. package/dist/types.d.ts.map +1 -1
  179. package/dist/workspaces.d.ts.map +1 -1
  180. package/dist/workspaces.js +34 -11
  181. package/docs/ARCHITECTURE.md +319 -66
  182. package/docs/COMPATIBILITY.md +2 -2
  183. package/docs/CONCEPT.md +18 -4
  184. package/docs/CROSS_PLATFORM.ru.md +20 -0
  185. package/docs/CROSS_PLATFORM.zh.md +18 -0
  186. package/docs/EXECUTION-LOOP.md +28 -10
  187. package/docs/FEATURES.md +129 -7
  188. package/docs/FEATURES.zh.md +97 -6
  189. package/docs/MIGRATION.md +2 -2
  190. package/docs/PIPELINE.md +293 -0
  191. package/docs/QA-A2-GUI-TUI.md +205 -0
  192. package/docs/README.ru.md +43 -4
  193. package/docs/README.zh.md +44 -4
  194. package/docs/SAFETY.md +23 -3
  195. package/gui-experimental.cjs +9 -8
  196. package/locales/en.json +58 -3
  197. package/locales/ru.json +58 -3
  198. package/locales/zh.json +58 -3
  199. package/opencode.pipeline.yaml +35 -0
  200. package/package.json +36 -4
  201. package/scripts/check-eslint-baseline.mjs +139 -0
  202. package/scripts/gen-test-plan-counters.mjs +117 -0
  203. package/scripts/github-ci-fetch.ps1 +37 -0
  204. package/scripts/pl-commit.ps1 +112 -0
  205. package/scripts/qa-a2-commit.ps1 +104 -0
  206. package/scripts/test-home.mjs +107 -0
  207. package/skills/scheduled-job-best-practices/SKILL.md +95 -1
  208. package/skills/scheduled-job-best-practices/references/recipes.md +139 -0
  209. package/src/cli.ts +417 -0
  210. package/src/core/analytics.ts +27 -4
  211. package/src/core/audit.ts +25 -0
  212. package/src/core/budget.ts +340 -0
  213. package/src/core/cron-to-schtasks.ts +42 -0
  214. package/src/core/dry-run.ts +235 -12
  215. package/src/core/execution.ts +538 -0
  216. package/src/core/feedback.ts +582 -0
  217. package/src/core/file-watcher.ts +2 -2
  218. package/src/core/gate-integrity.ts +330 -0
  219. package/src/core/git-trigger.ts +18 -5
  220. package/src/core/guard-run.ts +119 -0
  221. package/src/core/guard.ts +431 -0
  222. package/src/core/local-ai.ts +7 -3
  223. package/src/core/lock.ts +178 -37
  224. package/src/core/matrix.ts +158 -52
  225. package/src/core/mission.ts +531 -0
  226. package/src/core/native-notify.ts +1 -1
  227. package/src/core/opencode-models.ts +30 -21
  228. package/src/core/opencode-usage.ts +182 -0
  229. package/src/core/pipeline-apply.ts +158 -0
  230. package/src/core/pipeline-io.ts +96 -0
  231. package/src/core/pipeline-map.ts +283 -0
  232. package/src/core/pipeline-spec.ts +775 -0
  233. package/src/core/ps-wrapper.ts +435 -66
  234. package/src/core/record-history.ts +258 -81
  235. package/src/core/router/rules.ts +6 -0
  236. package/src/core/run-mode.ts +19 -0
  237. package/src/core/schedule-gate.ts +1 -1
  238. package/src/core/scheduler/at-fallback.ts +1 -1
  239. package/src/core/scheduler/linux.ts +40 -11
  240. package/src/core/scheduler/logs.ts +34 -3
  241. package/src/core/scheduler/mac.ts +174 -14
  242. package/src/core/scheduler/registry.ts +2 -2
  243. package/src/core/scheduler/windows.ts +19 -15
  244. package/src/core/secrets.ts +26 -19
  245. package/src/core/self-analysis.ts +75 -29
  246. package/src/core/shutdown.ts +90 -4
  247. package/src/core/structured-log.ts +89 -5
  248. package/src/core/telegram.ts +2 -2
  249. package/src/core/triage-worker.ts +7 -7
  250. package/src/core/triage.ts +2 -2
  251. package/src/core/usage-surface.ts +70 -0
  252. package/src/core/worktree-run.ts +199 -0
  253. package/src/core/worktree.ts +600 -0
  254. package/src/core/wrappers/bash.ts +248 -26
  255. package/src/db/capability-repo.ts +127 -10
  256. package/src/db/history-repo.ts +281 -40
  257. package/src/db/metrics-repo.ts +40 -13
  258. package/src/db/migrate.ts +57 -32
  259. package/src/db/recovery.ts +12 -5
  260. package/src/db/run-journal.ts +100 -13
  261. package/src/db/run-resume.ts +17 -1
  262. package/src/db/runs-repo.ts +147 -65
  263. package/src/db/schema.ts +134 -2
  264. package/src/db/templates-repo.ts +5 -3
  265. package/src/gui.tsx +438 -18
  266. package/src/history.ts +11 -4
  267. package/src/hook-output.ts +39 -0
  268. package/src/i18n.ts +12 -4
  269. package/src/index.ts +1902 -320
  270. package/src/notifications.ts +227 -47
  271. package/src/profiles.ts +88 -10
  272. package/src/rpc.ts +158 -0
  273. package/src/server.ts +201 -41
  274. package/src/settings.ts +125 -5
  275. package/src/shared/jobs-view.ts +3 -1
  276. package/src/task-transfer.ts +90 -6
  277. package/src/templates.ts +3 -3
  278. package/src/types.ts +23 -2
  279. package/src/workspaces.ts +37 -14
@@ -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, baseDir?: 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":"AAGA,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,CACpC,QAAQ,EAAE,MAAM,EAChB,OAAO,CAAC,EAAE,MAAM,GACf,OAAO,CAAC,mBAAmB,CAAC,CAyB9B"}
@@ -0,0 +1,78 @@
1
+ import { readFile } from "node:fs/promises";
2
+ import { isAbsolute, resolve } from "node:path";
3
+ import { parseDocument } from "yaml";
4
+ import { validatePipelineSpec, } from "./pipeline-spec.js";
5
+ const MAX_YAML_BYTES = 1024 * 1024;
6
+ const MAX_ALIAS_COUNT = 100;
7
+ function issueMessage(err) {
8
+ return err instanceof Error ? err.message : String(err);
9
+ }
10
+ /**
11
+ * Разбирает YAML-текст в `PipelineSpec` и сразу валидирует его.
12
+ * Функция не бросает: синтаксические и смысловые ошибки возвращаются в `errors`.
13
+ */
14
+ export function parsePipelineYaml(source) {
15
+ const errors = [];
16
+ const warnings = [];
17
+ if (source.length > MAX_YAML_BYTES) {
18
+ return {
19
+ ok: false,
20
+ errors: [{ path: "$", message: `YAML больше ${MAX_YAML_BYTES} байт` }],
21
+ warnings,
22
+ };
23
+ }
24
+ let data;
25
+ try {
26
+ const doc = parseDocument(source, {
27
+ prettyErrors: true,
28
+ uniqueKeys: true,
29
+ strict: true,
30
+ });
31
+ if (doc.errors.length > 0) {
32
+ for (const err of doc.errors) {
33
+ errors.push({ path: "$", message: err.message });
34
+ }
35
+ return { ok: false, errors, warnings };
36
+ }
37
+ data = doc.toJS({ maxAliasCount: MAX_ALIAS_COUNT });
38
+ }
39
+ catch (err) {
40
+ return {
41
+ ok: false,
42
+ errors: [{ path: "$", message: issueMessage(err) }],
43
+ warnings,
44
+ };
45
+ }
46
+ const result = validatePipelineSpec(data);
47
+ if (!result.ok)
48
+ return result;
49
+ return { ...result, spec: data };
50
+ }
51
+ /** Читает YAML-файл и валидирует его. Ошибки ввода-вывода также попадают в `errors`. */
52
+ export async function loadPipelineFile(filePath, baseDir) {
53
+ // PL-34: cwd процесса-хоста OpenCode может не совпадать с каталогом задачи.
54
+ // Пробуем явный baseDir, затем cwd и подсказки окружения.
55
+ const roots = [
56
+ baseDir?.trim(),
57
+ process.cwd(),
58
+ process.env.OPENCODE_PROJECT_DIR,
59
+ process.env.INIT_CWD,
60
+ ].filter((root) => Boolean(root));
61
+ const candidates = isAbsolute(filePath)
62
+ ? [filePath]
63
+ : roots.map((root) => resolve(root, filePath));
64
+ let lastError;
65
+ for (const candidate of [...new Set(candidates)]) {
66
+ try {
67
+ return parsePipelineYaml(await readFile(candidate, "utf8"));
68
+ }
69
+ catch (err) {
70
+ lastError = err;
71
+ }
72
+ }
73
+ return {
74
+ ok: false,
75
+ errors: [{ path: filePath, message: `Не удалось прочитать файл: ${issueMessage(lastError)}` }],
76
+ warnings: [],
77
+ };
78
+ }
@@ -0,0 +1,52 @@
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
+ * QA-P3.2: проверка, что конвейер действительно существует в наборе задач.
39
+ * `tasksToPipelineSpec` всегда возвращает spec (в т.ч. с нулём шагов), поэтому
40
+ * «не найден» должен определяться здесь, а не по `!result.spec`.
41
+ */
42
+ export declare function pipelineExportLookupError(tasks: TaskDefinition[], pipelineName: string): string | null;
43
+ /**
44
+ * Обратный маппинг: задачи одного pipeline из БД → `PipelineSpec` для export.
45
+ *
46
+ * Восстанавливает `needs` по `dependsOn`, `matrix.workspaces` по
47
+ * `matrix.workspaceIds`, trigger по `triggerType`. Шаг `dag` неотличим от
48
+ * ручного `file`-шага с зависимостями, поэтому восстанавливается эвристикой:
49
+ * `file`, без cron и watchPath, но с `dependsOn` → `dag`.
50
+ */
51
+ export declare function tasksToPipelineSpec(tasks: TaskDefinition[], pipelineName: string): PipelineExportResult;
52
+ //# 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;;;;GAIG;AACH,wBAAgB,yBAAyB,CACvC,KAAK,EAAE,cAAc,EAAE,EACvB,YAAY,EAAE,MAAM,GACnB,MAAM,GAAG,IAAI,CASf;AAED;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,cAAc,EAAE,EACvB,YAAY,EAAE,MAAM,GACnB,oBAAoB,CAsFtB"}
@@ -0,0 +1,208 @@
1
+ import { PIPELINE_VERSION, pipelineStepTaskName, } from "./pipeline-spec.js";
2
+ /**
3
+ * Преобразует провалидированный pipeline в определения задач.
4
+ *
5
+ * Правила:
6
+ * - `trigger: dag` → задача без собственного триггера (`triggerType: "file"`),
7
+ * как матричные родители: её запускает только DAG-движок по `dependsOn`;
8
+ * - `needs` → `dependsOn` с именами задач (`<pipeline> <step>`);
9
+ * - `defaults` наследуются шагом;
10
+ * - матрица `workspaces` переносится в `matrix.workspaceIds`.
11
+ */
12
+ export function pipelineSpecToTasks(spec, options = {}) {
13
+ const defaults = spec.defaults ?? {};
14
+ const warnings = [];
15
+ const nameByStep = new Map();
16
+ for (const step of spec.steps) {
17
+ const explicit = step.name?.trim();
18
+ nameByStep.set(step.id.toLowerCase(), explicit || pipelineStepTaskName(spec.name, step.id));
19
+ }
20
+ const tasks = spec.steps.map((step) => {
21
+ const trigger = step.trigger ?? defaults.trigger ?? "cron";
22
+ const scheduleValue = step.schedule ?? defaults.schedule ?? "";
23
+ const schedule = trigger === "cron" ? scheduleValue : "";
24
+ const dependsOn = step.needs?.length
25
+ ? step.needs.map((need) => nameByStep.get(need.toLowerCase()))
26
+ : undefined;
27
+ const task = {
28
+ name: nameByStep.get(step.id.toLowerCase()),
29
+ schedule,
30
+ prompt: step.prompt,
31
+ // TaskDefinition не знает "dag": ручной триггер "file" не регистрирует
32
+ // cron, задачу запускает DAG-движок после успеха зависимостей.
33
+ triggerType: trigger === "dag" ? "file" : trigger,
34
+ ...(dependsOn ? { dependsOn } : {}),
35
+ ...(step.qualityGate !== undefined ? { qualityGate: step.qualityGate } : {}),
36
+ ...(step.beforeScript !== undefined ? { beforeScript: step.beforeScript } : {}),
37
+ ...(step.afterScript !== undefined ? { afterScript: step.afterScript } : {}),
38
+ ...(step.guards !== undefined ? { guards: step.guards } : {}),
39
+ ...(step.model !== undefined || defaults.model !== undefined
40
+ ? { model: step.model ?? defaults.model }
41
+ : {}),
42
+ ...(step.priority !== undefined || defaults.priority !== undefined
43
+ ? { priority: step.priority ?? defaults.priority }
44
+ : {}),
45
+ ...(step.timeoutSeconds !== undefined || defaults.timeoutSeconds !== undefined
46
+ ? { timeoutSeconds: step.timeoutSeconds ?? defaults.timeoutSeconds }
47
+ : {}),
48
+ ...(step.workingDirectory !== undefined || defaults.workingDirectory !== undefined
49
+ ? { workingDirectory: step.workingDirectory ?? defaults.workingDirectory }
50
+ : {}),
51
+ ...(step.workspaceId !== undefined ? { workspaceId: step.workspaceId } : {}),
52
+ ...(step.retryCount !== undefined || defaults.retryCount !== undefined
53
+ ? { retryCount: step.retryCount ?? defaults.retryCount }
54
+ : {}),
55
+ ...(step.retryDelay !== undefined || defaults.retryDelay !== undefined
56
+ ? { retryDelay: step.retryDelay ?? defaults.retryDelay }
57
+ : {}),
58
+ ...(step.allowedTools !== undefined || defaults.allowedTools !== undefined
59
+ ? { allowedTools: step.allowedTools ?? defaults.allowedTools }
60
+ : {}),
61
+ ...(step.deniedTools !== undefined || defaults.deniedTools !== undefined
62
+ ? { deniedTools: step.deniedTools ?? defaults.deniedTools }
63
+ : {}),
64
+ ...(step.timezone !== undefined || defaults.timezone !== undefined
65
+ ? { timezone: step.timezone ?? defaults.timezone }
66
+ : {}),
67
+ ...(step.notBefore !== undefined ? { notBefore: step.notBefore } : {}),
68
+ ...(step.notAfter !== undefined ? { notAfter: step.notAfter } : {}),
69
+ ...(step.activeDays !== undefined ? { activeDays: step.activeDays } : {}),
70
+ ...(step.windowPolicy !== undefined ? { windowPolicy: step.windowPolicy } : {}),
71
+ ...(trigger === "once" && step.runAt !== undefined ? { runAt: step.runAt } : {}),
72
+ ...(step.matrix ? { matrix: mapMatrix(step.matrix, options, warnings) } : {}),
73
+ pipelineName: spec.name,
74
+ pipelineStepId: step.id,
75
+ };
76
+ return task;
77
+ });
78
+ return { tasks, warnings };
79
+ }
80
+ function mapMatrix(matrix, options, warnings) {
81
+ const workspaceIds = matrix.workspaces.map((raw) => {
82
+ const value = raw.trim();
83
+ const resolved = options.resolveWorkspaceId?.(value);
84
+ if (options.resolveWorkspaceId && !resolved) {
85
+ warnings.push(`workspace «${value}» не найден — шаг будет отклонён при apply.`);
86
+ return value;
87
+ }
88
+ return resolved ?? value;
89
+ });
90
+ return {
91
+ workspaceIds,
92
+ ...(matrix.strategy ? { strategy: matrix.strategy } : {}),
93
+ ...(matrix.failureMode ? { failureMode: matrix.failureMode } : {}),
94
+ ...(matrix.aggregation ? { aggregation: matrix.aggregation } : {}),
95
+ ...(matrix.concurrency !== undefined ? { concurrency: matrix.concurrency } : {}),
96
+ ...(matrix.createAggregator !== undefined
97
+ ? { createAggregator: matrix.createAggregator }
98
+ : {}),
99
+ };
100
+ }
101
+ /**
102
+ * QA-P3.2: проверка, что конвейер действительно существует в наборе задач.
103
+ * `tasksToPipelineSpec` всегда возвращает spec (в т.ч. с нулём шагов), поэтому
104
+ * «не найден» должен определяться здесь, а не по `!result.spec`.
105
+ */
106
+ export function pipelineExportLookupError(tasks, pipelineName) {
107
+ const hasSteps = tasks.some((task) => task.pipelineName?.toLowerCase() === pipelineName.toLowerCase() &&
108
+ Boolean(task.pipelineStepId));
109
+ return hasSteps
110
+ ? null
111
+ : `Конвейер "${pipelineName}" не найден (не найдены задачи с pipelineName=${pipelineName} и pipelineStepId).`;
112
+ }
113
+ /**
114
+ * Обратный маппинг: задачи одного pipeline из БД → `PipelineSpec` для export.
115
+ *
116
+ * Восстанавливает `needs` по `dependsOn`, `matrix.workspaces` по
117
+ * `matrix.workspaceIds`, trigger по `triggerType`. Шаг `dag` неотличим от
118
+ * ручного `file`-шага с зависимостями, поэтому восстанавливается эвристикой:
119
+ * `file`, без cron и watchPath, но с `dependsOn` → `dag`.
120
+ */
121
+ export function tasksToPipelineSpec(tasks, pipelineName) {
122
+ const warnings = [];
123
+ const own = tasks.filter((task) => task.pipelineName?.toLowerCase() === pipelineName.toLowerCase() &&
124
+ Boolean(task.pipelineStepId));
125
+ const stepIdByTaskName = new Map();
126
+ for (const task of own) {
127
+ const key = task.name.trim().toLowerCase();
128
+ if (key && !stepIdByTaskName.has(key)) {
129
+ stepIdByTaskName.set(key, task.pipelineStepId);
130
+ }
131
+ }
132
+ const steps = own.map((task) => {
133
+ const stepId = task.pipelineStepId;
134
+ const trigger = inferTrigger(task);
135
+ const needs = task.dependsOn
136
+ ?.map((dep) => {
137
+ const id = stepIdByTaskName.get(dep.trim().toLowerCase());
138
+ if (!id) {
139
+ warnings.push(`Шаг «${stepId}»: зависимость «${dep}» не входит в pipeline и опущена.`);
140
+ }
141
+ return id;
142
+ })
143
+ .filter((value) => Boolean(value));
144
+ const defaultName = pipelineStepTaskName(pipelineName, stepId);
145
+ const step = {
146
+ id: stepId,
147
+ ...(task.name.trim() !== defaultName ? { name: task.name } : {}),
148
+ prompt: task.prompt,
149
+ ...(needs?.length ? { needs } : {}),
150
+ ...(trigger === "cron" && task.schedule ? { schedule: task.schedule } : {}),
151
+ ...(trigger !== "cron" ? { trigger } : {}),
152
+ ...(trigger === "once" && task.runAt !== undefined ? { runAt: task.runAt } : {}),
153
+ ...(task.model !== undefined ? { model: task.model } : {}),
154
+ ...(task.priority !== undefined ? { priority: task.priority } : {}),
155
+ ...(task.timeoutSeconds !== undefined ? { timeoutSeconds: task.timeoutSeconds } : {}),
156
+ ...(task.workingDirectory !== undefined
157
+ ? { workingDirectory: task.workingDirectory }
158
+ : {}),
159
+ ...(task.workspaceId !== undefined ? { workspaceId: task.workspaceId } : {}),
160
+ ...(task.retryCount !== undefined ? { retryCount: task.retryCount } : {}),
161
+ ...(task.retryDelay !== undefined ? { retryDelay: task.retryDelay } : {}),
162
+ ...(task.qualityGate !== undefined ? { qualityGate: task.qualityGate } : {}),
163
+ ...(task.beforeScript !== undefined ? { beforeScript: task.beforeScript } : {}),
164
+ ...(task.afterScript !== undefined ? { afterScript: task.afterScript } : {}),
165
+ ...(task.guards !== undefined ? { guards: task.guards } : {}),
166
+ ...(task.allowedTools !== undefined ? { allowedTools: task.allowedTools } : {}),
167
+ ...(task.deniedTools !== undefined ? { deniedTools: task.deniedTools } : {}),
168
+ ...(task.matrix
169
+ ? {
170
+ matrix: {
171
+ workspaces: task.matrix.workspaceIds,
172
+ ...(task.matrix.strategy ? { strategy: task.matrix.strategy } : {}),
173
+ ...(task.matrix.failureMode ? { failureMode: task.matrix.failureMode } : {}),
174
+ ...(task.matrix.aggregation ? { aggregation: task.matrix.aggregation } : {}),
175
+ ...(task.matrix.concurrency !== undefined
176
+ ? { concurrency: task.matrix.concurrency }
177
+ : {}),
178
+ ...(task.matrix.createAggregator !== undefined
179
+ ? { createAggregator: task.matrix.createAggregator }
180
+ : {}),
181
+ },
182
+ }
183
+ : {}),
184
+ ...(task.timezone !== undefined ? { timezone: task.timezone } : {}),
185
+ ...(task.notBefore !== undefined ? { notBefore: task.notBefore } : {}),
186
+ ...(task.notAfter !== undefined ? { notAfter: task.notAfter } : {}),
187
+ ...(task.activeDays !== undefined ? { activeDays: task.activeDays } : {}),
188
+ ...(task.windowPolicy !== undefined
189
+ ? { windowPolicy: task.windowPolicy }
190
+ : {}),
191
+ };
192
+ return step;
193
+ });
194
+ return {
195
+ spec: { version: PIPELINE_VERSION, name: pipelineName, steps },
196
+ warnings,
197
+ };
198
+ }
199
+ function inferTrigger(task) {
200
+ const trigger = task.triggerType ?? "cron";
201
+ if (trigger === "file" &&
202
+ !task.schedule &&
203
+ !task.watchPath &&
204
+ Boolean(task.dependsOn?.length)) {
205
+ return "dag";
206
+ }
207
+ return trigger;
208
+ }
@@ -0,0 +1,109 @@
1
+ import { type TaskGuards } from "./guard.js";
2
+ /** Версия формата, которую понимает этот модуль. */
3
+ export declare const PIPELINE_VERSION = 1;
4
+ /** Защита от случайно огромного файла: шагов в одном pipeline. */
5
+ export declare const MAX_PIPELINE_STEPS = 200;
6
+ /** Максимальная длина id шага (id попадает в имена задач и логи). */
7
+ export declare const MAX_STEP_ID_LENGTH = 64;
8
+ /**
9
+ * Чем запускается шаг.
10
+ *
11
+ * `dag` — шаг без собственного триггера: он запускается только как
12
+ * зависимость другого шага (`needs` непустой). Это позволяет описывать
13
+ * pipeline целиком, не придумывая каждому шагу cron.
14
+ */
15
+ export type PipelineTrigger = "cron" | "file" | "git" | "mcp-event" | "once" | "dag";
16
+ export type PipelineMatrixStrategy = "parallel" | "sequential";
17
+ export type PipelineMatrixFailureMode = "continue" | "stop";
18
+ export type PipelineMatrixAggregation = "summary" | "per-task";
19
+ export type PipelineWindowPolicy = "skip" | "postpone" | "run";
20
+ /** Fan-out матрицы в терминах pipeline-файла. */
21
+ export interface PipelineMatrix {
22
+ /** Имена или id workspace, по одному клону на каждый. */
23
+ workspaces: string[];
24
+ strategy?: PipelineMatrixStrategy;
25
+ failureMode?: PipelineMatrixFailureMode;
26
+ aggregation?: PipelineMatrixAggregation;
27
+ /** Максимум одновременно выполняющихся клонов. */
28
+ concurrency?: number;
29
+ createAggregator?: boolean;
30
+ }
31
+ /** Значения по умолчанию для всех шагов pipeline. */
32
+ export interface PipelineDefaults {
33
+ schedule?: string;
34
+ trigger?: PipelineTrigger;
35
+ model?: string;
36
+ priority?: number;
37
+ timeoutSeconds?: number;
38
+ workingDirectory?: string;
39
+ retryCount?: number;
40
+ retryDelay?: number;
41
+ allowedTools?: string[];
42
+ deniedTools?: string[];
43
+ timezone?: string;
44
+ }
45
+ /** Один шаг pipeline. */
46
+ export interface PipelineStep {
47
+ /** Уникальный стабильный идентификатор шага (латиница/кириллица, цифры, `. _ -`). */
48
+ id: string;
49
+ /** Имя задачи в планировщике; по умолчанию `<pipeline> <id>`. */
50
+ name?: string;
51
+ prompt: string;
52
+ /** id шагов, которые должны успешно завершиться раньше. */
53
+ needs?: string[];
54
+ /** Cron-выражение (для trigger: cron). */
55
+ schedule?: string;
56
+ trigger?: PipelineTrigger;
57
+ /** ISO-8601 для trigger: once. */
58
+ runAt?: string;
59
+ model?: string;
60
+ priority?: number;
61
+ timeoutSeconds?: number;
62
+ workingDirectory?: string;
63
+ workspaceId?: string;
64
+ retryCount?: number;
65
+ retryDelay?: number;
66
+ qualityGate?: string;
67
+ beforeScript?: string;
68
+ afterScript?: string;
69
+ /** W-3: guard-условия шага; при невыполнении запуск пропускается. */
70
+ guards?: TaskGuards;
71
+ allowedTools?: string[];
72
+ deniedTools?: string[];
73
+ matrix?: PipelineMatrix;
74
+ timezone?: string;
75
+ notBefore?: string;
76
+ notAfter?: string;
77
+ activeDays?: number[];
78
+ windowPolicy?: PipelineWindowPolicy;
79
+ }
80
+ /** Корневой документ `opencode.pipeline.yaml`. */
81
+ export interface PipelineSpec {
82
+ version: typeof PIPELINE_VERSION;
83
+ name: string;
84
+ description?: string;
85
+ defaults?: PipelineDefaults;
86
+ steps: PipelineStep[];
87
+ }
88
+ /** Одна находка валидатора. */
89
+ export interface PipelineIssue {
90
+ /** Путь до поля: `steps[2].schedule`, `defaults.model` и т.п. */
91
+ path: string;
92
+ message: string;
93
+ }
94
+ /** Результат валидации: ошибки блокируют apply, предупреждения — нет. */
95
+ export interface PipelineValidationResult {
96
+ ok: boolean;
97
+ errors: PipelineIssue[];
98
+ warnings: PipelineIssue[];
99
+ }
100
+ /** Имя задачи по умолчанию для шага pipeline. */
101
+ export declare function pipelineStepTaskName(pipelineName: string, stepId: string): string;
102
+ /**
103
+ * Валидирует произвольный разобранный YAML.
104
+ *
105
+ * Не бросает исключений: все проблемы складываются в `errors`/`warnings`,
106
+ * чтобы CLI мог напечатать их списком и вернуть exit code.
107
+ */
108
+ export declare function validatePipelineSpec(input: unknown): PipelineValidationResult;
109
+ //# sourceMappingURL=pipeline-spec.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"pipeline-spec.d.ts","sourceRoot":"","sources":["../../src/core/pipeline-spec.ts"],"names":[],"mappings":"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"}