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,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)) {
|
|
@@ -29,10 +29,10 @@ export interface ParsedCron {
|
|
|
29
29
|
/** День недели 0(Вс)..6(Сб) или null, если поле = «*» и не содержит «#». */
|
|
30
30
|
dayOfWeek: Set<number> | null;
|
|
31
31
|
/** Пары {weekday, n} для «#». */
|
|
32
|
-
nthWeekday:
|
|
32
|
+
nthWeekday: {
|
|
33
33
|
weekday: number;
|
|
34
34
|
n: number;
|
|
35
|
-
}
|
|
35
|
+
}[];
|
|
36
36
|
}
|
|
37
37
|
/** Разворачивает «@every 15m|2h|1d» в обычный cron. */
|
|
38
38
|
export declare function normalizeCron(expr: string): string;
|
|
@@ -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 и обращения к ОС.
|
|
@@ -129,10 +131,10 @@ function expandField(token, min, max, names) {
|
|
|
129
131
|
let item = raw.trim().toUpperCase();
|
|
130
132
|
if (!item)
|
|
131
133
|
throw new Error(t("schedule.error.cronEmptyItem", { token }));
|
|
132
|
-
if (names
|
|
134
|
+
if (names?.[item] !== undefined)
|
|
133
135
|
item = String(names[item]);
|
|
134
136
|
// шаг: a-b/n или */n
|
|
135
|
-
const stepMatch =
|
|
137
|
+
const stepMatch = /^(.*)\/([0-9]+)$/.exec(item);
|
|
136
138
|
let step = 1;
|
|
137
139
|
if (stepMatch) {
|
|
138
140
|
item = (stepMatch[1] ?? "").trim();
|
|
@@ -151,13 +153,13 @@ function expandField(token, min, max, names) {
|
|
|
151
153
|
result.add(v);
|
|
152
154
|
continue;
|
|
153
155
|
}
|
|
154
|
-
const rangeMatch =
|
|
156
|
+
const rangeMatch = /^([0-9A-Z]+)-([0-9A-Z]+)$/.exec(item);
|
|
155
157
|
if (rangeMatch) {
|
|
156
158
|
let aToken = rangeMatch[1];
|
|
157
159
|
let bToken = rangeMatch[2];
|
|
158
|
-
if (names
|
|
160
|
+
if (names?.[aToken] !== undefined)
|
|
159
161
|
aToken = String(names[aToken]);
|
|
160
|
-
if (names
|
|
162
|
+
if (names?.[bToken] !== undefined)
|
|
161
163
|
bToken = String(names[bToken]);
|
|
162
164
|
const a = Number(aToken);
|
|
163
165
|
const b = Number(bToken);
|
|
@@ -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 }));
|
|
@@ -182,7 +193,7 @@ function expandField(token, min, max, names) {
|
|
|
182
193
|
/** Разворачивает «@every 15m|2h|1d» в обычный cron. */
|
|
183
194
|
export function normalizeCron(expr) {
|
|
184
195
|
const trimmed = expr.trim();
|
|
185
|
-
const match =
|
|
196
|
+
const match = /^@every\s+(\d+)([mhd])$/i.exec(trimmed);
|
|
186
197
|
if (!match)
|
|
187
198
|
return trimmed;
|
|
188
199
|
const n = Number(match[1]);
|
|
@@ -230,7 +241,7 @@ export function parseCron(expr) {
|
|
|
230
241
|
const tokens = dowF.trim().toUpperCase().split(",").map((s) => s.trim());
|
|
231
242
|
const kept = [];
|
|
232
243
|
for (const token of tokens) {
|
|
233
|
-
const hash =
|
|
244
|
+
const hash = /^([0-9A-Z]+)#([1-5])$/.exec(token);
|
|
234
245
|
if (hash) {
|
|
235
246
|
let dToken = hash[1];
|
|
236
247
|
if (DOW_NAMES[dToken] !== undefined)
|
|
@@ -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 + системный таймзона + окно не задано).
|
|
@@ -0,0 +1,95 @@
|
|
|
1
|
+
import type { RegistryEntry } from "./registry.js";
|
|
2
|
+
/**
|
|
3
|
+
* Fallback для one-shot задач, когда утилита `at` не установлена.
|
|
4
|
+
*
|
|
5
|
+
* Запускает отвязанный (detached) `/bin/bash`, который спит до `runAt` и
|
|
6
|
+
* затем выполняет команду задачи. Это не полноценная замена `atd`:
|
|
7
|
+
* - процесс не переживает перезагрузку машины;
|
|
8
|
+
* - не переживает ручной kill;
|
|
9
|
+
* - не виден в `atq`.
|
|
10
|
+
* Поэтому fallback используется только как последнее средство и пишет
|
|
11
|
+
* предупреждение в лог. Если `at` доступен — вызывается он.
|
|
12
|
+
*/
|
|
13
|
+
export interface DetachedOneShotSpawn {
|
|
14
|
+
once(event: "error", listener: (err: Error) => void): unknown;
|
|
15
|
+
once(event: "spawn", listener: () => void): unknown;
|
|
16
|
+
unref(): unknown;
|
|
17
|
+
pid?: number;
|
|
18
|
+
}
|
|
19
|
+
export type DetachedOneShotSpawnFn = (file: string, args: string[], options: {
|
|
20
|
+
detached: boolean;
|
|
21
|
+
stdio: "ignore";
|
|
22
|
+
}) => DetachedOneShotSpawn;
|
|
23
|
+
export interface ScheduleAtFallbackDeps {
|
|
24
|
+
spawnFn?: DetachedOneShotSpawnFn;
|
|
25
|
+
now?: () => number;
|
|
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
|
+
}
|
|
49
|
+
/** Ошибка `spawn("at")`, означающая, что бинарник не найден. */
|
|
50
|
+
export declare function isAtMissingError(err: unknown): boolean;
|
|
51
|
+
/** Сколько секунд осталось до `runAt` (0, если момент уже прошёл). */
|
|
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;
|
|
61
|
+
/** Скрипт для `/bin/bash -c`: подождать и выполнить команду задачи. */
|
|
62
|
+
export declare function buildDetachedOneShotScript(entry: RegistryEntry, command: string, nowMs: number): string;
|
|
63
|
+
/** Является ли сохранённый id задания pid-ом fallback-процесса. */
|
|
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;
|
|
74
|
+
/**
|
|
75
|
+
* Запускает отвязанный one-shot и возвращает `pid:<pid>` для `cancelAt`.
|
|
76
|
+
* Промис резолвится сразу после успешного `spawn`, не дожидаясь выполнения.
|
|
77
|
+
*/
|
|
78
|
+
export declare function scheduleAtFallback(entry: RegistryEntry, command: string, deps?: ScheduleAtFallbackDeps): Promise<string>;
|
|
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>;
|
|
95
|
+
//# sourceMappingURL=at-fallback.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"at-fallback.d.ts","sourceRoot":"","sources":["../../../src/core/scheduler/at-fallback.ts"],"names":[],"mappings":"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"}
|