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,375 @@
1
+ import { execFile } from "node:child_process";
2
+ import { promisify } from "node:util";
3
+ import iconv from "iconv-lite";
4
+ import { TASK_FOLDER, TASK_FOLDER_NAME } from "../../types.js";
5
+ import { buildScheduleFlags, convertCronToSchTasks } from "../cron-to-schtasks.js";
6
+ const execFileAsync = promisify(execFile);
7
+ /** Максимальный размер вывода schtasks (обычно хватает с большим запасом). */
8
+ const MAX_OUTPUT_BUFFER = 10 * 1024 * 1024;
9
+ /** Префикс папки задач плагина в Планировщике заданий Windows. */
10
+ export const WINDOWS_TASK_PREFIX = `\\${TASK_FOLDER}\\${TASK_FOLDER_NAME}\\`;
11
+ /**
12
+ * Декодирует вывод консольных утилит Windows.
13
+ *
14
+ * cmd.exe запускается с `chcp 65001`, поэтому штатный вывод — UTF-8.
15
+ * Но сам schtasks при ошибке (и при перенаправлении вывода) может отдать
16
+ * байты в OEM-кодировке русской Windows (CP866), из-за чего Node, читающий
17
+ * их как UTF-8, показывает «?????». Поэтому: если байты — валидный UTF-8,
18
+ * декодируем как UTF-8, иначе пробуем CP866.
19
+ */
20
+ function decodeConsoleOutput(buf) {
21
+ if (!buf)
22
+ return "";
23
+ if (typeof buf === "string")
24
+ return buf;
25
+ if (buf.length === 0)
26
+ return "";
27
+ const utf8 = buf.toString("utf8");
28
+ if (!utf8.includes("\uFFFD")) {
29
+ return utf8;
30
+ }
31
+ return iconv.decode(buf, "cp866");
32
+ }
33
+ /** Достаёт Buffer из ошибки execFile (при encoding: "buffer"). */
34
+ function errorBuffer(err, field) {
35
+ const value = err?.[field];
36
+ return Buffer.isBuffer(value) ? value : undefined;
37
+ }
38
+ /**
39
+ * Собирает читаемый текст ошибки.
40
+ *
41
+ * err.message от Node содержит stderr, уже декодированный как UTF-8,
42
+ * поэтому для русской Windows там остаются «кракозябры». Берём из message
43
+ * только первую строку (команду), а текст ошибки — из наших Buffer'ов.
44
+ */
45
+ function buildErrorDetails(err, stdout, stderr) {
46
+ const message = err?.message ?? "";
47
+ const commandLine = message.split(/\r?\n/)[0] ?? "";
48
+ return [...new Set([commandLine, stdout, stderr].filter(Boolean))].join(" | ");
49
+ }
50
+ /** Ошибка выполнения schtasks. */
51
+ export class SchtasksError extends Error {
52
+ constructor(message, code, stderr) {
53
+ super(message);
54
+ this.code = code;
55
+ this.stderr = stderr;
56
+ this.name = "SchtasksError";
57
+ }
58
+ }
59
+ /**
60
+ * Выполняет команду schtasks через cmd.exe с chcp 65001 (стабильные
61
+ * англоязычные ключи вывода) и windowsHide: true (без окон консоли).
62
+ */
63
+ export async function runSchtasks(args) {
64
+ try {
65
+ const command = ["chcp", "65001", ">nul", "&", "schtasks", ...args].join(" ");
66
+ const { stdout, stderr } = (await execFileAsync("cmd.exe", ["/c", command], {
67
+ windowsHide: true,
68
+ encoding: "buffer",
69
+ maxBuffer: MAX_OUTPUT_BUFFER,
70
+ }));
71
+ return {
72
+ stdout: decodeConsoleOutput(stdout),
73
+ stderr: decodeConsoleOutput(stderr),
74
+ code: 0,
75
+ };
76
+ }
77
+ catch (err) {
78
+ const e = err;
79
+ const stdout = decodeConsoleOutput(errorBuffer(err, "stdout"));
80
+ const stderr = decodeConsoleOutput(errorBuffer(err, "stderr"));
81
+ throw new SchtasksError(`schtasks error: ${buildErrorDetails(err, stdout, stderr)}`, e.code ?? null, stderr);
82
+ }
83
+ }
84
+ /** Формирует полное имя задачи с папкой плагина. */
85
+ export function taskFullName(name) {
86
+ if (name.startsWith(WINDOWS_TASK_PREFIX)) {
87
+ return name;
88
+ }
89
+ return WINDOWS_TASK_PREFIX + name;
90
+ }
91
+ /** Убирает папку плагина из полного имени задачи. */
92
+ function shortTaskName(fullName) {
93
+ return fullName.startsWith(WINDOWS_TASK_PREFIX)
94
+ ? fullName.slice(WINDOWS_TASK_PREFIX.length)
95
+ : fullName;
96
+ }
97
+ /**
98
+ * Бэкенд Планировщика заданий Windows (schtasks).
99
+ *
100
+ * Вся Windows-специфика (кодировка консоли, формат /tn, ONCE-заглушка для
101
+ * файловых триггеров) инкапсулирована здесь.
102
+ */
103
+ export class WindowsScheduler {
104
+ constructor() {
105
+ this.platform = "win32";
106
+ this.title = "Планировщик Windows";
107
+ }
108
+ async createTask(options) {
109
+ const { name, command, schedule, triggerType } = options;
110
+ let scheduleFlags;
111
+ if (triggerType && triggerType !== "cron") {
112
+ // Файловый или MCP-триггер: однократный запуск в далёком будущем.
113
+ // Активация — только вручную (runTask / файловый watcher / emit_event).
114
+ scheduleFlags = ["/sc", "ONCE", "/sd", "31.12.2099", "/st", "00:00"];
115
+ }
116
+ else {
117
+ scheduleFlags = buildScheduleFlags(convertCronToSchTasks(schedule));
118
+ }
119
+ const fullName = taskFullName(name);
120
+ const args = [
121
+ "/create",
122
+ "/tn",
123
+ fullName,
124
+ "/tr",
125
+ `"${command}"`,
126
+ ...scheduleFlags,
127
+ "/f",
128
+ ];
129
+ console.log("[windows-scheduler] createTask args:", args);
130
+ let result;
131
+ try {
132
+ result = await runSchtasks(args);
133
+ }
134
+ catch (err) {
135
+ if (!(err instanceof SchtasksError))
136
+ throw err;
137
+ const text = `${err.stderr} ${err.message}`.toLowerCase();
138
+ const isRunning = text.includes("running") ||
139
+ text.includes("выполняется") ||
140
+ text.includes("запущена") ||
141
+ text.includes("busy") ||
142
+ text.includes("in use") ||
143
+ text.includes("используется");
144
+ if (isRunning) {
145
+ throw new SchtasksError(`Задача с именем "${name}" уже существует и выполняется. Дождитесь её завершения или удалите её.`, err.code, err.stderr);
146
+ }
147
+ const alreadyExists = text.includes("already exists") || text.includes("уже существует");
148
+ if (alreadyExists) {
149
+ throw new SchtasksError(`Задача с именем "${name}" уже существует. Используйте delete_task или выберите другое имя.`, err.code, err.stderr);
150
+ }
151
+ throw new SchtasksError(`Не удалось создать задачу "${name}": ${err.stderr || err.message || "неизвестная ошибка schtasks"}`, err.code, err.stderr);
152
+ }
153
+ if (result.code === 0)
154
+ return;
155
+ }
156
+ async listTasks() {
157
+ const args = ["/query", "/fo", "LIST"];
158
+ let result;
159
+ try {
160
+ result = await runSchtasks(args);
161
+ }
162
+ catch (err) {
163
+ if (err instanceof SchtasksError && isEmptyQueryResult(err)) {
164
+ return [];
165
+ }
166
+ throw err;
167
+ }
168
+ if (!result.stdout || !result.stdout.trim()) {
169
+ return [];
170
+ }
171
+ const allTasks = parseListOutput(result.stdout).filter((task) => Boolean(task.taskName));
172
+ const filtered = allTasks.filter((task) => (task.taskName || "").startsWith(WINDOWS_TASK_PREFIX));
173
+ // Fallback: если структурный парсер не распознал ключи (нестандартная
174
+ // локаль/кодировка), вытаскиваем имена задач по префиксу папки.
175
+ if (filtered.length === 0 && /windows-scheduler/i.test(result.stdout)) {
176
+ const names = new Set();
177
+ const re = /[\\/]?OpenCode[\\/]windows-scheduler[\\/]([^\r\n"']+)/gi;
178
+ let m;
179
+ while ((m = re.exec(result.stdout)) !== null) {
180
+ const nm = m[1].trim().replace(/[\s:]+$/, "");
181
+ if (nm)
182
+ names.add(nm);
183
+ }
184
+ if (names.size > 0) {
185
+ return Array.from(names).map((nm) => ({ taskName: nm }));
186
+ }
187
+ }
188
+ return filtered.map((task) => ({
189
+ ...task,
190
+ taskName: shortTaskName(task.taskName || ""),
191
+ paused: /disabled|отключ|запрещ/i.test(task.status ?? ""),
192
+ }));
193
+ }
194
+ async deleteTask(name) {
195
+ // schtasks /delete требует имя без ведущего обратного слэша.
196
+ const fullName = taskFullName(name).replace(/^\\+/, "");
197
+ const args = ["/delete", "/tn", fullName, "/f"];
198
+ try {
199
+ await runSchtasks(args);
200
+ }
201
+ catch (err) {
202
+ if (err instanceof SchtasksError) {
203
+ const text = `${err.message} ${err.stderr}`.toLowerCase();
204
+ const alreadyGone = text.includes("cannot find") ||
205
+ text.includes("не удалось найти") ||
206
+ text.includes("не найдено") ||
207
+ text.includes("the system cannot find the file specified") ||
208
+ text.includes("no tasks") ||
209
+ text.includes("could not find");
210
+ if (alreadyGone)
211
+ return;
212
+ }
213
+ throw new SchtasksError(`Не удалось удалить задачу "${name}"`, err.code ?? null, err.stderr ?? "");
214
+ }
215
+ }
216
+ /** Ставит задачу на паузу (/disable). */
217
+ async pauseTask(name) {
218
+ const fullName = taskFullName(name).replace(/^\\+/, "");
219
+ const args = ["/change", "/tn", fullName, "/disable"];
220
+ try {
221
+ await runSchtasks(args);
222
+ }
223
+ catch (err) {
224
+ if (err instanceof SchtasksError) {
225
+ const text = `${err.message} ${err.stderr}`.toLowerCase();
226
+ const alreadyDisabled = text.includes("disabled") ||
227
+ text.includes("запрещена") ||
228
+ text.includes("не удалось найти") ||
229
+ text.includes("cannot find");
230
+ if (alreadyDisabled)
231
+ return;
232
+ }
233
+ throw new SchtasksError(`Не удалось поставить задачу "${name}" на паузу`, err.code ?? null, err.stderr ?? "");
234
+ }
235
+ }
236
+ /** Снимает задачу с паузы (/enable). */
237
+ async resumeTask(name) {
238
+ const fullName = taskFullName(name).replace(/^\\+/, "");
239
+ const args = ["/change", "/tn", fullName, "/enable"];
240
+ try {
241
+ await runSchtasks(args);
242
+ }
243
+ catch (err) {
244
+ if (err instanceof SchtasksError) {
245
+ const text = `${err.message} ${err.stderr}`.toLowerCase();
246
+ const alreadyEnabled = text.includes("enabled") ||
247
+ text.includes("включена") ||
248
+ text.includes("не удалось найти") ||
249
+ text.includes("cannot find");
250
+ if (alreadyEnabled)
251
+ return;
252
+ }
253
+ throw new SchtasksError(`Не удалось снять задачу "${name}" с паузы`, err.code ?? null, err.stderr ?? "");
254
+ }
255
+ }
256
+ /**
257
+ * Проверяет, находится ли задача в состоянии Running.
258
+ * Ошибки запроса списка не должны ломать основной сценарий.
259
+ */
260
+ async isTaskRunning(name) {
261
+ try {
262
+ const tasks = await this.listTasks();
263
+ const task = tasks.find((t) => (t.taskName ?? "").toLowerCase() === name.toLowerCase());
264
+ return /running|выполняется/i.test(task?.status ?? "");
265
+ }
266
+ catch {
267
+ return false;
268
+ }
269
+ }
270
+ async runTask(name) {
271
+ const fullName = taskFullName(name);
272
+ const args = ["/run", "/tn", fullName];
273
+ console.log("[windows-scheduler] runTask args:", args);
274
+ // schtasks /run не требует смены кодировки — вызываем напрямую.
275
+ try {
276
+ await execFileAsync("schtasks", args, {
277
+ windowsHide: true,
278
+ encoding: "buffer",
279
+ maxBuffer: MAX_OUTPUT_BUFFER,
280
+ });
281
+ return { alreadyRunning: false };
282
+ }
283
+ catch (err) {
284
+ const e = err;
285
+ const stdout = decodeConsoleOutput(errorBuffer(err, "stdout"));
286
+ const stderr = decodeConsoleOutput(errorBuffer(err, "stderr"));
287
+ const errorDetails = buildErrorDetails(err, stdout, stderr);
288
+ const text = errorDetails.toLowerCase();
289
+ const saysAlreadyRunning = text.includes("already running") ||
290
+ text.includes("уже выполняется") ||
291
+ text.includes("уже запущена");
292
+ if (saysAlreadyRunning || (await this.isTaskRunning(name))) {
293
+ return { alreadyRunning: true };
294
+ }
295
+ throw new SchtasksError(`schtasks error: ${errorDetails}`, e.code ?? null, stderr);
296
+ }
297
+ }
298
+ }
299
+ /** Определяет, что ошибка schtasks означает «задач не найдено». */
300
+ function isEmptyQueryResult(err) {
301
+ const text = `${err.message} ${err.stderr}`.toLowerCase();
302
+ return (err.code === 1 ||
303
+ text.includes("cannot find") ||
304
+ text.includes("не удалось найти") ||
305
+ text.includes("не найдено") ||
306
+ text.includes("no tasks"));
307
+ }
308
+ /** Парсит вывод schtasks /query /fo LIST в массив ScheduledTaskInfo. */
309
+ function parseListOutput(output) {
310
+ const tasks = [];
311
+ const blocks = output.split(/\n\s*\n/);
312
+ for (const block of blocks) {
313
+ const lines = block
314
+ .split(/\r?\n/)
315
+ .map((l) => l.trim())
316
+ .filter(Boolean);
317
+ if (lines.length === 0)
318
+ continue;
319
+ const task = {};
320
+ let currentKey = null;
321
+ let currentValue = [];
322
+ for (const line of lines) {
323
+ const colonIndex = line.indexOf(":");
324
+ if (colonIndex === -1) {
325
+ if (currentKey)
326
+ currentValue.push(line);
327
+ continue;
328
+ }
329
+ if (currentKey) {
330
+ setTaskField(task, currentKey, currentValue.join(" ").trim());
331
+ }
332
+ currentKey = line.slice(0, colonIndex).trim();
333
+ currentValue = [line.slice(colonIndex + 1).trim()];
334
+ }
335
+ if (currentKey) {
336
+ setTaskField(task, currentKey, currentValue.join(" ").trim());
337
+ }
338
+ tasks.push(task);
339
+ }
340
+ return tasks;
341
+ }
342
+ /** Сохраняет поле в объект задачи, преобразуя ключи schtasks в camelCase. */
343
+ function setTaskField(task, key, value) {
344
+ const keyLower = key.toLowerCase();
345
+ const map = {
346
+ // English keys (US locale)
347
+ folder: "folder",
348
+ taskname: "taskName",
349
+ tasknametorun: "taskNameToRun",
350
+ nextruntime: "nextRunTime",
351
+ status: "status",
352
+ logonmode: "logonMode",
353
+ lastruntime: "lastRunTime",
354
+ lastresult: "lastResult",
355
+ author: "author",
356
+ tasktorun: "taskToRun",
357
+ comment: "comment",
358
+ // Russian keys (RU locale)
359
+ папка: "folder",
360
+ "имя задачи": "taskName",
361
+ "требуемое имя задачи": "taskNameToRun",
362
+ "следующее время запуска": "nextRunTime",
363
+ состояние: "status",
364
+ "режим входа": "logonMode",
365
+ "последнее время запуска": "lastRunTime",
366
+ "последний результат": "lastResult",
367
+ автор: "author",
368
+ команда: "taskToRun",
369
+ комментарий: "comment",
370
+ };
371
+ const field = map[keyLower];
372
+ if (field) {
373
+ task[field] = value;
374
+ }
375
+ }
@@ -0,0 +1,58 @@
1
+ /** Параметры генерации bash-обёртки. */
2
+ export interface BashWrapperOptions {
3
+ /** Безопасное имя для файла (латиница, цифры, -, _). */
4
+ sanitizedName: string;
5
+ /** Отображаемое имя задачи (может быть кириллицей). */
6
+ taskName: string;
7
+ /** Абсолютный путь к файлу с промптом. */
8
+ promptFile: string;
9
+ /** Таймаут в секундах (0 — без таймаута). */
10
+ timeoutSeconds: number;
11
+ /** Абсолютный путь к lock-файлу (рядом создаётся каталог <lock>.d). */
12
+ lockFile: string;
13
+ /** Рабочая директория задачи. */
14
+ workdir?: string;
15
+ /** Имя multi-repo workspace (для git-контекста в логе). */
16
+ workspaceName?: string;
17
+ /** Разрешённые инструменты (спринт 14, metadata-only). */
18
+ allowedTools?: string[];
19
+ /** Запрещённые инструменты (спринт 14, metadata-only). */
20
+ deniedTools?: string[];
21
+ /** Путь к файлу лога. */
22
+ logFile?: string;
23
+ /** Путь к скомпилированному record-history.js. */
24
+ recorderFile?: string;
25
+ /** Проверочная команда Quality Gate. */
26
+ qualityGate?: string;
27
+ /** LLM-модель для `opencode run --model` (если не задана — модель по умолчанию). */
28
+ model?: string;
29
+ /** Pre-flight команда: ненулевой код отменяет запуск задачи. */
30
+ beforeScript?: string;
31
+ /** Post-flight команда: выполняется даже при ошибке основной задачи. */
32
+ afterScript?: string;
33
+ }
34
+ /**
35
+ * Собирает текст bash-обёртки.
36
+ *
37
+ * Скрипт:
38
+ * 1. выставляет PATH (важно для cron, где окружение минимальное);
39
+ * 2. берёт атомарный lock через `mkdir` (аналог 'wx' в Node);
40
+ * 3. переходит в рабочую директорию проекта;
41
+ * 4. выполняет pre-flight (если задан) — при ошибке задача отменяется;
42
+ * 5. запускает `opencode run <промпт>` с перенаправлением вывода в лог;
43
+ * 6. по таймауту завершает процесс;
44
+ * 7. выполняет Quality Gate (если задан);
45
+ * 8. выполняет post-flight (если задан) — даже при ошибке задачи;
46
+ * 9. пишет историю/метрики через `node record-history.js`.
47
+ *
48
+ * Если задана модель, вызов превращается в `opencode run --model "<model>" <промпт>`.
49
+ */
50
+ export declare function buildBashWrapperScript(options: BashWrapperOptions): string;
51
+ /**
52
+ * Записывает per-task bash-обёртку и делает её исполняемой.
53
+ * Возвращает абсолютный путь к .sh-файлу.
54
+ */
55
+ export declare function writeBashWrapper(options: BashWrapperOptions): Promise<string>;
56
+ /** Путь к bash-обёртке задачи (для диагностики/тестов). */
57
+ export declare function bashWrapperPath(sanitizedName: string): string;
58
+ //# sourceMappingURL=bash.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"bash.d.ts","sourceRoot":"","sources":["../../../src/core/wrappers/bash.ts"],"names":[],"mappings":"AAKA,wCAAwC;AACxC,MAAM,WAAW,kBAAkB;IACjC,wDAAwD;IACxD,aAAa,EAAE,MAAM,CAAC;IACtB,uDAAuD;IACvD,QAAQ,EAAE,MAAM,CAAC;IACjB,0CAA0C;IAC1C,UAAU,EAAE,MAAM,CAAC;IACnB,6CAA6C;IAC7C,cAAc,EAAE,MAAM,CAAC;IACvB,uEAAuE;IACvE,QAAQ,EAAE,MAAM,CAAC;IACjB,iCAAiC;IACjC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,2DAA2D;IAC3D,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,0DAA0D;IAC1D,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,0DAA0D;IAC1D,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB,yBAAyB;IACzB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,kDAAkD;IAClD,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,wCAAwC;IACxC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,oFAAoF;IACpF,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,gEAAgE;IAChE,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,wEAAwE;IACxE,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,kBAAkB,GAAG,MAAM,CA2M1E;AAED;;;GAGG;AACH,wBAAsB,gBAAgB,CACpC,OAAO,EAAE,kBAAkB,GAC1B,OAAO,CAAC,MAAM,CAAC,CAUjB;AAED,2DAA2D;AAC3D,wBAAgB,eAAe,CAAC,aAAa,EAAE,MAAM,GAAG,MAAM,CAE7D"}
@@ -0,0 +1,223 @@
1
+ import fs from "node:fs/promises";
2
+ import path from "node:path";
3
+ import { WRAPPER_DIR } from "../../types.js";
4
+ import { shellQuote } from "../scheduler/posix.js";
5
+ /**
6
+ * Собирает текст bash-обёртки.
7
+ *
8
+ * Скрипт:
9
+ * 1. выставляет PATH (важно для cron, где окружение минимальное);
10
+ * 2. берёт атомарный lock через `mkdir` (аналог 'wx' в Node);
11
+ * 3. переходит в рабочую директорию проекта;
12
+ * 4. выполняет pre-flight (если задан) — при ошибке задача отменяется;
13
+ * 5. запускает `opencode run <промпт>` с перенаправлением вывода в лог;
14
+ * 6. по таймауту завершает процесс;
15
+ * 7. выполняет Quality Gate (если задан);
16
+ * 8. выполняет post-flight (если задан) — даже при ошибке задачи;
17
+ * 9. пишет историю/метрики через `node record-history.js`.
18
+ *
19
+ * Если задана модель, вызов превращается в `opencode run --model "<model>" <промпт>`.
20
+ */
21
+ export function buildBashWrapperScript(options) {
22
+ const { taskName, promptFile, timeoutSeconds, lockFile, workdir, workspaceName, logFile, recorderFile, qualityGate, model, beforeScript, afterScript, allowedTools, deniedTools, } = options;
23
+ const lines = [
24
+ "#!/usr/bin/env bash",
25
+ "# Сгенерировано opencode-windows-scheduler. Не редактируйте вручную:",
26
+ "# файл перезаписывается при каждом обновлении задачи.",
27
+ "set -u",
28
+ "",
29
+ `TASK_NAME=${shellQuote(taskName)}`,
30
+ `PROMPT_FILE=${shellQuote(promptFile)}`,
31
+ `LOG_FILE=${shellQuote(logFile ?? path.join(WRAPPER_DIR, "task.log"))}`,
32
+ `LOCK_FILE=${shellQuote(lockFile)}`,
33
+ `WORKDIR=${shellQuote(workdir || process.cwd())}`,
34
+ `WORKSPACE_NAME=${shellQuote(workspaceName ?? "")}`,
35
+ `TIMEOUT_SECONDS=${Number.isFinite(timeoutSeconds) ? Math.max(0, Math.floor(timeoutSeconds)) : 3600}`,
36
+ `RECORDER_FILE=${shellQuote(recorderFile ?? "")}`,
37
+ `QUALITY_GATE=${shellQuote(qualityGate ?? "")}`,
38
+ `MODEL=${shellQuote(model ?? "")}`,
39
+ `BEFORE_SCRIPT=${shellQuote(beforeScript ?? "")}`,
40
+ `AFTER_SCRIPT=${shellQuote(afterScript ?? "")}`,
41
+ `ALLOWED_TOOLS=${shellQuote((allowedTools ?? []).join(","))}`,
42
+ `DENIED_TOOLS=${shellQuote((deniedTools ?? []).join(","))}`,
43
+ "",
44
+ "# cron запускает задачи с минимальным PATH — добавляем типовые каталоги.",
45
+ 'export PATH="/opt/homebrew/bin:/usr/local/bin:$HOME/.local/bin:$HOME/.bun/bin:$PATH"',
46
+ "",
47
+ 'mkdir -p "$(dirname "$LOG_FILE")" 2>/dev/null || true',
48
+ "",
49
+ "log() {",
50
+ ' printf \'[%s] %s\\n\' "$(date \'+%Y-%m-%d %H:%M:%S\')" "$*" >> "$LOG_FILE" 2>/dev/null || true',
51
+ "}",
52
+ "",
53
+ "# Атомарная блокировка: mkdir завершается ошибкой, если каталог уже есть.",
54
+ 'if ! mkdir "$LOCK_FILE.d" 2>/dev/null; then',
55
+ ' log "[scheduler] Задача \'$TASK_NAME\' уже выполняется — пропуск запуска."',
56
+ " exit 0",
57
+ "fi",
58
+ 'cleanup() { rmdir "$LOCK_FILE.d" 2>/dev/null || rm -rf "$LOCK_FILE.d" 2>/dev/null; }',
59
+ "trap cleanup EXIT INT TERM",
60
+ "",
61
+ 'if [ -n "$WORKDIR" ] && [ -d "$WORKDIR" ]; then',
62
+ ' cd "$WORKDIR" || { log "[scheduler] Не удалось перейти в $WORKDIR"; exit 1; }',
63
+ "fi",
64
+ "",
65
+ 'if [ -n "$WORKSPACE_NAME" ]; then',
66
+ ' GIT_BRANCH="$(git -C "$WORKDIR" rev-parse --abbrev-ref HEAD 2>/dev/null || true)"',
67
+ ' GIT_REMOTE="$(git -C "$WORKDIR" remote get-url origin 2>/dev/null || true)"',
68
+ ' [ -n "$GIT_BRANCH" ] || GIT_BRANCH="-"',
69
+ ' [ -n "$GIT_REMOTE" ] || GIT_REMOTE="-"',
70
+ ' log "[workspace] name=$WORKSPACE_NAME, cwd=$WORKDIR, branch=$GIT_BRANCH, remote=$GIT_REMOTE"',
71
+ "fi",
72
+ "",
73
+ "# Role-scoped tools: ограничения фиксируются в логе. Позиция metadata-only:",
74
+ "# opencode 2.2.3 не поддерживает allow/deny флаги, поэтому запрет мы лишь",
75
+ "# логируем и предупреждаем, но не блокируем.",
76
+ 'if [ -n "$ALLOWED_TOOLS" ] || [ -n "$DENIED_TOOLS" ]; then',
77
+ ' log "[role-scoped] allowed=[$ALLOWED_TOOLS], denied=[$DENIED_TOOLS]"',
78
+ ' case ",$DENIED_TOOLS," in',
79
+ ' *",write,"*|*",edit,"*|*",bash,"*|*",apply_patch,"*|*",remove,"*)',
80
+ ' log "[role-scoped] ВНИМАНИЕ: deniedTools содержит опасные инструменты ($DENIED_TOOLS). Запрет не может быть применён автоматически (metadata-only), проверьте промпт задачи."',
81
+ " ;;",
82
+ " esac",
83
+ "fi",
84
+ "",
85
+ 'if ! command -v opencode >/dev/null 2>&1; then',
86
+ ' log "[scheduler] ОШИБКА: opencode не найден в PATH ($PATH)."',
87
+ " exit 127",
88
+ "fi",
89
+ "",
90
+ 'PROMPT="$(cat "$PROMPT_FILE" 2>/dev/null || true)"',
91
+ 'START_EPOCH="$(date +%s)"',
92
+ 'STARTED_AT="$(date -u \'+%Y-%m-%dT%H:%M:%SZ\')"',
93
+ 'EXIT_CODE=0',
94
+ 'ERROR_MESSAGE=""',
95
+ 'PRE_FLIGHT_STATUS="skipped"',
96
+ 'POST_FLIGHT_STATUS="skipped"',
97
+ 'SKIP_MAIN=0',
98
+ "",
99
+ `log "[scheduler] Запуск задачи '$TASK_NAME'..."`,
100
+ "",
101
+ "# Crash recovery: фиксируем начало до pre-flight. Если процесс убьют,",
102
+ "# останется finished_at = NULL и recovery при следующем старте пометит error.",
103
+ 'RUN_ID=""',
104
+ 'if [ -n "$RECORDER_FILE" ] && command -v node >/dev/null 2>&1; then',
105
+ ' RUN_ID="$(node "$RECORDER_FILE" --start "$TASK_NAME" "$STARTED_AT" 2>> "$LOG_FILE" | tail -n 1)"',
106
+ "fi",
107
+ "",
108
+ "# Pre-flight: выполняется до основной задачи. Ненулевой код отменяет запуск.",
109
+ 'if [ -n "$BEFORE_SCRIPT" ]; then',
110
+ ' log "[scheduler] Pre-flight: $BEFORE_SCRIPT"',
111
+ ' bash -lc "$BEFORE_SCRIPT" >> "$LOG_FILE" 2>&1',
112
+ " PRE_CODE=$?",
113
+ ' if [ "$PRE_CODE" -ne 0 ]; then',
114
+ ' log "[scheduler] ОШИБКА: Pre-flight script failed (код $PRE_CODE)."',
115
+ ' PRE_FLIGHT_STATUS="error"',
116
+ ' ERROR_MESSAGE="Pre-flight script failed"',
117
+ " EXIT_CODE=1",
118
+ " SKIP_MAIN=1",
119
+ " else",
120
+ ' PRE_FLIGHT_STATUS="success"',
121
+ ' log "[scheduler] Pre-flight успешно завершён."',
122
+ " fi",
123
+ "fi",
124
+ "",
125
+ 'if [ "$SKIP_MAIN" -eq 0 ]; then',
126
+ "",
127
+ "# Модель указывается только если задана — иначе OpenCode берёт свою по умолчанию.",
128
+ "run_opencode() {",
129
+ ' if [ -n "$MODEL" ]; then',
130
+ ' opencode run --model "$MODEL" "$PROMPT"',
131
+ " else",
132
+ ' opencode run "$PROMPT"',
133
+ " fi",
134
+ "}",
135
+ "",
136
+ 'if [ "$TIMEOUT_SECONDS" -gt 0 ] 2>/dev/null; then',
137
+ ' run_opencode >> "$LOG_FILE" 2>&1 &',
138
+ " CHILD=$!",
139
+ ' ( sleep "$TIMEOUT_SECONDS"; kill -TERM "$CHILD" 2>/dev/null; sleep 5; kill -KILL "$CHILD" 2>/dev/null ) &',
140
+ " WATCHDOG=$!",
141
+ ' wait "$CHILD"',
142
+ " EXIT_CODE=$?",
143
+ ' kill "$WATCHDOG" 2>/dev/null || true',
144
+ ' wait "$WATCHDOG" 2>/dev/null || true',
145
+ "else",
146
+ ' run_opencode >> "$LOG_FILE" 2>&1',
147
+ " EXIT_CODE=$?",
148
+ "fi",
149
+ "",
150
+ 'if [ "$EXIT_CODE" -ne 0 ]; then',
151
+ ' log "[scheduler] Задача \'$TASK_NAME\' завершилась с кодом $EXIT_CODE."',
152
+ ' ERROR_MESSAGE="Код возврата $EXIT_CODE"',
153
+ "else",
154
+ ' log "[scheduler] Задача \'$TASK_NAME\' успешно завершена."',
155
+ "fi",
156
+ "",
157
+ 'if [ -n "$QUALITY_GATE" ] && [ "$EXIT_CODE" -eq 0 ]; then',
158
+ ' log "[scheduler] Запуск Quality Gate: $QUALITY_GATE"',
159
+ ' bash -lc "$QUALITY_GATE" >> "$LOG_FILE" 2>&1',
160
+ " GATE_CODE=$?",
161
+ ' if [ "$GATE_CODE" -ne 0 ]; then',
162
+ ' log "[scheduler] ОШИБКА: Quality Gate провален. Код возврата: $GATE_CODE"',
163
+ ' ERROR_MESSAGE="Quality Gate провален. Код возврата: $GATE_CODE"',
164
+ " EXIT_CODE=1",
165
+ " else",
166
+ ' log "[scheduler] Quality Gate пройден."',
167
+ " fi",
168
+ "fi",
169
+ "",
170
+ "fi # конец блока основной задачи",
171
+ "",
172
+ "# Post-flight: выполняется ВСЕГДА, даже если основная задача упала.",
173
+ 'if [ -n "$AFTER_SCRIPT" ]; then',
174
+ ' log "[scheduler] Post-flight: $AFTER_SCRIPT"',
175
+ ' bash -lc "$AFTER_SCRIPT" >> "$LOG_FILE" 2>&1',
176
+ " POST_CODE=$?",
177
+ ' if [ "$POST_CODE" -ne 0 ]; then',
178
+ ' log "[scheduler] ОШИБКА: Post-flight script failed (код $POST_CODE)."',
179
+ ' POST_FLIGHT_STATUS="error"',
180
+ ' if [ "$EXIT_CODE" -eq 0 ]; then',
181
+ ' ERROR_MESSAGE="Post-flight script failed"',
182
+ " EXIT_CODE=1",
183
+ " fi",
184
+ " else",
185
+ ' POST_FLIGHT_STATUS="success"',
186
+ ' log "[scheduler] Post-flight успешно завершён."',
187
+ " fi",
188
+ "fi",
189
+ "",
190
+ 'END_EPOCH="$(date +%s)"',
191
+ 'DURATION_MS=$(( (END_EPOCH - START_EPOCH) * 1000 ))',
192
+ 'STATUS="error"',
193
+ 'if [ "$EXIT_CODE" -eq 0 ]; then STATUS="success"; fi',
194
+ "",
195
+ 'if [ -n "$RECORDER_FILE" ] && command -v node >/dev/null 2>&1; then',
196
+ ' if [ -n "$RUN_ID" ]; then',
197
+ ' node "$RECORDER_FILE" --finish "$RUN_ID" "$TASK_NAME" "$STATUS" "$DURATION_MS" "$ERROR_MESSAGE" "-" "-" "$MODEL" "$PRE_FLIGHT_STATUS" "$POST_FLIGHT_STATUS" >> "$LOG_FILE" 2>&1 || true',
198
+ " else",
199
+ ' node "$RECORDER_FILE" "$TASK_NAME" "$STATUS" "$STARTED_AT" "$DURATION_MS" "$ERROR_MESSAGE" "-" "-" "$MODEL" "$PRE_FLIGHT_STATUS" "$POST_FLIGHT_STATUS" >> "$LOG_FILE" 2>&1 || true',
200
+ " fi",
201
+ "fi",
202
+ "",
203
+ 'exit "$EXIT_CODE"',
204
+ "",
205
+ ];
206
+ return lines.join("\n");
207
+ }
208
+ /**
209
+ * Записывает per-task bash-обёртку и делает её исполняемой.
210
+ * Возвращает абсолютный путь к .sh-файлу.
211
+ */
212
+ export async function writeBashWrapper(options) {
213
+ await fs.mkdir(WRAPPER_DIR, { recursive: true });
214
+ const scriptPath = path.join(WRAPPER_DIR, `run-${options.sanitizedName}.sh`);
215
+ const script = buildBashWrapperScript(options);
216
+ await fs.writeFile(scriptPath, script, "utf8");
217
+ await fs.chmod(scriptPath, 0o755);
218
+ return scriptPath;
219
+ }
220
+ /** Путь к bash-обёртке задачи (для диагностики/тестов). */
221
+ export function bashWrapperPath(sanitizedName) {
222
+ return path.join(WRAPPER_DIR, `run-${sanitizedName}.sh`);
223
+ }