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