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,1091 @@
1
+ import fs from "node:fs/promises";
2
+ import path from "node:path";
3
+ import { PLUGIN_DIR, LOCK_DIR, WRAPPER_DIR, STALE_LOCK_MAX_AGE_MS, sanitizeName } from "../types.js";
4
+ /**
5
+ * Путь к единому generic-обёртке PowerShell, которая реализует запуск opencode run
6
+ * с таймаутом и lock-логикой.
7
+ */
8
+ const WRAPPER_FILENAME = "run-task.ps1";
9
+ /**
10
+ * Текст PowerShell-обёртки.
11
+ *
12
+ * Параметры:
13
+ * TaskName — имя задачи (для логов)
14
+ * PromptFile — путь к файлу с промптом (читается через Get-Content -Raw)
15
+ * TimeoutSeconds — таймаут в секундах
16
+ * Model — LLM-модель для `opencode run --model` (опционально)
17
+ * Workdir — рабочая директория (опционально)
18
+ * WorkspaceName — имя multi-repo workspace для git-контекста в логе
19
+ * LockFile — путь к lock-файлу (удаляется в finally)
20
+ * BeforeScript — pre-flight команда (ненулевой код отменяет задачу)
21
+ * AfterScript — post-flight команда (выполняется даже при ошибке)
22
+ *
23
+ * Логика:
24
+ * 1. Выполняет pre-flight (если задан); при ошибке задача не запускается.
25
+ * 2. Читает промпт из файла.
26
+ * 3. Запускает opencode run <промпт> через Start-Process (без окна консоли).
27
+ * 4. Ждёт завершения с таймаутом.
28
+ * 5. При таймауте — убивает процесс и дочерние процессы.
29
+ * 6. В finally выполняет post-flight и удаляет lock-файл.
30
+ */
31
+ export const WRAPPER_SCRIPT = `param(
32
+ [string]$TaskName,
33
+ [string]$PromptFile,
34
+ [int]$TimeoutSeconds,
35
+ [string]$Model,
36
+ [string]$Workdir,
37
+ [string]$WorkspaceName,
38
+ [string]$AllowedTools,
39
+ [string]$DeniedTools,
40
+ [string]$LockFile,
41
+ [string]$LogFile,
42
+ [string]$RecorderFile,
43
+ [string]$QualityGate,
44
+ [string]$BeforeScript,
45
+ [string]$AfterScript,
46
+ [string]$EnvFile,
47
+ [string]$SessionMode,
48
+ [string]$SessionId,
49
+ [string]$SessionFile,
50
+ [int]$RetryCount = 0,
51
+ [int]$RetryDelaySeconds = 0,
52
+ [int]$GateTimeoutSeconds = 300,
53
+ [int]$StaleLockMaxAgeMs = 86400000,
54
+ [string]$PermissionsB64 = "",
55
+ [string]$PolicyB64 = "",
56
+ [string]$ModelB64 = "",
57
+ [string]$WorkspaceNameB64 = "",
58
+ [string]$AllowedToolsB64 = "",
59
+ [string]$DeniedToolsB64 = ""
60
+ )
61
+
62
+ [Console]::OutputEncoding = [System.Text.Encoding]::UTF8
63
+ $OutputEncoding = [System.Text.Encoding]::UTF8
64
+
65
+ $ErrorActionPreference = "Continue"
66
+
67
+ # P2-11: свободный текст (модель, имя workspace, списки инструментов) приходит
68
+ # в base64, чтобы символы подстановки PowerShell/cmd не разворачивались.
69
+ function ConvertFrom-B64Text {
70
+ param([string]$Value)
71
+ if (-not $Value) { return "" }
72
+ try {
73
+ return [System.Text.Encoding]::UTF8.GetString([System.Convert]::FromBase64String($Value))
74
+ } catch {
75
+ return ""
76
+ }
77
+ }
78
+
79
+ if ($ModelB64) { $Model = ConvertFrom-B64Text $ModelB64 }
80
+ if ($WorkspaceNameB64) { $WorkspaceName = ConvertFrom-B64Text $WorkspaceNameB64 }
81
+ if ($AllowedToolsB64) { $AllowedTools = ConvertFrom-B64Text $AllowedToolsB64 }
82
+ if ($DeniedToolsB64) { $DeniedTools = ConvertFrom-B64Text $DeniedToolsB64 }
83
+
84
+ function Write-Log {
85
+ param([string]$Message)
86
+ $timestamp = Get-Date -Format "yyyy-MM-dd HH:mm:ss"
87
+ $line = "[$timestamp] $Message"
88
+ if ($LogFile) {
89
+ try {
90
+ Add-Content -Path $LogFile -Value $line -Encoding utf8
91
+ } catch {}
92
+ }
93
+ Write-Host $line
94
+ }
95
+
96
+
97
+ # Проверяет, что процесс с указанным PID ещё существует. Нужно для stale-lock:
98
+ # возраст файла сам по себе не говорит, что владелец мёртв (задача может идти долго).
99
+ function Test-ProcessAlive {
100
+ param([int]$ProcessId)
101
+ if ($ProcessId -le 0) { return $false }
102
+ try {
103
+ $null = Get-Process -Id $ProcessId -ErrorAction Stop
104
+ return $true
105
+ } catch {
106
+ return $false
107
+ }
108
+ }
109
+
110
+ # Гарантируем существование папки для лога (на случай прямого вызова обёртки).
111
+ if ($LogFile) {
112
+ try {
113
+ $logDir = Split-Path -Parent $LogFile
114
+ if ($logDir -and -not (Test-Path $logDir)) {
115
+ New-Item -ItemType Directory -Force -Path $logDir | Out-Null
116
+ }
117
+ } catch {}
118
+ }
119
+
120
+ Write-Log "[agent-steward] Запуск задачи '$TaskName'..."
121
+
122
+ $startTime = Get-Date
123
+ $script:exitCode = 0
124
+ $script:errorMessage = ""
125
+ $script:preFlightStatus = "skipped"
126
+ $script:postFlightStatus = "skipped"
127
+ $script:skipMainTask = $false
128
+ $script:lockAcquired = $false
129
+ $script:timedOut = $false
130
+ $script:attemptExitCode = 0
131
+ $startedAtIso = $startTime.ToUniversalTime().ToString("o")
132
+ $script:runId = ""
133
+
134
+ # Hotfix 1.5.3.1: блокировка ДО записи в историю. Раньше lock существовал только
135
+ # в in-process пути (LockManager/withLock), а schtasks-запуск обёртки его не
136
+ # проверял: два одновременных запуска дублировали задачу и дрались за лог.
137
+ # Атомарное создание файла (CreateNew) даёт ту же гарантию, что и Node-лок.
138
+ if ($LockFile) {
139
+ try {
140
+ $lockDir = Split-Path -Parent $LockFile
141
+ if ($lockDir -and -not (Test-Path -LiteralPath $lockDir)) {
142
+ New-Item -ItemType Directory -Force -Path $lockDir | Out-Null
143
+ }
144
+ $lockStream = [System.IO.File]::Open($LockFile, [System.IO.FileMode]::CreateNew, [System.IO.FileAccess]::Write, [System.IO.FileShare]::None)
145
+ try {
146
+ # Внутри lock храним время старта и PID владельца: по PID можно
147
+ # отличить живой долгий запуск от осиротевшего после kill -9.
148
+ $lockBytes = [System.Text.Encoding]::UTF8.GetBytes("$startedAtIso|$PID")
149
+ $lockStream.Write($lockBytes, 0, $lockBytes.Length)
150
+ } finally {
151
+ $lockStream.Dispose()
152
+ }
153
+ $script:lockAcquired = $true
154
+ } catch [System.IO.IOException] {
155
+ # Зависший lock снимаем только если владелец мёртв (или файл старше
156
+ # StaleLockMaxAgeMs и PID в нём отсутствует — lock от старой версии).
157
+ $stale = $false
158
+ $holderPid = 0
159
+ try {
160
+ $holderRaw = "$(Get-Content -LiteralPath $LockFile -Raw -ErrorAction Stop)".Trim()
161
+ $holderParts = $holderRaw.Split([char]124)
162
+ if ($holderParts.Count -ge 2) {
163
+ [void][int]::TryParse($holderParts[1], [ref]$holderPid)
164
+ }
165
+ } catch {}
166
+ if ($holderPid -gt 0) {
167
+ $stale = -not (Test-ProcessAlive -ProcessId $holderPid)
168
+ } else {
169
+ try {
170
+ $ageMs = ((Get-Date) - (Get-Item -LiteralPath $LockFile).LastWriteTime).TotalMilliseconds
171
+ if ($ageMs -gt $StaleLockMaxAgeMs) { $stale = $true }
172
+ } catch {}
173
+ }
174
+ if ($stale) {
175
+ # T-03: не удаляем lock напрямую. Remove-Item + CreateNew давал
176
+ # гонку: второй воркер мог снести lock, который первый только что
177
+ # создал, и запустить ту же задачу повторно. Атомарно уводим старый
178
+ # файл в уникальное имя; если rename не удался — чужой lock не трогаем.
179
+ $staleLockPath = "$LockFile.stale-$PID-$([DateTime]::UtcNow.Ticks)"
180
+ $staleMoved = $false
181
+ try {
182
+ Move-Item -LiteralPath $LockFile -Destination $staleLockPath -Force -ErrorAction Stop
183
+ $staleMoved = $true
184
+ } catch {}
185
+ if ($staleMoved) {
186
+ try {
187
+ $lockStream = [System.IO.File]::Open($LockFile, [System.IO.FileMode]::CreateNew, [System.IO.FileAccess]::Write, [System.IO.FileShare]::None)
188
+ try {
189
+ $lockBytes = [System.Text.Encoding]::UTF8.GetBytes("$startedAtIso|$PID")
190
+ $lockStream.Write($lockBytes, 0, $lockBytes.Length)
191
+ } finally {
192
+ $lockStream.Dispose()
193
+ }
194
+ $script:lockAcquired = $true
195
+ } catch {}
196
+ try { Remove-Item -LiteralPath $staleLockPath -Force -ErrorAction SilentlyContinue } catch {}
197
+ }
198
+ }
199
+ if (-not $script:lockAcquired) {
200
+ Write-Log "[agent-steward] Запуск задачи '$TaskName' пропущен: удерживается активная блокировка."
201
+ exit 0
202
+ }
203
+ } catch {
204
+ Write-Log "[agent-steward] Не удалось захватить блокировку задачи '$TaskName': $_"
205
+ exit 0
206
+ }
207
+ }
208
+
209
+ # Crash recovery: фиксируем начало ДО pre-flight и основной задачи.
210
+ # Если процесс убьют (таймаут/KILL/перезагрузка), останется finished_at = NULL,
211
+ # и при следующем старте плагина recovery пометит запись как error.
212
+ if ($RecorderFile) {
213
+ try {
214
+ $startOutput = & node "$RecorderFile" --start "$TaskName" "$startedAtIso" 2>$null
215
+ if ($LASTEXITCODE -eq 0) {
216
+ $candidate = @($startOutput) | Select-Object -Last 1
217
+ if ($candidate) { $script:runId = "$candidate".Trim() }
218
+ }
219
+ } catch {}
220
+ }
221
+
222
+ # Выполняет команду оболочки и построчно пишет её вывод в лог.
223
+ # GateTimeoutSeconds ограничивает время хука: зависший pre-flight/Quality Gate
224
+ # раньше держал lock до истечения общего таймаута задачи (до 24 ч).
225
+ function Invoke-HookScript {
226
+ param([string]$Command)
227
+ $timeout = $GateTimeoutSeconds
228
+
229
+ if (-not $timeout -or $timeout -le 0) {
230
+ $output = & cmd.exe /c $Command 2>&1
231
+ $code = $LASTEXITCODE
232
+ foreach ($line in @($output)) {
233
+ Write-Log "[hook] $line"
234
+ }
235
+ return $code
236
+ }
237
+
238
+ # ВАЖНО: расширение должно быть .cmd. GetTempFileName() даёт .tmp, а
239
+ # запуск файла .tmp через cmd.exe /c может зависнуть вместо быстрого выполнения.
240
+ $hookFile = Join-Path ([System.IO.Path]::GetTempPath()) ("sched-hook-" + [guid]::NewGuid().ToString("N") + ".cmd")
241
+ try {
242
+ # Команду кладём в .cmd, чтобы кавычки/пайпы не ломали аргументы.
243
+ $lines = @('@echo off', 'chcp 65001 >nul', $Command)
244
+ Set-Content -LiteralPath $hookFile -Value $lines -Encoding Default
245
+ # Не используем Start-Process с -RedirectStandardOutput/-RedirectStandardError:
246
+ # в Windows PowerShell 5.1 такой вызов может зависнуть на закрытии потоков,
247
+ # даже если сам хук уже завершился. Запускаем процесс напрямую и читаем
248
+ # stdout/stderr асинхронно — это не блокирует WaitForExit(timeout).
249
+ $psi = New-Object System.Diagnostics.ProcessStartInfo
250
+ $psi.FileName = "cmd.exe"
251
+ $psi.Arguments = '/c "' + $hookFile + '"'
252
+ $psi.UseShellExecute = $false
253
+ $psi.RedirectStandardOutput = $true
254
+ $psi.RedirectStandardError = $true
255
+ $psi.CreateNoWindow = $true
256
+ $psi.StandardOutputEncoding = [System.Text.Encoding]::UTF8
257
+ $psi.StandardErrorEncoding = [System.Text.Encoding]::UTF8
258
+ $proc = New-Object System.Diagnostics.Process
259
+ $proc.StartInfo = $psi
260
+ $null = $proc.Start()
261
+ $outTask = $proc.StandardOutput.ReadToEndAsync()
262
+ $errTask = $proc.StandardError.ReadToEndAsync()
263
+ $finished = $proc.WaitForExit([int]($timeout * 1000))
264
+ if (-not $finished) {
265
+ try { & taskkill.exe /F /T /PID $proc.Id 2>$null | Out-Null } catch {}
266
+ try { $proc.WaitForExit(5000) | Out-Null } catch {}
267
+ $code = 124
268
+ Write-Log "[agent-steward] Таймаут хука ($timeout с): $Command"
269
+ } else {
270
+ try { $proc.WaitForExit() } catch {}
271
+ $code = $proc.ExitCode
272
+ }
273
+ $outText = ""
274
+ $errText = ""
275
+ if ($outTask.Wait(5000)) { try { $outText = $outTask.Result } catch {} }
276
+ if ($errTask.Wait(5000)) { try { $errText = $errTask.Result } catch {} }
277
+ foreach ($text in @($outText, $errText)) {
278
+ foreach ($line in @($text -split "\r?\n")) {
279
+ if ($line -ne "") {
280
+ Write-Log "[hook] $line"
281
+ }
282
+ }
283
+ }
284
+ return $code
285
+ } catch {
286
+ Write-Log "[agent-steward] Не удалось выполнить хук: $_"
287
+ return 1
288
+ } finally {
289
+ Remove-Item -LiteralPath $hookFile -Force -ErrorAction SilentlyContinue
290
+ }
291
+ }
292
+
293
+ # Hotfix 1.5.3.1: запуск opencode с реальным таймаутом.
294
+ # Раньше TimeoutSeconds принимался, но нигде не использовался — задача работала
295
+ # до конца, а статус 'timeout' не выставлялся никогда. Теперь параллельно
296
+ # стартует сторожевой job: по истечении лимита он помечает маркер и убивает
297
+ # дерево процессов задачи (taskkill /T), а обёртка переводит статус в 'timeout'.
298
+ function Invoke-OpenCodeOnce {
299
+ param([string]$CommandPath, [string[]]$Arguments)
300
+
301
+ $watch = $null
302
+ $timeoutMarker = ""
303
+ if ($TimeoutSeconds -gt 0) {
304
+ $timeoutMarker = Join-Path ([System.IO.Path]::GetTempPath()) ("sched-timeout-" + [guid]::NewGuid().ToString("N") + ".flag")
305
+ $watch = Start-Job -ScriptBlock {
306
+ param([int]$RootId, [int]$Seconds, [string]$Marker)
307
+ Start-Sleep -Seconds $Seconds
308
+ $selfId = $PID
309
+ $all = @()
310
+ try { $all = @(Get-CimInstance Win32_Process -Property ProcessId, ParentProcessId) } catch { $all = @() }
311
+ $targets = New-Object System.Collections.Generic.List[int]
312
+ $queue = New-Object System.Collections.Generic.Queue[int]
313
+ $queue.Enqueue($RootId)
314
+ $guard = 0
315
+ while ($queue.Count -gt 0 -and $guard -lt 2000) {
316
+ $guard++
317
+ $current = $queue.Dequeue()
318
+ foreach ($p in $all) {
319
+ $childId = [int]$p.ProcessId
320
+ if ([int]$p.ParentProcessId -eq $current -and $childId -ne $selfId -and -not $targets.Contains($childId)) {
321
+ $targets.Add($childId)
322
+ $queue.Enqueue($childId)
323
+ }
324
+ }
325
+ }
326
+ if ($targets.Count -gt 0) {
327
+ try { Set-Content -Path $Marker -Value "timeout" -Encoding UTF8 } catch {}
328
+ foreach ($targetId in @($targets)) {
329
+ try { & taskkill.exe /F /T /PID $targetId 2>$null | Out-Null } catch {}
330
+ }
331
+ }
332
+ } -ArgumentList $PID, $TimeoutSeconds, $timeoutMarker
333
+ }
334
+
335
+ $script:timedOut = $false
336
+ $script:attemptExitCode = 0
337
+ # Состояние фильтра лога сбрасываем на каждой попытке: иначе незакрытый
338
+ # служебный блок из упавшего запуска «съедал» бы весь лог следующей попытки.
339
+ $script:inServiceBlock = $false
340
+ $script:inComment = $false
341
+ try {
342
+ # Живой стриминг: вывод opencode проходит через конвейер и пишется в лог
343
+ # (Out-File -Append) или консоль (Out-Host) построчно, по мере поступления.
344
+ # Раньше вывод сначала копился в $output и сбрасывался одним куском только
345
+ # после завершения процесса: дашборд/get_task_logs были слепы во время
346
+ # долгих запусков, росла память, а при kill обёртки лог терялся целиком.
347
+ # $LASTEXITCODE после конвейера сохраняет код последней нативной команды.
348
+ if ($LogFile) {
349
+ if ($CommandPath -like "*.ps1") {
350
+ & powershell.exe -ExecutionPolicy Bypass -NoProfile -File $CommandPath @Arguments *>&1 | ForEach-Object { Format-LogLine $_ } | Out-File -FilePath $LogFile -Append -Encoding utf8
351
+ $script:attemptExitCode = $LASTEXITCODE
352
+ } else {
353
+ & $CommandPath @Arguments *>&1 | ForEach-Object { Format-LogLine $_ } | Out-File -FilePath $LogFile -Append -Encoding utf8
354
+ $script:attemptExitCode = $LASTEXITCODE
355
+ }
356
+ } else {
357
+ if ($CommandPath -like "*.ps1") {
358
+ & powershell.exe -ExecutionPolicy Bypass -NoProfile -File $CommandPath @Arguments *>&1 | ForEach-Object { Format-LogLine $_ } | Out-Host
359
+ $script:attemptExitCode = $LASTEXITCODE
360
+ } else {
361
+ & $CommandPath @Arguments *>&1 | ForEach-Object { Format-LogLine $_ } | Out-Host
362
+ $script:attemptExitCode = $LASTEXITCODE
363
+ }
364
+ }
365
+ } finally {
366
+ if ($timeoutMarker -and (Test-Path -LiteralPath $timeoutMarker)) {
367
+ $script:timedOut = $true
368
+ }
369
+ if ($watch) {
370
+ Stop-Job -Job $watch -ErrorAction SilentlyContinue
371
+ Remove-Job -Job $watch -Force -ErrorAction SilentlyContinue
372
+ }
373
+ if ($timeoutMarker) {
374
+ Remove-Item -LiteralPath $timeoutMarker -Force -ErrorAction SilentlyContinue
375
+ }
376
+ }
377
+
378
+ if ($script:timedOut) {
379
+ Write-Log "[agent-steward] Таймаут: задача '$TaskName' превысила лимит $TimeoutSeconds с — процесс остановлен."
380
+ $script:errorMessage = "Таймаут: превышено $TimeoutSeconds с"
381
+ return 124
382
+ }
383
+ return $script:attemptExitCode
384
+ }
385
+
386
+ # Фильтр технического шума и служебных блоков OpenCode.
387
+ # Строки ответа ИИ проходят без изменений.
388
+ #
389
+ # В TS-шаблоне обратные слэши удвоены, иначе JS съедает \s и regex ломается.
390
+ $esc = [char]27
391
+ $script:inServiceBlock = $false
392
+ $script:inComment = $false
393
+
394
+ $serviceOpen = '<\\s*(?:dcp-)?system[-_](?:reminder|update)\\b[^>]*>'
395
+ $serviceClose = '<\\s*/\\s*(?:dcp-)?system[-_](?:reminder|update)\\s*>'
396
+ $serviceTag = '<\\s*/?\\s*(?:dcp-)?system[-_](?:reminder|update)\\b[^>]*>'
397
+
398
+ function Format-LogLine {
399
+ param($Line)
400
+ $text = "$Line"
401
+
402
+ # ANSI-последовательности (цвета, управление курсором), например ESC[0m.
403
+ $text = $text -replace "$esc\\[[0-9;?]*[A-Za-z]", ""
404
+
405
+ # Служебные блоки, целиком уместившиеся в одной строке.
406
+ $text = [regex]::Replace($text, "$serviceOpen.*?$serviceClose", "", "IgnoreCase")
407
+ $text = [regex]::Replace($text, '<!--.*?-->', "", "IgnoreCase")
408
+
409
+ # Начало многострочного служебного блока OpenCode:
410
+ # <dcp-system-reminder> ... </dcp-system-reminder> (и <system-reminder>).
411
+ # Блоком считаем только тег в начале строки: одиночный тег внутри текста
412
+ # (например, ИИ упомянул его в объяснении) не должен съедать следующие строки.
413
+ if ($text -match "^\\s*$serviceOpen") { $script:inServiceBlock = $true }
414
+ if ($text -match '^\\s*<!--') { $script:inComment = $true }
415
+
416
+ if ($script:inServiceBlock -or $script:inComment) {
417
+ $closed = $false
418
+ if ($script:inServiceBlock -and $text -match $serviceClose) {
419
+ $script:inServiceBlock = $false
420
+ $closed = $true
421
+ }
422
+ if ($script:inComment -and $text -match '-->') {
423
+ $script:inComment = $false
424
+ $closed = $true
425
+ }
426
+
427
+ if ($closed) {
428
+ # Блок закончился в этой строке — сохраняем только хвост после тега.
429
+ $text = ($text -split '-->|<\\s*/\\s*(?:dcp-)?system[-_](?:reminder|update)\\s*>')[-1]
430
+ } else {
431
+ # Внутри служебного блока — строку не пишем.
432
+ return
433
+ }
434
+ }
435
+
436
+ # Одиночные теги, оставшиеся после вывода ИИ.
437
+ $text = [regex]::Replace($text, $serviceTag, "", "IgnoreCase")
438
+ $text = $text.TrimEnd()
439
+
440
+ # Технический шум вложенного powershell.exe.
441
+ if ($text -match "NativeCommandError|CategoryInfo|FullyQualifiedErrorId|RemoteException") { return }
442
+ if ($text -match "^At [A-Za-z]:.*:") { return }
443
+ if ($text -match "^\\s*\\+\\s*~+\\s*$") { return }
444
+ if (-not $text.Trim()) { return }
445
+
446
+ return $text
447
+ }
448
+
449
+ # Пытается вытащить из лога задачи информацию о расходе токенов и стоимости.
450
+ # OpenCode может печатать строки вида "Tokens: 1234", "Usage: 1234 tokens",
451
+ # "cost: $0.012" и т.п. Если данные не найдены — возвращает пустые строки,
452
+ # чтобы recorder записал поля как отсутствующие.
453
+ function Get-UsageFromLog {
454
+ param([string]$File)
455
+
456
+ $result = @{ Tokens = ""; Cost = "" }
457
+ if (-not $File) { return $result }
458
+
459
+ $tail = @()
460
+ try {
461
+ if (Test-Path $File) {
462
+ $tail = Get-Content -Path $File -Tail 500 -Encoding UTF8 -ErrorAction SilentlyContinue
463
+ }
464
+ } catch { return $result }
465
+ if (-not $tail) { return $result }
466
+
467
+ # Шаблоны намеренно «якорные»: метка должна стоять в начале строки
468
+ # (допускается префикс времени лога). Раньше подходило любое "token=" или
469
+ # "cost:" внутри текста — конфиг-дампы и проза ИИ давали ложный расход.
470
+ $prefix = '^\\s*(?:\\[[^\\]]{4,40}\\]\\s*)?'
471
+ $tokenPatterns = @(
472
+ ($prefix + '(?i)(?:tokens?|token\\s+usage|usage)\\s*[:=]\\s*([0-9][0-9.,]*)\\s*([kKmM])?\\b'),
473
+ ($prefix + '(?i)(?:input|output|total)\\s+tokens?\\s*[:=]?\\s*([0-9][0-9.,]*)\\s*([kKmM])?\\b')
474
+ )
475
+ $costPatterns = @(
476
+ ($prefix + '(?i)(?:cost|total\\s+cost)\\s*[:=]?\\s*\\$\\s*([0-9]+(?:[.,][0-9]+)?)'),
477
+ ($prefix + '(?i)(?:cost|total\\s+cost)\\s*[:=]\\s*([0-9]+(?:[.,][0-9]+)?)\\s*(?:usd|\\$)')
478
+ )
479
+
480
+ # Идём с конца: OpenCode печатает итог последним, а более ранние строки
481
+ # могут быть эхом промпта или промежуточной статистикой.
482
+ for ($i = $tail.Count - 1; $i -ge 0; $i--) {
483
+ $text = "$($tail[$i])"
484
+ if ($text -match '(?i)opencode\\.json|OPENCODE_CONFIG') { continue }
485
+
486
+ if (-not $result.Tokens) {
487
+ foreach ($pattern in $tokenPatterns) {
488
+ if ($text -match $pattern) {
489
+ $raw = $matches[1] -replace ',', '.'
490
+ $value = 0.0
491
+ if ([double]::TryParse($raw, [ref]$value)) {
492
+ $suffix = ""
493
+ if ($matches.Count -gt 2 -and $matches[2]) {
494
+ $suffix = $matches[2].ToString().ToLower()
495
+ }
496
+ if ($suffix -eq 'k') { $value = $value * 1000 }
497
+ elseif ($suffix -eq 'm') { $value = $value * 1000000 }
498
+ $result.Tokens = [string]([int64][Math]::Round($value))
499
+ }
500
+ break
501
+ }
502
+ }
503
+ }
504
+
505
+ if (-not $result.Cost) {
506
+ foreach ($pattern in $costPatterns) {
507
+ if ($text -match $pattern) {
508
+ $result.Cost = $matches[1] -replace ',', '.'
509
+ break
510
+ }
511
+ }
512
+ }
513
+
514
+ if ($result.Tokens -and $result.Cost) { break }
515
+ }
516
+
517
+ return $result
518
+ }
519
+
520
+ try {
521
+ # Рабочая директория нужна и хукам, и основной задаче.
522
+ if ($Workdir) {
523
+ Set-Location $Workdir
524
+ }
525
+
526
+ if ($WorkspaceName) {
527
+ $gitBranch = "-"
528
+ $gitRemote = "-"
529
+ try {
530
+ $branchOut = & git -C "$Workdir" rev-parse --abbrev-ref HEAD 2>$null
531
+ if ($LASTEXITCODE -eq 0 -and $branchOut) { $gitBranch = "$branchOut".Trim() }
532
+ } catch {}
533
+ try {
534
+ $remoteOut = & git -C "$Workdir" remote get-url origin 2>$null
535
+ if ($LASTEXITCODE -eq 0 -and $remoteOut) { $gitRemote = "$remoteOut".Trim() }
536
+ } catch {}
537
+ Write-Log "[workspace] name=$WorkspaceName, cwd=$Workdir, branch=$gitBranch, remote=$gitRemote"
538
+ }
539
+
540
+ # Спринт 32 / релиз 1.6: политика прав вычисляется в TypeScript
541
+ # (src/core/permissions.ts) и передаётся готовым JSON в base64.
542
+ # Старые .cmd, созданные до 1.6, параметр не передают — для них остаётся
543
+ # прежнее поведение «разрешено всё» (fallback ниже).
544
+ $toolToAction = @{
545
+ "read" = "read"; "write" = "edit"; "edit" = "edit"; "apply_patch" = "edit"; "remove" = "edit"
546
+ "bash" = "shell"; "shell" = "shell"; "glob" = "glob"; "grep" = "grep"
547
+ "webfetch" = "webfetch"; "websearch" = "websearch"; "question" = "question"
548
+ "subagent" = "subagent"; "skill" = "skill"
549
+ }
550
+ if ($PermissionsB64) {
551
+ try {
552
+ $decoded = [Text.Encoding]::UTF8.GetString([Convert]::FromBase64String($PermissionsB64))
553
+ $config = $decoded | ConvertFrom-Json
554
+ $env:OPENCODE_CONFIG_CONTENT = ($config | ConvertTo-Json -Depth 5 -Compress)
555
+ Write-Log "[role-scoped] opencode config passed via OPENCODE_CONFIG_CONTENT"
556
+ } catch {
557
+ Write-Log "[policy] ERROR: cannot decode PermissionsB64 ($($_.Exception.Message)); falling back to legacy permissions"
558
+ $PermissionsB64 = ""
559
+ }
560
+ }
561
+ if ($PolicyB64) {
562
+ try {
563
+ $policyJson = [Text.Encoding]::UTF8.GetString([Convert]::FromBase64String($PolicyB64)) | ConvertFrom-Json
564
+ $legacyFlag = ""
565
+ if ($policyJson.legacyShell) { $legacyFlag = ", legacyShell=true" }
566
+ Write-Log "[policy] policy=$($policyJson.policy)$legacyFlag"
567
+ foreach ($denied in @($policyJson.denied)) {
568
+ if ($denied.action) {
569
+ Write-Log "[policy] deny $($denied.action): $($denied.hint)"
570
+ }
571
+ }
572
+ } catch {
573
+ Write-Log "[policy] WARN: cannot decode PolicyB64 ($($_.Exception.Message))"
574
+ }
575
+ }
576
+ if (-not $PermissionsB64) {
577
+ # Legacy fallback для обёрток, созданных до 1.6: все action разрешены,
578
+ # DeniedTools/AllowedTools применяются как раньше.
579
+ $defaultPermissions = @(
580
+ @{ action = "read"; resource = "*"; effect = "allow" },
581
+ @{ action = "edit"; resource = "*"; effect = "allow" },
582
+ @{ action = "glob"; resource = "*"; effect = "allow" },
583
+ @{ action = "grep"; resource = "*"; effect = "allow" },
584
+ @{ action = "shell"; resource = "*"; effect = "allow" },
585
+ @{ action = "subagent"; resource = "*"; effect = "allow" },
586
+ @{ action = "skill"; resource = "*"; effect = "allow" },
587
+ @{ action = "question"; resource = "*"; effect = "allow" },
588
+ @{ action = "webfetch"; resource = "*"; effect = "allow" },
589
+ @{ action = "websearch"; resource = "*"; effect = "allow" }
590
+ )
591
+ $permissions = @()
592
+ foreach ($p in $defaultPermissions) { $permissions += $p }
593
+ if ($DeniedTools) {
594
+ $deniedList = @($DeniedTools -split ',' | ForEach-Object { $_.Trim().ToLower() } | Where-Object { $_ })
595
+ foreach ($tool in $deniedList) {
596
+ $action = $toolToAction[$tool]
597
+ if ($action) {
598
+ $idx = $permissions | Where-Object { $_.action -eq $action }
599
+ if ($idx) { $idx.effect = "deny" }
600
+ }
601
+ }
602
+ }
603
+ if ($AllowedTools) {
604
+ $allowedList = @($AllowedTools -split ',' | ForEach-Object { $_.Trim().ToLower() } | Where-Object { $_ })
605
+ $allowedActions = @{}
606
+ foreach ($tool in $allowedList) {
607
+ $action = $toolToAction[$tool]
608
+ if ($action) { $allowedActions[$action] = $true }
609
+ }
610
+ foreach ($p in $permissions) {
611
+ if (-not $allowedActions.ContainsKey($p.action)) { $p.effect = "deny" }
612
+ }
613
+ }
614
+ $config = @{ "$schema" = "https://opencode.ai/config.json"; "permissions" = $permissions }
615
+ $env:OPENCODE_CONFIG_CONTENT = ($config | ConvertTo-Json -Depth 3 -Compress)
616
+ Write-Log "[role-scoped] opencode config passed via OPENCODE_CONFIG_CONTENT (legacy fallback)"
617
+ }
618
+
619
+ # Pre-flight: выполняется ДО основной задачи. Ненулевой код отменяет запуск.
620
+ if ($BeforeScript) {
621
+ Write-Log "[agent-steward] Pre-flight: $BeforeScript"
622
+ $preCode = Invoke-HookScript -Command $BeforeScript
623
+ if ($preCode -ne 0) {
624
+ Write-Log "[agent-steward] ОШИБКА: Pre-flight script failed (код $preCode)."
625
+ $script:preFlightStatus = "error"
626
+ $script:errorMessage = "Pre-flight script failed"
627
+ $script:exitCode = 1
628
+ $script:skipMainTask = $true
629
+ } else {
630
+ $script:preFlightStatus = "success"
631
+ Write-Log "[agent-steward] Pre-flight успешно завершён."
632
+ }
633
+ }
634
+
635
+ if (-not $script:skipMainTask) {
636
+ $prompt = Get-Content -Path $PromptFile -Raw -Encoding UTF8
637
+
638
+ # CreateProcess ограничивает командную строку 32767 символами, а промпт
639
+ # передаётся opencode аргументом ($opencodeArgs += $prompt). Явная ошибка
640
+ # понятнее, чем обрезанный/отвергнутый запуск. Основная валидация — в schedule_task.
641
+ if ($prompt -and $prompt.Length -gt 30000) {
642
+ throw "Промпт слишком длинный для командной строки Windows: $($prompt.Length) символов (максимум 30000). Сократите промпт."
643
+ }
644
+
645
+ # Спринт 21: env-переменные workspace. Файл пишет плагин, значения не логируются.
646
+ if ($EnvFile -and (Test-Path -LiteralPath $EnvFile)) {
647
+ try {
648
+ Get-Content -Path $EnvFile -Encoding UTF8 | ForEach-Object {
649
+ $line = $_.Trim()
650
+ if ($line -and -not $line.StartsWith("#") -and $line -match "^([A-Za-z_][A-Za-z0-9_]*)=(.*)$") {
651
+ Set-Item -Path ("env:" + $matches[1]) -Value $matches[2]
652
+ }
653
+ }
654
+ Write-Log "[agent-steward] Переменные окружения workspace загружены."
655
+ } catch {
656
+ Write-Log "[agent-steward] Не удалось загрузить env-файл workspace: $($_.Exception.Message)"
657
+ }
658
+ }
659
+
660
+ # Получаем путь к скрипту opencode (.ps1 или .cmd)
661
+ $opencodeCmd = Get-Command opencode | Select-Object -ExpandProperty Source
662
+
663
+ # Формируем аргументы для opencode run (Спринт 24: сессия).
664
+ # Спринт 29.2: --auto автоодобряет не запрещённые права, а ограничения
665
+ # берутся из сгенерированного opencode.jsonc в Workdir.
666
+ $opencodeArgs = @("run", "--auto")
667
+ if ($Model) {
668
+ $opencodeArgs += @("--model", $Model)
669
+ }
670
+ if ($SessionMode -eq 'reuse') {
671
+ # Спринт 24: актуальный id читаем из sidecar-файла — ротация сессии
672
+ # обновляет файл, и обёртку не нужно пересоздавать.
673
+ $effectiveSessionId = $SessionId
674
+ if ($SessionFile -and (Test-Path -LiteralPath $SessionFile)) {
675
+ try {
676
+ $fromFile = (Get-Content -LiteralPath $SessionFile -Raw -ErrorAction Stop).Trim()
677
+ if ($fromFile) { $effectiveSessionId = $fromFile }
678
+ } catch {
679
+ Write-Log "[agent-steward] Не удалось прочитать файл сессии: $($_.Exception.Message)"
680
+ }
681
+ }
682
+ if ($effectiveSessionId) {
683
+ $opencodeArgs += @("--session", $effectiveSessionId)
684
+ }
685
+ } elseif ($SessionMode -eq 'last') {
686
+ $opencodeArgs += @("--continue")
687
+ }
688
+ if ($prompt) {
689
+ $opencodeArgs += $prompt
690
+ }
691
+
692
+ # Запускаем opencode и НАПРЯМУЮ направляем весь вывод (stdout + stderr) в лог.
693
+ # Out-File -Append -Encoding utf8 пишет по мере поступления строк, поэтому
694
+ # ответ ИИ появляется в GUI ещё до завершения задачи.
695
+ # Hotfix 1.5.3.1: retryCount из схемы раньше нигде не применялся — теперь
696
+ # неудачная попытка повторяется до RetryCount раз с паузой RetryDelaySeconds.
697
+ $maxAttempts = 1 + [Math]::Max(0, $RetryCount)
698
+ $attempt = 0
699
+ while ($attempt -lt $maxAttempts) {
700
+ $attempt++
701
+ if ($attempt -gt 1) {
702
+ $waitSeconds = [Math]::Max(0, $RetryDelaySeconds)
703
+ Write-Log "[agent-steward] Повтор $($attempt - 1) из $($maxAttempts - 1) через $waitSeconds с..."
704
+ if ($waitSeconds -gt 0) { Start-Sleep -Seconds $waitSeconds }
705
+ $script:errorMessage = ""
706
+ }
707
+ $script:exitCode = Invoke-OpenCodeOnce -CommandPath $opencodeCmd -Arguments $opencodeArgs
708
+ if ($script:exitCode -eq 0) { break }
709
+ # Таймаут повторять бессмысленно: каждая попытка снова съест весь лимит.
710
+ if ($script:timedOut) { break }
711
+ if ($attempt -lt $maxAttempts) {
712
+ Write-Log "[agent-steward] Попытка $attempt завершилась с кодом $($script:exitCode)."
713
+ }
714
+ }
715
+
716
+ # Quality Gate: проверочная команда выполняется ТОЛЬКО после успешного
717
+ # завершения opencode run. Если ИИ упал — шлюз не запускаем.
718
+ if ($QualityGate -and $script:exitCode -eq 0) {
719
+ Write-Log "[agent-steward] Запуск Quality Gate: $QualityGate"
720
+ # Тот же таймаут, что у хуков: зависший gate не должен держать lock.
721
+ $gateCode = Invoke-HookScript -Command $QualityGate
722
+
723
+ if ($gateCode -eq 124) {
724
+ Write-Log "[agent-steward] ОШИБКА: Quality Gate превысил таймаут $GateTimeoutSeconds с и был остановлен."
725
+ $script:errorMessage = "Quality Gate: превышен таймаут $GateTimeoutSeconds с"
726
+ $script:exitCode = 1
727
+ } elseif ($gateCode -ne 0) {
728
+ Write-Log "[agent-steward] ОШИБКА: Quality Gate провален. Код возврата: $gateCode"
729
+ $script:errorMessage = "Quality Gate провален. Код возврата: $gateCode"
730
+ $script:exitCode = 1
731
+ } else {
732
+ Write-Log "[agent-steward] Quality Gate пройден."
733
+ }
734
+ }
735
+
736
+ if ($script:exitCode -ne 0) {
737
+ Write-Log "[agent-steward] Задача '$TaskName' завершилась с кодом $script:exitCode."
738
+ } else {
739
+ Write-Log "[agent-steward] Задача '$TaskName' успешно завершена."
740
+ }
741
+ } # конец блока основной задачи
742
+ } catch {
743
+ Write-Log "[agent-steward] Ошибка выполнения задачи '$TaskName': $_"
744
+ $script:errorMessage = "Ошибка выполнения задачи: $_"
745
+ $script:exitCode = 1
746
+ } finally {
747
+ # Post-flight: выполняется ВСЕГДА, даже если основная задача упала.
748
+ if ($AfterScript) {
749
+ Write-Log "[agent-steward] Post-flight: $AfterScript"
750
+ $postCode = Invoke-HookScript -Command $AfterScript
751
+ if ($postCode -ne 0) {
752
+ Write-Log "[agent-steward] ОШИБКА: Post-flight script failed (код $postCode)."
753
+ $script:postFlightStatus = "error"
754
+ if ($script:exitCode -eq 0) {
755
+ $script:errorMessage = "Post-flight script failed"
756
+ $script:exitCode = 1
757
+ }
758
+ } else {
759
+ $script:postFlightStatus = "success"
760
+ Write-Log "[agent-steward] Post-flight успешно завершён."
761
+ }
762
+ }
763
+
764
+ # Фиксируем факт выполнения в историю и метрики (независимо от того, кто запустил: GUI или Windows)
765
+ $endTime = Get-Date
766
+ $durationMs = [int](($endTime - $startTime).TotalMilliseconds)
767
+ # Hotfix 1.5.3.1: статус timeout теперь реально выставляется (см. Invoke-OpenCodeOnce).
768
+ if ($script:timedOut) {
769
+ $status = "timeout"
770
+ } elseif ($script:exitCode -eq 0) {
771
+ $status = "success"
772
+ } else {
773
+ $status = "error"
774
+ }
775
+ $usage = Get-UsageFromLog -File $LogFile
776
+ $tokensArg = "-"
777
+ if ($usage.Tokens) { $tokensArg = $usage.Tokens }
778
+ $costArg = "-"
779
+ if ($usage.Cost) { $costArg = $usage.Cost }
780
+ $modelArg = "-"
781
+ if ($Model) { $modelArg = $Model }
782
+ # Hotfix 1.5.3.1: пустая строка ошибки раньше «съедалась» PowerShell и
783
+ # сдвигала все следующие аргументы recorder (model получал preFlight,
784
+ # postFlight терялся). Теперь всегда передаём непустое значение.
785
+ $errorArg = "-"
786
+ if ($script:errorMessage) { $errorArg = $script:errorMessage }
787
+ if ($RecorderFile) {
788
+ try {
789
+ if ($script:runId) {
790
+ & node "$RecorderFile" --finish "$script:runId" "$TaskName" "$status" $durationMs "$errorArg" $tokensArg $costArg "$modelArg" "$script:preFlightStatus" "$script:postFlightStatus" "$LogFile"
791
+ } else {
792
+ # Fallback: --start не удался (например, старая установка) —
793
+ # пишем завершённую запись старым способом, без потери истории.
794
+ & node "$RecorderFile" "$TaskName" "$status" "$startedAtIso" $durationMs "$errorArg" $tokensArg $costArg "$modelArg" "$script:preFlightStatus" "$script:postFlightStatus" "$LogFile"
795
+ }
796
+ } catch {}
797
+ }
798
+
799
+ # Снимаем блокировку только если мы её захватили: иначе пропущенный
800
+ # параллельный запуск удалял бы lock активной задачи.
801
+ if ($script:lockAcquired -and $LockFile -and (Test-Path $LockFile)) {
802
+ try {
803
+ Remove-Item $LockFile -Force
804
+ } catch {}
805
+ }
806
+ }
807
+
808
+ exit $script:exitCode
809
+ `;
810
+ /**
811
+ * Гарантирует existence директорий плагина и записывает generic-обёртку.
812
+ * Возвращает путь к обёртке.
813
+ */
814
+ export async function ensureWrapper() {
815
+ await fs.mkdir(WRAPPER_DIR, { recursive: true });
816
+ const wrapperPath = path.join(WRAPPER_DIR, WRAPPER_FILENAME);
817
+ // BOM обязателен: Windows PowerShell 5.1 читает .ps1 без BOM как ANSI,
818
+ // из-за чего кириллица в сообщениях Write-Log превращается в мусор.
819
+ await fs.writeFile(wrapperPath, "\uFEFF" + WRAPPER_SCRIPT, "utf8");
820
+ return wrapperPath;
821
+ }
822
+ /**
823
+ * Записывает промпт задачи во временный файл и возвращает его путь.
824
+ *
825
+ * Имя санитизируется внутри функции, а не только у вызывающей стороны:
826
+ * defence-in-depth против path traversal, если taskName когда-либо придёт
827
+ * из недоверенного источника (импорт, шаблон, RPC).
828
+ */
829
+ export async function writePromptFile(taskName, prompt) {
830
+ const promptDir = path.join(PLUGIN_DIR, "prompts");
831
+ await fs.mkdir(promptDir, { recursive: true });
832
+ const promptPath = path.join(promptDir, `${sanitizeName(taskName)}.txt`);
833
+ // BOM помогает Windows PowerShell 5.1 правильно прочитать кириллицу.
834
+ // На POSIX BOM попал бы в промпт как мусорный символ — не пишем его.
835
+ const content = process.platform === "win32" ? "\uFEFF" + prompt : prompt;
836
+ await fs.writeFile(promptPath, content, "utf8");
837
+ return promptPath;
838
+ }
839
+ /**
840
+ * Возвращает путь к lock-файлу задачи.
841
+ *
842
+ * Как и writePromptFile, санитизирует имя внутри: без этого значение с `../`
843
+ * могло бы создать lock вне каталога locks.
844
+ */
845
+ export function lockFilePath(taskName) {
846
+ return path.join(PLUGIN_DIR, "locks", `${sanitizeName(taskName)}.lock`);
847
+ }
848
+ /**
849
+ * Генерирует per-task .cmd-обёртку, которую schtasks вызывает через /tr.
850
+ * Внутри .cmd — жёстко заданный вызов run-task.ps1 с задачей, промптом,
851
+ * таймаутом и lock-файлом. schtasks получает только один путь (в кавычках),
852
+ * поэтому спецсимволы и кириллица в аргументах больше не ломают парсинг.
853
+ *
854
+ * @param sanitizedName безопасное имя для файла (латиница, цифры, -, _)
855
+ * @param taskName отображаемое имя задачи в taskschd.msc (как есть, может быть кириллицей)
856
+ * @param promptFile абсолютный путь к файлу с промптом
857
+ * @param timeoutSeconds таймаут в секундах
858
+ * @param lockFile абсолютный путь к lock-файлу
859
+ * @param workdir рабочая директория (опционально; по умолчанию — process.cwd())
860
+ * @param logFile путь к файлу лога
861
+ * @param recorderFile путь к record-history.js (история/метрики)
862
+ * @param qualityGate проверочная команда Quality Gate
863
+ * @param model LLM-модель для `opencode run --model` (опционально)
864
+ * @param beforeScript pre-flight команда (опционально)
865
+ * @param afterScript post-flight команда (опционально)
866
+ * @param workspaceName имя workspace для git-контекста в логе (опционально)
867
+ * @param allowedTools список разрешённых инструментов (спринт 14, опционально)
868
+ * @param deniedTools список запрещённых инструментов (спринт 14, опционально)
869
+ * @param scheduleGate гейт расписания (спринт 19): проверка cron в таймзоне
870
+ * и окна запуска перед стартом PowerShell-обёртки.
871
+ * @param envFile env-файл workspace (спринт 21, опционально)
872
+ * @param sessionMode режим сессии OpenCode (спринт 24): "new" (по умолчанию,
873
+ * без флагов), "reuse" (--session $SessionId), "last" (--continue)
874
+ * @param sessionId идентификатор сессии для режима "reuse" (спринт 24, опционально)
875
+ */
876
+ /**
877
+ * Hotfix 1.5.3.1: хуки и Quality Gate пишутся в отдельные .cmd-файлы.
878
+ *
879
+ * Раньше команда передавалась аргументом в однострочный вызов powershell.exe,
880
+ * а кавычки внутри неё заменялись на апострофы: `echo x > "C:\Program Files\out.txt"`
881
+ * превращался в нерабочий `echo x > 'C:\Program Files\out.txt'`. Файл снимает
882
+ * проблему целиком — внутри .cmd можно использовать любые кавычки и пайпы.
883
+ */
884
+ async function writeHookFile(sanitizedName, kind, command) {
885
+ const dir = path.join(WRAPPER_DIR, "hooks");
886
+ await fs.mkdir(dir, { recursive: true });
887
+ const file = path.join(dir, `run-${sanitizedName}-${kind}.cmd`);
888
+ await fs.writeFile(file, `@echo off\r\nchcp 65001 >nul\r\n${command}\r\n`, "utf8");
889
+ return file;
890
+ }
891
+ export async function writeWrapperCmd(sanitizedName, taskName, promptFile, timeoutSeconds, lockFile, workdir, logFile, recorderFile, qualityGate, model, beforeScript, afterScript, workspaceName, allowedTools, deniedTools, scheduleGate, envFile, sessionMode, sessionId, retryCount, retryDelaySeconds, gateTimeoutSeconds, permissionsConfig, policyMeta, sessionFile) {
892
+ await fs.mkdir(WRAPPER_DIR, { recursive: true });
893
+ const cmdPath = path.join(WRAPPER_DIR, `run-${sanitizedName}.cmd`);
894
+ const ps1Path = path.join(WRAPPER_DIR, WRAPPER_FILENAME);
895
+ // ВАЖНО: команда powershell.exe должна быть ОДНОЙ строкой.
896
+ // Раньше -LogFile и -RecorderFile добавлялись отдельными строками .cmd,
897
+ // из-за чего PowerShell их не получал, а cmd пытался выполнить их как
898
+ // самостоятельные команды: логи оставались пустыми, история не писалась.
899
+ const psArgs = [
900
+ `powershell.exe -ExecutionPolicy Bypass -WindowStyle Hidden -NoProfile -File "${ps1Path}"`,
901
+ `-TaskName "${taskName}"`,
902
+ `-PromptFile "${promptFile}"`,
903
+ `-TimeoutSeconds ${timeoutSeconds}`,
904
+ `-LockFile "${lockFile}"`,
905
+ `-StaleLockMaxAgeMs ${STALE_LOCK_MAX_AGE_MS}`,
906
+ ];
907
+ // Таймаут хуков/Quality Gate: 300 с по умолчанию, 0 — без ограничения.
908
+ const safeGateTimeout = typeof gateTimeoutSeconds === "number" && Number.isFinite(gateTimeoutSeconds)
909
+ ? Math.max(0, Math.floor(gateTimeoutSeconds))
910
+ : 300;
911
+ psArgs.push(`-GateTimeoutSeconds ${safeGateTimeout}`);
912
+ // Hotfix 1.5.3.1: ретраи. Параметр не передаём при 0 — обёртка по умолчанию
913
+ // делает ровно одну попытку, как раньше.
914
+ const safeRetryCount = Math.max(0, Math.floor(retryCount ?? 0));
915
+ if (safeRetryCount > 0) {
916
+ psArgs.push(`-RetryCount ${safeRetryCount}`);
917
+ psArgs.push(`-RetryDelaySeconds ${Math.max(0, Math.floor(retryDelaySeconds ?? 0))}`);
918
+ }
919
+ if (logFile) {
920
+ psArgs.push(`-LogFile "${logFile}"`);
921
+ }
922
+ if (recorderFile) {
923
+ psArgs.push(`-RecorderFile "${recorderFile}"`);
924
+ }
925
+ if (qualityGate?.trim()) {
926
+ // Hotfix 1.5.3.1: команда пишется в отдельный .cmd — кавычки и пайпы
927
+ // внутри неё больше не ломают однострочный вызов powershell.exe.
928
+ const gateFile = await writeHookFile(sanitizedName, "gate", qualityGate);
929
+ psArgs.push(`-QualityGate "${gateFile}"`);
930
+ }
931
+ if (model?.trim()) {
932
+ const safeModel = model.replace(/[\r\n"]+/g, "").trim();
933
+ if (safeModel) {
934
+ const modelB64 = Buffer.from(safeModel, "utf8").toString("base64");
935
+ psArgs.push(`-ModelB64 "${modelB64}"`);
936
+ }
937
+ }
938
+ if (workspaceName?.trim()) {
939
+ const workspaceB64 = Buffer.from(workspaceName.trim(), "utf8").toString("base64");
940
+ psArgs.push(`-WorkspaceNameB64 "${workspaceB64}"`);
941
+ }
942
+ // Role-scoped tools (спринт 14): передаём списки одной строкой через запятую.
943
+ for (const [flag, list] of [
944
+ ["-AllowedToolsB64", allowedTools],
945
+ ["-DeniedToolsB64", deniedTools],
946
+ ]) {
947
+ const joined = (Array.isArray(list) ? list : [])
948
+ .map((item) => String(item).trim())
949
+ .filter(Boolean)
950
+ .join(",");
951
+ if (joined) {
952
+ const b64 = Buffer.from(joined, "utf8").toString("base64");
953
+ psArgs.push(`${flag} "${b64}"`);
954
+ }
955
+ }
956
+ // Спринт 32: готовый JSON политики и метаданные для лога — в base64.
957
+ // Base64 не содержит кавычек и переводов строк, поэтому безопасен для .cmd.
958
+ if (permissionsConfig) {
959
+ const b64 = Buffer.from(permissionsConfig, "utf8").toString("base64");
960
+ psArgs.push(`-PermissionsB64 "${b64}"`);
961
+ }
962
+ if (policyMeta) {
963
+ const b64 = Buffer.from(JSON.stringify(policyMeta), "utf8").toString("base64");
964
+ psArgs.push(`-PolicyB64 "${b64}"`);
965
+ }
966
+ // Hotfix 1.5.3.1: хуки — в отдельные .cmd-файлы (см. writeHookFile).
967
+ // Раньше кавычки заменялись на апострофы, из-за чего хуки с путями в кавычках
968
+ // (например, "C:\Program Files\...") падали.
969
+ for (const [flag, script, kind] of [
970
+ ["-BeforeScript", beforeScript, "before"],
971
+ ["-AfterScript", afterScript, "after"],
972
+ ]) {
973
+ if (script?.trim()) {
974
+ const hookFile = await writeHookFile(sanitizedName, kind, script);
975
+ psArgs.push(`${flag} "${hookFile}"`);
976
+ }
977
+ }
978
+ // Спринт 21: env-файл workspace (пары KEY=VALUE). Значения не логируются.
979
+ if (envFile?.trim()) {
980
+ const safeEnvFile = envFile.replace(/[\r\n"]+/g, "").trim();
981
+ if (safeEnvFile) {
982
+ psArgs.push(`-EnvFile "${safeEnvFile}"`);
983
+ }
984
+ }
985
+ // Спринт 24: режим сессии OpenCode. sessionId передаём только для reuse.
986
+ const safeSessionMode = sessionMode === "reuse" || sessionMode === "last" ? sessionMode : "new";
987
+ if (safeSessionMode !== "new") {
988
+ psArgs.push(`-SessionMode "${safeSessionMode}"`);
989
+ if (safeSessionMode === "reuse") {
990
+ const safeSessionId = (sessionId ?? "").replace(/[\r\n"]+/g, "").trim();
991
+ if (safeSessionId) {
992
+ psArgs.push(`-SessionId "${safeSessionId}"`);
993
+ }
994
+ if (sessionFile?.trim()) {
995
+ const safeSessionFile = sessionFile.replace(/[\r\n"]+/g, "").trim();
996
+ if (safeSessionFile) {
997
+ psArgs.push(`-SessionFile "${safeSessionFile}"`);
998
+ }
999
+ }
1000
+ }
1001
+ }
1002
+ const lines = ["@echo off", "chcp 65001 >nul"];
1003
+ // Рабочая директория: всегда переходим в неё ДО запуска PowerShell.
1004
+ // По умолчанию — текущая папка проекта (process.cwd()). Это критично для
1005
+ // MCP: opencode run подхватывает opencode.json из рабочей директории.
1006
+ const effectiveWorkdir = workdir?.trim() || process.cwd();
1007
+ lines.push(`cd /d "${effectiveWorkdir}"`);
1008
+ // Спринт 19: гейт расписания ДО PowerShell. Проверяет, что cron реально
1009
+ // сработал сейчас (для poll-режима и чужих таймзон), и при необходимости
1010
+ // переносит запуск до открытия окна notBefore..notAfter.
1011
+ // Exit 3 — «не сейчас», выходим тихо, не считая это запуском задачи.
1012
+ if (scheduleGate?.gateFile) {
1013
+ const gateArgs = [`node "${scheduleGate.gateFile}"`];
1014
+ if (scheduleGate.cron?.trim()) {
1015
+ gateArgs.push(`--cron "${scheduleGate.cron.replace(/[\r\n"]+/g, " ").trim()}"`);
1016
+ }
1017
+ if (scheduleGate.tz?.trim()) {
1018
+ gateArgs.push(`--tz "${scheduleGate.tz.trim()}"`);
1019
+ }
1020
+ if (scheduleGate.notBefore?.trim()) {
1021
+ gateArgs.push(`--not-before ${scheduleGate.notBefore.trim()}`);
1022
+ }
1023
+ if (scheduleGate.notAfter?.trim()) {
1024
+ gateArgs.push(`--not-after ${scheduleGate.notAfter.trim()}`);
1025
+ }
1026
+ // Спринт 27: дни недели и политика окна.
1027
+ if (Array.isArray(scheduleGate.days) && scheduleGate.days.length > 0) {
1028
+ gateArgs.push(`--days ${scheduleGate.days.join(",")}`);
1029
+ }
1030
+ if (scheduleGate.windowPolicy) {
1031
+ gateArgs.push(`--window-policy ${scheduleGate.windowPolicy}`);
1032
+ }
1033
+ if (scheduleGate.deferFile?.trim()) {
1034
+ gateArgs.push(`--defer-file "${scheduleGate.deferFile.trim()}"`);
1035
+ }
1036
+ // Маркер ручного запуска: run_task_now/файловый триггер/MCP-событие
1037
+ // создают его перед вызовом schtasks /run, чтобы gate не отсекал запуск
1038
+ // по cron. Без этого run_task_now был тихим no-op для poll-режима.
1039
+ if (scheduleGate.forceFile?.trim()) {
1040
+ gateArgs.push(`--force-file "${scheduleGate.forceFile.trim()}"`);
1041
+ }
1042
+ // append к логу задачи, чтобы перенос/пропуск был виден в истории запусков
1043
+ if (logFile?.trim()) {
1044
+ gateArgs.push(`>> "${logFile.trim()}" 2>&1`);
1045
+ }
1046
+ lines.push(gateArgs.join(" "));
1047
+ lines.push("if \"%errorlevel%\"==\"3\" exit /b 0");
1048
+ }
1049
+ lines.push(psArgs.join(" "));
1050
+ await fs.writeFile(cmdPath, lines.join("\r\n"), "utf8");
1051
+ return cmdPath;
1052
+ }
1053
+ // ---------------------------------------------------------------------------
1054
+ // Маркер ручного запуска.
1055
+ /** Сколько живёт маркер ручного запуска (должно совпадать с schedule-gate.ts). */
1056
+ export const FORCE_FILE_TTL_MS = 2 * 60 * 1000;
1057
+ /**
1058
+ * Путь к маркеру немедленного запуска задачи.
1059
+ *
1060
+ * Лежит рядом с lock-файлом и вычисляется из того же санитизированного имени,
1061
+ * поэтому обёртка (--force-file) и агент указывают на один и тот же файл.
1062
+ */
1063
+ export function forceFilePath(taskName) {
1064
+ return `${lockFilePath(taskName)}.force`;
1065
+ }
1066
+ /**
1067
+ * Создаёт маркер «запустить сейчас» перед вызовом планировщика ОС.
1068
+ *
1069
+ * Зачем: для poll-режима (нестандартный cron/чужая таймзона/окно запуска)
1070
+ * обёртка всегда прогоняет schedule-gate, и ручной запуск вне cron-окна
1071
+ * молча завершался с exit 3 — инструмент рапортовал success, но задача не
1072
+ * выполнялась. Gate поглощает свежий маркер и пропускает проверку расписания.
1073
+ *
1074
+ * Маркер самоуничтожается через FORCE_FILE_TTL_MS, если задача так и не
1075
+ * стартовала (например, отключена в планировщике), чтобы не влиять на
1076
+ * последующие плановые запуски.
1077
+ */
1078
+ export async function requestImmediateRun(taskName) {
1079
+ const file = forceFilePath(taskName);
1080
+ await fs.mkdir(LOCK_DIR, { recursive: true });
1081
+ await fs.writeFile(file, new Date().toISOString(), "utf8");
1082
+ const timer = setTimeout(() => {
1083
+ void fs.unlink(file).catch(() => {
1084
+ /* маркер уже поглощён gate'ом или удалён вручную */
1085
+ });
1086
+ }, FORCE_FILE_TTL_MS);
1087
+ // Таймер не должен удерживать процесс хоста.
1088
+ if (typeof timer.unref === "function")
1089
+ timer.unref();
1090
+ return file;
1091
+ }