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,12 @@
1
+ import type { CronConversion } from "../types.js";
2
+ /**
3
+ * Валидирует и преобразует 5-полевое cron-выражение во флаги schtasks.
4
+ * Возвращает CronConversion или выбрасывает Error с понятным сообщением.
5
+ */
6
+ export declare function convertCronToSchTasks(cron: string): CronConversion;
7
+ /**
8
+ * Формирует массив флагов расписания для schtasks на основе CronConversion.
9
+ * Включает /sc, /st (если есть), и дополнительные флаги (/mo, /d).
10
+ */
11
+ export declare function buildScheduleFlags(conversion: CronConversion): string[];
12
+ //# sourceMappingURL=cron-to-schtasks.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"cron-to-schtasks.d.ts","sourceRoot":"","sources":["../../src/core/cron-to-schtasks.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAgElD;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,GAAG,cAAc,CA4HlE;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,UAAU,EAAE,cAAc,GAAG,MAAM,EAAE,CAUvE"}
@@ -0,0 +1,175 @@
1
+ /**
2
+ * Сообщение об ошибке, возвращаемое при встрече неподдерживаемого cron-выражения.
3
+ * Содержит описание поддерживаемого подмножества.
4
+ * Собрано конкатенацией, чтобы избежать последовательности закрывающего комментария внутри строк.
5
+ */
6
+ const UNSUPPORTED_ERROR = "Неподдерживаемое cron-выражение.\n" +
7
+ "\n" +
8
+ "Поддерживаемое подмножество cron (5 полей: минута час день_месяца месяц день_недели):\n" +
9
+ " * * * * * -> MINUTE, каждую минуту (/mo 1)\n" +
10
+ " */N * * * * -> MINUTE, каждые N минут (/mo N)\n" +
11
+ " M * * * * -> HOURLY, ежечасно в MM минут (/st 00:MM)\n" +
12
+ " M H * * * -> DAILY, ежедневно в HH:MM (/st HH:MM)\n" +
13
+ " M H * * D -> WEEKLY, по неделям в день D в HH:MM (/d D /st HH:MM)\n" +
14
+ "\n" +
15
+ "Не поддерживаются: диапазоны (1-5), списки (1,2,3), комбинации месяца и дня недели,\n" +
16
+ "*/N в поле дня месяца или дня недели, а также любые другие сложные выражения.\n" +
17
+ "Выражение `M H */N * *` намеренно не превращается в DAILY /mo N: cron отсчитывает\n" +
18
+ "дни от 1-го числа месяца, а /mo N — от даты создания задачи, поэтому расписания\n" +
19
+ "не совпадают. Такие задачи выполняются в режиме минутного опроса (minute-poll).\n" +
20
+ "Пожалуйста, упростите расписание, используя одно из поддерживаемых выше выражений.";
21
+ /** Дни недели для schtasks /d (0 и 7 = воскресенье). */
22
+ const DAY_OF_WEEK_MAP = {
23
+ "0": "SUN",
24
+ "1": "MON",
25
+ "2": "TUE",
26
+ "3": "WED",
27
+ "4": "THU",
28
+ "5": "FRI",
29
+ "6": "SAT",
30
+ "7": "SUN",
31
+ };
32
+ /**
33
+ * Проверяет, является ли строка звездочкой "*".
34
+ */
35
+ function isStar(value) {
36
+ return value === "*";
37
+ }
38
+ /**
39
+ * Проверяет, является ли строка шаблоном звездочка-слэш-N (N — положительное целое).
40
+ * Возвращает N или undefined.
41
+ */
42
+ function parseStep(value) {
43
+ const match = /^\*\/(\d+)$/.exec(value);
44
+ if (!match)
45
+ return undefined;
46
+ const n = parseInt(match[1], 10);
47
+ return n > 0 ? n : undefined;
48
+ }
49
+ /**
50
+ * Проверяет, является ли строка одиночным целым числом в диапазоне [min, max].
51
+ * Возвращает число или undefined.
52
+ */
53
+ function parseIntInRange(value, min, max) {
54
+ if (!/^\d+$/.test(value))
55
+ return undefined;
56
+ const n = parseInt(value, 10);
57
+ return n >= min && n <= max ? n : undefined;
58
+ }
59
+ /**
60
+ * Валидирует и преобразует 5-полевое cron-выражение во флаги schtasks.
61
+ * Возвращает CronConversion или выбрасывает Error с понятным сообщением.
62
+ */
63
+ export function convertCronToSchTasks(cron) {
64
+ const fields = cron.trim().split(/\s+/);
65
+ if (fields.length !== 5) {
66
+ throw new Error("Ожидалось 5 полей cron-выражения (минута час день_месяца месяц день_недели), получено " +
67
+ fields.length +
68
+ ".\n\n" +
69
+ UNSUPPORTED_ERROR);
70
+ }
71
+ const [minute, hour, dayOfMonth, month, dayOfWeek] = fields;
72
+ // --- ПАТТЕРН 1: * * * * * -> MINUTE /mo 1 ---
73
+ if (isStar(minute) &&
74
+ isStar(hour) &&
75
+ isStar(dayOfMonth) &&
76
+ isStar(month) &&
77
+ isStar(dayOfWeek)) {
78
+ return {
79
+ sc: "MINUTE",
80
+ extraFlags: ["/mo", "1"],
81
+ };
82
+ }
83
+ // --- ПАТТЕРН 2: */N * * * * -> MINUTE /mo N ---
84
+ const stepN = parseStep(minute);
85
+ if (stepN !== undefined &&
86
+ isStar(hour) &&
87
+ isStar(dayOfMonth) &&
88
+ isStar(month) &&
89
+ isStar(dayOfWeek)) {
90
+ if (stepN > 1439) {
91
+ throw new Error("Интервал /mo " +
92
+ stepN +
93
+ " минут превышает максимально допустимый для schtasks (1439 минут).\n\n" +
94
+ UNSUPPORTED_ERROR);
95
+ }
96
+ // schtasks /mo Nanchors на момент создания задачи, а cron */N означает
97
+ // минуты 0, N, 2N … внутри часа. Семантики совпадают только когда N
98
+ // делит 60 без остатка И есть выровненный старт (00:00), поэтому ниже
99
+ // добавляется startTime: "00:00". Для N, не делящих 60, выбрасывается
100
+ // ошибка — задача уходит в минутный опрос с gate во враппере
101
+ // (needsPollMode в windows.ts), а не конвертируется здесь нативно.
102
+ if (60 % stepN !== 0) {
103
+ throw new Error("Интервал */" +
104
+ stepN +
105
+ " не делит час нацело: cron и schtasks понимают его по-разному.\n\n" +
106
+ UNSUPPORTED_ERROR);
107
+ }
108
+ return {
109
+ sc: "MINUTE",
110
+ extraFlags: ["/mo", String(stepN)],
111
+ // schtasks /mo Nanchors на момент создания задачи; cron */N означает
112
+ // минуты 0, N, 2N … внутри часа. Выровненный старт 00:00 делает
113
+ // расписание идентичным cron для любого N, делящего 60.
114
+ startTime: "00:00",
115
+ };
116
+ }
117
+ // --- ПАТТЕРН 3: M * * * * -> HOURLY /mo 1 /st 00:MM (каждый час в минуту M) ---
118
+ const mHourly = parseIntInRange(minute, 0, 59);
119
+ if (mHourly !== undefined &&
120
+ isStar(hour) &&
121
+ isStar(dayOfMonth) &&
122
+ isStar(month) &&
123
+ isStar(dayOfWeek)) {
124
+ return {
125
+ sc: "HOURLY",
126
+ extraFlags: ["/mo", "1"],
127
+ startTime: "00:" + String(mHourly).padStart(2, "0"),
128
+ };
129
+ }
130
+ // --- ПАТТЕРН 4: M H * * * -> DAILY /st HH:MM ---
131
+ const m = parseIntInRange(minute, 0, 59);
132
+ const h = parseIntInRange(hour, 0, 23);
133
+ if (m !== undefined &&
134
+ h !== undefined &&
135
+ isStar(dayOfMonth) &&
136
+ isStar(month) &&
137
+ isStar(dayOfWeek)) {
138
+ const startTime = String(h).padStart(2, "0") + ":" + String(m).padStart(2, "0");
139
+ return {
140
+ sc: "DAILY",
141
+ extraFlags: [],
142
+ startTime,
143
+ };
144
+ }
145
+ // --- ПАТТЕРН 4: M H * * D -> WEEKLY /d D /st HH:MM ---
146
+ const d = parseIntInRange(dayOfWeek, 0, 7);
147
+ if (m !== undefined &&
148
+ h !== undefined &&
149
+ isStar(dayOfMonth) &&
150
+ isStar(month) &&
151
+ d !== undefined) {
152
+ const startTime = String(h).padStart(2, "0") + ":" + String(m).padStart(2, "0");
153
+ const dayName = DAY_OF_WEEK_MAP[String(d)];
154
+ return {
155
+ sc: "WEEKLY",
156
+ extraFlags: ["/d", dayName],
157
+ startTime,
158
+ days: dayName,
159
+ };
160
+ }
161
+ // Ни один поддерживаемый паттерн не совпал.
162
+ throw new Error(UNSUPPORTED_ERROR);
163
+ }
164
+ /**
165
+ * Формирует массив флагов расписания для schtasks на основе CronConversion.
166
+ * Включает /sc, /st (если есть), и дополнительные флаги (/mo, /d).
167
+ */
168
+ export function buildScheduleFlags(conversion) {
169
+ const flags = ["/sc", conversion.sc];
170
+ if (conversion.startTime) {
171
+ flags.push("/st", conversion.startTime);
172
+ }
173
+ flags.push(...conversion.extraFlags);
174
+ return flags;
175
+ }
@@ -0,0 +1,102 @@
1
+ export interface DryRunRoleScoped {
2
+ allowed?: string[];
3
+ denied?: string[];
4
+ }
5
+ /**
6
+ * Детали триггера (Спринт 27): чем задача запускается и не будет ли запуск
7
+ * пропущен из-за окна/дней недели. Для git-триггера — состояние репозитория.
8
+ */
9
+ export interface DryRunTriggerDetails {
10
+ type: "manual" | "cron" | "file" | "git" | "mcp-event" | "once";
11
+ /** Человекочитаемое объяснение условия запуска. */
12
+ explanation: string;
13
+ /** Состояние окна запуска и разрешённых дней недели (если заданы). */
14
+ activeWindow?: {
15
+ active: boolean;
16
+ reason?: string;
17
+ nextOpenAt: string | null;
18
+ };
19
+ /** Состояние git-триггера на момент dry-run. */
20
+ git?: {
21
+ branch: string | null;
22
+ head: string | null;
23
+ lastCommit: string | null;
24
+ changedFiles: string[];
25
+ matched: string[];
26
+ };
27
+ /** Настройки файлового триггера. */
28
+ file?: {
29
+ watchPath: string | null;
30
+ globs: string[];
31
+ ignore: string[];
32
+ };
33
+ }
34
+ export interface DryRunTaskItem {
35
+ name: string;
36
+ order: number;
37
+ trigger: "manual" | "cron" | "dag" | "once";
38
+ cwd: string;
39
+ command: string;
40
+ workspace?: {
41
+ name: string;
42
+ path: string;
43
+ };
44
+ preFlight?: string | null;
45
+ postFlight?: string | null;
46
+ qualityGate?: string | null;
47
+ roleScoped?: DryRunRoleScoped | null;
48
+ estimatedDurationSec?: number | null;
49
+ estimatedCostUsd?: number | null;
50
+ estimatedTokens?: number | null;
51
+ /** Для клона матрицы — имя родителя-шаблона (Спринт 15). */
52
+ matrixParent?: string;
53
+ /** Режим сессии OpenCode (Спринт 24): new (по умолчанию), reuse, last. */
54
+ session?: string | null;
55
+ /** Идентификатор переиспользуемой сессии (только для session=reuse). */
56
+ sessionId?: string | null;
57
+ /**
58
+ * Windows-режим входа (Спринт 27.5.4): false — задача интерактивная и идёт
59
+ * только при активном входе пользователя (Interactive only); true — запуск
60
+ * без входа через `/ru SYSTEM` (session 0, без профиля пользователя).
61
+ * На Linux/macOS поле всегда false: cron работает без входа, launchd-агент —
62
+ * только при входе.
63
+ */
64
+ runWhenLoggedOff?: boolean;
65
+ /** Человекочитаемое пояснение к режиму входа (для отчёта dry-run). */
66
+ logonMode?: string | null;
67
+ /**
68
+ * Эффективное расписание cron-задачи (Спринт 19): пояс, окно запуска и
69
+ * ближайшие срабатывания с учётом часового пояса. Позволяет проверить
70
+ * пересчёт cron до регистрации в ОС.
71
+ */
72
+ scheduleDetails?: {
73
+ cron: string;
74
+ timezone: string | null;
75
+ notBefore: string | null;
76
+ notAfter: string | null;
77
+ pausedUntil: string | null;
78
+ nextRuns: string[];
79
+ };
80
+ /** Детали триггера и причина возможного пропуска (Спринт 27). */
81
+ triggerDetails?: DryRunTriggerDetails;
82
+ }
83
+ export interface DryRunTotals {
84
+ estimatedDurationSec?: number | null;
85
+ estimatedCostUsd?: number | null;
86
+ estimatedTokens?: number | null;
87
+ }
88
+ export interface DryRunReport {
89
+ success: boolean;
90
+ taskName: string;
91
+ tasks: DryRunTaskItem[];
92
+ totals: DryRunTotals;
93
+ warnings: string[];
94
+ }
95
+ /** Средняя цена за 1K токенов (должна совпадать с dashboards/server.ts). */
96
+ export declare const ESTIMATED_COST_PER_1K_TOKENS_USD = 0.003;
97
+ /**
98
+ * Симулирует конвейер задачи: сама задача + все зависимости (dependsOn)
99
+ * в топологическом порядке. Возвращает отчёт без реального запуска.
100
+ */
101
+ export declare function simulatePipeline(taskName: string): Promise<DryRunReport>;
102
+ //# sourceMappingURL=dry-run.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"dry-run.d.ts","sourceRoot":"","sources":["../../src/core/dry-run.ts"],"names":[],"mappings":"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"}