opencode-windows-scheduler 0.0.0-stage → 1.0.0

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 (172) hide show
  1. package/CHANGELOG.md +45 -0
  2. package/CROSS_PLATFORM.md +113 -0
  3. package/LICENSE +21 -0
  4. package/README.md +173 -2
  5. package/README.ru.md +131 -0
  6. package/ROADMAP-STRATEGY.md +217 -0
  7. package/ROADMAP.md +87 -0
  8. package/dist/core/cron-to-schtasks.d.ts +20 -0
  9. package/dist/core/cron-to-schtasks.d.ts.map +1 -0
  10. package/dist/core/cron-to-schtasks.js +233 -0
  11. package/dist/core/dry-run.d.ts +44 -0
  12. package/dist/core/dry-run.d.ts.map +1 -0
  13. package/dist/core/dry-run.js +252 -0
  14. package/dist/core/file-watcher.d.ts +31 -0
  15. package/dist/core/file-watcher.d.ts.map +1 -0
  16. package/dist/core/file-watcher.js +128 -0
  17. package/dist/core/lock.d.ts +43 -0
  18. package/dist/core/lock.d.ts.map +1 -0
  19. package/dist/core/lock.js +118 -0
  20. package/dist/core/matrix.d.ts +167 -0
  21. package/dist/core/matrix.d.ts.map +1 -0
  22. package/dist/core/matrix.js +687 -0
  23. package/dist/core/ps-wrapper.d.ts +60 -0
  24. package/dist/core/ps-wrapper.d.ts.map +1 -0
  25. package/dist/core/ps-wrapper.js +538 -0
  26. package/dist/core/record-history.d.ts +14 -0
  27. package/dist/core/record-history.d.ts.map +1 -0
  28. package/dist/core/record-history.js +360 -0
  29. package/dist/core/scheduler/index.d.ts +20 -0
  30. package/dist/core/scheduler/index.d.ts.map +1 -0
  31. package/dist/core/scheduler/index.js +32 -0
  32. package/dist/core/scheduler/linux.d.ts +32 -0
  33. package/dist/core/scheduler/linux.d.ts.map +1 -0
  34. package/dist/core/scheduler/linux.js +115 -0
  35. package/dist/core/scheduler/logs.d.ts +11 -0
  36. package/dist/core/scheduler/logs.d.ts.map +1 -0
  37. package/dist/core/scheduler/logs.js +34 -0
  38. package/dist/core/scheduler/mac.d.ts +39 -0
  39. package/dist/core/scheduler/mac.d.ts.map +1 -0
  40. package/dist/core/scheduler/mac.js +175 -0
  41. package/dist/core/scheduler/posix.d.ts +40 -0
  42. package/dist/core/scheduler/posix.d.ts.map +1 -0
  43. package/dist/core/scheduler/posix.js +86 -0
  44. package/dist/core/scheduler/registry.d.ts +36 -0
  45. package/dist/core/scheduler/registry.d.ts.map +1 -0
  46. package/dist/core/scheduler/registry.js +56 -0
  47. package/dist/core/scheduler/types.d.ts +63 -0
  48. package/dist/core/scheduler/types.d.ts.map +1 -0
  49. package/dist/core/scheduler/types.js +1 -0
  50. package/dist/core/scheduler/windows.d.ts +47 -0
  51. package/dist/core/scheduler/windows.d.ts.map +1 -0
  52. package/dist/core/scheduler/windows.js +375 -0
  53. package/dist/core/wrappers/bash.d.ts +58 -0
  54. package/dist/core/wrappers/bash.d.ts.map +1 -0
  55. package/dist/core/wrappers/bash.js +223 -0
  56. package/dist/db/history-repo.d.ts +69 -0
  57. package/dist/db/history-repo.d.ts.map +1 -0
  58. package/dist/db/history-repo.js +150 -0
  59. package/dist/db/index.d.ts +47 -0
  60. package/dist/db/index.d.ts.map +1 -0
  61. package/dist/db/index.js +120 -0
  62. package/dist/db/metrics-repo.d.ts +43 -0
  63. package/dist/db/metrics-repo.d.ts.map +1 -0
  64. package/dist/db/metrics-repo.js +95 -0
  65. package/dist/db/migrate.d.ts +24 -0
  66. package/dist/db/migrate.d.ts.map +1 -0
  67. package/dist/db/migrate.js +237 -0
  68. package/dist/db/recovery.d.ts +11 -0
  69. package/dist/db/recovery.d.ts.map +1 -0
  70. package/dist/db/recovery.js +38 -0
  71. package/dist/db/schema.d.ts +24 -0
  72. package/dist/db/schema.d.ts.map +1 -0
  73. package/dist/db/schema.js +97 -0
  74. package/dist/db/settings-repo.d.ts +8 -0
  75. package/dist/db/settings-repo.d.ts.map +1 -0
  76. package/dist/db/settings-repo.js +27 -0
  77. package/dist/db/tasks-repo.d.ts +26 -0
  78. package/dist/db/tasks-repo.d.ts.map +1 -0
  79. package/dist/db/tasks-repo.js +120 -0
  80. package/dist/db/templates-repo.d.ts +17 -0
  81. package/dist/db/templates-repo.d.ts.map +1 -0
  82. package/dist/db/templates-repo.js +57 -0
  83. package/dist/gui-experimental.cjs +1 -0
  84. package/dist/history.d.ts +53 -0
  85. package/dist/history.d.ts.map +1 -0
  86. package/dist/history.js +57 -0
  87. package/dist/index.d.ts +156 -0
  88. package/dist/index.d.ts.map +1 -0
  89. package/dist/index.js +2077 -0
  90. package/dist/notifications.d.ts +45 -0
  91. package/dist/notifications.d.ts.map +1 -0
  92. package/dist/notifications.js +135 -0
  93. package/dist/rpc.d.ts +2052 -0
  94. package/dist/rpc.d.ts.map +1 -0
  95. package/dist/rpc.js +863 -0
  96. package/dist/schtasks.d.ts +32 -0
  97. package/dist/schtasks.d.ts.map +1 -0
  98. package/dist/schtasks.js +45 -0
  99. package/dist/server.d.ts +106 -0
  100. package/dist/server.d.ts.map +1 -0
  101. package/dist/server.js +1478 -0
  102. package/dist/settings.d.ts +43 -0
  103. package/dist/settings.d.ts.map +1 -0
  104. package/dist/settings.js +96 -0
  105. package/dist/shared/jobs-view.d.ts +21 -0
  106. package/dist/shared/jobs-view.d.ts.map +1 -0
  107. package/dist/shared/jobs-view.js +28 -0
  108. package/dist/skill.d.ts +15 -0
  109. package/dist/skill.d.ts.map +1 -0
  110. package/dist/skill.js +93 -0
  111. package/dist/task-transfer.d.ts +176 -0
  112. package/dist/task-transfer.d.ts.map +1 -0
  113. package/dist/task-transfer.js +442 -0
  114. package/dist/templates.d.ts +57 -0
  115. package/dist/templates.d.ts.map +1 -0
  116. package/dist/templates.js +16 -0
  117. package/dist/types.d.ts +78 -0
  118. package/dist/types.d.ts.map +1 -0
  119. package/dist/types.js +88 -0
  120. package/dist/workspaces.d.ts +55 -0
  121. package/dist/workspaces.d.ts.map +1 -0
  122. package/dist/workspaces.js +183 -0
  123. package/docs/ARCHITECTURE.md +302 -0
  124. package/docs/FEATURES.md +288 -0
  125. package/docs/MIGRATION.md +266 -0
  126. package/docs/dashboard.png +0 -0
  127. package/gui-experimental.cjs +2 -0
  128. package/index.js +1 -0
  129. package/package.json +92 -4
  130. package/scripts/demo-dashboard.mjs +199 -0
  131. package/skills/scheduled-job-best-practices/SKILL.md +155 -0
  132. package/skills/scheduled-job-best-practices/references/recipes.md +123 -0
  133. package/src/core/cron-to-schtasks.ts +269 -0
  134. package/src/core/dry-run.ts +315 -0
  135. package/src/core/file-watcher.ts +171 -0
  136. package/src/core/lock.ts +134 -0
  137. package/src/core/matrix.ts +907 -0
  138. package/src/core/ps-wrapper.ts +572 -0
  139. package/src/core/record-history.ts +493 -0
  140. package/src/core/scheduler/index.ts +44 -0
  141. package/src/core/scheduler/linux.ts +125 -0
  142. package/src/core/scheduler/logs.ts +37 -0
  143. package/src/core/scheduler/mac.ts +222 -0
  144. package/src/core/scheduler/posix.ts +111 -0
  145. package/src/core/scheduler/registry.ts +93 -0
  146. package/src/core/scheduler/types.ts +67 -0
  147. package/src/core/scheduler/windows.ts +469 -0
  148. package/src/core/wrappers/bash.ts +282 -0
  149. package/src/db/history-repo.ts +303 -0
  150. package/src/db/index.ts +166 -0
  151. package/src/db/metrics-repo.ts +158 -0
  152. package/src/db/migrate.ts +322 -0
  153. package/src/db/recovery.ts +46 -0
  154. package/src/db/schema.ts +109 -0
  155. package/src/db/settings-repo.ts +31 -0
  156. package/src/db/tasks-repo.ts +162 -0
  157. package/src/db/templates-repo.ts +77 -0
  158. package/src/gui.tsx +2725 -0
  159. package/src/history.ts +107 -0
  160. package/src/index.ts +2672 -0
  161. package/src/notifications.ts +174 -0
  162. package/src/rpc.ts +933 -0
  163. package/src/schtasks.ts +75 -0
  164. package/src/server.ts +1663 -0
  165. package/src/settings.ts +157 -0
  166. package/src/shared/jobs-view.ts +38 -0
  167. package/src/skill.ts +113 -0
  168. package/src/task-transfer.ts +648 -0
  169. package/src/templates.ts +67 -0
  170. package/src/tui.tsx +46 -0
  171. package/src/types.ts +145 -0
  172. package/src/workspaces.ts +236 -0
@@ -0,0 +1,39 @@
1
+ import { PosixSchedulerBase } from "./posix.js";
2
+ import type { RegistryEntry } from "./registry.js";
3
+ /** Расписание launchd, полученное из cron-выражения. */
4
+ interface LaunchdSchedule {
5
+ /** StartInterval в секундах (для «каждые N минут»). */
6
+ interval?: number;
7
+ /** StartCalendarInterval (для фиксированного времени). */
8
+ calendar?: {
9
+ Minute?: number;
10
+ Hour?: number;
11
+ Weekday?: number;
12
+ };
13
+ }
14
+ /**
15
+ * Преобразует поддерживаемое 5-полевое cron-выражение в расписание launchd.
16
+ * Поддерживается то же подмножество, что и у Windows-бэкенда.
17
+ */
18
+ export declare function cronToLaunchdSchedule(cron: string): LaunchdSchedule;
19
+ /**
20
+ * Бэкенд планировщика macOS на основе launchd.
21
+ *
22
+ * Каждая задача — отдельный LaunchAgent:
23
+ * ~/Library/LaunchAgents/com.opencode.scheduler.<name>.plist
24
+ * Управление — через launchctl load/unload -w.
25
+ */
26
+ export declare class MacScheduler extends PosixSchedulerBase {
27
+ readonly platform: NodeJS.Platform;
28
+ readonly title = "OpenCode Scheduler";
29
+ constructor();
30
+ private label;
31
+ private plistPath;
32
+ /** Выполняет launchctl, не считая ошибку фатальной (unload несуществующего). */
33
+ private launchctl;
34
+ protected installEntry(entry: RegistryEntry): Promise<void>;
35
+ protected uninstallEntry(entry: RegistryEntry): Promise<void>;
36
+ protected applyPause(entry: RegistryEntry, paused: boolean): Promise<void>;
37
+ }
38
+ export {};
39
+ //# sourceMappingURL=mac.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"mac.d.ts","sourceRoot":"","sources":["../../../src/core/scheduler/mac.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAChD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAmBnD,wDAAwD;AACxD,UAAU,eAAe;IACvB,uDAAuD;IACvD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,0DAA0D;IAC1D,QAAQ,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CACjE;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,GAAG,eAAe,CAsDnE;AA2ED;;;;;;GAMG;AACH,qBAAa,YAAa,SAAQ,kBAAkB;IAClD,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC,QAAQ,CAAY;IAC9C,QAAQ,CAAC,KAAK,wBAAwB;;IAMtC,OAAO,CAAC,KAAK;IAIb,OAAO,CAAC,SAAS;IAIjB,gFAAgF;YAClE,SAAS;cAQP,YAAY,CAAC,KAAK,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC;cAQjD,cAAc,CAAC,KAAK,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC;cAMnD,UAAU,CAAC,KAAK,EAAE,aAAa,EAAE,MAAM,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;CAQjF"}
@@ -0,0 +1,175 @@
1
+ import { execFile } from "node:child_process";
2
+ import fs from "node:fs/promises";
3
+ import os from "node:os";
4
+ import path from "node:path";
5
+ import { promisify } from "node:util";
6
+ import { sanitizeName } from "../../types.js";
7
+ import { PosixSchedulerBase } from "./posix.js";
8
+ const execFileAsync = promisify(execFile);
9
+ /** Папка пользовательских LaunchAgents. */
10
+ const LAUNCH_AGENTS_DIR = path.join(os.homedir(), "Library", "LaunchAgents");
11
+ /** Префикс label/файлов плагина. */
12
+ const LABEL_PREFIX = "com.opencode.scheduler";
13
+ /** Экранирует текст для XML. */
14
+ function xmlEscape(value) {
15
+ return value
16
+ .replace(/&/g, "&amp;")
17
+ .replace(/</g, "&lt;")
18
+ .replace(/>/g, "&gt;")
19
+ .replace(/"/g, "&quot;");
20
+ }
21
+ /**
22
+ * Преобразует поддерживаемое 5-полевое cron-выражение в расписание launchd.
23
+ * Поддерживается то же подмножество, что и у Windows-бэкенда.
24
+ */
25
+ export function cronToLaunchdSchedule(cron) {
26
+ const fields = cron.trim().split(/\s+/);
27
+ if (fields.length !== 5) {
28
+ throw new Error(`Ожидалось 5 полей cron-выражения, получено ${fields.length}.`);
29
+ }
30
+ const [minute, hour, dayOfMonth, month, dayOfWeek] = fields;
31
+ const star = (v) => v === "*";
32
+ const intIn = (v, min, max) => {
33
+ if (!/^\d+$/.test(v))
34
+ return undefined;
35
+ const n = parseInt(v, 10);
36
+ return n >= min && n <= max ? n : undefined;
37
+ };
38
+ if (star(minute) && star(hour) && star(dayOfMonth) && star(month) && star(dayOfWeek)) {
39
+ return { interval: 60 };
40
+ }
41
+ const step = /^\*\/(\d+)$/.exec(minute);
42
+ if (step && star(hour) && star(dayOfMonth) && star(month) && star(dayOfWeek)) {
43
+ const n = parseInt(step[1], 10);
44
+ if (n > 0)
45
+ return { interval: n * 60 };
46
+ }
47
+ const m = intIn(minute, 0, 59);
48
+ const h = intIn(hour, 0, 23);
49
+ if (m === undefined) {
50
+ throw new Error("Неподдерживаемое cron-выражение для launchd.");
51
+ }
52
+ // M * * * * — каждый час в минуту M.
53
+ if (star(hour) && star(dayOfMonth) && star(month) && star(dayOfWeek)) {
54
+ return { calendar: { Minute: m } };
55
+ }
56
+ if (h === undefined || !star(dayOfMonth) || !star(month)) {
57
+ throw new Error("Неподдерживаемое cron-выражение для launchd.");
58
+ }
59
+ // M H * * * — ежедневно.
60
+ if (star(dayOfWeek)) {
61
+ return { calendar: { Minute: m, Hour: h } };
62
+ }
63
+ // M H * * D — еженедельно (0 и 7 — воскресенье).
64
+ const d = intIn(dayOfWeek, 0, 7);
65
+ if (d === undefined) {
66
+ throw new Error("Неподдерживаемое cron-выражение для launchd.");
67
+ }
68
+ return { calendar: { Minute: m, Hour: h, Weekday: d } };
69
+ }
70
+ /** Собирает XML plist для задачи. */
71
+ function buildPlist(label, entry) {
72
+ const schedule = entry.triggerType !== "cron"
73
+ ? { interval: 315360000 } // file/mcp-event: 10 лет — фактически «никогда».
74
+ : cronToLaunchdSchedule(entry.schedule);
75
+ const scheduleXml = [];
76
+ if (schedule.interval !== undefined) {
77
+ scheduleXml.push(" <key>StartInterval</key>", ` <integer>${schedule.interval}</integer>`);
78
+ }
79
+ if (schedule.calendar) {
80
+ scheduleXml.push(" <key>StartCalendarInterval</key>", " <dict>");
81
+ if (schedule.calendar.Minute !== undefined) {
82
+ scheduleXml.push(" <key>Minute</key>", ` <integer>${schedule.calendar.Minute}</integer>`);
83
+ }
84
+ if (schedule.calendar.Hour !== undefined) {
85
+ scheduleXml.push(" <key>Hour</key>", ` <integer>${schedule.calendar.Hour}</integer>`);
86
+ }
87
+ if (schedule.calendar.Weekday !== undefined) {
88
+ scheduleXml.push(" <key>Weekday</key>", ` <integer>${schedule.calendar.Weekday}</integer>`);
89
+ }
90
+ scheduleXml.push(" </dict>");
91
+ }
92
+ const workdir = entry.workingDirectory || process.cwd();
93
+ const log = entry.logFile;
94
+ const logXml = log
95
+ ? [
96
+ " <key>StandardOutPath</key>",
97
+ ` <string>${xmlEscape(log)}</string>`,
98
+ " <key>StandardErrorPath</key>",
99
+ ` <string>${xmlEscape(log)}</string>`,
100
+ ]
101
+ : [];
102
+ return [
103
+ '<?xml version="1.0" encoding="UTF-8"?>',
104
+ '<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" ' +
105
+ '"http://www.apple.com/DTDs/PropertyList-1.0.dtd">',
106
+ '<plist version="1.0">',
107
+ "<dict>",
108
+ " <key>Label</key>",
109
+ ` <string>${xmlEscape(label)}</string>`,
110
+ " <key>ProgramArguments</key>",
111
+ " <array>",
112
+ " <string>/bin/bash</string>",
113
+ ` <string>${xmlEscape(entry.command)}</string>`,
114
+ " </array>",
115
+ " <key>WorkingDirectory</key>",
116
+ ` <string>${xmlEscape(workdir)}</string>`,
117
+ ...logXml,
118
+ " <key>RunAtLoad</key>",
119
+ " <false/>",
120
+ ...scheduleXml,
121
+ "</dict>",
122
+ "</plist>",
123
+ "",
124
+ ].join("\n");
125
+ }
126
+ /**
127
+ * Бэкенд планировщика macOS на основе launchd.
128
+ *
129
+ * Каждая задача — отдельный LaunchAgent:
130
+ * ~/Library/LaunchAgents/com.opencode.scheduler.<name>.plist
131
+ * Управление — через launchctl load/unload -w.
132
+ */
133
+ export class MacScheduler extends PosixSchedulerBase {
134
+ constructor() {
135
+ super("mac");
136
+ this.platform = "darwin";
137
+ this.title = "OpenCode Scheduler";
138
+ }
139
+ label(name) {
140
+ return `${LABEL_PREFIX}.${sanitizeName(name)}`;
141
+ }
142
+ plistPath(name) {
143
+ return path.join(LAUNCH_AGENTS_DIR, `${this.label(name)}.plist`);
144
+ }
145
+ /** Выполняет launchctl, не считая ошибку фатальной (unload несуществующего). */
146
+ async launchctl(args) {
147
+ try {
148
+ await execFileAsync("launchctl", args, { maxBuffer: 1024 * 1024 });
149
+ }
150
+ catch {
151
+ // launchctl возвращает ошибку, если агент ещё не загружен — это нормально.
152
+ }
153
+ }
154
+ async installEntry(entry) {
155
+ await fs.mkdir(LAUNCH_AGENTS_DIR, { recursive: true });
156
+ const plistPath = this.plistPath(entry.name);
157
+ await this.launchctl(["unload", plistPath]);
158
+ await fs.writeFile(plistPath, buildPlist(this.label(entry.name), entry), "utf8");
159
+ await this.launchctl(["load", "-w", plistPath]);
160
+ }
161
+ async uninstallEntry(entry) {
162
+ const plistPath = this.plistPath(entry.name);
163
+ await this.launchctl(["unload", "-w", plistPath]);
164
+ await fs.unlink(plistPath).catch(() => { });
165
+ }
166
+ async applyPause(entry, paused) {
167
+ const plistPath = this.plistPath(entry.name);
168
+ if (paused) {
169
+ await this.launchctl(["unload", "-w", plistPath]);
170
+ }
171
+ else {
172
+ await this.launchctl(["load", "-w", plistPath]);
173
+ }
174
+ }
175
+ }
@@ -0,0 +1,40 @@
1
+ import type { ScheduledTaskInfo } from "../../types.js";
2
+ import { TaskRegistry, type RegistryEntry } from "./registry.js";
3
+ import type { CreateTaskOptions, RunTaskResult, SchedulerBackend } from "./types.js";
4
+ /**
5
+ * Общая база для LinuxScheduler и MacScheduler.
6
+ *
7
+ * Инкапсулирует всё, что одинаково на POSIX: реестр задач, немедленный запуск
8
+ * bash-обёртки detached-процессом, список задач и удаление.
9
+ * Различия (crontab vs launchd) реализуют наследники через installEntry,
10
+ * uninstallEntry и applyPause.
11
+ */
12
+ export declare abstract class PosixSchedulerBase implements SchedulerBackend {
13
+ abstract readonly platform: NodeJS.Platform;
14
+ abstract readonly title: string;
15
+ protected readonly registry: TaskRegistry;
16
+ constructor(backendId: string);
17
+ /** Регистрирует запись в планировщике ОС (crontab-строка или plist). */
18
+ protected abstract installEntry(entry: RegistryEntry): Promise<void>;
19
+ /** Убирает запись из планировщика ОС. */
20
+ protected abstract uninstallEntry(entry: RegistryEntry): Promise<void>;
21
+ /** Применяет состояние паузы к записи в планировщике ОС. */
22
+ protected abstract applyPause(entry: RegistryEntry, paused: boolean): Promise<void>;
23
+ createTask(options: CreateTaskOptions): Promise<void>;
24
+ deleteTask(name: string): Promise<void>;
25
+ pauseTask(name: string): Promise<void>;
26
+ resumeTask(name: string): Promise<void>;
27
+ listTasks(): Promise<ScheduledTaskInfo[]>;
28
+ /**
29
+ * Запускает обёртку напрямую, минуя планировщик ОС. Это одинаково работает
30
+ * и для cron-, и для файловых задач. Сама обёртка отвечает за lock-файл,
31
+ * таймаут и запись истории.
32
+ */
33
+ runTask(name: string): Promise<RunTaskResult>;
34
+ }
35
+ /**
36
+ * Экранирует строку для безопасной вставки в POSIX shell
37
+ * (одинарные кавычки: ' -> '\'').
38
+ */
39
+ export declare function shellQuote(value: string): string;
40
+ //# sourceMappingURL=posix.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"posix.d.ts","sourceRoot":"","sources":["../../../src/core/scheduler/posix.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AACxD,OAAO,EAAE,YAAY,EAAE,KAAK,aAAa,EAAE,MAAM,eAAe,CAAC;AACjE,OAAO,KAAK,EACV,iBAAiB,EACjB,aAAa,EACb,gBAAgB,EACjB,MAAM,YAAY,CAAC;AAEpB;;;;;;;GAOG;AACH,8BAAsB,kBAAmB,YAAW,gBAAgB;IAClE,QAAQ,CAAC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC,QAAQ,CAAC;IAC5C,QAAQ,CAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IAEhC,SAAS,CAAC,QAAQ,CAAC,QAAQ,EAAE,YAAY,CAAC;gBAE9B,SAAS,EAAE,MAAM;IAI7B,wEAAwE;IACxE,SAAS,CAAC,QAAQ,CAAC,YAAY,CAAC,KAAK,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC;IACpE,yCAAyC;IACzC,SAAS,CAAC,QAAQ,CAAC,cAAc,CAAC,KAAK,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC;IACtE,4DAA4D;IAC5D,SAAS,CAAC,QAAQ,CAAC,UAAU,CAAC,KAAK,EAAE,aAAa,EAAE,MAAM,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IAE7E,UAAU,CAAC,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC;IAkBrD,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAQvC,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAOtC,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAOvC,SAAS,IAAI,OAAO,CAAC,iBAAiB,EAAE,CAAC;IAS/C;;;;OAIG;IACG,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC;CAapD;AAED;;;GAGG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAGhD"}
@@ -0,0 +1,86 @@
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) {
13
+ this.registry = new TaskRegistry(backendId);
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
+ paused: false,
24
+ createdAt: new Date().toISOString(),
25
+ ...(options.model ? { model: options.model } : {}),
26
+ ...(options.priority !== undefined ? { priority: options.priority } : {}),
27
+ };
28
+ await this.registry.upsert(entry);
29
+ await this.installEntry(entry);
30
+ }
31
+ async deleteTask(name) {
32
+ const entry = await this.registry.find(name);
33
+ await this.registry.remove(name);
34
+ if (entry) {
35
+ await this.uninstallEntry(entry);
36
+ }
37
+ }
38
+ async pauseTask(name) {
39
+ const entry = await this.registry.find(name);
40
+ if (!entry)
41
+ throw new Error(`Задача "${name}" не найдена.`);
42
+ await this.registry.setPaused(name, true);
43
+ await this.applyPause(entry, true);
44
+ }
45
+ async resumeTask(name) {
46
+ const entry = await this.registry.find(name);
47
+ if (!entry)
48
+ throw new Error(`Задача "${name}" не найдена.`);
49
+ await this.registry.setPaused(name, false);
50
+ await this.applyPause(entry, false);
51
+ }
52
+ async listTasks() {
53
+ const entries = await this.registry.load();
54
+ return entries.map((entry) => ({
55
+ taskName: entry.name,
56
+ status: entry.paused ? "Disabled" : "Ready",
57
+ paused: entry.paused,
58
+ }));
59
+ }
60
+ /**
61
+ * Запускает обёртку напрямую, минуя планировщик ОС. Это одинаково работает
62
+ * и для cron-, и для файловых задач. Сама обёртка отвечает за lock-файл,
63
+ * таймаут и запись истории.
64
+ */
65
+ async runTask(name) {
66
+ const entry = await this.registry.find(name);
67
+ if (!entry)
68
+ throw new Error(`Задача "${name}" не найдена.`);
69
+ const child = spawn("/bin/bash", [entry.command], {
70
+ detached: true,
71
+ stdio: "ignore",
72
+ cwd: entry.workingDirectory || process.cwd(),
73
+ });
74
+ child.unref();
75
+ return { alreadyRunning: false };
76
+ }
77
+ }
78
+ /**
79
+ * Экранирует строку для безопасной вставки в POSIX shell
80
+ * (одинарные кавычки: ' -> '\'').
81
+ */
82
+ export function shellQuote(value) {
83
+ if (value === "")
84
+ return "''";
85
+ return `'${value.replace(/'/g, `'\\''`)}'`;
86
+ }
@@ -0,0 +1,36 @@
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
+ paused: boolean;
17
+ createdAt: string;
18
+ /** LLM-модель задачи (опционально). */
19
+ model?: string;
20
+ /** Приоритет задачи 0..10 (опционально). */
21
+ priority?: number;
22
+ }
23
+ /** Реестр задач конкретного бэкенда: PLUGIN_DIR/scheduler-<backend>.json. */
24
+ export declare class TaskRegistry {
25
+ private readonly file;
26
+ constructor(backendId: string);
27
+ /** Путь к файлу реестра (для диагностики). */
28
+ get path(): string;
29
+ load(): Promise<RegistryEntry[]>;
30
+ save(entries: RegistryEntry[]): Promise<void>;
31
+ find(name: string): Promise<RegistryEntry | undefined>;
32
+ upsert(entry: RegistryEntry): Promise<void>;
33
+ remove(name: string): Promise<void>;
34
+ setPaused(name: string, paused: boolean): Promise<void>;
35
+ }
36
+ //# 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,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,6EAA6E;AAC7E,qBAAa,YAAY;IACvB,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAS;gBAElB,SAAS,EAAE,MAAM;IAI7B,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,56 @@
1
+ import fs from "node:fs/promises";
2
+ import path from "node:path";
3
+ import { PLUGIN_DIR } from "../../types.js";
4
+ /** Реестр задач конкретного бэкенда: PLUGIN_DIR/scheduler-<backend>.json. */
5
+ export class TaskRegistry {
6
+ constructor(backendId) {
7
+ this.file = path.join(PLUGIN_DIR, `scheduler-${backendId}.json`);
8
+ }
9
+ /** Путь к файлу реестра (для диагностики). */
10
+ get path() {
11
+ return this.file;
12
+ }
13
+ async load() {
14
+ try {
15
+ const raw = await fs.readFile(this.file, "utf8");
16
+ const parsed = JSON.parse(raw);
17
+ if (!Array.isArray(parsed))
18
+ return [];
19
+ return parsed.filter((entry) => entry && typeof entry.name === "string" && typeof entry.command === "string");
20
+ }
21
+ catch {
22
+ return [];
23
+ }
24
+ }
25
+ async save(entries) {
26
+ await fs.mkdir(PLUGIN_DIR, { recursive: true });
27
+ const tmp = `${this.file}.tmp`;
28
+ await fs.writeFile(tmp, JSON.stringify(entries, null, 2), "utf8");
29
+ await fs.rename(tmp, this.file);
30
+ }
31
+ async find(name) {
32
+ const entries = await this.load();
33
+ return entries.find((e) => e.name.toLowerCase() === name.toLowerCase());
34
+ }
35
+ async upsert(entry) {
36
+ const entries = await this.load();
37
+ const index = entries.findIndex((e) => e.name.toLowerCase() === entry.name.toLowerCase());
38
+ if (index === -1)
39
+ entries.push(entry);
40
+ else
41
+ entries[index] = entry;
42
+ await this.save(entries);
43
+ }
44
+ async remove(name) {
45
+ const entries = await this.load();
46
+ await this.save(entries.filter((e) => e.name.toLowerCase() !== name.toLowerCase()));
47
+ }
48
+ async setPaused(name, paused) {
49
+ const entries = await this.load();
50
+ const entry = entries.find((e) => e.name.toLowerCase() === name.toLowerCase());
51
+ if (!entry)
52
+ return;
53
+ entry.paused = paused;
54
+ await this.save(entries);
55
+ }
56
+ }
@@ -0,0 +1,63 @@
1
+ import type { ScheduledTaskInfo } from "../../types.js";
2
+ /** Чем запускается задача. */
3
+ export type TriggerType = "cron" | "file" | "mcp-event";
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. */
18
+ schedule: string;
19
+ /** Таймаут выполнения в секундах (используется обёрткой). */
20
+ timeoutSeconds?: number;
21
+ /** "cron" (по умолчанию), "file" или "mcp-event". */
22
+ triggerType?: TriggerType;
23
+ /** Рабочая директория задачи (для POSIX-бэкендов попадает в cron/plist). */
24
+ workingDirectory?: string;
25
+ /** Путь к файлу лога (для POSIX-бэкендов — перенаправление вывода). */
26
+ logFile?: string;
27
+ /** LLM-модель задачи (хранится в реестре; используется обёрткой). */
28
+ model?: string;
29
+ /** Приоритет задачи 0..10 (хранится в реестре для диагностики). */
30
+ priority?: number;
31
+ }
32
+ /** Результат немедленного запуска. */
33
+ export interface RunTaskResult {
34
+ /** true — задача уже выполняется, повторный запуск не потребовался. */
35
+ alreadyRunning: boolean;
36
+ }
37
+ /**
38
+ * Абстрактный бэкенд планировщика ОС.
39
+ *
40
+ * Реализации:
41
+ * - WindowsScheduler — schtasks;
42
+ * - LinuxScheduler — crontab;
43
+ * - MacScheduler — launchd.
44
+ */
45
+ export interface SchedulerBackend {
46
+ /** Платформа Node.js, для которой предназначен бэкенд. */
47
+ readonly platform: NodeJS.Platform;
48
+ /** Человекочитаемое название планировщика (для GUI и логов). */
49
+ readonly title: string;
50
+ /** Создаёт (или пересоздаёт) задачу. */
51
+ createTask(options: CreateTaskOptions): Promise<void>;
52
+ /** Удаляет задачу. Повторное удаление не считается ошибкой. */
53
+ deleteTask(name: string): Promise<void>;
54
+ /** Запускает задачу немедленно. */
55
+ runTask(name: string): Promise<RunTaskResult>;
56
+ /** Возвращает список задач плагина (короткие имена). */
57
+ listTasks(): Promise<ScheduledTaskInfo[]>;
58
+ /** Ставит задачу на паузу (disable). */
59
+ pauseTask(name: string): Promise<void>;
60
+ /** Снимает задачу с паузы (enable). */
61
+ resumeTask(name: string): Promise<void>;
62
+ }
63
+ //# 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,WAAW,CAAC;AAExD;;;GAGG;AACH,MAAM,WAAW,iBAAiB;IAChC,sDAAsD;IACtD,IAAI,EAAE,MAAM,CAAC;IACb;;;;OAIG;IACH,OAAO,EAAE,MAAM,CAAC;IAChB,2EAA2E;IAC3E,QAAQ,EAAE,MAAM,CAAC;IACjB,6DAA6D;IAC7D,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,qDAAqD;IACrD,WAAW,CAAC,EAAE,WAAW,CAAC;IAC1B,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;CACnB;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,47 @@
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 = "\\OpenCode\\windows-scheduler\\";
5
+ /** Результат выполнения команды schtasks. */
6
+ export interface SchtasksResult {
7
+ stdout: string;
8
+ stderr: string;
9
+ code: number | null;
10
+ }
11
+ /** Ошибка выполнения schtasks. */
12
+ export declare class SchtasksError extends Error {
13
+ readonly code: number | null;
14
+ readonly stderr: string;
15
+ constructor(message: string, code: number | null, stderr: string);
16
+ }
17
+ /**
18
+ * Выполняет команду schtasks через cmd.exe с chcp 65001 (стабильные
19
+ * англоязычные ключи вывода) и windowsHide: true (без окон консоли).
20
+ */
21
+ export declare function runSchtasks(args: string[]): Promise<SchtasksResult>;
22
+ /** Формирует полное имя задачи с папкой плагина. */
23
+ export declare function taskFullName(name: string): string;
24
+ /**
25
+ * Бэкенд Планировщика заданий Windows (schtasks).
26
+ *
27
+ * Вся Windows-специфика (кодировка консоли, формат /tn, ONCE-заглушка для
28
+ * файловых триггеров) инкапсулирована здесь.
29
+ */
30
+ export declare class WindowsScheduler implements SchedulerBackend {
31
+ readonly platform: NodeJS.Platform;
32
+ readonly title = "\u041F\u043B\u0430\u043D\u0438\u0440\u043E\u0432\u0449\u0438\u043A Windows";
33
+ createTask(options: CreateTaskOptions): Promise<void>;
34
+ listTasks(): Promise<ScheduledTaskInfo[]>;
35
+ deleteTask(name: string): Promise<void>;
36
+ /** Ставит задачу на паузу (/disable). */
37
+ pauseTask(name: string): Promise<void>;
38
+ /** Снимает задачу с паузы (/enable). */
39
+ resumeTask(name: string): Promise<void>;
40
+ /**
41
+ * Проверяет, находится ли задача в состоянии Running.
42
+ * Ошибки запроса списка не должны ломать основной сценарий.
43
+ */
44
+ private isTaskRunning;
45
+ runTask(name: string): Promise<RunTaskResult>;
46
+ }
47
+ //# 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;AAGxD,OAAO,KAAK,EACV,iBAAiB,EACjB,aAAa,EACb,gBAAgB,EACjB,MAAM,YAAY,CAAC;AAOpB,kEAAkE;AAClE,eAAO,MAAM,mBAAmB,oCAA4C,CAAC;AA2C7E,6CAA6C;AAC7C,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;CACrB;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;CAKjC;AAED;;;GAGG;AACH,wBAAsB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,cAAc,CAAC,CAuBzE;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;IAEjC,UAAU,CAAC,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC;IAsErD,SAAS,IAAI,OAAO,CAAC,iBAAiB,EAAE,CAAC;IAgDzC,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IA0B7C,yCAAyC;IACnC,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAuB5C,wCAAwC;IAClC,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAuB7C;;;OAGG;YACW,aAAa;IAYrB,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC;CAoCpD"}