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
@@ -1 +1 @@
1
- {"version":3,"file":"schedule-v2.d.ts","sourceRoot":"","sources":["../../src/core/schedule-v2.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"schedule-v2.d.ts","sourceRoot":"","sources":["../../src/core/schedule-v2.ts"],"names":[],"mappings":"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"}
@@ -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 и обращения к ОС.
@@ -171,6 +173,15 @@ function expandField(token, min, max, names) {
171
173
  result.add(v);
172
174
  continue;
173
175
  }
176
+ if (stepMatch) {
177
+ // Шаг для одиночного значения Vixie-совместимый cron не поддерживает:
178
+ // раньше «5/15» молча превращалось в «только минута 5». Лучше явная
179
+ // ошибка, чем тихо другая семантика.
180
+ throw new Error(t("schedule.error.cronStepNeedsRange", {
181
+ raw,
182
+ step: stepMatch[2],
183
+ }));
184
+ }
174
185
  const num = Number(item);
175
186
  if (!Number.isInteger(num) || num < min || num > max) {
176
187
  throw new Error(t("schedule.error.cronValueBounds", { raw, min, max }));
@@ -532,6 +543,54 @@ export function nextWindowOpenDelayMs(now, options = {}) {
532
543
  return 0;
533
544
  return state.nextOpenAt ? Math.max(0, state.nextOpenAt.getTime() - now.getTime()) : 0;
534
545
  }
546
+ /** Человекочитаемая причина недостижимости окна (P2-24). */
547
+ export function windowFeasibilityReasonText(reason) {
548
+ switch (reason) {
549
+ case "never-fires":
550
+ return t("dryRun.window.reason.neverFires");
551
+ case "never-in-window":
552
+ return t("dryRun.window.reason.neverInWindow");
553
+ case "postpone-too-far":
554
+ return t("dryRun.window.reason.postponeTooFar");
555
+ default:
556
+ return "";
557
+ }
558
+ }
559
+ /**
560
+ * P2-24: проверяет, не окажется ли cron навсегда отрезан окном запуска.
561
+ *
562
+ * `schedule-gate` откладывает запуск максимум на 12 ч. Если cron срабатывает
563
+ * только в 09:00, а окно 22:00–06:00, то до открытия всегда ~13 ч → каждый тик
564
+ * молча пропускается. Здесь это выявляется заранее (для предупреждения при
565
+ * создании задачи и в dry_run).
566
+ */
567
+ export function assessCronWindowFeasibility(expr, options = {}, policy = "postpone", from = new Date(), maxPostponeMs = 12 * 60 * 60 * 1000, maxOccurrences = 120) {
568
+ if (policy === "run")
569
+ return { feasible: true, checked: 0 };
570
+ let cursor = from;
571
+ for (let i = 0; i < maxOccurrences; i += 1) {
572
+ const at = nextRun(expr, cursor, options.timeZone);
573
+ if (!at) {
574
+ return { feasible: false, checked: i, reason: "never-fires" };
575
+ }
576
+ const state = activeWindowState(at, options);
577
+ if (state.active) {
578
+ return { feasible: true, checked: i + 1, firstRun: at.toISOString() };
579
+ }
580
+ if (policy === "postpone" && state.nextOpenAt) {
581
+ const waitMs = state.nextOpenAt.getTime() - at.getTime();
582
+ if (waitMs <= maxPostponeMs) {
583
+ return { feasible: true, checked: i + 1, firstRun: at.toISOString() };
584
+ }
585
+ }
586
+ cursor = at;
587
+ }
588
+ return {
589
+ feasible: false,
590
+ checked: maxOccurrences,
591
+ reason: policy === "skip" ? "never-in-window" : "postpone-too-far",
592
+ };
593
+ }
535
594
  // ---------------------------------------------------------------------------
536
595
  // Проверка совместимости с schtasks (родной режим).
537
596
  /**
@@ -552,6 +611,22 @@ export function isNativeSchtasksExpr(expr) {
552
611
  export function convertForSchtasks(expr) {
553
612
  return convertCronToSchTasks(normalizeCron(expr));
554
613
  }
614
+ /**
615
+ * true, если выражение можно записать в crontab как есть (Vixie-совместимый
616
+ * 5-полевой cron). В отличие от schtasks, crontab понимает списки, диапазоны,
617
+ * шаги и имена месяцев/дней недели — их не нужно загонять в минутный опрос.
618
+ * Quartz-расширения `L` / `d#n` и макросы вроде `@daily` (не 5 полей) crontab
619
+ * не понимает: для них нужен poll-режим с gate во враппере.
620
+ */
621
+ export function isNativePosixCronExpr(expr) {
622
+ try {
623
+ const spec = parseCron(expr);
624
+ return !spec.lastDom && spec.nthWeekday.length === 0;
625
+ }
626
+ catch {
627
+ return false;
628
+ }
629
+ }
555
630
  /**
556
631
  * true, если ОС-триггер не выражает расписание (чужой IANA-таймзона или
557
632
  * не конвертируемо в флаги schtasks) — нужен минутный опрос + gate.
@@ -562,6 +637,17 @@ export function needsPollMode(expr, timezone) {
562
637
  return true;
563
638
  return !isNativeSchtasksExpr(expr);
564
639
  }
640
+ /**
641
+ * Аналог needsPollMode для POSIX-бэков (crontab): чужой IANA-таймзона или
642
+ * не-Vixie-синтаксис заставляет опрашивать каждую минуту, остальное crontab
643
+ * выполняет сам. Списки/диапазоны/шаги/имена здесь родные.
644
+ */
645
+ export function needsPosixPollMode(expr, timezone) {
646
+ const tz = (timezone || "").trim();
647
+ if (tz && tz !== systemTimeZone())
648
+ return true;
649
+ return !isNativePosixCronExpr(expr);
650
+ }
565
651
  /**
566
652
  * Аргументы schedule-gate для враппера, либо undefined — если врапперу гейт
567
653
  * не нужен (нативный cron + системный таймзона + окно не задано).
@@ -24,19 +24,72 @@ export interface ScheduleAtFallbackDeps {
24
24
  spawnFn?: DetachedOneShotSpawnFn;
25
25
  now?: () => number;
26
26
  }
27
+ export interface CancelAtFallbackDeps {
28
+ isAlive?: (pid: number, taskName: string) => boolean;
29
+ kill?: (pid: number, signal: NodeJS.Signals) => void;
30
+ }
31
+ export interface PruneAtFallbackDeps {
32
+ now?: () => number;
33
+ isAlive?: (pid: number, taskName: string) => boolean;
34
+ schedule?: (entry: RegistryEntry, command: string, nowMs: number) => Promise<string>;
35
+ warn?: (message: string) => void;
36
+ }
37
+ export interface PruneAtFallbackReport {
38
+ kept: number;
39
+ removed: number;
40
+ rescheduled: number;
41
+ missed: number;
42
+ skipped: boolean;
43
+ }
44
+ /** Минимальный интерфейс реестра — чтобы prune можно было тестировать без FS. */
45
+ export interface FallbackRegistry {
46
+ load(): Promise<RegistryEntry[]>;
47
+ save(entries: RegistryEntry[]): Promise<void>;
48
+ }
27
49
  /** Ошибка `spawn("at")`, означающая, что бинарник не найден. */
28
50
  export declare function isAtMissingError(err: unknown): boolean;
29
51
  /** Сколько секунд осталось до `runAt` (0, если момент уже прошёл). */
30
52
  export declare function computeDelaySeconds(runAt: string, nowMs: number): number;
53
+ /**
54
+ * Маркер fallback-процесса конкретной задачи.
55
+ *
56
+ * Лежит в командной строке (`/proc/<pid>/cmdline`), поэтому позволяет
57
+ * проверить, что pid всё ещё принадлежит нашей задаче, а не переиспользован
58
+ * другим процессом после перезагрузки/завершения.
59
+ */
60
+ export declare function fallbackMarker(taskName: string): string;
31
61
  /** Скрипт для `/bin/bash -c`: подождать и выполнить команду задачи. */
32
62
  export declare function buildDetachedOneShotScript(entry: RegistryEntry, command: string, nowMs: number): string;
33
63
  /** Является ли сохранённый id задания pid-ом fallback-процесса. */
34
64
  export declare function isPidJobId(jobId: string | undefined): boolean;
65
+ /** Читает командную строку процесса из /proc; null, если процесс недоступен. */
66
+ export declare function readProcessCmdline(pid: number): string | null;
67
+ /**
68
+ * Живой ли это fallback-процесс именно этой задачи.
69
+ *
70
+ * Без проверки маркера `pid:` из персистентного реестра после перезагрузки
71
+ * может указывать на совершенно другой процесс.
72
+ */
73
+ export declare function isFallbackProcessAlive(pid: number, taskName: string): boolean;
35
74
  /**
36
75
  * Запускает отвязанный one-shot и возвращает `pid:<pid>` для `cancelAt`.
37
76
  * Промис резолвится сразу после успешного `spawn`, не дожидаясь выполнения.
38
77
  */
39
78
  export declare function scheduleAtFallback(entry: RegistryEntry, command: string, deps?: ScheduleAtFallbackDeps): Promise<string>;
40
- /** Снимает fallback-процесс. Ошибки (процесс уже завершился) игнорируются. */
41
- export declare function cancelAtFallback(jobId: string): boolean;
79
+ /**
80
+ * Снимает fallback-процесс.
81
+ *
82
+ * Требует имя задачи и сверяет маркер в `/proc/<pid>/cmdline`: голый pid из
83
+ * реестра после перезагрузки может принадлежать чужому процессу. Убивает
84
+ * группу процессов (fallback запущен detached и является её лидером).
85
+ */
86
+ export declare function cancelAtFallback(jobId: string, taskName?: string, deps?: CancelAtFallbackDeps): boolean;
87
+ /**
88
+ * Чистит `pid:`-записи, пережившие перезагрузку.
89
+ *
90
+ * Вызывается один раз при старте плагина. Живые процессы с совпадающим
91
+ * маркером сохраняются; мёртвые — удаляются. Будущие one-shot пересоздаются,
92
+ * прошедшие — помечаются пропущенными с предупреждением.
93
+ */
94
+ export declare function pruneStaleFallbackEntries(registry: FallbackRegistry, deps?: PruneAtFallbackDeps): Promise<PruneAtFallbackReport>;
42
95
  //# sourceMappingURL=at-fallback.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"at-fallback.d.ts","sourceRoot":"","sources":["../../../src/core/scheduler/at-fallback.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAEnD;;;;;;;;;;GAUG;AAEH,MAAM,WAAW,oBAAoB;IACnC,IAAI,CAAC,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,CAAC,GAAG,EAAE,KAAK,KAAK,IAAI,GAAG,OAAO,CAAC;IAC9D,IAAI,CAAC,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,IAAI,GAAG,OAAO,CAAC;IACpD,KAAK,IAAI,OAAO,CAAC;IACjB,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,MAAM,MAAM,sBAAsB,GAAG,CACnC,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EAAE,EACd,OAAO,EAAE;IAAE,QAAQ,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,QAAQ,CAAA;CAAE,KAC5C,oBAAoB,CAAC;AAE1B,MAAM,WAAW,sBAAsB;IACrC,OAAO,CAAC,EAAE,sBAAsB,CAAC;IACjC,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;CACpB;AAID,gEAAgE;AAChE,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAMtD;AAED,sEAAsE;AACtE,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAMxE;AAED,uEAAuE;AACvE,wBAAgB,0BAA0B,CACxC,KAAK,EAAE,aAAa,EACpB,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,MAAM,GACZ,MAAM,CAMR;AAED,mEAAmE;AACnE,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAE7D;AAMD;;;GAGG;AACH,wBAAsB,kBAAkB,CACtC,KAAK,EAAE,aAAa,EACpB,OAAO,EAAE,MAAM,EACf,IAAI,GAAE,sBAA2B,GAChC,OAAO,CAAC,MAAM,CAAC,CAgBjB;AAED,8EAA8E;AAC9E,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAUvD"}
1
+ {"version":3,"file":"at-fallback.d.ts","sourceRoot":"","sources":["../../../src/core/scheduler/at-fallback.ts"],"names":[],"mappings":"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"}
@@ -1,5 +1,8 @@
1
1
  import { spawn } from "node:child_process";
2
+ import fs from "node:fs";
3
+ import { shellQuote } from "./posix.js";
2
4
  const PID_JOB_PREFIX = "pid:";
5
+ const FALLBACK_MARKER_PREFIX = "opencode-scheduler-at-fallback:";
3
6
  /** Ошибка `spawn("at")`, означающая, что бинарник не найден. */
4
7
  export function isAtMissingError(err) {
5
8
  if (!err || typeof err !== "object")
@@ -18,13 +21,24 @@ export function computeDelaySeconds(runAt, nowMs) {
18
21
  }
19
22
  return Math.max(0, Math.ceil((target - nowMs) / 1000));
20
23
  }
24
+ /**
25
+ * Маркер fallback-процесса конкретной задачи.
26
+ *
27
+ * Лежит в командной строке (`/proc/<pid>/cmdline`), поэтому позволяет
28
+ * проверить, что pid всё ещё принадлежит нашей задаче, а не переиспользован
29
+ * другим процессом после перезагрузки/завершения.
30
+ */
31
+ export function fallbackMarker(taskName) {
32
+ return `${FALLBACK_MARKER_PREFIX}${Buffer.from(taskName, "utf8").toString("base64url")}`;
33
+ }
21
34
  /** Скрипт для `/bin/bash -c`: подождать и выполнить команду задачи. */
22
35
  export function buildDetachedOneShotScript(entry, command, nowMs) {
23
36
  if (!entry.runAt) {
24
37
  throw new Error(`Задача "${entry.name}": не задано runAt для one-shot.`);
25
38
  }
26
39
  const delay = computeDelaySeconds(entry.runAt, nowMs);
27
- return `sleep ${delay}; ${command}`;
40
+ // Маркер — обычный shell-комментарий в конце, поэтому на выполнение не влияет.
41
+ return `sleep ${delay}; ${command} # ${fallbackMarker(entry.name)}`;
28
42
  }
29
43
  /** Является ли сохранённый id задания pid-ом fallback-процесса. */
30
44
  export function isPidJobId(jobId) {
@@ -33,6 +47,39 @@ export function isPidJobId(jobId) {
33
47
  function pidFromJobId(jobId) {
34
48
  return Number.parseInt(jobId.slice(PID_JOB_PREFIX.length), 10);
35
49
  }
50
+ /** Читает командную строку процесса из /proc; null, если процесс недоступен. */
51
+ export function readProcessCmdline(pid) {
52
+ if (!Number.isFinite(pid) || pid <= 0)
53
+ return null;
54
+ try {
55
+ return fs
56
+ .readFileSync(`/proc/${pid}/cmdline`, "utf8")
57
+ .split("\0")
58
+ .join(" ")
59
+ .trim();
60
+ }
61
+ catch {
62
+ return null;
63
+ }
64
+ }
65
+ /**
66
+ * Живой ли это fallback-процесс именно этой задачи.
67
+ *
68
+ * Без проверки маркера `pid:` из персистентного реестра после перезагрузки
69
+ * может указывать на совершенно другой процесс.
70
+ */
71
+ export function isFallbackProcessAlive(pid, taskName) {
72
+ const cmdline = readProcessCmdline(pid);
73
+ return cmdline !== null && cmdline.includes(fallbackMarker(taskName));
74
+ }
75
+ function hasProcfs() {
76
+ try {
77
+ return fs.existsSync("/proc/self/cmdline");
78
+ }
79
+ catch {
80
+ return false;
81
+ }
82
+ }
36
83
  /**
37
84
  * Запускает отвязанный one-shot и возвращает `pid:<pid>` для `cancelAt`.
38
85
  * Промис резолвится сразу после успешного `spawn`, не дожидаясь выполнения.
@@ -53,18 +100,101 @@ export async function scheduleAtFallback(entry, command, deps = {}) {
53
100
  });
54
101
  });
55
102
  }
56
- /** Снимает fallback-процесс. Ошибки (процесс уже завершился) игнорируются. */
57
- export function cancelAtFallback(jobId) {
103
+ /**
104
+ * Снимает fallback-процесс.
105
+ *
106
+ * Требует имя задачи и сверяет маркер в `/proc/<pid>/cmdline`: голый pid из
107
+ * реестра после перезагрузки может принадлежать чужому процессу. Убивает
108
+ * группу процессов (fallback запущен detached и является её лидером).
109
+ */
110
+ export function cancelAtFallback(jobId, taskName, deps = {}) {
58
111
  if (!isPidJobId(jobId))
59
112
  return false;
60
113
  const pid = pidFromJobId(jobId);
61
114
  if (!Number.isFinite(pid) || pid <= 0)
62
115
  return false;
116
+ if (!taskName)
117
+ return false;
118
+ const isAlive = deps.isAlive ?? isFallbackProcessAlive;
119
+ if (!isAlive(pid, taskName))
120
+ return false;
121
+ const kill = deps.kill ??
122
+ ((target, signal) => process.kill(target, signal));
63
123
  try {
64
- process.kill(pid, "SIGTERM");
124
+ kill(-pid, "SIGTERM");
65
125
  return true;
66
126
  }
67
127
  catch {
68
- return false;
128
+ try {
129
+ kill(pid, "SIGTERM");
130
+ return true;
131
+ }
132
+ catch {
133
+ return false;
134
+ }
135
+ }
136
+ }
137
+ /** Команда, которую выполняет fallback: обёртка задачи + перенаправление лога. */
138
+ function buildFallbackCommand(entry) {
139
+ const log = entry.logFile ? ` >> ${shellQuote(entry.logFile)} 2>&1` : "";
140
+ return `/bin/bash ${shellQuote(entry.command)}${log}`;
141
+ }
142
+ /**
143
+ * Чистит `pid:`-записи, пережившие перезагрузку.
144
+ *
145
+ * Вызывается один раз при старте плагина. Живые процессы с совпадающим
146
+ * маркером сохраняются; мёртвые — удаляются. Будущие one-shot пересоздаются,
147
+ * прошедшие — помечаются пропущенными с предупреждением.
148
+ */
149
+ export async function pruneStaleFallbackEntries(registry, deps = {}) {
150
+ const nowMs = deps.now ? deps.now() : Date.now();
151
+ const isAlive = deps.isAlive ?? isFallbackProcessAlive;
152
+ const warn = deps.warn ?? ((message) => console.warn(message));
153
+ const schedule = deps.schedule ??
154
+ ((entry, command, at) => scheduleAtFallback(entry, command, { now: () => at }));
155
+ // В системах без /proc проверить личность pid нельзя. Без инъекции
156
+ // isAlive ничего не трогаем, чтобы не убить чужой процесс.
157
+ if (!deps.isAlive && !hasProcfs()) {
158
+ return { kept: 0, removed: 0, rescheduled: 0, missed: 0, skipped: true };
159
+ }
160
+ const entries = await registry.load();
161
+ const report = {
162
+ kept: 0,
163
+ removed: 0,
164
+ rescheduled: 0,
165
+ missed: 0,
166
+ skipped: false,
167
+ };
168
+ let changed = false;
169
+ for (const entry of entries) {
170
+ if (!isPidJobId(entry.atJobId))
171
+ continue;
172
+ const pid = pidFromJobId(entry.atJobId);
173
+ if (isAlive(pid, entry.name)) {
174
+ report.kept += 1;
175
+ continue;
176
+ }
177
+ delete entry.atJobId;
178
+ changed = true;
179
+ report.removed += 1;
180
+ if (entry.triggerType !== "once" || entry.paused)
181
+ continue;
182
+ const target = entry.runAt ? Date.parse(entry.runAt) : Number.NaN;
183
+ if (Number.isFinite(target) && target > nowMs) {
184
+ try {
185
+ entry.atJobId = await schedule(entry, buildFallbackCommand(entry), nowMs);
186
+ report.rescheduled += 1;
187
+ }
188
+ catch (err) {
189
+ warn(`[scheduler] Не удалось пересоздать fallback для "${entry.name}": ${err instanceof Error ? err.message : String(err)}`);
190
+ }
191
+ continue;
192
+ }
193
+ report.missed += 1;
194
+ warn(`[scheduler] One-shot "${entry.name}" не будет запущена: fallback-процесс потерян, ` +
195
+ `время запуска уже прошло (${entry.runAt ?? "runAt не задан"}).`);
69
196
  }
197
+ if (changed)
198
+ await registry.save(entries);
199
+ return report;
70
200
  }
@@ -1,3 +1,4 @@
1
+ import { type PruneAtFallbackReport } from "./at-fallback.js";
1
2
  import { PosixSchedulerBase } from "./posix.js";
2
3
  import type { RegistryEntry } from "./registry.js";
3
4
  /**
@@ -24,13 +25,23 @@ export declare class LinuxScheduler extends PosixSchedulerBase {
24
25
  private renderBlock;
25
26
  /** Читает текущий crontab (пустая строка, если crontab ещё не создан). */
26
27
  private readCrontab;
27
- /** Убирает управляемый блок плагина из текста crontab. */
28
+ /**
29
+ * Убирает управляемый блок плагина из текста crontab.
30
+ *
31
+ * B9: удаляются только строки между парными маркерами. Незакрытый блок
32
+ * (маркер начала без конца) — fail-closed: бросаем ошибку, чтобы вызывающий
33
+ * не записал crontab и пользовательские задания после маркера не пропали.
34
+ * Строки вне маркеров сохраняются байт-в-байт, включая пустые.
35
+ */
28
36
  private stripBlock;
29
37
  /** Записывает crontab через stdin: `crontab -`. */
30
38
  private writeCrontab;
31
39
  /** Перегенерирует блок плагина из реестра. */
32
40
  private rebuildCrontab;
33
- /** Строка команды one-shot для stdin `at`. */
41
+ /** Строка команды one-shot для stdin `at`.
42
+ * P1-7.T1.3: без `-c` bash трактует аргумент как ИМЯ ФАЙЛА скрипта
43
+ * (exit 127 «No such file or directory»), поэтому at «выполнял» задание,
44
+ * но команда на самом деле не запускалась. */
34
45
  private atCommand;
35
46
  /**
36
47
  * Ставит one-shot в `at` и возвращает id задания.
@@ -39,6 +50,11 @@ export declare class LinuxScheduler extends PosixSchedulerBase {
39
50
  private scheduleAt;
40
51
  /** Отменяет задание at, если оно ещё существует. */
41
52
  private cancelAt;
53
+ /**
54
+ * P1-14: чистит `pid:`-записи fallback'а, пережившие перезагрузку.
55
+ * Вызывается из старта плагина; на других платформах не используется.
56
+ */
57
+ pruneStaleFallbacks(): Promise<PruneAtFallbackReport>;
42
58
  protected installEntry(entry: RegistryEntry): Promise<void>;
43
59
  protected uninstallEntry(entry: RegistryEntry): Promise<void>;
44
60
  protected applyPause(entry: RegistryEntry, paused: boolean): Promise<void>;
@@ -1 +1 @@
1
- {"version":3,"file":"linux.d.ts","sourceRoot":"","sources":["../../../src/core/scheduler/linux.ts"],"names":[],"mappings":"AAcA,OAAO,EAAE,kBAAkB,EAAc,MAAM,YAAY,CAAC;AAC5D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAInD;;;;;;;;;;GAUG;AACH,qBAAa,cAAe,SAAQ,kBAAkB;IACpD,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC,QAAQ,CAAW;IAC7C,QAAQ,CAAC,KAAK,8BAA8B;IAE5C,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAClC,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAS;IAC1C,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAS;IACxC,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAU;gBAE9B,OAAO,GAAE,MAAyB;IAY9C,OAAO,CAAC,QAAQ;IAkBhB,OAAO,CAAC,WAAW;IAYnB,0EAA0E;YAC5D,WAAW;IAkBzB,0DAA0D;IAC1D,OAAO,CAAC,UAAU;IA+BlB,mDAAmD;YACrC,YAAY;IAgB1B,8CAA8C;YAChC,cAAc;IA4B5B,8CAA8C;IAC9C,OAAO,CAAC,SAAS;IAKjB;;;OAGG;YACW,UAAU;IAuExB,oDAAoD;YACtC,QAAQ;cAgBN,YAAY,CAAC,KAAK,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC;cAUjD,cAAc,CAAC,KAAK,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC;cAQnD,UAAU,CAAC,KAAK,EAAE,aAAa,EAAE,MAAM,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;CAYjF"}
1
+ {"version":3,"file":"linux.d.ts","sourceRoot":"","sources":["../../../src/core/scheduler/linux.ts"],"names":[],"mappings":"AAIA,OAAO,EAML,KAAK,qBAAqB,EAC3B,MAAM,kBAAkB,CAAC;AAK1B,OAAO,EAAE,kBAAkB,EAAc,MAAM,YAAY,CAAC;AAC5D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAInD;;;;;;;;;;GAUG;AACH,qBAAa,cAAe,SAAQ,kBAAkB;IACpD,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC,QAAQ,CAAW;IAC7C,QAAQ,CAAC,KAAK,8BAA8B;IAE5C,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAClC,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAS;IAC1C,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAS;IACxC,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAU;gBAE9B,OAAO,GAAE,MAAyB;IAY9C,OAAO,CAAC,QAAQ;IAkBhB,OAAO,CAAC,WAAW;IAYnB,0EAA0E;YAC5D,WAAW;IAmBzB;;;;;;;OAOG;IACH,OAAO,CAAC,UAAU;IAiDlB,mDAAmD;YACrC,YAAY;IAgB1B,8CAA8C;YAChC,cAAc;IA+B5B;;;mDAG+C;IAC/C,OAAO,CAAC,SAAS;IAKjB;;;OAGG;YACW,UAAU;IAuExB,oDAAoD;YACtC,QAAQ;IAiBtB;;;OAGG;IACG,mBAAmB,IAAI,OAAO,CAAC,qBAAqB,CAAC;cAI3C,YAAY,CAAC,KAAK,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC;cAUjD,cAAc,CAAC,KAAK,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC;cAQnD,UAAU,CAAC,KAAK,EAAE,aAAa,EAAE,MAAM,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;CAoBjF"}
@@ -2,8 +2,8 @@ import { execFile, spawn } from "node:child_process";
2
2
  import path from "node:path";
3
3
  import { promisify } from "node:util";
4
4
  import { buildAtTimestamp } from "../one-shot.js";
5
- import { cancelAtFallback, isAtMissingError, isPidJobId, scheduleAtFallback, } from "./at-fallback.js";
6
- import { needsPollMode } from "../schedule-v2.js";
5
+ import { cancelAtFallback, isAtMissingError, isPidJobId, pruneStaleFallbackEntries, scheduleAtFallback, } from "./at-fallback.js";
6
+ import { needsPosixPollMode } from "../schedule-v2.js";
7
7
  import { LockManager, withLockWait } from "../lock.js";
8
8
  import { getBasePluginDir, getProfileName } from "../../profiles.js";
9
9
  import { taskFolderNameForProfile, legacyTaskFolderNameForProfile } from "../../types.js";
@@ -41,12 +41,12 @@ export class LinuxScheduler extends PosixSchedulerBase {
41
41
  }
42
42
  const log = entry.logFile ? ` >> ${shellQuote(entry.logFile)} 2>&1` : "";
43
43
  const cmd = `/bin/bash ${shellQuote(entry.command)}${log}`;
44
- // crontab понимает только 5-полевой cron. Расширенные выражения (L, #,
45
- // списки, @daily и т.п.) нельзя писать в crontab как есть — опрашиваем
46
- // каждую минуту, а решение о запуске принимает gate во враппере.
47
- // Задачи с чужой IANA-таймзоной (не системной) тоже уходят в poll-режим,
48
- // иначе crontab сработает по системному времени, а не по таймзоне задачи.
49
- const schedule = needsPollMode(entry.schedule, entry.timezone)
44
+ // Vixie-совместимый 5-полевой cron crontab выполняет сам: списки,
45
+ // диапазоны, шаги и имена месяцев/дней недели писать как есть можно.
46
+ // Quartz-расширения (L, d#n) и @-макросы (не 5 полей) crontab не понимает —
47
+ // для них "* * * * *" + gate во враппере. Чужая IANA-таймзона тоже уходит
48
+ // в poll: иначе crontab сработает по системному времени задачи.
49
+ const schedule = needsPosixPollMode(entry.schedule, entry.timezone)
50
50
  ? "* * * * *"
51
51
  : entry.schedule;
52
52
  return `${schedule} ${cmd}`;
@@ -72,17 +72,25 @@ export class LinuxScheduler extends PosixSchedulerBase {
72
72
  return stdout;
73
73
  }
74
74
  catch (err) {
75
- const stderr = String(err?.stderr ?? "");
75
+ const stderrRaw = err?.stderr;
76
+ const stderr = typeof stderrRaw === "string" ? stderrRaw : String(stderrRaw ?? "");
76
77
  // "no crontab for user" — это нормальное состояние. Любую другую ошибку
77
78
  // (нет доступа, сбой crontab) нельзя превращать в пустой crontab: иначе
78
79
  // последующая запись затрёт пользовательские задания.
79
80
  if (/no crontab/i.test(stderr) || /no crontab/i.test(String(err?.message ?? ""))) {
80
81
  return "";
81
82
  }
82
- throw new Error(`Не удалось прочитать crontab: ${stderr.trim() || err?.message || err}`);
83
+ throw new Error(`Не удалось прочитать crontab: ${stderr.trim() || err?.message || String(err)}`);
83
84
  }
84
85
  }
85
- /** Убирает управляемый блок плагина из текста crontab. */
86
+ /**
87
+ * Убирает управляемый блок плагина из текста crontab.
88
+ *
89
+ * B9: удаляются только строки между парными маркерами. Незакрытый блок
90
+ * (маркер начала без конца) — fail-closed: бросаем ошибку, чтобы вызывающий
91
+ * не записал crontab и пользовательские задания после маркера не пропали.
92
+ * Строки вне маркеров сохраняются байт-в-байт, включая пустые.
93
+ */
86
94
  stripBlock(content) {
87
95
  // Совместимость: до появления профилей блок назывался без суффикса.
88
96
  // Он принадлежит профилю default; другие профили его не трогают.
@@ -98,19 +106,33 @@ export class LinuxScheduler extends PosixSchedulerBase {
98
106
  const lines = content.split(/\r?\n/);
99
107
  const result = [];
100
108
  let inside = false;
101
- for (const line of lines) {
102
- if (isBegin(line.trim())) {
109
+ let openAt = 0;
110
+ for (let index = 0; index < lines.length; index += 1) {
111
+ const line = lines[index];
112
+ const trimmed = line.trim();
113
+ if (isBegin(trimmed)) {
114
+ if (inside) {
115
+ throw new Error(`crontab: вложенный маркер начала блока на строке ${index + 1} ` +
116
+ `(предыдущий блок открыт на строке ${openAt}). Файл не изменён.`);
117
+ }
103
118
  inside = true;
119
+ openAt = index + 1;
104
120
  continue;
105
121
  }
106
- if (isEnd(line.trim())) {
122
+ if (inside && isEnd(trimmed)) {
107
123
  inside = false;
108
124
  continue;
109
125
  }
126
+ // Строки внутри блока удаляются; всё остальное (включая «сиротский»
127
+ // маркер конца) остаётся без изменений.
110
128
  if (!inside)
111
129
  result.push(line);
112
130
  }
113
- return result.join("\n").replace(/\n{3,}/g, "\n\n").trimEnd();
131
+ if (inside) {
132
+ throw new Error(`crontab: незакрытый блок плагина с строки ${openAt} — ` +
133
+ "маркер конца не найден. Файл не изменён.");
134
+ }
135
+ return result.join("\n");
114
136
  }
115
137
  /** Записывает crontab через stdin: `crontab -`. */
116
138
  async writeCrontab(content) {
@@ -140,20 +162,26 @@ export class LinuxScheduler extends PosixSchedulerBase {
140
162
  await withLockWait(crontabLock, "crontab", async () => {
141
163
  const entries = await this.registry.load();
142
164
  const current = await this.readCrontab();
143
- const base = this.stripBlock(current);
165
+ // B9: stripBlock сохраняет содержимое вне маркеров. Отрезаем только
166
+ // хвостовые переводы строк, чтобы повторные rebuild не копили пустые
167
+ // строки; одна финальная добавляется ниже.
168
+ const base = this.stripBlock(current).replace(/\n+$/, "");
144
169
  const block = this.renderBlock(entries);
145
170
  // Пустой блок (нет задач) не пишем, чтобы не оставлять мусор в crontab.
146
171
  const hasTasks = block
147
172
  .split("\n")
148
173
  .some((line) => line.trim().startsWith("# task:"));
149
174
  const next = [base, hasTasks ? block : ""].filter(Boolean).join("\n");
150
- await this.writeCrontab(next);
175
+ await this.writeCrontab(next ? `${next}\n` : "");
151
176
  }, { timeoutMs: 15000, staleMs: 60000 });
152
177
  }
153
- /** Строка команды one-shot для stdin `at`. */
178
+ /** Строка команды one-shot для stdin `at`.
179
+ * P1-7.T1.3: без `-c` bash трактует аргумент как ИМЯ ФАЙЛА скрипта
180
+ * (exit 127 «No such file or directory»), поэтому at «выполнял» задание,
181
+ * но команда на самом деле не запускалась. */
154
182
  atCommand(entry) {
155
183
  const log = entry.logFile ? ` >> ${shellQuote(entry.logFile)} 2>&1` : "";
156
- return `/bin/bash ${shellQuote(entry.command)}${log}`;
184
+ return `/bin/bash -c ${shellQuote(entry.command)}${log}`;
157
185
  }
158
186
  /**
159
187
  * Ставит one-shot в `at` и возвращает id задания.
@@ -217,7 +245,8 @@ export class LinuxScheduler extends PosixSchedulerBase {
217
245
  return;
218
246
  if (isPidJobId(entry.atJobId)) {
219
247
  // P1-7.T1.2: снимаем fallback-процесс, а не at-задание.
220
- cancelAtFallback(entry.atJobId);
248
+ // P1-14: передаём имя — без сверки маркера pid мог быть переиспользован.
249
+ cancelAtFallback(entry.atJobId, entry.name);
221
250
  delete entry.atJobId;
222
251
  return;
223
252
  }
@@ -229,6 +258,13 @@ export class LinuxScheduler extends PosixSchedulerBase {
229
258
  }
230
259
  delete entry.atJobId;
231
260
  }
261
+ /**
262
+ * P1-14: чистит `pid:`-записи fallback'а, пережившие перезагрузку.
263
+ * Вызывается из старта плагина; на других платформах не используется.
264
+ */
265
+ async pruneStaleFallbacks() {
266
+ return pruneStaleFallbackEntries(this.registry);
267
+ }
232
268
  async installEntry(entry) {
233
269
  if (entry.triggerType === "once") {
234
270
  if (!entry.paused) {
@@ -246,6 +282,10 @@ export class LinuxScheduler extends PosixSchedulerBase {
246
282
  await this.rebuildCrontab();
247
283
  }
248
284
  async applyPause(entry, paused) {
285
+ // P1-12: entry получен из find() ДО setPaused(), поэтому без этой строки
286
+ // upsert ниже возвращал в реестр paused:false, и listTasks() показывал
287
+ // приостановленную one-shot задачу как Ready.
288
+ entry.paused = paused;
249
289
  if (entry.triggerType === "once") {
250
290
  if (paused) {
251
291
  await this.cancelAt(entry);
@@ -253,6 +293,9 @@ export class LinuxScheduler extends PosixSchedulerBase {
253
293
  else if (entry.runAt && Date.parse(entry.runAt) > Date.now()) {
254
294
  entry.atJobId = await this.scheduleAt(entry);
255
295
  }
296
+ else {
297
+ console.warn(`[scheduler] Задача "${entry.name}" не будет перезапущена: время one-shot запуска уже прошло (${entry.runAt ?? "runAt не задан"}). Создайте новую задачу.`);
298
+ }
256
299
  await this.registry.upsert(entry);
257
300
  return;
258
301
  }