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,157 @@
1
+ /**
2
+ * Нативные уведомления ОС (Спринт 25).
3
+ *
4
+ * Windows — Toast через PowerShell/WinRT, macOS — Notification Center через
5
+ * osascript, Linux — notify-send (libnotify). Внешних зависимостей нет:
6
+ * node-notifier не требуется. Все ошибки проглатываются намеренно —
7
+ * уведомление не должно ломать задачу.
8
+ */
9
+ import { execFile } from "node:child_process";
10
+ import { promisify } from "node:util";
11
+
12
+ const execFileAsync = promisify(execFile);
13
+
14
+ /** Таймаут запуска процесса уведомления. */
15
+ const DEFAULT_TIMEOUT_MS = 15_000;
16
+
17
+ export interface NativeNotificationMessage {
18
+ /** Заголовок; по умолчанию «OpenCode Scheduler». */
19
+ title?: string;
20
+ /** Текст уведомления. */
21
+ body: string;
22
+ /** Со звуком, если платформа поддерживает. */
23
+ sound?: boolean;
24
+ }
25
+
26
+ /** Готовая команда запуска — удобно проверять в тестах. */
27
+ export interface NativeCommand {
28
+ command: string;
29
+ args: string[];
30
+ env?: Record<string, string>;
31
+ }
32
+
33
+ /** Скрипт Windows Toast: текст передаётся через env, чтобы не экранировать кавычки. */
34
+ const WINDOWS_TOAST_SCRIPT = `
35
+ $ErrorActionPreference = 'Stop'
36
+ $title = [System.Security.SecurityElement]::Escape($env:OCS_NOTIFY_TITLE)
37
+ $body = [System.Security.SecurityElement]::Escape($env:OCS_NOTIFY_BODY)
38
+ $silent = if ($env:OCS_NOTIFY_SOUND -eq '1') { '' } else { '<audio silent="true"/>' }
39
+ $xml = '<toast><visual><binding template="ToastGeneric"><text>' + $title + '</text><text>' + $body + '</text></binding></visual>' + $silent + '</toast>'
40
+ [Windows.UI.Notifications.ToastNotificationManager, Windows.UI.Notifications, ContentType=WindowsRuntime] > $null
41
+ [Windows.Data.Xml.Dom.XmlDocument, Windows.Data.Xml.Dom.XmlDocument, ContentType=WindowsRuntime] > $null
42
+ $doc = [Windows.Data.Xml.Dom.XmlDocument]::new()
43
+ $doc.LoadXml($xml)
44
+ $toast = [Windows.UI.Notifications.ToastNotification]::new($doc)
45
+ $appId = '{1AC14E77-02E7-4E5D-B744-2EB1AE5198B7}\\WindowsPowerShell\\v1.0\\powershell.exe'
46
+ [Windows.UI.Notifications.ToastNotificationManager]::CreateToastNotifier($appId).Show($toast)
47
+ `.trim();
48
+
49
+ /**
50
+ * Собирает команду нативного уведомления для платформы.
51
+ * Чистая функция: ничего не запускает.
52
+ */
53
+ export function buildNativeNotificationCommand(
54
+ platform: NodeJS.Platform,
55
+ message: NativeNotificationMessage
56
+ ): NativeCommand {
57
+ const title = (message.title ?? "OpenCode Scheduler").trim() || "OpenCode Scheduler";
58
+ const body = String(message.body ?? "");
59
+ const sound = message.sound !== false;
60
+
61
+ if (platform === "win32") {
62
+ return {
63
+ command: "powershell.exe",
64
+ args: [
65
+ "-NoProfile",
66
+ "-NonInteractive",
67
+ "-ExecutionPolicy",
68
+ "Bypass",
69
+ "-Command",
70
+ WINDOWS_TOAST_SCRIPT,
71
+ ],
72
+ env: {
73
+ OCS_NOTIFY_TITLE: title,
74
+ OCS_NOTIFY_BODY: body,
75
+ OCS_NOTIFY_SOUND: sound ? "1" : "0",
76
+ },
77
+ };
78
+ }
79
+
80
+ if (platform === "darwin") {
81
+ const script =
82
+ 'display notification (system attribute "OCS_NOTIFY_BODY") ' +
83
+ 'with title (system attribute "OCS_NOTIFY_TITLE")' +
84
+ (sound ? ' sound name "Glass"' : "");
85
+ return {
86
+ command: "osascript",
87
+ args: ["-e", script],
88
+ env: {
89
+ OCS_NOTIFY_TITLE: title,
90
+ OCS_NOTIFY_BODY: body,
91
+ },
92
+ };
93
+ }
94
+
95
+ return {
96
+ command: "notify-send",
97
+ args: [
98
+ "-a",
99
+ "OpenCode Scheduler",
100
+ "-u",
101
+ "normal",
102
+ "-i",
103
+ "dialog-information",
104
+ // `--` завершает разбор опций: текст уведомления может начинаться с "-"
105
+ // и без разделителя был бы принят за флаг notify-send.
106
+ "--",
107
+ title,
108
+ body,
109
+ ],
110
+ };
111
+ }
112
+
113
+ export interface SendNativeOptions {
114
+ /** Подмена платформы для тестов. */
115
+ platform?: NodeJS.Platform;
116
+ /** Подмена запуска процесса для тестов. */
117
+ exec?: (command: string, args: string[], env: NodeJS.ProcessEnv) => Promise<void>;
118
+ /** Таймаут процесса в мс. */
119
+ timeoutMs?: number;
120
+ }
121
+
122
+ export interface NativeSendResult {
123
+ success: boolean;
124
+ error?: string;
125
+ }
126
+
127
+ /**
128
+ * Показывает нативное уведомление. Никогда не бросает исключение.
129
+ */
130
+ export async function sendNativeNotification(
131
+ message: NativeNotificationMessage,
132
+ options: SendNativeOptions = {}
133
+ ): Promise<NativeSendResult> {
134
+ const platform = options.platform ?? process.platform;
135
+ const command = buildNativeNotificationCommand(platform, message);
136
+ const env = { ...process.env, ...(command.env ?? {}) };
137
+ const timeoutMs = Math.max(1_000, Math.floor(options.timeoutMs ?? DEFAULT_TIMEOUT_MS));
138
+
139
+ try {
140
+ if (options.exec) {
141
+ await options.exec(command.command, command.args, env);
142
+ } else {
143
+ await execFileAsync(command.command, command.args, {
144
+ env,
145
+ timeout: timeoutMs,
146
+ windowsHide: true,
147
+ maxBuffer: 1024 * 1024,
148
+ });
149
+ }
150
+ return { success: true };
151
+ } catch (err: any) {
152
+ return {
153
+ success: false,
154
+ error: err instanceof Error ? err.message : String(err),
155
+ };
156
+ }
157
+ }
@@ -0,0 +1,189 @@
1
+ /**
2
+ * One-shot расписание (Спринт 23).
3
+ *
4
+ * Задача с triggerType "once" выполняется ровно один раз в момент runAt.
5
+ * Абсолютное время хранится в ISO-8601 (UTC), а delaySeconds — удобный
6
+ * способ задать его относительно момента создания.
7
+ *
8
+ * Модуль намеренно не зависит от планировщика ОС: здесь только нормализация
9
+ * времени и преобразование в родные форматы Windows/Linux/macOS. Это
10
+ * позволяет тестировать one-shot без создания реальных задач.
11
+ */
12
+
13
+ /** Максимальная задержка — 5 лет. Защита от опечаток вроде 999999999. */
14
+ export const MAX_ONESHOT_DELAY_SECONDS = 5 * 365 * 24 * 60 * 60;
15
+
16
+ /** Минимальная задержка — 1 секунда. */
17
+ export const MIN_ONESHOT_DELAY_SECONDS = 1;
18
+
19
+ export interface OneShotInput {
20
+ /** Абсолютное время запуска (ISO-8601). */
21
+ runAt?: unknown;
22
+ /** Задержка от текущего момента в секундах. */
23
+ delaySeconds?: unknown;
24
+ }
25
+
26
+ export type OneShotNormalization =
27
+ | {
28
+ ok: true;
29
+ /** Нормализованное абсолютное время в ISO-8601 (UTC). */
30
+ runAt: string;
31
+ /** Исходная задержка, если она была задана. */
32
+ delaySeconds?: number;
33
+ }
34
+ | { ok: false; error: string };
35
+
36
+ function asDelaySeconds(value: unknown): number | undefined | "invalid" {
37
+ if (value === undefined || value === null || value === "") return undefined;
38
+ if (typeof value !== "number" || !Number.isFinite(value)) return "invalid";
39
+ const seconds = Math.floor(value);
40
+ if (seconds < MIN_ONESHOT_DELAY_SECONDS || seconds > MAX_ONESHOT_DELAY_SECONDS) {
41
+ return "invalid";
42
+ }
43
+ return seconds;
44
+ }
45
+
46
+ /**
47
+ * Приводит runAt/delaySeconds к абсолютному ISO-времени.
48
+ *
49
+ * Если заданы оба поля, приоритет у runAt: delaySeconds сохраняется только
50
+ * как исходная подсказка. Так импорт экспортированной задачи с обоими полями
51
+ * не меняет момент запуска.
52
+ */
53
+ export function normalizeOneShotRunAt(
54
+ input: OneShotInput,
55
+ nowMs: number = Date.now()
56
+ ): OneShotNormalization {
57
+ const rawRunAt =
58
+ typeof input.runAt === "string" ? input.runAt.trim() : undefined;
59
+ const delaySeconds = asDelaySeconds(input.delaySeconds);
60
+
61
+ if (delaySeconds === "invalid") {
62
+ return {
63
+ ok: false,
64
+ error:
65
+ `delaySeconds должен быть целым числом от ${MIN_ONESHOT_DELAY_SECONDS} ` +
66
+ `до ${MAX_ONESHOT_DELAY_SECONDS} секунд.`,
67
+ };
68
+ }
69
+
70
+ if (rawRunAt) {
71
+ const timestamp = Date.parse(rawRunAt);
72
+ if (!Number.isFinite(timestamp)) {
73
+ return {
74
+ ok: false,
75
+ error:
76
+ `runAt должен быть датой в формате ISO-8601, например ` +
77
+ `2026-12-01T09:00:00Z (получено «${rawRunAt}»).`,
78
+ };
79
+ }
80
+ if (timestamp <= nowMs) {
81
+ return {
82
+ ok: false,
83
+ error:
84
+ `runAt должен быть в будущем (получено «${rawRunAt}»). ` +
85
+ `Для запуска сразу используйте run_task_now.`,
86
+ };
87
+ }
88
+ return {
89
+ ok: true,
90
+ runAt: new Date(timestamp).toISOString(),
91
+ ...(delaySeconds !== undefined ? { delaySeconds } : {}),
92
+ };
93
+ }
94
+
95
+ if (delaySeconds !== undefined) {
96
+ return {
97
+ ok: true,
98
+ runAt: new Date(nowMs + delaySeconds * 1000).toISOString(),
99
+ delaySeconds,
100
+ };
101
+ }
102
+
103
+ return {
104
+ ok: false,
105
+ error:
106
+ "Для однократного запуска укажите runAt (ISO-8601) или delaySeconds.",
107
+ };
108
+ }
109
+
110
+ function pad(value: number): string {
111
+ return String(value).padStart(2, "0");
112
+ }
113
+
114
+ /**
115
+ * Формат даты/времени для schtasks /sd и /st.
116
+ *
117
+ * Windows Task Scheduler ожидает дату в формате текущей локали. Плагин уже
118
+ * использует DD.MM.YYYY для ONCE-заглушки, поэтому сохраняем этот формат
119
+ * для совместимости с русской локалью (основной сценарий проекта).
120
+ */
121
+ export function buildWindowsOneShotFlags(
122
+ runAt: string
123
+ ): ["/sc", "ONCE", "/sd", string, "/st", string] {
124
+ const date = new Date(runAt);
125
+ return [
126
+ "/sc",
127
+ "ONCE",
128
+ "/sd",
129
+ `${pad(date.getDate())}.${pad(date.getMonth() + 1)}.${date.getFullYear()}`,
130
+ "/st",
131
+ `${pad(date.getHours())}:${pad(date.getMinutes())}`,
132
+ ];
133
+ }
134
+
135
+ /** Формат `at -t`: YYYYMMDDHHMM в локальном времени системы. */
136
+ export function buildAtTimestamp(runAt: string): string {
137
+ const date = new Date(runAt);
138
+ return (
139
+ `${date.getFullYear()}` +
140
+ `${pad(date.getMonth() + 1)}` +
141
+ `${pad(date.getDate())}` +
142
+ `${pad(date.getHours())}` +
143
+ `${pad(date.getMinutes())}`
144
+ );
145
+ }
146
+
147
+ /**
148
+ * StartCalendarInterval для launchd. launchd не поддерживает год, поэтому
149
+ * плагин дополнительно выгружает plist после первого запуска (см. обёртку).
150
+ */
151
+ export function buildLaunchdCalendar(runAt: string): {
152
+ Month: number;
153
+ Day: number;
154
+ Hour: number;
155
+ Minute: number;
156
+ } {
157
+ const date = new Date(runAt);
158
+ return {
159
+ Month: date.getMonth() + 1,
160
+ Day: date.getDate(),
161
+ Hour: date.getHours(),
162
+ Minute: date.getMinutes(),
163
+ };
164
+ }
165
+
166
+ /** Команда самоочистки launchd-агента после единственного запуска. */
167
+ export function buildLaunchdOneShotCleanup(
168
+ sanitizedName: string,
169
+ profile: string = "default"
170
+ ): string {
171
+ const label = launchdLabel(sanitizedName, profile);
172
+ return (
173
+ `launchctl bootout "gui/$(id -u)" ` +
174
+ `"$HOME/Library/LaunchAgents/${label}.plist" ` +
175
+ `>/dev/null 2>&1 || true`
176
+ );
177
+ }
178
+
179
+ /**
180
+ * label launchd-агента задачи. Для default сохраняется историческое имя
181
+ * `com.opencode.scheduler.<name>`; у не-default профиля свой префикс, чтобы
182
+ * одноимённые задачи разных профилей не затирали plist друг друга.
183
+ */
184
+ export function launchdLabel(sanitizedName: string, profile: string = "default"): string {
185
+ const base = `com.opencode.scheduler.${sanitizedName}`;
186
+ if (profile === "default") return base;
187
+ const scope = profile.replace(/[^A-Za-z0-9_.-]/g, "-");
188
+ return `com.opencode.scheduler.profile-${scope}.${sanitizedName}`;
189
+ }
@@ -0,0 +1,128 @@
1
+ import crypto from "node:crypto";
2
+ import { getPluginVersion } from "../version.js";
3
+ import { getProfileName } from "../profiles.js";
4
+ import { getSchedulerTitle } from "./scheduler/index.js";
5
+ import type { StoredHistoryRecord } from "../db/history-repo.js";
6
+
7
+ /**
8
+ * Экспорт истории в OpenTelemetry-совместимом виде (Спринт 22).
9
+ *
10
+ * Формат — OTLP/JSON (`resourceSpans` → `scopeSpans` → `spans`), который
11
+ * принимают Collector, Jaeger, Tempo и большинство бэкендов после
12
+ * `otlp`-приёмника. Один запуск = один span.
13
+ *
14
+ * Идентификаторы детерминированы: sha256 от задачи, времени старта и id,
15
+ * поэтому повторный экспорт даёт стабильные traceId/spanId.
16
+ */
17
+
18
+ interface OtlpAttributeValue {
19
+ stringValue?: string;
20
+ intValue?: string;
21
+ doubleValue?: number;
22
+ boolValue?: boolean;
23
+ }
24
+
25
+ interface OtlpAttribute {
26
+ key: string;
27
+ value: OtlpAttributeValue;
28
+ }
29
+
30
+ function stringAttr(key: string, value: string | null | undefined): OtlpAttribute | null {
31
+ if (value == null || value === "") return null;
32
+ return { key, value: { stringValue: String(value) } };
33
+ }
34
+
35
+ function intAttr(key: string, value: number | null | undefined): OtlpAttribute | null {
36
+ if (typeof value !== "number" || !Number.isFinite(value)) return null;
37
+ return { key, value: { intValue: String(Math.trunc(value)) } };
38
+ }
39
+
40
+ function doubleAttr(key: string, value: number | null | undefined): OtlpAttribute | null {
41
+ if (typeof value !== "number" || !Number.isFinite(value)) return null;
42
+ return { key, value: { doubleValue: value } };
43
+ }
44
+
45
+ function compact(attrs: Array<OtlpAttribute | null>): OtlpAttribute[] {
46
+ return attrs.filter((attr): attr is OtlpAttribute => attr != null);
47
+ }
48
+
49
+ function toUnixNano(value: string | null | undefined): string | null {
50
+ if (!value) return null;
51
+ const ms = new Date(value).getTime();
52
+ if (!Number.isFinite(ms)) return null;
53
+ return (BigInt(Math.trunc(ms)) * 1000000n).toString();
54
+ }
55
+
56
+ function hashIds(record: StoredHistoryRecord): { traceId: string; spanId: string } {
57
+ const digest = crypto
58
+ .createHash("sha256")
59
+ .update(
60
+ `${record.taskName}|${record.startedAt}|${record.id ?? 0}`,
61
+ "utf8"
62
+ )
63
+ .digest("hex");
64
+ return { traceId: digest.slice(0, 32), spanId: digest.slice(32, 48) };
65
+ }
66
+
67
+ /** Строит OTLP/JSON-документ из записей истории. */
68
+ export function buildOtlpExport(records: StoredHistoryRecord[]): Record<string, unknown> {
69
+ const version = getPluginVersion();
70
+ const spans = records.map((record) => {
71
+ const { traceId, spanId } = hashIds(record);
72
+ const start = toUnixNano(record.startedAt) ?? "0";
73
+ const end = toUnixNano(record.finishedAt) ?? start;
74
+ const isRunning = record.status === "running";
75
+ const isError = !isRunning && record.status !== "success";
76
+ const attributes = compact([
77
+ stringAttr("task.name", record.taskName),
78
+ intAttr("run.id", record.id),
79
+ stringAttr("run.status", record.status),
80
+ intAttr("run.duration_ms", record.durationMs),
81
+ intAttr("run.tokens", record.tokens),
82
+ doubleAttr("run.cost_usd", record.costUsd),
83
+ stringAttr("llm.model", record.model),
84
+ stringAttr("error.message", record.error),
85
+ stringAttr("next.task", record.nextTask),
86
+ stringAttr("workspace.id", record.workspaceId),
87
+ stringAttr("pre_flight.status", record.preFlightStatus),
88
+ stringAttr("post_flight.status", record.postFlightStatus),
89
+ ]);
90
+ return {
91
+ traceId,
92
+ spanId,
93
+ name: `${record.taskName} run`,
94
+ kind: 1,
95
+ startTimeUnixNano: start,
96
+ endTimeUnixNano: end,
97
+ attributes,
98
+ status: {
99
+ code: isRunning ? 0 : isError ? 2 : 1,
100
+ ...(isError && record.error ? { message: String(record.error) } : {}),
101
+ },
102
+ };
103
+ });
104
+
105
+ return {
106
+ resourceSpans: [
107
+ {
108
+ resource: {
109
+ attributes: compact([
110
+ stringAttr("service.name", "opencode-windows-scheduler"),
111
+ stringAttr("service.version", version),
112
+ stringAttr("scheduler.profile", getProfileName()),
113
+ stringAttr("scheduler.backend", getSchedulerTitle()),
114
+ ]),
115
+ },
116
+ scopeSpans: [
117
+ {
118
+ scope: {
119
+ name: "opencode-windows-scheduler",
120
+ version,
121
+ },
122
+ spans,
123
+ },
124
+ ],
125
+ },
126
+ ],
127
+ };
128
+ }
@@ -0,0 +1,200 @@
1
+ /**
2
+ * Политика прав фоновых задач (Спринт 32 / релиз 1.6).
3
+ *
4
+ * OpenCode запускается с `--auto`, поэтому единственный барьер между
5
+ * автономной задачей и файловой системой/шеллом — сгенерированный
6
+ * OPENCODE_CONFIG_CONTENT. Здесь находится единый источник истины для
7
+ * PowerShell- и bash-обёрток, чтобы они не расходились в трактовке
8
+ * allowedTools/deniedTools.
9
+ *
10
+ * Важно: это политика на момент СОЗДАНИЯ/ОБНОВЛЕНИЯ задачи. Отдельный
11
+ * процесс обёртки не имеет доступа к SQLite, поэтому аудит фиксирует
12
+ * сгенерированную политику, а не попытки вызова инструментов.
13
+ */
14
+
15
+ /** Действия OpenCode v2, которые понимает permissions. */
16
+ export const PERMISSION_ACTIONS = [
17
+ "read",
18
+ "edit",
19
+ "glob",
20
+ "grep",
21
+ "shell",
22
+ "subagent",
23
+ "skill",
24
+ "question",
25
+ "webfetch",
26
+ "websearch",
27
+ ] as const;
28
+
29
+ export type PermissionAction = (typeof PERMISSION_ACTIONS)[number];
30
+
31
+ /** Имена инструментов, которые OpenCode отображает на действия. */
32
+ export const ACTION_ALIASES: Record<PermissionAction, readonly string[]> = {
33
+ read: ["read"],
34
+ edit: ["write", "edit", "apply_patch", "remove"],
35
+ glob: ["glob"],
36
+ grep: ["grep"],
37
+ shell: ["bash", "shell"],
38
+ subagent: ["subagent"],
39
+ skill: ["skill"],
40
+ question: ["question"],
41
+ webfetch: ["webfetch"],
42
+ websearch: ["websearch"],
43
+ };
44
+
45
+ export const PERMISSION_POLICIES = ["hybrid", "secure", "legacy"] as const;
46
+ export type PermissionPolicy = (typeof PERMISSION_POLICIES)[number];
47
+ export const DEFAULT_PERMISSION_POLICY: PermissionPolicy = "hybrid";
48
+
49
+ /** Базовые политики: какие действия разрешены без учёта списков задачи. */
50
+ const POLICY_BASE: Record<PermissionPolicy, readonly PermissionAction[]> = {
51
+ // Гибрид: агенту можно менять файлы, но не выполнять команды и не задавать
52
+ // вопросы (автономная задача всё равно некому на них ответить).
53
+ hybrid: ["read", "edit", "glob", "grep", "subagent", "skill", "webfetch", "websearch"],
54
+ // Строгий режим: только чтение и анализ исходников.
55
+ secure: ["read", "glob", "grep", "skill"],
56
+ // Прежнее поведение 1.5.x: разрешено всё.
57
+ legacy: [...PERMISSION_ACTIONS],
58
+ };
59
+
60
+ export interface PermissionInput {
61
+ /** Глобальная политика из SchedulerSettings.permissions.defaultPolicy. */
62
+ policy?: PermissionPolicy | string | null;
63
+ /** Переходный флаг задачи: вернуть shell в гибридной политике. */
64
+ legacyShell?: boolean;
65
+ /** Явный allowlist задачи (уже нормализованный или сырой). */
66
+ allowedTools?: readonly string[] | null;
67
+ /** Явный denylist задачи. */
68
+ deniedTools?: readonly string[] | null;
69
+ }
70
+
71
+ export interface EffectivePermission {
72
+ action: PermissionAction;
73
+ resource: "*";
74
+ effect: "allow" | "deny";
75
+ }
76
+
77
+ export interface DeniedByPolicy {
78
+ action: PermissionAction;
79
+ hint: string;
80
+ }
81
+
82
+ export interface EffectivePermissions {
83
+ policy: PermissionPolicy;
84
+ legacyShell: boolean;
85
+ permissions: EffectivePermission[];
86
+ /**
87
+ * Действия, запрещённые именно политикой по умолчанию (а не списками
88
+ * задачи). Используется для аудита и подсказок в логе.
89
+ */
90
+ deniedByPolicy: DeniedByPolicy[];
91
+ }
92
+
93
+ /** Приводит произвольное значение к известной политике. */
94
+ export function normalizePolicy(
95
+ value: unknown,
96
+ fallback: PermissionPolicy = DEFAULT_PERMISSION_POLICY
97
+ ): PermissionPolicy {
98
+ return typeof value === "string" &&
99
+ (PERMISSION_POLICIES as readonly string[]).includes(value)
100
+ ? (value as PermissionPolicy)
101
+ : fallback;
102
+ }
103
+
104
+ /** Нормализует список инструментов: trim, lower-case, без пустых и дублей. */
105
+ export function normalizeToolList(
106
+ value: readonly string[] | null | undefined
107
+ ): string[] {
108
+ return Array.from(
109
+ new Set(
110
+ (value ?? [])
111
+ .map((tool) => String(tool).trim().toLowerCase())
112
+ .filter(Boolean)
113
+ )
114
+ );
115
+ }
116
+
117
+ function actionsForTools(tools: Iterable<string>): Set<PermissionAction> {
118
+ const result = new Set<PermissionAction>();
119
+ for (const tool of tools) {
120
+ for (const action of PERMISSION_ACTIONS) {
121
+ if (ACTION_ALIASES[action].includes(tool)) result.add(action);
122
+ }
123
+ }
124
+ return result;
125
+ }
126
+
127
+ function hintFor(action: PermissionAction): string {
128
+ switch (action) {
129
+ case "shell":
130
+ return "shell запрещён политикой: добавьте shell в allowedTools задачи либо вынесите команду в qualityGate/afterScript.";
131
+ case "question":
132
+ return "question запрещён политикой: автономная задача не может ответить на вопрос; уберите интерактивный шаг или добавьте question в allowedTools.";
133
+ case "edit":
134
+ return "edit запрещён политикой secure: добавьте edit/write в allowedTools или выберите политику hybrid/legacy.";
135
+ default:
136
+ return `${action} запрещён политикой secure: добавьте ${action} в allowedTools или выберите политику hybrid/legacy.`;
137
+ }
138
+ }
139
+
140
+ /**
141
+ * Вычисляет эффективные права задачи.
142
+ *
143
+ * Порядок:
144
+ * 1. базовая политика (hybrid/secure/legacy), legacyShell возвращает shell;
145
+ * 2. deniedTools переводит действие в deny (выигрывает всегда);
146
+ * 3. непустой allowedTools превращается в allowlist и может явно вернуть
147
+ * действие, запрещённое политикой (кроме явно запрещённых deniedTools).
148
+ */
149
+ export function resolvePermissions(input: PermissionInput = {}): EffectivePermissions {
150
+ const policy = normalizePolicy(input.policy);
151
+ const legacyShell = input.legacyShell === true;
152
+ const allowed = actionsForTools(normalizeToolList(input.allowedTools));
153
+ const denied = actionsForTools(normalizeToolList(input.deniedTools));
154
+
155
+ const base = new Set<PermissionAction>(POLICY_BASE[policy]);
156
+ if (policy === "hybrid" && legacyShell) base.add("shell");
157
+
158
+ const permissions: EffectivePermission[] = PERMISSION_ACTIONS.map((action) => {
159
+ let effect: "allow" | "deny" = base.has(action) ? "allow" : "deny";
160
+ if (denied.has(action)) effect = "deny";
161
+ else if (allowed.size > 0) effect = allowed.has(action) ? "allow" : "deny";
162
+ return { action, resource: "*", effect };
163
+ });
164
+
165
+ const deniedByPolicy: DeniedByPolicy[] = [];
166
+ for (const entry of permissions) {
167
+ if (entry.effect !== "deny") continue;
168
+ if (denied.has(entry.action)) continue;
169
+ // Если список allowedTools непустой, запрет мог быть вызван им.
170
+ if (allowed.size > 0) continue;
171
+ deniedByPolicy.push({
172
+ action: entry.action,
173
+ hint: hintFor(entry.action),
174
+ });
175
+ }
176
+
177
+ return { policy, legacyShell, permissions, deniedByPolicy };
178
+ }
179
+
180
+ /** Готовый OPENCODE_CONFIG_CONTENT для обёрток. */
181
+ export function buildOpencodeConfig(input: PermissionInput = {}): string {
182
+ const effective = resolvePermissions(input);
183
+ return JSON.stringify(
184
+ {
185
+ $schema: "https://opencode.ai/config.json",
186
+ permissions: effective.permissions,
187
+ },
188
+ null,
189
+ 2
190
+ );
191
+ }
192
+
193
+ /** Краткое описание политики для лога задачи. */
194
+ export function formatPolicyLog(effective: EffectivePermissions): string {
195
+ const denied = effective.permissions
196
+ .filter((p) => p.effect === "deny")
197
+ .map((p) => p.action);
198
+ const legacyShell = effective.legacyShell ? ", legacyShell=true" : "";
199
+ return `policy=${effective.policy}${legacyShell}, denied=${denied.length > 0 ? denied.join(",") : "none"}`;
200
+ }