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,711 @@
1
+ import { execFile } from "node:child_process";
2
+ import { promisify } from "node:util";
3
+ import iconv from "iconv-lite";
4
+ import type { ScheduledTaskInfo } from "../../types.js";
5
+ import { TASK_FOLDER, TASK_FOLDER_NAME, taskFolderNameForProfile } from "../../types.js";
6
+ import { getProfileName } from "../../profiles.js";
7
+ import { buildScheduleFlags, convertCronToSchTasks } from "../cron-to-schtasks.js";
8
+ import { buildWindowsOneShotFlags } from "../one-shot.js";
9
+ import { needsPollMode } from "../schedule-v2.js";
10
+ import type {
11
+ CreateTaskOptions,
12
+ RunTaskResult,
13
+ SchedulerBackend,
14
+ } from "./types.js";
15
+
16
+ const execFileAsync = promisify(execFile);
17
+
18
+ /** Максимальный размер вывода schtasks (обычно хватает с большим запасом). */
19
+ const MAX_OUTPUT_BUFFER = 10 * 1024 * 1024;
20
+
21
+ /** Префикс папки задач плагина в Планировщике заданий Windows. */
22
+ export const WINDOWS_TASK_PREFIX = `\\${TASK_FOLDER}\\${TASK_FOLDER_NAME}\\`;
23
+
24
+ /** Префикс папки задач конкретного профиля (для удаления неактивного профиля). */
25
+ export function windowsTaskPrefixForProfile(profile: string): string {
26
+ return `\\${TASK_FOLDER}\\${taskFolderNameForProfile(profile)}\\`;
27
+ }
28
+
29
+ /** Полное имя задачи в папке конкретного профиля. */
30
+ export function taskFullNameForProfile(name: string, profile: string): string {
31
+ const prefix = windowsTaskPrefixForProfile(profile);
32
+ return name.startsWith(prefix) ? name : prefix + name;
33
+ }
34
+
35
+ /**
36
+ * Кэш OEM-кодовой страницы системы. Заполняется один раз через реестр
37
+ * HKLM\SYSTEM\CurrentControlSet\Control\Nls\CodePage (значение OEMCP).
38
+ */
39
+ let oemCodePageCache: number | null = null;
40
+
41
+ /**
42
+ * Определяет OEM-кодовую страницу системы из реестра Windows.
43
+ *
44
+ * schtasks.exe и другие консольные утилиты выводят текст в OEM-кодировке
45
+ * системы (CP866 на русской Windows, 850/852 на западноевропейской, 437 на
46
+ * английской и т.д.). Жёсткий фолбэк на cp866 ломает вывод на DE/FR/ES/IT/PL
47
+ * и других локалях: акцентные ключи (nächste Ausführung, última ejecución и т.д.)
48
+ * превращаются в кракозябры и не распознаются парсером.
49
+ *
50
+ * Фолбэк — cp866 (историческое поведение на русской Windows).
51
+ */
52
+ export async function getOemCodePage(): Promise<number> {
53
+ if (oemCodePageCache !== null) {
54
+ return oemCodePageCache;
55
+ }
56
+ try {
57
+ const { stdout } = await execFileAsync("reg", [
58
+ "query",
59
+ "HKLM\\SYSTEM\\CurrentControlSet\\Control\\Nls\\CodePage",
60
+ "/v",
61
+ "OEMCP",
62
+ ], {
63
+ windowsHide: true,
64
+ encoding: "buffer",
65
+ maxBuffer: 64 * 1024,
66
+ });
67
+ // reg query выводит в OEM-кодировке, но цифры кода страницы — ASCII,
68
+ // поэтому декодировать можно через cp866/utf8 — цифры не пострадают.
69
+ const text = decodeConsoleOutputSync(stdout);
70
+ // Значение может быть REG_DWORD (0x362) или REG_SZ (866 / "866").
71
+ const hexMatch = text.match(/0x([0-9A-Fa-f]{1,8})/i);
72
+ const decMatch = text.match(/\b(\d{2,5})\b/);
73
+ let cp: number | null = null;
74
+ if (hexMatch) {
75
+ cp = parseInt(hexMatch[1], 16);
76
+ } else if (decMatch) {
77
+ cp = parseInt(decMatch[1], 10);
78
+ }
79
+ if (cp && cp > 0 && cp < 65536) {
80
+ oemCodePageCache = cp;
81
+ return cp;
82
+ }
83
+ } catch {
84
+ // реестр недоступен — фолбэк ниже
85
+ }
86
+ oemCodePageCache = 866;
87
+ return 866;
88
+ }
89
+
90
+ /**
91
+ * Синхронная обёртка для начального определения OEMCP (используется внутри
92
+ * getOemCodePage для декодирования вывода reg query). Цифры кода страницы —
93
+ * ASCII, поэтому cp866/utf8 безопасны для этого шага.
94
+ */
95
+ export function decodeConsoleOutputSync(buf: Buffer | string | undefined | null): string {
96
+ if (!buf) return "";
97
+ if (typeof buf === "string") return buf;
98
+ if (buf.length === 0) return "";
99
+
100
+ const utf8 = buf.toString("utf8");
101
+ if (!utf8.includes("\uFFFD")) {
102
+ return utf8;
103
+ }
104
+
105
+ return iconv.decode(buf, "cp866");
106
+ }
107
+
108
+ /**
109
+ * Декодирует вывод консольных утилит Windows.
110
+ *
111
+ * `schtasks.exe` запускается напрямую, без `cmd.exe`, поэтому метасимволы
112
+ * в аргументах не исполняются. Вывод утилиты приходит в OEM-кодировке системы,
113
+ * из-за чего Node, читающий его как UTF-8, показывает «?????». Поэтому:
114
+ * если байты — валидный UTF-8, декодируем как UTF-8, иначе пробуем OEMCP
115
+ * системы (определяется из реестра Nls\CodePage), с фолбэком на cp866.
116
+ */
117
+ export async function decodeConsoleOutput(buf: Buffer | string | undefined | null): Promise<string> {
118
+ if (!buf) return "";
119
+ if (typeof buf === "string") return buf;
120
+ if (buf.length === 0) return "";
121
+
122
+ const utf8 = buf.toString("utf8");
123
+ if (!utf8.includes("\uFFFD")) {
124
+ return utf8;
125
+ }
126
+
127
+ const cp = await getOemCodePage();
128
+ try {
129
+ return iconv.decode(buf, `cp${cp}`);
130
+ } catch {
131
+ return iconv.decode(buf, "cp866");
132
+ }
133
+ }
134
+
135
+ /** Достаёт Buffer из ошибки execFile (при encoding: "buffer"). */
136
+ function errorBuffer(err: unknown, field: "stdout" | "stderr"): Buffer | undefined {
137
+ const value = (err as Record<string, unknown> | null)?.[field];
138
+ return Buffer.isBuffer(value) ? value : undefined;
139
+ }
140
+
141
+ /**
142
+ * Собирает читаемый текст ошибки.
143
+ *
144
+ * err.message от Node содержит stderr, уже декодированный как UTF-8,
145
+ * поэтому для русской Windows там остаются «кракозябры». Берём из message
146
+ * только первую строку (команду), а текст ошибки — из наших Buffer'ов.
147
+ */
148
+ function buildErrorDetails(err: unknown, stdout: string, stderr: string): string {
149
+ const message = (err as { message?: string } | null)?.message ?? "";
150
+ const commandLine = message.split(/\r?\n/)[0] ?? "";
151
+ return [...new Set([commandLine, stdout, stderr].filter(Boolean))].join(" | ");
152
+ }
153
+
154
+ /** Результат выполнения команды schtasks. */
155
+ export interface SchtasksResult {
156
+ stdout: string;
157
+ stderr: string;
158
+ code: number | null;
159
+ }
160
+
161
+ /**
162
+ * Поясняет известные коды и тексты ошибок schtasks.
163
+ *
164
+ * Возвращает `null`, если код/текст неизвестен: исходное сообщение в этом
165
+ * случае не меняется. schtasks часто возвращает общий код `1`, поэтому
166
+ * текстовая эвристика остаётся основным фолбэком.
167
+ */
168
+ export function explainSchtasksError(
169
+ code: number | null,
170
+ text: string
171
+ ): string | null {
172
+ // HRESULT-коды приходят как знаковые 32-битные числа; приводим к unsigned.
173
+ const unsigned =
174
+ typeof code === "number" && Number.isFinite(code)
175
+ ? code < 0
176
+ ? code >>> 0
177
+ : code
178
+ : null;
179
+
180
+ const byCode: Record<number, string> = {
181
+ 267009: "Задача сейчас выполняется.",
182
+ 267010: "Задача отключена.",
183
+ 267011: "Задача ещё ни разу не запускалась.",
184
+ 267012: "У задачи больше нет запланированных запусков.",
185
+ 267013: "Задача не запланирована.",
186
+ 267014: "Выполнение задачи было прервано пользователем.",
187
+ 2147942405: "Нет прав на операцию с задачей (access denied).",
188
+ 2147942402: "Задача или файл не найдены.",
189
+ };
190
+
191
+ if (unsigned !== null && byCode[unsigned]) {
192
+ return byCode[unsigned];
193
+ }
194
+
195
+ const lower = text.toLowerCase();
196
+ const byText: Array<[string[], string]> = [
197
+ [
198
+ ["access is denied", "отказано в доступе"],
199
+ "Нет прав на операцию с задачей (access denied).",
200
+ ],
201
+ [
202
+ ["cannot find", "не удалось найти", "не найдено"],
203
+ "Задача или файл не найдены.",
204
+ ],
205
+ [
206
+ ["already running", "currently running", "уже выполняется", "уже запущена", "сейчас выполняется"],
207
+ "Задача уже выполняется.",
208
+ ],
209
+ [["is disabled", "отключена"], "Задача отключена."],
210
+ ];
211
+
212
+ for (const [needles, hint] of byText) {
213
+ if (needles.some((needle) => lower.includes(needle))) {
214
+ return hint;
215
+ }
216
+ }
217
+
218
+ return null;
219
+ }
220
+
221
+ /** Ошибка выполнения schtasks. */
222
+ export class SchtasksError extends Error {
223
+ constructor(
224
+ message: string,
225
+ public readonly code: number | null,
226
+ public readonly stderr: string
227
+ ) {
228
+ const hint = explainSchtasksError(code, `${message} ${stderr}`);
229
+ super(hint ? `${message} | пояснение: ${hint}` : message);
230
+ this.name = "SchtasksError";
231
+ }
232
+ }
233
+
234
+ /**
235
+ * Выполняет `schtasks.exe` напрямую с массивом аргументов.
236
+ *
237
+ * Раньше команда собиралась в строку и запускалась через `cmd.exe /c`,
238
+ * из-за чего метасимволы (`&`, `|`, `"`) в имени задачи исполнялись
239
+ * оболочкой: можно было получить command injection и «фантомную» задачу.
240
+ * `execFile` передаёт каждый аргумент отдельно — оболочки в цепочке нет.
241
+ */
242
+ export async function runSchtasks(args: string[]): Promise<SchtasksResult> {
243
+ try {
244
+ const { stdout, stderr } = (await execFileAsync("schtasks", args, {
245
+ windowsHide: true,
246
+ encoding: "buffer",
247
+ maxBuffer: MAX_OUTPUT_BUFFER,
248
+ })) as unknown as { stdout: Buffer; stderr: Buffer };
249
+ return {
250
+ stdout: await decodeConsoleOutput(stdout),
251
+ stderr: await decodeConsoleOutput(stderr),
252
+ code: 0,
253
+ };
254
+ } catch (err) {
255
+ const e = err as { message?: string; code?: number | null };
256
+ const stdout = await decodeConsoleOutput(errorBuffer(err, "stdout"));
257
+ const stderr = await decodeConsoleOutput(errorBuffer(err, "stderr"));
258
+ throw new SchtasksError(
259
+ `schtasks error: ${buildErrorDetails(err, stdout, stderr)}`,
260
+ e.code ?? null,
261
+ stderr
262
+ );
263
+ }
264
+ }
265
+
266
+ /** Формирует полное имя задачи с папкой плагина. */
267
+ export function taskFullName(name: string): string {
268
+ if (name.startsWith(WINDOWS_TASK_PREFIX)) {
269
+ return name;
270
+ }
271
+ return WINDOWS_TASK_PREFIX + name;
272
+ }
273
+
274
+ /** Убирает папку плагина из полного имени задачи. */
275
+ function shortTaskName(fullName: string): string {
276
+ return fullName.startsWith(WINDOWS_TASK_PREFIX)
277
+ ? fullName.slice(WINDOWS_TASK_PREFIX.length)
278
+ : fullName;
279
+ }
280
+
281
+ /**
282
+ * Бэкенд Планировщика заданий Windows (schtasks).
283
+ *
284
+ * Вся Windows-специфика (кодировка консоли, формат /tn, ONCE-заглушка для
285
+ * файловых триггеров) инкапсулирована здесь.
286
+ */
287
+ export class WindowsScheduler implements SchedulerBackend {
288
+ readonly platform: NodeJS.Platform = "win32";
289
+ readonly title = "Планировщик Windows";
290
+
291
+ /** Имя папки задач и её префикс — в пространстве имён своего профиля. */
292
+ private readonly taskFolderName: string;
293
+ private readonly taskPrefix: string;
294
+
295
+ constructor(profile: string = getProfileName()) {
296
+ this.taskFolderName = taskFolderNameForProfile(profile);
297
+ this.taskPrefix = windowsTaskPrefixForProfile(profile);
298
+ }
299
+
300
+ /** Полное имя задачи (\OpenCode\<профиль>\<name>) для этого бэкенда. */
301
+ private fullName(name: string): string {
302
+ return name.startsWith(this.taskPrefix) ? name : this.taskPrefix + name;
303
+ }
304
+
305
+ /** Убирает папку профиля из полного имени задачи. */
306
+ private shortName(fullName: string): string {
307
+ return fullName.startsWith(this.taskPrefix)
308
+ ? fullName.slice(this.taskPrefix.length)
309
+ : fullName;
310
+ }
311
+
312
+ async createTask(options: CreateTaskOptions): Promise<void> {
313
+ const { name, command, schedule, triggerType } = options;
314
+
315
+ let scheduleFlags: string[];
316
+
317
+ if (triggerType === "once") {
318
+ // Настоящий one-shot: Windows сам удалит задачу из расписания после
319
+ // единственного запуска, повторных срабатываний не будет.
320
+ if (!options.runAt) {
321
+ throw new Error(
322
+ `Задача "${name}": для triggerType=once не передано время runAt.`
323
+ );
324
+ }
325
+ scheduleFlags = buildWindowsOneShotFlags(options.runAt);
326
+ } else if (triggerType && triggerType !== "cron") {
327
+ // Файловый или MCP-триггер: однократный запуск в далёком будущем.
328
+ // Активация — только вручную (runTask / файловый watcher / emit_event).
329
+ scheduleFlags = ["/sc", "ONCE", "/sd", "31.12.2099", "/st", "00:00"];
330
+ } else {
331
+ // Выражения, которые Windows не выражает нативно (список через запятую, L, #,
332
+ // именованные месяцы и т.д.), падают в минутный опрос + gate во враппере.
333
+ const tz = options.timezone?.trim() || null;
334
+ const poll = needsPollMode(schedule, tz);
335
+ if (poll) {
336
+ scheduleFlags = ["/sc", "MINUTE", "/mo", "1"];
337
+ } else {
338
+ // parseCron/валидация УЖЕ выполнена вызывающим кодом перед этим местом.
339
+ const native = convertCronToSchTasks(schedule);
340
+ scheduleFlags = buildScheduleFlags(native);
341
+ }
342
+ }
343
+
344
+ const fullName = this.fullName(name);
345
+ // Спринт 27.5.4: по умолчанию задача интерактивная — schtasks запускает её
346
+ // только при активном входе пользователя (Interactive only). Для работы без
347
+ // входа нужен SYSTEM: он не требует пароля, но работает в session 0 без
348
+ // профиля пользователя (нет доступа к пользовательским файлам/сети/ключам).
349
+ const logonFlags = options.runWhenLoggedOff ? ["/ru", "SYSTEM"] : [];
350
+ const args: string[] = [
351
+ "/create",
352
+ "/tn",
353
+ fullName,
354
+ "/tr",
355
+ `"${command}"`,
356
+ ...scheduleFlags,
357
+ ...logonFlags,
358
+ "/f",
359
+ ];
360
+
361
+ let result: SchtasksResult;
362
+ try {
363
+ result = await runSchtasks(args);
364
+ } catch (err) {
365
+ if (!(err instanceof SchtasksError)) throw err;
366
+
367
+ const text = `${err.stderr} ${err.message}`.toLowerCase();
368
+
369
+ const isRunning =
370
+ text.includes("running") ||
371
+ text.includes("выполняется") ||
372
+ text.includes("запущена") ||
373
+ text.includes("busy") ||
374
+ text.includes("in use") ||
375
+ text.includes("используется");
376
+
377
+ if (isRunning) {
378
+ throw new SchtasksError(
379
+ `Задача с именем "${name}" уже существует и выполняется. Дождитесь её завершения или удалите её.`,
380
+ err.code,
381
+ err.stderr
382
+ );
383
+ }
384
+
385
+ const alreadyExists =
386
+ text.includes("already exists") || text.includes("уже существует");
387
+
388
+ if (alreadyExists) {
389
+ throw new SchtasksError(
390
+ `Задача с именем "${name}" уже существует. Используйте delete_task или выберите другое имя.`,
391
+ err.code,
392
+ err.stderr
393
+ );
394
+ }
395
+
396
+ throw new SchtasksError(
397
+ `Не удалось создать задачу "${name}": ${
398
+ err.stderr || err.message || "неизвестная ошибка schtasks"
399
+ }`,
400
+ err.code,
401
+ err.stderr
402
+ );
403
+ }
404
+ if (result.code === 0) return;
405
+ }
406
+
407
+ async listTasks(): Promise<ScheduledTaskInfo[]> {
408
+ // /v нужен, чтобы ОС отдала «Режим входа» (Logon Mode): без него
409
+ // schtasks печатает только имя, время и состояние, а logonMode остаётся null.
410
+ const args = ["/query", "/v", "/fo", "LIST"];
411
+
412
+ let result: SchtasksResult;
413
+ try {
414
+ result = await runSchtasks(args);
415
+ } catch (err) {
416
+ if (err instanceof SchtasksError && isEmptyQueryResult(err)) {
417
+ return [];
418
+ }
419
+ throw err;
420
+ }
421
+
422
+ if (!result.stdout || !result.stdout.trim()) {
423
+ return [];
424
+ }
425
+
426
+ const allTasks = parseListOutput(result.stdout).filter((task) =>
427
+ Boolean(task.taskName)
428
+ );
429
+ const filtered = allTasks.filter((task) =>
430
+ (task.taskName || "").startsWith(this.taskPrefix)
431
+ );
432
+
433
+ // Fallback: если структурный парсер не распознал ключи (нестандартная
434
+ // локаль/кодировка), вытаскиваем имена задач по префиксу папки.
435
+ if (filtered.length === 0 && result.stdout.includes(this.taskFolderName)) {
436
+ const names = new Set<string>();
437
+ const folderPattern = `${TASK_FOLDER}[\\\\/]${this.taskFolderName}[\\\\/]`;
438
+ const re = new RegExp(`${folderPattern}([^\\r\\n"']+)`, "gi");
439
+ let m: RegExpExecArray | null;
440
+ while ((m = re.exec(result.stdout)) !== null) {
441
+ const nm = m[1].trim().replace(/[\s:]+$/, "");
442
+ if (nm) names.add(nm);
443
+ }
444
+ if (names.size > 0) {
445
+ return Array.from(names).map(
446
+ (nm) => ({ taskName: nm } as ScheduledTaskInfo)
447
+ );
448
+ }
449
+ }
450
+
451
+ return filtered.map((task) => ({
452
+ ...task,
453
+ taskName: this.shortName(task.taskName || ""),
454
+ paused: /disabled|отключ|запрещ/i.test(task.status ?? ""),
455
+ }));
456
+ }
457
+
458
+ async deleteTask(name: string): Promise<void> {
459
+ // schtasks /delete требует имя без ведущего обратного слэша.
460
+ const fullName = taskFullName(name).replace(/^\\+/, "");
461
+ const args = ["/delete", "/tn", fullName, "/f"];
462
+ try {
463
+ await runSchtasks(args);
464
+ } catch (err: any) {
465
+ if (err instanceof SchtasksError) {
466
+ const text = `${err.message} ${err.stderr}`.toLowerCase();
467
+ const alreadyGone =
468
+ text.includes("cannot find") ||
469
+ text.includes("не удалось найти") ||
470
+ text.includes("не удается найти") ||
471
+ text.includes("не может найти") ||
472
+ text.includes("не найдено") ||
473
+ text.includes("the system cannot find the file specified") ||
474
+ text.includes("no tasks") ||
475
+ text.includes("could not find");
476
+ if (alreadyGone) return;
477
+ }
478
+ throw new SchtasksError(
479
+ `Не удалось удалить задачу "${name}"`,
480
+ err.code ?? null,
481
+ err.stderr ?? ""
482
+ );
483
+ }
484
+ }
485
+
486
+ /** Ставит задачу на паузу (/disable). */
487
+ async pauseTask(name: string): Promise<void> {
488
+ const fullName = taskFullName(name).replace(/^\\+/, "");
489
+ const args = ["/change", "/tn", fullName, "/disable"];
490
+ try {
491
+ await runSchtasks(args);
492
+ } catch (err: any) {
493
+ if (err instanceof SchtasksError) {
494
+ const text = `${err.message} ${err.stderr}`.toLowerCase();
495
+ const alreadyDisabled =
496
+ text.includes("disabled") || text.includes("запрещена");
497
+ if (alreadyDisabled) return;
498
+ }
499
+ throw new SchtasksError(
500
+ `Не удалось поставить задачу "${name}" на паузу`,
501
+ err.code ?? null,
502
+ err.stderr ?? ""
503
+ );
504
+ }
505
+ }
506
+
507
+ /** Снимает задачу с паузы (/enable). */
508
+ async resumeTask(name: string): Promise<void> {
509
+ const fullName = taskFullName(name).replace(/^\\+/, "");
510
+ const args = ["/change", "/tn", fullName, "/enable"];
511
+ try {
512
+ await runSchtasks(args);
513
+ } catch (err: any) {
514
+ if (err instanceof SchtasksError) {
515
+ const text = `${err.message} ${err.stderr}`.toLowerCase();
516
+ const alreadyEnabled =
517
+ text.includes("enabled") || text.includes("включена");
518
+ if (alreadyEnabled) return;
519
+ }
520
+ throw new SchtasksError(
521
+ `Не удалось снять задачу "${name}" с паузы`,
522
+ err.code ?? null,
523
+ err.stderr ?? ""
524
+ );
525
+ }
526
+ }
527
+
528
+ /**
529
+ * Проверяет, находится ли задача в состоянии Running.
530
+ * Ошибки запроса списка не должны ломать основной сценарий.
531
+ */
532
+ private async isTaskRunning(name: string): Promise<boolean> {
533
+ try {
534
+ const tasks = await this.listTasks();
535
+ const task = tasks.find(
536
+ (t) => (t.taskName ?? "").toLowerCase() === name.toLowerCase()
537
+ );
538
+ return /running|выполняется/i.test(task?.status ?? "");
539
+ } catch {
540
+ return false;
541
+ }
542
+ }
543
+
544
+ async runTask(name: string): Promise<RunTaskResult> {
545
+ const fullName = this.fullName(name);
546
+ const args = ["/run", "/tn", fullName];
547
+
548
+ // schtasks /run не требует смены кодировки — вызываем напрямую.
549
+ try {
550
+ await execFileAsync("schtasks", args, {
551
+ windowsHide: true,
552
+ encoding: "buffer",
553
+ maxBuffer: MAX_OUTPUT_BUFFER,
554
+ });
555
+ return { alreadyRunning: false };
556
+ } catch (err) {
557
+ const e = err as { message?: string; code?: number | null };
558
+ const stdout = await decodeConsoleOutput(errorBuffer(err, "stdout"));
559
+ const stderr = await decodeConsoleOutput(errorBuffer(err, "stderr"));
560
+ const errorDetails = buildErrorDetails(err, stdout, stderr);
561
+
562
+ const text = errorDetails.toLowerCase();
563
+ const saysAlreadyRunning =
564
+ text.includes("already running") ||
565
+ text.includes("уже выполняется") ||
566
+ text.includes("уже запущена");
567
+
568
+ if (saysAlreadyRunning || (await this.isTaskRunning(name))) {
569
+ return { alreadyRunning: true };
570
+ }
571
+
572
+ throw new SchtasksError(
573
+ `schtasks error: ${errorDetails}`,
574
+ e.code ?? null,
575
+ stderr
576
+ );
577
+ }
578
+ }
579
+ }
580
+
581
+ /** Определяет, что ошибка schtasks означает «задач не найдено». */
582
+ function isEmptyQueryResult(err: SchtasksError): boolean {
583
+ const text = `${err.message} ${err.stderr}`.toLowerCase();
584
+ return (
585
+ text.includes("cannot find") ||
586
+ text.includes("не удалось найти") ||
587
+ text.includes("не найдено") ||
588
+ text.includes("no tasks") ||
589
+ text.includes("не содержит задач")
590
+ );
591
+ }
592
+
593
+ /** Парсит вывод schtasks /query /fo LIST в массив ScheduledTaskInfo. */
594
+ function parseListOutput(output: string): ScheduledTaskInfo[] {
595
+ const tasks: ScheduledTaskInfo[] = [];
596
+ const blocks = output.split(/\n\s*\n/);
597
+
598
+ for (const block of blocks) {
599
+ const lines = block
600
+ .split(/\r?\n/)
601
+ .map((l) => l.trim())
602
+ .filter(Boolean);
603
+ if (lines.length === 0) continue;
604
+
605
+ const task: any = {};
606
+ let currentKey: string | null = null;
607
+ let currentValue: string[] = [];
608
+
609
+ for (const line of lines) {
610
+ const colonIndex = line.indexOf(":");
611
+ if (colonIndex === -1) {
612
+ if (currentKey) currentValue.push(line);
613
+ continue;
614
+ }
615
+
616
+ if (currentKey) {
617
+ setTaskField(task, currentKey, currentValue.join(" ").trim());
618
+ }
619
+
620
+ currentKey = line.slice(0, colonIndex).trim();
621
+ currentValue = [line.slice(colonIndex + 1).trim()];
622
+ }
623
+
624
+ if (currentKey) {
625
+ setTaskField(task, currentKey, currentValue.join(" ").trim());
626
+ }
627
+
628
+ tasks.push(task);
629
+ }
630
+
631
+ return tasks;
632
+ }
633
+
634
+ /** Сохраняет поле в объект задачи, преобразуя ключи schtasks в camelCase. */
635
+ function setTaskField(task: any, key: string, value: string): void {
636
+ const keyLower = key.toLowerCase();
637
+
638
+ const map: Record<string, string> = {
639
+ // English keys (US locale)
640
+ folder: "folder",
641
+ taskname: "taskName",
642
+ tasknametorun: "taskNameToRun",
643
+ nextruntime: "nextRunTime",
644
+ status: "status",
645
+ logonmode: "logonMode",
646
+ lastruntime: "lastRunTime",
647
+ lastresult: "lastResult",
648
+ author: "author",
649
+ tasktorun: "taskToRun",
650
+ comment: "comment",
651
+ // Russian keys (RU locale)
652
+ папка: "folder",
653
+ "имя задачи": "taskName",
654
+ "требуемое имя задачи": "taskNameToRun",
655
+ "следующее время запуска": "nextRunTime",
656
+ состояние: "status",
657
+ "режим входа": "logonMode",
658
+ // RU Windows 10/11 в /v печатает полную формулировку.
659
+ "режим входа в систему": "logonMode",
660
+ "последнее время запуска": "lastRunTime",
661
+ "последний результат": "lastResult",
662
+ автор: "author",
663
+ команда: "taskToRun",
664
+ комментарий: "comment",
665
+ // German (DE)
666
+ ordner: "folder",
667
+ aufgabenname: "taskName",
668
+ "nächste ausführungszeit": "nextRunTime",
669
+ "nächste laufzeit": "nextRunTime",
670
+ "anmeldemodus": "logonMode",
671
+ "letzte laufzeit": "lastRunTime",
672
+ "letztes ergebnis": "lastResult",
673
+ // French (FR)
674
+ dossier: "folder",
675
+ "nom de la tâche": "taskName",
676
+ "prochaine exécution": "nextRunTime",
677
+ état: "status",
678
+ statut: "status",
679
+ "mode d'ouverture de session": "logonMode",
680
+ "dernière exécution": "lastRunTime",
681
+ "dernier résultat": "lastResult",
682
+ // Spanish (ES)
683
+ carpeta: "folder",
684
+ "nombre de tarea": "taskName",
685
+ "próxima ejecución": "nextRunTime",
686
+ estado: "status",
687
+ "modo de inicio de sesión": "logonMode",
688
+ "última ejecución": "lastRunTime",
689
+ "último resultado": "lastResult",
690
+ // Italian (IT)
691
+ cartella: "folder",
692
+ "nome attività": "taskName",
693
+ "prossima esecuzione": "nextRunTime",
694
+ stato: "status",
695
+ "modalità di accesso": "logonMode",
696
+ "ultima esecuzione": "lastRunTime",
697
+ "ultimo risultato": "lastResult",
698
+ // Polish (PL)
699
+ "nazwa zadania": "taskName",
700
+ "następne uruchomienie": "nextRunTime",
701
+ stan: "status",
702
+ "tryb logowania": "logonMode",
703
+ "ostatnie uruchomienie": "lastRunTime",
704
+ "ostatni wynik": "lastResult",
705
+ };
706
+
707
+ const field = map[keyLower];
708
+ if (field) {
709
+ task[field] = value;
710
+ }
711
+ }