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.
Files changed (171) hide show
  1. package/CHANGELOG.md +20 -0
  2. package/README.md +3 -3
  3. package/ROADMAP-STRATEGY.md +9 -9
  4. package/ROADMAP.md +50 -34
  5. package/dist/core/dlq-api.d.ts +44 -0
  6. package/dist/core/dlq-api.d.ts.map +1 -0
  7. package/dist/core/dlq-api.js +68 -0
  8. package/dist/core/dry-run.d.ts.map +1 -1
  9. package/dist/core/dry-run.js +18 -1
  10. package/dist/core/lock.d.ts +20 -4
  11. package/dist/core/lock.d.ts.map +1 -1
  12. package/dist/core/lock.js +97 -22
  13. package/dist/core/one-shot.d.ts +5 -1
  14. package/dist/core/one-shot.d.ts.map +1 -1
  15. package/dist/core/one-shot.js +33 -8
  16. package/dist/core/opencode-cli.d.ts +28 -0
  17. package/dist/core/opencode-cli.d.ts.map +1 -0
  18. package/dist/core/opencode-cli.js +74 -0
  19. package/dist/core/opencode-models.d.ts +62 -0
  20. package/dist/core/opencode-models.d.ts.map +1 -0
  21. package/dist/core/opencode-models.js +277 -0
  22. package/dist/core/ps-wrapper.d.ts +1 -1
  23. package/dist/core/ps-wrapper.d.ts.map +1 -1
  24. package/dist/core/ps-wrapper.js +11 -1
  25. package/dist/core/record-history.d.ts +15 -0
  26. package/dist/core/record-history.d.ts.map +1 -1
  27. package/dist/core/record-history.js +56 -32
  28. package/dist/core/router/dispatch.d.ts +36 -0
  29. package/dist/core/router/dispatch.d.ts.map +1 -0
  30. package/dist/core/router/dispatch.js +59 -0
  31. package/dist/core/router/escalation.d.ts +47 -0
  32. package/dist/core/router/escalation.d.ts.map +1 -0
  33. package/dist/core/router/escalation.js +87 -0
  34. package/dist/core/router/planner.d.ts +53 -0
  35. package/dist/core/router/planner.d.ts.map +1 -0
  36. package/dist/core/router/planner.js +113 -0
  37. package/dist/core/router/rules.d.ts +46 -0
  38. package/dist/core/router/rules.d.ts.map +1 -0
  39. package/dist/core/router/rules.js +85 -0
  40. package/dist/core/run-panel-api.d.ts +94 -0
  41. package/dist/core/run-panel-api.d.ts.map +1 -0
  42. package/dist/core/run-panel-api.js +169 -0
  43. package/dist/core/schedule-gate.js +5 -1
  44. package/dist/core/schedule-v2.d.ts +34 -0
  45. package/dist/core/schedule-v2.d.ts.map +1 -1
  46. package/dist/core/schedule-v2.js +91 -5
  47. package/dist/core/scheduler/at-fallback.d.ts +55 -2
  48. package/dist/core/scheduler/at-fallback.d.ts.map +1 -1
  49. package/dist/core/scheduler/at-fallback.js +135 -5
  50. package/dist/core/scheduler/linux.d.ts +10 -1
  51. package/dist/core/scheduler/linux.d.ts.map +1 -1
  52. package/dist/core/scheduler/linux.js +29 -11
  53. package/dist/core/scheduler/posix.d.ts.map +1 -1
  54. package/dist/core/scheduler/posix.js +25 -1
  55. package/dist/core/scheduler/registry.d.ts +11 -0
  56. package/dist/core/scheduler/registry.d.ts.map +1 -1
  57. package/dist/core/scheduler/registry.js +83 -21
  58. package/dist/core/scheduler/run-now.d.ts +16 -0
  59. package/dist/core/scheduler/run-now.d.ts.map +1 -0
  60. package/dist/core/scheduler/run-now.js +28 -0
  61. package/dist/core/secrets.d.ts.map +1 -1
  62. package/dist/core/secrets.js +125 -28
  63. package/dist/core/session.d.ts.map +1 -1
  64. package/dist/core/session.js +18 -11
  65. package/dist/core/task-name.d.ts +24 -0
  66. package/dist/core/task-name.d.ts.map +1 -0
  67. package/dist/core/task-name.js +40 -0
  68. package/dist/core/wrappers/bash.d.ts.map +1 -1
  69. package/dist/core/wrappers/bash.js +49 -4
  70. package/dist/db/capability-repo.d.ts +83 -0
  71. package/dist/db/capability-repo.d.ts.map +1 -0
  72. package/dist/db/capability-repo.js +182 -0
  73. package/dist/db/history-repo.d.ts +8 -0
  74. package/dist/db/history-repo.d.ts.map +1 -1
  75. package/dist/db/history-repo.js +19 -0
  76. package/dist/db/index.d.ts +4 -0
  77. package/dist/db/index.d.ts.map +1 -1
  78. package/dist/db/index.js +39 -1
  79. package/dist/db/migrate.d.ts.map +1 -1
  80. package/dist/db/migrate.js +3 -1
  81. package/dist/db/run-context.d.ts +103 -0
  82. package/dist/db/run-context.d.ts.map +1 -0
  83. package/dist/db/run-context.js +224 -0
  84. package/dist/db/run-dlq.d.ts +100 -0
  85. package/dist/db/run-dlq.d.ts.map +1 -0
  86. package/dist/db/run-dlq.js +191 -0
  87. package/dist/db/run-resume.d.ts +5 -2
  88. package/dist/db/run-resume.d.ts.map +1 -1
  89. package/dist/db/run-resume.js +30 -11
  90. package/dist/db/runs-repo.d.ts +13 -5
  91. package/dist/db/runs-repo.d.ts.map +1 -1
  92. package/dist/db/runs-repo.js +28 -5
  93. package/dist/db/schema.d.ts +2 -2
  94. package/dist/db/schema.d.ts.map +1 -1
  95. package/dist/db/schema.js +154 -2
  96. package/dist/db/settings-repo.d.ts +11 -0
  97. package/dist/db/settings-repo.d.ts.map +1 -1
  98. package/dist/db/settings-repo.js +25 -0
  99. package/dist/db/step-idempotency.d.ts +51 -0
  100. package/dist/db/step-idempotency.d.ts.map +1 -0
  101. package/dist/db/step-idempotency.js +136 -0
  102. package/dist/index.d.ts +4 -4
  103. package/dist/index.d.ts.map +1 -1
  104. package/dist/index.js +102 -4
  105. package/dist/rpc.d.ts +678 -0
  106. package/dist/rpc.d.ts.map +1 -1
  107. package/dist/rpc.js +235 -0
  108. package/dist/server.d.ts +31 -0
  109. package/dist/server.d.ts.map +1 -1
  110. package/dist/server.js +95 -35
  111. package/dist/types.d.ts.map +1 -1
  112. package/dist/types.js +7 -0
  113. package/dist/workspaces.d.ts +25 -3
  114. package/dist/workspaces.d.ts.map +1 -1
  115. package/dist/workspaces.js +43 -8
  116. package/docs/ARCHITECTURE.md +229 -5
  117. package/docs/CONCEPT.md +171 -91
  118. package/docs/EXECUTION-LOOP.md +196 -0
  119. package/docs/README.ru.md +2 -2
  120. package/docs/README.zh.md +3 -3
  121. package/docs/SAFETY.md +122 -0
  122. package/docs/SAVINGS.md +29 -0
  123. package/docs/SAVINGS.ru.md +29 -0
  124. package/docs/SAVINGS.zh.md +18 -0
  125. package/gui-experimental.cjs +8 -8
  126. package/locales/en.json +67 -0
  127. package/locales/ru.json +67 -0
  128. package/locales/zh.json +67 -0
  129. package/package.json +28 -3
  130. package/scripts/audit-bundle.mjs +215 -0
  131. package/src/core/dlq-api.ts +98 -0
  132. package/src/core/dry-run.ts +25 -1
  133. package/src/core/lock.ts +95 -22
  134. package/src/core/one-shot.ts +36 -8
  135. package/src/core/opencode-cli.ts +103 -0
  136. package/src/core/opencode-models.ts +315 -0
  137. package/src/core/ps-wrapper.ts +11 -1
  138. package/src/core/record-history.ts +75 -37
  139. package/src/core/router/dispatch.ts +94 -0
  140. package/src/core/router/escalation.ts +129 -0
  141. package/src/core/router/planner.ts +166 -0
  142. package/src/core/router/rules.ts +109 -0
  143. package/src/core/run-panel-api.ts +262 -0
  144. package/src/core/schedule-gate.ts +6 -2
  145. package/src/core/schedule-v2.ts +114 -5
  146. package/src/core/scheduler/at-fallback.ts +190 -5
  147. package/src/core/scheduler/linux.ts +32 -10
  148. package/src/core/scheduler/posix.ts +20 -1
  149. package/src/core/scheduler/registry.ts +107 -26
  150. package/src/core/scheduler/run-now.ts +32 -0
  151. package/src/core/secrets.ts +127 -27
  152. package/src/core/session.ts +23 -10
  153. package/src/core/task-name.ts +67 -0
  154. package/src/core/wrappers/bash.ts +49 -4
  155. package/src/db/capability-repo.ts +285 -0
  156. package/src/db/history-repo.ts +22 -0
  157. package/src/db/index.ts +37 -1
  158. package/src/db/migrate.ts +3 -1
  159. package/src/db/run-context.ts +370 -0
  160. package/src/db/run-dlq.ts +310 -0
  161. package/src/db/run-resume.ts +48 -12
  162. package/src/db/runs-repo.ts +30 -7
  163. package/src/db/schema.ts +154 -2
  164. package/src/db/settings-repo.ts +31 -0
  165. package/src/db/step-idempotency.ts +185 -0
  166. package/src/gui.tsx +515 -0
  167. package/src/index.ts +124 -4
  168. package/src/rpc.ts +251 -0
  169. package/src/server.ts +112 -36
  170. package/src/types.ts +9 -0
  171. package/src/workspaces.ts +58 -9
@@ -2,11 +2,13 @@
2
2
  * Расширенный cron и окна запуска (Спринт 19).
3
3
  *
4
4
  * Два режима регистрации в ОС:
5
- * - «родной» (флаги schtasks / строки crontab / plist launchd) — только для
6
- * простых выражений и системной таймзоны;
7
- * - «опрос раз в минуту» (MINUTE /mo 1 + node-gate в обёртке) — для всего
8
- * остального (timezone != system, списки, L, #, комбинации). Обёртка
9
- * вызывает dist/core/schedule-gate.js, который сам решает, пора ли запускать.
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
- return `sleep ${delay}; ${command}`;
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
- /** Снимает fallback-процесс. Ошибки (процесс уже завершился) игнорируются. */
103
- export function cancelAtFallback(jobId: string): boolean {
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
- process.kill(pid, "SIGTERM");
206
+ kill(-pid, "SIGTERM");
109
207
  return true;
110
208
  } catch {
111
- return false;
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 { needsPollMode } from "../schedule-v2.js";
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
- // crontab понимает только 5-полевой cron. Расширенные выражения (L, #,
61
- // списки, @daily и т.п.) нельзя писать в crontab как есть — опрашиваем
62
- // каждую минуту, а решение о запуске принимает gate во враппере.
63
- // Задачи с чужой IANA-таймзоной (не системной) тоже уходят в poll-режим,
64
- // иначе crontab сработает по системному времени, а не по таймзоне задачи.
65
- const schedule = needsPollMode(entry.schedule, entry.timezone)
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
- cancelAtFallback(entry.atJobId);
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
- await this.installEntry(entry);
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
  }