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,493 @@
1
+ import { spawn } from "node:child_process";
2
+ import { pathToFileURL } from "node:url";
3
+ import { createSchedulerBackend } from "./scheduler/index.js";
4
+ import { notifyTaskCompletion } from "../notifications.js";
5
+ import { finishRun, getHistory, recordRun, startRun } from "../db/history-repo.js";
6
+ import { getSetting, setSetting } from "../db/settings-repo.js";
7
+ import { getTask, listTasks } from "../db/tasks-repo.js";
8
+ import type { TaskDefinition } from "../task-transfer.js";
9
+ import type { HistoryRecord } from "../history.js";
10
+ import {
11
+ advanceMatrixAfterClone,
12
+ finalizeMatrixIfComplete,
13
+ } from "./matrix.js";
14
+
15
+ type Status = "success" | "error" | "timeout";
16
+
17
+ const RETRY_STATE_KEY = "retry_state";
18
+
19
+ /**
20
+ * Ищет настройку повторов задачи в БД.
21
+ * Возвращает 0, если повторы не настроены.
22
+ */
23
+ async function loadRetryConfig(taskName: string): Promise<{ count: number; delay: number }> {
24
+ const definition = getTask(taskName);
25
+ const count = Math.max(0, Math.floor(Number(definition?.retryCount) || 0));
26
+ const delay = Math.max(1, Math.floor(Number(definition?.retryDelay) || 60));
27
+ return { count, delay };
28
+ }
29
+
30
+ /**
31
+ * Запускает задачу по имени через бэкенд планировщика текущей ОС
32
+ * (schtasks / crontab / launchd). Используется цепочками задач
33
+ * (nextTaskOnSuccess / nextTaskOnError).
34
+ */
35
+ async function triggerTask(taskName: string): Promise<boolean> {
36
+ try {
37
+ await createSchedulerBackend().runTask(taskName);
38
+ return true;
39
+ } catch (err: any) {
40
+ console.error(
41
+ `[windows-scheduler] Не удалось запустить задачу цепочки "${taskName}": ${
42
+ err instanceof Error ? err.message : String(err)
43
+ }`
44
+ );
45
+ return false;
46
+ }
47
+ }
48
+
49
+ /** Счётчик оставшихся повторов по задачам (ключ — имя в нижнем регистре). */
50
+ type RetryState = Record<string, number>;
51
+
52
+ async function loadRetryState(): Promise<RetryState> {
53
+ const raw = getSetting<RetryState>(RETRY_STATE_KEY, {});
54
+ return raw && typeof raw === "object" && !Array.isArray(raw) ? raw : {};
55
+ }
56
+
57
+ async function writeRetryState(state: RetryState): Promise<void> {
58
+ setSetting(RETRY_STATE_KEY, state);
59
+ }
60
+
61
+ async function clearRetryState(taskName: string): Promise<void> {
62
+ const state = await loadRetryState();
63
+ const key = Object.keys(state).find((k) => k.toLowerCase() === taskName.toLowerCase());
64
+ if (!key) return;
65
+ delete state[key];
66
+ await writeRetryState(state);
67
+ }
68
+
69
+ /**
70
+ * Планирует повторный запуск упавшей задачи.
71
+ *
72
+ * Сам процесс record-history вызывается из PowerShell-обёртки синхронно
73
+ * (`& node ... "), поэтому ждать задержку внутри него нельзя: обёртка
74
+ * не завершится и не снимет lock-файл. Вместо этого запускаем отдельный
75
+ * detached-процесс, который спит retryDelay секунд и вызывает schtasks /run.
76
+ */
77
+ async function scheduleRetry(taskName: string): Promise<boolean> {
78
+ try {
79
+ const { count, delay } = await loadRetryConfig(taskName);
80
+ if (count <= 0) return false;
81
+
82
+ const state = await loadRetryState();
83
+ const key = taskName.toLowerCase();
84
+ const remaining = Object.prototype.hasOwnProperty.call(state, key)
85
+ ? Number(state[key]) || 0
86
+ : count;
87
+
88
+ if (remaining <= 0) {
89
+ await clearRetryState(taskName);
90
+ console.log(`[windows-scheduler] Повторы для "${taskName}" исчерпаны.`);
91
+ return false;
92
+ }
93
+
94
+ state[key] = remaining - 1;
95
+ await writeRetryState(state);
96
+
97
+ const script = process.argv[1];
98
+ if (!script) return false;
99
+
100
+ // Отвязываем дочерний процесс от текущего: родитель (PowerShell) должен
101
+ // завершиться сразу, а повтор — сработать позже независимо от него.
102
+ const child = spawn(process.execPath, [script, "--retry", taskName, String(delay)], {
103
+ detached: true,
104
+ stdio: "ignore",
105
+ windowsHide: true,
106
+ });
107
+ child.unref();
108
+
109
+ console.log(
110
+ `[windows-scheduler] Задача "${taskName}" будет повторена через ${delay} с ` +
111
+ `(осталось повторов: ${remaining - 1}).`
112
+ );
113
+ return true;
114
+ } catch (err: any) {
115
+ console.error(
116
+ `[windows-scheduler] Не удалось запланировать повтор "${taskName}": ${
117
+ err instanceof Error ? err.message : String(err)
118
+ }`
119
+ );
120
+ return false;
121
+ }
122
+ }
123
+
124
+ /**
125
+ * Режим `--retry <taskName> <delaySec>`: ждёт задержку и запускает задачу
126
+ * через бэкенд планировщика. Статус исхода запишет уже сама обёртка задачи.
127
+ */
128
+ async function runRetry(taskName: string, delaySec: number): Promise<void> {
129
+ if (!taskName) process.exit(1);
130
+ const delay = Math.max(1, Math.floor(Number(delaySec) || 60));
131
+ await new Promise<void>((resolve) => setTimeout(resolve, delay * 1000));
132
+
133
+ try {
134
+ await createSchedulerBackend().runTask(taskName);
135
+ console.log(`[windows-scheduler] Повторный запуск задачи "${taskName}".`);
136
+ } catch (err: any) {
137
+ console.error(
138
+ `[windows-scheduler] Повторный запуск "${taskName}" не удался: ${
139
+ err instanceof Error ? err.message : String(err)
140
+ }`
141
+ );
142
+ }
143
+ }
144
+
145
+ /**
146
+ * Возвращает имена задач из БД, которые пора запустить после успешного
147
+ * завершения `completedTask` (DAG-зависимости).
148
+ *
149
+ * Правила:
150
+ * - у задачи есть непустой dependsOn, и в нём упомянута completedTask;
151
+ * - каждая зависимость имеет в истории последнюю запись со статусом success;
152
+ * - зависимая задача ещё НЕ запускалась после завершения своих зависимостей
153
+ * (иначе граф зациклится и будет перезапускать её на каждом завершении).
154
+ */
155
+ export function selectDependentsToTrigger(
156
+ completedTask: string,
157
+ definitions: TaskDefinition[],
158
+ history: HistoryRecord[]
159
+ ): string[] {
160
+ const key = (value: string) => value.trim().toLowerCase();
161
+
162
+ // История хранится от новых к старым: первая запись задачи — самая свежая.
163
+ const latestByTask = new Map<string, HistoryRecord>();
164
+ for (const record of history) {
165
+ const k = key(record.taskName);
166
+ if (!latestByTask.has(k)) latestByTask.set(k, record);
167
+ }
168
+
169
+ const toTrigger: string[] = [];
170
+ const defsByKey = new Map<string, TaskDefinition>();
171
+ for (const definition of definitions) {
172
+ defsByKey.set(key(definition.name), definition);
173
+ }
174
+
175
+ for (const definition of definitions) {
176
+ const deps = (Array.isArray(definition.dependsOn) ? definition.dependsOn : [])
177
+ .map((dep) => (typeof dep === "string" ? dep.trim() : ""))
178
+ .filter(Boolean);
179
+ if (deps.length === 0) continue;
180
+ if (key(definition.name) === key(completedTask)) continue;
181
+ if (!deps.some((dep) => key(dep) === key(completedTask))) continue;
182
+
183
+ let allSuccess = true;
184
+ let latestDependencyFinished = 0;
185
+ for (const dep of deps) {
186
+ // Matrix (Спринт 15): зависимость-матрица считается выполненной только
187
+ // когда успешны ВСЕ её клоны (у самого родителя истории нет).
188
+ const depDefinition = defsByKey.get(key(dep));
189
+ const clones = depDefinition?.matrix
190
+ ? definitions.filter(
191
+ (item) =>
192
+ item.matrixParentId && key(item.matrixParentId) === key(dep)
193
+ )
194
+ : [];
195
+ const requiredNames = clones.length > 0 ? clones.map((c) => c.name) : [dep];
196
+
197
+ for (const requiredName of requiredNames) {
198
+ const record = latestByTask.get(key(requiredName));
199
+ if (!record || record.status !== "success") {
200
+ allSuccess = false;
201
+ break;
202
+ }
203
+ const finished = new Date(record.finishedAt ?? 0).getTime();
204
+ if (Number.isFinite(finished)) {
205
+ latestDependencyFinished = Math.max(latestDependencyFinished, finished);
206
+ }
207
+ }
208
+ if (!allSuccess) break;
209
+ }
210
+ if (!allSuccess) continue;
211
+
212
+ // Защита от повторного запуска: если зависимая задача уже стартовала
213
+ // после успешного завершения последней зависимости — не трогаем её.
214
+ const own = latestByTask.get(key(definition.name));
215
+ if (own) {
216
+ const ownStarted = new Date(own.startedAt).getTime();
217
+ if (Number.isFinite(ownStarted) && ownStarted >= latestDependencyFinished) {
218
+ continue;
219
+ }
220
+ }
221
+
222
+ toTrigger.push(definition.name);
223
+ }
224
+
225
+ // Приоритеты: при готовности нескольких задач первыми запускаем более важные.
226
+ const priorityByTask = new Map<string, number>();
227
+ for (const definition of definitions) {
228
+ priorityByTask.set(key(definition.name), Number(definition.priority) || 5);
229
+ }
230
+ return toTrigger.sort(
231
+ (a, b) => (priorityByTask.get(key(b)) ?? 5) - (priorityByTask.get(key(a)) ?? 5)
232
+ );
233
+ }
234
+
235
+ async function main() {
236
+ const [
237
+ ,
238
+ ,
239
+ first,
240
+ second,
241
+ third,
242
+ fourth,
243
+ fifth,
244
+ sixth,
245
+ seventh,
246
+ eighth,
247
+ ninth,
248
+ tenth,
249
+ eleventh,
250
+ ] = process.argv;
251
+
252
+ // Режим повтора: node record-history.js --retry "<task>" <delaySec>
253
+ if (first === "--retry") {
254
+ await runRetry(second, Number(third));
255
+ return;
256
+ }
257
+
258
+ const parseOptionalNumber = (value?: string): number | undefined => {
259
+ if (!value || value === "-") return undefined;
260
+ const num = Number(value);
261
+ return Number.isFinite(num) && num > 0 ? num : undefined;
262
+ };
263
+ const parseHookStatus = (
264
+ value?: string
265
+ ): "success" | "error" | "skipped" | undefined => {
266
+ if (!value || value === "-") return undefined;
267
+ if (value === "success" || value === "error" || value === "skipped") return value;
268
+ return undefined;
269
+ };
270
+
271
+ /**
272
+ * Режим старта: node record-history.js --start "<task>" "<startedAtIso>"
273
+ * Создаёт незавершённую запись (finished_at = NULL) и печатает её id.
274
+ * Обёртка передаёт id в --finish; если процесс убили, останется NULL и
275
+ * crash recovery при следующем старте плагина пометит запись как error.
276
+ */
277
+ if (first === "--start") {
278
+ const taskName = second;
279
+ if (!taskName) process.exit(1);
280
+ const startedAt = third ?? new Date().toISOString();
281
+ const definition = getTask(taskName);
282
+ const runId = startRun(
283
+ taskName,
284
+ startedAt,
285
+ definition?.workspaceId ?? null,
286
+ definition?.allowedTools ?? null,
287
+ definition?.deniedTools ?? null
288
+ );
289
+ console.log(String(runId));
290
+ return;
291
+ }
292
+
293
+ /**
294
+ * Режим завершения: --finish <id> <task> <status> <durationMs> <error>
295
+ * <tokens> <cost> <model> <preFlight> <postFlight>
296
+ */
297
+ if (first === "--finish") {
298
+ const runId = Number(second);
299
+ const taskName = third;
300
+ const status = fourth;
301
+ if (!Number.isFinite(runId) || runId <= 0 || !taskName || !status) {
302
+ process.exit(1);
303
+ }
304
+ const durationMs = Number(fifth) || 0;
305
+ const error = sixth !== undefined ? sixth : null;
306
+ const tokens = parseOptionalNumber(seventh);
307
+ const costUsd = parseOptionalNumber(eighth);
308
+ const model = ninth && ninth !== "-" ? ninth.trim() || undefined : undefined;
309
+ const preFlightStatus = parseHookStatus(tenth);
310
+ const postFlightStatus = parseHookStatus(eleventh);
311
+ const st: Status =
312
+ status === "success" ? "success" : status === "timeout" ? "timeout" : "error";
313
+
314
+ const definition = getTask(taskName);
315
+ const chainTarget =
316
+ st === "success"
317
+ ? definition?.nextTaskOnSuccess || null
318
+ : definition?.nextTaskOnError || null;
319
+
320
+ const completed = finishRun(
321
+ runId,
322
+ st,
323
+ durationMs,
324
+ error,
325
+ chainTarget,
326
+ tokens,
327
+ costUsd,
328
+ model,
329
+ preFlightStatus,
330
+ postFlightStatus
331
+ );
332
+ if (!completed) {
333
+ console.error(
334
+ `[windows-scheduler] record-history: запись #${runId} уже завершена или не найдена.`
335
+ );
336
+ return;
337
+ }
338
+
339
+ await handleCompletion(taskName, st, chainTarget, error, durationMs);
340
+ return;
341
+ }
342
+
343
+ // Обратная совместимость: старый режим без --start.
344
+ const taskName = first;
345
+ const status = second;
346
+ if (!taskName || !status) {
347
+ process.exit(1);
348
+ }
349
+
350
+ const startedAt = third ?? new Date().toISOString();
351
+ const durationMs = Number(fourth) || 0;
352
+ const error = fifth !== undefined ? fifth : null;
353
+
354
+ // Токены и стоимость приходят из PowerShell-обёртки (ps-wrapper.ts).
355
+ // "-" означает «данных нет» (openCode не печатал usage в лог).
356
+ const tokens = parseOptionalNumber(sixth);
357
+ const costUsd = parseOptionalNumber(seventh);
358
+ // Восьмой аргумент — модель; "-" означает, что модель не задана.
359
+ const model = eighth && eighth !== "-" ? eighth.trim() || undefined : undefined;
360
+ // Девятый и десятый — итоги pre/post-flight хуков.
361
+ const preFlightStatus = parseHookStatus(ninth);
362
+ const postFlightStatus = parseHookStatus(tenth);
363
+
364
+ const st: Status =
365
+ status === "success" ? "success" : status === "timeout" ? "timeout" : "error";
366
+
367
+ const definition = getTask(taskName);
368
+ const chainTarget =
369
+ st === "success"
370
+ ? definition?.nextTaskOnSuccess || null
371
+ : definition?.nextTaskOnError || null;
372
+
373
+ recordRun(
374
+ taskName,
375
+ st,
376
+ startedAt,
377
+ durationMs,
378
+ error,
379
+ chainTarget,
380
+ tokens,
381
+ costUsd,
382
+ model,
383
+ preFlightStatus,
384
+ postFlightStatus,
385
+ new Date().toISOString(),
386
+ definition?.workspaceId ?? null,
387
+ definition?.allowedTools ?? null,
388
+ definition?.deniedTools ?? null
389
+ );
390
+
391
+ await handleCompletion(taskName, st, chainTarget, error, durationMs);
392
+ }
393
+
394
+ /**
395
+ * Общая пост-обработка завершённого запуска: уведомление, цепочки задач,
396
+ * DAG-зависимости и повторы. Используется и legacy-режимом, и --finish.
397
+ */
398
+ async function handleCompletion(
399
+ taskName: string,
400
+ st: Status,
401
+ chainTarget: string | null,
402
+ error: string | null,
403
+ durationMs: number
404
+ ): Promise<void> {
405
+ // Уведомление о завершении (webhook). Ошибки отправки логируются внутри
406
+ // и не влияют на историю, цепочки и повторы.
407
+ await notifyTaskCompletion(taskName, st, durationMs, error);
408
+
409
+ // Matrix (Спринт 15): клон завершился — двигаем sequential-цепочку или
410
+ // очередь concurrency-лимита (Спринт 17), а когда все клоны готовы —
411
+ // фиксируем агрегат и запускаем matrix-complete.
412
+ try {
413
+ await advanceMatrixAfterClone(taskName);
414
+ await finalizeMatrixIfComplete(taskName);
415
+ } catch (err: any) {
416
+ console.log(
417
+ `[matrix] ${taskName}: ошибка обработки матрицы: ${
418
+ err instanceof Error ? err.message : String(err)
419
+ }`
420
+ );
421
+ }
422
+
423
+ if (st === "success") {
424
+ // Успешный запуск сбрасывает счётчик повторов.
425
+ await clearRetryState(taskName);
426
+ if (chainTarget) {
427
+ const started = await triggerTask(chainTarget);
428
+ if (started) {
429
+ console.log(`[windows-scheduler] Запущена следующая задача в цепочке: ${chainTarget}`);
430
+ }
431
+ }
432
+
433
+ // DAG: после успеха проверяем задачи, у которых эта задача — одна из
434
+ // зависимостей. Запускаем только если ВСЕ зависимости уже успешны и
435
+ // зависимая задача ещё не запускалась после их завершения.
436
+ try {
437
+ const history = getHistory(null, 200) as HistoryRecord[];
438
+ const definitions = listTasks();
439
+ const dependents = selectDependentsToTrigger(taskName, definitions, history);
440
+ for (const dependent of dependents) {
441
+ const started = await triggerTask(dependent);
442
+ if (started) {
443
+ console.log(
444
+ `[windows-scheduler] DAG: все зависимости выполнены, запущена задача "${dependent}".`
445
+ );
446
+ }
447
+ }
448
+ } catch (err: any) {
449
+ console.error(
450
+ `[windows-scheduler] DAG: не удалось запустить зависимые задачи: ${
451
+ err instanceof Error ? err.message : String(err)
452
+ }`
453
+ );
454
+ }
455
+ } else {
456
+ // Сначала пытаемся повторить саму задачу; компенсирующая задача запускается
457
+ // только когда повторы исчерпаны (или не настроены).
458
+ const retryScheduled = await scheduleRetry(taskName);
459
+ if (!retryScheduled && chainTarget) {
460
+ const started = await triggerTask(chainTarget);
461
+ if (started) {
462
+ console.log(`[windows-scheduler] Запущена компенсирующая задача: ${chainTarget}`);
463
+ }
464
+ }
465
+ }
466
+ }
467
+
468
+ /**
469
+ * Скрипт вызывается и как CLI (node record-history.js ...), и импортируется
470
+ * тестами. main() запускаем только при прямом вызове файла.
471
+ */
472
+ function isDirectInvocation(): boolean {
473
+ const entry = process.argv[1];
474
+ if (!entry) return false;
475
+ try {
476
+ return (
477
+ pathToFileURL(entry).href.toLowerCase() === import.meta.url.toLowerCase()
478
+ );
479
+ } catch {
480
+ return false;
481
+ }
482
+ }
483
+
484
+ if (isDirectInvocation()) {
485
+ main().catch((err) => {
486
+ console.error(
487
+ `[windows-scheduler] record-history: не удалось записать результат запуска: ${
488
+ err instanceof Error ? err.message : String(err)
489
+ }`
490
+ );
491
+ process.exit(1);
492
+ });
493
+ }
@@ -0,0 +1,44 @@
1
+ import { WindowsScheduler } from "./windows.js";
2
+ import { LinuxScheduler } from "./linux.js";
3
+ import { MacScheduler } from "./mac.js";
4
+ import type { SchedulerBackend } from "./types.js";
5
+
6
+ export type {
7
+ SchedulerBackend,
8
+ CreateTaskOptions,
9
+ RunTaskResult,
10
+ TriggerType,
11
+ } from "./types.js";
12
+ export { WindowsScheduler, SchtasksError, WINDOWS_TASK_PREFIX } from "./windows.js";
13
+ export { LinuxScheduler } from "./linux.js";
14
+ export { MacScheduler } from "./mac.js";
15
+ export { TaskRegistry } from "./registry.js";
16
+ export type { RegistryEntry } from "./registry.js";
17
+
18
+ /**
19
+ * Фабрика бэкендов планировщика по платформе.
20
+ *
21
+ * - win32 → WindowsScheduler (schtasks);
22
+ * - darwin → MacScheduler (launchd);
23
+ * - linux (и прочие POSIX) → LinuxScheduler (crontab).
24
+ */
25
+ export function createSchedulerBackend(
26
+ platform: NodeJS.Platform = process.platform
27
+ ): SchedulerBackend {
28
+ if (platform === "win32") return new WindowsScheduler();
29
+ if (platform === "darwin") return new MacScheduler();
30
+ return new LinuxScheduler();
31
+ }
32
+
33
+ let cached: SchedulerBackend | null = null;
34
+
35
+ /** Возвращает общий (закэшированный) бэкенд текущей платформы. */
36
+ export function getSchedulerBackend(): SchedulerBackend {
37
+ if (!cached) cached = createSchedulerBackend();
38
+ return cached;
39
+ }
40
+
41
+ /** Название планировщика для текущей платформы (для GUI/логов). */
42
+ export function getSchedulerTitle(platform: NodeJS.Platform = process.platform): string {
43
+ return createSchedulerBackend(platform).title;
44
+ }
@@ -0,0 +1,125 @@
1
+ import { execFile, spawn } from "node:child_process";
2
+ import { promisify } from "node:util";
3
+ import { PosixSchedulerBase, shellQuote } from "./posix.js";
4
+ import type { RegistryEntry } from "./registry.js";
5
+
6
+ const execFileAsync = promisify(execFile);
7
+
8
+ const BLOCK_BEGIN = "# >>> opencode-scheduler >>>";
9
+ const BLOCK_END = "# <<< opencode-scheduler <<<";
10
+
11
+ /**
12
+ * Бэкенд планировщика Linux на основе пользовательского crontab.
13
+ *
14
+ * Все задачи плагина живут в одном управляемом блоке:
15
+ * # >>> opencode-scheduler >>>
16
+ * # task: <имя>
17
+ * <cron> /bin/bash '<обёртка>' >> '<лог>' 2>&1
18
+ * # <<< opencode-scheduler <<<
19
+ * При паузе строка задачи комментируется ("# PAUSED: ..."), при удалении —
20
+ * блок перегенерируется из реестра.
21
+ */
22
+ export class LinuxScheduler extends PosixSchedulerBase {
23
+ readonly platform: NodeJS.Platform = "linux";
24
+ readonly title = "OpenCode Scheduler";
25
+
26
+ constructor() {
27
+ super("linux");
28
+ }
29
+
30
+ private cronLine(entry: RegistryEntry): string {
31
+ if (entry.triggerType !== "cron") {
32
+ // Файловый/MCP-триггер не имеет расписания — держим задачу только в реестре.
33
+ return "";
34
+ }
35
+ const log = entry.logFile ? ` >> ${shellQuote(entry.logFile)} 2>&1` : "";
36
+ const cmd = `/bin/bash ${shellQuote(entry.command)}${log}`;
37
+ return `${entry.schedule} ${cmd}`;
38
+ }
39
+
40
+ private renderBlock(entries: RegistryEntry[]): string {
41
+ const lines: string[] = [BLOCK_BEGIN];
42
+ for (const entry of entries) {
43
+ const line = this.cronLine(entry);
44
+ if (!line) continue;
45
+ lines.push(`# task: ${entry.name}`);
46
+ lines.push(entry.paused ? `# PAUSED: ${line}` : line);
47
+ }
48
+ lines.push(BLOCK_END);
49
+ return lines.join("\n");
50
+ }
51
+
52
+ /** Читает текущий crontab (пустая строка, если crontab ещё не создан). */
53
+ private async readCrontab(): Promise<string> {
54
+ try {
55
+ const { stdout } = await execFileAsync("crontab", ["-l"], {
56
+ maxBuffer: 10 * 1024 * 1024,
57
+ });
58
+ return stdout;
59
+ } catch {
60
+ // "no crontab for user" — это нормальное состояние.
61
+ return "";
62
+ }
63
+ }
64
+
65
+ /** Убирает управляемый блок плагина из текста crontab. */
66
+ private stripBlock(content: string): string {
67
+ const lines = content.split(/\r?\n/);
68
+ const result: string[] = [];
69
+ let inside = false;
70
+ for (const line of lines) {
71
+ if (line.trim() === BLOCK_BEGIN) {
72
+ inside = true;
73
+ continue;
74
+ }
75
+ if (line.trim() === BLOCK_END) {
76
+ inside = false;
77
+ continue;
78
+ }
79
+ if (!inside) result.push(line);
80
+ }
81
+ return result.join("\n").replace(/\n{3,}/g, "\n\n").trimEnd();
82
+ }
83
+
84
+ /** Записывает crontab через stdin: `crontab -`. */
85
+ private async writeCrontab(content: string): Promise<void> {
86
+ await new Promise<void>((resolve, reject) => {
87
+ const child = spawn("crontab", ["-"], { stdio: ["pipe", "ignore", "pipe"] });
88
+ let stderr = "";
89
+ child.stderr.on("data", (chunk) => {
90
+ stderr += String(chunk);
91
+ });
92
+ child.on("error", reject);
93
+ child.on("close", (code) => {
94
+ if (code === 0) resolve();
95
+ else reject(new Error(`crontab - завершился с кодом ${code}: ${stderr.trim()}`));
96
+ });
97
+ child.stdin.end(content.endsWith("\n") ? content : `${content}\n`);
98
+ });
99
+ }
100
+
101
+ /** Перегенерирует блок плагина из реестра. */
102
+ private async rebuildCrontab(): Promise<void> {
103
+ const entries = await this.registry.load();
104
+ const current = await this.readCrontab();
105
+ const base = this.stripBlock(current);
106
+ const block = this.renderBlock(entries);
107
+
108
+ // Пустой блок (нет задач) не пишем, чтобы не оставлять мусор в crontab.
109
+ const hasTasks = block.split("\n").some((line) => line.trim().startsWith("# task:"));
110
+ const next = [base, hasTasks ? block : ""].filter(Boolean).join("\n");
111
+ await this.writeCrontab(next);
112
+ }
113
+
114
+ protected async installEntry(_entry: RegistryEntry): Promise<void> {
115
+ await this.rebuildCrontab();
116
+ }
117
+
118
+ protected async uninstallEntry(_entry: RegistryEntry): Promise<void> {
119
+ await this.rebuildCrontab();
120
+ }
121
+
122
+ protected async applyPause(_entry: RegistryEntry, _paused: boolean): Promise<void> {
123
+ await this.rebuildCrontab();
124
+ }
125
+ }
@@ -0,0 +1,37 @@
1
+ import fs from "node:fs/promises";
2
+ import path from "node:path";
3
+ import { LOG_DIR, sanitizeName } from "../../types.js";
4
+
5
+ /**
6
+ * Читает файл лога задачи и возвращает последние 50 строк.
7
+ *
8
+ * Лог пишут обёртки (PowerShell на Windows, bash на POSIX) в
9
+ * ${LOG_DIR}/<sanitizedName>.log — тот же путь, что передаётся при создании.
10
+ */
11
+ export async function getTaskLogs(
12
+ name: string,
13
+ limit = 50
14
+ ): Promise<{ logs: string; error?: string }> {
15
+ const logPath = path.join(LOG_DIR, `${sanitizeName(name)}.log`);
16
+ try {
17
+ // PowerShell 5.1 пишет UTF-8 с BOM — убираем его, чтобы GUI не показывал мусор.
18
+ const content = (await fs.readFile(logPath, "utf8")).replace(/^\uFEFF/, "");
19
+ const lines = content.split(/\r?\n/).filter((line) => line.trim());
20
+ if (lines.length === 0) {
21
+ return {
22
+ logs: "",
23
+ error: `Лог задачи "${name}" пуст. Задача ещё не писала вывод — запустите её и повторите.`,
24
+ };
25
+ }
26
+ const last = lines.slice(-Math.max(1, Math.min(limit, 1000)));
27
+ return { logs: last.join("\n") };
28
+ } catch (err: any) {
29
+ if (err.code === "ENOENT") {
30
+ return {
31
+ logs: "",
32
+ error: `Лог задачи "${name}" не найден по пути ${logPath} (задача ещё не запускалась).`,
33
+ };
34
+ }
35
+ return { logs: "", error: err instanceof Error ? err.message : String(err) };
36
+ }
37
+ }