agent-steward 0.0.3 → 0.0.5
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 +154 -2
- package/CROSS_PLATFORM.md +19 -0
- package/README.md +54 -9
- package/ROADMAP-STRATEGY.md +23 -20
- package/ROADMAP.md +140 -143
- package/dist/cli.d.ts +3 -0
- package/dist/cli.d.ts.map +1 -0
- package/dist/cli.js +351 -0
- 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/execution.d.ts +203 -0
- package/dist/core/execution.d.ts.map +1 -0
- package/dist/core/execution.js +309 -0
- package/dist/core/gate-integrity.d.ts +35 -0
- package/dist/core/gate-integrity.d.ts.map +1 -0
- package/dist/core/gate-integrity.js +132 -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/lock.d.ts +61 -4
- package/dist/core/lock.d.ts.map +1 -1
- package/dist/core/lock.js +213 -26
- package/dist/core/matrix.d.ts.map +1 -1
- package/dist/core/matrix.js +75 -15
- package/dist/core/mission.d.ts +83 -0
- package/dist/core/mission.d.ts.map +1 -0
- package/dist/core/mission.js +334 -0
- 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/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 +64 -0
- package/dist/core/pipeline-map.d.ts +46 -0
- package/dist/core/pipeline-map.d.ts.map +1 -0
- package/dist/core/pipeline-map.js +196 -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 +19 -2
- package/dist/core/ps-wrapper.d.ts.map +1 -1
- package/dist/core/ps-wrapper.js +261 -63
- 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 +183 -58
- 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 +91 -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 +18 -2
- package/dist/core/scheduler/linux.d.ts.map +1 -1
- package/dist/core/scheduler/linux.js +63 -20
- 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/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/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 +125 -28
- package/dist/core/session.d.ts.map +1 -1
- package/dist/core/session.js +18 -11
- package/dist/core/structured-log.d.ts +7 -1
- package/dist/core/structured-log.d.ts.map +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/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 +17 -0
- package/dist/core/wrappers/bash.d.ts.map +1 -1
- package/dist/core/wrappers/bash.js +224 -28
- package/dist/db/capability-repo.d.ts +124 -0
- package/dist/db/capability-repo.d.ts.map +1 -0
- package/dist/db/capability-repo.js +267 -0
- package/dist/db/history-repo.d.ts +46 -5
- package/dist/db/history-repo.d.ts.map +1 -1
- package/dist/db/history-repo.js +107 -25
- 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/metrics-repo.js +2 -2
- package/dist/db/migrate.d.ts.map +1 -1
- package/dist/db/migrate.js +3 -1
- package/dist/db/recovery.d.ts.map +1 -1
- package/dist/db/recovery.js +5 -4
- 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 +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 +10 -2
- package/dist/db/run-resume.d.ts.map +1 -1
- package/dist/db/run-resume.js +39 -13
- package/dist/db/runs-repo.d.ts +32 -7
- package/dist/db/runs-repo.d.ts.map +1 -1
- package/dist/db/runs-repo.js +50 -11
- package/dist/db/schema.d.ts +2 -2
- package/dist/db/schema.d.ts.map +1 -1
- package/dist/db/schema.js +216 -3
- 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/history.d.ts +1 -1
- package/dist/history.d.ts.map +1 -1
- 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 +140 -6
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +480 -18
- package/dist/notifications.d.ts +22 -0
- package/dist/notifications.d.ts.map +1 -1
- package/dist/notifications.js +36 -8
- package/dist/profiles.d.ts.map +1 -1
- package/dist/profiles.js +25 -4
- package/dist/rpc.d.ts +924 -0
- package/dist/rpc.d.ts.map +1 -1
- package/dist/rpc.js +352 -0
- package/dist/server.d.ts +46 -0
- package/dist/server.d.ts.map +1 -1
- package/dist/server.js +172 -53
- package/dist/settings.d.ts +2 -2
- package/dist/settings.d.ts.map +1 -1
- package/dist/settings.js +3 -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 +16 -0
- package/dist/task-transfer.d.ts.map +1 -1
- package/dist/task-transfer.js +16 -0
- 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 +498 -58
- package/docs/COMPATIBILITY.md +2 -2
- package/docs/CONCEPT.md +185 -91
- package/docs/CROSS_PLATFORM.ru.md +20 -0
- package/docs/CROSS_PLATFORM.zh.md +18 -0
- package/docs/EXECUTION-LOOP.md +211 -0
- package/docs/FEATURES.md +65 -4
- package/docs/FEATURES.zh.md +52 -4
- package/docs/MIGRATION.md +2 -2
- package/docs/PIPELINE.md +293 -0
- package/docs/README.ru.md +44 -5
- package/docs/README.zh.md +46 -6
- package/docs/SAFETY.md +142 -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 +9 -8
- package/locales/en.json +84 -1
- package/locales/ru.json +84 -1
- package/locales/zh.json +84 -1
- package/opencode.pipeline.yaml +35 -0
- package/package.json +46 -2
- package/scripts/audit-bundle.mjs +215 -0
- package/scripts/test-home.mjs +83 -0
- package/src/cli.ts +412 -0
- package/src/core/dlq-api.ts +98 -0
- package/src/core/dry-run.ts +27 -3
- package/src/core/execution.ts +538 -0
- package/src/core/file-watcher.ts +2 -2
- package/src/core/gate-integrity.ts +160 -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/lock.ts +244 -30
- package/src/core/matrix.ts +95 -50
- package/src/core/mission.ts +485 -0
- package/src/core/native-notify.ts +1 -1
- 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/pipeline-apply.ts +158 -0
- package/src/core/pipeline-io.ts +79 -0
- package/src/core/pipeline-map.ts +264 -0
- package/src/core/pipeline-spec.ts +775 -0
- package/src/core/ps-wrapper.ts +274 -64
- package/src/core/record-history.ts +229 -104
- 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 +115 -0
- package/src/core/run-panel-api.ts +262 -0
- package/src/core/schedule-gate.ts +7 -3
- package/src/core/schedule-v2.ts +114 -5
- package/src/core/scheduler/at-fallback.ts +190 -5
- package/src/core/scheduler/linux.ts +72 -21
- package/src/core/scheduler/logs.ts +2 -2
- package/src/core/scheduler/mac.ts +174 -14
- 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/scheduler/windows.ts +19 -15
- package/src/core/secrets.ts +131 -31
- package/src/core/session.ts +23 -10
- package/src/core/structured-log.ts +22 -5
- package/src/core/task-name.ts +67 -0
- 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/worktree-run.ts +199 -0
- package/src/core/worktree.ts +600 -0
- package/src/core/wrappers/bash.ts +239 -27
- package/src/db/capability-repo.ts +402 -0
- package/src/db/history-repo.ts +151 -22
- package/src/db/index.ts +37 -1
- package/src/db/metrics-repo.ts +2 -2
- package/src/db/migrate.ts +3 -1
- package/src/db/recovery.ts +5 -4
- package/src/db/run-context.ts +370 -0
- package/src/db/run-dlq.ts +310 -0
- package/src/db/run-journal.ts +100 -13
- package/src/db/run-resume.ts +65 -13
- package/src/db/runs-repo.ts +66 -13
- package/src/db/schema.ts +218 -3
- package/src/db/settings-repo.ts +31 -0
- package/src/db/step-idempotency.ts +185 -0
- package/src/gui.tsx +692 -13
- package/src/history.ts +1 -1
- package/src/i18n.ts +12 -4
- package/src/index.ts +648 -8
- package/src/notifications.ts +38 -8
- package/src/profiles.ts +26 -4
- package/src/rpc.ts +379 -0
- package/src/server.ts +206 -54
- package/src/settings.ts +5 -5
- package/src/shared/jobs-view.ts +3 -1
- package/src/task-transfer.ts +31 -0
- package/src/types.ts +9 -0
- package/src/workspaces.ts +58 -9
|
@@ -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,EA2CvD,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,91 @@
|
|
|
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: "mission",
|
|
42
|
+
transport: "direct",
|
|
43
|
+
executor: "local",
|
|
44
|
+
description: "Ad-hoc миссия исполняется локально через обёртку без регистрации в ОС.",
|
|
45
|
+
},
|
|
46
|
+
{
|
|
47
|
+
taskType: "apply_diff",
|
|
48
|
+
transport: "direct",
|
|
49
|
+
executor: "local",
|
|
50
|
+
description: "Патч применяется локально, без внешних вызовов.",
|
|
51
|
+
},
|
|
52
|
+
{
|
|
53
|
+
taskType: "github_create_pr",
|
|
54
|
+
transport: "mcp",
|
|
55
|
+
executor: "local",
|
|
56
|
+
description: "Внешняя система GitHub — транспорт MCP, исполнитель локальный.",
|
|
57
|
+
},
|
|
58
|
+
{
|
|
59
|
+
taskType: "jira_update_task",
|
|
60
|
+
transport: "mcp",
|
|
61
|
+
executor: "cloud",
|
|
62
|
+
description: "Jira доступна только через MCP и облачный исполнитель.",
|
|
63
|
+
},
|
|
64
|
+
]);
|
|
65
|
+
const ROUTE_TABLE = new Map(STATIC_ROUTE_RULES.map((rule) => [rule.taskType, rule]));
|
|
66
|
+
/**
|
|
67
|
+
* Нормализует тип задачи: `Run Tests`, `run-tests`, ` RUN_TESTS ` → `run_tests`.
|
|
68
|
+
* Нужна, потому что план миссии может прийти из модели в свободной форме.
|
|
69
|
+
*/
|
|
70
|
+
export function normalizeTaskType(value) {
|
|
71
|
+
return value
|
|
72
|
+
.trim()
|
|
73
|
+
.toLowerCase()
|
|
74
|
+
.replace(/[\s-]+/g, "_")
|
|
75
|
+
.replace(/_+/g, "_");
|
|
76
|
+
}
|
|
77
|
+
/** Возвращает правило слоя 1 для типа задачи или `undefined`, если тип неизвестен. */
|
|
78
|
+
export function routeStaticStep(taskType) {
|
|
79
|
+
if (typeof taskType !== "string" || taskType.trim() === "") {
|
|
80
|
+
return undefined;
|
|
81
|
+
}
|
|
82
|
+
return ROUTE_TABLE.get(normalizeTaskType(taskType));
|
|
83
|
+
}
|
|
84
|
+
/** Есть ли для типа задачи статическое правило (0 токенов, без БД). */
|
|
85
|
+
export function isStaticTaskType(taskType) {
|
|
86
|
+
return routeStaticStep(taskType) !== undefined;
|
|
87
|
+
}
|
|
88
|
+
/** Снимок таблицы слоя 1 — для отчётов, GUI и тестов. */
|
|
89
|
+
export function listStaticRouteRules() {
|
|
90
|
+
return STATIC_ROUTE_RULES;
|
|
91
|
+
}
|
|
@@ -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"}
|
|
@@ -0,0 +1,169 @@
|
|
|
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 { getRun, listRuns, listRunSteps, reopenRun, } from "../db/runs-repo.js";
|
|
15
|
+
import { listRunInjections, pauseRun, } from "../db/run-context.js";
|
|
16
|
+
import { findResumeStep } from "../db/run-resume.js";
|
|
17
|
+
const MAX_CONTENT_PREVIEW = 500;
|
|
18
|
+
const DEFAULT_LIMIT = 20;
|
|
19
|
+
const MAX_LIMIT = 100;
|
|
20
|
+
const ACTIVE_STATUSES = ["pending", "running", "paused", "failed"];
|
|
21
|
+
function errorText(err) {
|
|
22
|
+
return err instanceof Error ? err.message : String(err);
|
|
23
|
+
}
|
|
24
|
+
/** Неизвестный фильтр трактуем как `active` — безопасный дефолт панели. */
|
|
25
|
+
export function normalizeRunPanelFilter(value) {
|
|
26
|
+
if (value === "all" || value === "active")
|
|
27
|
+
return value;
|
|
28
|
+
if (value === "pending" ||
|
|
29
|
+
value === "running" ||
|
|
30
|
+
value === "paused" ||
|
|
31
|
+
value === "passed" ||
|
|
32
|
+
value === "failed" ||
|
|
33
|
+
value === "cancelled") {
|
|
34
|
+
return value;
|
|
35
|
+
}
|
|
36
|
+
return "active";
|
|
37
|
+
}
|
|
38
|
+
function normalizeLimit(value, fallback = DEFAULT_LIMIT) {
|
|
39
|
+
const num = Math.floor(Number(value));
|
|
40
|
+
if (!Number.isFinite(num) || num < 1)
|
|
41
|
+
return fallback;
|
|
42
|
+
return Math.min(num, MAX_LIMIT);
|
|
43
|
+
}
|
|
44
|
+
function stepAnchor(runId, stepName) {
|
|
45
|
+
return `run-step-${runId}-${stepName.replace(/[^A-Za-z0-9_-]/g, "_")}`;
|
|
46
|
+
}
|
|
47
|
+
function toPanelStep(runId, step) {
|
|
48
|
+
return {
|
|
49
|
+
stepName: step.stepName,
|
|
50
|
+
position: step.position,
|
|
51
|
+
status: step.status,
|
|
52
|
+
attempt: step.attempt,
|
|
53
|
+
error: step.error,
|
|
54
|
+
anchor: stepAnchor(runId, step.stepName),
|
|
55
|
+
};
|
|
56
|
+
}
|
|
57
|
+
function toPanelInjection(injection) {
|
|
58
|
+
return {
|
|
59
|
+
id: injection.id,
|
|
60
|
+
kind: injection.kind,
|
|
61
|
+
content: injection.content.length > MAX_CONTENT_PREVIEW
|
|
62
|
+
? `${injection.content.slice(0, MAX_CONTENT_PREVIEW)}…`
|
|
63
|
+
: injection.content,
|
|
64
|
+
contentLength: injection.content.length,
|
|
65
|
+
author: injection.author,
|
|
66
|
+
createdAt: injection.createdAt,
|
|
67
|
+
consumedAt: injection.consumedAt,
|
|
68
|
+
consumedByStep: injection.consumedByStep,
|
|
69
|
+
};
|
|
70
|
+
}
|
|
71
|
+
function isDone(step) {
|
|
72
|
+
return step.status === "passed" || step.status === "skipped";
|
|
73
|
+
}
|
|
74
|
+
/** Собирает компактное описание запуска. */
|
|
75
|
+
export function getRunPanelRun(runId) {
|
|
76
|
+
const run = getRun(runId);
|
|
77
|
+
if (!run)
|
|
78
|
+
return undefined;
|
|
79
|
+
return toPanelRun(run);
|
|
80
|
+
}
|
|
81
|
+
function toPanelRun(run) {
|
|
82
|
+
const steps = listRunSteps(run.id);
|
|
83
|
+
const panelSteps = steps.map((step) => toPanelStep(run.id, step));
|
|
84
|
+
const current = steps.find((step) => !isDone(step));
|
|
85
|
+
const allInjections = listRunInjections(run.id);
|
|
86
|
+
const injections = allInjections.slice(-20).map(toPanelInjection);
|
|
87
|
+
return {
|
|
88
|
+
id: run.id,
|
|
89
|
+
taskName: run.taskName,
|
|
90
|
+
status: run.status,
|
|
91
|
+
createdAt: run.createdAt,
|
|
92
|
+
startedAt: run.startedAt,
|
|
93
|
+
finishedAt: run.finishedAt,
|
|
94
|
+
error: run.error,
|
|
95
|
+
steps: panelSteps,
|
|
96
|
+
currentStep: current ? toPanelStep(run.id, current) : null,
|
|
97
|
+
doneSteps: steps.filter(isDone).length,
|
|
98
|
+
totalSteps: steps.length,
|
|
99
|
+
injections,
|
|
100
|
+
pendingInjections: allInjections.filter((item) => item.consumedAt === null).length,
|
|
101
|
+
};
|
|
102
|
+
}
|
|
103
|
+
/** Список запусков для панели и счётчик активных. */
|
|
104
|
+
export function listRunPanel(options = {}) {
|
|
105
|
+
try {
|
|
106
|
+
const filter = normalizeRunPanelFilter(options.filter);
|
|
107
|
+
const limit = normalizeLimit(options.limit);
|
|
108
|
+
const all = listRuns(undefined, MAX_LIMIT);
|
|
109
|
+
const matching = all.filter((run) => filter === "all"
|
|
110
|
+
? true
|
|
111
|
+
: filter === "active"
|
|
112
|
+
? ACTIVE_STATUSES.includes(run.status)
|
|
113
|
+
: run.status === filter);
|
|
114
|
+
return {
|
|
115
|
+
success: true,
|
|
116
|
+
runs: matching.slice(0, limit).map(toPanelRun),
|
|
117
|
+
active: all.filter((run) => ACTIVE_STATUSES.includes(run.status)).length,
|
|
118
|
+
};
|
|
119
|
+
}
|
|
120
|
+
catch (err) {
|
|
121
|
+
return { success: false, runs: [], active: 0, error: errorText(err) };
|
|
122
|
+
}
|
|
123
|
+
}
|
|
124
|
+
/**
|
|
125
|
+
* Пауза с комментарием. Ошибки (running-шаг, терминальный запуск, нет
|
|
126
|
+
* незавершённых шагов) возвращаются как `{ success: false }`, чтобы GUI
|
|
127
|
+
* показал их рядом с кнопкой.
|
|
128
|
+
*/
|
|
129
|
+
export function pauseRunPanel(runId, input = {}) {
|
|
130
|
+
try {
|
|
131
|
+
const result = pauseRun(runId, input);
|
|
132
|
+
return {
|
|
133
|
+
success: true,
|
|
134
|
+
run: toPanelRun(result.run),
|
|
135
|
+
stepName: result.stepName,
|
|
136
|
+
};
|
|
137
|
+
}
|
|
138
|
+
catch (err) {
|
|
139
|
+
return { success: false, error: errorText(err) };
|
|
140
|
+
}
|
|
141
|
+
}
|
|
142
|
+
/**
|
|
143
|
+
* Resume только готовит запуск: paused/failed → running, шаг остаётся
|
|
144
|
+
* незавершённым. Дальше его выполняет `resumeRun`/внешний исполнитель DAG.
|
|
145
|
+
*/
|
|
146
|
+
export function resumeRunPanel(runId) {
|
|
147
|
+
try {
|
|
148
|
+
const run = getRun(runId);
|
|
149
|
+
if (!run)
|
|
150
|
+
return { success: false, error: `Запуск не найден: ${runId}` };
|
|
151
|
+
if (run.status !== "paused" && run.status !== "failed") {
|
|
152
|
+
return {
|
|
153
|
+
success: false,
|
|
154
|
+
error: `Запуск в статусе ${run.status} нельзя возобновить: ${runId}`,
|
|
155
|
+
};
|
|
156
|
+
}
|
|
157
|
+
reopenRun(runId);
|
|
158
|
+
const next = findResumeStep(runId);
|
|
159
|
+
return {
|
|
160
|
+
success: true,
|
|
161
|
+
run: toPanelRun(getRun(runId)),
|
|
162
|
+
stepName: next?.stepName ?? null,
|
|
163
|
+
prepared: true,
|
|
164
|
+
};
|
|
165
|
+
}
|
|
166
|
+
catch (err) {
|
|
167
|
+
return { success: false, error: errorText(err) };
|
|
168
|
+
}
|
|
169
|
+
}
|
|
@@ -143,7 +143,11 @@ async function main() {
|
|
|
143
143
|
spec = parseCron(cronExpr);
|
|
144
144
|
}
|
|
145
145
|
catch (err) {
|
|
146
|
-
|
|
146
|
+
// Fail-closed: при повреждённом cron проверка расписания невозможна.
|
|
147
|
+
// Если пропустить её (fail-open), задача с окном/днями будет
|
|
148
|
+
// запускаться на каждом минутном тике — включая дорогие LLM-агенты.
|
|
149
|
+
console.error(`[schedule-gate] ОШИБКА: невалидный cron «${cronExpr}»: ${err instanceof Error ? err.message : String(err)}. Запуск пропущен (fail-closed). Исправьте расписание задачи.`);
|
|
150
|
+
return 3;
|
|
147
151
|
}
|
|
148
152
|
}
|
|
149
153
|
if (spec && !cronMatches(spec, now, zone)) {
|
|
@@ -78,6 +78,26 @@ export declare function nextWindowOpenAt(now: Date, options: ActiveWindowOptions
|
|
|
78
78
|
export declare function activeWindowState(now: Date, options?: ActiveWindowOptions): ActiveWindowState;
|
|
79
79
|
/** Сколько мс до следующего разрешённого окна (0 — можно запускать). */
|
|
80
80
|
export declare function nextWindowOpenDelayMs(now: Date, options?: ActiveWindowOptions): number;
|
|
81
|
+
export interface CronWindowFeasibility {
|
|
82
|
+
/** Будет ли хотя бы один запуск пропущен не из-за окна. */
|
|
83
|
+
feasible: boolean;
|
|
84
|
+
/** Сколько вхождений cron проверено. */
|
|
85
|
+
checked: number;
|
|
86
|
+
/** Ближайшее вхождение, которое окно/политика пропустят (ISO). */
|
|
87
|
+
firstRun?: string;
|
|
88
|
+
reason?: "never-fires" | "never-in-window" | "postpone-too-far";
|
|
89
|
+
}
|
|
90
|
+
/** Человекочитаемая причина недостижимости окна (P2-24). */
|
|
91
|
+
export declare function windowFeasibilityReasonText(reason: CronWindowFeasibility["reason"]): string;
|
|
92
|
+
/**
|
|
93
|
+
* P2-24: проверяет, не окажется ли cron навсегда отрезан окном запуска.
|
|
94
|
+
*
|
|
95
|
+
* `schedule-gate` откладывает запуск максимум на 12 ч. Если cron срабатывает
|
|
96
|
+
* только в 09:00, а окно 22:00–06:00, то до открытия всегда ~13 ч → каждый тик
|
|
97
|
+
* молча пропускается. Здесь это выявляется заранее (для предупреждения при
|
|
98
|
+
* создании задачи и в dry_run).
|
|
99
|
+
*/
|
|
100
|
+
export declare function assessCronWindowFeasibility(expr: string, options?: ActiveWindowOptions, policy?: "skip" | "postpone" | "run", from?: Date, maxPostponeMs?: number, maxOccurrences?: number): CronWindowFeasibility;
|
|
81
101
|
/**
|
|
82
102
|
* true, если выражение умеет оформить Windows Task Scheduler «родными»
|
|
83
103
|
* флагами (MINUTE/HOURLY/DAILY/WEEKLY) и парсится строгим конвертером.
|
|
@@ -86,6 +106,14 @@ export declare function nextWindowOpenDelayMs(now: Date, options?: ActiveWindowO
|
|
|
86
106
|
export declare function isNativeSchtasksExpr(expr: string): boolean;
|
|
87
107
|
/** Конвертер для родного режима; бросает Error для неподдерживаемых. */
|
|
88
108
|
export declare function convertForSchtasks(expr: string): CronConversion;
|
|
109
|
+
/**
|
|
110
|
+
* true, если выражение можно записать в crontab как есть (Vixie-совместимый
|
|
111
|
+
* 5-полевой cron). В отличие от schtasks, crontab понимает списки, диапазоны,
|
|
112
|
+
* шаги и имена месяцев/дней недели — их не нужно загонять в минутный опрос.
|
|
113
|
+
* Quartz-расширения `L` / `d#n` и макросы вроде `@daily` (не 5 полей) crontab
|
|
114
|
+
* не понимает: для них нужен poll-режим с gate во враппере.
|
|
115
|
+
*/
|
|
116
|
+
export declare function isNativePosixCronExpr(expr: string): boolean;
|
|
89
117
|
/** Аргументы schedule-gate, которые запекаются во враппер (cron/tz/окно/пернос). */
|
|
90
118
|
export interface ScheduleGateSpec {
|
|
91
119
|
/**
|
|
@@ -107,6 +135,12 @@ export interface ScheduleGateSpec {
|
|
|
107
135
|
* не конвертируемо в флаги schtasks) — нужен минутный опрос + gate.
|
|
108
136
|
*/
|
|
109
137
|
export declare function needsPollMode(expr: string, timezone?: string | null): boolean;
|
|
138
|
+
/**
|
|
139
|
+
* Аналог needsPollMode для POSIX-бэков (crontab): чужой IANA-таймзона или
|
|
140
|
+
* не-Vixie-синтаксис заставляет опрашивать каждую минуту, остальное crontab
|
|
141
|
+
* выполняет сам. Списки/диапазоны/шаги/имена здесь родные.
|
|
142
|
+
*/
|
|
143
|
+
export declare function needsPosixPollMode(expr: string, timezone?: string | null): boolean;
|
|
110
144
|
/**
|
|
111
145
|
* Аргументы schedule-gate для враппера, либо undefined — если врапперу гейт
|
|
112
146
|
* не нужен (нативный cron + системный таймзона + окно не задано).
|