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,601 @@
1
+ /**
2
+ * Dry-Run (Спринт 14): симуляция конвейера задачи без реального запуска.
3
+ *
4
+ * Строит топологический порядок зависимостей, показывает фактические команды,
5
+ * cwd, роли (ограничения инструментов) и оценки по последним запускам.
6
+ * Никогда не исполняет команды — только анализ определений.
7
+ */
8
+ import fs from "node:fs";
9
+ import { loadTaskDefinitions } from "../task-transfer.js";
10
+ import { getHistory } from "../db/history-repo.js";
11
+ import { getWorkspace } from "../workspaces.js";
12
+ import { expandMatrixTask } from "./matrix.js";
13
+ import { nextRun, activeWindowState } from "./schedule-v2.js";
14
+ import { checkGitTrigger } from "./git-trigger.js";
15
+ import { t } from "../i18n.js";
16
+ import type { TaskDefinition } from "../task-transfer.js";
17
+
18
+ export interface DryRunRoleScoped {
19
+ allowed?: string[];
20
+ denied?: string[];
21
+ }
22
+
23
+ /**
24
+ * Детали триггера (Спринт 27): чем задача запускается и не будет ли запуск
25
+ * пропущен из-за окна/дней недели. Для git-триггера — состояние репозитория.
26
+ */
27
+ export interface DryRunTriggerDetails {
28
+ type: "manual" | "cron" | "file" | "git" | "mcp-event" | "once";
29
+ /** Человекочитаемое объяснение условия запуска. */
30
+ explanation: string;
31
+ /** Состояние окна запуска и разрешённых дней недели (если заданы). */
32
+ activeWindow?: {
33
+ active: boolean;
34
+ reason?: string;
35
+ nextOpenAt: string | null;
36
+ };
37
+ /** Состояние git-триггера на момент dry-run. */
38
+ git?: {
39
+ branch: string | null;
40
+ head: string | null;
41
+ lastCommit: string | null;
42
+ changedFiles: string[];
43
+ matched: string[];
44
+ };
45
+ /** Настройки файлового триггера. */
46
+ file?: {
47
+ watchPath: string | null;
48
+ globs: string[];
49
+ ignore: string[];
50
+ };
51
+ }
52
+
53
+ export interface DryRunTaskItem {
54
+ name: string;
55
+ order: number;
56
+ trigger: "manual" | "cron" | "dag" | "once";
57
+ cwd: string;
58
+ command: string;
59
+ workspace?: { name: string; path: string };
60
+ preFlight?: string | null;
61
+ postFlight?: string | null;
62
+ qualityGate?: string | null;
63
+ roleScoped?: DryRunRoleScoped | null;
64
+ estimatedDurationSec?: number | null;
65
+ estimatedCostUsd?: number | null;
66
+ estimatedTokens?: number | null;
67
+ /** Для клона матрицы — имя родителя-шаблона (Спринт 15). */
68
+ matrixParent?: string;
69
+ /** Режим сессии OpenCode (Спринт 24): new (по умолчанию), reuse, last. */
70
+ session?: string | null;
71
+ /** Идентификатор переиспользуемой сессии (только для session=reuse). */
72
+ sessionId?: string | null;
73
+ /**
74
+ * Windows-режим входа (Спринт 27.5.4): false — задача интерактивная и идёт
75
+ * только при активном входе пользователя (Interactive only); true — запуск
76
+ * без входа через `/ru SYSTEM` (session 0, без профиля пользователя).
77
+ * На Linux/macOS поле всегда false: cron работает без входа, launchd-агент —
78
+ * только при входе.
79
+ */
80
+ runWhenLoggedOff?: boolean;
81
+ /** Человекочитаемое пояснение к режиму входа (для отчёта dry-run). */
82
+ logonMode?: string | null;
83
+ /**
84
+ * Эффективное расписание cron-задачи (Спринт 19): пояс, окно запуска и
85
+ * ближайшие срабатывания с учётом часового пояса. Позволяет проверить
86
+ * пересчёт cron до регистрации в ОС.
87
+ */
88
+ scheduleDetails?: {
89
+ cron: string;
90
+ timezone: string | null;
91
+ notBefore: string | null;
92
+ notAfter: string | null;
93
+ pausedUntil: string | null;
94
+ nextRuns: string[];
95
+ };
96
+ /** Детали триггера и причина возможного пропуска (Спринт 27). */
97
+ triggerDetails?: DryRunTriggerDetails;
98
+ }
99
+
100
+ export interface DryRunTotals {
101
+ estimatedDurationSec?: number | null;
102
+ estimatedCostUsd?: number | null;
103
+ estimatedTokens?: number | null;
104
+ }
105
+
106
+ export interface DryRunReport {
107
+ success: boolean;
108
+ taskName: string;
109
+ tasks: DryRunTaskItem[];
110
+ totals: DryRunTotals;
111
+ warnings: string[];
112
+ }
113
+
114
+ /** Сколько последних успешных/любых запусков усредняем для оценки. */
115
+ const ESTIMATE_SAMPLE = 10;
116
+
117
+ /** Средняя цена за 1K токенов (должна совпадать с dashboards/server.ts). */
118
+ export const ESTIMATED_COST_PER_1K_TOKENS_USD = 0.003;
119
+
120
+ /** Опасные паттерны, о которых обязательно предупреждаем (ключи каталога). */
121
+ const DANGEROUS_PATTERNS: { test: RegExp; messageKey: string }[] = [
122
+ { test: /rm\s+-rf\s+\/(?:\s|$)/, messageKey: "dryRun.danger.rmRoot" },
123
+ { test: /git\s+push\s+.*--force(?:\s|$)/, messageKey: "dryRun.danger.forcePush" },
124
+ ];
125
+
126
+ /**
127
+ * Свойства для описания триггера задачи в dry-run (Спринт 27).
128
+ */
129
+ interface DescribeTriggerOptions {
130
+ /** Задание задачи (может содержать новые поля Спринта 27). */
131
+ def: TaskDefinition;
132
+ /** Эффективная рабочая директория задачи. */
133
+ cwd: string;
134
+ /** Вычисляемый тип триггера для поля `trigger`. */
135
+ triggerType: string;
136
+ /** Куда накапливать предупреждения (префикс [task] добавится в цикле). */
137
+ warnings: string[];
138
+ }
139
+
140
+ /**
141
+ * Описывает триггер задачи: что запускает задачу, не будет ли запуск
142
+ * пропущен из-за окна/дней недели, и (для git) состояние репозитория.
143
+ * Не имеет побочных эффектов (для git используется persist: false).
144
+ */
145
+ async function describeTrigger(opts: DescribeTriggerOptions): Promise<DryRunTriggerDetails> {
146
+ const { def, cwd, triggerType, warnings } = opts;
147
+ const policy: "skip" | "postpone" | "run" = def.windowPolicy ?? "postpone";
148
+
149
+ const base: DryRunTriggerDetails = {
150
+ type: triggerType as DryRunTriggerDetails["type"],
151
+ explanation: "",
152
+ };
153
+
154
+ const hasWindow = Boolean((def.notBefore ?? "").trim() || (def.notAfter ?? "").trim());
155
+ const hasDays = Array.isArray(def.activeDays) && def.activeDays.length > 0;
156
+
157
+ switch (triggerType) {
158
+ case "git": {
159
+ try {
160
+ const result = await checkGitTrigger(
161
+ {
162
+ name: def.name,
163
+ cwd,
164
+ branch: def.gitBranch ?? undefined,
165
+ paths: def.gitPaths ?? undefined,
166
+ ignore: def.gitIgnore ?? undefined,
167
+ },
168
+ { persist: false },
169
+ );
170
+ base.git = {
171
+ branch: result.branch ?? null,
172
+ head: result.head ?? null,
173
+ lastCommit: result.from ?? null,
174
+ changedFiles: result.files,
175
+ matched: result.matched,
176
+ };
177
+ base.explanation = result.message;
178
+
179
+ if (result.status === "no-repo") {
180
+ warnings.push(t("dryRun.git.notRepo"));
181
+ } else if (result.status === "branch-mismatch") {
182
+ warnings.push(
183
+ t("dryRun.git.branchMismatch", { branch: def.gitBranch ?? "" }),
184
+ );
185
+ }
186
+ } catch (err: any) {
187
+ base.explanation = t("dryRun.git.checkError", {
188
+ error: err instanceof Error ? err.message : String(err),
189
+ });
190
+ warnings.push(base.explanation);
191
+ }
192
+ break;
193
+ }
194
+
195
+ case "file": {
196
+ base.file = {
197
+ watchPath: def.watchPath ?? null,
198
+ globs: Array.isArray(def.watchGlobs) ? def.watchGlobs : [],
199
+ ignore: Array.isArray(def.watchIgnore) ? def.watchIgnore : [],
200
+ };
201
+ const parts: string[] = [];
202
+ if (def.watchPath) parts.push(`«${def.watchPath}»`);
203
+ if (def.watchGlobs?.length)
204
+ parts.push(t("dryRun.file.globs", { count: def.watchGlobs.length }));
205
+ if (def.watchIgnore?.length)
206
+ parts.push(t("dryRun.file.ignore", { count: def.watchIgnore.length }));
207
+ base.explanation =
208
+ parts.length > 0
209
+ ? t("dryRun.file.trigger", { parts: parts.join("; ") })
210
+ : t("dryRun.file.any");
211
+ break;
212
+ }
213
+
214
+ case "mcp-event": {
215
+ const ev = def.mcpEvent;
216
+ base.explanation = ev?.event
217
+ ? t("dryRun.mcp.event", {
218
+ server: ev.server,
219
+ event: ev.event,
220
+ filter: ev.filter
221
+ ? t("dryRun.mcp.filter", { filter: ev.filter })
222
+ : "",
223
+ })
224
+ : t("dryRun.mcp.missing");
225
+ break;
226
+ }
227
+
228
+ case "cron": {
229
+ base.explanation = def.timezone
230
+ ? t("dryRun.cronTimezone", {
231
+ schedule: def.schedule,
232
+ timezone: def.timezone,
233
+ })
234
+ : t("dryRun.cron", { schedule: def.schedule });
235
+ break;
236
+ }
237
+
238
+ case "once": {
239
+ base.explanation = def.runAt
240
+ ? t("dryRun.once.at", { runAt: def.runAt })
241
+ : t("dryRun.once");
242
+ break;
243
+ }
244
+
245
+ case "manual":
246
+ default: {
247
+ base.explanation = t("dryRun.manual");
248
+ break;
249
+ }
250
+ }
251
+
252
+ // Окно запуска и дни недели (если заданы).
253
+ if (hasWindow || hasDays) {
254
+ const state = activeWindowState(new Date(), {
255
+ notBefore: def.notBefore ?? undefined,
256
+ notAfter: def.notAfter ?? undefined,
257
+ days: def.activeDays ?? undefined,
258
+ timeZone: def.timezone ?? undefined,
259
+ });
260
+ base.activeWindow = {
261
+ active: state.active,
262
+ ...(state.reason ? { reason: state.reason } : {}),
263
+ nextOpenAt: state.nextOpenAt ? state.nextOpenAt.toISOString() : null,
264
+ };
265
+
266
+ if (!state.active && policy !== "run") {
267
+ const reason = state.reason ?? t("dryRun.window.outside");
268
+ if (policy === "skip") {
269
+ warnings.push(t("dryRun.window.skip", { reason }));
270
+ } else {
271
+ // postpone — переносим на ближайшее открытие.
272
+ const iso = base.activeWindow.nextOpenAt ?? null;
273
+ warnings.push(
274
+ iso
275
+ ? t("dryRun.window.postpone", { reason, nextOpenAt: iso })
276
+ : t("dryRun.window.noOpening", { reason }),
277
+ );
278
+ }
279
+ } else if (!state.active && policy === "run") {
280
+ warnings.push(
281
+ t("dryRun.window.run", {
282
+ reason: state.reason ?? t("dryRun.window.outside"),
283
+ }),
284
+ );
285
+ }
286
+ }
287
+
288
+ return base;
289
+ }
290
+
291
+ /**
292
+ * Симулирует конвейер задачи: сама задача + все зависимости (dependsOn)
293
+ * в топологическом порядке. Возвращает отчёт без реального запуска.
294
+ */
295
+ export async function simulatePipeline(taskName: string): Promise<DryRunReport> {
296
+ const warnings: string[] = [];
297
+
298
+ const allDefs = await loadTaskDefinitions();
299
+ const rootLower = taskName.trim().toLowerCase();
300
+ const root = allDefs.find((d) => d.name.toLowerCase() === rootLower);
301
+ if (!root) {
302
+ throw new Error(t("dryRun.taskNotFound", { task: taskName }));
303
+ }
304
+
305
+ // Собираем подграф зависимостей рекурсивно, обнаруживая циклы.
306
+ const byLower = new Map<string, TaskDefinition>(allDefs.map((d) => [d.name.toLowerCase(), d]));
307
+ const visited = new Map<string, TaskDefinition>(); // lower -> def
308
+ const visiting = new Set<string>();
309
+ const warningsPerTask = new Map<string, string[]>();
310
+
311
+ const collect = (lowerName: string): TaskDefinition | undefined => {
312
+ if (visiting.has(lowerName)) {
313
+ const list = warningsPerTask.get(lowerName) ?? [];
314
+ list.push(t("dryRun.cycle", { task: lowerName }));
315
+ warningsPerTask.set(lowerName, list);
316
+ return undefined;
317
+ }
318
+ const cached = visited.get(lowerName);
319
+ if (cached) return cached;
320
+ const def = byLower.get(lowerName);
321
+ if (!def) {
322
+ const list = warningsPerTask.get(lowerName) ?? [];
323
+ list.push(t("dryRun.dependencyMissing", { task: lowerName }));
324
+ warningsPerTask.set(lowerName, list);
325
+ return undefined;
326
+ }
327
+ visiting.add(lowerName);
328
+ for (const dep of def.dependsOn ?? []) {
329
+ const depLower = (dep ?? "").trim().toLowerCase();
330
+ if (depLower) collect(depLower);
331
+ }
332
+ visiting.delete(lowerName);
333
+ visited.set(lowerName, def);
334
+ return def;
335
+ };
336
+
337
+ collect(root.name.toLowerCase());
338
+
339
+ // Топологический порядок: сначала зависимости (Kahn поверх собранного подграфа).
340
+ const ordered: TaskDefinition[] = [];
341
+ {
342
+ const pending = [...visited.values()];
343
+ const emitted = new Set<string>();
344
+ let progress = true;
345
+ while (pending.length > 0 && progress) {
346
+ progress = false;
347
+ for (let i = 0; i < pending.length; i++) {
348
+ const def = pending[i];
349
+ const deps = (def.dependsOn ?? []).map((d) => (d ?? "").trim().toLowerCase()).filter(Boolean);
350
+ const unmet = deps.filter((d) => visited.has(d) && !emitted.has(d));
351
+ if (unmet.length === 0) {
352
+ ordered.push(def);
353
+ emitted.add(def.name.toLowerCase());
354
+ pending.splice(i, 1);
355
+ i--;
356
+ progress = true;
357
+ }
358
+ }
359
+ }
360
+ // Если остались (цикл), добавляем как есть — предупреждение уже записано.
361
+ for (const leftover of pending) ordered.push(leftover);
362
+ }
363
+
364
+ const history = getHistory(null, 1000);
365
+ const historyByTask = new Map<string, typeof history>();
366
+ for (const record of history) {
367
+ const list = historyByTask.get(record.taskName.toLowerCase()) ?? [];
368
+ list.push(record);
369
+ historyByTask.set(record.taskName.toLowerCase(), list);
370
+ }
371
+
372
+ const tasks: DryRunTaskItem[] = [];
373
+ let totalDuration: number | null = 0;
374
+ let totalCost: number | null = 0;
375
+ let totalTokens: number | null = 0;
376
+
377
+ // Matrix (Спринт 15): родитель сам не выполняется — вместо него в отчёте
378
+ // показываем клоны, по одному на workspace, с их cwd и оценками.
379
+ const units: { def: TaskDefinition; matrixParent?: string }[] = [];
380
+ for (const def of ordered) {
381
+ if (def.matrix) {
382
+ try {
383
+ const clones = expandMatrixTask(def);
384
+ warnings.push(
385
+ t("dryRun.matrix.parent", { name: def.name, count: clones.length }),
386
+ );
387
+ for (const clone of clones) units.push({ def: clone, matrixParent: def.name });
388
+ } catch (err: any) {
389
+ const list = warningsPerTask.get(def.name.toLowerCase()) ?? [];
390
+ list.push(
391
+ t("dryRun.matrix.expandError", {
392
+ error: err instanceof Error ? err.message : String(err),
393
+ }),
394
+ );
395
+ warningsPerTask.set(def.name.toLowerCase(), list);
396
+ warnings.push(`[${def.name}] ${list[list.length - 1]}`);
397
+ }
398
+ continue;
399
+ }
400
+ units.push({ def });
401
+ }
402
+
403
+ // Родители матриц с параллельной стратегией: их клоны считаются max, не sum.
404
+ const parallelMatrixParents = new Set(
405
+ allDefs
406
+ .filter((d) => d.matrix && (d.matrix.strategy ?? "parallel") !== "sequential")
407
+ .map((d) => d.name.toLowerCase()),
408
+ );
409
+ const parallelGroups = new Map<string, { maxDuration: number }>();
410
+
411
+ for (let index = 0; index < units.length; index++) {
412
+ const { def, matrixParent } = units[index];
413
+ const lower = def.name.toLowerCase();
414
+ const taskWarnings = warningsPerTask.get(lower) ?? [];
415
+
416
+ // cwd: workspace имеет приоритет над workingDirectory (как в schedulerCreateTask).
417
+ const workspace = def.workspaceId ? getWorkspace(def.workspaceId) : undefined;
418
+ const cwd = workspace?.path || def.workingDirectory || def.workdir || "";
419
+ if (!cwd) {
420
+ taskWarnings.push(t("dryRun.cwdImplicit"));
421
+ } else {
422
+ try {
423
+ const stat = fs.statSync(cwd);
424
+ if (!stat.isDirectory()) {
425
+ taskWarnings.push(t("dryRun.cwdNotDir", { path: cwd }));
426
+ }
427
+ } catch {
428
+ taskWarnings.push(t("dryRun.cwdMissing", { path: cwd }));
429
+ }
430
+ }
431
+
432
+ // Триггер: корневая задача (или клон корневой матрицы) — manual,
433
+ // остальные попали в конвейер через dependsOn — dag.
434
+ const triggerType = def.triggerType ?? "cron";
435
+ const trigger: DryRunTaskItem["trigger"] =
436
+ triggerType === "once"
437
+ ? "once"
438
+ : lower === rootLower || (matrixParent && matrixParent.toLowerCase() === rootLower)
439
+ ? "manual"
440
+ : "dag";
441
+
442
+ // Детали триггера (Спринт 27): состояние окна/дней недели, git-статус.
443
+ const triggerDetails = await describeTrigger({
444
+ def,
445
+ cwd,
446
+ triggerType,
447
+ warnings: taskWarnings,
448
+ });
449
+
450
+ // Команда, которую выполнит обёртка.
451
+ const modelArg = def.model ? ` --model ${def.model}` : "";
452
+ const promptPreview = (def.prompt ?? "").replace(/\s+/g, " ").trim();
453
+ const command = `opencode run${modelArg} "${promptPreview}"`;
454
+
455
+ // Оценки: среднее по последним ESTIMATE_SAMPLE записям истории.
456
+ const records = (historyByTask.get(lower) ?? []).filter((r) => r.status === "success");
457
+ let estimatedDurationSec: number | null = null;
458
+ let estimatedCostUsd: number | null = null;
459
+ let estimatedTokens: number | null = null;
460
+ if (records.length === 0) {
461
+ taskWarnings.push(t("dryRun.noHistory"));
462
+ } else {
463
+ const sample = records.slice(0, ESTIMATE_SAMPLE);
464
+ const avg = (pick: (r: (typeof sample)[number]) => number | null | undefined) => {
465
+ const values = sample.map(pick).filter((v): v is number => typeof v === "number" && Number.isFinite(v));
466
+ return values.length > 0 ? values.reduce((a, b) => a + b, 0) / values.length : null;
467
+ };
468
+ const avgMs = avg((r) => r.durationMs);
469
+ if (avgMs != null) estimatedDurationSec = Math.round(avgMs / 100) / 10;
470
+ estimatedTokens = avg((r) => r.tokens) ?? null;
471
+ if (estimatedTokens != null) {
472
+ estimatedCostUsd = (estimatedTokens / 1000) * ESTIMATED_COST_PER_1K_TOKENS_USD;
473
+ }
474
+ }
475
+
476
+ // Проверяем опасные паттерны в промпте и хуках.
477
+ const scanned = [def.prompt, def.beforeScript, def.afterScript, def.qualityGate]
478
+ .filter((s): s is string => typeof s === "string")
479
+ .join("\n")
480
+ .toLowerCase();
481
+ for (const { test, messageKey } of DANGEROUS_PATTERNS) {
482
+ if (test.test(scanned)) {
483
+ taskWarnings.push(
484
+ t("dryRun.dangerPattern", { message: t(messageKey) }),
485
+ );
486
+ }
487
+ }
488
+
489
+ const roleScoped: DryRunRoleScoped | null =
490
+ Array.isArray(def.allowedTools) && def.allowedTools.length > 0
491
+ ? { allowed: def.allowedTools, denied: def.deniedTools }
492
+ : Array.isArray(def.deniedTools) && def.deniedTools.length > 0
493
+ ? { allowed: undefined, denied: def.deniedTools }
494
+ : null;
495
+
496
+ // Эффективное расписание cron-задачи (Спринт 19): ближайшие срабатывания
497
+ // считаем в часовом поясе задачи, чтобы dry-run показывал то же время, что
498
+ // увидит планировщик после регистрации.
499
+ let scheduleDetails: DryRunTaskItem["scheduleDetails"];
500
+ if (triggerType === "once" && def.runAt) {
501
+ // Для разовой задачи dry-run показывает единственное запланированное время.
502
+ scheduleDetails = {
503
+ cron: "once",
504
+ timezone: def.timezone ?? null,
505
+ notBefore: def.notBefore ?? null,
506
+ notAfter: def.notAfter ?? null,
507
+ pausedUntil: def.pausedUntil ?? null,
508
+ nextRuns: [def.runAt],
509
+ };
510
+ } else if (triggerType === "cron" && def.schedule) {
511
+ const runs: string[] = [];
512
+ try {
513
+ let cursor = new Date();
514
+ for (let i = 0; i < 3; i++) {
515
+ const next = nextRun(def.schedule, cursor, def.timezone);
516
+ if (!next) break;
517
+ runs.push(next.toISOString());
518
+ cursor = next;
519
+ }
520
+ } catch {
521
+ taskWarnings.push(
522
+ t("dryRun.cronParseError", { schedule: def.schedule }),
523
+ );
524
+ }
525
+ scheduleDetails = {
526
+ cron: def.schedule,
527
+ timezone: def.timezone ?? null,
528
+ notBefore: def.notBefore ?? null,
529
+ notAfter: def.notAfter ?? null,
530
+ pausedUntil: def.pausedUntil ?? null,
531
+ nextRuns: runs,
532
+ };
533
+ }
534
+
535
+ tasks.push({
536
+ name: def.name,
537
+ order: index,
538
+ trigger,
539
+ session: def.session ?? "new",
540
+ sessionId: def.session === "reuse" ? def.sessionId ?? null : null,
541
+ // Спринт 27.5.4: показываем режим входа до регистрации в ОС.
542
+ runWhenLoggedOff: def.runWhenLoggedOff === true,
543
+ logonMode: def.runWhenLoggedOff === true ? "background" : "interactive",
544
+ cwd,
545
+ command,
546
+ workspace: workspace ? { name: workspace.name, path: workspace.path } : undefined,
547
+ preFlight: def.beforeScript ?? null,
548
+ postFlight: def.afterScript ?? null,
549
+ qualityGate: def.qualityGate ?? null,
550
+ roleScoped,
551
+ estimatedDurationSec,
552
+ estimatedCostUsd: estimatedCostUsd != null ? Math.round(estimatedCostUsd * 10000) / 10000 : null,
553
+ estimatedTokens: estimatedTokens != null ? Math.round(estimatedTokens) : null,
554
+ ...(matrixParent ? { matrixParent } : {}),
555
+ ...(scheduleDetails ? { scheduleDetails } : {}),
556
+ ...(triggerDetails ? { triggerDetails } : {}),
557
+ });
558
+
559
+ if (taskWarnings.length > 0) {
560
+ for (const warning of taskWarnings) {
561
+ warnings.push(`[${def.name}] ${warning}`);
562
+ }
563
+ }
564
+
565
+ // Суммируем оценки (null не ломает сумму). Для параллельных матриц
566
+ // длительность берём максимумом по группе, а не суммой клонов.
567
+ if (matrixParent && parallelMatrixParents.has(matrixParent.toLowerCase())) {
568
+ const key = matrixParent.toLowerCase();
569
+ const current = parallelGroups.get(key) ?? { maxDuration: 0 };
570
+ current.maxDuration = Math.max(current.maxDuration, estimatedDurationSec ?? 0);
571
+ parallelGroups.set(key, current);
572
+ } else if (totalDuration != null) {
573
+ totalDuration = totalDuration + (estimatedDurationSec ?? 0);
574
+ }
575
+ if (totalTokens != null) totalTokens = totalTokens + (estimatedTokens ?? 0);
576
+ if (totalCost != null) totalCost = totalCost + (estimatedCostUsd ?? 0);
577
+ }
578
+
579
+ for (const group of parallelGroups.values()) {
580
+ if (totalDuration != null) totalDuration = totalDuration + group.maxDuration;
581
+ }
582
+
583
+ const hasAnyEstimate = tasks.some(
584
+ (t) => t.estimatedDurationSec != null || t.estimatedCostUsd != null || t.estimatedTokens != null,
585
+ );
586
+ const totals: DryRunTotals = hasAnyEstimate
587
+ ? {
588
+ estimatedDurationSec: totalDuration != null ? Math.round(totalDuration * 10) / 10 : null,
589
+ estimatedCostUsd: totalCost != null ? Math.round(totalCost * 10000) / 10000 : null,
590
+ estimatedTokens: totalTokens != null ? Math.round(totalTokens) : null,
591
+ }
592
+ : { estimatedDurationSec: null, estimatedCostUsd: null, estimatedTokens: null };
593
+
594
+ return {
595
+ success: true,
596
+ taskName: root.name,
597
+ tasks,
598
+ totals,
599
+ warnings,
600
+ };
601
+ }