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,89 @@
1
+ import { spawn } from "node:child_process";
2
+ import { TaskRegistry } from "./registry.js";
3
+ /**
4
+ * Общая база для LinuxScheduler и MacScheduler.
5
+ *
6
+ * Инкапсулирует всё, что одинаково на POSIX: реестр задач, немедленный запуск
7
+ * bash-обёртки detached-процессом, список задач и удаление.
8
+ * Различия (crontab vs launchd) реализуют наследники через installEntry,
9
+ * uninstallEntry и applyPause.
10
+ */
11
+ export class PosixSchedulerBase {
12
+ constructor(backendId, profile) {
13
+ this.registry = new TaskRegistry(backendId, profile);
14
+ }
15
+ async createTask(options) {
16
+ const entry = {
17
+ name: options.name,
18
+ schedule: options.schedule,
19
+ command: options.command,
20
+ logFile: options.logFile,
21
+ workingDirectory: options.workingDirectory,
22
+ triggerType: options.triggerType ?? "cron",
23
+ ...(options.runAt ? { runAt: options.runAt } : {}),
24
+ paused: false,
25
+ createdAt: new Date().toISOString(),
26
+ ...(options.model ? { model: options.model } : {}),
27
+ ...(options.priority !== undefined ? { priority: options.priority } : {}),
28
+ };
29
+ await this.registry.upsert(entry);
30
+ await this.installEntry(entry);
31
+ // installEntry может записать atJobId для Linux one-shot.
32
+ await this.registry.upsert(entry);
33
+ }
34
+ async deleteTask(name) {
35
+ const entry = await this.registry.find(name);
36
+ await this.registry.remove(name);
37
+ if (entry) {
38
+ await this.uninstallEntry(entry);
39
+ }
40
+ }
41
+ async pauseTask(name) {
42
+ const entry = await this.registry.find(name);
43
+ if (!entry)
44
+ throw new Error(`Задача "${name}" не найдена.`);
45
+ await this.registry.setPaused(name, true);
46
+ await this.applyPause(entry, true);
47
+ }
48
+ async resumeTask(name) {
49
+ const entry = await this.registry.find(name);
50
+ if (!entry)
51
+ throw new Error(`Задача "${name}" не найдена.`);
52
+ await this.registry.setPaused(name, false);
53
+ await this.applyPause(entry, false);
54
+ }
55
+ async listTasks() {
56
+ const entries = await this.registry.load();
57
+ return entries.map((entry) => ({
58
+ taskName: entry.name,
59
+ status: entry.paused ? "Disabled" : "Ready",
60
+ paused: entry.paused,
61
+ }));
62
+ }
63
+ /**
64
+ * Запускает обёртку напрямую, минуя планировщик ОС. Это одинаково работает
65
+ * и для cron-, и для файловых задач. Сама обёртка отвечает за lock-файл,
66
+ * таймаут и запись истории.
67
+ */
68
+ async runTask(name) {
69
+ const entry = await this.registry.find(name);
70
+ if (!entry)
71
+ throw new Error(`Задача "${name}" не найдена.`);
72
+ const child = spawn("/bin/bash", [entry.command], {
73
+ detached: true,
74
+ stdio: "ignore",
75
+ cwd: entry.workingDirectory || process.cwd(),
76
+ });
77
+ child.unref();
78
+ return { alreadyRunning: false };
79
+ }
80
+ }
81
+ /**
82
+ * Экранирует строку для безопасной вставки в POSIX shell
83
+ * (одинарные кавычки: ' -> '\'').
84
+ */
85
+ export function shellQuote(value) {
86
+ if (value === "")
87
+ return "''";
88
+ return `'${value.replace(/'/g, `'\\''`)}'`;
89
+ }
@@ -0,0 +1,41 @@
1
+ import type { TriggerType } from "./types.js";
2
+ /**
3
+ * Запись реестра задач POSIX-бэкендов.
4
+ *
5
+ * crontab и launchd не хранят исходный cron-текст в удобном виде, а для
6
+ * файловых триггеров вообще не создают расписание. Поэтому источником правды
7
+ * для Linux/macOS служит собственный JSON-реестр плагина.
8
+ */
9
+ export interface RegistryEntry {
10
+ name: string;
11
+ schedule: string;
12
+ command: string;
13
+ logFile?: string;
14
+ workingDirectory?: string;
15
+ triggerType: TriggerType;
16
+ /** Абсолютное время однократного запуска (ISO-8601, только для once). */
17
+ runAt?: string;
18
+ /** Идентификатор задания `at` на Linux (для отмены one-shot). */
19
+ atJobId?: string;
20
+ paused: boolean;
21
+ createdAt: string;
22
+ /** LLM-модель задачи (опционально). */
23
+ model?: string;
24
+ /** Приоритет задачи 0..10 (опционально). */
25
+ priority?: number;
26
+ }
27
+ /** Реестр задач конкретного бэкенда: <pluginDir>/scheduler-<backend>.json. */
28
+ export declare class TaskRegistry {
29
+ private readonly file;
30
+ private readonly dir;
31
+ constructor(backendId: string, profile?: string);
32
+ /** Путь к файлу реестра (для диагностики). */
33
+ get path(): string;
34
+ load(): Promise<RegistryEntry[]>;
35
+ save(entries: RegistryEntry[]): Promise<void>;
36
+ find(name: string): Promise<RegistryEntry | undefined>;
37
+ upsert(entry: RegistryEntry): Promise<void>;
38
+ remove(name: string): Promise<void>;
39
+ setPaused(name: string, paused: boolean): Promise<void>;
40
+ }
41
+ //# sourceMappingURL=registry.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../../src/core/scheduler/registry.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAE9C;;;;;;GAMG;AACH,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,WAAW,EAAE,WAAW,CAAC;IACzB,yEAAyE;IACzE,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,iEAAiE;IACjE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,OAAO,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,uCAAuC;IACvC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,4CAA4C;IAC5C,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,8EAA8E;AAC9E,qBAAa,YAAY;IACvB,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAS;IAC9B,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAS;gBAEjB,SAAS,EAAE,MAAM,EAAE,OAAO,GAAE,MAAyB;IAKjE,8CAA8C;IAC9C,IAAI,IAAI,IAAI,MAAM,CAEjB;IAEK,IAAI,IAAI,OAAO,CAAC,aAAa,EAAE,CAAC;IAchC,IAAI,CAAC,OAAO,EAAE,aAAa,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAO7C,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,GAAG,SAAS,CAAC;IAKtD,MAAM,CAAC,KAAK,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC;IAU3C,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAOnC,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;CAS9D"}
@@ -0,0 +1,57 @@
1
+ import fs from "node:fs/promises";
2
+ import path from "node:path";
3
+ import { getProfileDir, getProfileName } from "../../profiles.js";
4
+ /** Реестр задач конкретного бэкенда: <pluginDir>/scheduler-<backend>.json. */
5
+ export class TaskRegistry {
6
+ constructor(backendId, profile = getProfileName()) {
7
+ this.dir = getProfileDir(profile);
8
+ this.file = path.join(this.dir, `scheduler-${backendId}.json`);
9
+ }
10
+ /** Путь к файлу реестра (для диагностики). */
11
+ get path() {
12
+ return this.file;
13
+ }
14
+ async load() {
15
+ try {
16
+ const raw = await fs.readFile(this.file, "utf8");
17
+ const parsed = JSON.parse(raw);
18
+ if (!Array.isArray(parsed))
19
+ return [];
20
+ return parsed.filter((entry) => entry && typeof entry.name === "string" && typeof entry.command === "string");
21
+ }
22
+ catch {
23
+ return [];
24
+ }
25
+ }
26
+ async save(entries) {
27
+ await fs.mkdir(this.dir, { recursive: true });
28
+ const tmp = `${this.file}.tmp`;
29
+ await fs.writeFile(tmp, JSON.stringify(entries, null, 2), "utf8");
30
+ await fs.rename(tmp, this.file);
31
+ }
32
+ async find(name) {
33
+ const entries = await this.load();
34
+ return entries.find((e) => e.name.toLowerCase() === name.toLowerCase());
35
+ }
36
+ async upsert(entry) {
37
+ const entries = await this.load();
38
+ const index = entries.findIndex((e) => e.name.toLowerCase() === entry.name.toLowerCase());
39
+ if (index === -1)
40
+ entries.push(entry);
41
+ else
42
+ entries[index] = entry;
43
+ await this.save(entries);
44
+ }
45
+ async remove(name) {
46
+ const entries = await this.load();
47
+ await this.save(entries.filter((e) => e.name.toLowerCase() !== name.toLowerCase()));
48
+ }
49
+ async setPaused(name, paused) {
50
+ const entries = await this.load();
51
+ const entry = entries.find((e) => e.name.toLowerCase() === name.toLowerCase());
52
+ if (!entry)
53
+ return;
54
+ entry.paused = paused;
55
+ await this.save(entries);
56
+ }
57
+ }
@@ -0,0 +1,86 @@
1
+ import type { ScheduledTaskInfo } from "../../types.js";
2
+ /** Чем запускается задача. */
3
+ export type TriggerType = "cron" | "file" | "git" | "mcp-event" | "once";
4
+ /**
5
+ * Параметры создания задачи. Бэкенд сам решает, как преобразовать cron
6
+ * в родное расписание ОС и как зарегистрировать команду запуска.
7
+ */
8
+ export interface CreateTaskOptions {
9
+ /** Уникальное имя задачи (без папки планировщика). */
10
+ name: string;
11
+ /**
12
+ * Абсолютный путь к исполняемой обёртке:
13
+ * - Windows: .cmd, вызывающий PowerShell-обёртку;
14
+ * - Linux/macOS: .sh с вызовом `opencode run`.
15
+ */
16
+ command: string;
17
+ /** 5-полевое cron-выражение. Игнорируется при триггерах file/mcp-event/once. */
18
+ schedule: string;
19
+ /** Таймаут выполнения в секундах (используется обёрткой). */
20
+ timeoutSeconds?: number;
21
+ /** "cron" (по умолчанию), "file", "mcp-event" или "once". */
22
+ triggerType?: TriggerType;
23
+ /** Абсолютное время однократного запуска (ISO-8601, только для once). */
24
+ runAt?: string;
25
+ /** Рабочая директория задачи (для POSIX-бэкендов попадает в cron/plist). */
26
+ workingDirectory?: string;
27
+ /** Путь к файлу лога (для POSIX-бэкендов — перенаправление вывода). */
28
+ logFile?: string;
29
+ /** LLM-модель задачи (хранится в реестре; используется обёрткой). */
30
+ model?: string;
31
+ /** Приоритет задачи 0..10 (хранится в реестре для диагностики). */
32
+ priority?: number;
33
+ /** IANA-таймзона задачи (например, "Europe/Moscow"). undefined — системная. */
34
+ timezone?: string;
35
+ /** Окно запуска «не раньше» (HH:MM, 24ч). Парно с notAfter. */
36
+ notBefore?: string;
37
+ /** Окно запуска «не позже» (HH:MM, 24ч). Парно с notBefore. */
38
+ notAfter?: string;
39
+ /**
40
+ * Windows: запускать задачу и без входа пользователя (/ru SYSTEM).
41
+ * По умолчанию задача интерактивная — выполняется только при активном входе.
42
+ * На Linux/macOS не используется: cron и так работает без входа, launchd-агент — только при входе.
43
+ */
44
+ runWhenLoggedOff?: boolean;
45
+ /** Аргументы schedule-gate для обёртки (расширенный cron / окно). */
46
+ scheduleGate?: {
47
+ cron?: string;
48
+ tz?: string;
49
+ notBefore?: string;
50
+ notAfter?: string;
51
+ /** Путь к defer-файлу для переноса из окна (lock-файл + .defer). */
52
+ deferFile?: string;
53
+ };
54
+ }
55
+ /** Результат немедленного запуска. */
56
+ export interface RunTaskResult {
57
+ /** true — задача уже выполняется, повторный запуск не потребовался. */
58
+ alreadyRunning: boolean;
59
+ }
60
+ /**
61
+ * Абстрактный бэкенд планировщика ОС.
62
+ *
63
+ * Реализации:
64
+ * - WindowsScheduler — schtasks;
65
+ * - LinuxScheduler — crontab;
66
+ * - MacScheduler — launchd.
67
+ */
68
+ export interface SchedulerBackend {
69
+ /** Платформа Node.js, для которой предназначен бэкенд. */
70
+ readonly platform: NodeJS.Platform;
71
+ /** Человекочитаемое название планировщика (для GUI и логов). */
72
+ readonly title: string;
73
+ /** Создаёт (или пересоздаёт) задачу. */
74
+ createTask(options: CreateTaskOptions): Promise<void>;
75
+ /** Удаляет задачу. Повторное удаление не считается ошибкой. */
76
+ deleteTask(name: string): Promise<void>;
77
+ /** Запускает задачу немедленно. */
78
+ runTask(name: string): Promise<RunTaskResult>;
79
+ /** Возвращает список задач плагина (короткие имена). */
80
+ listTasks(): Promise<ScheduledTaskInfo[]>;
81
+ /** Ставит задачу на паузу (disable). */
82
+ pauseTask(name: string): Promise<void>;
83
+ /** Снимает задачу с паузы (enable). */
84
+ resumeTask(name: string): Promise<void>;
85
+ }
86
+ //# sourceMappingURL=types.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/core/scheduler/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAExD,8BAA8B;AAC9B,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,MAAM,GAAG,KAAK,GAAG,WAAW,GAAG,MAAM,CAAC;AAEzE;;;GAGG;AACH,MAAM,WAAW,iBAAiB;IAChC,sDAAsD;IACtD,IAAI,EAAE,MAAM,CAAC;IACb;;;;OAIG;IACH,OAAO,EAAE,MAAM,CAAC;IAChB,gFAAgF;IAChF,QAAQ,EAAE,MAAM,CAAC;IACjB,6DAA6D;IAC7D,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,6DAA6D;IAC7D,WAAW,CAAC,EAAE,WAAW,CAAC;IAC1B,yEAAyE;IACzE,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,4EAA4E;IAC5E,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,uEAAuE;IACvE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,qEAAqE;IACrE,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,mEAAmE;IACnE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,+EAA+E;IAC/E,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,+DAA+D;IAC/D,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,+DAA+D;IAC/D,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;;;OAIG;IACH,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,qEAAqE;IACrE,YAAY,CAAC,EAAE;QACb,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,EAAE,CAAC,EAAE,MAAM,CAAC;QACZ,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,oEAAoE;QACpE,SAAS,CAAC,EAAE,MAAM,CAAC;KACpB,CAAC;CACH;AAED,sCAAsC;AACtC,MAAM,WAAW,aAAa;IAC5B,uEAAuE;IACvE,cAAc,EAAE,OAAO,CAAC;CACzB;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,gBAAgB;IAC/B,0DAA0D;IAC1D,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC,QAAQ,CAAC;IACnC,gEAAgE;IAChE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IAEvB,wCAAwC;IACxC,UAAU,CAAC,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACtD,+DAA+D;IAC/D,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACxC,mCAAmC;IACnC,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC;IAC9C,wDAAwD;IACxD,SAAS,IAAI,OAAO,CAAC,iBAAiB,EAAE,CAAC,CAAC;IAC1C,wCAAwC;IACxC,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACvC,uCAAuC;IACvC,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACzC"}
@@ -0,0 +1 @@
1
+ export {};
@@ -0,0 +1,99 @@
1
+ import type { ScheduledTaskInfo } from "../../types.js";
2
+ import type { CreateTaskOptions, RunTaskResult, SchedulerBackend } from "./types.js";
3
+ /** Префикс папки задач плагина в Планировщике заданий Windows. */
4
+ export declare const WINDOWS_TASK_PREFIX: string;
5
+ /** Префикс папки задач конкретного профиля (для удаления неактивного профиля). */
6
+ export declare function windowsTaskPrefixForProfile(profile: string): string;
7
+ /** Полное имя задачи в папке конкретного профиля. */
8
+ export declare function taskFullNameForProfile(name: string, profile: string): string;
9
+ /**
10
+ * Определяет OEM-кодовую страницу системы из реестра Windows.
11
+ *
12
+ * schtasks.exe и другие консольные утилиты выводят текст в OEM-кодировке
13
+ * системы (CP866 на русской Windows, 850/852 на западноевропейской, 437 на
14
+ * английской и т.д.). Жёсткий фолбэк на cp866 ломает вывод на DE/FR/ES/IT/PL
15
+ * и других локалях: акцентные ключи (nächste Ausführung, última ejecución и т.д.)
16
+ * превращаются в кракозябры и не распознаются парсером.
17
+ *
18
+ * Фолбэк — cp866 (историческое поведение на русской Windows).
19
+ */
20
+ export declare function getOemCodePage(): Promise<number>;
21
+ /**
22
+ * Синхронная обёртка для начального определения OEMCP (используется внутри
23
+ * getOemCodePage для декодирования вывода reg query). Цифры кода страницы —
24
+ * ASCII, поэтому cp866/utf8 безопасны для этого шага.
25
+ */
26
+ export declare function decodeConsoleOutputSync(buf: Buffer | string | undefined | null): string;
27
+ /**
28
+ * Декодирует вывод консольных утилит Windows.
29
+ *
30
+ * `schtasks.exe` запускается напрямую, без `cmd.exe`, поэтому метасимволы
31
+ * в аргументах не исполняются. Вывод утилиты приходит в OEM-кодировке системы,
32
+ * из-за чего Node, читающий его как UTF-8, показывает «?????». Поэтому:
33
+ * если байты — валидный UTF-8, декодируем как UTF-8, иначе пробуем OEMCP
34
+ * системы (определяется из реестра Nls\CodePage), с фолбэком на cp866.
35
+ */
36
+ export declare function decodeConsoleOutput(buf: Buffer | string | undefined | null): Promise<string>;
37
+ /** Результат выполнения команды schtasks. */
38
+ export interface SchtasksResult {
39
+ stdout: string;
40
+ stderr: string;
41
+ code: number | null;
42
+ }
43
+ /**
44
+ * Поясняет известные коды и тексты ошибок schtasks.
45
+ *
46
+ * Возвращает `null`, если код/текст неизвестен: исходное сообщение в этом
47
+ * случае не меняется. schtasks часто возвращает общий код `1`, поэтому
48
+ * текстовая эвристика остаётся основным фолбэком.
49
+ */
50
+ export declare function explainSchtasksError(code: number | null, text: string): string | null;
51
+ /** Ошибка выполнения schtasks. */
52
+ export declare class SchtasksError extends Error {
53
+ readonly code: number | null;
54
+ readonly stderr: string;
55
+ constructor(message: string, code: number | null, stderr: string);
56
+ }
57
+ /**
58
+ * Выполняет `schtasks.exe` напрямую с массивом аргументов.
59
+ *
60
+ * Раньше команда собиралась в строку и запускалась через `cmd.exe /c`,
61
+ * из-за чего метасимволы (`&`, `|`, `"`) в имени задачи исполнялись
62
+ * оболочкой: можно было получить command injection и «фантомную» задачу.
63
+ * `execFile` передаёт каждый аргумент отдельно — оболочки в цепочке нет.
64
+ */
65
+ export declare function runSchtasks(args: string[]): Promise<SchtasksResult>;
66
+ /** Формирует полное имя задачи с папкой плагина. */
67
+ export declare function taskFullName(name: string): string;
68
+ /**
69
+ * Бэкенд Планировщика заданий Windows (schtasks).
70
+ *
71
+ * Вся Windows-специфика (кодировка консоли, формат /tn, ONCE-заглушка для
72
+ * файловых триггеров) инкапсулирована здесь.
73
+ */
74
+ export declare class WindowsScheduler implements SchedulerBackend {
75
+ readonly platform: NodeJS.Platform;
76
+ readonly title = "\u041F\u043B\u0430\u043D\u0438\u0440\u043E\u0432\u0449\u0438\u043A Windows";
77
+ /** Имя папки задач и её префикс — в пространстве имён своего профиля. */
78
+ private readonly taskFolderName;
79
+ private readonly taskPrefix;
80
+ constructor(profile?: string);
81
+ /** Полное имя задачи (\OpenCode\<профиль>\<name>) для этого бэкенда. */
82
+ private fullName;
83
+ /** Убирает папку профиля из полного имени задачи. */
84
+ private shortName;
85
+ createTask(options: CreateTaskOptions): Promise<void>;
86
+ listTasks(): Promise<ScheduledTaskInfo[]>;
87
+ deleteTask(name: string): Promise<void>;
88
+ /** Ставит задачу на паузу (/disable). */
89
+ pauseTask(name: string): Promise<void>;
90
+ /** Снимает задачу с паузы (/enable). */
91
+ resumeTask(name: string): Promise<void>;
92
+ /**
93
+ * Проверяет, находится ли задача в состоянии Running.
94
+ * Ошибки запроса списка не должны ломать основной сценарий.
95
+ */
96
+ private isTaskRunning;
97
+ runTask(name: string): Promise<RunTaskResult>;
98
+ }
99
+ //# sourceMappingURL=windows.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"windows.d.ts","sourceRoot":"","sources":["../../../src/core/scheduler/windows.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAMxD,OAAO,KAAK,EACV,iBAAiB,EACjB,aAAa,EACb,gBAAgB,EACjB,MAAM,YAAY,CAAC;AAOpB,kEAAkE;AAClE,eAAO,MAAM,mBAAmB,QAA4C,CAAC;AAE7E,kFAAkF;AAClF,wBAAgB,2BAA2B,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAEnE;AAED,qDAAqD;AACrD,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAG5E;AAQD;;;;;;;;;;GAUG;AACH,wBAAsB,cAAc,IAAI,OAAO,CAAC,MAAM,CAAC,CAoCtD;AAED;;;;GAIG;AACH,wBAAgB,uBAAuB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,GAAG,IAAI,GAAG,MAAM,CAWvF;AAED;;;;;;;;GAQG;AACH,wBAAsB,mBAAmB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,GAAG,IAAI,GAAG,OAAO,CAAC,MAAM,CAAC,CAgBlG;AAqBD,6CAA6C;AAC7C,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;CACrB;AAED;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAClC,IAAI,EAAE,MAAM,GAAG,IAAI,EACnB,IAAI,EAAE,MAAM,GACX,MAAM,GAAG,IAAI,CAgDf;AAED,kCAAkC;AAClC,qBAAa,aAAc,SAAQ,KAAK;aAGpB,IAAI,EAAE,MAAM,GAAG,IAAI;aACnB,MAAM,EAAE,MAAM;gBAF9B,OAAO,EAAE,MAAM,EACC,IAAI,EAAE,MAAM,GAAG,IAAI,EACnB,MAAM,EAAE,MAAM;CAMjC;AAED;;;;;;;GAOG;AACH,wBAAsB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,cAAc,CAAC,CAsBzE;AAED,oDAAoD;AACpD,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAKjD;AASD;;;;;GAKG;AACH,qBAAa,gBAAiB,YAAW,gBAAgB;IACvD,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC,QAAQ,CAAW;IAC7C,QAAQ,CAAC,KAAK,gFAAyB;IAEvC,yEAAyE;IACzE,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAS;IACxC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;gBAExB,OAAO,GAAE,MAAyB;IAK9C,wEAAwE;IACxE,OAAO,CAAC,QAAQ;IAIhB,qDAAqD;IACrD,OAAO,CAAC,SAAS;IAMX,UAAU,CAAC,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC;IA+FrD,SAAS,IAAI,OAAO,CAAC,iBAAiB,EAAE,CAAC;IAmDzC,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IA4B7C,yCAAyC;IACnC,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAoB5C,wCAAwC;IAClC,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAoB7C;;;OAGG;YACW,aAAa;IAYrB,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC;CAmCpD"}