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,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"}
|
|
@@ -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 + системный таймзона + окно не задано).
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"schedule-v2.d.ts","sourceRoot":"","sources":["../../src/core/schedule-v2.ts"],"names":[],"mappings":"
|
|
1
|
+
{"version":3,"file":"schedule-v2.d.ts","sourceRoot":"","sources":["../../src/core/schedule-v2.ts"],"names":[],"mappings":"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"}
|
package/dist/core/schedule-v2.js
CHANGED
|
@@ -2,11 +2,13 @@
|
|
|
2
2
|
* Расширенный cron и окна запуска (Спринт 19).
|
|
3
3
|
*
|
|
4
4
|
* Два режима регистрации в ОС:
|
|
5
|
-
* - «родной»
|
|
6
|
-
*
|
|
7
|
-
*
|
|
8
|
-
*
|
|
9
|
-
*
|
|
5
|
+
* - «родной» — системная таймзона и выражение, понятное адаптеру ОС:
|
|
6
|
+
* для Windows — подмножество флагов schtasks, для POSIX (crontab) —
|
|
7
|
+
* Vixie-совместимый cron (списки, диапазоны, шаги, имена месяцев/дней);
|
|
8
|
+
* - «опрос раз в минуту» (MINUTE /mo 1 или "* * * * *" + node-gate во
|
|
9
|
+
* враппере) — для чужой таймзоны, Quartz-расширений L/# и прочего, что
|
|
10
|
+
* адаптер ОС не понимает. Обёртка вызывает dist/core/schedule-gate.js,
|
|
11
|
+
* который сам решает, пора ли запускать.
|
|
10
12
|
*
|
|
11
13
|
* Здесь живёт только чистая математика: парсинг, совпадение, ближайший запуск.
|
|
12
14
|
* Никакого I/O и обращения к ОС.
|
|
@@ -171,6 +173,15 @@ function expandField(token, min, max, names) {
|
|
|
171
173
|
result.add(v);
|
|
172
174
|
continue;
|
|
173
175
|
}
|
|
176
|
+
if (stepMatch) {
|
|
177
|
+
// Шаг для одиночного значения Vixie-совместимый cron не поддерживает:
|
|
178
|
+
// раньше «5/15» молча превращалось в «только минута 5». Лучше явная
|
|
179
|
+
// ошибка, чем тихо другая семантика.
|
|
180
|
+
throw new Error(t("schedule.error.cronStepNeedsRange", {
|
|
181
|
+
raw,
|
|
182
|
+
step: stepMatch[2],
|
|
183
|
+
}));
|
|
184
|
+
}
|
|
174
185
|
const num = Number(item);
|
|
175
186
|
if (!Number.isInteger(num) || num < min || num > max) {
|
|
176
187
|
throw new Error(t("schedule.error.cronValueBounds", { raw, min, max }));
|
|
@@ -532,6 +543,54 @@ export function nextWindowOpenDelayMs(now, options = {}) {
|
|
|
532
543
|
return 0;
|
|
533
544
|
return state.nextOpenAt ? Math.max(0, state.nextOpenAt.getTime() - now.getTime()) : 0;
|
|
534
545
|
}
|
|
546
|
+
/** Человекочитаемая причина недостижимости окна (P2-24). */
|
|
547
|
+
export function windowFeasibilityReasonText(reason) {
|
|
548
|
+
switch (reason) {
|
|
549
|
+
case "never-fires":
|
|
550
|
+
return t("dryRun.window.reason.neverFires");
|
|
551
|
+
case "never-in-window":
|
|
552
|
+
return t("dryRun.window.reason.neverInWindow");
|
|
553
|
+
case "postpone-too-far":
|
|
554
|
+
return t("dryRun.window.reason.postponeTooFar");
|
|
555
|
+
default:
|
|
556
|
+
return "";
|
|
557
|
+
}
|
|
558
|
+
}
|
|
559
|
+
/**
|
|
560
|
+
* P2-24: проверяет, не окажется ли cron навсегда отрезан окном запуска.
|
|
561
|
+
*
|
|
562
|
+
* `schedule-gate` откладывает запуск максимум на 12 ч. Если cron срабатывает
|
|
563
|
+
* только в 09:00, а окно 22:00–06:00, то до открытия всегда ~13 ч → каждый тик
|
|
564
|
+
* молча пропускается. Здесь это выявляется заранее (для предупреждения при
|
|
565
|
+
* создании задачи и в dry_run).
|
|
566
|
+
*/
|
|
567
|
+
export function assessCronWindowFeasibility(expr, options = {}, policy = "postpone", from = new Date(), maxPostponeMs = 12 * 60 * 60 * 1000, maxOccurrences = 120) {
|
|
568
|
+
if (policy === "run")
|
|
569
|
+
return { feasible: true, checked: 0 };
|
|
570
|
+
let cursor = from;
|
|
571
|
+
for (let i = 0; i < maxOccurrences; i += 1) {
|
|
572
|
+
const at = nextRun(expr, cursor, options.timeZone);
|
|
573
|
+
if (!at) {
|
|
574
|
+
return { feasible: false, checked: i, reason: "never-fires" };
|
|
575
|
+
}
|
|
576
|
+
const state = activeWindowState(at, options);
|
|
577
|
+
if (state.active) {
|
|
578
|
+
return { feasible: true, checked: i + 1, firstRun: at.toISOString() };
|
|
579
|
+
}
|
|
580
|
+
if (policy === "postpone" && state.nextOpenAt) {
|
|
581
|
+
const waitMs = state.nextOpenAt.getTime() - at.getTime();
|
|
582
|
+
if (waitMs <= maxPostponeMs) {
|
|
583
|
+
return { feasible: true, checked: i + 1, firstRun: at.toISOString() };
|
|
584
|
+
}
|
|
585
|
+
}
|
|
586
|
+
cursor = at;
|
|
587
|
+
}
|
|
588
|
+
return {
|
|
589
|
+
feasible: false,
|
|
590
|
+
checked: maxOccurrences,
|
|
591
|
+
reason: policy === "skip" ? "never-in-window" : "postpone-too-far",
|
|
592
|
+
};
|
|
593
|
+
}
|
|
535
594
|
// ---------------------------------------------------------------------------
|
|
536
595
|
// Проверка совместимости с schtasks (родной режим).
|
|
537
596
|
/**
|
|
@@ -552,6 +611,22 @@ export function isNativeSchtasksExpr(expr) {
|
|
|
552
611
|
export function convertForSchtasks(expr) {
|
|
553
612
|
return convertCronToSchTasks(normalizeCron(expr));
|
|
554
613
|
}
|
|
614
|
+
/**
|
|
615
|
+
* true, если выражение можно записать в crontab как есть (Vixie-совместимый
|
|
616
|
+
* 5-полевой cron). В отличие от schtasks, crontab понимает списки, диапазоны,
|
|
617
|
+
* шаги и имена месяцев/дней недели — их не нужно загонять в минутный опрос.
|
|
618
|
+
* Quartz-расширения `L` / `d#n` и макросы вроде `@daily` (не 5 полей) crontab
|
|
619
|
+
* не понимает: для них нужен poll-режим с gate во враппере.
|
|
620
|
+
*/
|
|
621
|
+
export function isNativePosixCronExpr(expr) {
|
|
622
|
+
try {
|
|
623
|
+
const spec = parseCron(expr);
|
|
624
|
+
return !spec.lastDom && spec.nthWeekday.length === 0;
|
|
625
|
+
}
|
|
626
|
+
catch {
|
|
627
|
+
return false;
|
|
628
|
+
}
|
|
629
|
+
}
|
|
555
630
|
/**
|
|
556
631
|
* true, если ОС-триггер не выражает расписание (чужой IANA-таймзона или
|
|
557
632
|
* не конвертируемо в флаги schtasks) — нужен минутный опрос + gate.
|
|
@@ -562,6 +637,17 @@ export function needsPollMode(expr, timezone) {
|
|
|
562
637
|
return true;
|
|
563
638
|
return !isNativeSchtasksExpr(expr);
|
|
564
639
|
}
|
|
640
|
+
/**
|
|
641
|
+
* Аналог needsPollMode для POSIX-бэков (crontab): чужой IANA-таймзона или
|
|
642
|
+
* не-Vixie-синтаксис заставляет опрашивать каждую минуту, остальное crontab
|
|
643
|
+
* выполняет сам. Списки/диапазоны/шаги/имена здесь родные.
|
|
644
|
+
*/
|
|
645
|
+
export function needsPosixPollMode(expr, timezone) {
|
|
646
|
+
const tz = (timezone || "").trim();
|
|
647
|
+
if (tz && tz !== systemTimeZone())
|
|
648
|
+
return true;
|
|
649
|
+
return !isNativePosixCronExpr(expr);
|
|
650
|
+
}
|
|
565
651
|
/**
|
|
566
652
|
* Аргументы schedule-gate для враппера, либо undefined — если врапперу гейт
|
|
567
653
|
* не нужен (нативный cron + системный таймзона + окно не задано).
|
|
@@ -24,19 +24,72 @@ export interface ScheduleAtFallbackDeps {
|
|
|
24
24
|
spawnFn?: DetachedOneShotSpawnFn;
|
|
25
25
|
now?: () => number;
|
|
26
26
|
}
|
|
27
|
+
export interface CancelAtFallbackDeps {
|
|
28
|
+
isAlive?: (pid: number, taskName: string) => boolean;
|
|
29
|
+
kill?: (pid: number, signal: NodeJS.Signals) => void;
|
|
30
|
+
}
|
|
31
|
+
export interface PruneAtFallbackDeps {
|
|
32
|
+
now?: () => number;
|
|
33
|
+
isAlive?: (pid: number, taskName: string) => boolean;
|
|
34
|
+
schedule?: (entry: RegistryEntry, command: string, nowMs: number) => Promise<string>;
|
|
35
|
+
warn?: (message: string) => void;
|
|
36
|
+
}
|
|
37
|
+
export interface PruneAtFallbackReport {
|
|
38
|
+
kept: number;
|
|
39
|
+
removed: number;
|
|
40
|
+
rescheduled: number;
|
|
41
|
+
missed: number;
|
|
42
|
+
skipped: boolean;
|
|
43
|
+
}
|
|
44
|
+
/** Минимальный интерфейс реестра — чтобы prune можно было тестировать без FS. */
|
|
45
|
+
export interface FallbackRegistry {
|
|
46
|
+
load(): Promise<RegistryEntry[]>;
|
|
47
|
+
save(entries: RegistryEntry[]): Promise<void>;
|
|
48
|
+
}
|
|
27
49
|
/** Ошибка `spawn("at")`, означающая, что бинарник не найден. */
|
|
28
50
|
export declare function isAtMissingError(err: unknown): boolean;
|
|
29
51
|
/** Сколько секунд осталось до `runAt` (0, если момент уже прошёл). */
|
|
30
52
|
export declare function computeDelaySeconds(runAt: string, nowMs: number): number;
|
|
53
|
+
/**
|
|
54
|
+
* Маркер fallback-процесса конкретной задачи.
|
|
55
|
+
*
|
|
56
|
+
* Лежит в командной строке (`/proc/<pid>/cmdline`), поэтому позволяет
|
|
57
|
+
* проверить, что pid всё ещё принадлежит нашей задаче, а не переиспользован
|
|
58
|
+
* другим процессом после перезагрузки/завершения.
|
|
59
|
+
*/
|
|
60
|
+
export declare function fallbackMarker(taskName: string): string;
|
|
31
61
|
/** Скрипт для `/bin/bash -c`: подождать и выполнить команду задачи. */
|
|
32
62
|
export declare function buildDetachedOneShotScript(entry: RegistryEntry, command: string, nowMs: number): string;
|
|
33
63
|
/** Является ли сохранённый id задания pid-ом fallback-процесса. */
|
|
34
64
|
export declare function isPidJobId(jobId: string | undefined): boolean;
|
|
65
|
+
/** Читает командную строку процесса из /proc; null, если процесс недоступен. */
|
|
66
|
+
export declare function readProcessCmdline(pid: number): string | null;
|
|
67
|
+
/**
|
|
68
|
+
* Живой ли это fallback-процесс именно этой задачи.
|
|
69
|
+
*
|
|
70
|
+
* Без проверки маркера `pid:` из персистентного реестра после перезагрузки
|
|
71
|
+
* может указывать на совершенно другой процесс.
|
|
72
|
+
*/
|
|
73
|
+
export declare function isFallbackProcessAlive(pid: number, taskName: string): boolean;
|
|
35
74
|
/**
|
|
36
75
|
* Запускает отвязанный one-shot и возвращает `pid:<pid>` для `cancelAt`.
|
|
37
76
|
* Промис резолвится сразу после успешного `spawn`, не дожидаясь выполнения.
|
|
38
77
|
*/
|
|
39
78
|
export declare function scheduleAtFallback(entry: RegistryEntry, command: string, deps?: ScheduleAtFallbackDeps): Promise<string>;
|
|
40
|
-
/**
|
|
41
|
-
|
|
79
|
+
/**
|
|
80
|
+
* Снимает fallback-процесс.
|
|
81
|
+
*
|
|
82
|
+
* Требует имя задачи и сверяет маркер в `/proc/<pid>/cmdline`: голый pid из
|
|
83
|
+
* реестра после перезагрузки может принадлежать чужому процессу. Убивает
|
|
84
|
+
* группу процессов (fallback запущен detached и является её лидером).
|
|
85
|
+
*/
|
|
86
|
+
export declare function cancelAtFallback(jobId: string, taskName?: string, deps?: CancelAtFallbackDeps): boolean;
|
|
87
|
+
/**
|
|
88
|
+
* Чистит `pid:`-записи, пережившие перезагрузку.
|
|
89
|
+
*
|
|
90
|
+
* Вызывается один раз при старте плагина. Живые процессы с совпадающим
|
|
91
|
+
* маркером сохраняются; мёртвые — удаляются. Будущие one-shot пересоздаются,
|
|
92
|
+
* прошедшие — помечаются пропущенными с предупреждением.
|
|
93
|
+
*/
|
|
94
|
+
export declare function pruneStaleFallbackEntries(registry: FallbackRegistry, deps?: PruneAtFallbackDeps): Promise<PruneAtFallbackReport>;
|
|
42
95
|
//# sourceMappingURL=at-fallback.d.ts.map
|