agent-steward 0.0.4 → 0.0.6

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 (279) hide show
  1. package/CHANGELOG.md +309 -2
  2. package/CROSS_PLATFORM.md +19 -0
  3. package/README.md +55 -8
  4. package/ROADMAP-STRATEGY.md +22 -19
  5. package/ROADMAP.md +230 -159
  6. package/dist/cli.d.ts +3 -0
  7. package/dist/cli.d.ts.map +1 -0
  8. package/dist/cli.js +356 -0
  9. package/dist/core/analytics.d.ts +6 -0
  10. package/dist/core/analytics.d.ts.map +1 -1
  11. package/dist/core/analytics.js +20 -3
  12. package/dist/core/audit.d.ts +6 -0
  13. package/dist/core/audit.d.ts.map +1 -1
  14. package/dist/core/audit.js +24 -0
  15. package/dist/core/budget.d.ts +118 -0
  16. package/dist/core/budget.d.ts.map +1 -0
  17. package/dist/core/budget.js +206 -0
  18. package/dist/core/cron-to-schtasks.d.ts.map +1 -1
  19. package/dist/core/cron-to-schtasks.js +38 -0
  20. package/dist/core/dry-run.d.ts +26 -1
  21. package/dist/core/dry-run.d.ts.map +1 -1
  22. package/dist/core/dry-run.js +199 -8
  23. package/dist/core/execution.d.ts +203 -0
  24. package/dist/core/execution.d.ts.map +1 -0
  25. package/dist/core/execution.js +309 -0
  26. package/dist/core/feedback.d.ts +192 -0
  27. package/dist/core/feedback.d.ts.map +1 -0
  28. package/dist/core/feedback.js +426 -0
  29. package/dist/core/gate-integrity.d.ts +71 -0
  30. package/dist/core/gate-integrity.d.ts.map +1 -0
  31. package/dist/core/gate-integrity.js +275 -0
  32. package/dist/core/git-trigger.d.ts.map +1 -1
  33. package/dist/core/git-trigger.js +14 -2
  34. package/dist/core/guard-run.d.ts +4 -0
  35. package/dist/core/guard-run.d.ts.map +1 -0
  36. package/dist/core/guard-run.js +101 -0
  37. package/dist/core/guard.d.ts +52 -0
  38. package/dist/core/guard.d.ts.map +1 -0
  39. package/dist/core/guard.js +362 -0
  40. package/dist/core/local-ai.d.ts.map +1 -1
  41. package/dist/core/local-ai.js +7 -3
  42. package/dist/core/lock.d.ts +41 -0
  43. package/dist/core/lock.d.ts.map +1 -1
  44. package/dist/core/lock.js +141 -29
  45. package/dist/core/matrix.d.ts +8 -0
  46. package/dist/core/matrix.d.ts.map +1 -1
  47. package/dist/core/matrix.js +132 -17
  48. package/dist/core/mission.d.ts +103 -0
  49. package/dist/core/mission.d.ts.map +1 -0
  50. package/dist/core/mission.js +374 -0
  51. package/dist/core/opencode-models.d.ts +2 -2
  52. package/dist/core/opencode-models.d.ts.map +1 -1
  53. package/dist/core/opencode-models.js +28 -21
  54. package/dist/core/opencode-usage.d.ts +35 -0
  55. package/dist/core/opencode-usage.d.ts.map +1 -0
  56. package/dist/core/opencode-usage.js +132 -0
  57. package/dist/core/pipeline-apply.d.ts +38 -0
  58. package/dist/core/pipeline-apply.d.ts.map +1 -0
  59. package/dist/core/pipeline-apply.js +117 -0
  60. package/dist/core/pipeline-io.d.ts +13 -0
  61. package/dist/core/pipeline-io.d.ts.map +1 -0
  62. package/dist/core/pipeline-io.js +78 -0
  63. package/dist/core/pipeline-map.d.ts +52 -0
  64. package/dist/core/pipeline-map.d.ts.map +1 -0
  65. package/dist/core/pipeline-map.js +208 -0
  66. package/dist/core/pipeline-spec.d.ts +109 -0
  67. package/dist/core/pipeline-spec.d.ts.map +1 -0
  68. package/dist/core/pipeline-spec.js +554 -0
  69. package/dist/core/ps-wrapper.d.ts +27 -2
  70. package/dist/core/ps-wrapper.d.ts.map +1 -1
  71. package/dist/core/ps-wrapper.js +424 -65
  72. package/dist/core/record-history.d.ts.map +1 -1
  73. package/dist/core/record-history.js +206 -33
  74. package/dist/core/router/rules.d.ts.map +1 -1
  75. package/dist/core/router/rules.js +6 -0
  76. package/dist/core/run-mode.d.ts +12 -0
  77. package/dist/core/run-mode.d.ts.map +1 -0
  78. package/dist/core/run-mode.js +17 -0
  79. package/dist/core/scheduler/linux.d.ts +8 -1
  80. package/dist/core/scheduler/linux.d.ts.map +1 -1
  81. package/dist/core/scheduler/linux.js +34 -9
  82. package/dist/core/scheduler/logs.d.ts +4 -0
  83. package/dist/core/scheduler/logs.d.ts.map +1 -1
  84. package/dist/core/scheduler/logs.js +25 -1
  85. package/dist/core/scheduler/mac.d.ts +44 -2
  86. package/dist/core/scheduler/mac.d.ts.map +1 -1
  87. package/dist/core/scheduler/mac.js +126 -15
  88. package/dist/core/scheduler/windows.d.ts.map +1 -1
  89. package/dist/core/scheduler/windows.js +15 -12
  90. package/dist/core/secrets.d.ts.map +1 -1
  91. package/dist/core/secrets.js +18 -8
  92. package/dist/core/self-analysis.d.ts +32 -2
  93. package/dist/core/self-analysis.d.ts.map +1 -1
  94. package/dist/core/self-analysis.js +38 -27
  95. package/dist/core/shutdown.d.ts +33 -2
  96. package/dist/core/shutdown.d.ts.map +1 -1
  97. package/dist/core/shutdown.js +58 -2
  98. package/dist/core/structured-log.d.ts +37 -1
  99. package/dist/core/structured-log.d.ts.map +1 -1
  100. package/dist/core/structured-log.js +37 -0
  101. package/dist/core/usage-surface.d.ts +25 -0
  102. package/dist/core/usage-surface.d.ts.map +1 -0
  103. package/dist/core/usage-surface.js +41 -0
  104. package/dist/core/worktree-run.d.ts +4 -0
  105. package/dist/core/worktree-run.d.ts.map +1 -0
  106. package/dist/core/worktree-run.js +164 -0
  107. package/dist/core/worktree.d.ts +115 -0
  108. package/dist/core/worktree.d.ts.map +1 -0
  109. package/dist/core/worktree.js +462 -0
  110. package/dist/core/wrappers/bash.d.ts +19 -0
  111. package/dist/core/wrappers/bash.d.ts.map +1 -1
  112. package/dist/core/wrappers/bash.js +230 -27
  113. package/dist/db/capability-repo.d.ts +43 -2
  114. package/dist/db/capability-repo.d.ts.map +1 -1
  115. package/dist/db/capability-repo.js +96 -11
  116. package/dist/db/history-repo.d.ts +70 -5
  117. package/dist/db/history-repo.d.ts.map +1 -1
  118. package/dist/db/history-repo.js +170 -29
  119. package/dist/db/metrics-repo.d.ts +20 -2
  120. package/dist/db/metrics-repo.d.ts.map +1 -1
  121. package/dist/db/metrics-repo.js +35 -13
  122. package/dist/db/migrate.d.ts.map +1 -1
  123. package/dist/db/migrate.js +37 -17
  124. package/dist/db/recovery.d.ts +3 -1
  125. package/dist/db/recovery.d.ts.map +1 -1
  126. package/dist/db/recovery.js +11 -5
  127. package/dist/db/run-journal.d.ts +33 -5
  128. package/dist/db/run-journal.d.ts.map +1 -1
  129. package/dist/db/run-journal.js +78 -14
  130. package/dist/db/run-resume.d.ts +5 -0
  131. package/dist/db/run-resume.d.ts.map +1 -1
  132. package/dist/db/run-resume.js +9 -2
  133. package/dist/db/runs-repo.d.ts +19 -2
  134. package/dist/db/runs-repo.d.ts.map +1 -1
  135. package/dist/db/runs-repo.js +91 -60
  136. package/dist/db/schema.d.ts +2 -2
  137. package/dist/db/schema.d.ts.map +1 -1
  138. package/dist/db/schema.js +132 -2
  139. package/dist/db/templates-repo.d.ts +2 -2
  140. package/dist/db/templates-repo.d.ts.map +1 -1
  141. package/dist/db/templates-repo.js +5 -3
  142. package/dist/history.d.ts +7 -2
  143. package/dist/history.d.ts.map +1 -1
  144. package/dist/history.js +4 -2
  145. package/dist/hook-output.d.ts +2 -0
  146. package/dist/hook-output.d.ts.map +1 -0
  147. package/dist/hook-output.js +31 -0
  148. package/dist/i18n.d.ts +5 -0
  149. package/dist/i18n.d.ts.map +1 -1
  150. package/dist/i18n.js +11 -4
  151. package/dist/index.d.ts +375 -47
  152. package/dist/index.d.ts.map +1 -1
  153. package/dist/index.js +1344 -192
  154. package/dist/notifications.d.ts +53 -2
  155. package/dist/notifications.d.ts.map +1 -1
  156. package/dist/notifications.js +168 -21
  157. package/dist/profiles.d.ts.map +1 -1
  158. package/dist/profiles.js +82 -10
  159. package/dist/rpc.d.ts +354 -0
  160. package/dist/rpc.d.ts.map +1 -1
  161. package/dist/rpc.js +145 -0
  162. package/dist/server.d.ts +32 -2
  163. package/dist/server.d.ts.map +1 -1
  164. package/dist/server.js +154 -30
  165. package/dist/settings.d.ts +44 -2
  166. package/dist/settings.d.ts.map +1 -1
  167. package/dist/settings.js +85 -3
  168. package/dist/shared/jobs-view.d.ts +1 -1
  169. package/dist/shared/jobs-view.d.ts.map +1 -1
  170. package/dist/shared/jobs-view.js +2 -0
  171. package/dist/task-transfer.d.ts +21 -0
  172. package/dist/task-transfer.d.ts.map +1 -1
  173. package/dist/task-transfer.js +64 -3
  174. package/dist/templates.d.ts +2 -2
  175. package/dist/templates.d.ts.map +1 -1
  176. package/dist/templates.js +3 -3
  177. package/dist/types.d.ts +22 -2
  178. package/dist/types.d.ts.map +1 -1
  179. package/dist/workspaces.d.ts.map +1 -1
  180. package/dist/workspaces.js +34 -11
  181. package/docs/ARCHITECTURE.md +319 -66
  182. package/docs/COMPATIBILITY.md +2 -2
  183. package/docs/CONCEPT.md +18 -4
  184. package/docs/CROSS_PLATFORM.ru.md +20 -0
  185. package/docs/CROSS_PLATFORM.zh.md +18 -0
  186. package/docs/EXECUTION-LOOP.md +28 -10
  187. package/docs/FEATURES.md +129 -7
  188. package/docs/FEATURES.zh.md +97 -6
  189. package/docs/MIGRATION.md +2 -2
  190. package/docs/PIPELINE.md +293 -0
  191. package/docs/QA-A2-GUI-TUI.md +205 -0
  192. package/docs/README.ru.md +43 -4
  193. package/docs/README.zh.md +44 -4
  194. package/docs/SAFETY.md +23 -3
  195. package/gui-experimental.cjs +9 -8
  196. package/locales/en.json +58 -3
  197. package/locales/ru.json +58 -3
  198. package/locales/zh.json +58 -3
  199. package/opencode.pipeline.yaml +35 -0
  200. package/package.json +36 -4
  201. package/scripts/check-eslint-baseline.mjs +139 -0
  202. package/scripts/gen-test-plan-counters.mjs +117 -0
  203. package/scripts/github-ci-fetch.ps1 +37 -0
  204. package/scripts/pl-commit.ps1 +112 -0
  205. package/scripts/qa-a2-commit.ps1 +104 -0
  206. package/scripts/test-home.mjs +107 -0
  207. package/skills/scheduled-job-best-practices/SKILL.md +95 -1
  208. package/skills/scheduled-job-best-practices/references/recipes.md +139 -0
  209. package/src/cli.ts +417 -0
  210. package/src/core/analytics.ts +27 -4
  211. package/src/core/audit.ts +25 -0
  212. package/src/core/budget.ts +340 -0
  213. package/src/core/cron-to-schtasks.ts +42 -0
  214. package/src/core/dry-run.ts +235 -12
  215. package/src/core/execution.ts +538 -0
  216. package/src/core/feedback.ts +582 -0
  217. package/src/core/file-watcher.ts +2 -2
  218. package/src/core/gate-integrity.ts +330 -0
  219. package/src/core/git-trigger.ts +18 -5
  220. package/src/core/guard-run.ts +119 -0
  221. package/src/core/guard.ts +431 -0
  222. package/src/core/local-ai.ts +7 -3
  223. package/src/core/lock.ts +178 -37
  224. package/src/core/matrix.ts +158 -52
  225. package/src/core/mission.ts +531 -0
  226. package/src/core/native-notify.ts +1 -1
  227. package/src/core/opencode-models.ts +30 -21
  228. package/src/core/opencode-usage.ts +182 -0
  229. package/src/core/pipeline-apply.ts +158 -0
  230. package/src/core/pipeline-io.ts +96 -0
  231. package/src/core/pipeline-map.ts +283 -0
  232. package/src/core/pipeline-spec.ts +775 -0
  233. package/src/core/ps-wrapper.ts +435 -66
  234. package/src/core/record-history.ts +258 -81
  235. package/src/core/router/rules.ts +6 -0
  236. package/src/core/run-mode.ts +19 -0
  237. package/src/core/schedule-gate.ts +1 -1
  238. package/src/core/scheduler/at-fallback.ts +1 -1
  239. package/src/core/scheduler/linux.ts +40 -11
  240. package/src/core/scheduler/logs.ts +34 -3
  241. package/src/core/scheduler/mac.ts +174 -14
  242. package/src/core/scheduler/registry.ts +2 -2
  243. package/src/core/scheduler/windows.ts +19 -15
  244. package/src/core/secrets.ts +26 -19
  245. package/src/core/self-analysis.ts +75 -29
  246. package/src/core/shutdown.ts +90 -4
  247. package/src/core/structured-log.ts +89 -5
  248. package/src/core/telegram.ts +2 -2
  249. package/src/core/triage-worker.ts +7 -7
  250. package/src/core/triage.ts +2 -2
  251. package/src/core/usage-surface.ts +70 -0
  252. package/src/core/worktree-run.ts +199 -0
  253. package/src/core/worktree.ts +600 -0
  254. package/src/core/wrappers/bash.ts +248 -26
  255. package/src/db/capability-repo.ts +127 -10
  256. package/src/db/history-repo.ts +281 -40
  257. package/src/db/metrics-repo.ts +40 -13
  258. package/src/db/migrate.ts +57 -32
  259. package/src/db/recovery.ts +12 -5
  260. package/src/db/run-journal.ts +100 -13
  261. package/src/db/run-resume.ts +17 -1
  262. package/src/db/runs-repo.ts +147 -65
  263. package/src/db/schema.ts +134 -2
  264. package/src/db/templates-repo.ts +5 -3
  265. package/src/gui.tsx +438 -18
  266. package/src/history.ts +11 -4
  267. package/src/hook-output.ts +39 -0
  268. package/src/i18n.ts +12 -4
  269. package/src/index.ts +1902 -320
  270. package/src/notifications.ts +227 -47
  271. package/src/profiles.ts +88 -10
  272. package/src/rpc.ts +158 -0
  273. package/src/server.ts +201 -41
  274. package/src/settings.ts +125 -5
  275. package/src/shared/jobs-view.ts +3 -1
  276. package/src/task-transfer.ts +90 -6
  277. package/src/templates.ts +3 -3
  278. package/src/types.ts +23 -2
  279. package/src/workspaces.ts +37 -14
@@ -6,15 +6,69 @@
6
6
  * Никогда не исполняет команды — только анализ определений.
7
7
  */
8
8
  import fs from "node:fs";
9
+ import { execFileSync } from "node:child_process";
9
10
  import { loadTaskDefinitions } from "../task-transfer.js";
10
11
  import { getHistory } from "../db/history-repo.js";
11
12
  import { getWorkspace } from "../workspaces.js";
12
13
  import { expandMatrixTask } from "./matrix.js";
13
- import { nextRun, activeWindowState, assessCronWindowFeasibility, windowFeasibilityReasonText } from "./schedule-v2.js";
14
+ import { nextRun, activeWindowState, assessCronWindowFeasibility, needsPollMode, windowFeasibilityReasonText } from "./schedule-v2.js";
14
15
  import { checkGitTrigger } from "./git-trigger.js";
15
16
  import { t } from "../i18n.js";
16
17
  import type { TaskDefinition } from "../task-transfer.js";
17
18
 
19
+ /**
20
+ * QV-9: cron срабатывает чаще, чем раз в 5 минут, круглосуточно.
21
+ * Поддерживаются `* * * * *`, каждый N-ю минуту (N <= 5) и списки минут с
22
+ * минимальным циклическим шагом <= 5. Часовой/дневной фильтр означает,
23
+ * что задача не является «постоянным опросом» и отдельно не предупреждается.
24
+ */
25
+ export function isFrequentCron(schedule: string): boolean {
26
+ const parts = schedule.trim().split(/\s+/);
27
+ if (parts.length < 5) return false;
28
+ const [minute, hour, dom, month, dow] = parts;
29
+ if (hour !== "*" || dom !== "*" || month !== "*" || dow !== "*") return false;
30
+ if (minute === "*") return true;
31
+ const step = /^\*\/(\d+)$/.exec(minute);
32
+ if (step) return Number(step[1]) <= 5;
33
+ const minutes = minute.split(",").map((m) => Number(m));
34
+ if (minutes.length > 1 && minutes.every((n) => Number.isInteger(n) && n >= 0 && n < 60)) {
35
+ const sorted = [...minutes].sort((a, b) => a - b);
36
+ let minStep = 60 - sorted[sorted.length - 1] + sorted[0];
37
+ for (let i = 1; i < sorted.length; i++) {
38
+ minStep = Math.min(minStep, sorted[i] - sorted[i - 1]);
39
+ }
40
+ return minStep <= 5;
41
+ }
42
+ return false;
43
+ }
44
+
45
+ /**
46
+ * PL-49: минимальный интервал срабатывания cron в минутах для простых
47
+ * выражений. Возвращает null, если интервал нельзя надёжно вывести.
48
+ */
49
+ export function minimumCronIntervalMinutes(schedule: string): number | null {
50
+ const parts = schedule.trim().split(/\s+/);
51
+ if (parts.length < 5) return null;
52
+ const [minute, hour, dom, month, dow] = parts;
53
+ if (hour !== "*" || dom !== "*" || month !== "*" || dow !== "*") return null;
54
+ if (minute === "*") return 1;
55
+ const step = /^\*\/(\d+)$/.exec(minute);
56
+ if (step) {
57
+ const n = Number(step[1]);
58
+ return n >= 1 && n <= 60 ? n : null;
59
+ }
60
+ const minutes = minute.split(",").map((m) => Number(m));
61
+ if (minutes.length > 1 && minutes.every((n) => Number.isInteger(n) && n >= 0 && n < 60)) {
62
+ const sorted = [...minutes].sort((a, b) => a - b);
63
+ let minStep = 60 - sorted[sorted.length - 1] + sorted[0];
64
+ for (let i = 1; i < sorted.length; i++) {
65
+ minStep = Math.min(minStep, sorted[i] - sorted[i - 1]);
66
+ }
67
+ return minStep;
68
+ }
69
+ return null;
70
+ }
71
+
18
72
  export interface DryRunRoleScoped {
19
73
  allowed?: string[];
20
74
  denied?: string[];
@@ -28,6 +82,8 @@ export interface DryRunTriggerDetails {
28
82
  type: "manual" | "cron" | "file" | "git" | "mcp-event" | "once";
29
83
  /** Человекочитаемое объяснение условия запуска. */
30
84
  explanation: string;
85
+ /** PL-50: cron не expressible в schtasks — ОС опрашивает его каждую минуту. */
86
+ polling?: boolean;
31
87
  /** Состояние окна запуска и разрешённых дней недели (если заданы). */
32
88
  activeWindow?: {
33
89
  active: boolean;
@@ -53,7 +109,10 @@ export interface DryRunTriggerDetails {
53
109
  export interface DryRunTaskItem {
54
110
  name: string;
55
111
  order: number;
56
- trigger: "manual" | "cron" | "dag" | "once";
112
+ /** PL-26/PL-30: реальный triggerType definition (совпадает с triggerDetails.type). */
113
+ trigger: DryRunTriggerDetails["type"];
114
+ /** Как задача попала в симуляцию: manual — корень, dag — через dependsOn. */
115
+ entryMode: "manual" | "dag";
57
116
  cwd: string;
58
117
  command: string;
59
118
  workspace?: { name: string; path: string };
@@ -123,6 +182,97 @@ const DANGEROUS_PATTERNS: { test: RegExp; messageKey: string }[] = [
123
182
  { test: /git\s+push\s+.*--force(?:\s|$)/, messageKey: "dryRun.danger.forcePush" },
124
183
  ];
125
184
 
185
+ /**
186
+ * PL-2.2: команды самопроверки, которые агент не выполнит без инструмента
187
+ * shell. Если они есть в промпте, а shell запрещён, агент получает tool.blocked
188
+ * и рапортует об «успешной проверке», ничего не проверив.
189
+ */
190
+ const SELF_CHECK_PATTERNS: readonly RegExp[] = [
191
+ /\bnpm\s+(?:test|run\s+[\w-]*test[\w-]*)\b/i,
192
+ /\bnode(?:\.exe)?\s+\S/i,
193
+ /\bpytest\b/i,
194
+ /\b(?:go|dotnet)\s+test\b/i,
195
+ /\btest\b/i,
196
+ /тест/iu,
197
+ ];
198
+
199
+ /** PL-2.2: эффективный запрет shell с учётом legacy-режима и политик. */
200
+ function shellIsForbidden(def: TaskDefinition): boolean {
201
+ if (def.legacyShell === true) return false;
202
+ const isShell = (tool: string): boolean => /^(?:shell|bash)$/i.test(tool.trim());
203
+ const allowed = Array.isArray(def.allowedTools) ? def.allowedTools : [];
204
+ const denied = Array.isArray(def.deniedTools) ? def.deniedTools : [];
205
+ if (allowed.length > 0) return !allowed.some(isShell);
206
+ if (denied.length > 0) return denied.some(isShell);
207
+ // Политика hybrid по умолчанию запрещает shell (см. SKILL.md §4).
208
+ return true;
209
+ }
210
+
211
+ /**
212
+ * PL-5.1: цепочка и DAG могут указывать на один и тот же переход. Тогда при
213
+ * завершении шага он будет запущен дважды: как chainTarget и как зависимый.
214
+ * Возвращаем имя конфликтующей задачи или null. Fail-open: нет данных — тишина.
215
+ */
216
+ function findChainDagOverlap(
217
+ def: TaskDefinition,
218
+ allDefs: TaskDefinition[],
219
+ ): string | null {
220
+ const next = (def.nextTaskOnSuccess ?? "").trim();
221
+ if (!next) return null;
222
+ const nextLower = next.toLowerCase();
223
+
224
+ // Случай 1: преемник прямо перечислен в dependsOn текущей задачи.
225
+ if (
226
+ (def.dependsOn ?? []).some(
227
+ (dep) => (dep ?? "").trim().toLowerCase() === nextLower,
228
+ )
229
+ ) {
230
+ return next;
231
+ }
232
+
233
+ // Случай 2 (типичная линейная цепочка): преемник сам зависит от текущей.
234
+ const nextDef = allDefs.find((d) => d.name.toLowerCase() === nextLower);
235
+ if (
236
+ nextDef &&
237
+ (nextDef.dependsOn ?? []).some(
238
+ (dep) => (dep ?? "").trim().toLowerCase() === def.name.toLowerCase(),
239
+ )
240
+ ) {
241
+ return next;
242
+ }
243
+ return null;
244
+ }
245
+
246
+ /**
247
+ * PL-8.1: рабочая директория могла уйти вперёд с момента постановки задачи —
248
+ * Quality Gate тогда проверяет уже другой код (расхождение счётчиков и т.п.).
249
+ * Сравниваем время HEAD-коммита с createdAt задачи. Fail-open: нет git, нет
250
+ * даты или команда недоступна — предупреждения нет.
251
+ */
252
+ export function workingDirectoryDriftWarning(def: TaskDefinition, cwd: string): string | null {
253
+ if (!def.createdAt || !cwd) return null;
254
+ const created = new Date(def.createdAt).getTime();
255
+ if (!Number.isFinite(created)) return null;
256
+ try {
257
+ const headIso = execFileSync("git", ["log", "-1", "--format=%cI"], {
258
+ cwd,
259
+ encoding: "utf8",
260
+ stdio: ["ignore", "pipe", "ignore"],
261
+ timeout: 5000,
262
+ }).trim();
263
+ const headTime = new Date(headIso).getTime();
264
+ if (!Number.isFinite(headTime) || headTime <= created) return null;
265
+ return (
266
+ `PL-8.1: рабочая директория ушла вперёд с момента постановки задачи (${def.createdAt}); ` +
267
+ `HEAD датирован ${headIso}. Quality Gate может упасть на чужих правках. ` +
268
+ "Зафиксируйте commit, на котором гейт считается валидным (например, проверьте HEAD внутри qualityGate), " +
269
+ "или используйте изолированный worktree."
270
+ );
271
+ } catch {
272
+ return null;
273
+ }
274
+ }
275
+
126
276
  /**
127
277
  * Свойства для описания триггера задачи в dry-run (Спринт 27).
128
278
  */
@@ -183,7 +333,7 @@ async function describeTrigger(opts: DescribeTriggerOptions): Promise<DryRunTrig
183
333
  t("dryRun.git.branchMismatch", { branch: def.gitBranch ?? "" }),
184
334
  );
185
335
  }
186
- } catch (err: any) {
336
+ } catch (err: unknown) {
187
337
  base.explanation = t("dryRun.git.checkError", {
188
338
  error: err instanceof Error ? err.message : String(err),
189
339
  });
@@ -232,6 +382,11 @@ async function describeTrigger(opts: DescribeTriggerOptions): Promise<DryRunTrig
232
382
  timezone: def.timezone,
233
383
  })
234
384
  : t("dryRun.cron", { schedule: def.schedule });
385
+ // PL-50: показываем, что расписание не зарегистрировано напрямую
386
+ // в schtasks, а проверяется минутным poll с schedule gate в обёртке.
387
+ if (def.schedule && needsPollMode(def.schedule, def.timezone ?? undefined)) {
388
+ base.polling = true;
389
+ }
235
390
  break;
236
391
  }
237
392
 
@@ -409,7 +564,7 @@ export async function simulatePipeline(taskName: string): Promise<DryRunReport>
409
564
  t("dryRun.matrix.parent", { name: def.name, count: clones.length }),
410
565
  );
411
566
  for (const clone of clones) units.push({ def: clone, matrixParent: def.name });
412
- } catch (err: any) {
567
+ } catch (err: unknown) {
413
568
  const list = warningsPerTask.get(def.name.toLowerCase()) ?? [];
414
569
  list.push(
415
570
  t("dryRun.matrix.expandError", {
@@ -453,15 +608,20 @@ export async function simulatePipeline(taskName: string): Promise<DryRunReport>
453
608
  }
454
609
  }
455
610
 
456
- // Триггер: корневая задача (или клон корневой матрицы) — manual,
457
- // остальные попали в конвейер через dependsOn — dag.
611
+ // PL-8.1: HEAD мог уйти вперёд с момента постановки задачи — гейт проверяет
612
+ // уже другой код. Предупреждаем и советуем зафиксировать commit.
613
+ const drift = workingDirectoryDriftWarning(def, cwd);
614
+ if (drift) taskWarnings.push(drift);
615
+
616
+ // PL-26/PL-30: trigger отражает реальный triggerType задачи и совпадает
617
+ // с triggerDetails.type. Режим входа в симуляцию вынесен в entryMode,
618
+ // чтобы не подменять тип триггера значениями manual/dag.
458
619
  const triggerType = def.triggerType ?? "cron";
459
- const trigger: DryRunTaskItem["trigger"] =
460
- triggerType === "once"
461
- ? "once"
462
- : lower === rootLower || (matrixParent && matrixParent.toLowerCase() === rootLower)
463
- ? "manual"
464
- : "dag";
620
+ const trigger = triggerType as DryRunTaskItem["trigger"];
621
+ const entryMode: DryRunTaskItem["entryMode"] =
622
+ lower === rootLower || (matrixParent && matrixParent.toLowerCase() === rootLower)
623
+ ? "manual"
624
+ : "dag";
465
625
 
466
626
  // Детали триггера (Спринт 27): состояние окна/дней недели, git-статус.
467
627
  const triggerDetails = await describeTrigger({
@@ -510,6 +670,68 @@ export async function simulatePipeline(taskName: string): Promise<DryRunReport>
510
670
  }
511
671
  }
512
672
 
673
+ // PL-5.1: nextTaskOnSuccess и dependsOn на одну задачу = дубль запуска.
674
+ const overlap = findChainDagOverlap(def, allDefs);
675
+ if (overlap) {
676
+ taskWarnings.push(
677
+ `PL-5.1: nextTaskOnSuccess="${overlap}" и dependsOn указывают на одну задачу: ` +
678
+ `при завершении "${def.name}" шаг "${overlap}" будет запущен дважды. ` +
679
+ "Используйте только один механизм перехода (nextTaskOnSuccess ИЛИ dependsOn; см. SKILL.md §6).",
680
+ );
681
+ }
682
+
683
+ // PL-2.2: самопроверка через node/тесты при запрещённом shell — источник
684
+ // tool.blocked в аудите и ложного «проверено» в отчёте агента.
685
+ if (
686
+ shellIsForbidden(def) &&
687
+ typeof def.prompt === "string" &&
688
+ SELF_CHECK_PATTERNS.some((pattern) => pattern.test(def.prompt ?? ""))
689
+ ) {
690
+ taskWarnings.push(
691
+ "PL-2.2: промпт требует самопроверки (node/тесты), но shell запрещён: добавьте shell в allowedTools или перенесите проверки в qualityGate/afterScript.",
692
+ );
693
+ }
694
+
695
+ // QV-9: частый cron + тяжёлый промпт (`opencode run`) — антипаттерн из
696
+ // SKILL.md: каждый тик поднимает полную сессию агента и сжигает квоту.
697
+ if (
698
+ triggerType === "cron" &&
699
+ def.schedule &&
700
+ isFrequentCron(def.schedule) &&
701
+ /\bopencode\s+run\b/i.test(def.prompt ?? "")
702
+ ) {
703
+ taskWarnings.push(
704
+ `QV-9: cron "${def.schedule}" запускает opencode run чаще, чем раз в 5 минут: ` +
705
+ "каждый тик поднимает полную сессию агента. Используйте редкое расписание или событийный триггер (mcp-event/file/git).",
706
+ );
707
+ }
708
+
709
+ // PL-49: таймаут длиннее интервала cron — следующий тик наступит до
710
+ // завершения текущего, и запуск будет пропущен (lock-skip).
711
+ const intervalMinutes = triggerType === "cron" && def.schedule
712
+ ? minimumCronIntervalMinutes(def.schedule)
713
+ : null;
714
+ if (
715
+ intervalMinutes !== null &&
716
+ typeof def.timeoutSeconds === "number" &&
717
+ def.timeoutSeconds > intervalMinutes * 60
718
+ ) {
719
+ taskWarnings.push(
720
+ `PL-49: timeoutSeconds=${def.timeoutSeconds}с больше интервала cron "${def.schedule}" ` +
721
+ `(${intervalMinutes} мин): следующий тик наступит до завершения текущего прогона. ` +
722
+ "Увеличьте интервал или уменьшите таймаут.",
723
+ );
724
+ }
725
+
726
+ // PL-50: cron вне подмножества schtasks тикает каждую минуту — это не
727
+ // частота задачи, а частота опроса planner'а; без пометки легко ошибиться.
728
+ if (triggerDetails.polling) {
729
+ taskWarnings.push(
730
+ `PL-50: cron "${def.schedule}" не выражается в планировщике ОС: ` +
731
+ "записана ежеминутная проверка с schedule gate. Фактическая частота запуска — по cron, но каждую минуту создаётся ProcessID для проверки расписания.",
732
+ );
733
+ }
734
+
513
735
  const roleScoped: DryRunRoleScoped | null =
514
736
  Array.isArray(def.allowedTools) && def.allowedTools.length > 0
515
737
  ? { allowed: def.allowedTools, denied: def.deniedTools }
@@ -560,6 +782,7 @@ export async function simulatePipeline(taskName: string): Promise<DryRunReport>
560
782
  name: def.name,
561
783
  order: index,
562
784
  trigger,
785
+ entryMode,
563
786
  session: def.session ?? "new",
564
787
  sessionId: def.session === "reuse" ? def.sessionId ?? null : null,
565
788
  // Спринт 27.5.4: показываем режим входа до регистрации в ОС.