agent-steward 0.0.2 → 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 +45 -2
- package/CROSS_PLATFORM.md +11 -9
- package/README.md +11 -10
- package/ROADMAP-STRATEGY.md +93 -44
- package/ROADMAP.md +148 -1017
- package/dist/core/cron-to-schtasks.d.ts +0 -8
- package/dist/core/cron-to-schtasks.d.ts.map +1 -1
- package/dist/core/cron-to-schtasks.js +11 -86
- 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 +19 -2
- package/dist/core/file-watcher.js +9 -9
- package/dist/core/git-trigger.js +4 -4
- package/dist/core/lock.d.ts +20 -4
- package/dist/core/lock.d.ts.map +1 -1
- package/dist/core/lock.js +99 -26
- package/dist/core/one-shot.d.ts +31 -5
- package/dist/core/one-shot.d.ts.map +1 -1
- package/dist/core/one-shot.js +78 -10
- 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/otel.js +2 -2
- 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 +66 -36
- 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 +78 -54
- 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 +36 -2
- package/dist/core/schedule-v2.d.ts.map +1 -1
- package/dist/core/schedule-v2.js +98 -12
- package/dist/core/scheduler/at-fallback.d.ts +95 -0
- package/dist/core/scheduler/at-fallback.d.ts.map +1 -0
- package/dist/core/scheduler/at-fallback.js +200 -0
- package/dist/core/scheduler/linux.d.ts +13 -2
- package/dist/core/scheduler/linux.d.ts.map +1 -1
- package/dist/core/scheduler/linux.js +67 -13
- package/dist/core/scheduler/mac.d.ts +14 -8
- package/dist/core/scheduler/mac.d.ts.map +1 -1
- package/dist/core/scheduler/mac.js +71 -22
- package/dist/core/scheduler/posix.d.ts.map +1 -1
- package/dist/core/scheduler/posix.js +37 -2
- package/dist/core/scheduler/registry.d.ts +13 -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/scheduler/windows.d.ts +16 -3
- package/dist/core/scheduler/windows.d.ts.map +1 -1
- package/dist/core/scheduler/windows.js +249 -96
- package/dist/core/secrets.d.ts.map +1 -1
- package/dist/core/secrets.js +127 -30
- package/dist/core/self-analysis.js +55 -55
- package/dist/core/session.d.ts.map +1 -1
- package/dist/core/session.js +18 -11
- package/dist/core/summary.js +1 -1
- 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/triage-chain.js +1 -1
- package/dist/core/triage-worker.js +2 -2
- package/dist/core/triage.js +1 -1
- package/dist/core/wrappers/bash.d.ts.map +1 -1
- package/dist/core/wrappers/bash.js +82 -37
- 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 +6 -0
- package/dist/db/index.d.ts.map +1 -1
- package/dist/db/index.js +48 -2
- 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-journal.d.ts +60 -0
- package/dist/db/run-journal.d.ts.map +1 -0
- package/dist/db/run-journal.js +143 -0
- package/dist/db/run-resume.d.ts +51 -0
- package/dist/db/run-resume.d.ts.map +1 -0
- package/dist/db/run-resume.js +156 -0
- package/dist/db/runs-repo.d.ts +128 -0
- package/dist/db/runs-repo.d.ts.map +1 -0
- package/dist/db/runs-repo.js +342 -0
- package/dist/db/schema.d.ts +16 -2
- package/dist/db/schema.d.ts.map +1 -1
- package/dist/db/schema.js +342 -35
- 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 +5 -5
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +168 -40
- package/dist/notifications.js +18 -18
- package/dist/profiles.d.ts +7 -3
- package/dist/profiles.d.ts.map +1 -1
- package/dist/profiles.js +85 -7
- package/dist/rpc.d.ts +787 -0
- package/dist/rpc.d.ts.map +1 -1
- package/dist/rpc.js +324 -0
- package/dist/server.d.ts +33 -2
- package/dist/server.d.ts.map +1 -1
- package/dist/server.js +115 -54
- package/dist/shared/jobs-view.d.ts.map +1 -1
- package/dist/skill.js +1 -1
- package/dist/task-transfer.d.ts +1 -1
- package/dist/task-transfer.d.ts.map +1 -1
- package/dist/task-transfer.js +14 -10
- package/dist/types.d.ts +20 -4
- package/dist/types.d.ts.map +1 -1
- package/dist/types.js +44 -9
- package/dist/workspaces.d.ts +25 -3
- package/dist/workspaces.d.ts.map +1 -1
- package/dist/workspaces.js +44 -9
- package/docs/ARCHITECTURE.md +335 -9
- package/docs/COMPATIBILITY.md +10 -6
- package/docs/CONCEPT.md +183 -91
- package/docs/CROSS_PLATFORM.ru.md +11 -9
- package/docs/CROSS_PLATFORM.zh.md +11 -9
- package/docs/EXECUTION-LOOP.md +196 -0
- package/docs/FAQ.md +2 -2
- package/docs/FAQ.ru.md +2 -2
- package/docs/FAQ.zh.md +2 -2
- package/docs/FEATURES.md +5 -4
- package/docs/FEATURES.zh.md +5 -4
- package/docs/MIGRATION.md +34 -26
- package/docs/README.ru.md +27 -8
- package/docs/README.zh.md +11 -10
- 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/docs/V1-V2-COMPATIBILITY-PLAN.md +6 -6
- package/gui-experimental.cjs +8 -8
- package/index.js +1 -0
- package/locales/en.json +68 -0
- package/locales/ru.json +68 -0
- package/locales/zh.json +68 -0
- package/package.json +57 -11
- package/scripts/audit-bundle.mjs +215 -0
- package/src/core/analytics.ts +2 -2
- package/src/core/audit.ts +17 -17
- package/src/core/cron-to-schtasks.ts +14 -93
- package/src/core/dlq-api.ts +98 -0
- package/src/core/dry-run.ts +51 -27
- package/src/core/file-watcher.ts +17 -17
- package/src/core/git-trigger.ts +9 -9
- package/src/core/glob.ts +1 -1
- package/src/core/local-ai.ts +2 -2
- package/src/core/lock.ts +104 -31
- package/src/core/matrix.ts +31 -31
- package/src/core/native-notify.ts +2 -2
- package/src/core/one-shot.ts +91 -13
- package/src/core/opencode-cli.ts +103 -0
- package/src/core/opencode-models.ts +315 -0
- package/src/core/otel.ts +4 -4
- package/src/core/permissions.ts +5 -5
- package/src/core/prometheus.ts +17 -17
- package/src/core/ps-wrapper.ts +68 -38
- package/src/core/record-history.ts +114 -76
- package/src/core/retention.ts +3 -3
- 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/savings.ts +1 -1
- package/src/core/schedule-gate.ts +17 -13
- package/src/core/schedule-v2.ts +138 -29
- package/src/core/scheduler/at-fallback.ts +298 -0
- package/src/core/scheduler/index.ts +3 -3
- package/src/core/scheduler/linux.ts +92 -19
- package/src/core/scheduler/logs.ts +1 -1
- package/src/core/scheduler/mac.ts +112 -60
- package/src/core/scheduler/posix.ts +35 -2
- package/src/core/scheduler/registry.ts +109 -26
- package/src/core/scheduler/run-now.ts +32 -0
- package/src/core/scheduler/windows.ts +295 -125
- package/src/core/secrets.ts +139 -39
- package/src/core/self-analysis.ts +61 -61
- package/src/core/session.ts +26 -13
- package/src/core/structured-log.ts +3 -3
- package/src/core/summary.ts +25 -25
- package/src/core/task-name.ts +67 -0
- package/src/core/telegram.ts +16 -16
- package/src/core/triage-chain.ts +4 -4
- package/src/core/triage-compare.ts +8 -8
- package/src/core/triage-rules.ts +4 -4
- package/src/core/triage-shadow.ts +7 -7
- package/src/core/triage-worker.ts +6 -6
- package/src/core/triage.ts +23 -23
- package/src/core/watch-paths.ts +1 -1
- package/src/core/wrappers/bash.ts +90 -45
- package/src/db/capability-repo.ts +285 -0
- package/src/db/git-state-repo.ts +1 -1
- package/src/db/history-repo.ts +44 -22
- package/src/db/index.ts +53 -7
- package/src/db/metrics-repo.ts +10 -10
- package/src/db/migrate.ts +13 -11
- package/src/db/recovery.ts +3 -3
- package/src/db/run-context.ts +370 -0
- package/src/db/run-dlq.ts +310 -0
- package/src/db/run-journal.ts +212 -0
- package/src/db/run-resume.ts +256 -0
- package/src/db/runs-repo.ts +504 -0
- package/src/db/schema.ts +357 -44
- package/src/db/settings-repo.ts +33 -2
- package/src/db/step-idempotency.ts +185 -0
- package/src/db/tasks-repo.ts +10 -10
- package/src/db/templates-repo.ts +7 -7
- package/src/gui.tsx +516 -1
- package/src/history.ts +4 -4
- package/src/i18n.ts +7 -7
- package/src/index.ts +465 -308
- package/src/integrations.ts +6 -6
- package/src/notifications.ts +76 -76
- package/src/profiles.ts +98 -7
- package/src/rpc.ts +347 -1
- package/src/schtasks.ts +2 -2
- package/src/server.ts +155 -78
- package/src/settings.ts +44 -44
- package/src/shared/jobs-view.ts +60 -60
- package/src/skill.ts +1 -1
- package/src/task-transfer.ts +58 -56
- package/src/templates.ts +1 -1
- package/src/types.ts +54 -10
- package/src/workspaces.ts +73 -24
- package/dist/core/self-analysis.test.d.ts +0 -2
- package/dist/core/self-analysis.test.d.ts.map +0 -1
- package/dist/core/self-analysis.test.js +0 -219
- package/dist/gui-experimental.cjs +0 -1
|
@@ -0,0 +1,59 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Сборка маршрута шага из слоёв 1–2 (Спринт 36.5.d).
|
|
3
|
+
*
|
|
4
|
+
* Слой 1 отвечает мгновенно по таблице правил, слой 2 — по Capability Map.
|
|
5
|
+
* Модель здесь не участвует: `routeStep` не импортирует planner и ничего не
|
|
6
|
+
* декомпозирует, поэтому известный тип задачи обходится в 0 токенов.
|
|
7
|
+
*/
|
|
8
|
+
import { decideCapabilityRoute } from "../../db/capability-repo.js";
|
|
9
|
+
import { normalizeTaskType, routeStaticStep } from "./rules.js";
|
|
10
|
+
/**
|
|
11
|
+
* Строит маршрут для типа задачи: статическое правило, затем Capability Map.
|
|
12
|
+
* Пустой тип — ошибка, а не молчаливый `explore`: маршрутизировать нечего.
|
|
13
|
+
*/
|
|
14
|
+
export function routeStep(taskType, thresholds = {}) {
|
|
15
|
+
const key = normalizeTaskType(taskType);
|
|
16
|
+
if (key === "") {
|
|
17
|
+
throw new Error("Пустой тип задачи: маршрутизация невозможна.");
|
|
18
|
+
}
|
|
19
|
+
const rule = routeStaticStep(key);
|
|
20
|
+
if (rule !== undefined) {
|
|
21
|
+
return {
|
|
22
|
+
taskType: key,
|
|
23
|
+
target: rule.executor,
|
|
24
|
+
transport: rule.transport,
|
|
25
|
+
executor: rule.executor,
|
|
26
|
+
source: "static",
|
|
27
|
+
reason: "static-rule",
|
|
28
|
+
};
|
|
29
|
+
}
|
|
30
|
+
const decision = decideCapabilityRoute(key, thresholds);
|
|
31
|
+
const target = decision.target;
|
|
32
|
+
return {
|
|
33
|
+
taskType: key,
|
|
34
|
+
target,
|
|
35
|
+
transport: transportForTarget(target),
|
|
36
|
+
executor: executorForTarget(target),
|
|
37
|
+
source: "capability",
|
|
38
|
+
reason: decision.reason,
|
|
39
|
+
decision,
|
|
40
|
+
};
|
|
41
|
+
}
|
|
42
|
+
function transportForTarget(target) {
|
|
43
|
+
if (target === "cloud") {
|
|
44
|
+
return "cloud";
|
|
45
|
+
}
|
|
46
|
+
if (target === "local") {
|
|
47
|
+
return "direct";
|
|
48
|
+
}
|
|
49
|
+
return null;
|
|
50
|
+
}
|
|
51
|
+
function executorForTarget(target) {
|
|
52
|
+
if (target === "cloud") {
|
|
53
|
+
return "cloud";
|
|
54
|
+
}
|
|
55
|
+
if (target === "local") {
|
|
56
|
+
return "local";
|
|
57
|
+
}
|
|
58
|
+
return null;
|
|
59
|
+
}
|
|
@@ -0,0 +1,47 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Эскалация после провала Quality Gate (Спринт 36.5.d).
|
|
3
|
+
*
|
|
4
|
+
* Правило детерминированное и не обращается ни к БД, ни к модели, ни к сети:
|
|
5
|
+
* провал на локальном исполнителе ведёт в облако, провал в облаке — на ручной
|
|
6
|
+
* review, провал review означает, что автоматических уровней больше нет.
|
|
7
|
+
* Решение принимается по одному флагу `passed`, поэтому его можно вызывать
|
|
8
|
+
* в горячем пути без затрат токенов.
|
|
9
|
+
*/
|
|
10
|
+
/** Уровень исполнения, на котором сработал Quality Gate. */
|
|
11
|
+
export type GateTarget = "local" | "cloud" | "review";
|
|
12
|
+
/** Что делать после проверки гейта. */
|
|
13
|
+
export type EscalationAction = "accept" | "escalate-cloud" | "escalate-review" | "blocked";
|
|
14
|
+
/** Результат Quality Gate, который видит роутер. */
|
|
15
|
+
export interface GateResult {
|
|
16
|
+
/** Прошёл ли шаг проверку. */
|
|
17
|
+
passed: boolean;
|
|
18
|
+
/** Свободное пояснение для журнала и уведомлений. */
|
|
19
|
+
reason?: string;
|
|
20
|
+
}
|
|
21
|
+
/** Решение об эскалации с текущего уровня. */
|
|
22
|
+
export interface EscalationDecision {
|
|
23
|
+
/** Уровень, на котором гейт сработал. */
|
|
24
|
+
from: GateTarget;
|
|
25
|
+
/** Куда переходим (при `accept` совпадает с `from`). */
|
|
26
|
+
next: GateTarget;
|
|
27
|
+
action: EscalationAction;
|
|
28
|
+
/** Почему принято решение: стабильный код, а не текст ошибки. */
|
|
29
|
+
reason: "gate-passed" | "local-failed" | "cloud-failed" | "review-failed";
|
|
30
|
+
}
|
|
31
|
+
/** Сколько автоматических эскалаций допускает цепочка local → cloud → review. */
|
|
32
|
+
export declare const MAX_ESCALATION_STEPS = 2;
|
|
33
|
+
/** Следующий уровень эскалации; `null` — автоматических уровней больше нет. */
|
|
34
|
+
export declare function nextGateTarget(current: GateTarget): GateTarget | null;
|
|
35
|
+
/** Исчерпаны ли автоматические уровни для текущего исполнителя. */
|
|
36
|
+
export declare function isEscalationExhausted(current: GateTarget): boolean;
|
|
37
|
+
/**
|
|
38
|
+
* Решает, что делать после гейта: принять результат или подняться на уровень
|
|
39
|
+
* выше. Модель здесь не вызывается — только таблица переходов.
|
|
40
|
+
*/
|
|
41
|
+
export declare function escalateAfterGate(current: GateTarget, gate: GateResult): EscalationDecision;
|
|
42
|
+
/**
|
|
43
|
+
* Полная цепочка уровней, которые предстоит пройти начиная с текущего
|
|
44
|
+
* (включая его). Полезно для dry-run и объяснения решения оператору.
|
|
45
|
+
*/
|
|
46
|
+
export declare function escalationChain(current: GateTarget): GateTarget[];
|
|
47
|
+
//# sourceMappingURL=escalation.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"escalation.d.ts","sourceRoot":"","sources":["../../../src/core/router/escalation.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,4DAA4D;AAC5D,MAAM,MAAM,UAAU,GAAG,OAAO,GAAG,OAAO,GAAG,QAAQ,CAAC;AAEtD,uCAAuC;AACvC,MAAM,MAAM,gBAAgB,GACxB,QAAQ,GACR,gBAAgB,GAChB,iBAAiB,GACjB,SAAS,CAAC;AAEd,oDAAoD;AACpD,MAAM,WAAW,UAAU;IACzB,8BAA8B;IAC9B,MAAM,EAAE,OAAO,CAAC;IAChB,qDAAqD;IACrD,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,8CAA8C;AAC9C,MAAM,WAAW,kBAAkB;IACjC,yCAAyC;IACzC,IAAI,EAAE,UAAU,CAAC;IACjB,wDAAwD;IACxD,IAAI,EAAE,UAAU,CAAC;IACjB,MAAM,EAAE,gBAAgB,CAAC;IACzB,iEAAiE;IACjE,MAAM,EAAE,aAAa,GAAG,cAAc,GAAG,cAAc,GAAG,eAAe,CAAC;CAC3E;AAWD,iFAAiF;AACjF,eAAO,MAAM,oBAAoB,IAAI,CAAC;AAiBtC,+EAA+E;AAC/E,wBAAgB,cAAc,CAAC,OAAO,EAAE,UAAU,GAAG,UAAU,GAAG,IAAI,CAGrE;AAED,mEAAmE;AACnE,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,UAAU,GAAG,OAAO,CAElE;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,UAAU,EACnB,IAAI,EAAE,UAAU,GACf,kBAAkB,CA6BpB;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,UAAU,GAAG,UAAU,EAAE,CASjE"}
|
|
@@ -0,0 +1,87 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Эскалация после провала Quality Gate (Спринт 36.5.d).
|
|
3
|
+
*
|
|
4
|
+
* Правило детерминированное и не обращается ни к БД, ни к модели, ни к сети:
|
|
5
|
+
* провал на локальном исполнителе ведёт в облако, провал в облаке — на ручной
|
|
6
|
+
* review, провал review означает, что автоматических уровней больше нет.
|
|
7
|
+
* Решение принимается по одному флагу `passed`, поэтому его можно вызывать
|
|
8
|
+
* в горячем пути без затрат токенов.
|
|
9
|
+
*/
|
|
10
|
+
/** Следующий уровень эскалации или `null`, если уровни закончились. */
|
|
11
|
+
const NEXT_TARGET = Object.freeze({
|
|
12
|
+
local: "cloud",
|
|
13
|
+
cloud: "review",
|
|
14
|
+
review: null,
|
|
15
|
+
});
|
|
16
|
+
/** Сколько автоматических эскалаций допускает цепочка local → cloud → review. */
|
|
17
|
+
export const MAX_ESCALATION_STEPS = 2;
|
|
18
|
+
function assertTarget(target) {
|
|
19
|
+
if (!Object.prototype.hasOwnProperty.call(NEXT_TARGET, target)) {
|
|
20
|
+
throw new Error(`Неизвестный уровень гейта: ${String(target)}`);
|
|
21
|
+
}
|
|
22
|
+
}
|
|
23
|
+
function assertGate(gate) {
|
|
24
|
+
if (gate === null || typeof gate !== "object") {
|
|
25
|
+
throw new Error("Результат Quality Gate должен быть объектом.");
|
|
26
|
+
}
|
|
27
|
+
if (typeof gate.passed !== "boolean") {
|
|
28
|
+
throw new Error("Результат Quality Gate должен содержать boolean (passed).");
|
|
29
|
+
}
|
|
30
|
+
}
|
|
31
|
+
/** Следующий уровень эскалации; `null` — автоматических уровней больше нет. */
|
|
32
|
+
export function nextGateTarget(current) {
|
|
33
|
+
assertTarget(current);
|
|
34
|
+
return NEXT_TARGET[current];
|
|
35
|
+
}
|
|
36
|
+
/** Исчерпаны ли автоматические уровни для текущего исполнителя. */
|
|
37
|
+
export function isEscalationExhausted(current) {
|
|
38
|
+
return nextGateTarget(current) === null;
|
|
39
|
+
}
|
|
40
|
+
/**
|
|
41
|
+
* Решает, что делать после гейта: принять результат или подняться на уровень
|
|
42
|
+
* выше. Модель здесь не вызывается — только таблица переходов.
|
|
43
|
+
*/
|
|
44
|
+
export function escalateAfterGate(current, gate) {
|
|
45
|
+
assertTarget(current);
|
|
46
|
+
assertGate(gate);
|
|
47
|
+
if (gate.passed) {
|
|
48
|
+
return { from: current, next: current, action: "accept", reason: "gate-passed" };
|
|
49
|
+
}
|
|
50
|
+
const next = NEXT_TARGET[current];
|
|
51
|
+
if (next === null) {
|
|
52
|
+
return {
|
|
53
|
+
from: current,
|
|
54
|
+
next: current,
|
|
55
|
+
action: "blocked",
|
|
56
|
+
reason: "review-failed",
|
|
57
|
+
};
|
|
58
|
+
}
|
|
59
|
+
if (next === "cloud") {
|
|
60
|
+
return {
|
|
61
|
+
from: current,
|
|
62
|
+
next,
|
|
63
|
+
action: "escalate-cloud",
|
|
64
|
+
reason: "local-failed",
|
|
65
|
+
};
|
|
66
|
+
}
|
|
67
|
+
return {
|
|
68
|
+
from: current,
|
|
69
|
+
next,
|
|
70
|
+
action: "escalate-review",
|
|
71
|
+
reason: "cloud-failed",
|
|
72
|
+
};
|
|
73
|
+
}
|
|
74
|
+
/**
|
|
75
|
+
* Полная цепочка уровней, которые предстоит пройти начиная с текущего
|
|
76
|
+
* (включая его). Полезно для dry-run и объяснения решения оператору.
|
|
77
|
+
*/
|
|
78
|
+
export function escalationChain(current) {
|
|
79
|
+
assertTarget(current);
|
|
80
|
+
const chain = [];
|
|
81
|
+
let target = current;
|
|
82
|
+
while (target !== null) {
|
|
83
|
+
chain.push(target);
|
|
84
|
+
target = NEXT_TARGET[target];
|
|
85
|
+
}
|
|
86
|
+
return chain;
|
|
87
|
+
}
|
|
@@ -0,0 +1,53 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Роутер, слой 3: декомпозиция миссии.
|
|
3
|
+
*
|
|
4
|
+
* Локальная модель вызывается только здесь и только для того, чтобы разбить
|
|
5
|
+
* миссию на шаги с типом задачи. Маршрут каждого шага (транспорт и исполнитель)
|
|
6
|
+
* определяется слоями 1–2: статическими правилами и Capability Map. Если
|
|
7
|
+
* декомпозера нет, работает эвристика по ключевым словам — она не обращается
|
|
8
|
+
* ни к модели, ни к сети.
|
|
9
|
+
*/
|
|
10
|
+
import { type RouterExecutor, type RouterTransport } from "./rules.js";
|
|
11
|
+
/** Один шаг плана: имя для журнала и тип задачи для маршрутизации. */
|
|
12
|
+
export interface MissionStep {
|
|
13
|
+
stepName: string;
|
|
14
|
+
taskType: string;
|
|
15
|
+
}
|
|
16
|
+
/** Источник плана: модель или эвристика. */
|
|
17
|
+
export type PlanSource = "model" | "heuristic";
|
|
18
|
+
/** Результат декомпозиции миссии. */
|
|
19
|
+
export interface MissionPlan {
|
|
20
|
+
mission: string;
|
|
21
|
+
steps: MissionStep[];
|
|
22
|
+
source: PlanSource;
|
|
23
|
+
/** Типы шагов, которых нет в статических правилах: их маршрут решают слои 2–3. */
|
|
24
|
+
ambiguousTaskTypes: string[];
|
|
25
|
+
}
|
|
26
|
+
/** Декомпозер, который поставляет локальная модель. */
|
|
27
|
+
export interface MissionDecomposer {
|
|
28
|
+
decompose(mission: string): Promise<MissionStep[]> | MissionStep[];
|
|
29
|
+
}
|
|
30
|
+
/** Опции декомпозиции. */
|
|
31
|
+
export interface PlanOptions {
|
|
32
|
+
decomposer?: MissionDecomposer;
|
|
33
|
+
/** Предохранитель от «простыни» шагов, по умолчанию 12. */
|
|
34
|
+
maxSteps?: number;
|
|
35
|
+
}
|
|
36
|
+
/** Маршрут шага, собранный из слоёв 1–2 (для удобства интеграции). */
|
|
37
|
+
export interface ResolvedStepRoute {
|
|
38
|
+
step: MissionStep;
|
|
39
|
+
transport?: RouterTransport;
|
|
40
|
+
executor?: RouterExecutor;
|
|
41
|
+
source: "static" | "capability" | "unknown";
|
|
42
|
+
}
|
|
43
|
+
/** Нужна ли декомпозиция: одна короткая задача обходится без модели. */
|
|
44
|
+
export declare function needsDecomposition(mission: string): boolean;
|
|
45
|
+
/** Определяет тип задачи по ключевым словам фрагмента; неизвестно — `unknown`. */
|
|
46
|
+
export declare function guessTaskType(fragment: string): string;
|
|
47
|
+
/** Эвристическая декомпозиция: без модели, без сети, детерминированно. */
|
|
48
|
+
export declare function decomposeHeuristically(mission: string, maxSteps?: number): MissionStep[];
|
|
49
|
+
/** Асинхронная декомпозиция: модель, если передана, иначе эвристика. */
|
|
50
|
+
export declare function planMission(mission: string, options?: PlanOptions): Promise<MissionPlan>;
|
|
51
|
+
/** Синхронный вариант для мест, где промис неудобен. */
|
|
52
|
+
export declare function planMissionSync(mission: string, options?: Omit<PlanOptions, "decomposer">): MissionPlan;
|
|
53
|
+
//# sourceMappingURL=planner.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"planner.d.ts","sourceRoot":"","sources":["../../../src/core/router/planner.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAuC,KAAK,cAAc,EAAE,KAAK,eAAe,EAAE,MAAM,YAAY,CAAC;AAE5G,sEAAsE;AACtE,MAAM,WAAW,WAAW;IAC1B,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,4CAA4C;AAC5C,MAAM,MAAM,UAAU,GAAG,OAAO,GAAG,WAAW,CAAC;AAE/C,qCAAqC;AACrC,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,WAAW,EAAE,CAAC;IACrB,MAAM,EAAE,UAAU,CAAC;IACnB,kFAAkF;IAClF,kBAAkB,EAAE,MAAM,EAAE,CAAC;CAC9B;AAED,uDAAuD;AACvD,MAAM,WAAW,iBAAiB;IAChC,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC,GAAG,WAAW,EAAE,CAAC;CACpE;AAED,0BAA0B;AAC1B,MAAM,WAAW,WAAW;IAC1B,UAAU,CAAC,EAAE,iBAAiB,CAAC;IAC/B,2DAA2D;IAC3D,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,sEAAsE;AACtE,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,WAAW,CAAC;IAClB,SAAS,CAAC,EAAE,eAAe,CAAC;IAC5B,QAAQ,CAAC,EAAE,cAAc,CAAC;IAC1B,MAAM,EAAE,QAAQ,GAAG,YAAY,GAAG,SAAS,CAAC;CAC7C;AAoBD,wEAAwE;AACxE,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAS3D;AAED,kFAAkF;AAClF,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAQtD;AAED,0EAA0E;AAC1E,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,GAAE,MAA0B,GAAG,WAAW,EAAE,CAmB3G;AA6BD,wEAAwE;AACxE,wBAAsB,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,GAAE,WAAgB,GAAG,OAAO,CAAC,WAAW,CAAC,CAalG;AAED,wDAAwD;AACxD,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,GAAE,IAAI,CAAC,WAAW,EAAE,YAAY,CAAM,GAAG,WAAW,CAQ3G"}
|
|
@@ -0,0 +1,113 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Роутер, слой 3: декомпозиция миссии.
|
|
3
|
+
*
|
|
4
|
+
* Локальная модель вызывается только здесь и только для того, чтобы разбить
|
|
5
|
+
* миссию на шаги с типом задачи. Маршрут каждого шага (транспорт и исполнитель)
|
|
6
|
+
* определяется слоями 1–2: статическими правилами и Capability Map. Если
|
|
7
|
+
* декомпозера нет, работает эвристика по ключевым словам — она не обращается
|
|
8
|
+
* ни к модели, ни к сети.
|
|
9
|
+
*/
|
|
10
|
+
import { isStaticTaskType, normalizeTaskType } from "./rules.js";
|
|
11
|
+
const DEFAULT_MAX_STEPS = 12;
|
|
12
|
+
/**
|
|
13
|
+
* Ключевые слова эвристики. Порядок важен: более специфичные типы идут первыми,
|
|
14
|
+
* иначе «проверь тесты в PR» уедет в run_tests вместо github_create_pr.
|
|
15
|
+
*/
|
|
16
|
+
const HEURISTIC_KEYWORDS = Object.freeze([
|
|
17
|
+
{ taskType: "github_create_pr", keywords: ["pull request", "merge request", " pr ", "pr ", "пуш", "push"] },
|
|
18
|
+
{ taskType: "jira_update_task", keywords: ["jira", "джира", "тикет", "ticket", "задач"] },
|
|
19
|
+
{ taskType: "run_tests", keywords: ["тест", "test", "прогон", "проверк"] },
|
|
20
|
+
{ taskType: "apply_diff", keywords: ["исправ", "поправ", "измени", "правк", "patch", "diff", "refactor", "рефактор"] },
|
|
21
|
+
{ taskType: "write_file", keywords: ["запиши", "создай", "напиши", "write", "сохрани"] },
|
|
22
|
+
{ taskType: "read_file", keywords: ["прочит", "прочитай", "посмотр", "открой", "read", "inspect"] },
|
|
23
|
+
]);
|
|
24
|
+
/** Разделители шагов в миссии. */
|
|
25
|
+
const STEP_SPLIT_PATTERN = /\r?\n|;|,\s*(?:затем|потом|после чего)\s*|\s+(?:затем|потом|после чего)\s+/iu;
|
|
26
|
+
/** Нужна ли декомпозиция: одна короткая задача обходится без модели. */
|
|
27
|
+
export function needsDecomposition(mission) {
|
|
28
|
+
const text = mission.trim();
|
|
29
|
+
if (!text) {
|
|
30
|
+
return false;
|
|
31
|
+
}
|
|
32
|
+
if (STEP_SPLIT_PATTERN.test(text)) {
|
|
33
|
+
return true;
|
|
34
|
+
}
|
|
35
|
+
return !isStaticTaskType(text);
|
|
36
|
+
}
|
|
37
|
+
/** Определяет тип задачи по ключевым словам фрагмента; неизвестно — `unknown`. */
|
|
38
|
+
export function guessTaskType(fragment) {
|
|
39
|
+
const haystack = ` ${fragment.toLowerCase().replace(/ё/gu, "е")} `;
|
|
40
|
+
for (const entry of HEURISTIC_KEYWORDS) {
|
|
41
|
+
if (entry.keywords.some((keyword) => haystack.includes(keyword))) {
|
|
42
|
+
return entry.taskType;
|
|
43
|
+
}
|
|
44
|
+
}
|
|
45
|
+
return "unknown";
|
|
46
|
+
}
|
|
47
|
+
/** Эвристическая декомпозиция: без модели, без сети, детерминированно. */
|
|
48
|
+
export function decomposeHeuristically(mission, maxSteps = DEFAULT_MAX_STEPS) {
|
|
49
|
+
const text = mission.trim();
|
|
50
|
+
if (!text) {
|
|
51
|
+
throw new Error("Пустая миссия: декомпозиция невозможна");
|
|
52
|
+
}
|
|
53
|
+
const fragments = text
|
|
54
|
+
.split(STEP_SPLIT_PATTERN)
|
|
55
|
+
.map((fragment) => fragment.trim().replace(/^[-*\d.)\s]+/u, "").trim())
|
|
56
|
+
.filter((fragment) => fragment.length > 0);
|
|
57
|
+
const steps = fragments.slice(0, Math.max(1, maxSteps)).map((fragment) => ({
|
|
58
|
+
stepName: fragment.length > 120 ? `${fragment.slice(0, 117)}...` : fragment,
|
|
59
|
+
taskType: guessTaskType(fragment),
|
|
60
|
+
}));
|
|
61
|
+
if (steps.length === 0) {
|
|
62
|
+
throw new Error("Пустая миссия: декомпозиция невозможна");
|
|
63
|
+
}
|
|
64
|
+
return steps;
|
|
65
|
+
}
|
|
66
|
+
function assertMaxSteps(maxSteps) {
|
|
67
|
+
if (!Number.isInteger(maxSteps) || maxSteps < 1) {
|
|
68
|
+
throw new Error(`Некорректный maxSteps: ${String(maxSteps)}`);
|
|
69
|
+
}
|
|
70
|
+
}
|
|
71
|
+
function normalizeSteps(raw, maxSteps) {
|
|
72
|
+
if (!Array.isArray(raw) || raw.length === 0) {
|
|
73
|
+
throw new Error("Декомпозер вернул пустой план");
|
|
74
|
+
}
|
|
75
|
+
const steps = [];
|
|
76
|
+
for (const item of raw.slice(0, maxSteps)) {
|
|
77
|
+
const stepName = typeof item?.stepName === "string" ? item.stepName.trim() : "";
|
|
78
|
+
const taskType = typeof item?.taskType === "string" ? normalizeTaskType(item.taskType) : "";
|
|
79
|
+
if (!stepName || !taskType) {
|
|
80
|
+
throw new Error("Декомпозер вернул шаг без имени или типа задачи");
|
|
81
|
+
}
|
|
82
|
+
steps.push({ stepName, taskType });
|
|
83
|
+
}
|
|
84
|
+
return steps;
|
|
85
|
+
}
|
|
86
|
+
function buildPlan(mission, steps, source) {
|
|
87
|
+
const ambiguousTaskTypes = [...new Set(steps.filter((step) => !isStaticTaskType(step.taskType)).map((step) => step.taskType))];
|
|
88
|
+
return { mission, steps, source, ambiguousTaskTypes };
|
|
89
|
+
}
|
|
90
|
+
/** Асинхронная декомпозиция: модель, если передана, иначе эвристика. */
|
|
91
|
+
export async function planMission(mission, options = {}) {
|
|
92
|
+
const text = mission.trim();
|
|
93
|
+
if (!text) {
|
|
94
|
+
throw new Error("Пустая миссия: декомпозиция невозможна");
|
|
95
|
+
}
|
|
96
|
+
const maxSteps = options.maxSteps ?? DEFAULT_MAX_STEPS;
|
|
97
|
+
assertMaxSteps(maxSteps);
|
|
98
|
+
if (options.decomposer) {
|
|
99
|
+
const raw = await options.decomposer.decompose(text);
|
|
100
|
+
return buildPlan(text, normalizeSteps(raw, maxSteps), "model");
|
|
101
|
+
}
|
|
102
|
+
return buildPlan(text, decomposeHeuristically(text, maxSteps), "heuristic");
|
|
103
|
+
}
|
|
104
|
+
/** Синхронный вариант для мест, где промис неудобен. */
|
|
105
|
+
export function planMissionSync(mission, options = {}) {
|
|
106
|
+
const text = mission.trim();
|
|
107
|
+
if (!text) {
|
|
108
|
+
throw new Error("Пустая миссия: декомпозиция невозможна");
|
|
109
|
+
}
|
|
110
|
+
const maxSteps = options.maxSteps ?? DEFAULT_MAX_STEPS;
|
|
111
|
+
assertMaxSteps(maxSteps);
|
|
112
|
+
return buildPlan(text, decomposeHeuristically(text, maxSteps), "heuristic");
|
|
113
|
+
}
|
|
@@ -0,0 +1,46 @@
|
|
|
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
|
+
export type RouterTransport = "direct" | "mcp" | "cloud";
|
|
16
|
+
/** Исполнитель шага: локальный процесс или облачная модель. */
|
|
17
|
+
export type RouterExecutor = "local" | "cloud";
|
|
18
|
+
/** Правило статической маршрутизации для одного типа задачи. */
|
|
19
|
+
export interface StaticRouteRule {
|
|
20
|
+
/** Тип шага в нормализованном виде (нижний регистр, подчёркивания). */
|
|
21
|
+
taskType: string;
|
|
22
|
+
transport: RouterTransport;
|
|
23
|
+
executor: RouterExecutor;
|
|
24
|
+
/** Почему правило выглядит именно так — для логов и отчётов. */
|
|
25
|
+
description: string;
|
|
26
|
+
}
|
|
27
|
+
/**
|
|
28
|
+
* Встроенная таблица слоя 1.
|
|
29
|
+
*
|
|
30
|
+
* Совпадает с docs/ARCHITECTURE.md → «Слой 1 — статические правила»: известные
|
|
31
|
+
* операции обслуживаются локально и напрямую, внешние системы — через MCP,
|
|
32
|
+
* облачная модель — только там, где локально сделать нельзя.
|
|
33
|
+
*/
|
|
34
|
+
export declare const STATIC_ROUTE_RULES: readonly StaticRouteRule[];
|
|
35
|
+
/**
|
|
36
|
+
* Нормализует тип задачи: `Run Tests`, `run-tests`, ` RUN_TESTS ` → `run_tests`.
|
|
37
|
+
* Нужна, потому что план миссии может прийти из модели в свободной форме.
|
|
38
|
+
*/
|
|
39
|
+
export declare function normalizeTaskType(value: string): string;
|
|
40
|
+
/** Возвращает правило слоя 1 для типа задачи или `undefined`, если тип неизвестен. */
|
|
41
|
+
export declare function routeStaticStep(taskType: string): StaticRouteRule | undefined;
|
|
42
|
+
/** Есть ли для типа задачи статическое правило (0 токенов, без БД). */
|
|
43
|
+
export declare function isStaticTaskType(taskType: string): boolean;
|
|
44
|
+
/** Снимок таблицы слоя 1 — для отчётов, GUI и тестов. */
|
|
45
|
+
export declare function listStaticRouteRules(): readonly StaticRouteRule[];
|
|
46
|
+
//# sourceMappingURL=rules.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"rules.d.ts","sourceRoot":"","sources":["../../../src/core/router/rules.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,+BAA+B;AAC/B,MAAM,MAAM,eAAe,GAAG,QAAQ,GAAG,KAAK,GAAG,OAAO,CAAC;AAEzD,+DAA+D;AAC/D,MAAM,MAAM,cAAc,GAAG,OAAO,GAAG,OAAO,CAAC;AAE/C,gEAAgE;AAChE,MAAM,WAAW,eAAe;IAC9B,uEAAuE;IACvE,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,eAAe,CAAC;IAC3B,QAAQ,EAAE,cAAc,CAAC;IACzB,gEAAgE;IAChE,WAAW,EAAE,MAAM,CAAC;CACrB;AAED;;;;;;GAMG;AACH,eAAO,MAAM,kBAAkB,EAAE,SAAS,eAAe,EAqCvD,CAAC;AAMH;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAMvD;AAED,sFAAsF;AACtF,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,eAAe,GAAG,SAAS,CAK7E;AAED,uEAAuE;AACvE,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAE1D;AAED,yDAAyD;AACzD,wBAAgB,oBAAoB,IAAI,SAAS,eAAe,EAAE,CAEjE"}
|
|
@@ -0,0 +1,85 @@
|
|
|
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
|
+
* Встроенная таблица слоя 1.
|
|
16
|
+
*
|
|
17
|
+
* Совпадает с docs/ARCHITECTURE.md → «Слой 1 — статические правила»: известные
|
|
18
|
+
* операции обслуживаются локально и напрямую, внешние системы — через MCP,
|
|
19
|
+
* облачная модель — только там, где локально сделать нельзя.
|
|
20
|
+
*/
|
|
21
|
+
export const STATIC_ROUTE_RULES = Object.freeze([
|
|
22
|
+
{
|
|
23
|
+
taskType: "read_file",
|
|
24
|
+
transport: "direct",
|
|
25
|
+
executor: "local",
|
|
26
|
+
description: "Чтение файла — прямое обращение к ФС, модель не нужна.",
|
|
27
|
+
},
|
|
28
|
+
{
|
|
29
|
+
taskType: "write_file",
|
|
30
|
+
transport: "direct",
|
|
31
|
+
executor: "local",
|
|
32
|
+
description: "Запись файла — прямое обращение к ФС, модель не нужна.",
|
|
33
|
+
},
|
|
34
|
+
{
|
|
35
|
+
taskType: "run_tests",
|
|
36
|
+
transport: "direct",
|
|
37
|
+
executor: "local",
|
|
38
|
+
description: "Тесты запускаются локальным процессом.",
|
|
39
|
+
},
|
|
40
|
+
{
|
|
41
|
+
taskType: "apply_diff",
|
|
42
|
+
transport: "direct",
|
|
43
|
+
executor: "local",
|
|
44
|
+
description: "Патч применяется локально, без внешних вызовов.",
|
|
45
|
+
},
|
|
46
|
+
{
|
|
47
|
+
taskType: "github_create_pr",
|
|
48
|
+
transport: "mcp",
|
|
49
|
+
executor: "local",
|
|
50
|
+
description: "Внешняя система GitHub — транспорт MCP, исполнитель локальный.",
|
|
51
|
+
},
|
|
52
|
+
{
|
|
53
|
+
taskType: "jira_update_task",
|
|
54
|
+
transport: "mcp",
|
|
55
|
+
executor: "cloud",
|
|
56
|
+
description: "Jira доступна только через MCP и облачный исполнитель.",
|
|
57
|
+
},
|
|
58
|
+
]);
|
|
59
|
+
const ROUTE_TABLE = new Map(STATIC_ROUTE_RULES.map((rule) => [rule.taskType, rule]));
|
|
60
|
+
/**
|
|
61
|
+
* Нормализует тип задачи: `Run Tests`, `run-tests`, ` RUN_TESTS ` → `run_tests`.
|
|
62
|
+
* Нужна, потому что план миссии может прийти из модели в свободной форме.
|
|
63
|
+
*/
|
|
64
|
+
export function normalizeTaskType(value) {
|
|
65
|
+
return value
|
|
66
|
+
.trim()
|
|
67
|
+
.toLowerCase()
|
|
68
|
+
.replace(/[\s-]+/g, "_")
|
|
69
|
+
.replace(/_+/g, "_");
|
|
70
|
+
}
|
|
71
|
+
/** Возвращает правило слоя 1 для типа задачи или `undefined`, если тип неизвестен. */
|
|
72
|
+
export function routeStaticStep(taskType) {
|
|
73
|
+
if (typeof taskType !== "string" || taskType.trim() === "") {
|
|
74
|
+
return undefined;
|
|
75
|
+
}
|
|
76
|
+
return ROUTE_TABLE.get(normalizeTaskType(taskType));
|
|
77
|
+
}
|
|
78
|
+
/** Есть ли для типа задачи статическое правило (0 токенов, без БД). */
|
|
79
|
+
export function isStaticTaskType(taskType) {
|
|
80
|
+
return routeStaticStep(taskType) !== undefined;
|
|
81
|
+
}
|
|
82
|
+
/** Снимок таблицы слоя 1 — для отчётов, GUI и тестов. */
|
|
83
|
+
export function listStaticRouteRules() {
|
|
84
|
+
return STATIC_ROUTE_RULES;
|
|
85
|
+
}
|
|
@@ -0,0 +1,94 @@
|
|
|
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 { type RunStatus } from "../db/runs-repo.js";
|
|
15
|
+
import { type PauseRunInput } from "../db/run-context.js";
|
|
16
|
+
/** Фильтр панели: конкретный статус, все записи или активные. */
|
|
17
|
+
export type RunPanelFilter = RunStatus | "all" | "active";
|
|
18
|
+
/** Компактная вставка контекста для истории панели. */
|
|
19
|
+
export interface RunPanelInjection {
|
|
20
|
+
id: string;
|
|
21
|
+
kind: string;
|
|
22
|
+
/** Обрезанный до 500 символов текст (секреты уже замаскированы в БД). */
|
|
23
|
+
content: string;
|
|
24
|
+
contentLength: number;
|
|
25
|
+
author: string;
|
|
26
|
+
createdAt: string;
|
|
27
|
+
consumedAt: string | null;
|
|
28
|
+
consumedByStep: string | null;
|
|
29
|
+
}
|
|
30
|
+
/** Шаг запуска для панели. */
|
|
31
|
+
export interface RunPanelStep {
|
|
32
|
+
stepName: string;
|
|
33
|
+
position: number;
|
|
34
|
+
status: string;
|
|
35
|
+
attempt: number;
|
|
36
|
+
error: string | null;
|
|
37
|
+
/** Якорь для ссылки «текущий шаг». */
|
|
38
|
+
anchor: string;
|
|
39
|
+
}
|
|
40
|
+
/** Описание одного durable-запуска. */
|
|
41
|
+
export interface RunPanelRun {
|
|
42
|
+
id: string;
|
|
43
|
+
taskName: string;
|
|
44
|
+
status: RunStatus;
|
|
45
|
+
createdAt: string;
|
|
46
|
+
startedAt: string | null;
|
|
47
|
+
finishedAt: string | null;
|
|
48
|
+
error: string | null;
|
|
49
|
+
steps: RunPanelStep[];
|
|
50
|
+
/** Первый незавершённый шаг или null, если все шаги закрыты. */
|
|
51
|
+
currentStep: RunPanelStep | null;
|
|
52
|
+
/** Сколько шагов уже passed/skipped. */
|
|
53
|
+
doneSteps: number;
|
|
54
|
+
totalSteps: number;
|
|
55
|
+
injections: RunPanelInjection[];
|
|
56
|
+
pendingInjections: number;
|
|
57
|
+
}
|
|
58
|
+
export interface RunPanelListResult {
|
|
59
|
+
success: boolean;
|
|
60
|
+
runs: RunPanelRun[];
|
|
61
|
+
/** Сколько активных запусков (pending/running/paused/failed) для бейджа. */
|
|
62
|
+
active: number;
|
|
63
|
+
error?: string;
|
|
64
|
+
}
|
|
65
|
+
export interface RunPanelActionResult {
|
|
66
|
+
success: boolean;
|
|
67
|
+
error?: string;
|
|
68
|
+
run?: RunPanelRun;
|
|
69
|
+
/** Шаг, который получит контекст паузы или продолжит работу. */
|
|
70
|
+
stepName?: string | null;
|
|
71
|
+
/** true, если resume только переоткрыл запуск и подготовил шаг. */
|
|
72
|
+
prepared?: boolean;
|
|
73
|
+
}
|
|
74
|
+
/** Неизвестный фильтр трактуем как `active` — безопасный дефолт панели. */
|
|
75
|
+
export declare function normalizeRunPanelFilter(value: unknown): RunPanelFilter;
|
|
76
|
+
/** Собирает компактное описание запуска. */
|
|
77
|
+
export declare function getRunPanelRun(runId: string): RunPanelRun | undefined;
|
|
78
|
+
/** Список запусков для панели и счётчик активных. */
|
|
79
|
+
export declare function listRunPanel(options?: {
|
|
80
|
+
filter?: unknown;
|
|
81
|
+
limit?: unknown;
|
|
82
|
+
}): RunPanelListResult;
|
|
83
|
+
/**
|
|
84
|
+
* Пауза с комментарием. Ошибки (running-шаг, терминальный запуск, нет
|
|
85
|
+
* незавершённых шагов) возвращаются как `{ success: false }`, чтобы GUI
|
|
86
|
+
* показал их рядом с кнопкой.
|
|
87
|
+
*/
|
|
88
|
+
export declare function pauseRunPanel(runId: string, input?: Omit<PauseRunInput, "file" | "artifact">): RunPanelActionResult;
|
|
89
|
+
/**
|
|
90
|
+
* Resume только готовит запуск: paused/failed → running, шаг остаётся
|
|
91
|
+
* незавершённым. Дальше его выполняет `resumeRun`/внешний исполнитель DAG.
|
|
92
|
+
*/
|
|
93
|
+
export declare function resumeRunPanel(runId: string): RunPanelActionResult;
|
|
94
|
+
//# sourceMappingURL=run-panel-api.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"run-panel-api.d.ts","sourceRoot":"","sources":["../../src/core/run-panel-api.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,OAAO,EAML,KAAK,SAAS,EAEf,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAIL,KAAK,aAAa,EACnB,MAAM,sBAAsB,CAAC;AAG9B,iEAAiE;AACjE,MAAM,MAAM,cAAc,GAAG,SAAS,GAAG,KAAK,GAAG,QAAQ,CAAC;AAE1D,uDAAuD;AACvD,MAAM,WAAW,iBAAiB;IAChC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,yEAAyE;IACzE,OAAO,EAAE,MAAM,CAAC;IAChB,aAAa,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;CAC/B;AAED,8BAA8B;AAC9B,MAAM,WAAW,YAAY;IAC3B,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,sCAAsC;IACtC,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,uCAAuC;AACvC,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,SAAS,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,KAAK,EAAE,YAAY,EAAE,CAAC;IACtB,gEAAgE;IAChE,WAAW,EAAE,YAAY,GAAG,IAAI,CAAC;IACjC,wCAAwC;IACxC,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,iBAAiB,EAAE,CAAC;IAChC,iBAAiB,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,EAAE,WAAW,EAAE,CAAC;IACpB,4EAA4E;IAC5E,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,oBAAoB;IACnC,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,GAAG,CAAC,EAAE,WAAW,CAAC;IAClB,gEAAgE;IAChE,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,mEAAmE;IACnE,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAWD,2EAA2E;AAC3E,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,OAAO,GAAG,cAAc,CAatE;AA2CD,4CAA4C;AAC5C,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS,CAIrE;AAyBD,qDAAqD;AACrD,wBAAgB,YAAY,CAC1B,OAAO,GAAE;IAAE,MAAM,CAAC,EAAE,OAAO,CAAC;IAAC,KAAK,CAAC,EAAE,OAAO,CAAA;CAAO,GAClD,kBAAkB,CAoBpB;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAC3B,KAAK,EAAE,MAAM,EACb,KAAK,GAAE,IAAI,CAAC,aAAa,EAAE,MAAM,GAAG,UAAU,CAAM,GACnD,oBAAoB,CAWtB;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,oBAAoB,CAqBlE"}
|