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,531 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* AB-8: ad-hoc миссия (`run_mission`) — полоса B execution model.
|
|
3
|
+
*
|
|
4
|
+
* Миссия проходит тот же путь, что и зарегистрированная задача:
|
|
5
|
+
* `createRun → план → маршрут → исполнение → GATE → ledger`. Отличие только
|
|
6
|
+
* в источнике входа: задача не создаётся и не регистрируется в планировщике
|
|
7
|
+
* ОС. Исполнение идёт через обёртку (lock, таймаут, политика прав, Quality
|
|
8
|
+
* Gate, запись истории), но без `schtasks`/`crontab`/`launchd`.
|
|
9
|
+
*/
|
|
10
|
+
|
|
11
|
+
import { spawn } from "node:child_process";
|
|
12
|
+
import crypto from "node:crypto";
|
|
13
|
+
import fs from "node:fs/promises";
|
|
14
|
+
import { createRequire } from "node:module";
|
|
15
|
+
import path from "node:path";
|
|
16
|
+
import { LOG_DIR, sanitizeName } from "../types.js";
|
|
17
|
+
import {
|
|
18
|
+
buildExecutionPlan,
|
|
19
|
+
createAdHocRunContext,
|
|
20
|
+
describeExecutionPlan,
|
|
21
|
+
executeExecutionPlan,
|
|
22
|
+
type ExecutionPlan,
|
|
23
|
+
type ExecutionResult,
|
|
24
|
+
type RunContext,
|
|
25
|
+
type RunPermissionPolicy,
|
|
26
|
+
type StepExecutor,
|
|
27
|
+
} from "./execution.js";
|
|
28
|
+
import { buildOpencodeConfig } from "./permissions.js";
|
|
29
|
+
import {
|
|
30
|
+
ensureWrapper,
|
|
31
|
+
lockFilePath,
|
|
32
|
+
writePromptFile,
|
|
33
|
+
writeWrapperCmd,
|
|
34
|
+
} from "./ps-wrapper.js";
|
|
35
|
+
import {
|
|
36
|
+
generateSessionId,
|
|
37
|
+
normalizeSessionMode,
|
|
38
|
+
sessionStatePath,
|
|
39
|
+
writeSessionStateFile,
|
|
40
|
+
type SessionMode,
|
|
41
|
+
} from "./session.js";
|
|
42
|
+
import { writeBashWrapper } from "./wrappers/bash.js";
|
|
43
|
+
|
|
44
|
+
/**
|
|
45
|
+
* Маркер начала прогона в логе задачи/миссии.
|
|
46
|
+
*
|
|
47
|
+
* Лог НЕ очищается перед запуском: при падении до первого вывода обёртки он
|
|
48
|
+
* остался бы пустым и диагностировать причину было бы невозможно. Маркер
|
|
49
|
+
* разделяет прогоны в общем файле и подтверждает, что запуск действительно
|
|
50
|
+
* дошёл до подготовки обёртки.
|
|
51
|
+
*/
|
|
52
|
+
export function formatLogRunMarker(
|
|
53
|
+
kind: "run" | "mission" | "prepare",
|
|
54
|
+
taskName: string,
|
|
55
|
+
now: Date = new Date(),
|
|
56
|
+
): string {
|
|
57
|
+
// "prepare" — задача только что создана/подготовлена, но ещё НЕ запускалась.
|
|
58
|
+
// ВАЖНО: не называть этот маркер "Run started", иначе в логе задачи
|
|
59
|
+
// появляется ложная запись о запуске при create/update/dry-run, хотя
|
|
60
|
+
// реального прогона не было (finding QA #8).
|
|
61
|
+
if (kind === "prepare") {
|
|
62
|
+
return `[agent-steward] === Task prepared ${now.toISOString()} (${taskName}) ===\n`;
|
|
63
|
+
}
|
|
64
|
+
const label = kind === "run" ? "Run" : "Mission";
|
|
65
|
+
return `[agent-steward] === ${label} started ${now.toISOString()} (${taskName}) ===\n`;
|
|
66
|
+
}
|
|
67
|
+
|
|
68
|
+
/**
|
|
69
|
+
* Возвращает часть лога, относящуюся только к последнему запуску.
|
|
70
|
+
*
|
|
71
|
+
* Лог намеренно дописывается, а не очищается (иначе при падении до первого
|
|
72
|
+
* вывода обёртки диагностировать причину было бы невозможно). Маркеры
|
|
73
|
+
* `Run started`/`Mission started` разделяют прогоны: потребителям лога
|
|
74
|
+
* нужно показывать и разбирать только последний сегмент. `Task prepared`
|
|
75
|
+
* маркером запуска НЕ считается — он пишется при создании/редактировании
|
|
76
|
+
* задачи, когда реального прогона ещё не было.
|
|
77
|
+
*/
|
|
78
|
+
export function extractLastRunLog(content: string): string {
|
|
79
|
+
const lines = content.replace(/^\uFEFF/, "").split(/\r?\n/);
|
|
80
|
+
let start = 0;
|
|
81
|
+
for (let i = 0; i < lines.length; i += 1) {
|
|
82
|
+
if (/^\[agent-steward\] === (Run|Mission) started /.test(lines[i])) {
|
|
83
|
+
start = i;
|
|
84
|
+
}
|
|
85
|
+
}
|
|
86
|
+
return lines.slice(start).join("\n");
|
|
87
|
+
}
|
|
88
|
+
|
|
89
|
+
/** AB-8.1: спецификация ad-hoc миссии (цель + safety-контракт). */
|
|
90
|
+
export interface MissionSpec {
|
|
91
|
+
/** Цель миссии — тот же промпт, что получил бы OpenCode. */
|
|
92
|
+
prompt: string;
|
|
93
|
+
/** Рабочая директория; по умолчанию — cwd процесса. */
|
|
94
|
+
cwd?: string;
|
|
95
|
+
/** Имя запуска в ledger; по умолчанию генерируется `ad-hoc-*`. */
|
|
96
|
+
taskName?: string;
|
|
97
|
+
/** Тип задачи для маршрутизатора; по умолчанию `mission` (local/direct). */
|
|
98
|
+
taskType?: string;
|
|
99
|
+
/** Модель OpenCode (пусто — модель по умолчанию). */
|
|
100
|
+
model?: string;
|
|
101
|
+
/** Режим сессии OpenCode. */
|
|
102
|
+
session?: SessionMode;
|
|
103
|
+
/** Идентификатор сессии для `session=reuse`. */
|
|
104
|
+
sessionId?: string;
|
|
105
|
+
/** Таймаут исполнения в секундах (по умолчанию 3600). */
|
|
106
|
+
timeoutSeconds?: number;
|
|
107
|
+
/** Quality Gate: команда, ненулевой код которой проваливает миссию. */
|
|
108
|
+
gate?: string;
|
|
109
|
+
/** Таймаут Quality Gate в секундах (по умолчанию 300). */
|
|
110
|
+
gateTimeoutSeconds?: number;
|
|
111
|
+
/** Политика прав: hybrid (по умолчанию), secure, legacy. */
|
|
112
|
+
policy?: RunPermissionPolicy;
|
|
113
|
+
/** Allowlist инструментов; непустой список блокирует остальные. */
|
|
114
|
+
allowedTools?: string[];
|
|
115
|
+
/** Denylist инструментов; выигрывает у allowlist. */
|
|
116
|
+
deniedTools?: string[];
|
|
117
|
+
/** Только построить план и показать трассировку, не исполняя. */
|
|
118
|
+
dryRun?: boolean;
|
|
119
|
+
}
|
|
120
|
+
|
|
121
|
+
/** Результат ad-hoc миссии. */
|
|
122
|
+
export interface MissionResult {
|
|
123
|
+
success: boolean;
|
|
124
|
+
dryRun: boolean;
|
|
125
|
+
runId: string | null;
|
|
126
|
+
status: ExecutionResult["status"] | "planned";
|
|
127
|
+
plan: ExecutionPlan;
|
|
128
|
+
description: string;
|
|
129
|
+
steps: ExecutionResult["steps"];
|
|
130
|
+
error: string | null;
|
|
131
|
+
logFile: string | null;
|
|
132
|
+
}
|
|
133
|
+
|
|
134
|
+
/** Зависимости для тестов: позволяют подменить исполнение без OpenCode. */
|
|
135
|
+
export interface MissionDependencies {
|
|
136
|
+
executor?: StepExecutor;
|
|
137
|
+
/** Хук после подготовки: тест может проверить отсутствие задач в ОС. */
|
|
138
|
+
onPrepared?: (info: { taskName: string; cwd: string }) => void;
|
|
139
|
+
}
|
|
140
|
+
|
|
141
|
+
const DEFAULT_TIMEOUT_SECONDS = 3600;
|
|
142
|
+
const MAX_TIMEOUT_SECONDS = 24 * 60 * 60;
|
|
143
|
+
|
|
144
|
+
/** Активные ad-hoc миссии по workspace — защита от двух миссий в одном репо. */
|
|
145
|
+
const activeWorkspaces = new Map<string, string>();
|
|
146
|
+
|
|
147
|
+
const requireFromCore = createRequire(import.meta.url);
|
|
148
|
+
|
|
149
|
+
/** Путь к скомпилированному record-history.js (как в index.ts). */
|
|
150
|
+
function recorderPath(): string {
|
|
151
|
+
const resolved = requireFromCore.resolve("./record-history.js");
|
|
152
|
+
if (!resolved.endsWith(".ts")) return resolved;
|
|
153
|
+
return resolved
|
|
154
|
+
.replace(/([\\/])src([\\/])/, "$1dist$2")
|
|
155
|
+
.replace(/\.ts$/, ".js");
|
|
156
|
+
}
|
|
157
|
+
|
|
158
|
+
function assertNonEmpty(value: unknown, label: string): string {
|
|
159
|
+
if (typeof value !== "string" || value.trim() === "") {
|
|
160
|
+
throw new Error(`Пустое поле миссии: ${label}.`);
|
|
161
|
+
}
|
|
162
|
+
return value.trim();
|
|
163
|
+
}
|
|
164
|
+
|
|
165
|
+
function positiveInt(value: unknown, label: string, fallback: number): number {
|
|
166
|
+
if (value === undefined || value === null) return fallback;
|
|
167
|
+
if (typeof value !== "number" || !Number.isInteger(value) || value <= 0) {
|
|
168
|
+
throw new Error(`Поле миссии "${label}" должно быть целым положительным числом.`);
|
|
169
|
+
}
|
|
170
|
+
return Math.min(value, MAX_TIMEOUT_SECONDS);
|
|
171
|
+
}
|
|
172
|
+
|
|
173
|
+
function normalizeTools(value: unknown, label: string): string[] | undefined {
|
|
174
|
+
if (value === undefined) return undefined;
|
|
175
|
+
if (!Array.isArray(value)) {
|
|
176
|
+
throw new Error(`Поле миссии "${label}" должно быть массивом строк.`);
|
|
177
|
+
}
|
|
178
|
+
const list = value
|
|
179
|
+
.filter((item): item is string => typeof item === "string")
|
|
180
|
+
.map((item) => item.trim())
|
|
181
|
+
.filter(Boolean);
|
|
182
|
+
return list.length > 0 ? list : undefined;
|
|
183
|
+
}
|
|
184
|
+
|
|
185
|
+
function newMissionName(): string {
|
|
186
|
+
const stamp = Date.now().toString(36);
|
|
187
|
+
const random = crypto.randomBytes(4).toString("hex");
|
|
188
|
+
return `ad-hoc-${stamp}-${random}`;
|
|
189
|
+
}
|
|
190
|
+
|
|
191
|
+
/**
|
|
192
|
+
* AB-8.1: валидирует и нормализует вход. Возвращает безопасную копию спеки,
|
|
193
|
+
* чтобы CLI/RPC/GUI не могли передать нестроковые поля в обёртку.
|
|
194
|
+
*/
|
|
195
|
+
export function normalizeMissionSpec(input: MissionSpec): MissionSpec {
|
|
196
|
+
if (!input || typeof input !== "object") {
|
|
197
|
+
throw new Error("Спецификация миссии должна быть объектом.");
|
|
198
|
+
}
|
|
199
|
+
const prompt = assertNonEmpty(input.prompt, "prompt");
|
|
200
|
+
const cwd = input.cwd?.trim() ? path.resolve(input.cwd.trim()) : process.cwd();
|
|
201
|
+
const taskName = input.taskName?.trim() ? input.taskName.trim() : undefined;
|
|
202
|
+
if (taskName && taskName.length > 200) {
|
|
203
|
+
throw new Error("Имя миссии длиннее 200 символов.");
|
|
204
|
+
}
|
|
205
|
+
const session = normalizeSessionMode(input.session);
|
|
206
|
+
if (!session) {
|
|
207
|
+
throw new Error('Поле "session" должно быть new, reuse или last.');
|
|
208
|
+
}
|
|
209
|
+
if (session === "reuse" && input.sessionId !== undefined && !/^ses_[A-Za-z0-9]{10,64}$/.test(input.sessionId)) {
|
|
210
|
+
throw new Error('Поле "sessionId" должно иметь формат ses_<id>.');
|
|
211
|
+
}
|
|
212
|
+
const policy = input.policy ?? "hybrid";
|
|
213
|
+
if (policy !== "hybrid" && policy !== "secure" && policy !== "legacy") {
|
|
214
|
+
throw new Error('Поле "policy" должно быть hybrid, secure или legacy.');
|
|
215
|
+
}
|
|
216
|
+
const allowedTools = normalizeTools(input.allowedTools, "allowedTools");
|
|
217
|
+
const deniedTools = normalizeTools(input.deniedTools, "deniedTools");
|
|
218
|
+
const denied = new Set((deniedTools ?? []).map((tool) => tool.toLowerCase()));
|
|
219
|
+
const conflict = (allowedTools ?? []).find((tool) => denied.has(tool.toLowerCase()));
|
|
220
|
+
if (conflict) {
|
|
221
|
+
throw new Error(`Инструмент "${conflict}" одновременно разрешён и запрещён.`);
|
|
222
|
+
}
|
|
223
|
+
return {
|
|
224
|
+
prompt,
|
|
225
|
+
cwd,
|
|
226
|
+
taskName,
|
|
227
|
+
taskType: input.taskType?.trim() || undefined,
|
|
228
|
+
model: input.model?.trim() || undefined,
|
|
229
|
+
session,
|
|
230
|
+
sessionId: input.sessionId?.trim() || undefined,
|
|
231
|
+
timeoutSeconds: positiveInt(
|
|
232
|
+
input.timeoutSeconds,
|
|
233
|
+
"timeoutSeconds",
|
|
234
|
+
DEFAULT_TIMEOUT_SECONDS,
|
|
235
|
+
),
|
|
236
|
+
gate: input.gate?.trim() || undefined,
|
|
237
|
+
gateTimeoutSeconds:
|
|
238
|
+
input.gateTimeoutSeconds === undefined
|
|
239
|
+
? undefined
|
|
240
|
+
: positiveInt(input.gateTimeoutSeconds, "gateTimeoutSeconds", 300),
|
|
241
|
+
policy,
|
|
242
|
+
allowedTools,
|
|
243
|
+
deniedTools,
|
|
244
|
+
dryRun: input.dryRun === true,
|
|
245
|
+
};
|
|
246
|
+
}
|
|
247
|
+
|
|
248
|
+
/** Создаёт RunContext ad-hoc миссии (без task definition). */
|
|
249
|
+
export function createMissionContext(spec: MissionSpec): RunContext {
|
|
250
|
+
return createAdHocRunContext(spec.prompt, {
|
|
251
|
+
cwd: spec.cwd,
|
|
252
|
+
taskName: spec.taskName,
|
|
253
|
+
taskType: spec.taskType ?? "mission",
|
|
254
|
+
policy: spec.policy ?? "hybrid",
|
|
255
|
+
profile: {
|
|
256
|
+
model: spec.model,
|
|
257
|
+
session: spec.session ?? "new",
|
|
258
|
+
sessionId: spec.sessionId,
|
|
259
|
+
},
|
|
260
|
+
safety: {
|
|
261
|
+
policy: spec.policy ?? "hybrid",
|
|
262
|
+
allowedTools: spec.allowedTools,
|
|
263
|
+
deniedTools: spec.deniedTools,
|
|
264
|
+
},
|
|
265
|
+
metadata: {
|
|
266
|
+
mission: true,
|
|
267
|
+
gate: spec.gate ?? null,
|
|
268
|
+
timeoutSeconds: spec.timeoutSeconds ?? DEFAULT_TIMEOUT_SECONDS,
|
|
269
|
+
},
|
|
270
|
+
});
|
|
271
|
+
}
|
|
272
|
+
|
|
273
|
+
interface WrapperPlan {
|
|
274
|
+
wrapperPath: string;
|
|
275
|
+
logFile: string;
|
|
276
|
+
}
|
|
277
|
+
|
|
278
|
+
/** Готовит обёртку с lock/таймаутом/политикой/Quality Gate, но без ОС. */
|
|
279
|
+
async function prepareWrapper(
|
|
280
|
+
spec: MissionSpec,
|
|
281
|
+
context: RunContext,
|
|
282
|
+
taskName: string,
|
|
283
|
+
): Promise<WrapperPlan> {
|
|
284
|
+
const sanitized = sanitizeName(taskName);
|
|
285
|
+
const logFile = path.join(LOG_DIR, `${sanitized}.log`);
|
|
286
|
+
const promptFile = await writePromptFile(taskName, spec.prompt);
|
|
287
|
+
await fs.mkdir(LOG_DIR, { recursive: true });
|
|
288
|
+
try {
|
|
289
|
+
// Не очищаем лог: при раннем падении до вывода обёртки он остался бы пустым.
|
|
290
|
+
// Дописываем маркер начала прогона — он же разделяет запуски в общем файле.
|
|
291
|
+
await fs.appendFile(logFile, formatLogRunMarker("mission", taskName), "utf8");
|
|
292
|
+
} catch (error) {
|
|
293
|
+
// Обёртки пишут лог через >> и создают файл сами: маркер нужен только для
|
|
294
|
+
// диагностики. Не срываем миссию из-за прав доступа к каталогу логов.
|
|
295
|
+
console.warn(
|
|
296
|
+
`[agent-steward] Не удалось записать маркер в лог миссии (${logFile}): ${error instanceof Error ? error.message : String(error)}`,
|
|
297
|
+
);
|
|
298
|
+
}
|
|
299
|
+
const lockFile = lockFilePath(taskName);
|
|
300
|
+
const sessionMode = spec.session ?? "new";
|
|
301
|
+
let sessionId = spec.sessionId;
|
|
302
|
+
if (sessionMode === "reuse" && !sessionId) {
|
|
303
|
+
sessionId = generateSessionId();
|
|
304
|
+
}
|
|
305
|
+
if (sessionMode === "reuse") {
|
|
306
|
+
await writeSessionStateFile(taskName, sessionId);
|
|
307
|
+
}
|
|
308
|
+
const sessionFile = sessionMode === "reuse" ? sessionStatePath(taskName) : undefined;
|
|
309
|
+
const timeoutSeconds = spec.timeoutSeconds ?? DEFAULT_TIMEOUT_SECONDS;
|
|
310
|
+
|
|
311
|
+
if (process.platform === "win32") {
|
|
312
|
+
const permissionsConfig = buildOpencodeConfig({
|
|
313
|
+
policy: context.safety.policy,
|
|
314
|
+
allowedTools: spec.allowedTools,
|
|
315
|
+
deniedTools: spec.deniedTools,
|
|
316
|
+
});
|
|
317
|
+
await ensureWrapper();
|
|
318
|
+
const wrapperPath = await writeWrapperCmd(
|
|
319
|
+
sanitized,
|
|
320
|
+
taskName,
|
|
321
|
+
promptFile,
|
|
322
|
+
timeoutSeconds,
|
|
323
|
+
lockFile,
|
|
324
|
+
context.cwd,
|
|
325
|
+
logFile,
|
|
326
|
+
recorderPath(),
|
|
327
|
+
spec.gate,
|
|
328
|
+
spec.model,
|
|
329
|
+
undefined,
|
|
330
|
+
undefined,
|
|
331
|
+
undefined,
|
|
332
|
+
spec.allowedTools,
|
|
333
|
+
spec.deniedTools,
|
|
334
|
+
undefined,
|
|
335
|
+
undefined,
|
|
336
|
+
sessionMode,
|
|
337
|
+
sessionId,
|
|
338
|
+
spec.gateTimeoutSeconds,
|
|
339
|
+
permissionsConfig,
|
|
340
|
+
{ policy: context.safety.policy, legacyShell: false },
|
|
341
|
+
sessionFile,
|
|
342
|
+
);
|
|
343
|
+
return { wrapperPath, logFile };
|
|
344
|
+
}
|
|
345
|
+
|
|
346
|
+
const wrapperPath = await writeBashWrapper({
|
|
347
|
+
sanitizedName: sanitized,
|
|
348
|
+
taskName,
|
|
349
|
+
promptFile,
|
|
350
|
+
timeoutSeconds,
|
|
351
|
+
lockFile,
|
|
352
|
+
workdir: context.cwd,
|
|
353
|
+
logFile,
|
|
354
|
+
recorderFile: recorderPath(),
|
|
355
|
+
qualityGate: spec.gate,
|
|
356
|
+
model: spec.model,
|
|
357
|
+
policy: context.safety.policy,
|
|
358
|
+
allowedTools: spec.allowedTools,
|
|
359
|
+
deniedTools: spec.deniedTools,
|
|
360
|
+
sessionMode,
|
|
361
|
+
sessionId,
|
|
362
|
+
sessionFile,
|
|
363
|
+
gateTimeoutSeconds: spec.gateTimeoutSeconds,
|
|
364
|
+
});
|
|
365
|
+
return { wrapperPath, logFile };
|
|
366
|
+
}
|
|
367
|
+
|
|
368
|
+
/** Прямой запуск обёртки: ОС-задача не создаётся, процесс ждём здесь. */
|
|
369
|
+
async function runWrapperProcess(
|
|
370
|
+
wrapperPath: string,
|
|
371
|
+
cwd: string,
|
|
372
|
+
timeoutSeconds: number,
|
|
373
|
+
): Promise<{ output: string; error: string | null }> {
|
|
374
|
+
const timeoutMs = (timeoutSeconds + 120) * 1000;
|
|
375
|
+
return new Promise((resolve) => {
|
|
376
|
+
const child =
|
|
377
|
+
process.platform === "win32"
|
|
378
|
+
? spawn(process.env.ComSpec ?? "cmd.exe", ["/d", "/s", "/c", `"${wrapperPath}"`], {
|
|
379
|
+
cwd,
|
|
380
|
+
windowsHide: true,
|
|
381
|
+
env: process.env,
|
|
382
|
+
})
|
|
383
|
+
: spawn("bash", [wrapperPath], {
|
|
384
|
+
cwd,
|
|
385
|
+
windowsHide: true,
|
|
386
|
+
env: process.env,
|
|
387
|
+
});
|
|
388
|
+
|
|
389
|
+
let stdout = "";
|
|
390
|
+
let stderr = "";
|
|
391
|
+
let settled = false;
|
|
392
|
+
const append = (target: "out" | "err", chunk: Buffer) => {
|
|
393
|
+
const text = chunk.toString("utf8");
|
|
394
|
+
if (target === "out") stdout = (stdout + text).slice(-200_000);
|
|
395
|
+
else stderr = (stderr + text).slice(-200_000);
|
|
396
|
+
};
|
|
397
|
+
child.stdout?.on("data", (chunk: Buffer) => append("out", chunk));
|
|
398
|
+
child.stderr?.on("data", (chunk: Buffer) => append("err", chunk));
|
|
399
|
+
|
|
400
|
+
const timer = setTimeout(() => {
|
|
401
|
+
if (settled) return;
|
|
402
|
+
settled = true;
|
|
403
|
+
child.kill("SIGKILL");
|
|
404
|
+
resolve({
|
|
405
|
+
output: stdout,
|
|
406
|
+
error: `Миссия превысила внешний таймаут ${timeoutSeconds + 120} с.`,
|
|
407
|
+
});
|
|
408
|
+
}, timeoutMs);
|
|
409
|
+
timer.unref?.();
|
|
410
|
+
|
|
411
|
+
const finish = (error: string | null) => {
|
|
412
|
+
if (settled) return;
|
|
413
|
+
settled = true;
|
|
414
|
+
clearTimeout(timer);
|
|
415
|
+
resolve({ output: [stdout.trim(), stderr.trim()].filter(Boolean).join("\n"), error });
|
|
416
|
+
};
|
|
417
|
+
|
|
418
|
+
child.on("error", (error) => finish(error.message));
|
|
419
|
+
child.on("close", (code, signal) => {
|
|
420
|
+
if (code === 0) {
|
|
421
|
+
finish(null);
|
|
422
|
+
return;
|
|
423
|
+
}
|
|
424
|
+
finish(
|
|
425
|
+
`Обёртка миссии завершилась с кодом ${code ?? "null"}${
|
|
426
|
+
signal ? ` (сигнал ${signal})` : ""
|
|
427
|
+
}.`,
|
|
428
|
+
);
|
|
429
|
+
});
|
|
430
|
+
});
|
|
431
|
+
}
|
|
432
|
+
|
|
433
|
+
function createWrapperExecutor(
|
|
434
|
+
wrapperPath: string,
|
|
435
|
+
spec: MissionSpec,
|
|
436
|
+
): StepExecutor {
|
|
437
|
+
return {
|
|
438
|
+
id: "mission-wrapper",
|
|
439
|
+
supports: (route) => route.executor !== null,
|
|
440
|
+
async execute() {
|
|
441
|
+
const { output, error } = await runWrapperProcess(
|
|
442
|
+
wrapperPath,
|
|
443
|
+
spec.cwd ?? process.cwd(),
|
|
444
|
+
spec.timeoutSeconds ?? DEFAULT_TIMEOUT_SECONDS,
|
|
445
|
+
);
|
|
446
|
+
return error ? { output, error } : { output };
|
|
447
|
+
},
|
|
448
|
+
};
|
|
449
|
+
}
|
|
450
|
+
|
|
451
|
+
/**
|
|
452
|
+
* AB-8: единая точка входа ad-hoc миссии для CLI, RPC и GUI.
|
|
453
|
+
*
|
|
454
|
+
* Инварианты EXECUTION-LOOP §2.1: нет записи в планировщике ОС, работают
|
|
455
|
+
* GATE, политика прав, ledger (`runs`/`run_steps`) и аудит; параллельные
|
|
456
|
+
* обычные миссии в одном workspace не допускаются.
|
|
457
|
+
*
|
|
458
|
+
* W-3 (контракт dryRun): `dryRun: true` строит план и описание, но не захватывает
|
|
459
|
+
* `activeWorkspaces` и не пишет ledger (`runs`/`run_steps`) — это контракт, а не
|
|
460
|
+
* утечка контекста. Поэтому несколько dry-run в одном `cwd` проходят параллельно.
|
|
461
|
+
*/
|
|
462
|
+
export async function runMission(
|
|
463
|
+
input: MissionSpec,
|
|
464
|
+
dependencies: MissionDependencies = {},
|
|
465
|
+
): Promise<MissionResult> {
|
|
466
|
+
const spec = normalizeMissionSpec(input);
|
|
467
|
+
const taskName = spec.taskName ?? newMissionName();
|
|
468
|
+
spec.taskName = taskName;
|
|
469
|
+
const context = createMissionContext(spec);
|
|
470
|
+
const plan = await buildExecutionPlan(context);
|
|
471
|
+
const description = describeExecutionPlan(plan);
|
|
472
|
+
|
|
473
|
+
if (spec.dryRun) {
|
|
474
|
+
dependencies.onPrepared?.({ taskName, cwd: context.cwd });
|
|
475
|
+
return {
|
|
476
|
+
success: true,
|
|
477
|
+
dryRun: true,
|
|
478
|
+
runId: null,
|
|
479
|
+
status: "planned",
|
|
480
|
+
plan,
|
|
481
|
+
description,
|
|
482
|
+
steps: [],
|
|
483
|
+
error: null,
|
|
484
|
+
logFile: null,
|
|
485
|
+
};
|
|
486
|
+
}
|
|
487
|
+
|
|
488
|
+
const workspaceKey = path.resolve(context.cwd);
|
|
489
|
+
const running = activeWorkspaces.get(workspaceKey);
|
|
490
|
+
if (running) {
|
|
491
|
+
throw new Error(
|
|
492
|
+
`В workspace ${workspaceKey} уже выполняется миссия "${running}". Дождитесь её завершения.`,
|
|
493
|
+
);
|
|
494
|
+
}
|
|
495
|
+
activeWorkspaces.set(workspaceKey, taskName);
|
|
496
|
+
|
|
497
|
+
try {
|
|
498
|
+
let executor = dependencies.executor;
|
|
499
|
+
let logFile: string | null = null;
|
|
500
|
+
if (!executor) {
|
|
501
|
+
const prepared = await prepareWrapper(spec, context, taskName);
|
|
502
|
+
logFile = prepared.logFile;
|
|
503
|
+
executor = createWrapperExecutor(prepared.wrapperPath, spec);
|
|
504
|
+
}
|
|
505
|
+
dependencies.onPrepared?.({ taskName, cwd: context.cwd });
|
|
506
|
+
|
|
507
|
+
const result = await executeExecutionPlan(plan, {
|
|
508
|
+
executors: [executor],
|
|
509
|
+
stopOnError: true,
|
|
510
|
+
metadata: {
|
|
511
|
+
adHoc: true,
|
|
512
|
+
gate: spec.gate ?? null,
|
|
513
|
+
timeoutSeconds: spec.timeoutSeconds ?? DEFAULT_TIMEOUT_SECONDS,
|
|
514
|
+
},
|
|
515
|
+
});
|
|
516
|
+
|
|
517
|
+
return {
|
|
518
|
+
success: result.status === "passed",
|
|
519
|
+
dryRun: false,
|
|
520
|
+
runId: result.runId,
|
|
521
|
+
status: result.status,
|
|
522
|
+
plan,
|
|
523
|
+
description,
|
|
524
|
+
steps: result.steps,
|
|
525
|
+
error: result.error,
|
|
526
|
+
logFile,
|
|
527
|
+
};
|
|
528
|
+
} finally {
|
|
529
|
+
activeWorkspaces.delete(workspaceKey);
|
|
530
|
+
}
|
|
531
|
+
}
|
|
@@ -21,8 +21,7 @@
|
|
|
21
21
|
import fs from "node:fs";
|
|
22
22
|
import os from "node:os";
|
|
23
23
|
import path from "node:path";
|
|
24
|
-
import {
|
|
25
|
-
import { opencodeCommand } from "./opencode-cli.js";
|
|
24
|
+
import { runOpencode } from "./opencode-cli.js";
|
|
26
25
|
|
|
27
26
|
/** Цена за 1M токенов модели в каталоге models.dev. */
|
|
28
27
|
export interface ModelCatalogEntry {
|
|
@@ -207,30 +206,37 @@ export function catalogPricePerMillion(model: string | undefined): number | null
|
|
|
207
206
|
}
|
|
208
207
|
|
|
209
208
|
let cliCache: { at: number; models: string[] } | null = null;
|
|
209
|
+
/** Один общий запуск CLI: параллельные запросы дашборда не плодят процессы. */
|
|
210
|
+
let cliInflight: Promise<string[]> | null = null;
|
|
210
211
|
|
|
211
|
-
/**
|
|
212
|
-
|
|
213
|
-
|
|
214
|
-
|
|
215
|
-
|
|
216
|
-
|
|
217
|
-
|
|
218
|
-
|
|
219
|
-
|
|
220
|
-
|
|
221
|
-
|
|
222
|
-
|
|
223
|
-
|
|
224
|
-
}
|
|
212
|
+
/**
|
|
213
|
+
* Запускает `opencode models` асинхронно.
|
|
214
|
+
*
|
|
215
|
+
* Раньше здесь был `execFileSync`, и это вешало event loop сервера, внутри
|
|
216
|
+
* которого живёт плагин. CLI в этот момент опрашивал тот же сервер как
|
|
217
|
+
* background service, не получал ответа, запускал recovery и перезапускал
|
|
218
|
+
* сервис вместе с дашбордом — отсюда `ERR_CONNECTION_REFUSED` каждые ~10 с.
|
|
219
|
+
* Асинхронный запуск event loop не блокирует.
|
|
220
|
+
*/
|
|
221
|
+
async function runModelsCli(): Promise<string[]> {
|
|
222
|
+
const result = await runOpencode(["models"], CLI_TIMEOUT_MS);
|
|
223
|
+
if (!result.ok) return [];
|
|
224
|
+
return parseModelList(result.stdout);
|
|
225
225
|
}
|
|
226
226
|
|
|
227
227
|
/** Доступные пользователю модели (`opencode models`), кэш 10 минут. */
|
|
228
|
-
export function listAvailableModels(): string[] {
|
|
228
|
+
export async function listAvailableModels(): Promise<string[]> {
|
|
229
229
|
if (modelSourceMode() === "static") return [];
|
|
230
230
|
const now = Date.now();
|
|
231
231
|
if (cliCache && now - cliCache.at < CLI_TTL_MS) return cliCache.models;
|
|
232
|
-
|
|
233
|
-
|
|
232
|
+
if (!cliInflight) {
|
|
233
|
+
cliInflight = runModelsCli().finally(() => {
|
|
234
|
+
cliInflight = null;
|
|
235
|
+
});
|
|
236
|
+
}
|
|
237
|
+
const models = await cliInflight;
|
|
238
|
+
// Пустой результат тоже кэшируем: иначе каждый запрос снова дёргает CLI.
|
|
239
|
+
cliCache = { at: Date.now(), models };
|
|
234
240
|
return models;
|
|
235
241
|
}
|
|
236
242
|
|
|
@@ -304,12 +310,15 @@ export function selectWhatIfModels(
|
|
|
304
310
|
}
|
|
305
311
|
|
|
306
312
|
/** What-If по реальным источникам: история + `opencode models` + каталог цен. */
|
|
307
|
-
export function resolveWhatIfModels(
|
|
308
|
-
|
|
313
|
+
export async function resolveWhatIfModels(
|
|
314
|
+
preferred: string[] = [],
|
|
315
|
+
): Promise<WhatIfSelection> {
|
|
316
|
+
return selectWhatIfModels(preferred, await listAvailableModels());
|
|
309
317
|
}
|
|
310
318
|
|
|
311
319
|
/** Сбрасывает кэши (нужно тестам). */
|
|
312
320
|
export function resetModelCaches(): void {
|
|
313
321
|
catalogCache = null;
|
|
314
322
|
cliCache = null;
|
|
323
|
+
cliInflight = null;
|
|
315
324
|
}
|