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.
Files changed (287) hide show
  1. package/CHANGELOG.md +154 -2
  2. package/CROSS_PLATFORM.md +19 -0
  3. package/README.md +54 -9
  4. package/ROADMAP-STRATEGY.md +23 -20
  5. package/ROADMAP.md +140 -143
  6. package/dist/cli.d.ts +3 -0
  7. package/dist/cli.d.ts.map +1 -0
  8. package/dist/cli.js +351 -0
  9. package/dist/core/dlq-api.d.ts +44 -0
  10. package/dist/core/dlq-api.d.ts.map +1 -0
  11. package/dist/core/dlq-api.js +68 -0
  12. package/dist/core/dry-run.d.ts.map +1 -1
  13. package/dist/core/dry-run.js +18 -1
  14. package/dist/core/execution.d.ts +203 -0
  15. package/dist/core/execution.d.ts.map +1 -0
  16. package/dist/core/execution.js +309 -0
  17. package/dist/core/gate-integrity.d.ts +35 -0
  18. package/dist/core/gate-integrity.d.ts.map +1 -0
  19. package/dist/core/gate-integrity.js +132 -0
  20. package/dist/core/git-trigger.d.ts.map +1 -1
  21. package/dist/core/git-trigger.js +14 -2
  22. package/dist/core/guard-run.d.ts +4 -0
  23. package/dist/core/guard-run.d.ts.map +1 -0
  24. package/dist/core/guard-run.js +101 -0
  25. package/dist/core/guard.d.ts +52 -0
  26. package/dist/core/guard.d.ts.map +1 -0
  27. package/dist/core/guard.js +362 -0
  28. package/dist/core/lock.d.ts +61 -4
  29. package/dist/core/lock.d.ts.map +1 -1
  30. package/dist/core/lock.js +213 -26
  31. package/dist/core/matrix.d.ts.map +1 -1
  32. package/dist/core/matrix.js +75 -15
  33. package/dist/core/mission.d.ts +83 -0
  34. package/dist/core/mission.d.ts.map +1 -0
  35. package/dist/core/mission.js +334 -0
  36. package/dist/core/one-shot.d.ts +5 -1
  37. package/dist/core/one-shot.d.ts.map +1 -1
  38. package/dist/core/one-shot.js +33 -8
  39. package/dist/core/opencode-cli.d.ts +28 -0
  40. package/dist/core/opencode-cli.d.ts.map +1 -0
  41. package/dist/core/opencode-cli.js +74 -0
  42. package/dist/core/opencode-models.d.ts +62 -0
  43. package/dist/core/opencode-models.d.ts.map +1 -0
  44. package/dist/core/opencode-models.js +277 -0
  45. package/dist/core/pipeline-apply.d.ts +38 -0
  46. package/dist/core/pipeline-apply.d.ts.map +1 -0
  47. package/dist/core/pipeline-apply.js +117 -0
  48. package/dist/core/pipeline-io.d.ts +13 -0
  49. package/dist/core/pipeline-io.d.ts.map +1 -0
  50. package/dist/core/pipeline-io.js +64 -0
  51. package/dist/core/pipeline-map.d.ts +46 -0
  52. package/dist/core/pipeline-map.d.ts.map +1 -0
  53. package/dist/core/pipeline-map.js +196 -0
  54. package/dist/core/pipeline-spec.d.ts +109 -0
  55. package/dist/core/pipeline-spec.d.ts.map +1 -0
  56. package/dist/core/pipeline-spec.js +554 -0
  57. package/dist/core/ps-wrapper.d.ts +19 -2
  58. package/dist/core/ps-wrapper.d.ts.map +1 -1
  59. package/dist/core/ps-wrapper.js +261 -63
  60. package/dist/core/record-history.d.ts +15 -0
  61. package/dist/core/record-history.d.ts.map +1 -1
  62. package/dist/core/record-history.js +183 -58
  63. package/dist/core/router/dispatch.d.ts +36 -0
  64. package/dist/core/router/dispatch.d.ts.map +1 -0
  65. package/dist/core/router/dispatch.js +59 -0
  66. package/dist/core/router/escalation.d.ts +47 -0
  67. package/dist/core/router/escalation.d.ts.map +1 -0
  68. package/dist/core/router/escalation.js +87 -0
  69. package/dist/core/router/planner.d.ts +53 -0
  70. package/dist/core/router/planner.d.ts.map +1 -0
  71. package/dist/core/router/planner.js +113 -0
  72. package/dist/core/router/rules.d.ts +46 -0
  73. package/dist/core/router/rules.d.ts.map +1 -0
  74. package/dist/core/router/rules.js +91 -0
  75. package/dist/core/run-panel-api.d.ts +94 -0
  76. package/dist/core/run-panel-api.d.ts.map +1 -0
  77. package/dist/core/run-panel-api.js +169 -0
  78. package/dist/core/schedule-gate.js +5 -1
  79. package/dist/core/schedule-v2.d.ts +34 -0
  80. package/dist/core/schedule-v2.d.ts.map +1 -1
  81. package/dist/core/schedule-v2.js +91 -5
  82. package/dist/core/scheduler/at-fallback.d.ts +55 -2
  83. package/dist/core/scheduler/at-fallback.d.ts.map +1 -1
  84. package/dist/core/scheduler/at-fallback.js +135 -5
  85. package/dist/core/scheduler/linux.d.ts +18 -2
  86. package/dist/core/scheduler/linux.d.ts.map +1 -1
  87. package/dist/core/scheduler/linux.js +63 -20
  88. package/dist/core/scheduler/mac.d.ts +44 -2
  89. package/dist/core/scheduler/mac.d.ts.map +1 -1
  90. package/dist/core/scheduler/mac.js +126 -15
  91. package/dist/core/scheduler/posix.d.ts.map +1 -1
  92. package/dist/core/scheduler/posix.js +25 -1
  93. package/dist/core/scheduler/registry.d.ts +11 -0
  94. package/dist/core/scheduler/registry.d.ts.map +1 -1
  95. package/dist/core/scheduler/registry.js +83 -21
  96. package/dist/core/scheduler/run-now.d.ts +16 -0
  97. package/dist/core/scheduler/run-now.d.ts.map +1 -0
  98. package/dist/core/scheduler/run-now.js +28 -0
  99. package/dist/core/scheduler/windows.d.ts.map +1 -1
  100. package/dist/core/scheduler/windows.js +15 -12
  101. package/dist/core/secrets.d.ts.map +1 -1
  102. package/dist/core/secrets.js +125 -28
  103. package/dist/core/session.d.ts.map +1 -1
  104. package/dist/core/session.js +18 -11
  105. package/dist/core/structured-log.d.ts +7 -1
  106. package/dist/core/structured-log.d.ts.map +1 -1
  107. package/dist/core/task-name.d.ts +24 -0
  108. package/dist/core/task-name.d.ts.map +1 -0
  109. package/dist/core/task-name.js +40 -0
  110. package/dist/core/worktree-run.d.ts +4 -0
  111. package/dist/core/worktree-run.d.ts.map +1 -0
  112. package/dist/core/worktree-run.js +164 -0
  113. package/dist/core/worktree.d.ts +115 -0
  114. package/dist/core/worktree.d.ts.map +1 -0
  115. package/dist/core/worktree.js +462 -0
  116. package/dist/core/wrappers/bash.d.ts +17 -0
  117. package/dist/core/wrappers/bash.d.ts.map +1 -1
  118. package/dist/core/wrappers/bash.js +224 -28
  119. package/dist/db/capability-repo.d.ts +124 -0
  120. package/dist/db/capability-repo.d.ts.map +1 -0
  121. package/dist/db/capability-repo.js +267 -0
  122. package/dist/db/history-repo.d.ts +46 -5
  123. package/dist/db/history-repo.d.ts.map +1 -1
  124. package/dist/db/history-repo.js +107 -25
  125. package/dist/db/index.d.ts +4 -0
  126. package/dist/db/index.d.ts.map +1 -1
  127. package/dist/db/index.js +39 -1
  128. package/dist/db/metrics-repo.js +2 -2
  129. package/dist/db/migrate.d.ts.map +1 -1
  130. package/dist/db/migrate.js +3 -1
  131. package/dist/db/recovery.d.ts.map +1 -1
  132. package/dist/db/recovery.js +5 -4
  133. package/dist/db/run-context.d.ts +103 -0
  134. package/dist/db/run-context.d.ts.map +1 -0
  135. package/dist/db/run-context.js +224 -0
  136. package/dist/db/run-dlq.d.ts +100 -0
  137. package/dist/db/run-dlq.d.ts.map +1 -0
  138. package/dist/db/run-dlq.js +191 -0
  139. package/dist/db/run-journal.d.ts +33 -5
  140. package/dist/db/run-journal.d.ts.map +1 -1
  141. package/dist/db/run-journal.js +78 -14
  142. package/dist/db/run-resume.d.ts +10 -2
  143. package/dist/db/run-resume.d.ts.map +1 -1
  144. package/dist/db/run-resume.js +39 -13
  145. package/dist/db/runs-repo.d.ts +32 -7
  146. package/dist/db/runs-repo.d.ts.map +1 -1
  147. package/dist/db/runs-repo.js +50 -11
  148. package/dist/db/schema.d.ts +2 -2
  149. package/dist/db/schema.d.ts.map +1 -1
  150. package/dist/db/schema.js +216 -3
  151. package/dist/db/settings-repo.d.ts +11 -0
  152. package/dist/db/settings-repo.d.ts.map +1 -1
  153. package/dist/db/settings-repo.js +25 -0
  154. package/dist/db/step-idempotency.d.ts +51 -0
  155. package/dist/db/step-idempotency.d.ts.map +1 -0
  156. package/dist/db/step-idempotency.js +136 -0
  157. package/dist/history.d.ts +1 -1
  158. package/dist/history.d.ts.map +1 -1
  159. package/dist/i18n.d.ts +5 -0
  160. package/dist/i18n.d.ts.map +1 -1
  161. package/dist/i18n.js +11 -4
  162. package/dist/index.d.ts +140 -6
  163. package/dist/index.d.ts.map +1 -1
  164. package/dist/index.js +480 -18
  165. package/dist/notifications.d.ts +22 -0
  166. package/dist/notifications.d.ts.map +1 -1
  167. package/dist/notifications.js +36 -8
  168. package/dist/profiles.d.ts.map +1 -1
  169. package/dist/profiles.js +25 -4
  170. package/dist/rpc.d.ts +924 -0
  171. package/dist/rpc.d.ts.map +1 -1
  172. package/dist/rpc.js +352 -0
  173. package/dist/server.d.ts +46 -0
  174. package/dist/server.d.ts.map +1 -1
  175. package/dist/server.js +172 -53
  176. package/dist/settings.d.ts +2 -2
  177. package/dist/settings.d.ts.map +1 -1
  178. package/dist/settings.js +3 -3
  179. package/dist/shared/jobs-view.d.ts +1 -1
  180. package/dist/shared/jobs-view.d.ts.map +1 -1
  181. package/dist/shared/jobs-view.js +2 -0
  182. package/dist/task-transfer.d.ts +16 -0
  183. package/dist/task-transfer.d.ts.map +1 -1
  184. package/dist/task-transfer.js +16 -0
  185. package/dist/types.d.ts.map +1 -1
  186. package/dist/types.js +7 -0
  187. package/dist/workspaces.d.ts +25 -3
  188. package/dist/workspaces.d.ts.map +1 -1
  189. package/dist/workspaces.js +43 -8
  190. package/docs/ARCHITECTURE.md +498 -58
  191. package/docs/COMPATIBILITY.md +2 -2
  192. package/docs/CONCEPT.md +185 -91
  193. package/docs/CROSS_PLATFORM.ru.md +20 -0
  194. package/docs/CROSS_PLATFORM.zh.md +18 -0
  195. package/docs/EXECUTION-LOOP.md +211 -0
  196. package/docs/FEATURES.md +65 -4
  197. package/docs/FEATURES.zh.md +52 -4
  198. package/docs/MIGRATION.md +2 -2
  199. package/docs/PIPELINE.md +293 -0
  200. package/docs/README.ru.md +44 -5
  201. package/docs/README.zh.md +46 -6
  202. package/docs/SAFETY.md +142 -0
  203. package/docs/SAVINGS.md +29 -0
  204. package/docs/SAVINGS.ru.md +29 -0
  205. package/docs/SAVINGS.zh.md +18 -0
  206. package/gui-experimental.cjs +9 -8
  207. package/locales/en.json +84 -1
  208. package/locales/ru.json +84 -1
  209. package/locales/zh.json +84 -1
  210. package/opencode.pipeline.yaml +35 -0
  211. package/package.json +46 -2
  212. package/scripts/audit-bundle.mjs +215 -0
  213. package/scripts/test-home.mjs +83 -0
  214. package/src/cli.ts +412 -0
  215. package/src/core/dlq-api.ts +98 -0
  216. package/src/core/dry-run.ts +27 -3
  217. package/src/core/execution.ts +538 -0
  218. package/src/core/file-watcher.ts +2 -2
  219. package/src/core/gate-integrity.ts +160 -0
  220. package/src/core/git-trigger.ts +18 -5
  221. package/src/core/guard-run.ts +119 -0
  222. package/src/core/guard.ts +431 -0
  223. package/src/core/lock.ts +244 -30
  224. package/src/core/matrix.ts +95 -50
  225. package/src/core/mission.ts +485 -0
  226. package/src/core/native-notify.ts +1 -1
  227. package/src/core/one-shot.ts +36 -8
  228. package/src/core/opencode-cli.ts +103 -0
  229. package/src/core/opencode-models.ts +315 -0
  230. package/src/core/pipeline-apply.ts +158 -0
  231. package/src/core/pipeline-io.ts +79 -0
  232. package/src/core/pipeline-map.ts +264 -0
  233. package/src/core/pipeline-spec.ts +775 -0
  234. package/src/core/ps-wrapper.ts +274 -64
  235. package/src/core/record-history.ts +229 -104
  236. package/src/core/router/dispatch.ts +94 -0
  237. package/src/core/router/escalation.ts +129 -0
  238. package/src/core/router/planner.ts +166 -0
  239. package/src/core/router/rules.ts +115 -0
  240. package/src/core/run-panel-api.ts +262 -0
  241. package/src/core/schedule-gate.ts +7 -3
  242. package/src/core/schedule-v2.ts +114 -5
  243. package/src/core/scheduler/at-fallback.ts +190 -5
  244. package/src/core/scheduler/linux.ts +72 -21
  245. package/src/core/scheduler/logs.ts +2 -2
  246. package/src/core/scheduler/mac.ts +174 -14
  247. package/src/core/scheduler/posix.ts +20 -1
  248. package/src/core/scheduler/registry.ts +107 -26
  249. package/src/core/scheduler/run-now.ts +32 -0
  250. package/src/core/scheduler/windows.ts +19 -15
  251. package/src/core/secrets.ts +131 -31
  252. package/src/core/session.ts +23 -10
  253. package/src/core/structured-log.ts +22 -5
  254. package/src/core/task-name.ts +67 -0
  255. package/src/core/telegram.ts +2 -2
  256. package/src/core/triage-worker.ts +7 -7
  257. package/src/core/triage.ts +2 -2
  258. package/src/core/worktree-run.ts +199 -0
  259. package/src/core/worktree.ts +600 -0
  260. package/src/core/wrappers/bash.ts +239 -27
  261. package/src/db/capability-repo.ts +402 -0
  262. package/src/db/history-repo.ts +151 -22
  263. package/src/db/index.ts +37 -1
  264. package/src/db/metrics-repo.ts +2 -2
  265. package/src/db/migrate.ts +3 -1
  266. package/src/db/recovery.ts +5 -4
  267. package/src/db/run-context.ts +370 -0
  268. package/src/db/run-dlq.ts +310 -0
  269. package/src/db/run-journal.ts +100 -13
  270. package/src/db/run-resume.ts +65 -13
  271. package/src/db/runs-repo.ts +66 -13
  272. package/src/db/schema.ts +218 -3
  273. package/src/db/settings-repo.ts +31 -0
  274. package/src/db/step-idempotency.ts +185 -0
  275. package/src/gui.tsx +692 -13
  276. package/src/history.ts +1 -1
  277. package/src/i18n.ts +12 -4
  278. package/src/index.ts +648 -8
  279. package/src/notifications.ts +38 -8
  280. package/src/profiles.ts +26 -4
  281. package/src/rpc.ts +379 -0
  282. package/src/server.ts +206 -54
  283. package/src/settings.ts +5 -5
  284. package/src/shared/jobs-view.ts +3 -1
  285. package/src/task-transfer.ts +31 -0
  286. package/src/types.ts +9 -0
  287. 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: unknown) {
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}`;
@@ -87,19 +89,27 @@ export class LinuxScheduler extends PosixSchedulerBase {
87
89
  maxBuffer: 10 * 1024 * 1024,
88
90
  });
89
91
  return stdout;
90
- } catch (err: any) {
91
- const stderr = String(err?.stderr ?? "");
92
+ } catch (err: unknown) {
93
+ const stderrRaw = (err as { stderr?: unknown } | undefined)?.stderr;
94
+ const stderr = typeof stderrRaw === "string" ? stderrRaw : String(stderrRaw ?? "");
92
95
  // "no crontab for user" — это нормальное состояние. Любую другую ошибку
93
96
  // (нет доступа, сбой crontab) нельзя превращать в пустой crontab: иначе
94
97
  // последующая запись затрёт пользовательские задания.
95
- if (/no crontab/i.test(stderr) || /no crontab/i.test(String(err?.message ?? ""))) {
98
+ if (/no crontab/i.test(stderr) || /no crontab/i.test(String((err as Error | undefined)?.message ?? ""))) {
96
99
  return "";
97
100
  }
98
- throw new Error(`Не удалось прочитать crontab: ${stderr.trim() || err?.message || err}`);
101
+ throw new Error(`Не удалось прочитать crontab: ${stderr.trim() || (err as Error | undefined)?.message || String(err)}`);
99
102
  }
100
103
  }
101
104
 
102
- /** Убирает управляемый блок плагина из текста crontab. */
105
+ /**
106
+ * Убирает управляемый блок плагина из текста crontab.
107
+ *
108
+ * B9: удаляются только строки между парными маркерами. Незакрытый блок
109
+ * (маркер начала без конца) — fail-closed: бросаем ошибку, чтобы вызывающий
110
+ * не записал crontab и пользовательские задания после маркера не пропали.
111
+ * Строки вне маркеров сохраняются байт-в-байт, включая пустые.
112
+ */
103
113
  private stripBlock(content: string): string {
104
114
  // Совместимость: до появления профилей блок назывался без суффикса.
105
115
  // Он принадлежит профилю default; другие профили его не трогают.
@@ -117,18 +127,36 @@ export class LinuxScheduler extends PosixSchedulerBase {
117
127
  const lines = content.split(/\r?\n/);
118
128
  const result: string[] = [];
119
129
  let inside = false;
120
- for (const line of lines) {
121
- if (isBegin(line.trim())) {
130
+ let openAt = 0;
131
+ for (let index = 0; index < lines.length; index += 1) {
132
+ const line = lines[index];
133
+ const trimmed = line.trim();
134
+ if (isBegin(trimmed)) {
135
+ if (inside) {
136
+ throw new Error(
137
+ `crontab: вложенный маркер начала блока на строке ${index + 1} ` +
138
+ `(предыдущий блок открыт на строке ${openAt}). Файл не изменён.`,
139
+ );
140
+ }
122
141
  inside = true;
142
+ openAt = index + 1;
123
143
  continue;
124
144
  }
125
- if (isEnd(line.trim())) {
145
+ if (inside && isEnd(trimmed)) {
126
146
  inside = false;
127
147
  continue;
128
148
  }
149
+ // Строки внутри блока удаляются; всё остальное (включая «сиротский»
150
+ // маркер конца) остаётся без изменений.
129
151
  if (!inside) result.push(line);
130
152
  }
131
- return result.join("\n").replace(/\n{3,}/g, "\n\n").trimEnd();
153
+ if (inside) {
154
+ throw new Error(
155
+ `crontab: незакрытый блок плагина с строки ${openAt} — ` +
156
+ "маркер конца не найден. Файл не изменён.",
157
+ );
158
+ }
159
+ return result.join("\n");
132
160
  }
133
161
 
134
162
  /** Записывает crontab через stdin: `crontab -`. */
@@ -163,7 +191,10 @@ export class LinuxScheduler extends PosixSchedulerBase {
163
191
  async () => {
164
192
  const entries = await this.registry.load();
165
193
  const current = await this.readCrontab();
166
- const base = this.stripBlock(current);
194
+ // B9: stripBlock сохраняет содержимое вне маркеров. Отрезаем только
195
+ // хвостовые переводы строк, чтобы повторные rebuild не копили пустые
196
+ // строки; одна финальная добавляется ниже.
197
+ const base = this.stripBlock(current).replace(/\n+$/, "");
167
198
  const block = this.renderBlock(entries);
168
199
 
169
200
  // Пустой блок (нет задач) не пишем, чтобы не оставлять мусор в crontab.
@@ -171,16 +202,19 @@ export class LinuxScheduler extends PosixSchedulerBase {
171
202
  .split("\n")
172
203
  .some((line) => line.trim().startsWith("# task:"));
173
204
  const next = [base, hasTasks ? block : ""].filter(Boolean).join("\n");
174
- await this.writeCrontab(next);
205
+ await this.writeCrontab(next ? `${next}\n` : "");
175
206
  },
176
207
  { timeoutMs: 15000, staleMs: 60000 },
177
208
  );
178
209
  }
179
210
 
180
- /** Строка команды one-shot для stdin `at`. */
211
+ /** Строка команды one-shot для stdin `at`.
212
+ * P1-7.T1.3: без `-c` bash трактует аргумент как ИМЯ ФАЙЛА скрипта
213
+ * (exit 127 «No such file or directory»), поэтому at «выполнял» задание,
214
+ * но команда на самом деле не запускалась. */
181
215
  private atCommand(entry: RegistryEntry): string {
182
216
  const log = entry.logFile ? ` >> ${shellQuote(entry.logFile)} 2>&1` : "";
183
- return `/bin/bash ${shellQuote(entry.command)}${log}`;
217
+ return `/bin/bash -c ${shellQuote(entry.command)}${log}`;
184
218
  }
185
219
 
186
220
  /**
@@ -263,7 +297,8 @@ export class LinuxScheduler extends PosixSchedulerBase {
263
297
  if (!entry.atJobId) return;
264
298
  if (isPidJobId(entry.atJobId)) {
265
299
  // P1-7.T1.2: снимаем fallback-процесс, а не at-задание.
266
- cancelAtFallback(entry.atJobId);
300
+ // P1-14: передаём имя — без сверки маркера pid мог быть переиспользован.
301
+ cancelAtFallback(entry.atJobId, entry.name);
267
302
  delete entry.atJobId;
268
303
  return;
269
304
  }
@@ -275,6 +310,14 @@ export class LinuxScheduler extends PosixSchedulerBase {
275
310
  delete entry.atJobId;
276
311
  }
277
312
 
313
+ /**
314
+ * P1-14: чистит `pid:`-записи fallback'а, пережившие перезагрузку.
315
+ * Вызывается из старта плагина; на других платформах не используется.
316
+ */
317
+ async pruneStaleFallbacks(): Promise<PruneAtFallbackReport> {
318
+ return pruneStaleFallbackEntries(this.registry);
319
+ }
320
+
278
321
  protected async installEntry(entry: RegistryEntry): Promise<void> {
279
322
  if (entry.triggerType === "once") {
280
323
  if (!entry.paused) {
@@ -294,11 +337,19 @@ export class LinuxScheduler extends PosixSchedulerBase {
294
337
  }
295
338
 
296
339
  protected async applyPause(entry: RegistryEntry, paused: boolean): Promise<void> {
340
+ // P1-12: entry получен из find() ДО setPaused(), поэтому без этой строки
341
+ // upsert ниже возвращал в реестр paused:false, и listTasks() показывал
342
+ // приостановленную one-shot задачу как Ready.
343
+ entry.paused = paused;
297
344
  if (entry.triggerType === "once") {
298
345
  if (paused) {
299
346
  await this.cancelAt(entry);
300
347
  } else if (entry.runAt && Date.parse(entry.runAt) > Date.now()) {
301
348
  entry.atJobId = await this.scheduleAt(entry);
349
+ } else {
350
+ console.warn(
351
+ `[scheduler] Задача "${entry.name}" не будет перезапущена: время one-shot запуска уже прошло (${entry.runAt ?? "runAt не задан"}). Создайте новую задачу.`,
352
+ );
302
353
  }
303
354
  await this.registry.upsert(entry);
304
355
  return;
@@ -25,8 +25,8 @@ export async function getTaskLogs(
25
25
  }
26
26
  const last = lines.slice(-Math.max(1, Math.min(limit, 1000)));
27
27
  return { logs: last.join("\n") };
28
- } catch (err: any) {
29
- if (err.code === "ENOENT") {
28
+ } catch (err: unknown) {
29
+ if ((err as NodeJS.ErrnoException).code === "ENOENT") {
30
30
  return {
31
31
  logs: "",
32
32
  error: `Лог задачи "${name}" не найден по пути ${logPath} (задача ещё не запускалась).`,