opencode-windows-scheduler 0.0.0-stage → 1.1.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 (183) hide show
  1. package/CHANGELOG.md +52 -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 +90 -0
  8. package/dist/core/analytics.d.ts +119 -0
  9. package/dist/core/analytics.d.ts.map +1 -0
  10. package/dist/core/analytics.js +265 -0
  11. package/dist/core/cron-to-schtasks.d.ts +20 -0
  12. package/dist/core/cron-to-schtasks.d.ts.map +1 -0
  13. package/dist/core/cron-to-schtasks.js +233 -0
  14. package/dist/core/dry-run.d.ts +44 -0
  15. package/dist/core/dry-run.d.ts.map +1 -0
  16. package/dist/core/dry-run.js +252 -0
  17. package/dist/core/file-watcher.d.ts +31 -0
  18. package/dist/core/file-watcher.d.ts.map +1 -0
  19. package/dist/core/file-watcher.js +128 -0
  20. package/dist/core/lock.d.ts +43 -0
  21. package/dist/core/lock.d.ts.map +1 -0
  22. package/dist/core/lock.js +118 -0
  23. package/dist/core/matrix.d.ts +167 -0
  24. package/dist/core/matrix.d.ts.map +1 -0
  25. package/dist/core/matrix.js +687 -0
  26. package/dist/core/ps-wrapper.d.ts +60 -0
  27. package/dist/core/ps-wrapper.d.ts.map +1 -0
  28. package/dist/core/ps-wrapper.js +538 -0
  29. package/dist/core/record-history.d.ts +14 -0
  30. package/dist/core/record-history.d.ts.map +1 -0
  31. package/dist/core/record-history.js +360 -0
  32. package/dist/core/retention.d.ts +29 -0
  33. package/dist/core/retention.d.ts.map +1 -0
  34. package/dist/core/retention.js +98 -0
  35. package/dist/core/scheduler/index.d.ts +20 -0
  36. package/dist/core/scheduler/index.d.ts.map +1 -0
  37. package/dist/core/scheduler/index.js +32 -0
  38. package/dist/core/scheduler/linux.d.ts +32 -0
  39. package/dist/core/scheduler/linux.d.ts.map +1 -0
  40. package/dist/core/scheduler/linux.js +115 -0
  41. package/dist/core/scheduler/logs.d.ts +11 -0
  42. package/dist/core/scheduler/logs.d.ts.map +1 -0
  43. package/dist/core/scheduler/logs.js +34 -0
  44. package/dist/core/scheduler/mac.d.ts +39 -0
  45. package/dist/core/scheduler/mac.d.ts.map +1 -0
  46. package/dist/core/scheduler/mac.js +175 -0
  47. package/dist/core/scheduler/posix.d.ts +40 -0
  48. package/dist/core/scheduler/posix.d.ts.map +1 -0
  49. package/dist/core/scheduler/posix.js +86 -0
  50. package/dist/core/scheduler/registry.d.ts +36 -0
  51. package/dist/core/scheduler/registry.d.ts.map +1 -0
  52. package/dist/core/scheduler/registry.js +56 -0
  53. package/dist/core/scheduler/types.d.ts +63 -0
  54. package/dist/core/scheduler/types.d.ts.map +1 -0
  55. package/dist/core/scheduler/types.js +1 -0
  56. package/dist/core/scheduler/windows.d.ts +47 -0
  57. package/dist/core/scheduler/windows.d.ts.map +1 -0
  58. package/dist/core/scheduler/windows.js +375 -0
  59. package/dist/core/wrappers/bash.d.ts +58 -0
  60. package/dist/core/wrappers/bash.d.ts.map +1 -0
  61. package/dist/core/wrappers/bash.js +223 -0
  62. package/dist/db/history-repo.d.ts +102 -0
  63. package/dist/db/history-repo.d.ts.map +1 -0
  64. package/dist/db/history-repo.js +215 -0
  65. package/dist/db/index.d.ts +47 -0
  66. package/dist/db/index.d.ts.map +1 -0
  67. package/dist/db/index.js +120 -0
  68. package/dist/db/metrics-repo.d.ts +43 -0
  69. package/dist/db/metrics-repo.d.ts.map +1 -0
  70. package/dist/db/metrics-repo.js +95 -0
  71. package/dist/db/migrate.d.ts +24 -0
  72. package/dist/db/migrate.d.ts.map +1 -0
  73. package/dist/db/migrate.js +237 -0
  74. package/dist/db/recovery.d.ts +11 -0
  75. package/dist/db/recovery.d.ts.map +1 -0
  76. package/dist/db/recovery.js +38 -0
  77. package/dist/db/schema.d.ts +24 -0
  78. package/dist/db/schema.d.ts.map +1 -0
  79. package/dist/db/schema.js +97 -0
  80. package/dist/db/settings-repo.d.ts +8 -0
  81. package/dist/db/settings-repo.d.ts.map +1 -0
  82. package/dist/db/settings-repo.js +27 -0
  83. package/dist/db/tasks-repo.d.ts +26 -0
  84. package/dist/db/tasks-repo.d.ts.map +1 -0
  85. package/dist/db/tasks-repo.js +120 -0
  86. package/dist/db/templates-repo.d.ts +17 -0
  87. package/dist/db/templates-repo.d.ts.map +1 -0
  88. package/dist/db/templates-repo.js +57 -0
  89. package/dist/history.d.ts +53 -0
  90. package/dist/history.d.ts.map +1 -0
  91. package/dist/history.js +57 -0
  92. package/dist/index.d.ts +156 -0
  93. package/dist/index.d.ts.map +1 -0
  94. package/dist/index.js +2159 -0
  95. package/dist/notifications.d.ts +45 -0
  96. package/dist/notifications.d.ts.map +1 -0
  97. package/dist/notifications.js +135 -0
  98. package/dist/rpc.d.ts +2186 -0
  99. package/dist/rpc.d.ts.map +1 -0
  100. package/dist/rpc.js +924 -0
  101. package/dist/schtasks.d.ts +32 -0
  102. package/dist/schtasks.d.ts.map +1 -0
  103. package/dist/schtasks.js +45 -0
  104. package/dist/server.d.ts +106 -0
  105. package/dist/server.d.ts.map +1 -0
  106. package/dist/server.js +1668 -0
  107. package/dist/settings.d.ts +66 -0
  108. package/dist/settings.d.ts.map +1 -0
  109. package/dist/settings.js +137 -0
  110. package/dist/shared/jobs-view.d.ts +21 -0
  111. package/dist/shared/jobs-view.d.ts.map +1 -0
  112. package/dist/shared/jobs-view.js +28 -0
  113. package/dist/skill.d.ts +15 -0
  114. package/dist/skill.d.ts.map +1 -0
  115. package/dist/skill.js +93 -0
  116. package/dist/task-transfer.d.ts +176 -0
  117. package/dist/task-transfer.d.ts.map +1 -0
  118. package/dist/task-transfer.js +442 -0
  119. package/dist/templates.d.ts +57 -0
  120. package/dist/templates.d.ts.map +1 -0
  121. package/dist/templates.js +16 -0
  122. package/dist/types.d.ts +78 -0
  123. package/dist/types.d.ts.map +1 -0
  124. package/dist/types.js +88 -0
  125. package/dist/version.d.ts +8 -0
  126. package/dist/version.d.ts.map +1 -0
  127. package/dist/version.js +27 -0
  128. package/dist/workspaces.d.ts +55 -0
  129. package/dist/workspaces.d.ts.map +1 -0
  130. package/dist/workspaces.js +183 -0
  131. package/docs/ARCHITECTURE.md +314 -0
  132. package/docs/FEATURES.md +300 -0
  133. package/docs/MIGRATION.md +266 -0
  134. package/docs/dashboard.png +0 -0
  135. package/gui-experimental.cjs +2 -0
  136. package/index.js +1 -0
  137. package/package.json +94 -4
  138. package/scripts/demo-dashboard.mjs +199 -0
  139. package/skills/scheduled-job-best-practices/SKILL.md +155 -0
  140. package/skills/scheduled-job-best-practices/references/recipes.md +123 -0
  141. package/src/core/analytics.ts +378 -0
  142. package/src/core/cron-to-schtasks.ts +269 -0
  143. package/src/core/dry-run.ts +315 -0
  144. package/src/core/file-watcher.ts +171 -0
  145. package/src/core/lock.ts +134 -0
  146. package/src/core/matrix.ts +907 -0
  147. package/src/core/ps-wrapper.ts +572 -0
  148. package/src/core/record-history.ts +493 -0
  149. package/src/core/retention.ts +141 -0
  150. package/src/core/scheduler/index.ts +44 -0
  151. package/src/core/scheduler/linux.ts +125 -0
  152. package/src/core/scheduler/logs.ts +37 -0
  153. package/src/core/scheduler/mac.ts +222 -0
  154. package/src/core/scheduler/posix.ts +111 -0
  155. package/src/core/scheduler/registry.ts +93 -0
  156. package/src/core/scheduler/types.ts +67 -0
  157. package/src/core/scheduler/windows.ts +469 -0
  158. package/src/core/wrappers/bash.ts +282 -0
  159. package/src/db/history-repo.ts +396 -0
  160. package/src/db/index.ts +166 -0
  161. package/src/db/metrics-repo.ts +158 -0
  162. package/src/db/migrate.ts +322 -0
  163. package/src/db/recovery.ts +46 -0
  164. package/src/db/schema.ts +109 -0
  165. package/src/db/settings-repo.ts +31 -0
  166. package/src/db/tasks-repo.ts +162 -0
  167. package/src/db/templates-repo.ts +77 -0
  168. package/src/gui.tsx +2868 -0
  169. package/src/history.ts +107 -0
  170. package/src/index.ts +2768 -0
  171. package/src/notifications.ts +174 -0
  172. package/src/rpc.ts +999 -0
  173. package/src/schtasks.ts +75 -0
  174. package/src/server.ts +1879 -0
  175. package/src/settings.ts +228 -0
  176. package/src/shared/jobs-view.ts +38 -0
  177. package/src/skill.ts +113 -0
  178. package/src/task-transfer.ts +648 -0
  179. package/src/templates.ts +67 -0
  180. package/src/tui.tsx +46 -0
  181. package/src/types.ts +145 -0
  182. package/src/version.ts +27 -0
  183. package/src/workspaces.ts +236 -0
@@ -0,0 +1,14 @@
1
+ import type { TaskDefinition } from "../task-transfer.js";
2
+ import type { HistoryRecord } from "../history.js";
3
+ /**
4
+ * Возвращает имена задач из БД, которые пора запустить после успешного
5
+ * завершения `completedTask` (DAG-зависимости).
6
+ *
7
+ * Правила:
8
+ * - у задачи есть непустой dependsOn, и в нём упомянута completedTask;
9
+ * - каждая зависимость имеет в истории последнюю запись со статусом success;
10
+ * - зависимая задача ещё НЕ запускалась после завершения своих зависимостей
11
+ * (иначе граф зациклится и будет перезапускать её на каждом завершении).
12
+ */
13
+ export declare function selectDependentsToTrigger(completedTask: string, definitions: TaskDefinition[], history: HistoryRecord[]): string[];
14
+ //# sourceMappingURL=record-history.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"record-history.d.ts","sourceRoot":"","sources":["../../src/core/record-history.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAC1D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAwInD;;;;;;;;;GASG;AACH,wBAAgB,yBAAyB,CACvC,aAAa,EAAE,MAAM,EACrB,WAAW,EAAE,cAAc,EAAE,EAC7B,OAAO,EAAE,aAAa,EAAE,GACvB,MAAM,EAAE,CA0EV"}
@@ -0,0 +1,360 @@
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 { advanceMatrixAfterClone, finalizeMatrixIfComplete, } from "./matrix.js";
9
+ const RETRY_STATE_KEY = "retry_state";
10
+ /**
11
+ * Ищет настройку повторов задачи в БД.
12
+ * Возвращает 0, если повторы не настроены.
13
+ */
14
+ async function loadRetryConfig(taskName) {
15
+ const definition = getTask(taskName);
16
+ const count = Math.max(0, Math.floor(Number(definition?.retryCount) || 0));
17
+ const delay = Math.max(1, Math.floor(Number(definition?.retryDelay) || 60));
18
+ return { count, delay };
19
+ }
20
+ /**
21
+ * Запускает задачу по имени через бэкенд планировщика текущей ОС
22
+ * (schtasks / crontab / launchd). Используется цепочками задач
23
+ * (nextTaskOnSuccess / nextTaskOnError).
24
+ */
25
+ async function triggerTask(taskName) {
26
+ try {
27
+ await createSchedulerBackend().runTask(taskName);
28
+ return true;
29
+ }
30
+ catch (err) {
31
+ console.error(`[windows-scheduler] Не удалось запустить задачу цепочки "${taskName}": ${err instanceof Error ? err.message : String(err)}`);
32
+ return false;
33
+ }
34
+ }
35
+ async function loadRetryState() {
36
+ const raw = getSetting(RETRY_STATE_KEY, {});
37
+ return raw && typeof raw === "object" && !Array.isArray(raw) ? raw : {};
38
+ }
39
+ async function writeRetryState(state) {
40
+ setSetting(RETRY_STATE_KEY, state);
41
+ }
42
+ async function clearRetryState(taskName) {
43
+ const state = await loadRetryState();
44
+ const key = Object.keys(state).find((k) => k.toLowerCase() === taskName.toLowerCase());
45
+ if (!key)
46
+ return;
47
+ delete state[key];
48
+ await writeRetryState(state);
49
+ }
50
+ /**
51
+ * Планирует повторный запуск упавшей задачи.
52
+ *
53
+ * Сам процесс record-history вызывается из PowerShell-обёртки синхронно
54
+ * (`& node ... "), поэтому ждать задержку внутри него нельзя: обёртка
55
+ * не завершится и не снимет lock-файл. Вместо этого запускаем отдельный
56
+ * detached-процесс, который спит retryDelay секунд и вызывает schtasks /run.
57
+ */
58
+ async function scheduleRetry(taskName) {
59
+ try {
60
+ const { count, delay } = await loadRetryConfig(taskName);
61
+ if (count <= 0)
62
+ return false;
63
+ const state = await loadRetryState();
64
+ const key = taskName.toLowerCase();
65
+ const remaining = Object.prototype.hasOwnProperty.call(state, key)
66
+ ? Number(state[key]) || 0
67
+ : count;
68
+ if (remaining <= 0) {
69
+ await clearRetryState(taskName);
70
+ console.log(`[windows-scheduler] Повторы для "${taskName}" исчерпаны.`);
71
+ return false;
72
+ }
73
+ state[key] = remaining - 1;
74
+ await writeRetryState(state);
75
+ const script = process.argv[1];
76
+ if (!script)
77
+ return false;
78
+ // Отвязываем дочерний процесс от текущего: родитель (PowerShell) должен
79
+ // завершиться сразу, а повтор — сработать позже независимо от него.
80
+ const child = spawn(process.execPath, [script, "--retry", taskName, String(delay)], {
81
+ detached: true,
82
+ stdio: "ignore",
83
+ windowsHide: true,
84
+ });
85
+ child.unref();
86
+ console.log(`[windows-scheduler] Задача "${taskName}" будет повторена через ${delay} с ` +
87
+ `(осталось повторов: ${remaining - 1}).`);
88
+ return true;
89
+ }
90
+ catch (err) {
91
+ console.error(`[windows-scheduler] Не удалось запланировать повтор "${taskName}": ${err instanceof Error ? err.message : String(err)}`);
92
+ return false;
93
+ }
94
+ }
95
+ /**
96
+ * Режим `--retry <taskName> <delaySec>`: ждёт задержку и запускает задачу
97
+ * через бэкенд планировщика. Статус исхода запишет уже сама обёртка задачи.
98
+ */
99
+ async function runRetry(taskName, delaySec) {
100
+ if (!taskName)
101
+ process.exit(1);
102
+ const delay = Math.max(1, Math.floor(Number(delaySec) || 60));
103
+ await new Promise((resolve) => setTimeout(resolve, delay * 1000));
104
+ try {
105
+ await createSchedulerBackend().runTask(taskName);
106
+ console.log(`[windows-scheduler] Повторный запуск задачи "${taskName}".`);
107
+ }
108
+ catch (err) {
109
+ console.error(`[windows-scheduler] Повторный запуск "${taskName}" не удался: ${err instanceof Error ? err.message : String(err)}`);
110
+ }
111
+ }
112
+ /**
113
+ * Возвращает имена задач из БД, которые пора запустить после успешного
114
+ * завершения `completedTask` (DAG-зависимости).
115
+ *
116
+ * Правила:
117
+ * - у задачи есть непустой dependsOn, и в нём упомянута completedTask;
118
+ * - каждая зависимость имеет в истории последнюю запись со статусом success;
119
+ * - зависимая задача ещё НЕ запускалась после завершения своих зависимостей
120
+ * (иначе граф зациклится и будет перезапускать её на каждом завершении).
121
+ */
122
+ export function selectDependentsToTrigger(completedTask, definitions, history) {
123
+ const key = (value) => value.trim().toLowerCase();
124
+ // История хранится от новых к старым: первая запись задачи — самая свежая.
125
+ const latestByTask = new Map();
126
+ for (const record of history) {
127
+ const k = key(record.taskName);
128
+ if (!latestByTask.has(k))
129
+ latestByTask.set(k, record);
130
+ }
131
+ const toTrigger = [];
132
+ const defsByKey = new Map();
133
+ for (const definition of definitions) {
134
+ defsByKey.set(key(definition.name), definition);
135
+ }
136
+ for (const definition of definitions) {
137
+ const deps = (Array.isArray(definition.dependsOn) ? definition.dependsOn : [])
138
+ .map((dep) => (typeof dep === "string" ? dep.trim() : ""))
139
+ .filter(Boolean);
140
+ if (deps.length === 0)
141
+ continue;
142
+ if (key(definition.name) === key(completedTask))
143
+ continue;
144
+ if (!deps.some((dep) => key(dep) === key(completedTask)))
145
+ continue;
146
+ let allSuccess = true;
147
+ let latestDependencyFinished = 0;
148
+ for (const dep of deps) {
149
+ // Matrix (Спринт 15): зависимость-матрица считается выполненной только
150
+ // когда успешны ВСЕ её клоны (у самого родителя истории нет).
151
+ const depDefinition = defsByKey.get(key(dep));
152
+ const clones = depDefinition?.matrix
153
+ ? definitions.filter((item) => item.matrixParentId && key(item.matrixParentId) === key(dep))
154
+ : [];
155
+ const requiredNames = clones.length > 0 ? clones.map((c) => c.name) : [dep];
156
+ for (const requiredName of requiredNames) {
157
+ const record = latestByTask.get(key(requiredName));
158
+ if (!record || record.status !== "success") {
159
+ allSuccess = false;
160
+ break;
161
+ }
162
+ const finished = new Date(record.finishedAt ?? 0).getTime();
163
+ if (Number.isFinite(finished)) {
164
+ latestDependencyFinished = Math.max(latestDependencyFinished, finished);
165
+ }
166
+ }
167
+ if (!allSuccess)
168
+ break;
169
+ }
170
+ if (!allSuccess)
171
+ continue;
172
+ // Защита от повторного запуска: если зависимая задача уже стартовала
173
+ // после успешного завершения последней зависимости — не трогаем её.
174
+ const own = latestByTask.get(key(definition.name));
175
+ if (own) {
176
+ const ownStarted = new Date(own.startedAt).getTime();
177
+ if (Number.isFinite(ownStarted) && ownStarted >= latestDependencyFinished) {
178
+ continue;
179
+ }
180
+ }
181
+ toTrigger.push(definition.name);
182
+ }
183
+ // Приоритеты: при готовности нескольких задач первыми запускаем более важные.
184
+ const priorityByTask = new Map();
185
+ for (const definition of definitions) {
186
+ priorityByTask.set(key(definition.name), Number(definition.priority) || 5);
187
+ }
188
+ return toTrigger.sort((a, b) => (priorityByTask.get(key(b)) ?? 5) - (priorityByTask.get(key(a)) ?? 5));
189
+ }
190
+ async function main() {
191
+ const [, , first, second, third, fourth, fifth, sixth, seventh, eighth, ninth, tenth, eleventh,] = process.argv;
192
+ // Режим повтора: node record-history.js --retry "<task>" <delaySec>
193
+ if (first === "--retry") {
194
+ await runRetry(second, Number(third));
195
+ return;
196
+ }
197
+ const parseOptionalNumber = (value) => {
198
+ if (!value || value === "-")
199
+ return undefined;
200
+ const num = Number(value);
201
+ return Number.isFinite(num) && num > 0 ? num : undefined;
202
+ };
203
+ const parseHookStatus = (value) => {
204
+ if (!value || value === "-")
205
+ return undefined;
206
+ if (value === "success" || value === "error" || value === "skipped")
207
+ return value;
208
+ return undefined;
209
+ };
210
+ /**
211
+ * Режим старта: node record-history.js --start "<task>" "<startedAtIso>"
212
+ * Создаёт незавершённую запись (finished_at = NULL) и печатает её id.
213
+ * Обёртка передаёт id в --finish; если процесс убили, останется NULL и
214
+ * crash recovery при следующем старте плагина пометит запись как error.
215
+ */
216
+ if (first === "--start") {
217
+ const taskName = second;
218
+ if (!taskName)
219
+ process.exit(1);
220
+ const startedAt = third ?? new Date().toISOString();
221
+ const definition = getTask(taskName);
222
+ const runId = startRun(taskName, startedAt, definition?.workspaceId ?? null, definition?.allowedTools ?? null, definition?.deniedTools ?? null);
223
+ console.log(String(runId));
224
+ return;
225
+ }
226
+ /**
227
+ * Режим завершения: --finish <id> <task> <status> <durationMs> <error>
228
+ * <tokens> <cost> <model> <preFlight> <postFlight>
229
+ */
230
+ if (first === "--finish") {
231
+ const runId = Number(second);
232
+ const taskName = third;
233
+ const status = fourth;
234
+ if (!Number.isFinite(runId) || runId <= 0 || !taskName || !status) {
235
+ process.exit(1);
236
+ }
237
+ const durationMs = Number(fifth) || 0;
238
+ const error = sixth !== undefined ? sixth : null;
239
+ const tokens = parseOptionalNumber(seventh);
240
+ const costUsd = parseOptionalNumber(eighth);
241
+ const model = ninth && ninth !== "-" ? ninth.trim() || undefined : undefined;
242
+ const preFlightStatus = parseHookStatus(tenth);
243
+ const postFlightStatus = parseHookStatus(eleventh);
244
+ const st = status === "success" ? "success" : status === "timeout" ? "timeout" : "error";
245
+ const definition = getTask(taskName);
246
+ const chainTarget = st === "success"
247
+ ? definition?.nextTaskOnSuccess || null
248
+ : definition?.nextTaskOnError || null;
249
+ const completed = finishRun(runId, st, durationMs, error, chainTarget, tokens, costUsd, model, preFlightStatus, postFlightStatus);
250
+ if (!completed) {
251
+ console.error(`[windows-scheduler] record-history: запись #${runId} уже завершена или не найдена.`);
252
+ return;
253
+ }
254
+ await handleCompletion(taskName, st, chainTarget, error, durationMs);
255
+ return;
256
+ }
257
+ // Обратная совместимость: старый режим без --start.
258
+ const taskName = first;
259
+ const status = second;
260
+ if (!taskName || !status) {
261
+ process.exit(1);
262
+ }
263
+ const startedAt = third ?? new Date().toISOString();
264
+ const durationMs = Number(fourth) || 0;
265
+ const error = fifth !== undefined ? fifth : null;
266
+ // Токены и стоимость приходят из PowerShell-обёртки (ps-wrapper.ts).
267
+ // "-" означает «данных нет» (openCode не печатал usage в лог).
268
+ const tokens = parseOptionalNumber(sixth);
269
+ const costUsd = parseOptionalNumber(seventh);
270
+ // Восьмой аргумент — модель; "-" означает, что модель не задана.
271
+ const model = eighth && eighth !== "-" ? eighth.trim() || undefined : undefined;
272
+ // Девятый и десятый — итоги pre/post-flight хуков.
273
+ const preFlightStatus = parseHookStatus(ninth);
274
+ const postFlightStatus = parseHookStatus(tenth);
275
+ const st = status === "success" ? "success" : status === "timeout" ? "timeout" : "error";
276
+ const definition = getTask(taskName);
277
+ const chainTarget = st === "success"
278
+ ? definition?.nextTaskOnSuccess || null
279
+ : definition?.nextTaskOnError || null;
280
+ recordRun(taskName, st, startedAt, durationMs, error, chainTarget, tokens, costUsd, model, preFlightStatus, postFlightStatus, new Date().toISOString(), definition?.workspaceId ?? null, definition?.allowedTools ?? null, definition?.deniedTools ?? null);
281
+ await handleCompletion(taskName, st, chainTarget, error, durationMs);
282
+ }
283
+ /**
284
+ * Общая пост-обработка завершённого запуска: уведомление, цепочки задач,
285
+ * DAG-зависимости и повторы. Используется и legacy-режимом, и --finish.
286
+ */
287
+ async function handleCompletion(taskName, st, chainTarget, error, durationMs) {
288
+ // Уведомление о завершении (webhook). Ошибки отправки логируются внутри
289
+ // и не влияют на историю, цепочки и повторы.
290
+ await notifyTaskCompletion(taskName, st, durationMs, error);
291
+ // Matrix (Спринт 15): клон завершился — двигаем sequential-цепочку или
292
+ // очередь concurrency-лимита (Спринт 17), а когда все клоны готовы —
293
+ // фиксируем агрегат и запускаем matrix-complete.
294
+ try {
295
+ await advanceMatrixAfterClone(taskName);
296
+ await finalizeMatrixIfComplete(taskName);
297
+ }
298
+ catch (err) {
299
+ console.log(`[matrix] ${taskName}: ошибка обработки матрицы: ${err instanceof Error ? err.message : String(err)}`);
300
+ }
301
+ if (st === "success") {
302
+ // Успешный запуск сбрасывает счётчик повторов.
303
+ await clearRetryState(taskName);
304
+ if (chainTarget) {
305
+ const started = await triggerTask(chainTarget);
306
+ if (started) {
307
+ console.log(`[windows-scheduler] Запущена следующая задача в цепочке: ${chainTarget}`);
308
+ }
309
+ }
310
+ // DAG: после успеха проверяем задачи, у которых эта задача — одна из
311
+ // зависимостей. Запускаем только если ВСЕ зависимости уже успешны и
312
+ // зависимая задача ещё не запускалась после их завершения.
313
+ try {
314
+ const history = getHistory(null, 200);
315
+ const definitions = listTasks();
316
+ const dependents = selectDependentsToTrigger(taskName, definitions, history);
317
+ for (const dependent of dependents) {
318
+ const started = await triggerTask(dependent);
319
+ if (started) {
320
+ console.log(`[windows-scheduler] DAG: все зависимости выполнены, запущена задача "${dependent}".`);
321
+ }
322
+ }
323
+ }
324
+ catch (err) {
325
+ console.error(`[windows-scheduler] DAG: не удалось запустить зависимые задачи: ${err instanceof Error ? err.message : String(err)}`);
326
+ }
327
+ }
328
+ else {
329
+ // Сначала пытаемся повторить саму задачу; компенсирующая задача запускается
330
+ // только когда повторы исчерпаны (или не настроены).
331
+ const retryScheduled = await scheduleRetry(taskName);
332
+ if (!retryScheduled && chainTarget) {
333
+ const started = await triggerTask(chainTarget);
334
+ if (started) {
335
+ console.log(`[windows-scheduler] Запущена компенсирующая задача: ${chainTarget}`);
336
+ }
337
+ }
338
+ }
339
+ }
340
+ /**
341
+ * Скрипт вызывается и как CLI (node record-history.js ...), и импортируется
342
+ * тестами. main() запускаем только при прямом вызове файла.
343
+ */
344
+ function isDirectInvocation() {
345
+ const entry = process.argv[1];
346
+ if (!entry)
347
+ return false;
348
+ try {
349
+ return (pathToFileURL(entry).href.toLowerCase() === import.meta.url.toLowerCase());
350
+ }
351
+ catch {
352
+ return false;
353
+ }
354
+ }
355
+ if (isDirectInvocation()) {
356
+ main().catch((err) => {
357
+ console.error(`[windows-scheduler] record-history: не удалось записать результат запуска: ${err instanceof Error ? err.message : String(err)}`);
358
+ process.exit(1);
359
+ });
360
+ }
@@ -0,0 +1,29 @@
1
+ import { type PruneHistoryResult } from "../db/history-repo.js";
2
+ /** Период автоочистки: раз в сутки. */
3
+ export declare const CLEANUP_INTERVAL_MS: number;
4
+ /** Переопределения лимитов для одного прогона `cleanup_history`. */
5
+ export interface RetentionOverrides {
6
+ retentionDays?: number;
7
+ maxRecords?: number;
8
+ }
9
+ export interface RetentionReport extends PruneHistoryResult {
10
+ retentionDays: number;
11
+ maxRecords: number;
12
+ /** Удалось ли выполнить PRAGMA incremental_vacuum. */
13
+ vacuumed: boolean;
14
+ /** Причина, по которой очистка пропущена (лимиты выключены). */
15
+ skipped: string | null;
16
+ ranAt: string;
17
+ }
18
+ /**
19
+ * Выполняет очистку истории по текущим настройкам.
20
+ * Переопределения (если переданы) сохраняются в settings.json — так
21
+ * `cleanup_history` заодно настраивает ретеншн.
22
+ */
23
+ export declare function runHistoryRetention(overrides?: RetentionOverrides): Promise<RetentionReport>;
24
+ /**
25
+ * Автоочистка при старте плагина: не чаще одного раза в сутки.
26
+ * `force` игнорирует интервал (используется в тестах).
27
+ */
28
+ export declare function maybeRunHistoryRetention(force?: boolean): Promise<RetentionReport | undefined>;
29
+ //# sourceMappingURL=retention.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"retention.d.ts","sourceRoot":"","sources":["../../src/core/retention.ts"],"names":[],"mappings":"AAiBA,OAAO,EAIL,KAAK,kBAAkB,EACxB,MAAM,uBAAuB,CAAC;AAE/B,uCAAuC;AACvC,eAAO,MAAM,mBAAmB,QAAsB,CAAC;AAEvD,oEAAoE;AACpE,MAAM,WAAW,kBAAkB;IACjC,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,eAAgB,SAAQ,kBAAkB;IACzD,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;IACnB,sDAAsD;IACtD,QAAQ,EAAE,OAAO,CAAC;IAClB,gEAAgE;IAChE,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,KAAK,EAAE,MAAM,CAAC;CACf;AAsBD;;;;GAIG;AACH,wBAAsB,mBAAmB,CACvC,SAAS,GAAE,kBAAuB,GACjC,OAAO,CAAC,eAAe,CAAC,CAoD1B;AAED;;;GAGG;AACH,wBAAsB,wBAAwB,CAC5C,KAAK,UAAQ,GACZ,OAAO,CAAC,eAAe,GAAG,SAAS,CAAC,CAUtC"}
@@ -0,0 +1,98 @@
1
+ /**
2
+ * Ретеншн истории (Спринт 18).
3
+ *
4
+ * Раз в сутки (и по запросу `cleanup_history`) плагин чистит сырую историю
5
+ * запусков: удаляет записи старше `history.retentionDays` и всё, что выходит
6
+ * за `history.maxRecords`. Агрегированные метрики (таблица metrics) при этом
7
+ * не меняются — «Всего запусков» и суммарная стоимость остаются корректными.
8
+ *
9
+ * Очистка никогда не удаляет незавершённые запуски (`finished_at IS NULL`):
10
+ * их обрабатывает crash recovery.
11
+ */
12
+ import { defaultHistorySettings, loadSettings, saveSettings, } from "../settings.js";
13
+ import { countHistory, pruneHistory, vacuumHistory, } from "../db/history-repo.js";
14
+ /** Период автоочистки: раз в сутки. */
15
+ export const CLEANUP_INTERVAL_MS = 24 * 60 * 60 * 1000;
16
+ /** Приводит переопределение к безопасному целому (>= 0) или undefined. */
17
+ function normalizeOverride(value) {
18
+ if (value === undefined || value === null)
19
+ return undefined;
20
+ const n = Number(value);
21
+ if (!Number.isFinite(n))
22
+ return undefined;
23
+ const int = Math.floor(n);
24
+ return int >= 0 ? int : undefined;
25
+ }
26
+ function effectiveLimits(settings, overrides) {
27
+ return {
28
+ retentionDays: normalizeOverride(overrides.retentionDays) ?? settings.retentionDays,
29
+ maxRecords: normalizeOverride(overrides.maxRecords) ?? settings.maxRecords,
30
+ };
31
+ }
32
+ /**
33
+ * Выполняет очистку истории по текущим настройкам.
34
+ * Переопределения (если переданы) сохраняются в settings.json — так
35
+ * `cleanup_history` заодно настраивает ретеншн.
36
+ */
37
+ export async function runHistoryRetention(overrides = {}) {
38
+ const settings = await loadSettings();
39
+ const base = settings.history ?? defaultHistorySettings();
40
+ const limits = effectiveLimits(base, overrides);
41
+ const ranAt = new Date().toISOString();
42
+ const shouldPersistLimits = normalizeOverride(overrides.retentionDays) !== undefined ||
43
+ normalizeOverride(overrides.maxRecords) !== undefined;
44
+ if (limits.retentionDays === 0 && limits.maxRecords === 0) {
45
+ const report = {
46
+ deletedByAge: 0,
47
+ deletedByCount: 0,
48
+ deleted: 0,
49
+ kept: countHistory(),
50
+ cutoff: null,
51
+ retentionDays: 0,
52
+ maxRecords: 0,
53
+ vacuumed: false,
54
+ skipped: "Ретеншн выключен: history.retentionDays и history.maxRecords равны 0.",
55
+ ranAt,
56
+ };
57
+ if (shouldPersistLimits) {
58
+ await saveSettings({ history: { ...base, ...limits, lastCleanupAt: ranAt, lastCleanupDeleted: 0 } });
59
+ }
60
+ return report;
61
+ }
62
+ const pruned = pruneHistory({
63
+ retentionDays: limits.retentionDays,
64
+ maxRecords: limits.maxRecords,
65
+ });
66
+ const vacuumed = pruned.deleted > 0 ? vacuumHistory() : false;
67
+ await saveSettings({
68
+ history: {
69
+ ...base,
70
+ ...limits,
71
+ lastCleanupAt: ranAt,
72
+ lastCleanupDeleted: pruned.deleted,
73
+ },
74
+ });
75
+ return {
76
+ ...pruned,
77
+ retentionDays: limits.retentionDays,
78
+ maxRecords: limits.maxRecords,
79
+ vacuumed,
80
+ skipped: null,
81
+ ranAt,
82
+ };
83
+ }
84
+ /**
85
+ * Автоочистка при старте плагина: не чаще одного раза в сутки.
86
+ * `force` игнорирует интервал (используется в тестах).
87
+ */
88
+ export async function maybeRunHistoryRetention(force = false) {
89
+ const settings = await loadSettings();
90
+ const history = settings.history ?? defaultHistorySettings();
91
+ if (!force && history.lastCleanupAt) {
92
+ const last = new Date(history.lastCleanupAt).getTime();
93
+ if (Number.isFinite(last) && Date.now() - last < CLEANUP_INTERVAL_MS) {
94
+ return undefined;
95
+ }
96
+ }
97
+ return await runHistoryRetention();
98
+ }
@@ -0,0 +1,20 @@
1
+ import type { SchedulerBackend } from "./types.js";
2
+ export type { SchedulerBackend, CreateTaskOptions, RunTaskResult, TriggerType, } from "./types.js";
3
+ export { WindowsScheduler, SchtasksError, WINDOWS_TASK_PREFIX } from "./windows.js";
4
+ export { LinuxScheduler } from "./linux.js";
5
+ export { MacScheduler } from "./mac.js";
6
+ export { TaskRegistry } from "./registry.js";
7
+ export type { RegistryEntry } from "./registry.js";
8
+ /**
9
+ * Фабрика бэкендов планировщика по платформе.
10
+ *
11
+ * - win32 → WindowsScheduler (schtasks);
12
+ * - darwin → MacScheduler (launchd);
13
+ * - linux (и прочие POSIX) → LinuxScheduler (crontab).
14
+ */
15
+ export declare function createSchedulerBackend(platform?: NodeJS.Platform): SchedulerBackend;
16
+ /** Возвращает общий (закэшированный) бэкенд текущей платформы. */
17
+ export declare function getSchedulerBackend(): SchedulerBackend;
18
+ /** Название планировщика для текущей платформы (для GUI/логов). */
19
+ export declare function getSchedulerTitle(platform?: NodeJS.Platform): string;
20
+ //# sourceMappingURL=index.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/scheduler/index.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAEnD,YAAY,EACV,gBAAgB,EAChB,iBAAiB,EACjB,aAAa,EACb,WAAW,GACZ,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,gBAAgB,EAAE,aAAa,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AACpF,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAC5C,OAAO,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AACxC,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAC7C,YAAY,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAEnD;;;;;;GAMG;AACH,wBAAgB,sBAAsB,CACpC,QAAQ,GAAE,MAAM,CAAC,QAA2B,GAC3C,gBAAgB,CAIlB;AAID,kEAAkE;AAClE,wBAAgB,mBAAmB,IAAI,gBAAgB,CAGtD;AAED,mEAAmE;AACnE,wBAAgB,iBAAiB,CAAC,QAAQ,GAAE,MAAM,CAAC,QAA2B,GAAG,MAAM,CAEtF"}
@@ -0,0 +1,32 @@
1
+ import { WindowsScheduler } from "./windows.js";
2
+ import { LinuxScheduler } from "./linux.js";
3
+ import { MacScheduler } from "./mac.js";
4
+ export { WindowsScheduler, SchtasksError, WINDOWS_TASK_PREFIX } from "./windows.js";
5
+ export { LinuxScheduler } from "./linux.js";
6
+ export { MacScheduler } from "./mac.js";
7
+ export { TaskRegistry } from "./registry.js";
8
+ /**
9
+ * Фабрика бэкендов планировщика по платформе.
10
+ *
11
+ * - win32 → WindowsScheduler (schtasks);
12
+ * - darwin → MacScheduler (launchd);
13
+ * - linux (и прочие POSIX) → LinuxScheduler (crontab).
14
+ */
15
+ export function createSchedulerBackend(platform = process.platform) {
16
+ if (platform === "win32")
17
+ return new WindowsScheduler();
18
+ if (platform === "darwin")
19
+ return new MacScheduler();
20
+ return new LinuxScheduler();
21
+ }
22
+ let cached = null;
23
+ /** Возвращает общий (закэшированный) бэкенд текущей платформы. */
24
+ export function getSchedulerBackend() {
25
+ if (!cached)
26
+ cached = createSchedulerBackend();
27
+ return cached;
28
+ }
29
+ /** Название планировщика для текущей платформы (для GUI/логов). */
30
+ export function getSchedulerTitle(platform = process.platform) {
31
+ return createSchedulerBackend(platform).title;
32
+ }
@@ -0,0 +1,32 @@
1
+ import { PosixSchedulerBase } from "./posix.js";
2
+ import type { RegistryEntry } from "./registry.js";
3
+ /**
4
+ * Бэкенд планировщика Linux на основе пользовательского crontab.
5
+ *
6
+ * Все задачи плагина живут в одном управляемом блоке:
7
+ * # >>> opencode-scheduler >>>
8
+ * # task: <имя>
9
+ * <cron> /bin/bash '<обёртка>' >> '<лог>' 2>&1
10
+ * # <<< opencode-scheduler <<<
11
+ * При паузе строка задачи комментируется ("# PAUSED: ..."), при удалении —
12
+ * блок перегенерируется из реестра.
13
+ */
14
+ export declare class LinuxScheduler extends PosixSchedulerBase {
15
+ readonly platform: NodeJS.Platform;
16
+ readonly title = "OpenCode Scheduler";
17
+ constructor();
18
+ private cronLine;
19
+ private renderBlock;
20
+ /** Читает текущий crontab (пустая строка, если crontab ещё не создан). */
21
+ private readCrontab;
22
+ /** Убирает управляемый блок плагина из текста crontab. */
23
+ private stripBlock;
24
+ /** Записывает crontab через stdin: `crontab -`. */
25
+ private writeCrontab;
26
+ /** Перегенерирует блок плагина из реестра. */
27
+ private rebuildCrontab;
28
+ protected installEntry(_entry: RegistryEntry): Promise<void>;
29
+ protected uninstallEntry(_entry: RegistryEntry): Promise<void>;
30
+ protected applyPause(_entry: RegistryEntry, _paused: boolean): Promise<void>;
31
+ }
32
+ //# sourceMappingURL=linux.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"linux.d.ts","sourceRoot":"","sources":["../../../src/core/scheduler/linux.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,kBAAkB,EAAc,MAAM,YAAY,CAAC;AAC5D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAOnD;;;;;;;;;;GAUG;AACH,qBAAa,cAAe,SAAQ,kBAAkB;IACpD,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC,QAAQ,CAAW;IAC7C,QAAQ,CAAC,KAAK,wBAAwB;;IAMtC,OAAO,CAAC,QAAQ;IAUhB,OAAO,CAAC,WAAW;IAYnB,0EAA0E;YAC5D,WAAW;IAYzB,0DAA0D;IAC1D,OAAO,CAAC,UAAU;IAkBlB,mDAAmD;YACrC,YAAY;IAgB1B,8CAA8C;YAChC,cAAc;cAYZ,YAAY,CAAC,MAAM,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC;cAIlD,cAAc,CAAC,MAAM,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC;cAIpD,UAAU,CAAC,MAAM,EAAE,aAAa,EAAE,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;CAGnF"}