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,648 @@
1
+ import fs from "node:fs/promises";
2
+ import path from "node:path";
3
+ import { PLUGIN_DIR, sanitizeName } from "./types.js";
4
+ import type { ScheduledTaskInfo } from "./types.js";
5
+ import {
6
+ listTasks,
7
+ saveTask,
8
+ deleteTask,
9
+ } from "./db/tasks-repo.js";
10
+
11
+ /** Триггер задачи по событию из MCP-шины. */
12
+ export interface McpEventTrigger {
13
+ /** Имя MCP-сервера/источника (например, "github", "jira"). */
14
+ server: string;
15
+ /** Имя события (например, "github.pr.opened"). */
16
+ event: string;
17
+ /** Необязательный фильтр: `repo="my-project"` или regex. */
18
+ filter?: string;
19
+ }
20
+
21
+ /**
22
+ * Переопределения для конкретного workspace внутри матрицы (Спринт 17).
23
+ * Позволяют задать отдельный промпт/модель/хуки/QG для одного клона.
24
+ */
25
+ export interface MatrixWorkspaceOverride {
26
+ prompt?: string;
27
+ model?: string;
28
+ qualityGate?: string;
29
+ beforeScript?: string;
30
+ afterScript?: string;
31
+ }
32
+
33
+ /**
34
+ * Matrix (fan-out, Спринт 15): одна задача-шаблон раскладывается на N клонов,
35
+ * по одному на каждый workspace. Родитель сам не выполняется — он управляет
36
+ * клонами и агрегирует их результаты.
37
+ */
38
+ export interface MatrixConfig {
39
+ /** Список workspace id, по одному клону на каждый. Пустой запрещён. */
40
+ workspaceIds: string[];
41
+ /** Стратегия запуска клонов (по умолчанию parallel). */
42
+ strategy?: "parallel" | "sequential";
43
+ /** Поведение при ошибке клона (по умолчанию continue). */
44
+ failureMode?: "continue" | "stop";
45
+ /** Как агрегировать результат (по умолчанию summary). */
46
+ aggregation?: "summary" | "per-task";
47
+ /** Создавать ли виртуальную задачу matrix-complete (агрегатор). */
48
+ createAggregator?: boolean;
49
+ /**
50
+ * Максимум одновременно выполняющихся клонов этой матрицы (Спринт 17).
51
+ * Действует поверх глобального maxConcurrent. Для sequential всегда 1.
52
+ */
53
+ concurrency?: number;
54
+ /**
55
+ * Per-workspace переопределения промпта/модели/хуков/QG (Спринт 17).
56
+ * Ключи — workspaceId из workspaceIds.
57
+ */
58
+ overrides?: Record<string, MatrixWorkspaceOverride>;
59
+ }
60
+
61
+ /**
62
+ * Определение задачи, которое сохраняется при создании и используется
63
+ * для экспорта/импорта. В schtasks нельзя надёжно прочитать исходный
64
+ * cron и промпт, поэтому храним их рядом с плагином.
65
+ */
66
+ export interface TaskDefinition {
67
+ name: string;
68
+ schedule: string;
69
+ prompt: string;
70
+ timeoutSeconds?: number;
71
+ /**
72
+ * LLM-модель в формате OpenCode (например, "anthropic/claude-3-5-sonnet",
73
+ * "openai/gpt-4o"). Если не задана — используется модель по умолчанию OpenCode.
74
+ */
75
+ model?: string;
76
+ /**
77
+ * Приоритет задачи от 0 до 10 (10 — наивысший). Влияет на порядок запуска
78
+ * готовых задач (catch-up и DAG-зависимости). По умолчанию — 5 (Обычный).
79
+ */
80
+ priority?: number;
81
+ /**
82
+ * Рабочая директория задачи. Если не задана, обёртка запускает задачу
83
+ * в папке проекта (process.cwd() / директория воркспейса OpenCode),
84
+ * благодаря чему `opencode run` подхватывает opencode.json с MCP-серверами.
85
+ */
86
+ workingDirectory?: string;
87
+ /**
88
+ * Привязка к multi-repo workspace. Если задана, cwd задачи = path workspace,
89
+ * а workingDirectory игнорируется (с предупреждением в логе).
90
+ */
91
+ workspaceId?: string;
92
+ /** @deprecated Старое имя поля; поддерживается только при чтении/импорте. */
93
+ workdir?: string;
94
+ /** Сколько раз повторять задачу при ошибке (0 — не повторять). */
95
+ retryCount?: number;
96
+ /** Задержка перед повтором в секундах. */
97
+ retryDelay?: number;
98
+ /** Проверочная команда, выполняемая после успешного ответа ИИ. */
99
+ qualityGate?: string;
100
+ /** Команда перед запуском (pre-flight). Ненулевой код отменяет задачу. */
101
+ beforeScript?: string;
102
+ /** Команда после запуска (post-flight). Выполняется даже при ошибке задачи. */
103
+ afterScript?: string;
104
+ /** Задача, запускаемая при успешном завершении этой задачи. */
105
+ nextTaskOnSuccess?: string;
106
+ /** Компенсирующая задача, запускаемая при ошибке этой задачи. */
107
+ nextTaskOnError?: string;
108
+ /**
109
+ * DAG-зависимости: имена задач, которые должны успешно завершиться,
110
+ * прежде чем эта задача будет запущена. Пустой массив — без зависимостей.
111
+ */
112
+ dependsOn?: string[];
113
+ /**
114
+ * Чем запускается задача: по расписанию ("cron", по умолчанию) или
115
+ * при изменении файла ("file"). Для "file" расписание не используется.
116
+ */
117
+ triggerType?: "cron" | "file" | "mcp-event";
118
+ /** Путь к файлу/папке, изменения которого запускают задачу (для triggerType === "file"). */
119
+ watchPath?: string;
120
+ /** Параметры MCP-события (для triggerType === "mcp-event"). */
121
+ mcpEvent?: McpEventTrigger;
122
+ /**
123
+ * Ограничения инструментов (role-scoped tools): список разрешённых инструментов
124
+ * OpenCode. Пустой массив отклоняется (нет смысла — «запрещено всё»).
125
+ * Пока opencode run не поддерживает флаги allow/deny — metadata-only.
126
+ */
127
+ allowedTools?: string[];
128
+ /** Запрещённые инструменты. При конфликте denied выигрывает у allowed. */
129
+ deniedTools?: string[];
130
+ /** Настройки fan-out матрицы (родитель). */
131
+ matrix?: MatrixConfig;
132
+ /** Для клона матрицы — имя родительской задачи-шаблона. */
133
+ matrixParentId?: string;
134
+ /**
135
+ * Внутреннее поле матрицы (Спринт 17): очередь клонов, ожидающих запуска
136
+ * из-за ограничения matrix.concurrency. Хранится в определении родителя,
137
+ * чтобы переживать перезапуск плагина. Экспортируется как обычные данные,
138
+ * но не входит в matrix.overrides и не используется клонами.
139
+ */
140
+ matrixQueue?: string[];
141
+ /** Для родителя матрицы — true (флаг для фильтров/DAG). */
142
+ isMatrixParent?: boolean;
143
+ /** Когда задача была создана — защита от ложного catch-up сразу после создания. */
144
+ createdAt?: string;
145
+ }
146
+
147
+ const PREFIX = "\\OpenCode\\windows-scheduler\\";
148
+
149
+ /** Приоритет по умолчанию — «Обычный». */
150
+ export const DEFAULT_PRIORITY = 5;
151
+ /** Максимальный приоритет (10 — «Критический»). */
152
+ export const MAX_PRIORITY = 10;
153
+
154
+ /**
155
+ * Приводит приоритет к целому числу 0..10.
156
+ * Возвращает undefined, если значение не задано или не является числом.
157
+ */
158
+ export function normalizePriority(value: unknown): number | undefined {
159
+ if (typeof value !== "number" || !Number.isFinite(value)) return undefined;
160
+ return Math.min(MAX_PRIORITY, Math.max(0, Math.floor(value)));
161
+ }
162
+
163
+ /** Человекочитаемая подпись приоритета для GUI/дашборда. */
164
+ export function priorityLabel(priority?: number): string {
165
+ const value = normalizePriority(priority) ?? DEFAULT_PRIORITY;
166
+ if (value >= 10) return "Критический";
167
+ if (value >= 8) return "Высокий";
168
+ if (value <= 3) return "Низкий";
169
+ return "Обычный";
170
+ }
171
+
172
+ /**
173
+ * Читает определения задач из SQLite.
174
+ * Сигнатура сохранена: вызывающий код не знает, JSON это или БД.
175
+ */
176
+ export async function loadTaskDefinitions(): Promise<TaskDefinition[]> {
177
+ return listTasks();
178
+ }
179
+
180
+ /** Добавляет или обновляет определение задачи (сравнение по имени без учёта регистра). */
181
+ export async function saveTaskDefinition(definition: TaskDefinition): Promise<void> {
182
+ saveTask(definition);
183
+ }
184
+
185
+ /** Удаляет определение задачи из хранилища. */
186
+ export async function removeTaskDefinition(name: string): Promise<void> {
187
+ deleteTask(name);
188
+ }
189
+
190
+ /** Убирает префикс папки плагина из полного имени задачи. */
191
+ export function stripTaskPrefix(fullName: string): string {
192
+ return fullName.startsWith(PREFIX) ? fullName.slice(PREFIX.length) : fullName;
193
+ }
194
+
195
+ /**
196
+ * Собирает JSON для экспорта.
197
+ *
198
+ * Расписание и промпт берутся из tasks.json; для задач, созданных до появления
199
+ * хранилища, промпт подхватывается из файла prompts/<sanitized>.txt.
200
+ * Если расписания нет, оно останется пустым — импорт такую запись пропустит.
201
+ */
202
+ export async function buildExportJson(
203
+ tasks: ScheduledTaskInfo[]
204
+ ): Promise<{ data: string; count: number }> {
205
+ const definitions = await loadTaskDefinitions();
206
+ const byName = new Map(
207
+ definitions.map((item) => [item.name.toLowerCase(), item])
208
+ );
209
+
210
+ const exported: TaskDefinition[] = [];
211
+ for (const task of tasks) {
212
+ const name = stripTaskPrefix(task.taskName ?? "");
213
+ if (!name) continue;
214
+
215
+ const definition = byName.get(name.toLowerCase());
216
+
217
+ let prompt = definition?.prompt ?? "";
218
+ if (!prompt) {
219
+ try {
220
+ prompt = (
221
+ await fs.readFile(
222
+ path.join(PLUGIN_DIR, "prompts", `${sanitizeName(name)}.txt`),
223
+ "utf8"
224
+ )
225
+ ).replace(/^\uFEFF/, "");
226
+ } catch {
227
+ // Промпт не найден — экспортируем пустой, импорт пропустит запись.
228
+ }
229
+ }
230
+
231
+ exported.push({
232
+ name,
233
+ schedule: definition?.schedule ?? "",
234
+ prompt,
235
+ ...(definition?.timeoutSeconds !== undefined
236
+ ? { timeoutSeconds: definition.timeoutSeconds }
237
+ : {}),
238
+ ...(definition?.model ? { model: definition.model } : {}),
239
+ ...(definition?.priority !== undefined
240
+ ? { priority: definition.priority }
241
+ : {}),
242
+ ...(definition?.workingDirectory
243
+ ? { workingDirectory: definition.workingDirectory }
244
+ : {}),
245
+ ...(definition?.workspaceId ? { workspaceId: definition.workspaceId } : {}),
246
+ ...(definition?.retryCount !== undefined
247
+ ? { retryCount: definition.retryCount }
248
+ : {}),
249
+ ...(definition?.retryDelay !== undefined
250
+ ? { retryDelay: definition.retryDelay }
251
+ : {}),
252
+ ...(definition?.qualityGate ? { qualityGate: definition.qualityGate } : {}),
253
+ ...(definition?.beforeScript ? { beforeScript: definition.beforeScript } : {}),
254
+ ...(definition?.afterScript ? { afterScript: definition.afterScript } : {}),
255
+ ...(definition?.nextTaskOnSuccess
256
+ ? { nextTaskOnSuccess: definition.nextTaskOnSuccess }
257
+ : {}),
258
+ ...(definition?.nextTaskOnError
259
+ ? { nextTaskOnError: definition.nextTaskOnError }
260
+ : {}),
261
+ ...(Array.isArray(definition?.dependsOn) && definition.dependsOn.length > 0
262
+ ? { dependsOn: definition.dependsOn }
263
+ : {}),
264
+ ...(definition?.triggerType === "file" ? { triggerType: "file" as const } : {}),
265
+ ...(definition?.triggerType === "mcp-event"
266
+ ? { triggerType: "mcp-event" as const }
267
+ : {}),
268
+ ...(definition?.watchPath ? { watchPath: definition.watchPath } : {}),
269
+ ...(Array.isArray(definition?.allowedTools) && definition.allowedTools.length > 0
270
+ ? { allowedTools: definition.allowedTools }
271
+ : {}),
272
+ ...(Array.isArray(definition?.deniedTools) && definition.deniedTools.length > 0
273
+ ? { deniedTools: definition.deniedTools }
274
+ : {}),
275
+ ...(definition?.matrix &&
276
+ Array.isArray(definition.matrix.workspaceIds) &&
277
+ definition.matrix.workspaceIds.length > 0
278
+ ? { matrix: definition.matrix }
279
+ : {}),
280
+ ...(definition?.matrixParentId
281
+ ? { matrixParentId: definition.matrixParentId }
282
+ : {}),
283
+ ...(definition?.mcpEvent &&
284
+ definition.mcpEvent.event &&
285
+ definition.mcpEvent.server
286
+ ? {
287
+ mcpEvent: {
288
+ server: definition.mcpEvent.server,
289
+ event: definition.mcpEvent.event,
290
+ ...(definition.mcpEvent.filter
291
+ ? { filter: definition.mcpEvent.filter }
292
+ : {}),
293
+ },
294
+ }
295
+ : {}),
296
+ });
297
+ }
298
+
299
+ const payload = {
300
+ version: 1,
301
+ exportedAt: new Date().toISOString(),
302
+ tasks: exported,
303
+ };
304
+
305
+ return { data: JSON.stringify(payload, null, 2), count: exported.length };
306
+ }
307
+
308
+ export interface ParsedImport {
309
+ tasks: TaskDefinition[];
310
+ errors: string[];
311
+ }
312
+
313
+ /**
314
+ * Разбирает файл импорта. Поддерживает как { tasks: [...] }, так и просто массив.
315
+ * Ошибки отдельных записей не прерывают импорт остальных.
316
+ */
317
+ export function parseImportJson(raw: string): ParsedImport {
318
+ let parsed: unknown;
319
+ try {
320
+ parsed = JSON.parse(raw);
321
+ } catch (err: any) {
322
+ throw new Error(
323
+ `Файл не является корректным JSON: ${err?.message ?? String(err)}`
324
+ );
325
+ }
326
+
327
+ const list = Array.isArray(parsed)
328
+ ? parsed
329
+ : (parsed as { tasks?: unknown } | null)?.tasks;
330
+
331
+ if (!Array.isArray(list)) {
332
+ throw new Error("В файле нет массива задач (ожидается поле tasks).");
333
+ }
334
+ if (list.length === 0) {
335
+ throw new Error("В файле нет задач для импорта.");
336
+ }
337
+
338
+ const tasks: TaskDefinition[] = [];
339
+ const errors: string[] = [];
340
+
341
+ list.forEach((item, index) => {
342
+ const position = index + 1;
343
+ if (!item || typeof item !== "object") {
344
+ errors.push(`Запись ${position}: ожидался объект.`);
345
+ return;
346
+ }
347
+
348
+ const source = item as Record<string, unknown>;
349
+ const name = typeof source.name === "string" ? source.name.trim() : "";
350
+ const schedule =
351
+ typeof source.schedule === "string" ? source.schedule.trim() : "";
352
+ const prompt = typeof source.prompt === "string" ? source.prompt.trim() : "";
353
+ const triggerType: "cron" | "file" | "mcp-event" =
354
+ source.triggerType === "file"
355
+ ? "file"
356
+ : source.triggerType === "mcp-event"
357
+ ? "mcp-event"
358
+ : "cron";
359
+ const watchPath =
360
+ typeof source.watchPath === "string" ? source.watchPath.trim() : "";
361
+
362
+ const rawMcpEvent =
363
+ source.mcpEvent && typeof source.mcpEvent === "object"
364
+ ? (source.mcpEvent as Record<string, unknown>)
365
+ : undefined;
366
+ const mcpEvent: McpEventTrigger | undefined =
367
+ rawMcpEvent &&
368
+ typeof rawMcpEvent.event === "string" &&
369
+ rawMcpEvent.event.trim()
370
+ ? {
371
+ server:
372
+ typeof rawMcpEvent.server === "string"
373
+ ? rawMcpEvent.server.trim()
374
+ : "",
375
+ event: rawMcpEvent.event.trim(),
376
+ ...(typeof rawMcpEvent.filter === "string" && rawMcpEvent.filter.trim()
377
+ ? { filter: rawMcpEvent.filter.trim() }
378
+ : {}),
379
+ }
380
+ : undefined;
381
+
382
+ // Для файлового/MCP-триггера расписание не нужно.
383
+ // Клоны матрицы (matrixParentId) запускаются только через runMatrix(),
384
+ // поэтому watchPath для файлового триггера им не требуется.
385
+ const matrixParentHint =
386
+ typeof source.matrixParentId === "string" ? source.matrixParentId.trim() : "";
387
+ const scheduleOk = triggerType === "cron" ? Boolean(schedule) : true;
388
+ const watchOk =
389
+ triggerType === "file" ? Boolean(watchPath) || Boolean(matrixParentHint) : true;
390
+ const eventOk = triggerType === "mcp-event" ? Boolean(mcpEvent?.event) : true;
391
+
392
+ if (!name || !scheduleOk || !watchOk || !eventOk || !prompt) {
393
+ errors.push(
394
+ `Запись ${position}${name ? ` (${name})` : ""}: нужны непустые поля name и prompt` +
395
+ (triggerType === "file"
396
+ ? ", а также watchPath для файлового триггера."
397
+ : triggerType === "mcp-event"
398
+ ? ", а также mcpEvent.event для MCP-триггера."
399
+ : ", а также schedule.")
400
+ );
401
+ return;
402
+ }
403
+
404
+ const timeoutSeconds =
405
+ typeof source.timeoutSeconds === "number" &&
406
+ Number.isFinite(source.timeoutSeconds) &&
407
+ source.timeoutSeconds > 0
408
+ ? Math.floor(source.timeoutSeconds)
409
+ : undefined;
410
+
411
+ // Новое поле workingDirectory; workdir читаем для обратной совместимости.
412
+ const workingDirectory =
413
+ typeof source.workingDirectory === "string" && source.workingDirectory.trim()
414
+ ? source.workingDirectory.trim()
415
+ : typeof source.workdir === "string" && source.workdir.trim()
416
+ ? source.workdir.trim()
417
+ : undefined;
418
+
419
+ const retryCount =
420
+ typeof source.retryCount === "number" &&
421
+ Number.isFinite(source.retryCount) &&
422
+ source.retryCount > 0
423
+ ? Math.floor(source.retryCount)
424
+ : undefined;
425
+
426
+ const retryDelay =
427
+ typeof source.retryDelay === "number" &&
428
+ Number.isFinite(source.retryDelay) &&
429
+ source.retryDelay > 0
430
+ ? Math.floor(source.retryDelay)
431
+ : undefined;
432
+
433
+ const readOptionalString = (value: unknown): string | undefined =>
434
+ typeof value === "string" && value.trim() ? value.trim() : undefined;
435
+
436
+ const qualityGate = readOptionalString(source.qualityGate);
437
+ const beforeScript = readOptionalString(source.beforeScript);
438
+ const afterScript = readOptionalString(source.afterScript);
439
+ const nextTaskOnSuccess = readOptionalString(source.nextTaskOnSuccess);
440
+ const nextTaskOnError = readOptionalString(source.nextTaskOnError);
441
+ const model = readOptionalString(source.model);
442
+ const priority = normalizePriority(source.priority);
443
+ const workspaceId = readOptionalString(source.workspaceId);
444
+
445
+ // Ограничения инструментов (Спринт 14): массив непустых строк без дублей.
446
+ // Пустой allowedTools отклоняется с явной ошибкой (избегаем «запрещено всё»).
447
+ const readToolList = (raw: unknown, fieldLabel: string): string[] | undefined | "empty" => {
448
+ if (raw === undefined || raw === null) return undefined;
449
+ if (!Array.isArray(raw)) {
450
+ errors.push(`Запись ${position}${name ? ` (${name})` : ""}: ${fieldLabel} должен быть массивом строк.`);
451
+ return undefined;
452
+ }
453
+ const seen = new Set<string>();
454
+ const list: string[] = [];
455
+ for (const value of raw) {
456
+ if (typeof value !== "string") continue;
457
+ const tool = value.trim();
458
+ if (!tool || seen.has(tool.toLowerCase())) continue;
459
+ seen.add(tool.toLowerCase());
460
+ list.push(tool);
461
+ }
462
+ if (list.length === 0) return "empty";
463
+ return list;
464
+ };
465
+
466
+ const allowedRaw = readToolList(source.allowedTools, "allowedTools");
467
+ const deniedRaw = readToolList(source.deniedTools, "deniedTools");
468
+ let allowedTools: string[] | undefined;
469
+ let deniedTools: string[] | undefined;
470
+ if (allowedRaw !== undefined) {
471
+ if (allowedRaw === "empty") {
472
+ errors.push(
473
+ `Запись ${position}${name ? ` (${name})` : ""}: пустой allowedTools запрещён — ` +
474
+ `задайте список инструментов или уберите поле.`
475
+ );
476
+ } else {
477
+ allowedTools = allowedRaw;
478
+ }
479
+ }
480
+ if (deniedRaw !== undefined && deniedRaw !== "empty") {
481
+ deniedTools = deniedRaw;
482
+ }
483
+
484
+ // Matrix (fan-out, Спринт 15): список workspace id + стратегия.
485
+ // Одновременно workspaceId и matrix.workspaceIds использовать нельзя.
486
+ let matrix: MatrixConfig | undefined;
487
+ const rawMatrix = (source as { matrix?: unknown }).matrix;
488
+ if (rawMatrix !== undefined && rawMatrix !== null) {
489
+ const label = `Запись ${position}${name ? ` (${name})` : ""}`;
490
+ if (typeof rawMatrix !== "object" || Array.isArray(rawMatrix)) {
491
+ errors.push(`${label}: matrix должен быть объектом.`);
492
+ } else {
493
+ const candidate = rawMatrix as Record<string, unknown>;
494
+ if (workspaceId) {
495
+ errors.push(
496
+ `${label}: нельзя одновременно workspaceId и matrix.workspaceIds.`
497
+ );
498
+ } else {
499
+ const idsRaw = candidate.workspaceIds;
500
+ if (!Array.isArray(idsRaw)) {
501
+ errors.push(`${label}: matrix.workspaceIds должен быть массивом строк.`);
502
+ } else {
503
+ const seen = new Set<string>();
504
+ const ids: string[] = [];
505
+ for (const value of idsRaw) {
506
+ if (typeof value !== "string") continue;
507
+ const id = value.trim();
508
+ if (!id || seen.has(id.toLowerCase())) continue;
509
+ seen.add(id.toLowerCase());
510
+ ids.push(id);
511
+ }
512
+ if (ids.length === 0) {
513
+ errors.push(`${label}: matrix.workspaceIds не может быть пустым.`);
514
+ } else {
515
+ const strategy =
516
+ candidate.strategy === "sequential" ? "sequential" : "parallel";
517
+ const failureMode =
518
+ candidate.failureMode === "stop" ? "stop" : "continue";
519
+ const aggregation =
520
+ candidate.aggregation === "per-task" ? "per-task" : "summary";
521
+
522
+ // Спринт 17: ограничение параллелизма и per-workspace настройки.
523
+ let concurrency: number | undefined;
524
+ if (candidate.concurrency !== undefined && candidate.concurrency !== null) {
525
+ if (
526
+ typeof candidate.concurrency !== "number" ||
527
+ !Number.isFinite(candidate.concurrency) ||
528
+ candidate.concurrency < 1
529
+ ) {
530
+ errors.push(
531
+ `${label}: matrix.concurrency должен быть числом не меньше 1.`
532
+ );
533
+ } else {
534
+ concurrency = Math.floor(candidate.concurrency);
535
+ }
536
+ }
537
+
538
+ let overrides: Record<string, MatrixWorkspaceOverride> | undefined;
539
+ const rawOverrides = candidate.overrides;
540
+ if (rawOverrides !== undefined && rawOverrides !== null) {
541
+ if (typeof rawOverrides !== "object" || Array.isArray(rawOverrides)) {
542
+ errors.push(`${label}: matrix.overrides должен быть объектом.`);
543
+ } else {
544
+ const allowed = new Set(ids);
545
+ const parsedOverrides: Record<string, MatrixWorkspaceOverride> = {};
546
+ for (const [key, value] of Object.entries(
547
+ rawOverrides as Record<string, unknown>
548
+ )) {
549
+ const workspaceKey = key.trim();
550
+ if (!workspaceKey || !allowed.has(workspaceKey)) {
551
+ errors.push(
552
+ `${label}: matrix.overrides содержит workspace "${workspaceKey}", ` +
553
+ `которого нет в workspaceIds.`
554
+ );
555
+ continue;
556
+ }
557
+ if (typeof value !== "object" || value === null || Array.isArray(value)) {
558
+ errors.push(
559
+ `${label}: matrix.overrides["${workspaceKey}"] должен быть объектом.`
560
+ );
561
+ continue;
562
+ }
563
+ const raw = value as Record<string, unknown>;
564
+ const override: MatrixWorkspaceOverride = {};
565
+ for (const field of [
566
+ "prompt",
567
+ "model",
568
+ "qualityGate",
569
+ "beforeScript",
570
+ "afterScript",
571
+ ] as const) {
572
+ const stringValue = readOptionalString(raw[field]);
573
+ if (stringValue !== undefined) override[field] = stringValue;
574
+ }
575
+ if (Object.keys(override).length > 0) {
576
+ parsedOverrides[workspaceKey] = override;
577
+ }
578
+ }
579
+ if (Object.keys(parsedOverrides).length > 0) {
580
+ overrides = parsedOverrides;
581
+ }
582
+ }
583
+ }
584
+
585
+ matrix = {
586
+ workspaceIds: ids,
587
+ strategy,
588
+ failureMode,
589
+ aggregation,
590
+ ...(candidate.createAggregator === true
591
+ ? { createAggregator: true }
592
+ : {}),
593
+ ...(concurrency !== undefined ? { concurrency } : {}),
594
+ ...(overrides !== undefined ? { overrides } : {}),
595
+ };
596
+ }
597
+ }
598
+ }
599
+ }
600
+ }
601
+ const matrixParentId = readOptionalString(
602
+ (source as { matrixParentId?: unknown }).matrixParentId
603
+ );
604
+
605
+ // DAG-зависимости: массив непустых имён без дублей (сравнение без регистра).
606
+ let dependsOn: string[] | undefined;
607
+ if (Array.isArray(source.dependsOn)) {
608
+ const seen = new Set<string>();
609
+ const deps: string[] = [];
610
+ for (const value of source.dependsOn) {
611
+ if (typeof value !== "string") continue;
612
+ const dep = value.trim();
613
+ if (!dep || seen.has(dep.toLowerCase())) continue;
614
+ seen.add(dep.toLowerCase());
615
+ deps.push(dep);
616
+ }
617
+ if (deps.length > 0) dependsOn = deps;
618
+ }
619
+
620
+ tasks.push({
621
+ name,
622
+ schedule,
623
+ prompt,
624
+ ...(timeoutSeconds !== undefined ? { timeoutSeconds } : {}),
625
+ ...(model !== undefined ? { model } : {}),
626
+ ...(priority !== undefined ? { priority } : {}),
627
+ ...(workingDirectory !== undefined ? { workingDirectory } : {}),
628
+ ...(workspaceId !== undefined ? { workspaceId } : {}),
629
+ ...(retryCount !== undefined ? { retryCount } : {}),
630
+ ...(retryDelay !== undefined ? { retryDelay } : {}),
631
+ ...(qualityGate !== undefined ? { qualityGate } : {}),
632
+ ...(beforeScript !== undefined ? { beforeScript } : {}),
633
+ ...(afterScript !== undefined ? { afterScript } : {}),
634
+ ...(nextTaskOnSuccess !== undefined ? { nextTaskOnSuccess } : {}),
635
+ ...(nextTaskOnError !== undefined ? { nextTaskOnError } : {}),
636
+ ...(dependsOn !== undefined ? { dependsOn } : {}),
637
+ ...(triggerType === "cron" ? {} : { triggerType }),
638
+ ...(watchPath ? { watchPath } : {}),
639
+ ...(mcpEvent ? { mcpEvent } : {}),
640
+ ...(allowedTools !== undefined ? { allowedTools } : {}),
641
+ ...(deniedTools !== undefined ? { deniedTools } : {}),
642
+ ...(matrix !== undefined ? { matrix } : {}),
643
+ ...(matrixParentId !== undefined ? { matrixParentId } : {}),
644
+ });
645
+ });
646
+
647
+ return { tasks, errors };
648
+ }