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
|
@@ -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
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"at-fallback.d.ts","sourceRoot":"","sources":["../../../src/core/scheduler/at-fallback.ts"],"names":[],"mappings":"
|
|
1
|
+
{"version":3,"file":"at-fallback.d.ts","sourceRoot":"","sources":["../../../src/core/scheduler/at-fallback.ts"],"names":[],"mappings":"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"}
|
|
@@ -1,5 +1,8 @@
|
|
|
1
1
|
import { spawn } from "node:child_process";
|
|
2
|
+
import fs from "node:fs";
|
|
3
|
+
import { shellQuote } from "./posix.js";
|
|
2
4
|
const PID_JOB_PREFIX = "pid:";
|
|
5
|
+
const FALLBACK_MARKER_PREFIX = "opencode-scheduler-at-fallback:";
|
|
3
6
|
/** Ошибка `spawn("at")`, означающая, что бинарник не найден. */
|
|
4
7
|
export function isAtMissingError(err) {
|
|
5
8
|
if (!err || typeof err !== "object")
|
|
@@ -18,13 +21,24 @@ export function computeDelaySeconds(runAt, nowMs) {
|
|
|
18
21
|
}
|
|
19
22
|
return Math.max(0, Math.ceil((target - nowMs) / 1000));
|
|
20
23
|
}
|
|
24
|
+
/**
|
|
25
|
+
* Маркер fallback-процесса конкретной задачи.
|
|
26
|
+
*
|
|
27
|
+
* Лежит в командной строке (`/proc/<pid>/cmdline`), поэтому позволяет
|
|
28
|
+
* проверить, что pid всё ещё принадлежит нашей задаче, а не переиспользован
|
|
29
|
+
* другим процессом после перезагрузки/завершения.
|
|
30
|
+
*/
|
|
31
|
+
export function fallbackMarker(taskName) {
|
|
32
|
+
return `${FALLBACK_MARKER_PREFIX}${Buffer.from(taskName, "utf8").toString("base64url")}`;
|
|
33
|
+
}
|
|
21
34
|
/** Скрипт для `/bin/bash -c`: подождать и выполнить команду задачи. */
|
|
22
35
|
export function buildDetachedOneShotScript(entry, command, nowMs) {
|
|
23
36
|
if (!entry.runAt) {
|
|
24
37
|
throw new Error(`Задача "${entry.name}": не задано runAt для one-shot.`);
|
|
25
38
|
}
|
|
26
39
|
const delay = computeDelaySeconds(entry.runAt, nowMs);
|
|
27
|
-
|
|
40
|
+
// Маркер — обычный shell-комментарий в конце, поэтому на выполнение не влияет.
|
|
41
|
+
return `sleep ${delay}; ${command} # ${fallbackMarker(entry.name)}`;
|
|
28
42
|
}
|
|
29
43
|
/** Является ли сохранённый id задания pid-ом fallback-процесса. */
|
|
30
44
|
export function isPidJobId(jobId) {
|
|
@@ -33,6 +47,39 @@ export function isPidJobId(jobId) {
|
|
|
33
47
|
function pidFromJobId(jobId) {
|
|
34
48
|
return Number.parseInt(jobId.slice(PID_JOB_PREFIX.length), 10);
|
|
35
49
|
}
|
|
50
|
+
/** Читает командную строку процесса из /proc; null, если процесс недоступен. */
|
|
51
|
+
export function readProcessCmdline(pid) {
|
|
52
|
+
if (!Number.isFinite(pid) || pid <= 0)
|
|
53
|
+
return null;
|
|
54
|
+
try {
|
|
55
|
+
return fs
|
|
56
|
+
.readFileSync(`/proc/${pid}/cmdline`, "utf8")
|
|
57
|
+
.split("\0")
|
|
58
|
+
.join(" ")
|
|
59
|
+
.trim();
|
|
60
|
+
}
|
|
61
|
+
catch {
|
|
62
|
+
return null;
|
|
63
|
+
}
|
|
64
|
+
}
|
|
65
|
+
/**
|
|
66
|
+
* Живой ли это fallback-процесс именно этой задачи.
|
|
67
|
+
*
|
|
68
|
+
* Без проверки маркера `pid:` из персистентного реестра после перезагрузки
|
|
69
|
+
* может указывать на совершенно другой процесс.
|
|
70
|
+
*/
|
|
71
|
+
export function isFallbackProcessAlive(pid, taskName) {
|
|
72
|
+
const cmdline = readProcessCmdline(pid);
|
|
73
|
+
return cmdline !== null && cmdline.includes(fallbackMarker(taskName));
|
|
74
|
+
}
|
|
75
|
+
function hasProcfs() {
|
|
76
|
+
try {
|
|
77
|
+
return fs.existsSync("/proc/self/cmdline");
|
|
78
|
+
}
|
|
79
|
+
catch {
|
|
80
|
+
return false;
|
|
81
|
+
}
|
|
82
|
+
}
|
|
36
83
|
/**
|
|
37
84
|
* Запускает отвязанный one-shot и возвращает `pid:<pid>` для `cancelAt`.
|
|
38
85
|
* Промис резолвится сразу после успешного `spawn`, не дожидаясь выполнения.
|
|
@@ -53,18 +100,101 @@ export async function scheduleAtFallback(entry, command, deps = {}) {
|
|
|
53
100
|
});
|
|
54
101
|
});
|
|
55
102
|
}
|
|
56
|
-
/**
|
|
57
|
-
|
|
103
|
+
/**
|
|
104
|
+
* Снимает fallback-процесс.
|
|
105
|
+
*
|
|
106
|
+
* Требует имя задачи и сверяет маркер в `/proc/<pid>/cmdline`: голый pid из
|
|
107
|
+
* реестра после перезагрузки может принадлежать чужому процессу. Убивает
|
|
108
|
+
* группу процессов (fallback запущен detached и является её лидером).
|
|
109
|
+
*/
|
|
110
|
+
export function cancelAtFallback(jobId, taskName, deps = {}) {
|
|
58
111
|
if (!isPidJobId(jobId))
|
|
59
112
|
return false;
|
|
60
113
|
const pid = pidFromJobId(jobId);
|
|
61
114
|
if (!Number.isFinite(pid) || pid <= 0)
|
|
62
115
|
return false;
|
|
116
|
+
if (!taskName)
|
|
117
|
+
return false;
|
|
118
|
+
const isAlive = deps.isAlive ?? isFallbackProcessAlive;
|
|
119
|
+
if (!isAlive(pid, taskName))
|
|
120
|
+
return false;
|
|
121
|
+
const kill = deps.kill ??
|
|
122
|
+
((target, signal) => process.kill(target, signal));
|
|
63
123
|
try {
|
|
64
|
-
|
|
124
|
+
kill(-pid, "SIGTERM");
|
|
65
125
|
return true;
|
|
66
126
|
}
|
|
67
127
|
catch {
|
|
68
|
-
|
|
128
|
+
try {
|
|
129
|
+
kill(pid, "SIGTERM");
|
|
130
|
+
return true;
|
|
131
|
+
}
|
|
132
|
+
catch {
|
|
133
|
+
return false;
|
|
134
|
+
}
|
|
135
|
+
}
|
|
136
|
+
}
|
|
137
|
+
/** Команда, которую выполняет fallback: обёртка задачи + перенаправление лога. */
|
|
138
|
+
function buildFallbackCommand(entry) {
|
|
139
|
+
const log = entry.logFile ? ` >> ${shellQuote(entry.logFile)} 2>&1` : "";
|
|
140
|
+
return `/bin/bash ${shellQuote(entry.command)}${log}`;
|
|
141
|
+
}
|
|
142
|
+
/**
|
|
143
|
+
* Чистит `pid:`-записи, пережившие перезагрузку.
|
|
144
|
+
*
|
|
145
|
+
* Вызывается один раз при старте плагина. Живые процессы с совпадающим
|
|
146
|
+
* маркером сохраняются; мёртвые — удаляются. Будущие one-shot пересоздаются,
|
|
147
|
+
* прошедшие — помечаются пропущенными с предупреждением.
|
|
148
|
+
*/
|
|
149
|
+
export async function pruneStaleFallbackEntries(registry, deps = {}) {
|
|
150
|
+
const nowMs = deps.now ? deps.now() : Date.now();
|
|
151
|
+
const isAlive = deps.isAlive ?? isFallbackProcessAlive;
|
|
152
|
+
const warn = deps.warn ?? ((message) => console.warn(message));
|
|
153
|
+
const schedule = deps.schedule ??
|
|
154
|
+
((entry, command, at) => scheduleAtFallback(entry, command, { now: () => at }));
|
|
155
|
+
// В системах без /proc проверить личность pid нельзя. Без инъекции
|
|
156
|
+
// isAlive ничего не трогаем, чтобы не убить чужой процесс.
|
|
157
|
+
if (!deps.isAlive && !hasProcfs()) {
|
|
158
|
+
return { kept: 0, removed: 0, rescheduled: 0, missed: 0, skipped: true };
|
|
159
|
+
}
|
|
160
|
+
const entries = await registry.load();
|
|
161
|
+
const report = {
|
|
162
|
+
kept: 0,
|
|
163
|
+
removed: 0,
|
|
164
|
+
rescheduled: 0,
|
|
165
|
+
missed: 0,
|
|
166
|
+
skipped: false,
|
|
167
|
+
};
|
|
168
|
+
let changed = false;
|
|
169
|
+
for (const entry of entries) {
|
|
170
|
+
if (!isPidJobId(entry.atJobId))
|
|
171
|
+
continue;
|
|
172
|
+
const pid = pidFromJobId(entry.atJobId);
|
|
173
|
+
if (isAlive(pid, entry.name)) {
|
|
174
|
+
report.kept += 1;
|
|
175
|
+
continue;
|
|
176
|
+
}
|
|
177
|
+
delete entry.atJobId;
|
|
178
|
+
changed = true;
|
|
179
|
+
report.removed += 1;
|
|
180
|
+
if (entry.triggerType !== "once" || entry.paused)
|
|
181
|
+
continue;
|
|
182
|
+
const target = entry.runAt ? Date.parse(entry.runAt) : Number.NaN;
|
|
183
|
+
if (Number.isFinite(target) && target > nowMs) {
|
|
184
|
+
try {
|
|
185
|
+
entry.atJobId = await schedule(entry, buildFallbackCommand(entry), nowMs);
|
|
186
|
+
report.rescheduled += 1;
|
|
187
|
+
}
|
|
188
|
+
catch (err) {
|
|
189
|
+
warn(`[scheduler] Не удалось пересоздать fallback для "${entry.name}": ${err instanceof Error ? err.message : String(err)}`);
|
|
190
|
+
}
|
|
191
|
+
continue;
|
|
192
|
+
}
|
|
193
|
+
report.missed += 1;
|
|
194
|
+
warn(`[scheduler] One-shot "${entry.name}" не будет запущена: fallback-процесс потерян, ` +
|
|
195
|
+
`время запуска уже прошло (${entry.runAt ?? "runAt не задан"}).`);
|
|
69
196
|
}
|
|
197
|
+
if (changed)
|
|
198
|
+
await registry.save(entries);
|
|
199
|
+
return report;
|
|
70
200
|
}
|
|
@@ -1,3 +1,4 @@
|
|
|
1
|
+
import { type PruneAtFallbackReport } from "./at-fallback.js";
|
|
1
2
|
import { PosixSchedulerBase } from "./posix.js";
|
|
2
3
|
import type { RegistryEntry } from "./registry.js";
|
|
3
4
|
/**
|
|
@@ -24,13 +25,23 @@ export declare class LinuxScheduler extends PosixSchedulerBase {
|
|
|
24
25
|
private renderBlock;
|
|
25
26
|
/** Читает текущий crontab (пустая строка, если crontab ещё не создан). */
|
|
26
27
|
private readCrontab;
|
|
27
|
-
/**
|
|
28
|
+
/**
|
|
29
|
+
* Убирает управляемый блок плагина из текста crontab.
|
|
30
|
+
*
|
|
31
|
+
* B9: удаляются только строки между парными маркерами. Незакрытый блок
|
|
32
|
+
* (маркер начала без конца) — fail-closed: бросаем ошибку, чтобы вызывающий
|
|
33
|
+
* не записал crontab и пользовательские задания после маркера не пропали.
|
|
34
|
+
* Строки вне маркеров сохраняются байт-в-байт, включая пустые.
|
|
35
|
+
*/
|
|
28
36
|
private stripBlock;
|
|
29
37
|
/** Записывает crontab через stdin: `crontab -`. */
|
|
30
38
|
private writeCrontab;
|
|
31
39
|
/** Перегенерирует блок плагина из реестра. */
|
|
32
40
|
private rebuildCrontab;
|
|
33
|
-
/** Строка команды one-shot для stdin `at`.
|
|
41
|
+
/** Строка команды one-shot для stdin `at`.
|
|
42
|
+
* P1-7.T1.3: без `-c` bash трактует аргумент как ИМЯ ФАЙЛА скрипта
|
|
43
|
+
* (exit 127 «No such file or directory»), поэтому at «выполнял» задание,
|
|
44
|
+
* но команда на самом деле не запускалась. */
|
|
34
45
|
private atCommand;
|
|
35
46
|
/**
|
|
36
47
|
* Ставит one-shot в `at` и возвращает id задания.
|
|
@@ -39,6 +50,11 @@ export declare class LinuxScheduler extends PosixSchedulerBase {
|
|
|
39
50
|
private scheduleAt;
|
|
40
51
|
/** Отменяет задание at, если оно ещё существует. */
|
|
41
52
|
private cancelAt;
|
|
53
|
+
/**
|
|
54
|
+
* P1-14: чистит `pid:`-записи fallback'а, пережившие перезагрузку.
|
|
55
|
+
* Вызывается из старта плагина; на других платформах не используется.
|
|
56
|
+
*/
|
|
57
|
+
pruneStaleFallbacks(): Promise<PruneAtFallbackReport>;
|
|
42
58
|
protected installEntry(entry: RegistryEntry): Promise<void>;
|
|
43
59
|
protected uninstallEntry(entry: RegistryEntry): Promise<void>;
|
|
44
60
|
protected applyPause(entry: RegistryEntry, paused: boolean): Promise<void>;
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"linux.d.ts","sourceRoot":"","sources":["../../../src/core/scheduler/linux.ts"],"names":[],"mappings":"
|
|
1
|
+
{"version":3,"file":"linux.d.ts","sourceRoot":"","sources":["../../../src/core/scheduler/linux.ts"],"names":[],"mappings":"AAIA,OAAO,EAML,KAAK,qBAAqB,EAC3B,MAAM,kBAAkB,CAAC;AAK1B,OAAO,EAAE,kBAAkB,EAAc,MAAM,YAAY,CAAC;AAC5D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAInD;;;;;;;;;;GAUG;AACH,qBAAa,cAAe,SAAQ,kBAAkB;IACpD,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC,QAAQ,CAAW;IAC7C,QAAQ,CAAC,KAAK,8BAA8B;IAE5C,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAClC,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAS;IAC1C,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAS;IACxC,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAU;gBAE9B,OAAO,GAAE,MAAyB;IAY9C,OAAO,CAAC,QAAQ;IAkBhB,OAAO,CAAC,WAAW;IAYnB,0EAA0E;YAC5D,WAAW;IAmBzB;;;;;;;OAOG;IACH,OAAO,CAAC,UAAU;IAiDlB,mDAAmD;YACrC,YAAY;IAgB1B,8CAA8C;YAChC,cAAc;IA+B5B;;;mDAG+C;IAC/C,OAAO,CAAC,SAAS;IAKjB;;;OAGG;YACW,UAAU;IAuExB,oDAAoD;YACtC,QAAQ;IAiBtB;;;OAGG;IACG,mBAAmB,IAAI,OAAO,CAAC,qBAAqB,CAAC;cAI3C,YAAY,CAAC,KAAK,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC;cAUjD,cAAc,CAAC,KAAK,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC;cAQnD,UAAU,CAAC,KAAK,EAAE,aAAa,EAAE,MAAM,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;CAoBjF"}
|
|
@@ -2,8 +2,8 @@ import { execFile, spawn } from "node:child_process";
|
|
|
2
2
|
import path from "node:path";
|
|
3
3
|
import { promisify } from "node:util";
|
|
4
4
|
import { buildAtTimestamp } from "../one-shot.js";
|
|
5
|
-
import { cancelAtFallback, isAtMissingError, isPidJobId, scheduleAtFallback, } from "./at-fallback.js";
|
|
6
|
-
import {
|
|
5
|
+
import { cancelAtFallback, isAtMissingError, isPidJobId, pruneStaleFallbackEntries, scheduleAtFallback, } from "./at-fallback.js";
|
|
6
|
+
import { needsPosixPollMode } from "../schedule-v2.js";
|
|
7
7
|
import { LockManager, withLockWait } from "../lock.js";
|
|
8
8
|
import { getBasePluginDir, getProfileName } from "../../profiles.js";
|
|
9
9
|
import { taskFolderNameForProfile, legacyTaskFolderNameForProfile } from "../../types.js";
|
|
@@ -41,12 +41,12 @@ export class LinuxScheduler extends PosixSchedulerBase {
|
|
|
41
41
|
}
|
|
42
42
|
const log = entry.logFile ? ` >> ${shellQuote(entry.logFile)} 2>&1` : "";
|
|
43
43
|
const cmd = `/bin/bash ${shellQuote(entry.command)}${log}`;
|
|
44
|
-
//
|
|
45
|
-
//
|
|
46
|
-
//
|
|
47
|
-
//
|
|
48
|
-
// иначе crontab сработает по системному
|
|
49
|
-
const schedule =
|
|
44
|
+
// Vixie-совместимый 5-полевой cron crontab выполняет сам: списки,
|
|
45
|
+
// диапазоны, шаги и имена месяцев/дней недели писать как есть можно.
|
|
46
|
+
// Quartz-расширения (L, d#n) и @-макросы (не 5 полей) crontab не понимает —
|
|
47
|
+
// для них "* * * * *" + gate во враппере. Чужая IANA-таймзона тоже уходит
|
|
48
|
+
// в poll: иначе crontab сработает по системному времени задачи.
|
|
49
|
+
const schedule = needsPosixPollMode(entry.schedule, entry.timezone)
|
|
50
50
|
? "* * * * *"
|
|
51
51
|
: entry.schedule;
|
|
52
52
|
return `${schedule} ${cmd}`;
|
|
@@ -72,17 +72,25 @@ export class LinuxScheduler extends PosixSchedulerBase {
|
|
|
72
72
|
return stdout;
|
|
73
73
|
}
|
|
74
74
|
catch (err) {
|
|
75
|
-
const
|
|
75
|
+
const stderrRaw = err?.stderr;
|
|
76
|
+
const stderr = typeof stderrRaw === "string" ? stderrRaw : String(stderrRaw ?? "");
|
|
76
77
|
// "no crontab for user" — это нормальное состояние. Любую другую ошибку
|
|
77
78
|
// (нет доступа, сбой crontab) нельзя превращать в пустой crontab: иначе
|
|
78
79
|
// последующая запись затрёт пользовательские задания.
|
|
79
80
|
if (/no crontab/i.test(stderr) || /no crontab/i.test(String(err?.message ?? ""))) {
|
|
80
81
|
return "";
|
|
81
82
|
}
|
|
82
|
-
throw new Error(`Не удалось прочитать crontab: ${stderr.trim() || err?.message || err}`);
|
|
83
|
+
throw new Error(`Не удалось прочитать crontab: ${stderr.trim() || err?.message || String(err)}`);
|
|
83
84
|
}
|
|
84
85
|
}
|
|
85
|
-
/**
|
|
86
|
+
/**
|
|
87
|
+
* Убирает управляемый блок плагина из текста crontab.
|
|
88
|
+
*
|
|
89
|
+
* B9: удаляются только строки между парными маркерами. Незакрытый блок
|
|
90
|
+
* (маркер начала без конца) — fail-closed: бросаем ошибку, чтобы вызывающий
|
|
91
|
+
* не записал crontab и пользовательские задания после маркера не пропали.
|
|
92
|
+
* Строки вне маркеров сохраняются байт-в-байт, включая пустые.
|
|
93
|
+
*/
|
|
86
94
|
stripBlock(content) {
|
|
87
95
|
// Совместимость: до появления профилей блок назывался без суффикса.
|
|
88
96
|
// Он принадлежит профилю default; другие профили его не трогают.
|
|
@@ -98,19 +106,33 @@ export class LinuxScheduler extends PosixSchedulerBase {
|
|
|
98
106
|
const lines = content.split(/\r?\n/);
|
|
99
107
|
const result = [];
|
|
100
108
|
let inside = false;
|
|
101
|
-
|
|
102
|
-
|
|
109
|
+
let openAt = 0;
|
|
110
|
+
for (let index = 0; index < lines.length; index += 1) {
|
|
111
|
+
const line = lines[index];
|
|
112
|
+
const trimmed = line.trim();
|
|
113
|
+
if (isBegin(trimmed)) {
|
|
114
|
+
if (inside) {
|
|
115
|
+
throw new Error(`crontab: вложенный маркер начала блока на строке ${index + 1} ` +
|
|
116
|
+
`(предыдущий блок открыт на строке ${openAt}). Файл не изменён.`);
|
|
117
|
+
}
|
|
103
118
|
inside = true;
|
|
119
|
+
openAt = index + 1;
|
|
104
120
|
continue;
|
|
105
121
|
}
|
|
106
|
-
if (isEnd(
|
|
122
|
+
if (inside && isEnd(trimmed)) {
|
|
107
123
|
inside = false;
|
|
108
124
|
continue;
|
|
109
125
|
}
|
|
126
|
+
// Строки внутри блока удаляются; всё остальное (включая «сиротский»
|
|
127
|
+
// маркер конца) остаётся без изменений.
|
|
110
128
|
if (!inside)
|
|
111
129
|
result.push(line);
|
|
112
130
|
}
|
|
113
|
-
|
|
131
|
+
if (inside) {
|
|
132
|
+
throw new Error(`crontab: незакрытый блок плагина с строки ${openAt} — ` +
|
|
133
|
+
"маркер конца не найден. Файл не изменён.");
|
|
134
|
+
}
|
|
135
|
+
return result.join("\n");
|
|
114
136
|
}
|
|
115
137
|
/** Записывает crontab через stdin: `crontab -`. */
|
|
116
138
|
async writeCrontab(content) {
|
|
@@ -140,20 +162,26 @@ export class LinuxScheduler extends PosixSchedulerBase {
|
|
|
140
162
|
await withLockWait(crontabLock, "crontab", async () => {
|
|
141
163
|
const entries = await this.registry.load();
|
|
142
164
|
const current = await this.readCrontab();
|
|
143
|
-
|
|
165
|
+
// B9: stripBlock сохраняет содержимое вне маркеров. Отрезаем только
|
|
166
|
+
// хвостовые переводы строк, чтобы повторные rebuild не копили пустые
|
|
167
|
+
// строки; одна финальная добавляется ниже.
|
|
168
|
+
const base = this.stripBlock(current).replace(/\n+$/, "");
|
|
144
169
|
const block = this.renderBlock(entries);
|
|
145
170
|
// Пустой блок (нет задач) не пишем, чтобы не оставлять мусор в crontab.
|
|
146
171
|
const hasTasks = block
|
|
147
172
|
.split("\n")
|
|
148
173
|
.some((line) => line.trim().startsWith("# task:"));
|
|
149
174
|
const next = [base, hasTasks ? block : ""].filter(Boolean).join("\n");
|
|
150
|
-
await this.writeCrontab(next);
|
|
175
|
+
await this.writeCrontab(next ? `${next}\n` : "");
|
|
151
176
|
}, { timeoutMs: 15000, staleMs: 60000 });
|
|
152
177
|
}
|
|
153
|
-
/** Строка команды one-shot для stdin `at`.
|
|
178
|
+
/** Строка команды one-shot для stdin `at`.
|
|
179
|
+
* P1-7.T1.3: без `-c` bash трактует аргумент как ИМЯ ФАЙЛА скрипта
|
|
180
|
+
* (exit 127 «No such file or directory»), поэтому at «выполнял» задание,
|
|
181
|
+
* но команда на самом деле не запускалась. */
|
|
154
182
|
atCommand(entry) {
|
|
155
183
|
const log = entry.logFile ? ` >> ${shellQuote(entry.logFile)} 2>&1` : "";
|
|
156
|
-
return `/bin/bash ${shellQuote(entry.command)}${log}`;
|
|
184
|
+
return `/bin/bash -c ${shellQuote(entry.command)}${log}`;
|
|
157
185
|
}
|
|
158
186
|
/**
|
|
159
187
|
* Ставит one-shot в `at` и возвращает id задания.
|
|
@@ -217,7 +245,8 @@ export class LinuxScheduler extends PosixSchedulerBase {
|
|
|
217
245
|
return;
|
|
218
246
|
if (isPidJobId(entry.atJobId)) {
|
|
219
247
|
// P1-7.T1.2: снимаем fallback-процесс, а не at-задание.
|
|
220
|
-
|
|
248
|
+
// P1-14: передаём имя — без сверки маркера pid мог быть переиспользован.
|
|
249
|
+
cancelAtFallback(entry.atJobId, entry.name);
|
|
221
250
|
delete entry.atJobId;
|
|
222
251
|
return;
|
|
223
252
|
}
|
|
@@ -229,6 +258,13 @@ export class LinuxScheduler extends PosixSchedulerBase {
|
|
|
229
258
|
}
|
|
230
259
|
delete entry.atJobId;
|
|
231
260
|
}
|
|
261
|
+
/**
|
|
262
|
+
* P1-14: чистит `pid:`-записи fallback'а, пережившие перезагрузку.
|
|
263
|
+
* Вызывается из старта плагина; на других платформах не используется.
|
|
264
|
+
*/
|
|
265
|
+
async pruneStaleFallbacks() {
|
|
266
|
+
return pruneStaleFallbackEntries(this.registry);
|
|
267
|
+
}
|
|
232
268
|
async installEntry(entry) {
|
|
233
269
|
if (entry.triggerType === "once") {
|
|
234
270
|
if (!entry.paused) {
|
|
@@ -246,6 +282,10 @@ export class LinuxScheduler extends PosixSchedulerBase {
|
|
|
246
282
|
await this.rebuildCrontab();
|
|
247
283
|
}
|
|
248
284
|
async applyPause(entry, paused) {
|
|
285
|
+
// P1-12: entry получен из find() ДО setPaused(), поэтому без этой строки
|
|
286
|
+
// upsert ниже возвращал в реестр paused:false, и listTasks() показывал
|
|
287
|
+
// приостановленную one-shot задачу как Ready.
|
|
288
|
+
entry.paused = paused;
|
|
249
289
|
if (entry.triggerType === "once") {
|
|
250
290
|
if (paused) {
|
|
251
291
|
await this.cancelAt(entry);
|
|
@@ -253,6 +293,9 @@ export class LinuxScheduler extends PosixSchedulerBase {
|
|
|
253
293
|
else if (entry.runAt && Date.parse(entry.runAt) > Date.now()) {
|
|
254
294
|
entry.atJobId = await this.scheduleAt(entry);
|
|
255
295
|
}
|
|
296
|
+
else {
|
|
297
|
+
console.warn(`[scheduler] Задача "${entry.name}" не будет перезапущена: время one-shot запуска уже прошло (${entry.runAt ?? "runAt не задан"}). Создайте новую задачу.`);
|
|
298
|
+
}
|
|
256
299
|
await this.registry.upsert(entry);
|
|
257
300
|
return;
|
|
258
301
|
}
|