agent-steward 0.0.2 → 0.0.4

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (263) hide show
  1. package/CHANGELOG.md +45 -2
  2. package/CROSS_PLATFORM.md +11 -9
  3. package/README.md +11 -10
  4. package/ROADMAP-STRATEGY.md +93 -44
  5. package/ROADMAP.md +148 -1017
  6. package/dist/core/cron-to-schtasks.d.ts +0 -8
  7. package/dist/core/cron-to-schtasks.d.ts.map +1 -1
  8. package/dist/core/cron-to-schtasks.js +11 -86
  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 +19 -2
  14. package/dist/core/file-watcher.js +9 -9
  15. package/dist/core/git-trigger.js +4 -4
  16. package/dist/core/lock.d.ts +20 -4
  17. package/dist/core/lock.d.ts.map +1 -1
  18. package/dist/core/lock.js +99 -26
  19. package/dist/core/one-shot.d.ts +31 -5
  20. package/dist/core/one-shot.d.ts.map +1 -1
  21. package/dist/core/one-shot.js +78 -10
  22. package/dist/core/opencode-cli.d.ts +28 -0
  23. package/dist/core/opencode-cli.d.ts.map +1 -0
  24. package/dist/core/opencode-cli.js +74 -0
  25. package/dist/core/opencode-models.d.ts +62 -0
  26. package/dist/core/opencode-models.d.ts.map +1 -0
  27. package/dist/core/opencode-models.js +277 -0
  28. package/dist/core/otel.js +2 -2
  29. package/dist/core/ps-wrapper.d.ts +1 -1
  30. package/dist/core/ps-wrapper.d.ts.map +1 -1
  31. package/dist/core/ps-wrapper.js +66 -36
  32. package/dist/core/record-history.d.ts +15 -0
  33. package/dist/core/record-history.d.ts.map +1 -1
  34. package/dist/core/record-history.js +78 -54
  35. package/dist/core/router/dispatch.d.ts +36 -0
  36. package/dist/core/router/dispatch.d.ts.map +1 -0
  37. package/dist/core/router/dispatch.js +59 -0
  38. package/dist/core/router/escalation.d.ts +47 -0
  39. package/dist/core/router/escalation.d.ts.map +1 -0
  40. package/dist/core/router/escalation.js +87 -0
  41. package/dist/core/router/planner.d.ts +53 -0
  42. package/dist/core/router/planner.d.ts.map +1 -0
  43. package/dist/core/router/planner.js +113 -0
  44. package/dist/core/router/rules.d.ts +46 -0
  45. package/dist/core/router/rules.d.ts.map +1 -0
  46. package/dist/core/router/rules.js +85 -0
  47. package/dist/core/run-panel-api.d.ts +94 -0
  48. package/dist/core/run-panel-api.d.ts.map +1 -0
  49. package/dist/core/run-panel-api.js +169 -0
  50. package/dist/core/schedule-gate.js +5 -1
  51. package/dist/core/schedule-v2.d.ts +36 -2
  52. package/dist/core/schedule-v2.d.ts.map +1 -1
  53. package/dist/core/schedule-v2.js +98 -12
  54. package/dist/core/scheduler/at-fallback.d.ts +95 -0
  55. package/dist/core/scheduler/at-fallback.d.ts.map +1 -0
  56. package/dist/core/scheduler/at-fallback.js +200 -0
  57. package/dist/core/scheduler/linux.d.ts +13 -2
  58. package/dist/core/scheduler/linux.d.ts.map +1 -1
  59. package/dist/core/scheduler/linux.js +67 -13
  60. package/dist/core/scheduler/mac.d.ts +14 -8
  61. package/dist/core/scheduler/mac.d.ts.map +1 -1
  62. package/dist/core/scheduler/mac.js +71 -22
  63. package/dist/core/scheduler/posix.d.ts.map +1 -1
  64. package/dist/core/scheduler/posix.js +37 -2
  65. package/dist/core/scheduler/registry.d.ts +13 -0
  66. package/dist/core/scheduler/registry.d.ts.map +1 -1
  67. package/dist/core/scheduler/registry.js +83 -21
  68. package/dist/core/scheduler/run-now.d.ts +16 -0
  69. package/dist/core/scheduler/run-now.d.ts.map +1 -0
  70. package/dist/core/scheduler/run-now.js +28 -0
  71. package/dist/core/scheduler/windows.d.ts +16 -3
  72. package/dist/core/scheduler/windows.d.ts.map +1 -1
  73. package/dist/core/scheduler/windows.js +249 -96
  74. package/dist/core/secrets.d.ts.map +1 -1
  75. package/dist/core/secrets.js +127 -30
  76. package/dist/core/self-analysis.js +55 -55
  77. package/dist/core/session.d.ts.map +1 -1
  78. package/dist/core/session.js +18 -11
  79. package/dist/core/summary.js +1 -1
  80. package/dist/core/task-name.d.ts +24 -0
  81. package/dist/core/task-name.d.ts.map +1 -0
  82. package/dist/core/task-name.js +40 -0
  83. package/dist/core/triage-chain.js +1 -1
  84. package/dist/core/triage-worker.js +2 -2
  85. package/dist/core/triage.js +1 -1
  86. package/dist/core/wrappers/bash.d.ts.map +1 -1
  87. package/dist/core/wrappers/bash.js +82 -37
  88. package/dist/db/capability-repo.d.ts +83 -0
  89. package/dist/db/capability-repo.d.ts.map +1 -0
  90. package/dist/db/capability-repo.js +182 -0
  91. package/dist/db/history-repo.d.ts +8 -0
  92. package/dist/db/history-repo.d.ts.map +1 -1
  93. package/dist/db/history-repo.js +19 -0
  94. package/dist/db/index.d.ts +6 -0
  95. package/dist/db/index.d.ts.map +1 -1
  96. package/dist/db/index.js +48 -2
  97. package/dist/db/migrate.d.ts.map +1 -1
  98. package/dist/db/migrate.js +3 -1
  99. package/dist/db/run-context.d.ts +103 -0
  100. package/dist/db/run-context.d.ts.map +1 -0
  101. package/dist/db/run-context.js +224 -0
  102. package/dist/db/run-dlq.d.ts +100 -0
  103. package/dist/db/run-dlq.d.ts.map +1 -0
  104. package/dist/db/run-dlq.js +191 -0
  105. package/dist/db/run-journal.d.ts +60 -0
  106. package/dist/db/run-journal.d.ts.map +1 -0
  107. package/dist/db/run-journal.js +143 -0
  108. package/dist/db/run-resume.d.ts +51 -0
  109. package/dist/db/run-resume.d.ts.map +1 -0
  110. package/dist/db/run-resume.js +156 -0
  111. package/dist/db/runs-repo.d.ts +128 -0
  112. package/dist/db/runs-repo.d.ts.map +1 -0
  113. package/dist/db/runs-repo.js +342 -0
  114. package/dist/db/schema.d.ts +16 -2
  115. package/dist/db/schema.d.ts.map +1 -1
  116. package/dist/db/schema.js +342 -35
  117. package/dist/db/settings-repo.d.ts +11 -0
  118. package/dist/db/settings-repo.d.ts.map +1 -1
  119. package/dist/db/settings-repo.js +25 -0
  120. package/dist/db/step-idempotency.d.ts +51 -0
  121. package/dist/db/step-idempotency.d.ts.map +1 -0
  122. package/dist/db/step-idempotency.js +136 -0
  123. package/dist/index.d.ts +5 -5
  124. package/dist/index.d.ts.map +1 -1
  125. package/dist/index.js +168 -40
  126. package/dist/notifications.js +18 -18
  127. package/dist/profiles.d.ts +7 -3
  128. package/dist/profiles.d.ts.map +1 -1
  129. package/dist/profiles.js +85 -7
  130. package/dist/rpc.d.ts +787 -0
  131. package/dist/rpc.d.ts.map +1 -1
  132. package/dist/rpc.js +324 -0
  133. package/dist/server.d.ts +33 -2
  134. package/dist/server.d.ts.map +1 -1
  135. package/dist/server.js +115 -54
  136. package/dist/shared/jobs-view.d.ts.map +1 -1
  137. package/dist/skill.js +1 -1
  138. package/dist/task-transfer.d.ts +1 -1
  139. package/dist/task-transfer.d.ts.map +1 -1
  140. package/dist/task-transfer.js +14 -10
  141. package/dist/types.d.ts +20 -4
  142. package/dist/types.d.ts.map +1 -1
  143. package/dist/types.js +44 -9
  144. package/dist/workspaces.d.ts +25 -3
  145. package/dist/workspaces.d.ts.map +1 -1
  146. package/dist/workspaces.js +44 -9
  147. package/docs/ARCHITECTURE.md +335 -9
  148. package/docs/COMPATIBILITY.md +10 -6
  149. package/docs/CONCEPT.md +183 -91
  150. package/docs/CROSS_PLATFORM.ru.md +11 -9
  151. package/docs/CROSS_PLATFORM.zh.md +11 -9
  152. package/docs/EXECUTION-LOOP.md +196 -0
  153. package/docs/FAQ.md +2 -2
  154. package/docs/FAQ.ru.md +2 -2
  155. package/docs/FAQ.zh.md +2 -2
  156. package/docs/FEATURES.md +5 -4
  157. package/docs/FEATURES.zh.md +5 -4
  158. package/docs/MIGRATION.md +34 -26
  159. package/docs/README.ru.md +27 -8
  160. package/docs/README.zh.md +11 -10
  161. package/docs/SAFETY.md +122 -0
  162. package/docs/SAVINGS.md +29 -0
  163. package/docs/SAVINGS.ru.md +29 -0
  164. package/docs/SAVINGS.zh.md +18 -0
  165. package/docs/V1-V2-COMPATIBILITY-PLAN.md +6 -6
  166. package/gui-experimental.cjs +8 -8
  167. package/index.js +1 -0
  168. package/locales/en.json +68 -0
  169. package/locales/ru.json +68 -0
  170. package/locales/zh.json +68 -0
  171. package/package.json +57 -11
  172. package/scripts/audit-bundle.mjs +215 -0
  173. package/src/core/analytics.ts +2 -2
  174. package/src/core/audit.ts +17 -17
  175. package/src/core/cron-to-schtasks.ts +14 -93
  176. package/src/core/dlq-api.ts +98 -0
  177. package/src/core/dry-run.ts +51 -27
  178. package/src/core/file-watcher.ts +17 -17
  179. package/src/core/git-trigger.ts +9 -9
  180. package/src/core/glob.ts +1 -1
  181. package/src/core/local-ai.ts +2 -2
  182. package/src/core/lock.ts +104 -31
  183. package/src/core/matrix.ts +31 -31
  184. package/src/core/native-notify.ts +2 -2
  185. package/src/core/one-shot.ts +91 -13
  186. package/src/core/opencode-cli.ts +103 -0
  187. package/src/core/opencode-models.ts +315 -0
  188. package/src/core/otel.ts +4 -4
  189. package/src/core/permissions.ts +5 -5
  190. package/src/core/prometheus.ts +17 -17
  191. package/src/core/ps-wrapper.ts +68 -38
  192. package/src/core/record-history.ts +114 -76
  193. package/src/core/retention.ts +3 -3
  194. package/src/core/router/dispatch.ts +94 -0
  195. package/src/core/router/escalation.ts +129 -0
  196. package/src/core/router/planner.ts +166 -0
  197. package/src/core/router/rules.ts +109 -0
  198. package/src/core/run-panel-api.ts +262 -0
  199. package/src/core/savings.ts +1 -1
  200. package/src/core/schedule-gate.ts +17 -13
  201. package/src/core/schedule-v2.ts +138 -29
  202. package/src/core/scheduler/at-fallback.ts +298 -0
  203. package/src/core/scheduler/index.ts +3 -3
  204. package/src/core/scheduler/linux.ts +92 -19
  205. package/src/core/scheduler/logs.ts +1 -1
  206. package/src/core/scheduler/mac.ts +112 -60
  207. package/src/core/scheduler/posix.ts +35 -2
  208. package/src/core/scheduler/registry.ts +109 -26
  209. package/src/core/scheduler/run-now.ts +32 -0
  210. package/src/core/scheduler/windows.ts +295 -125
  211. package/src/core/secrets.ts +139 -39
  212. package/src/core/self-analysis.ts +61 -61
  213. package/src/core/session.ts +26 -13
  214. package/src/core/structured-log.ts +3 -3
  215. package/src/core/summary.ts +25 -25
  216. package/src/core/task-name.ts +67 -0
  217. package/src/core/telegram.ts +16 -16
  218. package/src/core/triage-chain.ts +4 -4
  219. package/src/core/triage-compare.ts +8 -8
  220. package/src/core/triage-rules.ts +4 -4
  221. package/src/core/triage-shadow.ts +7 -7
  222. package/src/core/triage-worker.ts +6 -6
  223. package/src/core/triage.ts +23 -23
  224. package/src/core/watch-paths.ts +1 -1
  225. package/src/core/wrappers/bash.ts +90 -45
  226. package/src/db/capability-repo.ts +285 -0
  227. package/src/db/git-state-repo.ts +1 -1
  228. package/src/db/history-repo.ts +44 -22
  229. package/src/db/index.ts +53 -7
  230. package/src/db/metrics-repo.ts +10 -10
  231. package/src/db/migrate.ts +13 -11
  232. package/src/db/recovery.ts +3 -3
  233. package/src/db/run-context.ts +370 -0
  234. package/src/db/run-dlq.ts +310 -0
  235. package/src/db/run-journal.ts +212 -0
  236. package/src/db/run-resume.ts +256 -0
  237. package/src/db/runs-repo.ts +504 -0
  238. package/src/db/schema.ts +357 -44
  239. package/src/db/settings-repo.ts +33 -2
  240. package/src/db/step-idempotency.ts +185 -0
  241. package/src/db/tasks-repo.ts +10 -10
  242. package/src/db/templates-repo.ts +7 -7
  243. package/src/gui.tsx +516 -1
  244. package/src/history.ts +4 -4
  245. package/src/i18n.ts +7 -7
  246. package/src/index.ts +465 -308
  247. package/src/integrations.ts +6 -6
  248. package/src/notifications.ts +76 -76
  249. package/src/profiles.ts +98 -7
  250. package/src/rpc.ts +347 -1
  251. package/src/schtasks.ts +2 -2
  252. package/src/server.ts +155 -78
  253. package/src/settings.ts +44 -44
  254. package/src/shared/jobs-view.ts +60 -60
  255. package/src/skill.ts +1 -1
  256. package/src/task-transfer.ts +58 -56
  257. package/src/templates.ts +1 -1
  258. package/src/types.ts +54 -10
  259. package/src/workspaces.ts +73 -24
  260. package/dist/core/self-analysis.test.d.ts +0 -2
  261. package/dist/core/self-analysis.test.d.ts.map +0 -1
  262. package/dist/core/self-analysis.test.js +0 -219
  263. package/dist/gui-experimental.cjs +0 -1
@@ -0,0 +1,169 @@
1
+ /**
2
+ * GUI/RPC-фасад над durable-запусками (Спринт 36.8).
3
+ *
4
+ * Тонкий слой между `runs-repo`/`run-context`/`run-resume` и RPC: приводит
5
+ * фильтр и лимит к безопасным значениям, отдаёт панели компактное описание
6
+ * запуска (текущий шаг, прогресс, история контекста) и не выпускает панику
7
+ * БД наружу.
8
+ *
9
+ * Resume здесь, как и retry в DLQ (36.6), только готовит запуск: снимает
10
+ * паузу/переоткрывает failed и возвращает первый незавершённый шаг.
11
+ * Выполнение шагов запускает исполнитель DAG через `resumeRun`, поэтому
12
+ * фасад не притворяется, что работа уже сделана.
13
+ */
14
+ import { getRun, listRuns, listRunSteps, reopenRun, } from "../db/runs-repo.js";
15
+ import { listRunInjections, pauseRun, } from "../db/run-context.js";
16
+ import { findResumeStep } from "../db/run-resume.js";
17
+ const MAX_CONTENT_PREVIEW = 500;
18
+ const DEFAULT_LIMIT = 20;
19
+ const MAX_LIMIT = 100;
20
+ const ACTIVE_STATUSES = ["pending", "running", "paused", "failed"];
21
+ function errorText(err) {
22
+ return err instanceof Error ? err.message : String(err);
23
+ }
24
+ /** Неизвестный фильтр трактуем как `active` — безопасный дефолт панели. */
25
+ export function normalizeRunPanelFilter(value) {
26
+ if (value === "all" || value === "active")
27
+ return value;
28
+ if (value === "pending" ||
29
+ value === "running" ||
30
+ value === "paused" ||
31
+ value === "passed" ||
32
+ value === "failed" ||
33
+ value === "cancelled") {
34
+ return value;
35
+ }
36
+ return "active";
37
+ }
38
+ function normalizeLimit(value, fallback = DEFAULT_LIMIT) {
39
+ const num = Math.floor(Number(value));
40
+ if (!Number.isFinite(num) || num < 1)
41
+ return fallback;
42
+ return Math.min(num, MAX_LIMIT);
43
+ }
44
+ function stepAnchor(runId, stepName) {
45
+ return `run-step-${runId}-${stepName.replace(/[^A-Za-z0-9_-]/g, "_")}`;
46
+ }
47
+ function toPanelStep(runId, step) {
48
+ return {
49
+ stepName: step.stepName,
50
+ position: step.position,
51
+ status: step.status,
52
+ attempt: step.attempt,
53
+ error: step.error,
54
+ anchor: stepAnchor(runId, step.stepName),
55
+ };
56
+ }
57
+ function toPanelInjection(injection) {
58
+ return {
59
+ id: injection.id,
60
+ kind: injection.kind,
61
+ content: injection.content.length > MAX_CONTENT_PREVIEW
62
+ ? `${injection.content.slice(0, MAX_CONTENT_PREVIEW)}…`
63
+ : injection.content,
64
+ contentLength: injection.content.length,
65
+ author: injection.author,
66
+ createdAt: injection.createdAt,
67
+ consumedAt: injection.consumedAt,
68
+ consumedByStep: injection.consumedByStep,
69
+ };
70
+ }
71
+ function isDone(step) {
72
+ return step.status === "passed" || step.status === "skipped";
73
+ }
74
+ /** Собирает компактное описание запуска. */
75
+ export function getRunPanelRun(runId) {
76
+ const run = getRun(runId);
77
+ if (!run)
78
+ return undefined;
79
+ return toPanelRun(run);
80
+ }
81
+ function toPanelRun(run) {
82
+ const steps = listRunSteps(run.id);
83
+ const panelSteps = steps.map((step) => toPanelStep(run.id, step));
84
+ const current = steps.find((step) => !isDone(step));
85
+ const allInjections = listRunInjections(run.id);
86
+ const injections = allInjections.slice(-20).map(toPanelInjection);
87
+ return {
88
+ id: run.id,
89
+ taskName: run.taskName,
90
+ status: run.status,
91
+ createdAt: run.createdAt,
92
+ startedAt: run.startedAt,
93
+ finishedAt: run.finishedAt,
94
+ error: run.error,
95
+ steps: panelSteps,
96
+ currentStep: current ? toPanelStep(run.id, current) : null,
97
+ doneSteps: steps.filter(isDone).length,
98
+ totalSteps: steps.length,
99
+ injections,
100
+ pendingInjections: allInjections.filter((item) => item.consumedAt === null).length,
101
+ };
102
+ }
103
+ /** Список запусков для панели и счётчик активных. */
104
+ export function listRunPanel(options = {}) {
105
+ try {
106
+ const filter = normalizeRunPanelFilter(options.filter);
107
+ const limit = normalizeLimit(options.limit);
108
+ const all = listRuns(undefined, MAX_LIMIT);
109
+ const matching = all.filter((run) => filter === "all"
110
+ ? true
111
+ : filter === "active"
112
+ ? ACTIVE_STATUSES.includes(run.status)
113
+ : run.status === filter);
114
+ return {
115
+ success: true,
116
+ runs: matching.slice(0, limit).map(toPanelRun),
117
+ active: all.filter((run) => ACTIVE_STATUSES.includes(run.status)).length,
118
+ };
119
+ }
120
+ catch (err) {
121
+ return { success: false, runs: [], active: 0, error: errorText(err) };
122
+ }
123
+ }
124
+ /**
125
+ * Пауза с комментарием. Ошибки (running-шаг, терминальный запуск, нет
126
+ * незавершённых шагов) возвращаются как `{ success: false }`, чтобы GUI
127
+ * показал их рядом с кнопкой.
128
+ */
129
+ export function pauseRunPanel(runId, input = {}) {
130
+ try {
131
+ const result = pauseRun(runId, input);
132
+ return {
133
+ success: true,
134
+ run: toPanelRun(result.run),
135
+ stepName: result.stepName,
136
+ };
137
+ }
138
+ catch (err) {
139
+ return { success: false, error: errorText(err) };
140
+ }
141
+ }
142
+ /**
143
+ * Resume только готовит запуск: paused/failed → running, шаг остаётся
144
+ * незавершённым. Дальше его выполняет `resumeRun`/внешний исполнитель DAG.
145
+ */
146
+ export function resumeRunPanel(runId) {
147
+ try {
148
+ const run = getRun(runId);
149
+ if (!run)
150
+ return { success: false, error: `Запуск не найден: ${runId}` };
151
+ if (run.status !== "paused" && run.status !== "failed") {
152
+ return {
153
+ success: false,
154
+ error: `Запуск в статусе ${run.status} нельзя возобновить: ${runId}`,
155
+ };
156
+ }
157
+ reopenRun(runId);
158
+ const next = findResumeStep(runId);
159
+ return {
160
+ success: true,
161
+ run: toPanelRun(getRun(runId)),
162
+ stepName: next?.stepName ?? null,
163
+ prepared: true,
164
+ };
165
+ }
166
+ catch (err) {
167
+ return { success: false, error: errorText(err) };
168
+ }
169
+ }
@@ -143,7 +143,11 @@ async function main() {
143
143
  spec = parseCron(cronExpr);
144
144
  }
145
145
  catch (err) {
146
- console.error(`[schedule-gate] Невалидный cron «${cronExpr}»: ${err instanceof Error ? err.message : String(err)} — пропускаем проверку cron.`);
146
+ // Fail-closed: при повреждённом cron проверка расписания невозможна.
147
+ // Если пропустить её (fail-open), задача с окном/днями будет
148
+ // запускаться на каждом минутном тике — включая дорогие LLM-агенты.
149
+ console.error(`[schedule-gate] ОШИБКА: невалидный cron «${cronExpr}»: ${err instanceof Error ? err.message : String(err)}. Запуск пропущен (fail-closed). Исправьте расписание задачи.`);
150
+ return 3;
147
151
  }
148
152
  }
149
153
  if (spec && !cronMatches(spec, now, zone)) {
@@ -29,10 +29,10 @@ export interface ParsedCron {
29
29
  /** День недели 0(Вс)..6(Сб) или null, если поле = «*» и не содержит «#». */
30
30
  dayOfWeek: Set<number> | null;
31
31
  /** Пары {weekday, n} для «#». */
32
- nthWeekday: Array<{
32
+ nthWeekday: {
33
33
  weekday: number;
34
34
  n: number;
35
- }>;
35
+ }[];
36
36
  }
37
37
  /** Разворачивает «@every 15m|2h|1d» в обычный cron. */
38
38
  export declare function normalizeCron(expr: string): string;
@@ -78,6 +78,26 @@ export declare function nextWindowOpenAt(now: Date, options: ActiveWindowOptions
78
78
  export declare function activeWindowState(now: Date, options?: ActiveWindowOptions): ActiveWindowState;
79
79
  /** Сколько мс до следующего разрешённого окна (0 — можно запускать). */
80
80
  export declare function nextWindowOpenDelayMs(now: Date, options?: ActiveWindowOptions): number;
81
+ export interface CronWindowFeasibility {
82
+ /** Будет ли хотя бы один запуск пропущен не из-за окна. */
83
+ feasible: boolean;
84
+ /** Сколько вхождений cron проверено. */
85
+ checked: number;
86
+ /** Ближайшее вхождение, которое окно/политика пропустят (ISO). */
87
+ firstRun?: string;
88
+ reason?: "never-fires" | "never-in-window" | "postpone-too-far";
89
+ }
90
+ /** Человекочитаемая причина недостижимости окна (P2-24). */
91
+ export declare function windowFeasibilityReasonText(reason: CronWindowFeasibility["reason"]): string;
92
+ /**
93
+ * P2-24: проверяет, не окажется ли cron навсегда отрезан окном запуска.
94
+ *
95
+ * `schedule-gate` откладывает запуск максимум на 12 ч. Если cron срабатывает
96
+ * только в 09:00, а окно 22:00–06:00, то до открытия всегда ~13 ч → каждый тик
97
+ * молча пропускается. Здесь это выявляется заранее (для предупреждения при
98
+ * создании задачи и в dry_run).
99
+ */
100
+ export declare function assessCronWindowFeasibility(expr: string, options?: ActiveWindowOptions, policy?: "skip" | "postpone" | "run", from?: Date, maxPostponeMs?: number, maxOccurrences?: number): CronWindowFeasibility;
81
101
  /**
82
102
  * true, если выражение умеет оформить Windows Task Scheduler «родными»
83
103
  * флагами (MINUTE/HOURLY/DAILY/WEEKLY) и парсится строгим конвертером.
@@ -86,6 +106,14 @@ export declare function nextWindowOpenDelayMs(now: Date, options?: ActiveWindowO
86
106
  export declare function isNativeSchtasksExpr(expr: string): boolean;
87
107
  /** Конвертер для родного режима; бросает Error для неподдерживаемых. */
88
108
  export declare function convertForSchtasks(expr: string): CronConversion;
109
+ /**
110
+ * true, если выражение можно записать в crontab как есть (Vixie-совместимый
111
+ * 5-полевой cron). В отличие от schtasks, crontab понимает списки, диапазоны,
112
+ * шаги и имена месяцев/дней недели — их не нужно загонять в минутный опрос.
113
+ * Quartz-расширения `L` / `d#n` и макросы вроде `@daily` (не 5 полей) crontab
114
+ * не понимает: для них нужен poll-режим с gate во враппере.
115
+ */
116
+ export declare function isNativePosixCronExpr(expr: string): boolean;
89
117
  /** Аргументы schedule-gate, которые запекаются во враппер (cron/tz/окно/пернос). */
90
118
  export interface ScheduleGateSpec {
91
119
  /**
@@ -107,6 +135,12 @@ export interface ScheduleGateSpec {
107
135
  * не конвертируемо в флаги schtasks) — нужен минутный опрос + gate.
108
136
  */
109
137
  export declare function needsPollMode(expr: string, timezone?: string | null): boolean;
138
+ /**
139
+ * Аналог needsPollMode для POSIX-бэков (crontab): чужой IANA-таймзона или
140
+ * не-Vixie-синтаксис заставляет опрашивать каждую минуту, остальное crontab
141
+ * выполняет сам. Списки/диапазоны/шаги/имена здесь родные.
142
+ */
143
+ export declare function needsPosixPollMode(expr: string, timezone?: string | null): boolean;
110
144
  /**
111
145
  * Аргументы schedule-gate для враппера, либо undefined — если врапперу гейт
112
146
  * не нужен (нативный cron + системный таймзона + окно не задано).
@@ -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 и обращения к ОС.
@@ -129,10 +131,10 @@ function expandField(token, min, max, names) {
129
131
  let item = raw.trim().toUpperCase();
130
132
  if (!item)
131
133
  throw new Error(t("schedule.error.cronEmptyItem", { token }));
132
- if (names && names[item] !== undefined)
134
+ if (names?.[item] !== undefined)
133
135
  item = String(names[item]);
134
136
  // шаг: a-b/n или */n
135
- const stepMatch = item.match(/^(.*)\/([0-9]+)$/);
137
+ const stepMatch = /^(.*)\/([0-9]+)$/.exec(item);
136
138
  let step = 1;
137
139
  if (stepMatch) {
138
140
  item = (stepMatch[1] ?? "").trim();
@@ -151,13 +153,13 @@ function expandField(token, min, max, names) {
151
153
  result.add(v);
152
154
  continue;
153
155
  }
154
- const rangeMatch = item.match(/^([0-9A-Z]+)-([0-9A-Z]+)$/);
156
+ const rangeMatch = /^([0-9A-Z]+)-([0-9A-Z]+)$/.exec(item);
155
157
  if (rangeMatch) {
156
158
  let aToken = rangeMatch[1];
157
159
  let bToken = rangeMatch[2];
158
- if (names && names[aToken] !== undefined)
160
+ if (names?.[aToken] !== undefined)
159
161
  aToken = String(names[aToken]);
160
- if (names && names[bToken] !== undefined)
162
+ if (names?.[bToken] !== undefined)
161
163
  bToken = String(names[bToken]);
162
164
  const a = Number(aToken);
163
165
  const b = Number(bToken);
@@ -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 }));
@@ -182,7 +193,7 @@ function expandField(token, min, max, names) {
182
193
  /** Разворачивает «@every 15m|2h|1d» в обычный cron. */
183
194
  export function normalizeCron(expr) {
184
195
  const trimmed = expr.trim();
185
- const match = trimmed.match(/^@every\s+(\d+)([mhd])$/i);
196
+ const match = /^@every\s+(\d+)([mhd])$/i.exec(trimmed);
186
197
  if (!match)
187
198
  return trimmed;
188
199
  const n = Number(match[1]);
@@ -230,7 +241,7 @@ export function parseCron(expr) {
230
241
  const tokens = dowF.trim().toUpperCase().split(",").map((s) => s.trim());
231
242
  const kept = [];
232
243
  for (const token of tokens) {
233
- const hash = token.match(/^([0-9A-Z]+)#([1-5])$/);
244
+ const hash = /^([0-9A-Z]+)#([1-5])$/.exec(token);
234
245
  if (hash) {
235
246
  let dToken = hash[1];
236
247
  if (DOW_NAMES[dToken] !== undefined)
@@ -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 + системный таймзона + окно не задано).
@@ -0,0 +1,95 @@
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
+ 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
+ }
49
+ /** Ошибка `spawn("at")`, означающая, что бинарник не найден. */
50
+ export declare function isAtMissingError(err: unknown): boolean;
51
+ /** Сколько секунд осталось до `runAt` (0, если момент уже прошёл). */
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;
61
+ /** Скрипт для `/bin/bash -c`: подождать и выполнить команду задачи. */
62
+ export declare function buildDetachedOneShotScript(entry: RegistryEntry, command: string, nowMs: number): string;
63
+ /** Является ли сохранённый id задания pid-ом fallback-процесса. */
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;
74
+ /**
75
+ * Запускает отвязанный one-shot и возвращает `pid:<pid>` для `cancelAt`.
76
+ * Промис резолвится сразу после успешного `spawn`, не дожидаясь выполнения.
77
+ */
78
+ export declare function scheduleAtFallback(entry: RegistryEntry, command: string, deps?: ScheduleAtFallbackDeps): Promise<string>;
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>;
95
+ //# 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":"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"}