agent-steward 0.0.1 → 0.0.3

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 (345) hide show
  1. package/CHANGELOG.md +399 -0
  2. package/CROSS_PLATFORM.md +151 -0
  3. package/README.md +307 -15
  4. package/ROADMAP-STRATEGY.md +196 -0
  5. package/ROADMAP.md +184 -0
  6. package/dist/core/analytics.d.ts +132 -0
  7. package/dist/core/analytics.d.ts.map +1 -0
  8. package/dist/core/analytics.js +290 -0
  9. package/dist/core/audit.d.ts +96 -0
  10. package/dist/core/audit.d.ts.map +1 -0
  11. package/dist/core/audit.js +297 -0
  12. package/dist/core/cron-to-schtasks.d.ts +12 -0
  13. package/dist/core/cron-to-schtasks.d.ts.map +1 -0
  14. package/dist/core/cron-to-schtasks.js +175 -0
  15. package/dist/core/dry-run.d.ts +102 -0
  16. package/dist/core/dry-run.d.ts.map +1 -0
  17. package/dist/core/dry-run.js +447 -0
  18. package/dist/core/file-watcher.d.ts +31 -0
  19. package/dist/core/file-watcher.d.ts.map +1 -0
  20. package/dist/core/file-watcher.js +186 -0
  21. package/dist/core/git-trigger.d.ts +82 -0
  22. package/dist/core/git-trigger.d.ts.map +1 -0
  23. package/dist/core/git-trigger.js +312 -0
  24. package/dist/core/glob.d.ts +38 -0
  25. package/dist/core/glob.d.ts.map +1 -0
  26. package/dist/core/glob.js +233 -0
  27. package/dist/core/local-ai.d.ts +52 -0
  28. package/dist/core/local-ai.d.ts.map +1 -0
  29. package/dist/core/local-ai.js +119 -0
  30. package/dist/core/lock.d.ts +57 -0
  31. package/dist/core/lock.d.ts.map +1 -0
  32. package/dist/core/lock.js +193 -0
  33. package/dist/core/matrix.d.ts +167 -0
  34. package/dist/core/matrix.d.ts.map +1 -0
  35. package/dist/core/matrix.js +724 -0
  36. package/dist/core/native-notify.d.ts +36 -0
  37. package/dist/core/native-notify.d.ts.map +1 -0
  38. package/dist/core/native-notify.js +113 -0
  39. package/dist/core/one-shot.d.ts +90 -0
  40. package/dist/core/one-shot.d.ts.map +1 -0
  41. package/dist/core/one-shot.js +182 -0
  42. package/dist/core/otel.d.ts +4 -0
  43. package/dist/core/otel.d.ts.map +1 -0
  44. package/dist/core/otel.js +98 -0
  45. package/dist/core/permissions.d.ts +69 -0
  46. package/dist/core/permissions.d.ts.map +1 -0
  47. package/dist/core/permissions.js +143 -0
  48. package/dist/core/prometheus.d.ts +23 -0
  49. package/dist/core/prometheus.d.ts.map +1 -0
  50. package/dist/core/prometheus.js +146 -0
  51. package/dist/core/ps-wrapper.d.ts +73 -0
  52. package/dist/core/ps-wrapper.d.ts.map +1 -0
  53. package/dist/core/ps-wrapper.js +1091 -0
  54. package/dist/core/record-history.d.ts +25 -0
  55. package/dist/core/record-history.d.ts.map +1 -0
  56. package/dist/core/record-history.js +471 -0
  57. package/dist/core/retention.d.ts +29 -0
  58. package/dist/core/retention.d.ts.map +1 -0
  59. package/dist/core/retention.js +98 -0
  60. package/dist/core/savings.d.ts +70 -0
  61. package/dist/core/savings.d.ts.map +1 -0
  62. package/dist/core/savings.js +87 -0
  63. package/dist/core/schedule-gate.d.ts +2 -0
  64. package/dist/core/schedule-gate.d.ts.map +1 -0
  65. package/dist/core/schedule-gate.js +211 -0
  66. package/dist/core/schedule-v2.d.ts +116 -0
  67. package/dist/core/schedule-v2.d.ts.map +1 -0
  68. package/dist/core/schedule-v2.js +586 -0
  69. package/dist/core/scheduler/at-fallback.d.ts +42 -0
  70. package/dist/core/scheduler/at-fallback.d.ts.map +1 -0
  71. package/dist/core/scheduler/at-fallback.js +70 -0
  72. package/dist/core/scheduler/index.d.ts +32 -0
  73. package/dist/core/scheduler/index.d.ts.map +1 -0
  74. package/dist/core/scheduler/index.js +63 -0
  75. package/dist/core/scheduler/linux.d.ts +46 -0
  76. package/dist/core/scheduler/linux.d.ts.map +1 -0
  77. package/dist/core/scheduler/linux.js +261 -0
  78. package/dist/core/scheduler/logs.d.ts +11 -0
  79. package/dist/core/scheduler/logs.d.ts.map +1 -0
  80. package/dist/core/scheduler/logs.js +34 -0
  81. package/dist/core/scheduler/mac.d.ts +46 -0
  82. package/dist/core/scheduler/mac.d.ts.map +1 -0
  83. package/dist/core/scheduler/mac.js +256 -0
  84. package/dist/core/scheduler/posix.d.ts +40 -0
  85. package/dist/core/scheduler/posix.d.ts.map +1 -0
  86. package/dist/core/scheduler/posix.js +100 -0
  87. package/dist/core/scheduler/registry.d.ts +43 -0
  88. package/dist/core/scheduler/registry.d.ts.map +1 -0
  89. package/dist/core/scheduler/registry.js +57 -0
  90. package/dist/core/scheduler/types.d.ts +86 -0
  91. package/dist/core/scheduler/types.d.ts.map +1 -0
  92. package/dist/core/scheduler/types.js +1 -0
  93. package/dist/core/scheduler/windows.d.ts +112 -0
  94. package/dist/core/scheduler/windows.d.ts.map +1 -0
  95. package/dist/core/scheduler/windows.js +749 -0
  96. package/dist/core/secrets.d.ts +66 -0
  97. package/dist/core/secrets.d.ts.map +1 -0
  98. package/dist/core/secrets.js +433 -0
  99. package/dist/core/self-analysis.d.ts +117 -0
  100. package/dist/core/self-analysis.d.ts.map +1 -0
  101. package/dist/core/self-analysis.js +539 -0
  102. package/dist/core/session.d.ts +42 -0
  103. package/dist/core/session.d.ts.map +1 -0
  104. package/dist/core/session.js +134 -0
  105. package/dist/core/shutdown.d.ts +26 -0
  106. package/dist/core/shutdown.d.ts.map +1 -0
  107. package/dist/core/shutdown.js +49 -0
  108. package/dist/core/structured-log.d.ts +84 -0
  109. package/dist/core/structured-log.d.ts.map +1 -0
  110. package/dist/core/structured-log.js +146 -0
  111. package/dist/core/summary.d.ts +69 -0
  112. package/dist/core/summary.d.ts.map +1 -0
  113. package/dist/core/summary.js +250 -0
  114. package/dist/core/telegram.d.ts +55 -0
  115. package/dist/core/telegram.d.ts.map +1 -0
  116. package/dist/core/telegram.js +344 -0
  117. package/dist/core/triage-chain.d.ts +40 -0
  118. package/dist/core/triage-chain.d.ts.map +1 -0
  119. package/dist/core/triage-chain.js +80 -0
  120. package/dist/core/triage-compare.d.ts +68 -0
  121. package/dist/core/triage-compare.d.ts.map +1 -0
  122. package/dist/core/triage-compare.js +184 -0
  123. package/dist/core/triage-rules.d.ts +23 -0
  124. package/dist/core/triage-rules.d.ts.map +1 -0
  125. package/dist/core/triage-rules.js +196 -0
  126. package/dist/core/triage-shadow.d.ts +91 -0
  127. package/dist/core/triage-shadow.d.ts.map +1 -0
  128. package/dist/core/triage-shadow.js +160 -0
  129. package/dist/core/triage-worker.d.ts +55 -0
  130. package/dist/core/triage-worker.d.ts.map +1 -0
  131. package/dist/core/triage-worker.js +314 -0
  132. package/dist/core/triage.d.ts +76 -0
  133. package/dist/core/triage.d.ts.map +1 -0
  134. package/dist/core/triage.js +271 -0
  135. package/dist/core/watch-paths.d.ts +6 -0
  136. package/dist/core/watch-paths.d.ts.map +1 -0
  137. package/dist/core/watch-paths.js +62 -0
  138. package/dist/core/wrappers/bash.d.ts +95 -0
  139. package/dist/core/wrappers/bash.d.ts.map +1 -0
  140. package/dist/core/wrappers/bash.js +413 -0
  141. package/dist/db/git-state-repo.d.ts +16 -0
  142. package/dist/db/git-state-repo.d.ts.map +1 -0
  143. package/dist/db/git-state-repo.js +38 -0
  144. package/dist/db/history-repo.d.ts +110 -0
  145. package/dist/db/history-repo.d.ts.map +1 -0
  146. package/dist/db/history-repo.js +300 -0
  147. package/dist/db/index.d.ts +49 -0
  148. package/dist/db/index.d.ts.map +1 -0
  149. package/dist/db/index.js +128 -0
  150. package/dist/db/metrics-repo.d.ts +46 -0
  151. package/dist/db/metrics-repo.d.ts.map +1 -0
  152. package/dist/db/metrics-repo.js +103 -0
  153. package/dist/db/migrate.d.ts +24 -0
  154. package/dist/db/migrate.d.ts.map +1 -0
  155. package/dist/db/migrate.js +244 -0
  156. package/dist/db/recovery.d.ts +11 -0
  157. package/dist/db/recovery.d.ts.map +1 -0
  158. package/dist/db/recovery.js +38 -0
  159. package/dist/db/run-journal.d.ts +60 -0
  160. package/dist/db/run-journal.d.ts.map +1 -0
  161. package/dist/db/run-journal.js +143 -0
  162. package/dist/db/run-resume.d.ts +48 -0
  163. package/dist/db/run-resume.d.ts.map +1 -0
  164. package/dist/db/run-resume.js +137 -0
  165. package/dist/db/runs-repo.d.ts +120 -0
  166. package/dist/db/runs-repo.d.ts.map +1 -0
  167. package/dist/db/runs-repo.js +319 -0
  168. package/dist/db/schema.d.ts +38 -0
  169. package/dist/db/schema.d.ts.map +1 -0
  170. package/dist/db/schema.js +325 -0
  171. package/dist/db/settings-repo.d.ts +8 -0
  172. package/dist/db/settings-repo.d.ts.map +1 -0
  173. package/dist/db/settings-repo.js +27 -0
  174. package/dist/db/tasks-repo.d.ts +26 -0
  175. package/dist/db/tasks-repo.d.ts.map +1 -0
  176. package/dist/db/tasks-repo.js +120 -0
  177. package/dist/db/templates-repo.d.ts +17 -0
  178. package/dist/db/templates-repo.d.ts.map +1 -0
  179. package/dist/db/templates-repo.js +57 -0
  180. package/dist/history.d.ts +60 -0
  181. package/dist/history.d.ts.map +1 -0
  182. package/dist/history.js +70 -0
  183. package/dist/i18n.d.ts +75 -0
  184. package/dist/i18n.d.ts.map +1 -0
  185. package/dist/i18n.js +357 -0
  186. package/dist/index.d.ts +858 -0
  187. package/dist/index.d.ts.map +1 -0
  188. package/dist/index.js +5209 -0
  189. package/dist/integrations.d.ts +72 -0
  190. package/dist/integrations.d.ts.map +1 -0
  191. package/dist/integrations.js +233 -0
  192. package/dist/notifications.d.ts +199 -0
  193. package/dist/notifications.d.ts.map +1 -0
  194. package/dist/notifications.js +967 -0
  195. package/dist/profiles.d.ts +64 -0
  196. package/dist/profiles.d.ts.map +1 -0
  197. package/dist/profiles.js +305 -0
  198. package/dist/rpc.d.ts +3915 -0
  199. package/dist/rpc.d.ts.map +1 -0
  200. package/dist/rpc.js +1596 -0
  201. package/dist/schtasks.d.ts +32 -0
  202. package/dist/schtasks.d.ts.map +1 -0
  203. package/dist/schtasks.js +45 -0
  204. package/dist/server.d.ts +128 -0
  205. package/dist/server.d.ts.map +1 -0
  206. package/dist/server.js +2414 -0
  207. package/dist/settings.d.ts +389 -0
  208. package/dist/settings.d.ts.map +1 -0
  209. package/dist/settings.js +770 -0
  210. package/dist/shared/jobs-view.d.ts +59 -0
  211. package/dist/shared/jobs-view.d.ts.map +1 -0
  212. package/dist/shared/jobs-view.js +146 -0
  213. package/dist/skill.d.ts +15 -0
  214. package/dist/skill.d.ts.map +1 -0
  215. package/dist/skill.js +93 -0
  216. package/dist/task-transfer.d.ts +252 -0
  217. package/dist/task-transfer.d.ts.map +1 -0
  218. package/dist/task-transfer.js +632 -0
  219. package/dist/templates.d.ts +57 -0
  220. package/dist/templates.d.ts.map +1 -0
  221. package/dist/templates.js +16 -0
  222. package/dist/types.d.ts +112 -0
  223. package/dist/types.d.ts.map +1 -0
  224. package/dist/types.js +158 -0
  225. package/dist/version.d.ts +8 -0
  226. package/dist/version.d.ts.map +1 -0
  227. package/dist/version.js +27 -0
  228. package/dist/workspaces.d.ts +113 -0
  229. package/dist/workspaces.d.ts.map +1 -0
  230. package/dist/workspaces.js +393 -0
  231. package/docs/ARCHITECTURE.md +559 -0
  232. package/docs/COMPATIBILITY.md +237 -0
  233. package/docs/CONCEPT.md +242 -0
  234. package/docs/CROSS_PLATFORM.ru.md +152 -0
  235. package/docs/CROSS_PLATFORM.zh.md +148 -0
  236. package/docs/FAQ.md +52 -0
  237. package/docs/FAQ.ru.md +53 -0
  238. package/docs/FAQ.zh.md +43 -0
  239. package/docs/FEATURES.md +699 -0
  240. package/docs/FEATURES.zh.md +656 -0
  241. package/docs/LOCAL-AI.md +300 -0
  242. package/docs/MIGRATION.md +363 -0
  243. package/docs/README.ru.md +287 -0
  244. package/docs/README.zh.md +306 -0
  245. package/docs/SAVINGS.md +61 -0
  246. package/docs/SAVINGS.ru.md +60 -0
  247. package/docs/SAVINGS.zh.md +52 -0
  248. package/docs/V1-V2-COMPATIBILITY-PLAN.md +366 -0
  249. package/docs/ZH-LOCALE-PLAN.md +324 -0
  250. package/docs/dashboard.png +0 -0
  251. package/docs/spikes/local-model-structured-output.md +81 -0
  252. package/docs/spikes/ollama-qwen3-4b-smoke.json +28 -0
  253. package/docs/spikes/ollama-qwen3-4b.json +163 -0
  254. package/gui-experimental.cjs +9 -0
  255. package/index.js +2 -0
  256. package/locales/en.json +781 -0
  257. package/locales/ru.json +781 -0
  258. package/locales/zh.json +781 -0
  259. package/package.json +154 -13
  260. package/scripts/bench-local.mjs +321 -0
  261. package/scripts/check-zh-locale.mjs +218 -0
  262. package/scripts/demo-dashboard.mjs +209 -0
  263. package/scripts/run-tests.mjs +236 -0
  264. package/scripts/spike-local-structured.mjs +182 -0
  265. package/scripts/test-locale.mjs +45 -0
  266. package/skills/scheduled-job-best-practices/SKILL.md +158 -0
  267. package/skills/scheduled-job-best-practices/references/recipes.md +163 -0
  268. package/src/core/analytics.ts +424 -0
  269. package/src/core/audit.ts +418 -0
  270. package/src/core/cron-to-schtasks.ts +209 -0
  271. package/src/core/dry-run.ts +601 -0
  272. package/src/core/file-watcher.ts +245 -0
  273. package/src/core/git-trigger.ts +391 -0
  274. package/src/core/glob.ts +226 -0
  275. package/src/core/local-ai.ts +173 -0
  276. package/src/core/lock.ts +219 -0
  277. package/src/core/matrix.ts +947 -0
  278. package/src/core/native-notify.ts +157 -0
  279. package/src/core/one-shot.ts +239 -0
  280. package/src/core/otel.ts +128 -0
  281. package/src/core/permissions.ts +200 -0
  282. package/src/core/prometheus.ts +215 -0
  283. package/src/core/ps-wrapper.ts +1160 -0
  284. package/src/core/record-history.ts +615 -0
  285. package/src/core/retention.ts +141 -0
  286. package/src/core/savings.ts +150 -0
  287. package/src/core/schedule-gate.ts +253 -0
  288. package/src/core/schedule-v2.ts +668 -0
  289. package/src/core/scheduler/at-fallback.ts +113 -0
  290. package/src/core/scheduler/index.ts +82 -0
  291. package/src/core/scheduler/linux.ts +308 -0
  292. package/src/core/scheduler/logs.ts +37 -0
  293. package/src/core/scheduler/mac.ts +322 -0
  294. package/src/core/scheduler/posix.ts +128 -0
  295. package/src/core/scheduler/registry.ts +101 -0
  296. package/src/core/scheduler/types.ts +90 -0
  297. package/src/core/scheduler/windows.ts +881 -0
  298. package/src/core/secrets.ts +503 -0
  299. package/src/core/self-analysis.ts +744 -0
  300. package/src/core/session.ts +150 -0
  301. package/src/core/shutdown.ts +69 -0
  302. package/src/core/structured-log.ts +214 -0
  303. package/src/core/summary.ts +318 -0
  304. package/src/core/telegram.ts +436 -0
  305. package/src/core/triage-chain.ts +125 -0
  306. package/src/core/triage-compare.ts +277 -0
  307. package/src/core/triage-rules.ts +238 -0
  308. package/src/core/triage-shadow.ts +240 -0
  309. package/src/core/triage-worker.ts +344 -0
  310. package/src/core/triage.ts +366 -0
  311. package/src/core/watch-paths.ts +70 -0
  312. package/src/core/wrappers/bash.ts +532 -0
  313. package/src/db/git-state-repo.ts +62 -0
  314. package/src/db/history-repo.ts +492 -0
  315. package/src/db/index.ts +176 -0
  316. package/src/db/metrics-repo.ts +170 -0
  317. package/src/db/migrate.ts +328 -0
  318. package/src/db/recovery.ts +46 -0
  319. package/src/db/run-journal.ts +212 -0
  320. package/src/db/run-resume.ts +220 -0
  321. package/src/db/runs-repo.ts +481 -0
  322. package/src/db/schema.ts +349 -0
  323. package/src/db/settings-repo.ts +31 -0
  324. package/src/db/tasks-repo.ts +162 -0
  325. package/src/db/templates-repo.ts +77 -0
  326. package/src/gui.tsx +5222 -0
  327. package/src/history.ts +128 -0
  328. package/src/i18n.ts +413 -0
  329. package/src/index.ts +6642 -0
  330. package/src/integrations.ts +297 -0
  331. package/src/notifications.ts +1346 -0
  332. package/src/profiles.ts +345 -0
  333. package/src/rpc.ts +1704 -0
  334. package/src/schtasks.ts +75 -0
  335. package/src/server.ts +2663 -0
  336. package/src/settings.ts +1369 -0
  337. package/src/shared/jobs-view.ts +188 -0
  338. package/src/skill.ts +113 -0
  339. package/src/task-transfer.ts +946 -0
  340. package/src/templates.ts +67 -0
  341. package/src/tui-v1.tsx +341 -0
  342. package/src/tui.tsx +329 -0
  343. package/src/types.ts +226 -0
  344. package/src/version.ts +27 -0
  345. package/src/workspaces.ts +487 -0
@@ -0,0 +1,586 @@
1
+ /**
2
+ * Расширенный cron и окна запуска (Спринт 19).
3
+ *
4
+ * Два режима регистрации в ОС:
5
+ * - «родной» (флаги schtasks / строки crontab / plist launchd) — только для
6
+ * простых выражений и системной таймзоны;
7
+ * - «опрос раз в минуту» (MINUTE /mo 1 + node-gate в обёртке) — для всего
8
+ * остального (timezone != system, списки, L, #, комбинации). Обёртка
9
+ * вызывает dist/core/schedule-gate.js, который сам решает, пора ли запускать.
10
+ *
11
+ * Здесь живёт только чистая математика: парсинг, совпадение, ближайший запуск.
12
+ * Никакого I/O и обращения к ОС.
13
+ */
14
+ import { convertCronToSchTasks } from "./cron-to-schtasks.js";
15
+ import { t } from "../i18n.js";
16
+ /** Ограничение на поиск ближайшего запуска. */
17
+ const MAX_SEARCH_DAYS = 5 * 366;
18
+ const MONTH_NAMES = {
19
+ JAN: 1, FEB: 2, MAR: 3, APR: 4, MAY: 5, JUN: 6,
20
+ JUL: 7, AUG: 8, SEP: 9, OCT: 10, NOV: 11, DEC: 12,
21
+ };
22
+ const DOW_NAMES = {
23
+ SUN: 0, MON: 1, TUE: 2, WED: 3, THU: 4, FRI: 5, SAT: 6,
24
+ };
25
+ /** Кэш форматтеров Intl по таймзоне (создание Intl.DateTimeFormat недёшево). */
26
+ const dtfCache = new Map();
27
+ function getDtf(timeZone) {
28
+ const cached = dtfCache.get(timeZone);
29
+ if (cached)
30
+ return cached;
31
+ // hourCycle h23: 00..23, без «24».
32
+ const dtf = new Intl.DateTimeFormat("en-US", {
33
+ timeZone,
34
+ year: "numeric", month: "numeric", day: "numeric",
35
+ hour: "numeric", minute: "numeric", second: "numeric",
36
+ hourCycle: "h23",
37
+ });
38
+ dtfCache.set(timeZone, dtf);
39
+ return dtf;
40
+ }
41
+ export function isValidIanaTimeZone(tz) {
42
+ const t = (tz || "").trim();
43
+ if (!t)
44
+ return false;
45
+ try {
46
+ new Intl.DateTimeFormat("en-US", { timeZone: t });
47
+ return true;
48
+ }
49
+ catch {
50
+ return false;
51
+ }
52
+ }
53
+ /** Системная таймзона (IANA) или "UTC", если её не удалось определить. */
54
+ export function systemTimeZone() {
55
+ try {
56
+ return Intl.DateTimeFormat().resolvedOptions().timeZone || "UTC";
57
+ }
58
+ catch {
59
+ return "UTC";
60
+ }
61
+ }
62
+ /** Части даты в заданной инстанции (или в системной локали, если tz не задан). */
63
+ export function zonedParts(date, timeZone) {
64
+ if (timeZone && timeZone !== Intl.DateTimeFormat().resolvedOptions().timeZone) {
65
+ const parts = getDtf(timeZone).formatToParts(date);
66
+ const bag = {};
67
+ for (const p of parts) {
68
+ if (p.type === "year" || p.type === "month" || p.type === "day"
69
+ || p.type === "hour" || p.type === "minute" || p.type === "second") {
70
+ bag[p.type] = Number(p.value);
71
+ }
72
+ }
73
+ const asUtc = new Date(Date.UTC(bag.year, bag.month - 1, bag.day));
74
+ return {
75
+ year: bag.year, month: bag.month, day: bag.day,
76
+ hour: bag.hour, minute: bag.minute, second: bag.second, ms: date.getUTCMilliseconds(),
77
+ weekday: asUtc.getUTCDay(),
78
+ };
79
+ }
80
+ return {
81
+ year: date.getFullYear(), month: date.getMonth() + 1, day: date.getDate(),
82
+ hour: date.getHours(), minute: date.getMinutes(), second: date.getSeconds(),
83
+ ms: date.getMilliseconds(), weekday: date.getDay(),
84
+ };
85
+ }
86
+ /** Стенные часы → UTC, итеративно учитывая смещение (DST-safe). null — несуществующее время. */
87
+ export function wallToUtc(y, m, d, h, mi, timeZone) {
88
+ const tz = timeZone || Intl.DateTimeFormat().resolvedOptions().timeZone;
89
+ const target = Date.UTC(y, m - 1, d, h, mi);
90
+ const matches = (ms) => {
91
+ const p = zonedParts(new Date(ms), tz);
92
+ return p.year === y && p.month === m && p.day === d && p.hour === h && p.minute === mi;
93
+ };
94
+ let guess = target;
95
+ for (let i = 0; i < 4; i += 1) {
96
+ const p = zonedParts(new Date(guess), tz);
97
+ const actual = Date.UTC(p.year, p.month - 1, p.day, p.hour, p.minute);
98
+ const delta = target - actual;
99
+ if (delta === 0)
100
+ break;
101
+ guess += delta;
102
+ }
103
+ // При переходе на зимнее время настенное время существует дважды. Для
104
+ // «следующего запуска» берём ПЕРВОЕ (более раннее) вхождение, а не то, к
105
+ // которому сошлась итерация. Обычно совпадение одно, тогда результат тот же.
106
+ const probes = [0, -30, 30, -60, 60, -90, 90, -120, 120].map((minutes) => guess + minutes * 60000);
107
+ let best = null;
108
+ for (const ms of probes) {
109
+ if (!matches(ms))
110
+ continue;
111
+ if (best === null || ms < best)
112
+ best = ms;
113
+ }
114
+ return best === null ? null : new Date(best);
115
+ }
116
+ function lastDayOfMonth(y, m) {
117
+ return new Date(Date.UTC(y, m, 0)).getUTCDate();
118
+ }
119
+ function nthWeekdayOfMonth(y, m, weekday, n) {
120
+ const firstDow = new Date(Date.UTC(y, m - 1, 1)).getUTCDay();
121
+ const first = 1 + ((weekday - firstDow + 7) % 7);
122
+ const dom = first + 7 * (n - 1);
123
+ return dom <= lastDayOfMonth(y, m) ? dom : null;
124
+ }
125
+ function expandField(token, min, max, names) {
126
+ const result = new Set();
127
+ const items = token.split(",");
128
+ for (const raw of items) {
129
+ let item = raw.trim().toUpperCase();
130
+ if (!item)
131
+ throw new Error(t("schedule.error.cronEmptyItem", { token }));
132
+ if (names?.[item] !== undefined)
133
+ item = String(names[item]);
134
+ // шаг: a-b/n или */n
135
+ const stepMatch = /^(.*)\/([0-9]+)$/.exec(item);
136
+ let step = 1;
137
+ if (stepMatch) {
138
+ item = (stepMatch[1] ?? "").trim();
139
+ step = Number(stepMatch[2]);
140
+ if (!Number.isInteger(step) || step < 1) {
141
+ throw new Error(t("schedule.error.cronStepInvalid", {
142
+ step: stepMatch[2],
143
+ raw,
144
+ }));
145
+ }
146
+ if (item === "")
147
+ throw new Error(t("schedule.error.cronStepMissing", { raw }));
148
+ }
149
+ if (item === "*" || item === "") {
150
+ for (let v = min; v <= max; v += step)
151
+ result.add(v);
152
+ continue;
153
+ }
154
+ const rangeMatch = /^([0-9A-Z]+)-([0-9A-Z]+)$/.exec(item);
155
+ if (rangeMatch) {
156
+ let aToken = rangeMatch[1];
157
+ let bToken = rangeMatch[2];
158
+ if (names?.[aToken] !== undefined)
159
+ aToken = String(names[aToken]);
160
+ if (names?.[bToken] !== undefined)
161
+ bToken = String(names[bToken]);
162
+ const a = Number(aToken);
163
+ const b = Number(bToken);
164
+ if (!Number.isFinite(a) || !Number.isFinite(b)) {
165
+ throw new Error(t("schedule.error.cronRangeInvalid", { item }));
166
+ }
167
+ if (a < min || b > max || a > b) {
168
+ throw new Error(t("schedule.error.cronRangeBounds", { item, min, max }));
169
+ }
170
+ for (let v = a; v <= b; v += step)
171
+ result.add(v);
172
+ continue;
173
+ }
174
+ const num = Number(item);
175
+ if (!Number.isInteger(num) || num < min || num > max) {
176
+ throw new Error(t("schedule.error.cronValueBounds", { raw, min, max }));
177
+ }
178
+ result.add(num);
179
+ }
180
+ return result;
181
+ }
182
+ /** Разворачивает «@every 15m|2h|1d» в обычный cron. */
183
+ export function normalizeCron(expr) {
184
+ const trimmed = expr.trim();
185
+ const match = /^@every\s+(\d+)([mhd])$/i.exec(trimmed);
186
+ if (!match)
187
+ return trimmed;
188
+ const n = Number(match[1]);
189
+ const unit = match[2].toLowerCase();
190
+ if (unit === "m" && n >= 1 && n < 60)
191
+ return `*/${n} * * * *`;
192
+ if (unit === "h" && n >= 1 && n <= 23)
193
+ return `0 */${n} * * *`;
194
+ if (unit === "d" && n >= 1 && n <= 31)
195
+ return `0 0 */${n} * *`;
196
+ throw new Error(t("schedule.error.everyInterval", { value: `${n}${unit}` }));
197
+ }
198
+ /** Парсит cron-выражение; бросает Error с понятным сообщением. */
199
+ export function parseCron(expr) {
200
+ const raw = normalizeCron(expr);
201
+ const fields = raw.split(/\s+/);
202
+ if (fields.length !== 5) {
203
+ throw new Error(t("schedule.error.cronFields", { count: fields.length, raw }));
204
+ }
205
+ const [minF, hourF, domF, monthF, dowF] = fields;
206
+ const minute = expandField(minF, 0, 59);
207
+ const hour = expandField(hourF, 0, 23);
208
+ const month = expandField(monthF, 1, 12, MONTH_NAMES);
209
+ // dom: «*» + опциональный «L» в списке (например «15,L»).
210
+ let dayOfMonth = null;
211
+ let lastDom = false;
212
+ {
213
+ const tokens = domF.trim().toUpperCase().split(",").map((s) => s.trim());
214
+ const kept = [];
215
+ for (const token of tokens) {
216
+ if (token === "L") {
217
+ lastDom = true;
218
+ continue;
219
+ }
220
+ kept.push(token);
221
+ }
222
+ if (domF.trim() !== "*") {
223
+ dayOfMonth = kept.length > 0 ? expandField(kept.join(","), 1, 31) : new Set();
224
+ }
225
+ }
226
+ // dow: «*» + имена + «d#n».
227
+ let dayOfWeek = null;
228
+ const nthWeekday = [];
229
+ {
230
+ const tokens = dowF.trim().toUpperCase().split(",").map((s) => s.trim());
231
+ const kept = [];
232
+ for (const token of tokens) {
233
+ const hash = /^([0-9A-Z]+)#([1-5])$/.exec(token);
234
+ if (hash) {
235
+ let dToken = hash[1];
236
+ if (DOW_NAMES[dToken] !== undefined)
237
+ dToken = String(DOW_NAMES[dToken]);
238
+ const weekday = Number(dToken);
239
+ if (!Number.isInteger(weekday) || weekday < 0 || weekday > 7) {
240
+ throw new Error(t("schedule.error.weekdayBounds", {
241
+ value: hash[1],
242
+ field: dowF,
243
+ }));
244
+ }
245
+ nthWeekday.push({ weekday: weekday % 7, n: Number(hash[2]) });
246
+ continue;
247
+ }
248
+ if (token === "L") {
249
+ throw new Error(t("schedule.error.lastDomOnly"));
250
+ }
251
+ kept.push(token);
252
+ }
253
+ if (dowF.trim() !== "*") {
254
+ dayOfWeek = kept.length > 0 ? expandField(kept.join(","), 0, 7, DOW_NAMES) : new Set();
255
+ // 0 и 7 — оба воскресенье.
256
+ const mapped = new Set();
257
+ for (const d of dayOfWeek)
258
+ mapped.add(d % 7);
259
+ dayOfWeek = mapped;
260
+ }
261
+ }
262
+ return { raw, minute, hour, dayOfMonth, lastDom, month, dayOfWeek, nthWeekday };
263
+ }
264
+ function domMatches(p, spec) {
265
+ const last = lastDayOfMonth(p.year, p.month);
266
+ if (spec.dayOfMonth && spec.dayOfMonth.has(p.day))
267
+ return true;
268
+ if (spec.lastDom && p.day === last)
269
+ return true;
270
+ return false;
271
+ }
272
+ function dowMatches(p, spec) {
273
+ if (spec.dayOfWeek && spec.dayOfWeek.has(p.weekday))
274
+ return true;
275
+ for (const { weekday, n } of spec.nthWeekday) {
276
+ const dom = nthWeekdayOfMonth(p.year, p.month, weekday, n);
277
+ if (dom === p.day)
278
+ return true;
279
+ }
280
+ return false;
281
+ }
282
+ /** true, если cron срабатывает в указанную минуту (в системной или заданной tz). */
283
+ export function cronMatches(spec, date, timeZone) {
284
+ const p = zonedParts(date, timeZone);
285
+ if (!spec.minute.has(p.minute))
286
+ return false;
287
+ if (!spec.hour.has(p.hour))
288
+ return false;
289
+ if (!spec.month.has(p.month))
290
+ return false;
291
+ const domAny = spec.dayOfMonth === null && !spec.lastDom;
292
+ const dowAny = spec.dayOfWeek === null && spec.nthWeekday.length === 0;
293
+ const dm = domMatches(p, spec);
294
+ const dw = dowMatches(p, spec);
295
+ // Vixie OR-семантика: обе группы ограничены — достаточно совпадения одной.
296
+ if (domAny && dowAny)
297
+ return true;
298
+ if (domAny)
299
+ return dw;
300
+ if (dowAny)
301
+ return dm;
302
+ return dm || dw;
303
+ }
304
+ function iterateDay(p, delta) {
305
+ const d = new Date(Date.UTC(p.year, p.month - 1, p.day + delta));
306
+ return { year: d.getUTCFullYear(), month: d.getUTCMonth() + 1, day: d.getUTCDate() };
307
+ }
308
+ function candidatesOnDay(spec, y, m, d, notBefore, notAfter) {
309
+ const hours = [...spec.hour].sort((a, b) => a - b);
310
+ const minutes = [...spec.minute].sort((a, b) => a - b);
311
+ const result = [];
312
+ for (const hour of hours) {
313
+ for (const minute of minutes) {
314
+ if (notBefore) {
315
+ if (hour < notBefore.hour || (hour === notBefore.hour && minute < notBefore.minute))
316
+ continue;
317
+ }
318
+ if (notAfter) {
319
+ if (hour > notAfter.hour || (hour === notAfter.hour && minute > notAfter.minute))
320
+ continue;
321
+ }
322
+ result.push({ hour, minute });
323
+ }
324
+ }
325
+ return result;
326
+ }
327
+ /**
328
+ * Ближайший запуск после `from` (или null, если найти не удалось за 5 лет).
329
+ * `timeZone` — IANA; по умолчанию системная.
330
+ */
331
+ export function nextRun(expr, from, timeZone) {
332
+ const spec = parseCron(expr);
333
+ const base = from.getTime();
334
+ const origin = zonedParts(from, timeZone);
335
+ let cursor = { year: origin.year, month: origin.month, day: origin.day };
336
+ // Не считать время дня на первом дне: только строго после from.
337
+ let firstDay = true;
338
+ for (let i = 0; i < MAX_SEARCH_DAYS; i += 1) {
339
+ if (dayMatches(cursor.year, cursor.month, cursor.day, spec)) {
340
+ const nb = firstDay
341
+ ? { hour: origin.hour, minute: origin.minute + 1 } // строго позже минуты from
342
+ : null;
343
+ const candidates = candidatesOnDay(spec, cursor.year, cursor.month, cursor.day, nb, null);
344
+ for (const cand of candidates) {
345
+ const at = wallToUtc(cursor.year, cursor.month, cursor.day, cand.hour, cand.minute, timeZone);
346
+ if (at && at.getTime() > base)
347
+ return at;
348
+ }
349
+ }
350
+ firstDay = false;
351
+ cursor = iterateDay(cursor, 1);
352
+ }
353
+ return null;
354
+ }
355
+ /** Последний запуск не позже `from` (или null). */
356
+ export function prevRun(expr, from, timeZone) {
357
+ const spec = parseCron(expr);
358
+ const base = from.getTime();
359
+ const origin = zonedParts(from, timeZone);
360
+ let cursor = { year: origin.year, month: origin.month, day: origin.day };
361
+ let firstDay = true;
362
+ for (let i = 0; i < MAX_SEARCH_DAYS; i += 1) {
363
+ if (dayMatches(cursor.year, cursor.month, cursor.day, spec)) {
364
+ const na = firstDay
365
+ ? { hour: origin.hour, minute: origin.minute } // включая текущую минуту
366
+ : null;
367
+ const candidates = candidatesOnDay(spec, cursor.year, cursor.month, cursor.day, null, na);
368
+ for (let i2 = candidates.length - 1; i2 >= 0; i2 -= 1) {
369
+ const cand = candidates[i2];
370
+ const at = wallToUtc(cursor.year, cursor.month, cursor.day, cand.hour, cand.minute, timeZone);
371
+ if (at && at.getTime() <= base)
372
+ return at;
373
+ }
374
+ }
375
+ firstDay = false;
376
+ cursor = iterateDay(cursor, -1);
377
+ }
378
+ return null;
379
+ }
380
+ function dayMatches(y, m, d, spec) {
381
+ if (!spec.month.has(m))
382
+ return false;
383
+ const domAny = spec.dayOfMonth === null && !spec.lastDom;
384
+ const date = new Date(Date.UTC(y, m - 1, d));
385
+ const weekday = date.getUTCDay();
386
+ const p = { year: y, month: m, day: d, weekday };
387
+ if (domAny && spec.dayOfWeek === null && spec.nthWeekday.length === 0)
388
+ return true;
389
+ const dm = domMatches({ year: y, month: m, day: d }, spec);
390
+ const dw = dowMatches(p, spec);
391
+ const dowAny = spec.dayOfWeek === null && spec.nthWeekday.length === 0;
392
+ if (domAny)
393
+ return dw;
394
+ if (dowAny)
395
+ return dm;
396
+ return dm || dw;
397
+ }
398
+ function dayStartUtc(y, m, d, timeZone) {
399
+ const d0 = wallToUtc(y, m, d, 0, 0, timeZone);
400
+ return d0 ?? new Date(Date.UTC(y, m - 1, d, 0, 0));
401
+ }
402
+ // ---------------------------------------------------------------------------
403
+ // Окна запуска (notBefore/notAfter, «дд:мм» 24ч, можно через полночь).
404
+ const DAILY_TIME_RE = /^([01]\d|2[0-3]):[0-5]\d$/;
405
+ export function isValidDailyTime(value) {
406
+ return DAILY_TIME_RE.test((value || "").trim());
407
+ }
408
+ function dailyTimeToMinutes(value) {
409
+ const [h, m] = value.trim().split(":").map(Number);
410
+ return h * 60 + m;
411
+ }
412
+ /** Проверяет пару окна; возвращает текст ошибки или null. */
413
+ export function validateLaunchWindow(notBefore, notAfter) {
414
+ if (notBefore === undefined && notAfter === undefined)
415
+ return null;
416
+ const nb = notBefore?.trim() ?? "";
417
+ const na = notAfter?.trim() ?? "";
418
+ if (!nb && !na)
419
+ return null;
420
+ if (nb && !isValidDailyTime(nb))
421
+ return t("schedule.error.notBeforeFormat", { value: nb });
422
+ if (na && !isValidDailyTime(na))
423
+ return t("schedule.error.notAfterFormat", { value: na });
424
+ if (!nb || !na)
425
+ return t("schedule.error.windowTogether");
426
+ if (nb === na)
427
+ return t("schedule.error.windowEmpty");
428
+ return null;
429
+ }
430
+ function wallMinutes(date, timeZone) {
431
+ const p = zonedParts(date, timeZone);
432
+ return { minutes: p.hour * 60 + p.minute, seconds: p.second, ms: p.ms };
433
+ }
434
+ /** Мы внутри окна запуска? */
435
+ export function isInWindow(now, notBefore, notAfter, timeZone) {
436
+ if (validateLaunchWindow(notBefore, notAfter) !== null)
437
+ return true; // невалидное окно не должно блокировать
438
+ if (!notBefore?.trim() && !notAfter?.trim())
439
+ return true;
440
+ const start = dailyTimeToMinutes(notBefore);
441
+ const end = dailyTimeToMinutes(notAfter);
442
+ const { minutes } = wallMinutes(now, timeZone);
443
+ if (start < end)
444
+ return minutes >= start && minutes < end;
445
+ return minutes >= start || minutes < end; // через полночь
446
+ }
447
+ /** Сколько мс ждать до открытия окна (0 — уже открыто / окно не задано). */
448
+ export function windowDelayMs(now, notBefore, notAfter, timeZone) {
449
+ if (validateLaunchWindow(notBefore, notAfter) !== null)
450
+ return 0;
451
+ if (!notBefore?.trim() && !notAfter?.trim())
452
+ return 0;
453
+ if (isInWindow(now, notBefore, notAfter, timeZone))
454
+ return 0;
455
+ const start = dailyTimeToMinutes(notBefore);
456
+ const { minutes, seconds, ms } = wallMinutes(now, timeZone);
457
+ const deltaMin = (start - minutes + 1440) % 1440;
458
+ const deltaSec = deltaMin * 60 - seconds;
459
+ return Math.max(0, deltaSec * 1000 - ms);
460
+ }
461
+ // ---------------------------------------------------------------------------
462
+ // Дни недели и политика вне окна (Спринт 27).
463
+ /** 0=Вс..6=Сб. Пустой/полный список трактуется как «все дни» (undefined). */
464
+ export function normalizeActiveDays(days) {
465
+ if (!Array.isArray(days))
466
+ return undefined;
467
+ const unique = [
468
+ ...new Set(days
469
+ .map((value) => Math.floor(Number(value)))
470
+ .filter((value) => Number.isInteger(value) && value >= 0 && value <= 6)),
471
+ ].sort((a, b) => a - b);
472
+ if (unique.length === 0 || unique.length === 7)
473
+ return undefined;
474
+ return unique;
475
+ }
476
+ /** Разрешён ли день недели (в поясе задачи). */
477
+ export function isActiveDay(now, days, timeZone) {
478
+ const normalized = normalizeActiveDays(days);
479
+ if (!normalized)
480
+ return true;
481
+ return normalized.includes(zonedParts(now, timeZone).weekday);
482
+ }
483
+ const WINDOW_SCAN_MINUTES = 8 * 24 * 60;
484
+ /** Ближайшая минута, когда и день, и окно разрешают запуск. */
485
+ export function nextWindowOpenAt(now, options) {
486
+ const { notBefore, notAfter, timeZone } = options;
487
+ const normalizedDays = normalizeActiveDays(options.days);
488
+ const hasWindow = Boolean((notBefore || "").trim() || (notAfter || "").trim());
489
+ if (!hasWindow && !normalizedDays)
490
+ return null;
491
+ const invalidWindow = validateLaunchWindow(notBefore, notAfter) !== null;
492
+ for (let i = 1; i <= WINDOW_SCAN_MINUTES; i++) {
493
+ const candidate = new Date(now.getTime() + i * 60000);
494
+ const dayOk = !normalizedDays || normalizedDays.includes(zonedParts(candidate, timeZone).weekday);
495
+ const windowOk = invalidWindow || isInWindow(candidate, notBefore, notAfter, timeZone);
496
+ if (dayOk && windowOk)
497
+ return candidate;
498
+ }
499
+ return null;
500
+ }
501
+ /** Состояние окна с учётом дней недели. */
502
+ export function activeWindowState(now, options = {}) {
503
+ const normalizedDays = normalizeActiveDays(options.days);
504
+ const dayOk = !normalizedDays ||
505
+ normalizedDays.includes(zonedParts(now, options.timeZone).weekday);
506
+ const windowOk = isInWindow(now, options.notBefore, options.notAfter, options.timeZone);
507
+ if (dayOk && windowOk)
508
+ return { active: true, nextOpenAt: null };
509
+ const reasons = [];
510
+ if (!dayOk) {
511
+ const days = (normalizedDays ?? [])
512
+ .map((d) => t(`schedule.weekday.${d}`))
513
+ .join(", ");
514
+ reasons.push(t("schedule.reason.dayNotAllowed", { days }));
515
+ }
516
+ if (!windowOk) {
517
+ reasons.push(t("schedule.reason.outsideWindow", {
518
+ notBefore: options.notBefore,
519
+ notAfter: options.notAfter,
520
+ }));
521
+ }
522
+ return {
523
+ active: false,
524
+ reason: reasons.join("; "),
525
+ nextOpenAt: nextWindowOpenAt(now, options),
526
+ };
527
+ }
528
+ /** Сколько мс до следующего разрешённого окна (0 — можно запускать). */
529
+ export function nextWindowOpenDelayMs(now, options = {}) {
530
+ const state = activeWindowState(now, options);
531
+ if (state.active)
532
+ return 0;
533
+ return state.nextOpenAt ? Math.max(0, state.nextOpenAt.getTime() - now.getTime()) : 0;
534
+ }
535
+ // ---------------------------------------------------------------------------
536
+ // Проверка совместимости с schtasks (родной режим).
537
+ /**
538
+ * true, если выражение умеет оформить Windows Task Scheduler «родными»
539
+ * флагами (MINUTE/HOURLY/DAILY/WEEKLY) и парсится строгим конвертером.
540
+ * Используется для выбора между флагами и минутным опросом.
541
+ */
542
+ export function isNativeSchtasksExpr(expr) {
543
+ try {
544
+ convertCronToSchTasks(normalizeCron(expr));
545
+ return true;
546
+ }
547
+ catch {
548
+ return false;
549
+ }
550
+ }
551
+ /** Конвертер для родного режима; бросает Error для неподдерживаемых. */
552
+ export function convertForSchtasks(expr) {
553
+ return convertCronToSchTasks(normalizeCron(expr));
554
+ }
555
+ /**
556
+ * true, если ОС-триггер не выражает расписание (чужой IANA-таймзона или
557
+ * не конвертируемо в флаги schtasks) — нужен минутный опрос + gate.
558
+ */
559
+ export function needsPollMode(expr, timezone) {
560
+ const tz = (timezone || "").trim();
561
+ if (tz && tz !== systemTimeZone())
562
+ return true;
563
+ return !isNativeSchtasksExpr(expr);
564
+ }
565
+ /**
566
+ * Аргументы schedule-gate для враппера, либо undefined — если врапперу гейт
567
+ * не нужен (нативный cron + системный таймзона + окно не задано).
568
+ * Окно запуска всегда требует gate (перенос реализует враппер).
569
+ */
570
+ export function buildScheduleGate(expr, timezone, notBefore, notAfter, days, windowPolicy) {
571
+ const tz = (timezone || "").trim() || undefined;
572
+ const poll = needsPollMode(expr, tz);
573
+ const normalizedDays = normalizeActiveDays(days);
574
+ const policy = windowPolicy === "skip" || windowPolicy === "run" ? windowPolicy : undefined;
575
+ if (!poll && !(notBefore && notAfter) && !normalizedDays)
576
+ return undefined;
577
+ // cron проверяем только в poll-режиме (см. комментарий у ScheduleGateSpec).
578
+ return {
579
+ ...(poll ? { cron: expr } : {}),
580
+ tz,
581
+ notBefore,
582
+ notAfter,
583
+ ...(normalizedDays ? { days: normalizedDays } : {}),
584
+ ...(policy ? { windowPolicy: policy } : {}),
585
+ };
586
+ }
@@ -0,0 +1,42 @@
1
+ import type { RegistryEntry } from "./registry.js";
2
+ /**
3
+ * Fallback для one-shot задач, когда утилита `at` не установлена.
4
+ *
5
+ * Запускает отвязанный (detached) `/bin/bash`, который спит до `runAt` и
6
+ * затем выполняет команду задачи. Это не полноценная замена `atd`:
7
+ * - процесс не переживает перезагрузку машины;
8
+ * - не переживает ручной kill;
9
+ * - не виден в `atq`.
10
+ * Поэтому fallback используется только как последнее средство и пишет
11
+ * предупреждение в лог. Если `at` доступен — вызывается он.
12
+ */
13
+ export interface DetachedOneShotSpawn {
14
+ once(event: "error", listener: (err: Error) => void): unknown;
15
+ once(event: "spawn", listener: () => void): unknown;
16
+ unref(): unknown;
17
+ pid?: number;
18
+ }
19
+ export type DetachedOneShotSpawnFn = (file: string, args: string[], options: {
20
+ detached: boolean;
21
+ stdio: "ignore";
22
+ }) => DetachedOneShotSpawn;
23
+ export interface ScheduleAtFallbackDeps {
24
+ spawnFn?: DetachedOneShotSpawnFn;
25
+ now?: () => number;
26
+ }
27
+ /** Ошибка `spawn("at")`, означающая, что бинарник не найден. */
28
+ export declare function isAtMissingError(err: unknown): boolean;
29
+ /** Сколько секунд осталось до `runAt` (0, если момент уже прошёл). */
30
+ export declare function computeDelaySeconds(runAt: string, nowMs: number): number;
31
+ /** Скрипт для `/bin/bash -c`: подождать и выполнить команду задачи. */
32
+ export declare function buildDetachedOneShotScript(entry: RegistryEntry, command: string, nowMs: number): string;
33
+ /** Является ли сохранённый id задания pid-ом fallback-процесса. */
34
+ export declare function isPidJobId(jobId: string | undefined): boolean;
35
+ /**
36
+ * Запускает отвязанный one-shot и возвращает `pid:<pid>` для `cancelAt`.
37
+ * Промис резолвится сразу после успешного `spawn`, не дожидаясь выполнения.
38
+ */
39
+ export declare function scheduleAtFallback(entry: RegistryEntry, command: string, deps?: ScheduleAtFallbackDeps): Promise<string>;
40
+ /** Снимает fallback-процесс. Ошибки (процесс уже завершился) игнорируются. */
41
+ export declare function cancelAtFallback(jobId: string): boolean;
42
+ //# sourceMappingURL=at-fallback.d.ts.map
@@ -0,0 +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"}