agent-steward 0.0.4 → 0.0.6
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +309 -2
- package/CROSS_PLATFORM.md +19 -0
- package/README.md +55 -8
- package/ROADMAP-STRATEGY.md +22 -19
- package/ROADMAP.md +230 -159
- package/dist/cli.d.ts +3 -0
- package/dist/cli.d.ts.map +1 -0
- package/dist/cli.js +356 -0
- package/dist/core/analytics.d.ts +6 -0
- package/dist/core/analytics.d.ts.map +1 -1
- package/dist/core/analytics.js +20 -3
- package/dist/core/audit.d.ts +6 -0
- package/dist/core/audit.d.ts.map +1 -1
- package/dist/core/audit.js +24 -0
- package/dist/core/budget.d.ts +118 -0
- package/dist/core/budget.d.ts.map +1 -0
- package/dist/core/budget.js +206 -0
- package/dist/core/cron-to-schtasks.d.ts.map +1 -1
- package/dist/core/cron-to-schtasks.js +38 -0
- package/dist/core/dry-run.d.ts +26 -1
- package/dist/core/dry-run.d.ts.map +1 -1
- package/dist/core/dry-run.js +199 -8
- package/dist/core/execution.d.ts +203 -0
- package/dist/core/execution.d.ts.map +1 -0
- package/dist/core/execution.js +309 -0
- package/dist/core/feedback.d.ts +192 -0
- package/dist/core/feedback.d.ts.map +1 -0
- package/dist/core/feedback.js +426 -0
- package/dist/core/gate-integrity.d.ts +71 -0
- package/dist/core/gate-integrity.d.ts.map +1 -0
- package/dist/core/gate-integrity.js +275 -0
- package/dist/core/git-trigger.d.ts.map +1 -1
- package/dist/core/git-trigger.js +14 -2
- package/dist/core/guard-run.d.ts +4 -0
- package/dist/core/guard-run.d.ts.map +1 -0
- package/dist/core/guard-run.js +101 -0
- package/dist/core/guard.d.ts +52 -0
- package/dist/core/guard.d.ts.map +1 -0
- package/dist/core/guard.js +362 -0
- package/dist/core/local-ai.d.ts.map +1 -1
- package/dist/core/local-ai.js +7 -3
- package/dist/core/lock.d.ts +41 -0
- package/dist/core/lock.d.ts.map +1 -1
- package/dist/core/lock.js +141 -29
- package/dist/core/matrix.d.ts +8 -0
- package/dist/core/matrix.d.ts.map +1 -1
- package/dist/core/matrix.js +132 -17
- package/dist/core/mission.d.ts +103 -0
- package/dist/core/mission.d.ts.map +1 -0
- package/dist/core/mission.js +374 -0
- package/dist/core/opencode-models.d.ts +2 -2
- package/dist/core/opencode-models.d.ts.map +1 -1
- package/dist/core/opencode-models.js +28 -21
- package/dist/core/opencode-usage.d.ts +35 -0
- package/dist/core/opencode-usage.d.ts.map +1 -0
- package/dist/core/opencode-usage.js +132 -0
- package/dist/core/pipeline-apply.d.ts +38 -0
- package/dist/core/pipeline-apply.d.ts.map +1 -0
- package/dist/core/pipeline-apply.js +117 -0
- package/dist/core/pipeline-io.d.ts +13 -0
- package/dist/core/pipeline-io.d.ts.map +1 -0
- package/dist/core/pipeline-io.js +78 -0
- package/dist/core/pipeline-map.d.ts +52 -0
- package/dist/core/pipeline-map.d.ts.map +1 -0
- package/dist/core/pipeline-map.js +208 -0
- package/dist/core/pipeline-spec.d.ts +109 -0
- package/dist/core/pipeline-spec.d.ts.map +1 -0
- package/dist/core/pipeline-spec.js +554 -0
- package/dist/core/ps-wrapper.d.ts +27 -2
- package/dist/core/ps-wrapper.d.ts.map +1 -1
- package/dist/core/ps-wrapper.js +424 -65
- package/dist/core/record-history.d.ts.map +1 -1
- package/dist/core/record-history.js +206 -33
- package/dist/core/router/rules.d.ts.map +1 -1
- package/dist/core/router/rules.js +6 -0
- package/dist/core/run-mode.d.ts +12 -0
- package/dist/core/run-mode.d.ts.map +1 -0
- package/dist/core/run-mode.js +17 -0
- package/dist/core/scheduler/linux.d.ts +8 -1
- package/dist/core/scheduler/linux.d.ts.map +1 -1
- package/dist/core/scheduler/linux.js +34 -9
- package/dist/core/scheduler/logs.d.ts +4 -0
- package/dist/core/scheduler/logs.d.ts.map +1 -1
- package/dist/core/scheduler/logs.js +25 -1
- package/dist/core/scheduler/mac.d.ts +44 -2
- package/dist/core/scheduler/mac.d.ts.map +1 -1
- package/dist/core/scheduler/mac.js +126 -15
- package/dist/core/scheduler/windows.d.ts.map +1 -1
- package/dist/core/scheduler/windows.js +15 -12
- package/dist/core/secrets.d.ts.map +1 -1
- package/dist/core/secrets.js +18 -8
- package/dist/core/self-analysis.d.ts +32 -2
- package/dist/core/self-analysis.d.ts.map +1 -1
- package/dist/core/self-analysis.js +38 -27
- package/dist/core/shutdown.d.ts +33 -2
- package/dist/core/shutdown.d.ts.map +1 -1
- package/dist/core/shutdown.js +58 -2
- package/dist/core/structured-log.d.ts +37 -1
- package/dist/core/structured-log.d.ts.map +1 -1
- package/dist/core/structured-log.js +37 -0
- package/dist/core/usage-surface.d.ts +25 -0
- package/dist/core/usage-surface.d.ts.map +1 -0
- package/dist/core/usage-surface.js +41 -0
- package/dist/core/worktree-run.d.ts +4 -0
- package/dist/core/worktree-run.d.ts.map +1 -0
- package/dist/core/worktree-run.js +164 -0
- package/dist/core/worktree.d.ts +115 -0
- package/dist/core/worktree.d.ts.map +1 -0
- package/dist/core/worktree.js +462 -0
- package/dist/core/wrappers/bash.d.ts +19 -0
- package/dist/core/wrappers/bash.d.ts.map +1 -1
- package/dist/core/wrappers/bash.js +230 -27
- package/dist/db/capability-repo.d.ts +43 -2
- package/dist/db/capability-repo.d.ts.map +1 -1
- package/dist/db/capability-repo.js +96 -11
- package/dist/db/history-repo.d.ts +70 -5
- package/dist/db/history-repo.d.ts.map +1 -1
- package/dist/db/history-repo.js +170 -29
- package/dist/db/metrics-repo.d.ts +20 -2
- package/dist/db/metrics-repo.d.ts.map +1 -1
- package/dist/db/metrics-repo.js +35 -13
- package/dist/db/migrate.d.ts.map +1 -1
- package/dist/db/migrate.js +37 -17
- package/dist/db/recovery.d.ts +3 -1
- package/dist/db/recovery.d.ts.map +1 -1
- package/dist/db/recovery.js +11 -5
- package/dist/db/run-journal.d.ts +33 -5
- package/dist/db/run-journal.d.ts.map +1 -1
- package/dist/db/run-journal.js +78 -14
- package/dist/db/run-resume.d.ts +5 -0
- package/dist/db/run-resume.d.ts.map +1 -1
- package/dist/db/run-resume.js +9 -2
- package/dist/db/runs-repo.d.ts +19 -2
- package/dist/db/runs-repo.d.ts.map +1 -1
- package/dist/db/runs-repo.js +91 -60
- package/dist/db/schema.d.ts +2 -2
- package/dist/db/schema.d.ts.map +1 -1
- package/dist/db/schema.js +132 -2
- package/dist/db/templates-repo.d.ts +2 -2
- package/dist/db/templates-repo.d.ts.map +1 -1
- package/dist/db/templates-repo.js +5 -3
- package/dist/history.d.ts +7 -2
- package/dist/history.d.ts.map +1 -1
- package/dist/history.js +4 -2
- package/dist/hook-output.d.ts +2 -0
- package/dist/hook-output.d.ts.map +1 -0
- package/dist/hook-output.js +31 -0
- package/dist/i18n.d.ts +5 -0
- package/dist/i18n.d.ts.map +1 -1
- package/dist/i18n.js +11 -4
- package/dist/index.d.ts +375 -47
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +1344 -192
- package/dist/notifications.d.ts +53 -2
- package/dist/notifications.d.ts.map +1 -1
- package/dist/notifications.js +168 -21
- package/dist/profiles.d.ts.map +1 -1
- package/dist/profiles.js +82 -10
- package/dist/rpc.d.ts +354 -0
- package/dist/rpc.d.ts.map +1 -1
- package/dist/rpc.js +145 -0
- package/dist/server.d.ts +32 -2
- package/dist/server.d.ts.map +1 -1
- package/dist/server.js +154 -30
- package/dist/settings.d.ts +44 -2
- package/dist/settings.d.ts.map +1 -1
- package/dist/settings.js +85 -3
- package/dist/shared/jobs-view.d.ts +1 -1
- package/dist/shared/jobs-view.d.ts.map +1 -1
- package/dist/shared/jobs-view.js +2 -0
- package/dist/task-transfer.d.ts +21 -0
- package/dist/task-transfer.d.ts.map +1 -1
- package/dist/task-transfer.js +64 -3
- package/dist/templates.d.ts +2 -2
- package/dist/templates.d.ts.map +1 -1
- package/dist/templates.js +3 -3
- package/dist/types.d.ts +22 -2
- package/dist/types.d.ts.map +1 -1
- package/dist/workspaces.d.ts.map +1 -1
- package/dist/workspaces.js +34 -11
- package/docs/ARCHITECTURE.md +319 -66
- package/docs/COMPATIBILITY.md +2 -2
- package/docs/CONCEPT.md +18 -4
- package/docs/CROSS_PLATFORM.ru.md +20 -0
- package/docs/CROSS_PLATFORM.zh.md +18 -0
- package/docs/EXECUTION-LOOP.md +28 -10
- package/docs/FEATURES.md +129 -7
- package/docs/FEATURES.zh.md +97 -6
- package/docs/MIGRATION.md +2 -2
- package/docs/PIPELINE.md +293 -0
- package/docs/QA-A2-GUI-TUI.md +205 -0
- package/docs/README.ru.md +43 -4
- package/docs/README.zh.md +44 -4
- package/docs/SAFETY.md +23 -3
- package/gui-experimental.cjs +9 -8
- package/locales/en.json +58 -3
- package/locales/ru.json +58 -3
- package/locales/zh.json +58 -3
- package/opencode.pipeline.yaml +35 -0
- package/package.json +36 -4
- package/scripts/check-eslint-baseline.mjs +139 -0
- package/scripts/gen-test-plan-counters.mjs +117 -0
- package/scripts/github-ci-fetch.ps1 +37 -0
- package/scripts/pl-commit.ps1 +112 -0
- package/scripts/qa-a2-commit.ps1 +104 -0
- package/scripts/test-home.mjs +107 -0
- package/skills/scheduled-job-best-practices/SKILL.md +95 -1
- package/skills/scheduled-job-best-practices/references/recipes.md +139 -0
- package/src/cli.ts +417 -0
- package/src/core/analytics.ts +27 -4
- package/src/core/audit.ts +25 -0
- package/src/core/budget.ts +340 -0
- package/src/core/cron-to-schtasks.ts +42 -0
- package/src/core/dry-run.ts +235 -12
- package/src/core/execution.ts +538 -0
- package/src/core/feedback.ts +582 -0
- package/src/core/file-watcher.ts +2 -2
- package/src/core/gate-integrity.ts +330 -0
- package/src/core/git-trigger.ts +18 -5
- package/src/core/guard-run.ts +119 -0
- package/src/core/guard.ts +431 -0
- package/src/core/local-ai.ts +7 -3
- package/src/core/lock.ts +178 -37
- package/src/core/matrix.ts +158 -52
- package/src/core/mission.ts +531 -0
- package/src/core/native-notify.ts +1 -1
- package/src/core/opencode-models.ts +30 -21
- package/src/core/opencode-usage.ts +182 -0
- package/src/core/pipeline-apply.ts +158 -0
- package/src/core/pipeline-io.ts +96 -0
- package/src/core/pipeline-map.ts +283 -0
- package/src/core/pipeline-spec.ts +775 -0
- package/src/core/ps-wrapper.ts +435 -66
- package/src/core/record-history.ts +258 -81
- package/src/core/router/rules.ts +6 -0
- package/src/core/run-mode.ts +19 -0
- package/src/core/schedule-gate.ts +1 -1
- package/src/core/scheduler/at-fallback.ts +1 -1
- package/src/core/scheduler/linux.ts +40 -11
- package/src/core/scheduler/logs.ts +34 -3
- package/src/core/scheduler/mac.ts +174 -14
- package/src/core/scheduler/registry.ts +2 -2
- package/src/core/scheduler/windows.ts +19 -15
- package/src/core/secrets.ts +26 -19
- package/src/core/self-analysis.ts +75 -29
- package/src/core/shutdown.ts +90 -4
- package/src/core/structured-log.ts +89 -5
- package/src/core/telegram.ts +2 -2
- package/src/core/triage-worker.ts +7 -7
- package/src/core/triage.ts +2 -2
- package/src/core/usage-surface.ts +70 -0
- package/src/core/worktree-run.ts +199 -0
- package/src/core/worktree.ts +600 -0
- package/src/core/wrappers/bash.ts +248 -26
- package/src/db/capability-repo.ts +127 -10
- package/src/db/history-repo.ts +281 -40
- package/src/db/metrics-repo.ts +40 -13
- package/src/db/migrate.ts +57 -32
- package/src/db/recovery.ts +12 -5
- package/src/db/run-journal.ts +100 -13
- package/src/db/run-resume.ts +17 -1
- package/src/db/runs-repo.ts +147 -65
- package/src/db/schema.ts +134 -2
- package/src/db/templates-repo.ts +5 -3
- package/src/gui.tsx +438 -18
- package/src/history.ts +11 -4
- package/src/hook-output.ts +39 -0
- package/src/i18n.ts +12 -4
- package/src/index.ts +1902 -320
- package/src/notifications.ts +227 -47
- package/src/profiles.ts +88 -10
- package/src/rpc.ts +158 -0
- package/src/server.ts +201 -41
- package/src/settings.ts +125 -5
- package/src/shared/jobs-view.ts +3 -1
- package/src/task-transfer.ts +90 -6
- package/src/templates.ts +3 -3
- package/src/types.ts +23 -2
- package/src/workspaces.ts +37 -14
|
@@ -0,0 +1,203 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* AC-1: единый путь исполнения.
|
|
3
|
+
*
|
|
4
|
+
* Любой запуск — зарегистрированная задача или ad-hoc миссия — сначала
|
|
5
|
+
* превращается в `RunContext` (вход, задача, профиль, безопасность), затем в
|
|
6
|
+
* план `createRun → декомпозиция → маршрут → исполнение → GATE → ledger`.
|
|
7
|
+
* Транспорт (OpenCode, локальная модель, облако) скрыт за `StepExecutor`,
|
|
8
|
+
* поэтому ядро не зависит от конкретного CLI.
|
|
9
|
+
*
|
|
10
|
+
* Модуль намеренно не запускает процессы сам: исполнитель передаётся снаружи.
|
|
11
|
+
* Это позволяет тестировать путь без регистрации задачи в ОС и подменять
|
|
12
|
+
* OpenCode на любой другой транспорт.
|
|
13
|
+
*/
|
|
14
|
+
import { type MissionDecomposer, type MissionStep, type PlanSource } from "./router/planner.js";
|
|
15
|
+
import { type StepRoute } from "./router/dispatch.js";
|
|
16
|
+
import type { CapabilityThresholds } from "../db/capability-repo.js";
|
|
17
|
+
/** Откуда пришёл запуск. Оба источника идут одним путём. */
|
|
18
|
+
export type RunOrigin = "registered" | "ad-hoc";
|
|
19
|
+
/** Что инициировало запуск. */
|
|
20
|
+
export type RunTrigger = "manual" | "cron" | "file" | "git" | "mcp-event" | "once";
|
|
21
|
+
/** Политика доступа к инструментам (совпадает с core/permissions). */
|
|
22
|
+
export type RunPermissionPolicy = "hybrid" | "secure" | "legacy";
|
|
23
|
+
/** Профиль исполнения: модель, сессия и рабочее пространство. */
|
|
24
|
+
export interface RunProfile {
|
|
25
|
+
model?: string | null;
|
|
26
|
+
session?: "new" | "reuse" | "last";
|
|
27
|
+
sessionId?: string | null;
|
|
28
|
+
workspaceId?: string | null;
|
|
29
|
+
}
|
|
30
|
+
/** Контракт безопасности запуска. */
|
|
31
|
+
export interface RunSafety {
|
|
32
|
+
policy: RunPermissionPolicy;
|
|
33
|
+
allowedTools?: readonly string[];
|
|
34
|
+
deniedTools?: readonly string[];
|
|
35
|
+
}
|
|
36
|
+
/**
|
|
37
|
+
* AC-1.1: контракт контекста запуска.
|
|
38
|
+
* Содержит всё, что нужно ядру до первого шага, и не содержит транспорта.
|
|
39
|
+
*/
|
|
40
|
+
export interface RunContext {
|
|
41
|
+
origin: RunOrigin;
|
|
42
|
+
trigger: RunTrigger;
|
|
43
|
+
taskName: string;
|
|
44
|
+
/** Исходная миссия/промпт, по которой строится план. */
|
|
45
|
+
mission: string;
|
|
46
|
+
/** Промпт, который получит исполнитель (обычно совпадает с mission). */
|
|
47
|
+
prompt: string;
|
|
48
|
+
cwd: string;
|
|
49
|
+
/** Явный тип задачи: если задан, декомпозиция не нужна. */
|
|
50
|
+
taskType?: string;
|
|
51
|
+
profile: RunProfile;
|
|
52
|
+
safety: RunSafety;
|
|
53
|
+
/** Свободные метаданные: родительский запуск, матрица, источник. */
|
|
54
|
+
metadata?: Record<string, unknown>;
|
|
55
|
+
}
|
|
56
|
+
/** Структурный минимум определения зарегистрированной задачи. */
|
|
57
|
+
export interface RegisteredTaskLike {
|
|
58
|
+
name: string;
|
|
59
|
+
prompt: string;
|
|
60
|
+
taskType?: string;
|
|
61
|
+
schedule?: string;
|
|
62
|
+
priority?: number;
|
|
63
|
+
model?: string | null;
|
|
64
|
+
workingDirectory?: string;
|
|
65
|
+
workdir?: string;
|
|
66
|
+
workspaceId?: string;
|
|
67
|
+
session?: "new" | "reuse" | "last";
|
|
68
|
+
sessionId?: string | null;
|
|
69
|
+
allowedTools?: string[];
|
|
70
|
+
deniedTools?: string[];
|
|
71
|
+
triggerType?: RunTrigger;
|
|
72
|
+
qualityGate?: string;
|
|
73
|
+
beforeScript?: string;
|
|
74
|
+
afterScript?: string;
|
|
75
|
+
}
|
|
76
|
+
/** Опции фабрик контекста. */
|
|
77
|
+
export interface RunContextOverrides {
|
|
78
|
+
cwd?: string;
|
|
79
|
+
taskName?: string;
|
|
80
|
+
taskType?: string;
|
|
81
|
+
trigger?: RunTrigger;
|
|
82
|
+
policy?: RunPermissionPolicy;
|
|
83
|
+
profile?: Partial<RunProfile>;
|
|
84
|
+
safety?: Partial<RunSafety>;
|
|
85
|
+
metadata?: Record<string, unknown>;
|
|
86
|
+
}
|
|
87
|
+
/**
|
|
88
|
+
* AC-1.1: контекст зарегистрированной задачи. Определение из БД — только
|
|
89
|
+
* источник данных; дальнейший путь не отличается от ad-hoc.
|
|
90
|
+
*/
|
|
91
|
+
export declare function createRegisteredRunContext(definition: RegisteredTaskLike, overrides?: RunContextOverrides): RunContext;
|
|
92
|
+
/** AC-1.1: контекст ad-hoc миссии — без записи в ОС и без task definition. */
|
|
93
|
+
export declare function createAdHocRunContext(mission: string, overrides?: RunContextOverrides): RunContext;
|
|
94
|
+
/** Проверяет контракт безопасности до создания запуска. */
|
|
95
|
+
export declare function validateRunContext(context: RunContext): void;
|
|
96
|
+
/** Один шаг плана с готовым маршрутом (AC-1.3: трассировка). */
|
|
97
|
+
export interface PlannedStep extends MissionStep {
|
|
98
|
+
order: number;
|
|
99
|
+
route: StepRoute;
|
|
100
|
+
}
|
|
101
|
+
/** План исполнения: контекст + шаги + источник декомпозиции. */
|
|
102
|
+
export interface ExecutionPlan {
|
|
103
|
+
context: RunContext;
|
|
104
|
+
steps: PlannedStep[];
|
|
105
|
+
source: PlanSource;
|
|
106
|
+
ambiguousTaskTypes: string[];
|
|
107
|
+
warnings: string[];
|
|
108
|
+
}
|
|
109
|
+
/** Опции построения плана. */
|
|
110
|
+
export interface BuildPlanOptions {
|
|
111
|
+
maxSteps?: number;
|
|
112
|
+
decomposer?: MissionDecomposer;
|
|
113
|
+
thresholds?: CapabilityThresholds;
|
|
114
|
+
}
|
|
115
|
+
/**
|
|
116
|
+
* AC-1.3: строит план и маршрут каждого шага до первого исполнения.
|
|
117
|
+
* Сам по себе план ничего не запускает — это и есть dry-run.
|
|
118
|
+
*/
|
|
119
|
+
export declare function buildExecutionPlan(context: RunContext, options?: BuildPlanOptions): Promise<ExecutionPlan>;
|
|
120
|
+
/** Человекочитаемая трассировка маршрута для dry-run и логов. */
|
|
121
|
+
export declare function describeExecutionPlan(plan: ExecutionPlan): string;
|
|
122
|
+
/** Вход исполнителя шага: всё, что нужно транспорту, без знания о ядре. */
|
|
123
|
+
export interface StepExecutionInput {
|
|
124
|
+
step: PlannedStep;
|
|
125
|
+
context: RunContext;
|
|
126
|
+
/** Полный план — исполнителю может понадобиться предыдущий шаг. */
|
|
127
|
+
plan: ExecutionPlan;
|
|
128
|
+
}
|
|
129
|
+
/** Результат исполнителя шага. */
|
|
130
|
+
export interface StepExecutionResult {
|
|
131
|
+
output?: unknown;
|
|
132
|
+
/** Явная ошибка без исключения; ядро переведёт шаг в failed. */
|
|
133
|
+
error?: string;
|
|
134
|
+
}
|
|
135
|
+
/**
|
|
136
|
+
* AC-1.2: абстракция исполнителя. Ядро не знает, OpenCode это, локальная
|
|
137
|
+
* модель или облачный API — только умеет ли исполнитель взять маршрут.
|
|
138
|
+
*/
|
|
139
|
+
export interface StepExecutor {
|
|
140
|
+
readonly id: string;
|
|
141
|
+
supports(route: StepRoute): boolean;
|
|
142
|
+
execute(input: StepExecutionInput): Promise<StepExecutionResult> | StepExecutionResult;
|
|
143
|
+
}
|
|
144
|
+
/** HTTP-/CLI-независимый исполнитель OpenCode: транспорт передаётся функцией. */
|
|
145
|
+
export interface OpenCodeInvocation {
|
|
146
|
+
prompt: string;
|
|
147
|
+
cwd: string;
|
|
148
|
+
model: string | null;
|
|
149
|
+
session: RunProfile["session"];
|
|
150
|
+
sessionId: string | null;
|
|
151
|
+
step: PlannedStep;
|
|
152
|
+
context: RunContext;
|
|
153
|
+
}
|
|
154
|
+
export declare function createOpenCodeExecutor(invoke: (input: OpenCodeInvocation) => Promise<unknown> | unknown, id?: string): StepExecutor;
|
|
155
|
+
/** Вердикт GATE после шага. */
|
|
156
|
+
export interface GateVerdict {
|
|
157
|
+
ok: boolean;
|
|
158
|
+
reason?: string;
|
|
159
|
+
}
|
|
160
|
+
export type Gate = (input: StepExecutionInput & {
|
|
161
|
+
result: StepExecutionResult;
|
|
162
|
+
}) => GateVerdict | Promise<GateVerdict>;
|
|
163
|
+
/** Ошибка GATE: шаг выполнен, но результат не принят. */
|
|
164
|
+
export declare class GateRejectedError extends Error {
|
|
165
|
+
constructor(reason: string);
|
|
166
|
+
}
|
|
167
|
+
/** Результат выполнения одного шага. */
|
|
168
|
+
export interface ExecutedStep {
|
|
169
|
+
stepName: string;
|
|
170
|
+
taskType: string;
|
|
171
|
+
target: StepRoute["target"];
|
|
172
|
+
status: "passed" | "failed" | "skipped";
|
|
173
|
+
attempt: number;
|
|
174
|
+
output?: unknown;
|
|
175
|
+
error?: string;
|
|
176
|
+
}
|
|
177
|
+
/** Результат выполнения плана. */
|
|
178
|
+
export interface ExecutionResult {
|
|
179
|
+
runId: string;
|
|
180
|
+
status: "passed" | "failed";
|
|
181
|
+
steps: ExecutedStep[];
|
|
182
|
+
error: string | null;
|
|
183
|
+
plan: ExecutionPlan;
|
|
184
|
+
}
|
|
185
|
+
/** Опции исполнения. */
|
|
186
|
+
export interface ExecutePlanOptions {
|
|
187
|
+
/** Исполнители в порядке приоритета. */
|
|
188
|
+
executors: StepExecutor[];
|
|
189
|
+
gate?: Gate;
|
|
190
|
+
/** Останавливаться на первой ошибке (по умолчанию true). */
|
|
191
|
+
stopOnError?: boolean;
|
|
192
|
+
/** Дополнительные метаданные запуска. */
|
|
193
|
+
metadata?: Record<string, unknown>;
|
|
194
|
+
}
|
|
195
|
+
/**
|
|
196
|
+
* AC-1.4: единое исполнение плана для зарегистрированной и ad-hoc миссии.
|
|
197
|
+
*
|
|
198
|
+
* Создаёт запуск в ledger, для каждого шага фиксирует running/passed/failed,
|
|
199
|
+
* применяет GATE и завершает запуск. Шаги `review`/`explore` пропускаются:
|
|
200
|
+
* их нельзя исполнить автоматически.
|
|
201
|
+
*/
|
|
202
|
+
export declare function executeExecutionPlan(plan: ExecutionPlan, options: ExecutePlanOptions): Promise<ExecutionResult>;
|
|
203
|
+
//# sourceMappingURL=execution.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"execution.d.ts","sourceRoot":"","sources":["../../src/core/execution.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,309 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* AC-1: единый путь исполнения.
|
|
3
|
+
*
|
|
4
|
+
* Любой запуск — зарегистрированная задача или ad-hoc миссия — сначала
|
|
5
|
+
* превращается в `RunContext` (вход, задача, профиль, безопасность), затем в
|
|
6
|
+
* план `createRun → декомпозиция → маршрут → исполнение → GATE → ledger`.
|
|
7
|
+
* Транспорт (OpenCode, локальная модель, облако) скрыт за `StepExecutor`,
|
|
8
|
+
* поэтому ядро не зависит от конкретного CLI.
|
|
9
|
+
*
|
|
10
|
+
* Модуль намеренно не запускает процессы сам: исполнитель передаётся снаружи.
|
|
11
|
+
* Это позволяет тестировать путь без регистрации задачи в ОС и подменять
|
|
12
|
+
* OpenCode на любой другой транспорт.
|
|
13
|
+
*/
|
|
14
|
+
import { createRun, finishRun, finishStep, getStep, startRun, } from "../db/runs-repo.js";
|
|
15
|
+
import { runStepStatefullyAsync } from "../db/run-journal.js";
|
|
16
|
+
import { planMission, } from "./router/planner.js";
|
|
17
|
+
import { routeStep } from "./router/dispatch.js";
|
|
18
|
+
function normalizeList(values) {
|
|
19
|
+
if (!Array.isArray(values))
|
|
20
|
+
return undefined;
|
|
21
|
+
const cleaned = values
|
|
22
|
+
.filter((value) => typeof value === "string")
|
|
23
|
+
.map((value) => value.trim())
|
|
24
|
+
.filter(Boolean);
|
|
25
|
+
return cleaned.length > 0 ? cleaned : undefined;
|
|
26
|
+
}
|
|
27
|
+
function assertNonEmpty(value, field) {
|
|
28
|
+
const text = value.trim();
|
|
29
|
+
if (!text)
|
|
30
|
+
throw new Error(`Пустой ${field}: запуск невозможен`);
|
|
31
|
+
return text;
|
|
32
|
+
}
|
|
33
|
+
function normalizePolicy(policy) {
|
|
34
|
+
return policy === "secure" || policy === "legacy" ? policy : "hybrid";
|
|
35
|
+
}
|
|
36
|
+
/**
|
|
37
|
+
* AC-1.1: контекст зарегистрированной задачи. Определение из БД — только
|
|
38
|
+
* источник данных; дальнейший путь не отличается от ad-hoc.
|
|
39
|
+
*/
|
|
40
|
+
export function createRegisteredRunContext(definition, overrides = {}) {
|
|
41
|
+
const taskName = assertNonEmpty(overrides.taskName ?? definition.name, "имя задачи");
|
|
42
|
+
const prompt = assertNonEmpty(definition.prompt, "промпт задачи");
|
|
43
|
+
const cwd = overrides.cwd?.trim() ||
|
|
44
|
+
definition.workingDirectory?.trim() ||
|
|
45
|
+
definition.workdir?.trim() ||
|
|
46
|
+
process.cwd();
|
|
47
|
+
const safety = {
|
|
48
|
+
policy: normalizePolicy(overrides.safety?.policy ?? overrides.policy),
|
|
49
|
+
allowedTools: normalizeList(overrides.safety?.allowedTools ?? definition.allowedTools),
|
|
50
|
+
deniedTools: normalizeList(overrides.safety?.deniedTools ?? definition.deniedTools),
|
|
51
|
+
};
|
|
52
|
+
return {
|
|
53
|
+
origin: "registered",
|
|
54
|
+
trigger: overrides.trigger ?? definition.triggerType ?? "manual",
|
|
55
|
+
taskName,
|
|
56
|
+
mission: prompt,
|
|
57
|
+
prompt,
|
|
58
|
+
cwd,
|
|
59
|
+
...(overrides.taskType ?? definition.taskType
|
|
60
|
+
? { taskType: overrides.taskType ?? definition.taskType }
|
|
61
|
+
: {}),
|
|
62
|
+
profile: {
|
|
63
|
+
model: overrides.profile?.model ?? definition.model ?? null,
|
|
64
|
+
session: overrides.profile?.session ?? definition.session ?? "new",
|
|
65
|
+
sessionId: overrides.profile?.sessionId ?? definition.sessionId ?? null,
|
|
66
|
+
workspaceId: overrides.profile?.workspaceId ?? definition.workspaceId ?? null,
|
|
67
|
+
},
|
|
68
|
+
safety,
|
|
69
|
+
metadata: {
|
|
70
|
+
...(overrides.metadata ?? {}),
|
|
71
|
+
schedule: definition.schedule ?? null,
|
|
72
|
+
priority: definition.priority ?? 5,
|
|
73
|
+
qualityGate: definition.qualityGate ?? null,
|
|
74
|
+
beforeScript: definition.beforeScript ?? null,
|
|
75
|
+
afterScript: definition.afterScript ?? null,
|
|
76
|
+
},
|
|
77
|
+
};
|
|
78
|
+
}
|
|
79
|
+
/** AC-1.1: контекст ad-hoc миссии — без записи в ОС и без task definition. */
|
|
80
|
+
export function createAdHocRunContext(mission, overrides = {}) {
|
|
81
|
+
const text = assertNonEmpty(mission, "миссия");
|
|
82
|
+
const taskName = assertNonEmpty(overrides.taskName ?? "ad-hoc", "имя запуска");
|
|
83
|
+
const cwd = overrides.cwd?.trim() || process.cwd();
|
|
84
|
+
return {
|
|
85
|
+
origin: "ad-hoc",
|
|
86
|
+
trigger: overrides.trigger ?? "manual",
|
|
87
|
+
taskName,
|
|
88
|
+
mission: text,
|
|
89
|
+
prompt: text,
|
|
90
|
+
cwd,
|
|
91
|
+
...(overrides.taskType ? { taskType: overrides.taskType } : {}),
|
|
92
|
+
profile: {
|
|
93
|
+
model: overrides.profile?.model ?? null,
|
|
94
|
+
session: overrides.profile?.session ?? "new",
|
|
95
|
+
sessionId: overrides.profile?.sessionId ?? null,
|
|
96
|
+
workspaceId: overrides.profile?.workspaceId ?? null,
|
|
97
|
+
},
|
|
98
|
+
safety: {
|
|
99
|
+
policy: normalizePolicy(overrides.safety?.policy ?? overrides.policy),
|
|
100
|
+
allowedTools: normalizeList(overrides.safety?.allowedTools),
|
|
101
|
+
deniedTools: normalizeList(overrides.safety?.deniedTools),
|
|
102
|
+
},
|
|
103
|
+
metadata: overrides.metadata,
|
|
104
|
+
};
|
|
105
|
+
}
|
|
106
|
+
/** Проверяет контракт безопасности до создания запуска. */
|
|
107
|
+
export function validateRunContext(context) {
|
|
108
|
+
assertNonEmpty(context.taskName, "имя запуска");
|
|
109
|
+
assertNonEmpty(context.prompt, "промпт запуска");
|
|
110
|
+
assertNonEmpty(context.cwd, "рабочая директория");
|
|
111
|
+
if (!["hybrid", "secure", "legacy"].includes(context.safety.policy)) {
|
|
112
|
+
throw new Error(`Неизвестная политика безопасности: ${String(context.safety.policy)}`);
|
|
113
|
+
}
|
|
114
|
+
const allowed = new Set(context.safety.allowedTools ?? []);
|
|
115
|
+
const denied = context.safety.deniedTools ?? [];
|
|
116
|
+
const conflict = denied.find((tool) => allowed.has(tool));
|
|
117
|
+
if (conflict) {
|
|
118
|
+
throw new Error(`Инструмент "${conflict}" одновременно разрешён и запрещён`);
|
|
119
|
+
}
|
|
120
|
+
}
|
|
121
|
+
function planStepsForContext(context, options) {
|
|
122
|
+
if (context.taskType) {
|
|
123
|
+
return Promise.resolve({
|
|
124
|
+
steps: [{ stepName: context.taskName, taskType: context.taskType }],
|
|
125
|
+
source: "heuristic",
|
|
126
|
+
ambiguous: [],
|
|
127
|
+
});
|
|
128
|
+
}
|
|
129
|
+
return planMission(context.mission, {
|
|
130
|
+
maxSteps: options.maxSteps,
|
|
131
|
+
decomposer: options.decomposer,
|
|
132
|
+
}).then((plan) => ({
|
|
133
|
+
steps: plan.steps,
|
|
134
|
+
source: plan.source,
|
|
135
|
+
ambiguous: plan.ambiguousTaskTypes,
|
|
136
|
+
}));
|
|
137
|
+
}
|
|
138
|
+
/**
|
|
139
|
+
* AC-1.3: строит план и маршрут каждого шага до первого исполнения.
|
|
140
|
+
* Сам по себе план ничего не запускает — это и есть dry-run.
|
|
141
|
+
*/
|
|
142
|
+
export async function buildExecutionPlan(context, options = {}) {
|
|
143
|
+
validateRunContext(context);
|
|
144
|
+
const planned = await planStepsForContext(context, options);
|
|
145
|
+
const warnings = [];
|
|
146
|
+
const steps = planned.steps.map((step, order) => {
|
|
147
|
+
const route = routeStep(step.taskType, options.thresholds);
|
|
148
|
+
if (route.target === "review" || route.target === "explore") {
|
|
149
|
+
warnings.push(`Шаг "${step.stepName}" (${step.taskType}) не исполняется автоматически: ${route.reason}`);
|
|
150
|
+
}
|
|
151
|
+
return { ...step, order, route };
|
|
152
|
+
});
|
|
153
|
+
return {
|
|
154
|
+
context,
|
|
155
|
+
steps,
|
|
156
|
+
source: planned.source,
|
|
157
|
+
ambiguousTaskTypes: planned.ambiguous,
|
|
158
|
+
warnings,
|
|
159
|
+
};
|
|
160
|
+
}
|
|
161
|
+
/** Человекочитаемая трассировка маршрута для dry-run и логов. */
|
|
162
|
+
export function describeExecutionPlan(plan) {
|
|
163
|
+
const lines = [
|
|
164
|
+
`План ${plan.context.origin}: ${plan.context.taskName} → ${plan.steps.length} шаг(ов), источник ${plan.source}`,
|
|
165
|
+
];
|
|
166
|
+
for (const step of plan.steps) {
|
|
167
|
+
const route = step.route;
|
|
168
|
+
const target = route.executor ? `${route.executor}/${route.transport}` : route.target;
|
|
169
|
+
lines.push(` ${step.order + 1}. ${step.stepName} [${route.taskType}] → ${target} (${route.source}: ${route.reason})`);
|
|
170
|
+
}
|
|
171
|
+
for (const warning of plan.warnings)
|
|
172
|
+
lines.push(` ! ${warning}`);
|
|
173
|
+
return lines.join("\n");
|
|
174
|
+
}
|
|
175
|
+
export function createOpenCodeExecutor(invoke, id = "opencode") {
|
|
176
|
+
return {
|
|
177
|
+
id,
|
|
178
|
+
supports: (route) => route.executor !== null,
|
|
179
|
+
async execute({ step, context, plan }) {
|
|
180
|
+
const output = await invoke({
|
|
181
|
+
prompt: plan.context.prompt,
|
|
182
|
+
cwd: plan.context.cwd,
|
|
183
|
+
model: plan.context.profile.model ?? null,
|
|
184
|
+
session: plan.context.profile.session ?? "new",
|
|
185
|
+
sessionId: plan.context.profile.sessionId ?? null,
|
|
186
|
+
step,
|
|
187
|
+
context,
|
|
188
|
+
});
|
|
189
|
+
return { output };
|
|
190
|
+
},
|
|
191
|
+
};
|
|
192
|
+
}
|
|
193
|
+
/** Ошибка GATE: шаг выполнен, но результат не принят. */
|
|
194
|
+
export class GateRejectedError extends Error {
|
|
195
|
+
constructor(reason) {
|
|
196
|
+
super(reason);
|
|
197
|
+
this.name = "GateRejectedError";
|
|
198
|
+
}
|
|
199
|
+
}
|
|
200
|
+
function pickExecutor(step, executors) {
|
|
201
|
+
return executors.find((executor) => executor.supports(step.route));
|
|
202
|
+
}
|
|
203
|
+
function errorMessage(error) {
|
|
204
|
+
return error instanceof Error ? error.message : String(error);
|
|
205
|
+
}
|
|
206
|
+
/**
|
|
207
|
+
* AC-1.4: единое исполнение плана для зарегистрированной и ad-hoc миссии.
|
|
208
|
+
*
|
|
209
|
+
* Создаёт запуск в ledger, для каждого шага фиксирует running/passed/failed,
|
|
210
|
+
* применяет GATE и завершает запуск. Шаги `review`/`explore` пропускаются:
|
|
211
|
+
* их нельзя исполнить автоматически.
|
|
212
|
+
*/
|
|
213
|
+
export async function executeExecutionPlan(plan, options) {
|
|
214
|
+
validateRunContext(plan.context);
|
|
215
|
+
const run = createRun({
|
|
216
|
+
taskName: plan.context.taskName,
|
|
217
|
+
steps: plan.steps.map((step) => ({ stepName: step.stepName })),
|
|
218
|
+
metadata: {
|
|
219
|
+
origin: plan.context.origin,
|
|
220
|
+
trigger: plan.context.trigger,
|
|
221
|
+
planSource: plan.source,
|
|
222
|
+
routes: plan.steps.map((step) => ({
|
|
223
|
+
stepName: step.stepName,
|
|
224
|
+
taskType: step.route.taskType,
|
|
225
|
+
target: step.route.target,
|
|
226
|
+
transport: step.route.transport,
|
|
227
|
+
executor: step.route.executor,
|
|
228
|
+
source: step.route.source,
|
|
229
|
+
reason: step.route.reason,
|
|
230
|
+
})),
|
|
231
|
+
...(plan.context.metadata ?? {}),
|
|
232
|
+
...(options.metadata ?? {}),
|
|
233
|
+
},
|
|
234
|
+
});
|
|
235
|
+
startRun(run.id);
|
|
236
|
+
const executed = [];
|
|
237
|
+
let firstError = null;
|
|
238
|
+
const stopOnError = options.stopOnError !== false;
|
|
239
|
+
for (const step of plan.steps) {
|
|
240
|
+
const executor = step.route.executor === null ? undefined : pickExecutor(step, options.executors);
|
|
241
|
+
// review/explore или нет подходящего транспорта — шаг не исполняется.
|
|
242
|
+
if (!executor) {
|
|
243
|
+
const record = getStep(run.id, step.stepName);
|
|
244
|
+
const reason = step.route.executor === null
|
|
245
|
+
? `маршрут ${step.route.target}: ${step.route.reason}`
|
|
246
|
+
: `нет исполнителя для маршрута ${step.route.executor}/${String(step.route.transport)}`;
|
|
247
|
+
if (record) {
|
|
248
|
+
finishStep(record.id, "skipped", { error: reason });
|
|
249
|
+
}
|
|
250
|
+
executed.push({
|
|
251
|
+
stepName: step.stepName,
|
|
252
|
+
taskType: step.route.taskType,
|
|
253
|
+
target: step.route.target,
|
|
254
|
+
status: "skipped",
|
|
255
|
+
attempt: record?.attempt ?? 0,
|
|
256
|
+
error: reason,
|
|
257
|
+
});
|
|
258
|
+
continue;
|
|
259
|
+
}
|
|
260
|
+
try {
|
|
261
|
+
const execution = await runStepStatefullyAsync(run.id, step.stepName, async () => {
|
|
262
|
+
const result = await executor.execute({ step, context: plan.context, plan });
|
|
263
|
+
if (result.error) {
|
|
264
|
+
throw new Error(result.error);
|
|
265
|
+
}
|
|
266
|
+
if (options.gate) {
|
|
267
|
+
const verdict = await options.gate({ step, context: plan.context, plan, result });
|
|
268
|
+
if (!verdict.ok) {
|
|
269
|
+
throw new GateRejectedError(verdict.reason ?? "GATE отклонил результат шага");
|
|
270
|
+
}
|
|
271
|
+
}
|
|
272
|
+
return result.output;
|
|
273
|
+
});
|
|
274
|
+
executed.push({
|
|
275
|
+
stepName: step.stepName,
|
|
276
|
+
taskType: step.route.taskType,
|
|
277
|
+
target: step.route.target,
|
|
278
|
+
status: "passed",
|
|
279
|
+
attempt: execution.attempt,
|
|
280
|
+
output: execution.result,
|
|
281
|
+
});
|
|
282
|
+
}
|
|
283
|
+
catch (error) {
|
|
284
|
+
const message = errorMessage(error);
|
|
285
|
+
firstError = firstError ?? message;
|
|
286
|
+
executed.push({
|
|
287
|
+
stepName: step.stepName,
|
|
288
|
+
taskType: step.route.taskType,
|
|
289
|
+
target: step.route.target,
|
|
290
|
+
status: "failed",
|
|
291
|
+
attempt: getStep(run.id, step.stepName)?.attempt ?? 1,
|
|
292
|
+
error: message,
|
|
293
|
+
});
|
|
294
|
+
if (stopOnError)
|
|
295
|
+
break;
|
|
296
|
+
}
|
|
297
|
+
}
|
|
298
|
+
const failed = executed.some((step) => step.status === "failed");
|
|
299
|
+
finishRun(run.id, failed ? "failed" : "passed", {
|
|
300
|
+
...(firstError ? { error: firstError } : {}),
|
|
301
|
+
});
|
|
302
|
+
return {
|
|
303
|
+
runId: run.id,
|
|
304
|
+
status: failed ? "failed" : "passed",
|
|
305
|
+
steps: executed,
|
|
306
|
+
error: firstError,
|
|
307
|
+
plan,
|
|
308
|
+
};
|
|
309
|
+
}
|