agent-steward 0.0.0-stage → 0.0.2

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