agent-steward 0.0.3 → 0.0.4
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 +20 -0
- package/README.md +3 -3
- package/ROADMAP-STRATEGY.md +9 -9
- package/ROADMAP.md +50 -34
- package/dist/core/dlq-api.d.ts +44 -0
- package/dist/core/dlq-api.d.ts.map +1 -0
- package/dist/core/dlq-api.js +68 -0
- package/dist/core/dry-run.d.ts.map +1 -1
- package/dist/core/dry-run.js +18 -1
- package/dist/core/lock.d.ts +20 -4
- package/dist/core/lock.d.ts.map +1 -1
- package/dist/core/lock.js +97 -22
- package/dist/core/one-shot.d.ts +5 -1
- package/dist/core/one-shot.d.ts.map +1 -1
- package/dist/core/one-shot.js +33 -8
- package/dist/core/opencode-cli.d.ts +28 -0
- package/dist/core/opencode-cli.d.ts.map +1 -0
- package/dist/core/opencode-cli.js +74 -0
- package/dist/core/opencode-models.d.ts +62 -0
- package/dist/core/opencode-models.d.ts.map +1 -0
- package/dist/core/opencode-models.js +277 -0
- package/dist/core/ps-wrapper.d.ts +1 -1
- package/dist/core/ps-wrapper.d.ts.map +1 -1
- package/dist/core/ps-wrapper.js +11 -1
- package/dist/core/record-history.d.ts +15 -0
- package/dist/core/record-history.d.ts.map +1 -1
- package/dist/core/record-history.js +56 -32
- package/dist/core/router/dispatch.d.ts +36 -0
- package/dist/core/router/dispatch.d.ts.map +1 -0
- package/dist/core/router/dispatch.js +59 -0
- package/dist/core/router/escalation.d.ts +47 -0
- package/dist/core/router/escalation.d.ts.map +1 -0
- package/dist/core/router/escalation.js +87 -0
- package/dist/core/router/planner.d.ts +53 -0
- package/dist/core/router/planner.d.ts.map +1 -0
- package/dist/core/router/planner.js +113 -0
- package/dist/core/router/rules.d.ts +46 -0
- package/dist/core/router/rules.d.ts.map +1 -0
- package/dist/core/router/rules.js +85 -0
- package/dist/core/run-panel-api.d.ts +94 -0
- package/dist/core/run-panel-api.d.ts.map +1 -0
- package/dist/core/run-panel-api.js +169 -0
- package/dist/core/schedule-gate.js +5 -1
- package/dist/core/schedule-v2.d.ts +34 -0
- package/dist/core/schedule-v2.d.ts.map +1 -1
- package/dist/core/schedule-v2.js +91 -5
- package/dist/core/scheduler/at-fallback.d.ts +55 -2
- package/dist/core/scheduler/at-fallback.d.ts.map +1 -1
- package/dist/core/scheduler/at-fallback.js +135 -5
- package/dist/core/scheduler/linux.d.ts +10 -1
- package/dist/core/scheduler/linux.d.ts.map +1 -1
- package/dist/core/scheduler/linux.js +29 -11
- package/dist/core/scheduler/posix.d.ts.map +1 -1
- package/dist/core/scheduler/posix.js +25 -1
- package/dist/core/scheduler/registry.d.ts +11 -0
- package/dist/core/scheduler/registry.d.ts.map +1 -1
- package/dist/core/scheduler/registry.js +83 -21
- package/dist/core/scheduler/run-now.d.ts +16 -0
- package/dist/core/scheduler/run-now.d.ts.map +1 -0
- package/dist/core/scheduler/run-now.js +28 -0
- package/dist/core/secrets.d.ts.map +1 -1
- package/dist/core/secrets.js +125 -28
- package/dist/core/session.d.ts.map +1 -1
- package/dist/core/session.js +18 -11
- package/dist/core/task-name.d.ts +24 -0
- package/dist/core/task-name.d.ts.map +1 -0
- package/dist/core/task-name.js +40 -0
- package/dist/core/wrappers/bash.d.ts.map +1 -1
- package/dist/core/wrappers/bash.js +49 -4
- package/dist/db/capability-repo.d.ts +83 -0
- package/dist/db/capability-repo.d.ts.map +1 -0
- package/dist/db/capability-repo.js +182 -0
- package/dist/db/history-repo.d.ts +8 -0
- package/dist/db/history-repo.d.ts.map +1 -1
- package/dist/db/history-repo.js +19 -0
- package/dist/db/index.d.ts +4 -0
- package/dist/db/index.d.ts.map +1 -1
- package/dist/db/index.js +39 -1
- package/dist/db/migrate.d.ts.map +1 -1
- package/dist/db/migrate.js +3 -1
- package/dist/db/run-context.d.ts +103 -0
- package/dist/db/run-context.d.ts.map +1 -0
- package/dist/db/run-context.js +224 -0
- package/dist/db/run-dlq.d.ts +100 -0
- package/dist/db/run-dlq.d.ts.map +1 -0
- package/dist/db/run-dlq.js +191 -0
- package/dist/db/run-resume.d.ts +5 -2
- package/dist/db/run-resume.d.ts.map +1 -1
- package/dist/db/run-resume.js +30 -11
- package/dist/db/runs-repo.d.ts +13 -5
- package/dist/db/runs-repo.d.ts.map +1 -1
- package/dist/db/runs-repo.js +28 -5
- package/dist/db/schema.d.ts +2 -2
- package/dist/db/schema.d.ts.map +1 -1
- package/dist/db/schema.js +154 -2
- package/dist/db/settings-repo.d.ts +11 -0
- package/dist/db/settings-repo.d.ts.map +1 -1
- package/dist/db/settings-repo.js +25 -0
- package/dist/db/step-idempotency.d.ts +51 -0
- package/dist/db/step-idempotency.d.ts.map +1 -0
- package/dist/db/step-idempotency.js +136 -0
- package/dist/index.d.ts +4 -4
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +102 -4
- package/dist/rpc.d.ts +678 -0
- package/dist/rpc.d.ts.map +1 -1
- package/dist/rpc.js +235 -0
- package/dist/server.d.ts +31 -0
- package/dist/server.d.ts.map +1 -1
- package/dist/server.js +95 -35
- package/dist/types.d.ts.map +1 -1
- package/dist/types.js +7 -0
- package/dist/workspaces.d.ts +25 -3
- package/dist/workspaces.d.ts.map +1 -1
- package/dist/workspaces.js +43 -8
- package/docs/ARCHITECTURE.md +229 -5
- package/docs/CONCEPT.md +171 -91
- package/docs/EXECUTION-LOOP.md +196 -0
- package/docs/README.ru.md +2 -2
- package/docs/README.zh.md +3 -3
- package/docs/SAFETY.md +122 -0
- package/docs/SAVINGS.md +29 -0
- package/docs/SAVINGS.ru.md +29 -0
- package/docs/SAVINGS.zh.md +18 -0
- package/gui-experimental.cjs +8 -8
- package/locales/en.json +67 -0
- package/locales/ru.json +67 -0
- package/locales/zh.json +67 -0
- package/package.json +28 -3
- package/scripts/audit-bundle.mjs +215 -0
- package/src/core/dlq-api.ts +98 -0
- package/src/core/dry-run.ts +25 -1
- package/src/core/lock.ts +95 -22
- package/src/core/one-shot.ts +36 -8
- package/src/core/opencode-cli.ts +103 -0
- package/src/core/opencode-models.ts +315 -0
- package/src/core/ps-wrapper.ts +11 -1
- package/src/core/record-history.ts +75 -37
- package/src/core/router/dispatch.ts +94 -0
- package/src/core/router/escalation.ts +129 -0
- package/src/core/router/planner.ts +166 -0
- package/src/core/router/rules.ts +109 -0
- package/src/core/run-panel-api.ts +262 -0
- package/src/core/schedule-gate.ts +6 -2
- package/src/core/schedule-v2.ts +114 -5
- package/src/core/scheduler/at-fallback.ts +190 -5
- package/src/core/scheduler/linux.ts +32 -10
- package/src/core/scheduler/posix.ts +20 -1
- package/src/core/scheduler/registry.ts +107 -26
- package/src/core/scheduler/run-now.ts +32 -0
- package/src/core/secrets.ts +127 -27
- package/src/core/session.ts +23 -10
- package/src/core/task-name.ts +67 -0
- package/src/core/wrappers/bash.ts +49 -4
- package/src/db/capability-repo.ts +285 -0
- package/src/db/history-repo.ts +22 -0
- package/src/db/index.ts +37 -1
- package/src/db/migrate.ts +3 -1
- package/src/db/run-context.ts +370 -0
- package/src/db/run-dlq.ts +310 -0
- package/src/db/run-resume.ts +48 -12
- package/src/db/runs-repo.ts +30 -7
- package/src/db/schema.ts +154 -2
- package/src/db/settings-repo.ts +31 -0
- package/src/db/step-idempotency.ts +185 -0
- package/src/gui.tsx +515 -0
- package/src/index.ts +124 -4
- package/src/rpc.ts +251 -0
- package/src/server.ts +112 -36
- package/src/types.ts +9 -0
- package/src/workspaces.ts +58 -9
|
@@ -0,0 +1,129 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Эскалация после провала Quality Gate (Спринт 36.5.d).
|
|
3
|
+
*
|
|
4
|
+
* Правило детерминированное и не обращается ни к БД, ни к модели, ни к сети:
|
|
5
|
+
* провал на локальном исполнителе ведёт в облако, провал в облаке — на ручной
|
|
6
|
+
* review, провал review означает, что автоматических уровней больше нет.
|
|
7
|
+
* Решение принимается по одному флагу `passed`, поэтому его можно вызывать
|
|
8
|
+
* в горячем пути без затрат токенов.
|
|
9
|
+
*/
|
|
10
|
+
|
|
11
|
+
/** Уровень исполнения, на котором сработал Quality Gate. */
|
|
12
|
+
export type GateTarget = "local" | "cloud" | "review";
|
|
13
|
+
|
|
14
|
+
/** Что делать после проверки гейта. */
|
|
15
|
+
export type EscalationAction =
|
|
16
|
+
| "accept"
|
|
17
|
+
| "escalate-cloud"
|
|
18
|
+
| "escalate-review"
|
|
19
|
+
| "blocked";
|
|
20
|
+
|
|
21
|
+
/** Результат Quality Gate, который видит роутер. */
|
|
22
|
+
export interface GateResult {
|
|
23
|
+
/** Прошёл ли шаг проверку. */
|
|
24
|
+
passed: boolean;
|
|
25
|
+
/** Свободное пояснение для журнала и уведомлений. */
|
|
26
|
+
reason?: string;
|
|
27
|
+
}
|
|
28
|
+
|
|
29
|
+
/** Решение об эскалации с текущего уровня. */
|
|
30
|
+
export interface EscalationDecision {
|
|
31
|
+
/** Уровень, на котором гейт сработал. */
|
|
32
|
+
from: GateTarget;
|
|
33
|
+
/** Куда переходим (при `accept` совпадает с `from`). */
|
|
34
|
+
next: GateTarget;
|
|
35
|
+
action: EscalationAction;
|
|
36
|
+
/** Почему принято решение: стабильный код, а не текст ошибки. */
|
|
37
|
+
reason: "gate-passed" | "local-failed" | "cloud-failed" | "review-failed";
|
|
38
|
+
}
|
|
39
|
+
|
|
40
|
+
/** Следующий уровень эскалации или `null`, если уровни закончились. */
|
|
41
|
+
const NEXT_TARGET: Readonly<Record<GateTarget, GateTarget | null>> = Object.freeze(
|
|
42
|
+
{
|
|
43
|
+
local: "cloud",
|
|
44
|
+
cloud: "review",
|
|
45
|
+
review: null,
|
|
46
|
+
},
|
|
47
|
+
);
|
|
48
|
+
|
|
49
|
+
/** Сколько автоматических эскалаций допускает цепочка local → cloud → review. */
|
|
50
|
+
export const MAX_ESCALATION_STEPS = 2;
|
|
51
|
+
|
|
52
|
+
function assertTarget(target: GateTarget): void {
|
|
53
|
+
if (!Object.prototype.hasOwnProperty.call(NEXT_TARGET, target)) {
|
|
54
|
+
throw new Error(`Неизвестный уровень гейта: ${String(target)}`);
|
|
55
|
+
}
|
|
56
|
+
}
|
|
57
|
+
|
|
58
|
+
function assertGate(gate: GateResult): void {
|
|
59
|
+
if (gate === null || typeof gate !== "object") {
|
|
60
|
+
throw new Error("Результат Quality Gate должен быть объектом.");
|
|
61
|
+
}
|
|
62
|
+
if (typeof gate.passed !== "boolean") {
|
|
63
|
+
throw new Error("Результат Quality Gate должен содержать boolean (passed).");
|
|
64
|
+
}
|
|
65
|
+
}
|
|
66
|
+
|
|
67
|
+
/** Следующий уровень эскалации; `null` — автоматических уровней больше нет. */
|
|
68
|
+
export function nextGateTarget(current: GateTarget): GateTarget | null {
|
|
69
|
+
assertTarget(current);
|
|
70
|
+
return NEXT_TARGET[current];
|
|
71
|
+
}
|
|
72
|
+
|
|
73
|
+
/** Исчерпаны ли автоматические уровни для текущего исполнителя. */
|
|
74
|
+
export function isEscalationExhausted(current: GateTarget): boolean {
|
|
75
|
+
return nextGateTarget(current) === null;
|
|
76
|
+
}
|
|
77
|
+
|
|
78
|
+
/**
|
|
79
|
+
* Решает, что делать после гейта: принять результат или подняться на уровень
|
|
80
|
+
* выше. Модель здесь не вызывается — только таблица переходов.
|
|
81
|
+
*/
|
|
82
|
+
export function escalateAfterGate(
|
|
83
|
+
current: GateTarget,
|
|
84
|
+
gate: GateResult,
|
|
85
|
+
): EscalationDecision {
|
|
86
|
+
assertTarget(current);
|
|
87
|
+
assertGate(gate);
|
|
88
|
+
if (gate.passed) {
|
|
89
|
+
return { from: current, next: current, action: "accept", reason: "gate-passed" };
|
|
90
|
+
}
|
|
91
|
+
const next = NEXT_TARGET[current];
|
|
92
|
+
if (next === null) {
|
|
93
|
+
return {
|
|
94
|
+
from: current,
|
|
95
|
+
next: current,
|
|
96
|
+
action: "blocked",
|
|
97
|
+
reason: "review-failed",
|
|
98
|
+
};
|
|
99
|
+
}
|
|
100
|
+
if (next === "cloud") {
|
|
101
|
+
return {
|
|
102
|
+
from: current,
|
|
103
|
+
next,
|
|
104
|
+
action: "escalate-cloud",
|
|
105
|
+
reason: "local-failed",
|
|
106
|
+
};
|
|
107
|
+
}
|
|
108
|
+
return {
|
|
109
|
+
from: current,
|
|
110
|
+
next,
|
|
111
|
+
action: "escalate-review",
|
|
112
|
+
reason: "cloud-failed",
|
|
113
|
+
};
|
|
114
|
+
}
|
|
115
|
+
|
|
116
|
+
/**
|
|
117
|
+
* Полная цепочка уровней, которые предстоит пройти начиная с текущего
|
|
118
|
+
* (включая его). Полезно для dry-run и объяснения решения оператору.
|
|
119
|
+
*/
|
|
120
|
+
export function escalationChain(current: GateTarget): GateTarget[] {
|
|
121
|
+
assertTarget(current);
|
|
122
|
+
const chain: GateTarget[] = [];
|
|
123
|
+
let target: GateTarget | null = current;
|
|
124
|
+
while (target !== null) {
|
|
125
|
+
chain.push(target);
|
|
126
|
+
target = NEXT_TARGET[target];
|
|
127
|
+
}
|
|
128
|
+
return chain;
|
|
129
|
+
}
|
|
@@ -0,0 +1,166 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Роутер, слой 3: декомпозиция миссии.
|
|
3
|
+
*
|
|
4
|
+
* Локальная модель вызывается только здесь и только для того, чтобы разбить
|
|
5
|
+
* миссию на шаги с типом задачи. Маршрут каждого шага (транспорт и исполнитель)
|
|
6
|
+
* определяется слоями 1–2: статическими правилами и Capability Map. Если
|
|
7
|
+
* декомпозера нет, работает эвристика по ключевым словам — она не обращается
|
|
8
|
+
* ни к модели, ни к сети.
|
|
9
|
+
*/
|
|
10
|
+
|
|
11
|
+
import { isStaticTaskType, normalizeTaskType, type RouterExecutor, type RouterTransport } from "./rules.js";
|
|
12
|
+
|
|
13
|
+
/** Один шаг плана: имя для журнала и тип задачи для маршрутизации. */
|
|
14
|
+
export interface MissionStep {
|
|
15
|
+
stepName: string;
|
|
16
|
+
taskType: string;
|
|
17
|
+
}
|
|
18
|
+
|
|
19
|
+
/** Источник плана: модель или эвристика. */
|
|
20
|
+
export type PlanSource = "model" | "heuristic";
|
|
21
|
+
|
|
22
|
+
/** Результат декомпозиции миссии. */
|
|
23
|
+
export interface MissionPlan {
|
|
24
|
+
mission: string;
|
|
25
|
+
steps: MissionStep[];
|
|
26
|
+
source: PlanSource;
|
|
27
|
+
/** Типы шагов, которых нет в статических правилах: их маршрут решают слои 2–3. */
|
|
28
|
+
ambiguousTaskTypes: string[];
|
|
29
|
+
}
|
|
30
|
+
|
|
31
|
+
/** Декомпозер, который поставляет локальная модель. */
|
|
32
|
+
export interface MissionDecomposer {
|
|
33
|
+
decompose(mission: string): Promise<MissionStep[]> | MissionStep[];
|
|
34
|
+
}
|
|
35
|
+
|
|
36
|
+
/** Опции декомпозиции. */
|
|
37
|
+
export interface PlanOptions {
|
|
38
|
+
decomposer?: MissionDecomposer;
|
|
39
|
+
/** Предохранитель от «простыни» шагов, по умолчанию 12. */
|
|
40
|
+
maxSteps?: number;
|
|
41
|
+
}
|
|
42
|
+
|
|
43
|
+
/** Маршрут шага, собранный из слоёв 1–2 (для удобства интеграции). */
|
|
44
|
+
export interface ResolvedStepRoute {
|
|
45
|
+
step: MissionStep;
|
|
46
|
+
transport?: RouterTransport;
|
|
47
|
+
executor?: RouterExecutor;
|
|
48
|
+
source: "static" | "capability" | "unknown";
|
|
49
|
+
}
|
|
50
|
+
|
|
51
|
+
const DEFAULT_MAX_STEPS = 12;
|
|
52
|
+
|
|
53
|
+
/**
|
|
54
|
+
* Ключевые слова эвристики. Порядок важен: более специфичные типы идут первыми,
|
|
55
|
+
* иначе «проверь тесты в PR» уедет в run_tests вместо github_create_pr.
|
|
56
|
+
*/
|
|
57
|
+
const HEURISTIC_KEYWORDS: readonly { taskType: string; keywords: readonly string[] }[] = Object.freeze([
|
|
58
|
+
{ taskType: "github_create_pr", keywords: ["pull request", "merge request", " pr ", "pr ", "пуш", "push"] },
|
|
59
|
+
{ taskType: "jira_update_task", keywords: ["jira", "джира", "тикет", "ticket", "задач"] },
|
|
60
|
+
{ taskType: "run_tests", keywords: ["тест", "test", "прогон", "проверк"] },
|
|
61
|
+
{ taskType: "apply_diff", keywords: ["исправ", "поправ", "измени", "правк", "patch", "diff", "refactor", "рефактор"] },
|
|
62
|
+
{ taskType: "write_file", keywords: ["запиши", "создай", "напиши", "write", "сохрани"] },
|
|
63
|
+
{ taskType: "read_file", keywords: ["прочит", "прочитай", "посмотр", "открой", "read", "inspect"] },
|
|
64
|
+
]);
|
|
65
|
+
|
|
66
|
+
/** Разделители шагов в миссии. */
|
|
67
|
+
const STEP_SPLIT_PATTERN = /\r?\n|;|,\s*(?:затем|потом|после чего)\s*|\s+(?:затем|потом|после чего)\s+/iu;
|
|
68
|
+
|
|
69
|
+
/** Нужна ли декомпозиция: одна короткая задача обходится без модели. */
|
|
70
|
+
export function needsDecomposition(mission: string): boolean {
|
|
71
|
+
const text = mission.trim();
|
|
72
|
+
if (!text) {
|
|
73
|
+
return false;
|
|
74
|
+
}
|
|
75
|
+
if (STEP_SPLIT_PATTERN.test(text)) {
|
|
76
|
+
return true;
|
|
77
|
+
}
|
|
78
|
+
return !isStaticTaskType(text);
|
|
79
|
+
}
|
|
80
|
+
|
|
81
|
+
/** Определяет тип задачи по ключевым словам фрагмента; неизвестно — `unknown`. */
|
|
82
|
+
export function guessTaskType(fragment: string): string {
|
|
83
|
+
const haystack = ` ${fragment.toLowerCase().replace(/ё/gu, "е")} `;
|
|
84
|
+
for (const entry of HEURISTIC_KEYWORDS) {
|
|
85
|
+
if (entry.keywords.some((keyword) => haystack.includes(keyword))) {
|
|
86
|
+
return entry.taskType;
|
|
87
|
+
}
|
|
88
|
+
}
|
|
89
|
+
return "unknown";
|
|
90
|
+
}
|
|
91
|
+
|
|
92
|
+
/** Эвристическая декомпозиция: без модели, без сети, детерминированно. */
|
|
93
|
+
export function decomposeHeuristically(mission: string, maxSteps: number = DEFAULT_MAX_STEPS): MissionStep[] {
|
|
94
|
+
const text = mission.trim();
|
|
95
|
+
if (!text) {
|
|
96
|
+
throw new Error("Пустая миссия: декомпозиция невозможна");
|
|
97
|
+
}
|
|
98
|
+
const fragments = text
|
|
99
|
+
.split(STEP_SPLIT_PATTERN)
|
|
100
|
+
.map((fragment) => fragment.trim().replace(/^[-*\d.)\s]+/u, "").trim())
|
|
101
|
+
.filter((fragment) => fragment.length > 0);
|
|
102
|
+
|
|
103
|
+
const steps = fragments.slice(0, Math.max(1, maxSteps)).map((fragment) => ({
|
|
104
|
+
stepName: fragment.length > 120 ? `${fragment.slice(0, 117)}...` : fragment,
|
|
105
|
+
taskType: guessTaskType(fragment),
|
|
106
|
+
}));
|
|
107
|
+
|
|
108
|
+
if (steps.length === 0) {
|
|
109
|
+
throw new Error("Пустая миссия: декомпозиция невозможна");
|
|
110
|
+
}
|
|
111
|
+
return steps;
|
|
112
|
+
}
|
|
113
|
+
|
|
114
|
+
function assertMaxSteps(maxSteps: number): void {
|
|
115
|
+
if (!Number.isInteger(maxSteps) || maxSteps < 1) {
|
|
116
|
+
throw new Error(`Некорректный maxSteps: ${String(maxSteps)}`);
|
|
117
|
+
}
|
|
118
|
+
}
|
|
119
|
+
|
|
120
|
+
function normalizeSteps(raw: readonly MissionStep[], maxSteps: number): MissionStep[] {
|
|
121
|
+
if (!Array.isArray(raw) || raw.length === 0) {
|
|
122
|
+
throw new Error("Декомпозер вернул пустой план");
|
|
123
|
+
}
|
|
124
|
+
const steps: MissionStep[] = [];
|
|
125
|
+
for (const item of raw.slice(0, maxSteps)) {
|
|
126
|
+
const stepName = typeof item?.stepName === "string" ? item.stepName.trim() : "";
|
|
127
|
+
const taskType = typeof item?.taskType === "string" ? normalizeTaskType(item.taskType) : "";
|
|
128
|
+
if (!stepName || !taskType) {
|
|
129
|
+
throw new Error("Декомпозер вернул шаг без имени или типа задачи");
|
|
130
|
+
}
|
|
131
|
+
steps.push({ stepName, taskType });
|
|
132
|
+
}
|
|
133
|
+
return steps;
|
|
134
|
+
}
|
|
135
|
+
|
|
136
|
+
function buildPlan(mission: string, steps: MissionStep[], source: PlanSource): MissionPlan {
|
|
137
|
+
const ambiguousTaskTypes = [...new Set(steps.filter((step) => !isStaticTaskType(step.taskType)).map((step) => step.taskType))];
|
|
138
|
+
return { mission, steps, source, ambiguousTaskTypes };
|
|
139
|
+
}
|
|
140
|
+
|
|
141
|
+
/** Асинхронная декомпозиция: модель, если передана, иначе эвристика. */
|
|
142
|
+
export async function planMission(mission: string, options: PlanOptions = {}): Promise<MissionPlan> {
|
|
143
|
+
const text = mission.trim();
|
|
144
|
+
if (!text) {
|
|
145
|
+
throw new Error("Пустая миссия: декомпозиция невозможна");
|
|
146
|
+
}
|
|
147
|
+
const maxSteps = options.maxSteps ?? DEFAULT_MAX_STEPS;
|
|
148
|
+
assertMaxSteps(maxSteps);
|
|
149
|
+
|
|
150
|
+
if (options.decomposer) {
|
|
151
|
+
const raw = await options.decomposer.decompose(text);
|
|
152
|
+
return buildPlan(text, normalizeSteps(raw, maxSteps), "model");
|
|
153
|
+
}
|
|
154
|
+
return buildPlan(text, decomposeHeuristically(text, maxSteps), "heuristic");
|
|
155
|
+
}
|
|
156
|
+
|
|
157
|
+
/** Синхронный вариант для мест, где промис неудобен. */
|
|
158
|
+
export function planMissionSync(mission: string, options: Omit<PlanOptions, "decomposer"> = {}): MissionPlan {
|
|
159
|
+
const text = mission.trim();
|
|
160
|
+
if (!text) {
|
|
161
|
+
throw new Error("Пустая миссия: декомпозиция невозможна");
|
|
162
|
+
}
|
|
163
|
+
const maxSteps = options.maxSteps ?? DEFAULT_MAX_STEPS;
|
|
164
|
+
assertMaxSteps(maxSteps);
|
|
165
|
+
return buildPlan(text, decomposeHeuristically(text, maxSteps), "heuristic");
|
|
166
|
+
}
|
|
@@ -0,0 +1,109 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Слой 1 роутера — статические правила горячего пути (Спринт 36.5.a).
|
|
3
|
+
*
|
|
4
|
+
* Таблица «тип задачи → транспорт + исполнитель» отвечает на вопрос «как
|
|
5
|
+
* выполнять шаг» без модели: 0 токенов, чистая функция, мгновенный ответ.
|
|
6
|
+
* Модель (слой 3) сюда не заглядывает — она только разбивает миссию на шаги
|
|
7
|
+
* с типами, а маршрут выбирается по этой таблице (и по Capability Map из
|
|
8
|
+
* слоя 2, см. src/db/capability-repo.ts).
|
|
9
|
+
*
|
|
10
|
+
* Модуль намеренно не импортирует ничего: ни БД, ни локальную модель, ни
|
|
11
|
+
* транспорт. Это гарантирует, что горячий путь не тянет за собой побочных
|
|
12
|
+
* эффектов и не может случайно вызвать модель.
|
|
13
|
+
*/
|
|
14
|
+
|
|
15
|
+
/** Транспорт доставки шага. */
|
|
16
|
+
export type RouterTransport = "direct" | "mcp" | "cloud";
|
|
17
|
+
|
|
18
|
+
/** Исполнитель шага: локальный процесс или облачная модель. */
|
|
19
|
+
export type RouterExecutor = "local" | "cloud";
|
|
20
|
+
|
|
21
|
+
/** Правило статической маршрутизации для одного типа задачи. */
|
|
22
|
+
export interface StaticRouteRule {
|
|
23
|
+
/** Тип шага в нормализованном виде (нижний регистр, подчёркивания). */
|
|
24
|
+
taskType: string;
|
|
25
|
+
transport: RouterTransport;
|
|
26
|
+
executor: RouterExecutor;
|
|
27
|
+
/** Почему правило выглядит именно так — для логов и отчётов. */
|
|
28
|
+
description: string;
|
|
29
|
+
}
|
|
30
|
+
|
|
31
|
+
/**
|
|
32
|
+
* Встроенная таблица слоя 1.
|
|
33
|
+
*
|
|
34
|
+
* Совпадает с docs/ARCHITECTURE.md → «Слой 1 — статические правила»: известные
|
|
35
|
+
* операции обслуживаются локально и напрямую, внешние системы — через MCP,
|
|
36
|
+
* облачная модель — только там, где локально сделать нельзя.
|
|
37
|
+
*/
|
|
38
|
+
export const STATIC_ROUTE_RULES: readonly StaticRouteRule[] = Object.freeze([
|
|
39
|
+
{
|
|
40
|
+
taskType: "read_file",
|
|
41
|
+
transport: "direct",
|
|
42
|
+
executor: "local",
|
|
43
|
+
description: "Чтение файла — прямое обращение к ФС, модель не нужна.",
|
|
44
|
+
},
|
|
45
|
+
{
|
|
46
|
+
taskType: "write_file",
|
|
47
|
+
transport: "direct",
|
|
48
|
+
executor: "local",
|
|
49
|
+
description: "Запись файла — прямое обращение к ФС, модель не нужна.",
|
|
50
|
+
},
|
|
51
|
+
{
|
|
52
|
+
taskType: "run_tests",
|
|
53
|
+
transport: "direct",
|
|
54
|
+
executor: "local",
|
|
55
|
+
description: "Тесты запускаются локальным процессом.",
|
|
56
|
+
},
|
|
57
|
+
{
|
|
58
|
+
taskType: "apply_diff",
|
|
59
|
+
transport: "direct",
|
|
60
|
+
executor: "local",
|
|
61
|
+
description: "Патч применяется локально, без внешних вызовов.",
|
|
62
|
+
},
|
|
63
|
+
{
|
|
64
|
+
taskType: "github_create_pr",
|
|
65
|
+
transport: "mcp",
|
|
66
|
+
executor: "local",
|
|
67
|
+
description: "Внешняя система GitHub — транспорт MCP, исполнитель локальный.",
|
|
68
|
+
},
|
|
69
|
+
{
|
|
70
|
+
taskType: "jira_update_task",
|
|
71
|
+
transport: "mcp",
|
|
72
|
+
executor: "cloud",
|
|
73
|
+
description: "Jira доступна только через MCP и облачный исполнитель.",
|
|
74
|
+
},
|
|
75
|
+
]);
|
|
76
|
+
|
|
77
|
+
const ROUTE_TABLE: ReadonlyMap<string, StaticRouteRule> = new Map(
|
|
78
|
+
STATIC_ROUTE_RULES.map((rule) => [rule.taskType, rule]),
|
|
79
|
+
);
|
|
80
|
+
|
|
81
|
+
/**
|
|
82
|
+
* Нормализует тип задачи: `Run Tests`, `run-tests`, ` RUN_TESTS ` → `run_tests`.
|
|
83
|
+
* Нужна, потому что план миссии может прийти из модели в свободной форме.
|
|
84
|
+
*/
|
|
85
|
+
export function normalizeTaskType(value: string): string {
|
|
86
|
+
return value
|
|
87
|
+
.trim()
|
|
88
|
+
.toLowerCase()
|
|
89
|
+
.replace(/[\s-]+/g, "_")
|
|
90
|
+
.replace(/_+/g, "_");
|
|
91
|
+
}
|
|
92
|
+
|
|
93
|
+
/** Возвращает правило слоя 1 для типа задачи или `undefined`, если тип неизвестен. */
|
|
94
|
+
export function routeStaticStep(taskType: string): StaticRouteRule | undefined {
|
|
95
|
+
if (typeof taskType !== "string" || taskType.trim() === "") {
|
|
96
|
+
return undefined;
|
|
97
|
+
}
|
|
98
|
+
return ROUTE_TABLE.get(normalizeTaskType(taskType));
|
|
99
|
+
}
|
|
100
|
+
|
|
101
|
+
/** Есть ли для типа задачи статическое правило (0 токенов, без БД). */
|
|
102
|
+
export function isStaticTaskType(taskType: string): boolean {
|
|
103
|
+
return routeStaticStep(taskType) !== undefined;
|
|
104
|
+
}
|
|
105
|
+
|
|
106
|
+
/** Снимок таблицы слоя 1 — для отчётов, GUI и тестов. */
|
|
107
|
+
export function listStaticRouteRules(): readonly StaticRouteRule[] {
|
|
108
|
+
return STATIC_ROUTE_RULES;
|
|
109
|
+
}
|
|
@@ -0,0 +1,262 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* GUI/RPC-фасад над durable-запусками (Спринт 36.8).
|
|
3
|
+
*
|
|
4
|
+
* Тонкий слой между `runs-repo`/`run-context`/`run-resume` и RPC: приводит
|
|
5
|
+
* фильтр и лимит к безопасным значениям, отдаёт панели компактное описание
|
|
6
|
+
* запуска (текущий шаг, прогресс, история контекста) и не выпускает панику
|
|
7
|
+
* БД наружу.
|
|
8
|
+
*
|
|
9
|
+
* Resume здесь, как и retry в DLQ (36.6), только готовит запуск: снимает
|
|
10
|
+
* паузу/переоткрывает failed и возвращает первый незавершённый шаг.
|
|
11
|
+
* Выполнение шагов запускает исполнитель DAG через `resumeRun`, поэтому
|
|
12
|
+
* фасад не притворяется, что работа уже сделана.
|
|
13
|
+
*/
|
|
14
|
+
import {
|
|
15
|
+
getRun,
|
|
16
|
+
listRuns,
|
|
17
|
+
listRunSteps,
|
|
18
|
+
reopenRun,
|
|
19
|
+
type RunRecord,
|
|
20
|
+
type RunStatus,
|
|
21
|
+
type RunStepRecord,
|
|
22
|
+
} from "../db/runs-repo.js";
|
|
23
|
+
import {
|
|
24
|
+
listRunInjections,
|
|
25
|
+
pauseRun,
|
|
26
|
+
type RunInjection,
|
|
27
|
+
type PauseRunInput,
|
|
28
|
+
} from "../db/run-context.js";
|
|
29
|
+
import { findResumeStep } from "../db/run-resume.js";
|
|
30
|
+
|
|
31
|
+
/** Фильтр панели: конкретный статус, все записи или активные. */
|
|
32
|
+
export type RunPanelFilter = RunStatus | "all" | "active";
|
|
33
|
+
|
|
34
|
+
/** Компактная вставка контекста для истории панели. */
|
|
35
|
+
export interface RunPanelInjection {
|
|
36
|
+
id: string;
|
|
37
|
+
kind: string;
|
|
38
|
+
/** Обрезанный до 500 символов текст (секреты уже замаскированы в БД). */
|
|
39
|
+
content: string;
|
|
40
|
+
contentLength: number;
|
|
41
|
+
author: string;
|
|
42
|
+
createdAt: string;
|
|
43
|
+
consumedAt: string | null;
|
|
44
|
+
consumedByStep: string | null;
|
|
45
|
+
}
|
|
46
|
+
|
|
47
|
+
/** Шаг запуска для панели. */
|
|
48
|
+
export interface RunPanelStep {
|
|
49
|
+
stepName: string;
|
|
50
|
+
position: number;
|
|
51
|
+
status: string;
|
|
52
|
+
attempt: number;
|
|
53
|
+
error: string | null;
|
|
54
|
+
/** Якорь для ссылки «текущий шаг». */
|
|
55
|
+
anchor: string;
|
|
56
|
+
}
|
|
57
|
+
|
|
58
|
+
/** Описание одного durable-запуска. */
|
|
59
|
+
export interface RunPanelRun {
|
|
60
|
+
id: string;
|
|
61
|
+
taskName: string;
|
|
62
|
+
status: RunStatus;
|
|
63
|
+
createdAt: string;
|
|
64
|
+
startedAt: string | null;
|
|
65
|
+
finishedAt: string | null;
|
|
66
|
+
error: string | null;
|
|
67
|
+
steps: RunPanelStep[];
|
|
68
|
+
/** Первый незавершённый шаг или null, если все шаги закрыты. */
|
|
69
|
+
currentStep: RunPanelStep | null;
|
|
70
|
+
/** Сколько шагов уже passed/skipped. */
|
|
71
|
+
doneSteps: number;
|
|
72
|
+
totalSteps: number;
|
|
73
|
+
injections: RunPanelInjection[];
|
|
74
|
+
pendingInjections: number;
|
|
75
|
+
}
|
|
76
|
+
|
|
77
|
+
export interface RunPanelListResult {
|
|
78
|
+
success: boolean;
|
|
79
|
+
runs: RunPanelRun[];
|
|
80
|
+
/** Сколько активных запусков (pending/running/paused/failed) для бейджа. */
|
|
81
|
+
active: number;
|
|
82
|
+
error?: string;
|
|
83
|
+
}
|
|
84
|
+
|
|
85
|
+
export interface RunPanelActionResult {
|
|
86
|
+
success: boolean;
|
|
87
|
+
error?: string;
|
|
88
|
+
run?: RunPanelRun;
|
|
89
|
+
/** Шаг, который получит контекст паузы или продолжит работу. */
|
|
90
|
+
stepName?: string | null;
|
|
91
|
+
/** true, если resume только переоткрыл запуск и подготовил шаг. */
|
|
92
|
+
prepared?: boolean;
|
|
93
|
+
}
|
|
94
|
+
|
|
95
|
+
const MAX_CONTENT_PREVIEW = 500;
|
|
96
|
+
const DEFAULT_LIMIT = 20;
|
|
97
|
+
const MAX_LIMIT = 100;
|
|
98
|
+
const ACTIVE_STATUSES: RunStatus[] = ["pending", "running", "paused", "failed"];
|
|
99
|
+
|
|
100
|
+
function errorText(err: unknown): string {
|
|
101
|
+
return err instanceof Error ? err.message : String(err);
|
|
102
|
+
}
|
|
103
|
+
|
|
104
|
+
/** Неизвестный фильтр трактуем как `active` — безопасный дефолт панели. */
|
|
105
|
+
export function normalizeRunPanelFilter(value: unknown): RunPanelFilter {
|
|
106
|
+
if (value === "all" || value === "active") return value;
|
|
107
|
+
if (
|
|
108
|
+
value === "pending" ||
|
|
109
|
+
value === "running" ||
|
|
110
|
+
value === "paused" ||
|
|
111
|
+
value === "passed" ||
|
|
112
|
+
value === "failed" ||
|
|
113
|
+
value === "cancelled"
|
|
114
|
+
) {
|
|
115
|
+
return value;
|
|
116
|
+
}
|
|
117
|
+
return "active";
|
|
118
|
+
}
|
|
119
|
+
|
|
120
|
+
function normalizeLimit(value: unknown, fallback = DEFAULT_LIMIT): number {
|
|
121
|
+
const num = Math.floor(Number(value));
|
|
122
|
+
if (!Number.isFinite(num) || num < 1) return fallback;
|
|
123
|
+
return Math.min(num, MAX_LIMIT);
|
|
124
|
+
}
|
|
125
|
+
|
|
126
|
+
function stepAnchor(runId: string, stepName: string): string {
|
|
127
|
+
return `run-step-${runId}-${stepName.replace(/[^A-Za-z0-9_-]/g, "_")}`;
|
|
128
|
+
}
|
|
129
|
+
|
|
130
|
+
function toPanelStep(runId: string, step: RunStepRecord): RunPanelStep {
|
|
131
|
+
return {
|
|
132
|
+
stepName: step.stepName,
|
|
133
|
+
position: step.position,
|
|
134
|
+
status: step.status,
|
|
135
|
+
attempt: step.attempt,
|
|
136
|
+
error: step.error,
|
|
137
|
+
anchor: stepAnchor(runId, step.stepName),
|
|
138
|
+
};
|
|
139
|
+
}
|
|
140
|
+
|
|
141
|
+
function toPanelInjection(injection: RunInjection): RunPanelInjection {
|
|
142
|
+
return {
|
|
143
|
+
id: injection.id,
|
|
144
|
+
kind: injection.kind,
|
|
145
|
+
content:
|
|
146
|
+
injection.content.length > MAX_CONTENT_PREVIEW
|
|
147
|
+
? `${injection.content.slice(0, MAX_CONTENT_PREVIEW)}…`
|
|
148
|
+
: injection.content,
|
|
149
|
+
contentLength: injection.content.length,
|
|
150
|
+
author: injection.author,
|
|
151
|
+
createdAt: injection.createdAt,
|
|
152
|
+
consumedAt: injection.consumedAt,
|
|
153
|
+
consumedByStep: injection.consumedByStep,
|
|
154
|
+
};
|
|
155
|
+
}
|
|
156
|
+
|
|
157
|
+
function isDone(step: RunStepRecord): boolean {
|
|
158
|
+
return step.status === "passed" || step.status === "skipped";
|
|
159
|
+
}
|
|
160
|
+
|
|
161
|
+
/** Собирает компактное описание запуска. */
|
|
162
|
+
export function getRunPanelRun(runId: string): RunPanelRun | undefined {
|
|
163
|
+
const run = getRun(runId);
|
|
164
|
+
if (!run) return undefined;
|
|
165
|
+
return toPanelRun(run);
|
|
166
|
+
}
|
|
167
|
+
|
|
168
|
+
function toPanelRun(run: RunRecord): RunPanelRun {
|
|
169
|
+
const steps = listRunSteps(run.id);
|
|
170
|
+
const panelSteps = steps.map((step) => toPanelStep(run.id, step));
|
|
171
|
+
const current = steps.find((step) => !isDone(step));
|
|
172
|
+
const allInjections = listRunInjections(run.id);
|
|
173
|
+
const injections = allInjections.slice(-20).map(toPanelInjection);
|
|
174
|
+
return {
|
|
175
|
+
id: run.id,
|
|
176
|
+
taskName: run.taskName,
|
|
177
|
+
status: run.status,
|
|
178
|
+
createdAt: run.createdAt,
|
|
179
|
+
startedAt: run.startedAt,
|
|
180
|
+
finishedAt: run.finishedAt,
|
|
181
|
+
error: run.error,
|
|
182
|
+
steps: panelSteps,
|
|
183
|
+
currentStep: current ? toPanelStep(run.id, current) : null,
|
|
184
|
+
doneSteps: steps.filter(isDone).length,
|
|
185
|
+
totalSteps: steps.length,
|
|
186
|
+
injections,
|
|
187
|
+
pendingInjections: allInjections.filter((item) => item.consumedAt === null).length,
|
|
188
|
+
};
|
|
189
|
+
}
|
|
190
|
+
|
|
191
|
+
/** Список запусков для панели и счётчик активных. */
|
|
192
|
+
export function listRunPanel(
|
|
193
|
+
options: { filter?: unknown; limit?: unknown } = {},
|
|
194
|
+
): RunPanelListResult {
|
|
195
|
+
try {
|
|
196
|
+
const filter = normalizeRunPanelFilter(options.filter);
|
|
197
|
+
const limit = normalizeLimit(options.limit);
|
|
198
|
+
const all = listRuns(undefined, MAX_LIMIT);
|
|
199
|
+
const matching = all.filter((run) =>
|
|
200
|
+
filter === "all"
|
|
201
|
+
? true
|
|
202
|
+
: filter === "active"
|
|
203
|
+
? ACTIVE_STATUSES.includes(run.status)
|
|
204
|
+
: run.status === filter,
|
|
205
|
+
);
|
|
206
|
+
return {
|
|
207
|
+
success: true,
|
|
208
|
+
runs: matching.slice(0, limit).map(toPanelRun),
|
|
209
|
+
active: all.filter((run) => ACTIVE_STATUSES.includes(run.status)).length,
|
|
210
|
+
};
|
|
211
|
+
} catch (err) {
|
|
212
|
+
return { success: false, runs: [], active: 0, error: errorText(err) };
|
|
213
|
+
}
|
|
214
|
+
}
|
|
215
|
+
|
|
216
|
+
/**
|
|
217
|
+
* Пауза с комментарием. Ошибки (running-шаг, терминальный запуск, нет
|
|
218
|
+
* незавершённых шагов) возвращаются как `{ success: false }`, чтобы GUI
|
|
219
|
+
* показал их рядом с кнопкой.
|
|
220
|
+
*/
|
|
221
|
+
export function pauseRunPanel(
|
|
222
|
+
runId: string,
|
|
223
|
+
input: Omit<PauseRunInput, "file" | "artifact"> = {},
|
|
224
|
+
): RunPanelActionResult {
|
|
225
|
+
try {
|
|
226
|
+
const result = pauseRun(runId, input);
|
|
227
|
+
return {
|
|
228
|
+
success: true,
|
|
229
|
+
run: toPanelRun(result.run),
|
|
230
|
+
stepName: result.stepName,
|
|
231
|
+
};
|
|
232
|
+
} catch (err) {
|
|
233
|
+
return { success: false, error: errorText(err) };
|
|
234
|
+
}
|
|
235
|
+
}
|
|
236
|
+
|
|
237
|
+
/**
|
|
238
|
+
* Resume только готовит запуск: paused/failed → running, шаг остаётся
|
|
239
|
+
* незавершённым. Дальше его выполняет `resumeRun`/внешний исполнитель DAG.
|
|
240
|
+
*/
|
|
241
|
+
export function resumeRunPanel(runId: string): RunPanelActionResult {
|
|
242
|
+
try {
|
|
243
|
+
const run = getRun(runId);
|
|
244
|
+
if (!run) return { success: false, error: `Запуск не найден: ${runId}` };
|
|
245
|
+
if (run.status !== "paused" && run.status !== "failed") {
|
|
246
|
+
return {
|
|
247
|
+
success: false,
|
|
248
|
+
error: `Запуск в статусе ${run.status} нельзя возобновить: ${runId}`,
|
|
249
|
+
};
|
|
250
|
+
}
|
|
251
|
+
reopenRun(runId);
|
|
252
|
+
const next = findResumeStep(runId);
|
|
253
|
+
return {
|
|
254
|
+
success: true,
|
|
255
|
+
run: toPanelRun(getRun(runId)!),
|
|
256
|
+
stepName: next?.stepName ?? null,
|
|
257
|
+
prepared: true,
|
|
258
|
+
};
|
|
259
|
+
} catch (err) {
|
|
260
|
+
return { success: false, error: errorText(err) };
|
|
261
|
+
}
|
|
262
|
+
}
|
|
@@ -161,11 +161,15 @@ async function main(): Promise<number> {
|
|
|
161
161
|
try {
|
|
162
162
|
spec = parseCron(cronExpr);
|
|
163
163
|
} catch (err: any) {
|
|
164
|
+
// Fail-closed: при повреждённом cron проверка расписания невозможна.
|
|
165
|
+
// Если пропустить её (fail-open), задача с окном/днями будет
|
|
166
|
+
// запускаться на каждом минутном тике — включая дорогие LLM-агенты.
|
|
164
167
|
console.error(
|
|
165
|
-
`[schedule-gate]
|
|
168
|
+
`[schedule-gate] ОШИБКА: невалидный cron «${cronExpr}»: ${
|
|
166
169
|
err instanceof Error ? err.message : String(err)
|
|
167
|
-
}
|
|
170
|
+
}. Запуск пропущен (fail-closed). Исправьте расписание задачи.`,
|
|
168
171
|
);
|
|
172
|
+
return 3;
|
|
169
173
|
}
|
|
170
174
|
}
|
|
171
175
|
|