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,252 @@
1
+ /**
2
+ * Dry-Run (Спринт 14): симуляция конвейера задачи без реального запуска.
3
+ *
4
+ * Строит топологический порядок зависимостей, показывает фактические команды,
5
+ * cwd, роли (ограничения инструментов) и оценки по последним запускам.
6
+ * Никогда не исполняет команды — только анализ определений.
7
+ */
8
+ import fs from "node:fs";
9
+ import { loadTaskDefinitions } from "../task-transfer.js";
10
+ import { getHistory } from "../db/history-repo.js";
11
+ import { getWorkspace } from "../workspaces.js";
12
+ import { expandMatrixTask } from "./matrix.js";
13
+ /** Сколько последних успешных/любых запусков усредняем для оценки. */
14
+ const ESTIMATE_SAMPLE = 10;
15
+ /** Средняя цена за 1K токенов (должна совпадать с dashboards/server.ts). */
16
+ export const ESTIMATED_COST_PER_1K_TOKENS_USD = 0.003;
17
+ /** Опасные паттерны, о которых обязательно предупреждаем. */
18
+ const DANGEROUS_PATTERNS = [
19
+ { test: /rm\s+-rf\s+\/(?:\s|$)/, message: "возможна рекурсивная очистка корня файловой системы (`rm -rf /`)" },
20
+ { test: /git\s+push\s+.*--force(?:\s|$)/, message: "принудительный push в git (`git push --force`)" },
21
+ ];
22
+ /**
23
+ * Симулирует конвейер задачи: сама задача + все зависимости (dependsOn)
24
+ * в топологическом порядке. Возвращает отчёт без реального запуска.
25
+ */
26
+ export async function simulatePipeline(taskName) {
27
+ const warnings = [];
28
+ const allDefs = await loadTaskDefinitions();
29
+ const rootLower = taskName.trim().toLowerCase();
30
+ const root = allDefs.find((d) => d.name.toLowerCase() === rootLower);
31
+ if (!root) {
32
+ throw new Error(`Задача "${taskName}" не найдена.`);
33
+ }
34
+ // Собираем подграф зависимостей рекурсивно, обнаруживая циклы.
35
+ const byLower = new Map(allDefs.map((d) => [d.name.toLowerCase(), d]));
36
+ const visited = new Map(); // lower -> def
37
+ const visiting = new Set();
38
+ const warningsPerTask = new Map();
39
+ const collect = (lowerName) => {
40
+ if (visiting.has(lowerName)) {
41
+ const list = warningsPerTask.get(lowerName) ?? [];
42
+ list.push(`Обнаружена циклическая зависимость вокруг задачи "${lowerName}" — конвейер разорван на этом узле.`);
43
+ warningsPerTask.set(lowerName, list);
44
+ return undefined;
45
+ }
46
+ const cached = visited.get(lowerName);
47
+ if (cached)
48
+ return cached;
49
+ const def = byLower.get(lowerName);
50
+ if (!def) {
51
+ const list = warningsPerTask.get(lowerName) ?? [];
52
+ list.push(`Зависимость "${lowerName}" не найдена среди задач — узел пропущен.`);
53
+ warningsPerTask.set(lowerName, list);
54
+ return undefined;
55
+ }
56
+ visiting.add(lowerName);
57
+ for (const dep of def.dependsOn ?? []) {
58
+ const depLower = (dep ?? "").trim().toLowerCase();
59
+ if (depLower)
60
+ collect(depLower);
61
+ }
62
+ visiting.delete(lowerName);
63
+ visited.set(lowerName, def);
64
+ return def;
65
+ };
66
+ collect(root.name.toLowerCase());
67
+ // Топологический порядок: сначала зависимости (Kahn поверх собранного подграфа).
68
+ const ordered = [];
69
+ {
70
+ const pending = [...visited.values()];
71
+ const emitted = new Set();
72
+ let progress = true;
73
+ while (pending.length > 0 && progress) {
74
+ progress = false;
75
+ for (let i = 0; i < pending.length; i++) {
76
+ const def = pending[i];
77
+ const deps = (def.dependsOn ?? []).map((d) => (d ?? "").trim().toLowerCase()).filter(Boolean);
78
+ const unmet = deps.filter((d) => visited.has(d) && !emitted.has(d));
79
+ if (unmet.length === 0) {
80
+ ordered.push(def);
81
+ emitted.add(def.name.toLowerCase());
82
+ pending.splice(i, 1);
83
+ i--;
84
+ progress = true;
85
+ }
86
+ }
87
+ }
88
+ // Если остались (цикл), добавляем как есть — предупреждение уже записано.
89
+ for (const leftover of pending)
90
+ ordered.push(leftover);
91
+ }
92
+ const history = getHistory(null, 1000);
93
+ const historyByTask = new Map();
94
+ for (const record of history) {
95
+ const list = historyByTask.get(record.taskName.toLowerCase()) ?? [];
96
+ list.push(record);
97
+ historyByTask.set(record.taskName.toLowerCase(), list);
98
+ }
99
+ const tasks = [];
100
+ let totalDuration = 0;
101
+ let totalCost = 0;
102
+ let totalTokens = 0;
103
+ // Matrix (Спринт 15): родитель сам не выполняется — вместо него в отчёте
104
+ // показываем клоны, по одному на workspace, с их cwd и оценками.
105
+ const units = [];
106
+ for (const def of ordered) {
107
+ if (def.matrix) {
108
+ try {
109
+ const clones = expandMatrixTask(def);
110
+ warnings.push(`[${def.name}] Родитель матрицы не выполняется сам — показаны ${clones.length} клон(а/ов) по workspace.`);
111
+ for (const clone of clones)
112
+ units.push({ def: clone, matrixParent: def.name });
113
+ }
114
+ catch (err) {
115
+ const list = warningsPerTask.get(def.name.toLowerCase()) ?? [];
116
+ list.push(`Матрица не может быть развёрнута: ${err instanceof Error ? err.message : String(err)}`);
117
+ warningsPerTask.set(def.name.toLowerCase(), list);
118
+ warnings.push(`[${def.name}] ${list[list.length - 1]}`);
119
+ }
120
+ continue;
121
+ }
122
+ units.push({ def });
123
+ }
124
+ // Родители матриц с параллельной стратегией: их клоны считаются max, не sum.
125
+ const parallelMatrixParents = new Set(allDefs
126
+ .filter((d) => d.matrix && (d.matrix.strategy ?? "parallel") !== "sequential")
127
+ .map((d) => d.name.toLowerCase()));
128
+ const parallelGroups = new Map();
129
+ for (let index = 0; index < units.length; index++) {
130
+ const { def, matrixParent } = units[index];
131
+ const lower = def.name.toLowerCase();
132
+ const taskWarnings = warningsPerTask.get(lower) ?? [];
133
+ // cwd: workspace имеет приоритет над workingDirectory (как в schedulerCreateTask).
134
+ const workspace = def.workspaceId ? getWorkspace(def.workspaceId) : undefined;
135
+ const cwd = workspace?.path || def.workingDirectory || def.workdir || "";
136
+ if (!cwd) {
137
+ taskWarnings.push("Рабочая директория не задана явно — будет использована папка текущего проекта.");
138
+ }
139
+ else {
140
+ try {
141
+ const stat = fs.statSync(cwd);
142
+ if (!stat.isDirectory()) {
143
+ taskWarnings.push(`Путь "${cwd}" существует, но не является директорией.`);
144
+ }
145
+ }
146
+ catch {
147
+ taskWarnings.push(`Рабочая директория "${cwd}" не существует на диске.`);
148
+ }
149
+ }
150
+ // Триггер: корневая задача (или клон корневой матрицы) — manual,
151
+ // остальные попали в конвейер через dependsOn — dag.
152
+ const trigger = lower === rootLower || (matrixParent && matrixParent.toLowerCase() === rootLower)
153
+ ? "manual"
154
+ : "dag";
155
+ // Команда, которую выполнит обёртка.
156
+ const modelArg = def.model ? ` --model ${def.model}` : "";
157
+ const promptPreview = (def.prompt ?? "").replace(/\s+/g, " ").trim();
158
+ const command = `opencode run${modelArg} "${promptPreview}"`;
159
+ // Оценки: среднее по последним ESTIMATE_SAMPLE записям истории.
160
+ const records = (historyByTask.get(lower) ?? []).filter((r) => r.status === "success");
161
+ let estimatedDurationSec = null;
162
+ let estimatedCostUsd = null;
163
+ let estimatedTokens = null;
164
+ if (records.length === 0) {
165
+ taskWarnings.push("Нет успешных запусков в истории — оценка длительности/токенов/стоимости недоступна.");
166
+ }
167
+ else {
168
+ const sample = records.slice(0, ESTIMATE_SAMPLE);
169
+ const avg = (pick) => {
170
+ const values = sample.map(pick).filter((v) => typeof v === "number" && Number.isFinite(v));
171
+ return values.length > 0 ? values.reduce((a, b) => a + b, 0) / values.length : null;
172
+ };
173
+ const avgMs = avg((r) => r.durationMs);
174
+ if (avgMs != null)
175
+ estimatedDurationSec = Math.round(avgMs / 100) / 10;
176
+ estimatedTokens = avg((r) => r.tokens) ?? null;
177
+ if (estimatedTokens != null) {
178
+ estimatedCostUsd = (estimatedTokens / 1000) * ESTIMATED_COST_PER_1K_TOKENS_USD;
179
+ }
180
+ }
181
+ // Проверяем опасные паттерны в промпте и хуках.
182
+ const scanned = [def.prompt, def.beforeScript, def.afterScript, def.qualityGate]
183
+ .filter((s) => typeof s === "string")
184
+ .join("\n")
185
+ .toLowerCase();
186
+ for (const { test, message } of DANGEROUS_PATTERNS) {
187
+ if (test.test(scanned)) {
188
+ taskWarnings.push(`Опасный паттерн: ${message}.`);
189
+ }
190
+ }
191
+ const roleScoped = Array.isArray(def.allowedTools) && def.allowedTools.length > 0
192
+ ? { allowed: def.allowedTools, denied: def.deniedTools }
193
+ : Array.isArray(def.deniedTools) && def.deniedTools.length > 0
194
+ ? { allowed: undefined, denied: def.deniedTools }
195
+ : null;
196
+ tasks.push({
197
+ name: def.name,
198
+ order: index,
199
+ trigger,
200
+ cwd,
201
+ command,
202
+ workspace: workspace ? { name: workspace.name, path: workspace.path } : undefined,
203
+ preFlight: def.beforeScript ?? null,
204
+ postFlight: def.afterScript ?? null,
205
+ qualityGate: def.qualityGate ?? null,
206
+ roleScoped,
207
+ estimatedDurationSec,
208
+ estimatedCostUsd: estimatedCostUsd != null ? Math.round(estimatedCostUsd * 10000) / 10000 : null,
209
+ estimatedTokens: estimatedTokens != null ? Math.round(estimatedTokens) : null,
210
+ ...(matrixParent ? { matrixParent } : {}),
211
+ });
212
+ if (taskWarnings.length > 0) {
213
+ for (const warning of taskWarnings) {
214
+ warnings.push(`[${def.name}] ${warning}`);
215
+ }
216
+ }
217
+ // Суммируем оценки (null не ломает сумму). Для параллельных матриц
218
+ // длительность берём максимумом по группе, а не суммой клонов.
219
+ if (matrixParent && parallelMatrixParents.has(matrixParent.toLowerCase())) {
220
+ const key = matrixParent.toLowerCase();
221
+ const current = parallelGroups.get(key) ?? { maxDuration: 0 };
222
+ current.maxDuration = Math.max(current.maxDuration, estimatedDurationSec ?? 0);
223
+ parallelGroups.set(key, current);
224
+ }
225
+ else if (totalDuration != null) {
226
+ totalDuration = totalDuration + (estimatedDurationSec ?? 0);
227
+ }
228
+ if (totalTokens != null)
229
+ totalTokens = totalTokens + (estimatedTokens ?? 0);
230
+ if (totalCost != null)
231
+ totalCost = totalCost + (estimatedCostUsd ?? 0);
232
+ }
233
+ for (const group of parallelGroups.values()) {
234
+ if (totalDuration != null)
235
+ totalDuration = totalDuration + group.maxDuration;
236
+ }
237
+ const hasAnyEstimate = tasks.some((t) => t.estimatedDurationSec != null || t.estimatedCostUsd != null || t.estimatedTokens != null);
238
+ const totals = hasAnyEstimate
239
+ ? {
240
+ estimatedDurationSec: totalDuration != null ? Math.round(totalDuration * 10) / 10 : null,
241
+ estimatedCostUsd: totalCost != null ? Math.round(totalCost * 10000) / 10000 : null,
242
+ estimatedTokens: totalTokens != null ? Math.round(totalTokens) : null,
243
+ }
244
+ : { estimatedDurationSec: null, estimatedCostUsd: null, estimatedTokens: null };
245
+ return {
246
+ success: true,
247
+ taskName: root.name,
248
+ tasks,
249
+ totals,
250
+ warnings,
251
+ };
252
+ }
@@ -0,0 +1,31 @@
1
+ /**
2
+ * Задержка между последним изменением файла и запуском задачи.
3
+ * Нужна потому, что редакторы часто пишут файл несколькими порциями
4
+ * (truncate + write + rename) — без дебаунса задача стартовала бы 3-5 раз.
5
+ */
6
+ export declare const FILE_TRIGGER_DEBOUNCE_MS = 2000;
7
+ export type FileTriggerHandler = (taskName: string, changedPath: string) => void | Promise<void>;
8
+ /**
9
+ * Менеджер файловых триггеров: держит по одному chokidar- watcher'у на задачу
10
+ * с triggerType === "file" и пересобирает их при изменении tasks.json.
11
+ */
12
+ export declare class FileWatchManager {
13
+ private readonly handler;
14
+ private readonly debounceMs;
15
+ private entries;
16
+ private stopped;
17
+ constructor(handler: FileTriggerHandler, debounceMs?: number);
18
+ /** Сколько задач сейчас отслеживается. */
19
+ get size(): number;
20
+ /**
21
+ * Перечитывает tasks.json и приводит набор watcher'ов в соответствие:
22
+ * новые задачи добавляются, удалённые/изменённые — закрываются.
23
+ * Возвращает количество активных файловых триггеров.
24
+ */
25
+ refresh(): Promise<number>;
26
+ /** Закрывает все watcher'ы (вызывается при выгрузке плагина). */
27
+ stop(): Promise<void>;
28
+ private add;
29
+ private remove;
30
+ }
31
+ //# sourceMappingURL=file-watcher.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"file-watcher.d.ts","sourceRoot":"","sources":["../../src/core/file-watcher.ts"],"names":[],"mappings":"AAGA;;;;GAIG;AACH,eAAO,MAAM,wBAAwB,OAAO,CAAC;AAE7C,MAAM,MAAM,kBAAkB,GAAG,CAC/B,QAAQ,EAAE,MAAM,EAChB,WAAW,EAAE,MAAM,KAChB,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;AAY1B;;;GAGG;AACH,qBAAa,gBAAgB;IAKzB,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,OAAO,CAAC,QAAQ,CAAC,UAAU;IAL7B,OAAO,CAAC,OAAO,CAAkC;IACjD,OAAO,CAAC,OAAO,CAAS;gBAGL,OAAO,EAAE,kBAAkB,EAC3B,UAAU,GAAE,MAAiC;IAGhE,0CAA0C;IAC1C,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED;;;;OAIG;IACG,OAAO,IAAI,OAAO,CAAC,MAAM,CAAC;IAkChC,iEAAiE;IAC3D,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAO3B,OAAO,CAAC,GAAG;YAkEG,MAAM;CAcrB"}
@@ -0,0 +1,128 @@
1
+ import { watch } from "chokidar";
2
+ import { loadTaskDefinitions } from "../task-transfer.js";
3
+ /**
4
+ * Задержка между последним изменением файла и запуском задачи.
5
+ * Нужна потому, что редакторы часто пишут файл несколькими порциями
6
+ * (truncate + write + rename) — без дебаунса задача стартовала бы 3-5 раз.
7
+ */
8
+ export const FILE_TRIGGER_DEBOUNCE_MS = 2000;
9
+ /**
10
+ * Менеджер файловых триггеров: держит по одному chokidar- watcher'у на задачу
11
+ * с triggerType === "file" и пересобирает их при изменении tasks.json.
12
+ */
13
+ export class FileWatchManager {
14
+ constructor(handler, debounceMs = FILE_TRIGGER_DEBOUNCE_MS) {
15
+ this.handler = handler;
16
+ this.debounceMs = debounceMs;
17
+ this.entries = new Map();
18
+ this.stopped = false;
19
+ }
20
+ /** Сколько задач сейчас отслеживается. */
21
+ get size() {
22
+ return this.entries.size;
23
+ }
24
+ /**
25
+ * Перечитывает tasks.json и приводит набор watcher'ов в соответствие:
26
+ * новые задачи добавляются, удалённые/изменённые — закрываются.
27
+ * Возвращает количество активных файловых триггеров.
28
+ */
29
+ async refresh() {
30
+ if (this.stopped)
31
+ return 0;
32
+ const definitions = await loadTaskDefinitions();
33
+ const wanted = definitions
34
+ .filter((d) => d.triggerType === "file" &&
35
+ typeof d.watchPath === "string" &&
36
+ d.watchPath.trim().length > 0)
37
+ .map((d) => ({ name: d.name.trim(), path: d.watchPath.trim() }))
38
+ .filter((d) => d.name.length > 0);
39
+ const wantedKeys = new Set(wanted.map((d) => d.name.toLowerCase()));
40
+ // Убираем watcher'ы для задач, которых больше нет или у которых сменился путь.
41
+ for (const [key, entry] of Array.from(this.entries.entries())) {
42
+ const target = wanted.find((d) => d.name.toLowerCase() === key);
43
+ if (!target || target.path !== entry.path) {
44
+ await this.remove(key);
45
+ }
46
+ }
47
+ // Добавляем новые.
48
+ for (const item of wanted) {
49
+ const key = item.name.toLowerCase();
50
+ if (this.entries.has(key) || !wantedKeys.has(key))
51
+ continue;
52
+ this.add(item.name, item.path);
53
+ }
54
+ return this.entries.size;
55
+ }
56
+ /** Закрывает все watcher'ы (вызывается при выгрузке плагина). */
57
+ async stop() {
58
+ this.stopped = true;
59
+ for (const key of Array.from(this.entries.keys())) {
60
+ await this.remove(key);
61
+ }
62
+ }
63
+ add(name, watchPath) {
64
+ let watcher;
65
+ try {
66
+ watcher = watch(watchPath, {
67
+ // Не считаем уже существующий файл «изменением» при старте.
68
+ ignoreInitial: true,
69
+ // Следим за одним файлом/папкой, без рекурсии в глубину.
70
+ depth: 0,
71
+ // Файлы могут быть большими: дождёмся, пока запись успокоится.
72
+ awaitWriteFinish: { stabilityThreshold: 500, pollInterval: 100 },
73
+ ignorePermissionErrors: true,
74
+ });
75
+ }
76
+ catch (err) {
77
+ console.error(`[windows-scheduler] Не удалось начать отслеживание "${watchPath}" для задачи "${name}": ${err instanceof Error ? err.message : String(err)}`);
78
+ return;
79
+ }
80
+ const entry = { name, path: watchPath, watcher, timer: null };
81
+ watcher.on("change", (changedPath) => {
82
+ if (this.stopped)
83
+ return;
84
+ if (entry.timer)
85
+ clearTimeout(entry.timer);
86
+ entry.timer = setTimeout(() => {
87
+ entry.timer = null;
88
+ if (this.stopped)
89
+ return;
90
+ try {
91
+ const result = this.handler(name, changedPath);
92
+ if (result && typeof result.catch === "function") {
93
+ result.catch((err) => {
94
+ console.error(`[windows-scheduler] Ошибка запуска задачи "${name}" по изменению файла: ${err instanceof Error ? err.message : String(err)}`);
95
+ });
96
+ }
97
+ }
98
+ catch (err) {
99
+ console.error(`[windows-scheduler] Ошибка запуска задачи "${name}" по изменению файла: ${err instanceof Error ? err.message : String(err)}`);
100
+ }
101
+ }, this.debounceMs);
102
+ // Таймер не должен удерживать процесс, если хост завершается.
103
+ if (typeof entry.timer.unref === "function")
104
+ entry.timer.unref();
105
+ });
106
+ watcher.on("error", (err) => {
107
+ console.error(`[windows-scheduler] Ошибка наблюдения за "${watchPath}" (задача "${name}"): ${err?.message ?? String(err)}`);
108
+ });
109
+ this.entries.set(name.toLowerCase(), entry);
110
+ console.log(`[windows-scheduler] Слежу за "${watchPath}" — задача "${name}" запускается при изменении файла.`);
111
+ }
112
+ async remove(key) {
113
+ const entry = this.entries.get(key);
114
+ if (!entry)
115
+ return;
116
+ this.entries.delete(key);
117
+ if (entry.timer) {
118
+ clearTimeout(entry.timer);
119
+ entry.timer = null;
120
+ }
121
+ try {
122
+ await entry.watcher.close();
123
+ }
124
+ catch {
125
+ // watcher уже мог быть закрыт — не критично.
126
+ }
127
+ }
128
+ }
@@ -0,0 +1,43 @@
1
+ /**
2
+ * Менеджер файловых блокировок для предотвращения наложения запусков одной задачи.
3
+ *
4
+ * Блокировка реализуется через атомарное создание файла с флагом 'wx' (exclusive create).
5
+ * Если файл уже существует — блокировка удерживается другим запуском.
6
+ * После завершения задачи файл удаляется.
7
+ * Зависшие блокировки (старше STALE_LOCK_MAX_AGE_MS) удаляются при инициализации.
8
+ */
9
+ export declare class LockManager {
10
+ private readonly lockDir;
11
+ constructor(lockDir?: string);
12
+ /** Имя lock-файла для задачи. */
13
+ private lockFileName;
14
+ /** Полный путь к lock-файлу задачи. */
15
+ private lockFilePath;
16
+ /**
17
+ * Инициализация директории блокировок и очистка зависших (старых) файлов.
18
+ * Вызывается при старте плагина.
19
+ */
20
+ initialize(): Promise<void>;
21
+ /**
22
+ * Пытается захватить блокировку для задачи.
23
+ * Возвращает true, если блокировка захвачена (файл создан).
24
+ * Возвращает false, если блокировка уже удерживается другим запуском.
25
+ */
26
+ acquire(taskName: string): Promise<boolean>;
27
+ /**
28
+ * Освобождает блокировку задачи (удаляет lock-файл).
29
+ * Не выбрасывает ошибку, если файл уже удалён.
30
+ */
31
+ release(taskName: string): Promise<void>;
32
+ /**
33
+ * Проверяет, удерживается ли блокировка задачей в данный момент.
34
+ */
35
+ isLocked(taskName: string): Promise<boolean>;
36
+ }
37
+ /**
38
+ * Выполняет функцию с захватом файловых блокировок.
39
+ * Если блокировка уже удерживается — пропускает выполнение и возвращает null.
40
+ * Гарантирует освобождение блокировки в finally (включая при ошибках).
41
+ */
42
+ export declare function withLock<T>(lockManager: LockManager, taskName: string, fn: () => Promise<T>): Promise<T | null>;
43
+ //# sourceMappingURL=lock.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"lock.d.ts","sourceRoot":"","sources":["../../src/core/lock.ts"],"names":[],"mappings":"AAIA;;;;;;;GAOG;AACH,qBAAa,WAAW;IACtB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;gBAErB,OAAO,GAAE,MAAiB;IAItC,iCAAiC;IACjC,OAAO,CAAC,YAAY;IAIpB,uCAAuC;IACvC,OAAO,CAAC,YAAY;IAIpB;;;OAGG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IA2BjC;;;;OAIG;IACG,OAAO,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAgBjD;;;OAGG;IACG,OAAO,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAS9C;;OAEG;IACG,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;CAUnD;AAED;;;;GAIG;AACH,wBAAsB,QAAQ,CAAC,CAAC,EAC9B,WAAW,EAAE,WAAW,EACxB,QAAQ,EAAE,MAAM,EAChB,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GACnB,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC,CAenB"}
@@ -0,0 +1,118 @@
1
+ import fs from "node:fs/promises";
2
+ import path from "node:path";
3
+ import { LOCK_DIR, STALE_LOCK_MAX_AGE_MS } from "../types.js";
4
+ /**
5
+ * Менеджер файловых блокировок для предотвращения наложения запусков одной задачи.
6
+ *
7
+ * Блокировка реализуется через атомарное создание файла с флагом 'wx' (exclusive create).
8
+ * Если файл уже существует — блокировка удерживается другим запуском.
9
+ * После завершения задачи файл удаляется.
10
+ * Зависшие блокировки (старше STALE_LOCK_MAX_AGE_MS) удаляются при инициализации.
11
+ */
12
+ export class LockManager {
13
+ constructor(lockDir = LOCK_DIR) {
14
+ this.lockDir = lockDir;
15
+ }
16
+ /** Имя lock-файла для задачи. */
17
+ lockFileName(taskName) {
18
+ return `${taskName}.lock`;
19
+ }
20
+ /** Полный путь к lock-файлу задачи. */
21
+ lockFilePath(taskName) {
22
+ return path.join(this.lockDir, this.lockFileName(taskName));
23
+ }
24
+ /**
25
+ * Инициализация директории блокировок и очистка зависших (старых) файлов.
26
+ * Вызывается при старте плагина.
27
+ */
28
+ async initialize() {
29
+ await fs.mkdir(this.lockDir, { recursive: true });
30
+ const files = await fs.readdir(this.lockDir).catch(() => []);
31
+ const now = Date.now();
32
+ for (const file of files) {
33
+ if (!file.endsWith(".lock"))
34
+ continue;
35
+ const fullPath = path.join(this.lockDir, file);
36
+ try {
37
+ const stat = await fs.stat(fullPath);
38
+ const age = now - stat.mtimeMs;
39
+ if (age > STALE_LOCK_MAX_AGE_MS) {
40
+ await fs.unlink(fullPath).catch(() => { });
41
+ // eslint-disable-next-line no-console
42
+ console.log(`[windows-scheduler] Удалён зависший lock-файл: ${file} (возраст ${Math.round(age / 1000)} с)`);
43
+ }
44
+ }
45
+ catch {
46
+ // Игнорируем ошибки чтения отдельных файлов при очистке.
47
+ }
48
+ }
49
+ }
50
+ /**
51
+ * Пытается захватить блокировку для задачи.
52
+ * Возвращает true, если блокировка захвачена (файл создан).
53
+ * Возвращает false, если блокировка уже удерживается другим запуском.
54
+ */
55
+ async acquire(taskName) {
56
+ await fs.mkdir(this.lockDir, { recursive: true });
57
+ const lockPath = this.lockFilePath(taskName);
58
+ try {
59
+ // 'wx' — exclusive create: ошибка если файл уже существует.
60
+ await fs.writeFile(lockPath, String(Date.now()), { flag: "wx" });
61
+ return true;
62
+ }
63
+ catch (err) {
64
+ if (err.code === "EEXIST") {
65
+ return false;
66
+ }
67
+ throw err;
68
+ }
69
+ }
70
+ /**
71
+ * Освобождает блокировку задачи (удаляет lock-файл).
72
+ * Не выбрасывает ошибку, если файл уже удалён.
73
+ */
74
+ async release(taskName) {
75
+ const lockPath = this.lockFilePath(taskName);
76
+ try {
77
+ await fs.unlink(lockPath);
78
+ }
79
+ catch (err) {
80
+ if (err.code !== "ENOENT")
81
+ throw err;
82
+ }
83
+ }
84
+ /**
85
+ * Проверяет, удерживается ли блокировка задачей в данный момент.
86
+ */
87
+ async isLocked(taskName) {
88
+ const lockPath = this.lockFilePath(taskName);
89
+ try {
90
+ await fs.stat(lockPath);
91
+ return true;
92
+ }
93
+ catch (err) {
94
+ if (err.code === "ENOENT")
95
+ return false;
96
+ throw err;
97
+ }
98
+ }
99
+ }
100
+ /**
101
+ * Выполняет функцию с захватом файловых блокировок.
102
+ * Если блокировка уже удерживается — пропускает выполнение и возвращает null.
103
+ * Гарантирует освобождение блокировки в finally (включая при ошибках).
104
+ */
105
+ export async function withLock(lockManager, taskName, fn) {
106
+ const acquired = await lockManager.acquire(taskName);
107
+ if (!acquired) {
108
+ // eslint-disable-next-line no-console
109
+ console.log(`[windows-scheduler] Запуск задачи "${taskName}" пропущен: удерживается активная блокировка.`);
110
+ return null;
111
+ }
112
+ try {
113
+ return await fn();
114
+ }
115
+ finally {
116
+ await lockManager.release(taskName);
117
+ }
118
+ }