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
package/src/core/schedule-v2.ts
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 и обращения к ОС.
|
|
@@ -183,6 +185,17 @@ function expandField(token: string, min: number, max: number, names?: Record<str
|
|
|
183
185
|
for (let v = a; v <= b; v += step) result.add(v);
|
|
184
186
|
continue;
|
|
185
187
|
}
|
|
188
|
+
if (stepMatch) {
|
|
189
|
+
// Шаг для одиночного значения Vixie-совместимый cron не поддерживает:
|
|
190
|
+
// раньше «5/15» молча превращалось в «только минута 5». Лучше явная
|
|
191
|
+
// ошибка, чем тихо другая семантика.
|
|
192
|
+
throw new Error(
|
|
193
|
+
t("schedule.error.cronStepNeedsRange", {
|
|
194
|
+
raw,
|
|
195
|
+
step: stepMatch[2],
|
|
196
|
+
}),
|
|
197
|
+
);
|
|
198
|
+
}
|
|
186
199
|
const num = Number(item);
|
|
187
200
|
if (!Number.isInteger(num) || num < min || num > max) {
|
|
188
201
|
throw new Error(
|
|
@@ -586,6 +599,75 @@ export function nextWindowOpenDelayMs(now: Date, options: ActiveWindowOptions =
|
|
|
586
599
|
return state.nextOpenAt ? Math.max(0, state.nextOpenAt.getTime() - now.getTime()) : 0;
|
|
587
600
|
}
|
|
588
601
|
|
|
602
|
+
export interface CronWindowFeasibility {
|
|
603
|
+
/** Будет ли хотя бы один запуск пропущен не из-за окна. */
|
|
604
|
+
feasible: boolean;
|
|
605
|
+
/** Сколько вхождений cron проверено. */
|
|
606
|
+
checked: number;
|
|
607
|
+
/** Ближайшее вхождение, которое окно/политика пропустят (ISO). */
|
|
608
|
+
firstRun?: string;
|
|
609
|
+
reason?: "never-fires" | "never-in-window" | "postpone-too-far";
|
|
610
|
+
}
|
|
611
|
+
|
|
612
|
+
/** Человекочитаемая причина недостижимости окна (P2-24). */
|
|
613
|
+
export function windowFeasibilityReasonText(
|
|
614
|
+
reason: CronWindowFeasibility["reason"],
|
|
615
|
+
): string {
|
|
616
|
+
switch (reason) {
|
|
617
|
+
case "never-fires":
|
|
618
|
+
return t("dryRun.window.reason.neverFires");
|
|
619
|
+
case "never-in-window":
|
|
620
|
+
return t("dryRun.window.reason.neverInWindow");
|
|
621
|
+
case "postpone-too-far":
|
|
622
|
+
return t("dryRun.window.reason.postponeTooFar");
|
|
623
|
+
default:
|
|
624
|
+
return "";
|
|
625
|
+
}
|
|
626
|
+
}
|
|
627
|
+
|
|
628
|
+
/**
|
|
629
|
+
* P2-24: проверяет, не окажется ли cron навсегда отрезан окном запуска.
|
|
630
|
+
*
|
|
631
|
+
* `schedule-gate` откладывает запуск максимум на 12 ч. Если cron срабатывает
|
|
632
|
+
* только в 09:00, а окно 22:00–06:00, то до открытия всегда ~13 ч → каждый тик
|
|
633
|
+
* молча пропускается. Здесь это выявляется заранее (для предупреждения при
|
|
634
|
+
* создании задачи и в dry_run).
|
|
635
|
+
*/
|
|
636
|
+
export function assessCronWindowFeasibility(
|
|
637
|
+
expr: string,
|
|
638
|
+
options: ActiveWindowOptions = {},
|
|
639
|
+
policy: "skip" | "postpone" | "run" = "postpone",
|
|
640
|
+
from: Date = new Date(),
|
|
641
|
+
maxPostponeMs = 12 * 60 * 60 * 1000,
|
|
642
|
+
maxOccurrences = 120,
|
|
643
|
+
): CronWindowFeasibility {
|
|
644
|
+
if (policy === "run") return { feasible: true, checked: 0 };
|
|
645
|
+
|
|
646
|
+
let cursor = from;
|
|
647
|
+
for (let i = 0; i < maxOccurrences; i += 1) {
|
|
648
|
+
const at = nextRun(expr, cursor, options.timeZone);
|
|
649
|
+
if (!at) {
|
|
650
|
+
return { feasible: false, checked: i, reason: "never-fires" };
|
|
651
|
+
}
|
|
652
|
+
const state = activeWindowState(at, options);
|
|
653
|
+
if (state.active) {
|
|
654
|
+
return { feasible: true, checked: i + 1, firstRun: at.toISOString() };
|
|
655
|
+
}
|
|
656
|
+
if (policy === "postpone" && state.nextOpenAt) {
|
|
657
|
+
const waitMs = state.nextOpenAt.getTime() - at.getTime();
|
|
658
|
+
if (waitMs <= maxPostponeMs) {
|
|
659
|
+
return { feasible: true, checked: i + 1, firstRun: at.toISOString() };
|
|
660
|
+
}
|
|
661
|
+
}
|
|
662
|
+
cursor = at;
|
|
663
|
+
}
|
|
664
|
+
return {
|
|
665
|
+
feasible: false,
|
|
666
|
+
checked: maxOccurrences,
|
|
667
|
+
reason: policy === "skip" ? "never-in-window" : "postpone-too-far",
|
|
668
|
+
};
|
|
669
|
+
}
|
|
670
|
+
|
|
589
671
|
// ---------------------------------------------------------------------------
|
|
590
672
|
// Проверка совместимости с schtasks (родной режим).
|
|
591
673
|
|
|
@@ -608,6 +690,22 @@ export function convertForSchtasks(expr: string): CronConversion {
|
|
|
608
690
|
return convertCronToSchTasks(normalizeCron(expr));
|
|
609
691
|
}
|
|
610
692
|
|
|
693
|
+
/**
|
|
694
|
+
* true, если выражение можно записать в crontab как есть (Vixie-совместимый
|
|
695
|
+
* 5-полевой cron). В отличие от schtasks, crontab понимает списки, диапазоны,
|
|
696
|
+
* шаги и имена месяцев/дней недели — их не нужно загонять в минутный опрос.
|
|
697
|
+
* Quartz-расширения `L` / `d#n` и макросы вроде `@daily` (не 5 полей) crontab
|
|
698
|
+
* не понимает: для них нужен poll-режим с gate во враппере.
|
|
699
|
+
*/
|
|
700
|
+
export function isNativePosixCronExpr(expr: string): boolean {
|
|
701
|
+
try {
|
|
702
|
+
const spec = parseCron(expr);
|
|
703
|
+
return !spec.lastDom && spec.nthWeekday.length === 0;
|
|
704
|
+
} catch {
|
|
705
|
+
return false;
|
|
706
|
+
}
|
|
707
|
+
}
|
|
708
|
+
|
|
611
709
|
// ---------------------------------------------------------------------------
|
|
612
710
|
// Политика планирования одной задачи (общий код для Windows-бека и index.ts).
|
|
613
711
|
|
|
@@ -638,6 +736,17 @@ export function needsPollMode(expr: string, timezone?: string | null): boolean {
|
|
|
638
736
|
return !isNativeSchtasksExpr(expr);
|
|
639
737
|
}
|
|
640
738
|
|
|
739
|
+
/**
|
|
740
|
+
* Аналог needsPollMode для POSIX-бэков (crontab): чужой IANA-таймзона или
|
|
741
|
+
* не-Vixie-синтаксис заставляет опрашивать каждую минуту, остальное crontab
|
|
742
|
+
* выполняет сам. Списки/диапазоны/шаги/имена здесь родные.
|
|
743
|
+
*/
|
|
744
|
+
export function needsPosixPollMode(expr: string, timezone?: string | null): boolean {
|
|
745
|
+
const tz = (timezone || "").trim();
|
|
746
|
+
if (tz && tz !== systemTimeZone()) return true;
|
|
747
|
+
return !isNativePosixCronExpr(expr);
|
|
748
|
+
}
|
|
749
|
+
|
|
641
750
|
/**
|
|
642
751
|
* Аргументы schedule-gate для враппера, либо undefined — если врапперу гейт
|
|
643
752
|
* не нужен (нативный cron + системный таймзона + окно не задано).
|
|
@@ -1,5 +1,7 @@
|
|
|
1
1
|
import { spawn } from "node:child_process";
|
|
2
|
+
import fs from "node:fs";
|
|
2
3
|
import type { RegistryEntry } from "./registry.js";
|
|
4
|
+
import { shellQuote } from "./posix.js";
|
|
3
5
|
|
|
4
6
|
/**
|
|
5
7
|
* Fallback для one-shot задач, когда утилита `at` не установлена.
|
|
@@ -31,7 +33,38 @@ export interface ScheduleAtFallbackDeps {
|
|
|
31
33
|
now?: () => number;
|
|
32
34
|
}
|
|
33
35
|
|
|
36
|
+
export interface CancelAtFallbackDeps {
|
|
37
|
+
isAlive?: (pid: number, taskName: string) => boolean;
|
|
38
|
+
kill?: (pid: number, signal: NodeJS.Signals) => void;
|
|
39
|
+
}
|
|
40
|
+
|
|
41
|
+
export interface PruneAtFallbackDeps {
|
|
42
|
+
now?: () => number;
|
|
43
|
+
isAlive?: (pid: number, taskName: string) => boolean;
|
|
44
|
+
schedule?: (
|
|
45
|
+
entry: RegistryEntry,
|
|
46
|
+
command: string,
|
|
47
|
+
nowMs: number,
|
|
48
|
+
) => Promise<string>;
|
|
49
|
+
warn?: (message: string) => void;
|
|
50
|
+
}
|
|
51
|
+
|
|
52
|
+
export interface PruneAtFallbackReport {
|
|
53
|
+
kept: number;
|
|
54
|
+
removed: number;
|
|
55
|
+
rescheduled: number;
|
|
56
|
+
missed: number;
|
|
57
|
+
skipped: boolean;
|
|
58
|
+
}
|
|
59
|
+
|
|
60
|
+
/** Минимальный интерфейс реестра — чтобы prune можно было тестировать без FS. */
|
|
61
|
+
export interface FallbackRegistry {
|
|
62
|
+
load(): Promise<RegistryEntry[]>;
|
|
63
|
+
save(entries: RegistryEntry[]): Promise<void>;
|
|
64
|
+
}
|
|
65
|
+
|
|
34
66
|
const PID_JOB_PREFIX = "pid:";
|
|
67
|
+
const FALLBACK_MARKER_PREFIX = "opencode-scheduler-at-fallback:";
|
|
35
68
|
|
|
36
69
|
/** Ошибка `spawn("at")`, означающая, что бинарник не найден. */
|
|
37
70
|
export function isAtMissingError(err: unknown): boolean {
|
|
@@ -51,6 +84,19 @@ export function computeDelaySeconds(runAt: string, nowMs: number): number {
|
|
|
51
84
|
return Math.max(0, Math.ceil((target - nowMs) / 1000));
|
|
52
85
|
}
|
|
53
86
|
|
|
87
|
+
/**
|
|
88
|
+
* Маркер fallback-процесса конкретной задачи.
|
|
89
|
+
*
|
|
90
|
+
* Лежит в командной строке (`/proc/<pid>/cmdline`), поэтому позволяет
|
|
91
|
+
* проверить, что pid всё ещё принадлежит нашей задаче, а не переиспользован
|
|
92
|
+
* другим процессом после перезагрузки/завершения.
|
|
93
|
+
*/
|
|
94
|
+
export function fallbackMarker(taskName: string): string {
|
|
95
|
+
return `${FALLBACK_MARKER_PREFIX}${Buffer.from(taskName, "utf8").toString(
|
|
96
|
+
"base64url",
|
|
97
|
+
)}`;
|
|
98
|
+
}
|
|
99
|
+
|
|
54
100
|
/** Скрипт для `/bin/bash -c`: подождать и выполнить команду задачи. */
|
|
55
101
|
export function buildDetachedOneShotScript(
|
|
56
102
|
entry: RegistryEntry,
|
|
@@ -61,7 +107,8 @@ export function buildDetachedOneShotScript(
|
|
|
61
107
|
throw new Error(`Задача "${entry.name}": не задано runAt для one-shot.`);
|
|
62
108
|
}
|
|
63
109
|
const delay = computeDelaySeconds(entry.runAt, nowMs);
|
|
64
|
-
|
|
110
|
+
// Маркер — обычный shell-комментарий в конце, поэтому на выполнение не влияет.
|
|
111
|
+
return `sleep ${delay}; ${command} # ${fallbackMarker(entry.name)}`;
|
|
65
112
|
}
|
|
66
113
|
|
|
67
114
|
/** Является ли сохранённый id задания pid-ом fallback-процесса. */
|
|
@@ -73,6 +120,39 @@ function pidFromJobId(jobId: string): number {
|
|
|
73
120
|
return Number.parseInt(jobId.slice(PID_JOB_PREFIX.length), 10);
|
|
74
121
|
}
|
|
75
122
|
|
|
123
|
+
/** Читает командную строку процесса из /proc; null, если процесс недоступен. */
|
|
124
|
+
export function readProcessCmdline(pid: number): string | null {
|
|
125
|
+
if (!Number.isFinite(pid) || pid <= 0) return null;
|
|
126
|
+
try {
|
|
127
|
+
return fs
|
|
128
|
+
.readFileSync(`/proc/${pid}/cmdline`, "utf8")
|
|
129
|
+
.split("\0")
|
|
130
|
+
.join(" ")
|
|
131
|
+
.trim();
|
|
132
|
+
} catch {
|
|
133
|
+
return null;
|
|
134
|
+
}
|
|
135
|
+
}
|
|
136
|
+
|
|
137
|
+
/**
|
|
138
|
+
* Живой ли это fallback-процесс именно этой задачи.
|
|
139
|
+
*
|
|
140
|
+
* Без проверки маркера `pid:` из персистентного реестра после перезагрузки
|
|
141
|
+
* может указывать на совершенно другой процесс.
|
|
142
|
+
*/
|
|
143
|
+
export function isFallbackProcessAlive(pid: number, taskName: string): boolean {
|
|
144
|
+
const cmdline = readProcessCmdline(pid);
|
|
145
|
+
return cmdline !== null && cmdline.includes(fallbackMarker(taskName));
|
|
146
|
+
}
|
|
147
|
+
|
|
148
|
+
function hasProcfs(): boolean {
|
|
149
|
+
try {
|
|
150
|
+
return fs.existsSync("/proc/self/cmdline");
|
|
151
|
+
} catch {
|
|
152
|
+
return false;
|
|
153
|
+
}
|
|
154
|
+
}
|
|
155
|
+
|
|
76
156
|
/**
|
|
77
157
|
* Запускает отвязанный one-shot и возвращает `pid:<pid>` для `cancelAt`.
|
|
78
158
|
* Промис резолвится сразу после успешного `spawn`, не дожидаясь выполнения.
|
|
@@ -99,15 +179,120 @@ export async function scheduleAtFallback(
|
|
|
99
179
|
});
|
|
100
180
|
}
|
|
101
181
|
|
|
102
|
-
/**
|
|
103
|
-
|
|
182
|
+
/**
|
|
183
|
+
* Снимает fallback-процесс.
|
|
184
|
+
*
|
|
185
|
+
* Требует имя задачи и сверяет маркер в `/proc/<pid>/cmdline`: голый pid из
|
|
186
|
+
* реестра после перезагрузки может принадлежать чужому процессу. Убивает
|
|
187
|
+
* группу процессов (fallback запущен detached и является её лидером).
|
|
188
|
+
*/
|
|
189
|
+
export function cancelAtFallback(
|
|
190
|
+
jobId: string,
|
|
191
|
+
taskName?: string,
|
|
192
|
+
deps: CancelAtFallbackDeps = {},
|
|
193
|
+
): boolean {
|
|
104
194
|
if (!isPidJobId(jobId)) return false;
|
|
105
195
|
const pid = pidFromJobId(jobId);
|
|
106
196
|
if (!Number.isFinite(pid) || pid <= 0) return false;
|
|
197
|
+
if (!taskName) return false;
|
|
198
|
+
|
|
199
|
+
const isAlive = deps.isAlive ?? isFallbackProcessAlive;
|
|
200
|
+
if (!isAlive(pid, taskName)) return false;
|
|
201
|
+
|
|
202
|
+
const kill =
|
|
203
|
+
deps.kill ??
|
|
204
|
+
((target: number, signal: NodeJS.Signals) => process.kill(target, signal));
|
|
107
205
|
try {
|
|
108
|
-
|
|
206
|
+
kill(-pid, "SIGTERM");
|
|
109
207
|
return true;
|
|
110
208
|
} catch {
|
|
111
|
-
|
|
209
|
+
try {
|
|
210
|
+
kill(pid, "SIGTERM");
|
|
211
|
+
return true;
|
|
212
|
+
} catch {
|
|
213
|
+
return false;
|
|
214
|
+
}
|
|
112
215
|
}
|
|
113
216
|
}
|
|
217
|
+
|
|
218
|
+
/** Команда, которую выполняет fallback: обёртка задачи + перенаправление лога. */
|
|
219
|
+
function buildFallbackCommand(entry: RegistryEntry): string {
|
|
220
|
+
const log = entry.logFile ? ` >> ${shellQuote(entry.logFile)} 2>&1` : "";
|
|
221
|
+
return `/bin/bash ${shellQuote(entry.command)}${log}`;
|
|
222
|
+
}
|
|
223
|
+
|
|
224
|
+
/**
|
|
225
|
+
* Чистит `pid:`-записи, пережившие перезагрузку.
|
|
226
|
+
*
|
|
227
|
+
* Вызывается один раз при старте плагина. Живые процессы с совпадающим
|
|
228
|
+
* маркером сохраняются; мёртвые — удаляются. Будущие one-shot пересоздаются,
|
|
229
|
+
* прошедшие — помечаются пропущенными с предупреждением.
|
|
230
|
+
*/
|
|
231
|
+
export async function pruneStaleFallbackEntries(
|
|
232
|
+
registry: FallbackRegistry,
|
|
233
|
+
deps: PruneAtFallbackDeps = {},
|
|
234
|
+
): Promise<PruneAtFallbackReport> {
|
|
235
|
+
const nowMs = deps.now ? deps.now() : Date.now();
|
|
236
|
+
const isAlive = deps.isAlive ?? isFallbackProcessAlive;
|
|
237
|
+
const warn = deps.warn ?? ((message: string) => console.warn(message));
|
|
238
|
+
const schedule =
|
|
239
|
+
deps.schedule ??
|
|
240
|
+
((entry, command, at) =>
|
|
241
|
+
scheduleAtFallback(entry, command, { now: () => at }));
|
|
242
|
+
|
|
243
|
+
// В системах без /proc проверить личность pid нельзя. Без инъекции
|
|
244
|
+
// isAlive ничего не трогаем, чтобы не убить чужой процесс.
|
|
245
|
+
if (!deps.isAlive && !hasProcfs()) {
|
|
246
|
+
return { kept: 0, removed: 0, rescheduled: 0, missed: 0, skipped: true };
|
|
247
|
+
}
|
|
248
|
+
|
|
249
|
+
const entries = await registry.load();
|
|
250
|
+
const report: PruneAtFallbackReport = {
|
|
251
|
+
kept: 0,
|
|
252
|
+
removed: 0,
|
|
253
|
+
rescheduled: 0,
|
|
254
|
+
missed: 0,
|
|
255
|
+
skipped: false,
|
|
256
|
+
};
|
|
257
|
+
|
|
258
|
+
let changed = false;
|
|
259
|
+
for (const entry of entries) {
|
|
260
|
+
if (!isPidJobId(entry.atJobId)) continue;
|
|
261
|
+
const pid = pidFromJobId(entry.atJobId!);
|
|
262
|
+
|
|
263
|
+
if (isAlive(pid, entry.name)) {
|
|
264
|
+
report.kept += 1;
|
|
265
|
+
continue;
|
|
266
|
+
}
|
|
267
|
+
|
|
268
|
+
delete entry.atJobId;
|
|
269
|
+
changed = true;
|
|
270
|
+
report.removed += 1;
|
|
271
|
+
|
|
272
|
+
if (entry.triggerType !== "once" || entry.paused) continue;
|
|
273
|
+
|
|
274
|
+
const target = entry.runAt ? Date.parse(entry.runAt) : Number.NaN;
|
|
275
|
+
if (Number.isFinite(target) && target > nowMs) {
|
|
276
|
+
try {
|
|
277
|
+
entry.atJobId = await schedule(entry, buildFallbackCommand(entry), nowMs);
|
|
278
|
+
report.rescheduled += 1;
|
|
279
|
+
} catch (err: any) {
|
|
280
|
+
warn(
|
|
281
|
+
`[scheduler] Не удалось пересоздать fallback для "${entry.name}": ${
|
|
282
|
+
err instanceof Error ? err.message : String(err)
|
|
283
|
+
}`,
|
|
284
|
+
);
|
|
285
|
+
}
|
|
286
|
+
continue;
|
|
287
|
+
}
|
|
288
|
+
|
|
289
|
+
report.missed += 1;
|
|
290
|
+
warn(
|
|
291
|
+
`[scheduler] One-shot "${entry.name}" не будет запущена: fallback-процесс потерян, ` +
|
|
292
|
+
`время запуска уже прошло (${entry.runAt ?? "runAt не задан"}).`,
|
|
293
|
+
);
|
|
294
|
+
}
|
|
295
|
+
|
|
296
|
+
if (changed) await registry.save(entries);
|
|
297
|
+
return report;
|
|
298
|
+
}
|
|
@@ -6,9 +6,11 @@ import {
|
|
|
6
6
|
cancelAtFallback,
|
|
7
7
|
isAtMissingError,
|
|
8
8
|
isPidJobId,
|
|
9
|
+
pruneStaleFallbackEntries,
|
|
9
10
|
scheduleAtFallback,
|
|
11
|
+
type PruneAtFallbackReport,
|
|
10
12
|
} from "./at-fallback.js";
|
|
11
|
-
import {
|
|
13
|
+
import { needsPosixPollMode } from "../schedule-v2.js";
|
|
12
14
|
import { LockManager, withLockWait } from "../lock.js";
|
|
13
15
|
import { getBasePluginDir, getProfileName } from "../../profiles.js";
|
|
14
16
|
import { taskFolderNameForProfile, legacyTaskFolderNameForProfile } from "../../types.js";
|
|
@@ -57,12 +59,12 @@ export class LinuxScheduler extends PosixSchedulerBase {
|
|
|
57
59
|
}
|
|
58
60
|
const log = entry.logFile ? ` >> ${shellQuote(entry.logFile)} 2>&1` : "";
|
|
59
61
|
const cmd = `/bin/bash ${shellQuote(entry.command)}${log}`;
|
|
60
|
-
//
|
|
61
|
-
//
|
|
62
|
-
//
|
|
63
|
-
//
|
|
64
|
-
// иначе crontab сработает по системному
|
|
65
|
-
const schedule =
|
|
62
|
+
// Vixie-совместимый 5-полевой cron crontab выполняет сам: списки,
|
|
63
|
+
// диапазоны, шаги и имена месяцев/дней недели писать как есть можно.
|
|
64
|
+
// Quartz-расширения (L, d#n) и @-макросы (не 5 полей) crontab не понимает —
|
|
65
|
+
// для них "* * * * *" + gate во враппере. Чужая IANA-таймзона тоже уходит
|
|
66
|
+
// в poll: иначе crontab сработает по системному времени задачи.
|
|
67
|
+
const schedule = needsPosixPollMode(entry.schedule, entry.timezone)
|
|
66
68
|
? "* * * * *"
|
|
67
69
|
: entry.schedule;
|
|
68
70
|
return `${schedule} ${cmd}`;
|
|
@@ -177,10 +179,13 @@ export class LinuxScheduler extends PosixSchedulerBase {
|
|
|
177
179
|
);
|
|
178
180
|
}
|
|
179
181
|
|
|
180
|
-
/** Строка команды one-shot для stdin `at`.
|
|
182
|
+
/** Строка команды one-shot для stdin `at`.
|
|
183
|
+
* P1-7.T1.3: без `-c` bash трактует аргумент как ИМЯ ФАЙЛА скрипта
|
|
184
|
+
* (exit 127 «No such file or directory»), поэтому at «выполнял» задание,
|
|
185
|
+
* но команда на самом деле не запускалась. */
|
|
181
186
|
private atCommand(entry: RegistryEntry): string {
|
|
182
187
|
const log = entry.logFile ? ` >> ${shellQuote(entry.logFile)} 2>&1` : "";
|
|
183
|
-
return `/bin/bash ${shellQuote(entry.command)}${log}`;
|
|
188
|
+
return `/bin/bash -c ${shellQuote(entry.command)}${log}`;
|
|
184
189
|
}
|
|
185
190
|
|
|
186
191
|
/**
|
|
@@ -263,7 +268,8 @@ export class LinuxScheduler extends PosixSchedulerBase {
|
|
|
263
268
|
if (!entry.atJobId) return;
|
|
264
269
|
if (isPidJobId(entry.atJobId)) {
|
|
265
270
|
// P1-7.T1.2: снимаем fallback-процесс, а не at-задание.
|
|
266
|
-
|
|
271
|
+
// P1-14: передаём имя — без сверки маркера pid мог быть переиспользован.
|
|
272
|
+
cancelAtFallback(entry.atJobId, entry.name);
|
|
267
273
|
delete entry.atJobId;
|
|
268
274
|
return;
|
|
269
275
|
}
|
|
@@ -275,6 +281,14 @@ export class LinuxScheduler extends PosixSchedulerBase {
|
|
|
275
281
|
delete entry.atJobId;
|
|
276
282
|
}
|
|
277
283
|
|
|
284
|
+
/**
|
|
285
|
+
* P1-14: чистит `pid:`-записи fallback'а, пережившие перезагрузку.
|
|
286
|
+
* Вызывается из старта плагина; на других платформах не используется.
|
|
287
|
+
*/
|
|
288
|
+
async pruneStaleFallbacks(): Promise<PruneAtFallbackReport> {
|
|
289
|
+
return pruneStaleFallbackEntries(this.registry);
|
|
290
|
+
}
|
|
291
|
+
|
|
278
292
|
protected async installEntry(entry: RegistryEntry): Promise<void> {
|
|
279
293
|
if (entry.triggerType === "once") {
|
|
280
294
|
if (!entry.paused) {
|
|
@@ -294,11 +308,19 @@ export class LinuxScheduler extends PosixSchedulerBase {
|
|
|
294
308
|
}
|
|
295
309
|
|
|
296
310
|
protected async applyPause(entry: RegistryEntry, paused: boolean): Promise<void> {
|
|
311
|
+
// P1-12: entry получен из find() ДО setPaused(), поэтому без этой строки
|
|
312
|
+
// upsert ниже возвращал в реестр paused:false, и listTasks() показывал
|
|
313
|
+
// приостановленную one-shot задачу как Ready.
|
|
314
|
+
entry.paused = paused;
|
|
297
315
|
if (entry.triggerType === "once") {
|
|
298
316
|
if (paused) {
|
|
299
317
|
await this.cancelAt(entry);
|
|
300
318
|
} else if (entry.runAt && Date.parse(entry.runAt) > Date.now()) {
|
|
301
319
|
entry.atJobId = await this.scheduleAt(entry);
|
|
320
|
+
} else {
|
|
321
|
+
console.warn(
|
|
322
|
+
`[scheduler] Задача "${entry.name}" не будет перезапущена: время one-shot запуска уже прошло (${entry.runAt ?? "runAt не задан"}). Создайте новую задачу.`,
|
|
323
|
+
);
|
|
302
324
|
}
|
|
303
325
|
await this.registry.upsert(entry);
|
|
304
326
|
return;
|
|
@@ -48,8 +48,27 @@ export abstract class PosixSchedulerBase implements SchedulerBackend {
|
|
|
48
48
|
...(options.timezone ? { timezone: options.timezone } : {}),
|
|
49
49
|
};
|
|
50
50
|
|
|
51
|
+
// P2-17: запись нужна в реестре ДО installEntry — Linux пересобирает crontab
|
|
52
|
+
// из реестра. Но если установка упала, запись-призрак останется навсегда,
|
|
53
|
+
// поэтому откатываем реестр к предыдущему состоянию.
|
|
54
|
+
const previous = await this.registry.find(entry.name);
|
|
51
55
|
await this.registry.upsert(entry);
|
|
52
|
-
|
|
56
|
+
try {
|
|
57
|
+
await this.installEntry(entry);
|
|
58
|
+
} catch (err) {
|
|
59
|
+
try {
|
|
60
|
+
if (previous) await this.registry.upsert(previous);
|
|
61
|
+
else await this.registry.remove(entry.name);
|
|
62
|
+
} catch {
|
|
63
|
+
// Не маскируем исходную ошибку установки ошибкой отката.
|
|
64
|
+
}
|
|
65
|
+
try {
|
|
66
|
+
await this.uninstallEntry(entry);
|
|
67
|
+
} catch {
|
|
68
|
+
// Частичная установка могла не создать запись — это не ошибка отката.
|
|
69
|
+
}
|
|
70
|
+
throw err;
|
|
71
|
+
}
|
|
53
72
|
// installEntry может записать atJobId для Linux one-shot.
|
|
54
73
|
await this.registry.upsert(entry);
|
|
55
74
|
}
|