opencode-windows-scheduler 1.4.0 → 1.5.1

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 (95) hide show
  1. package/CHANGELOG.md +61 -1
  2. package/LICENSE +21 -21
  3. package/README.md +26 -4
  4. package/ROADMAP-STRATEGY.md +43 -24
  5. package/ROADMAP.md +549 -31
  6. package/dist/core/dry-run.d.ts +41 -0
  7. package/dist/core/dry-run.d.ts.map +1 -1
  8. package/dist/core/dry-run.js +165 -16
  9. package/dist/core/file-watcher.d.ts.map +1 -1
  10. package/dist/core/file-watcher.js +53 -10
  11. package/dist/core/git-trigger.d.ts +80 -0
  12. package/dist/core/git-trigger.d.ts.map +1 -0
  13. package/dist/core/git-trigger.js +294 -0
  14. package/dist/core/glob.d.ts +38 -0
  15. package/dist/core/glob.d.ts.map +1 -0
  16. package/dist/core/glob.js +233 -0
  17. package/dist/core/matrix.d.ts.map +1 -1
  18. package/dist/core/matrix.js +48 -22
  19. package/dist/core/ps-wrapper.d.ts.map +1 -1
  20. package/dist/core/ps-wrapper.js +7 -0
  21. package/dist/core/schedule-gate.js +55 -30
  22. package/dist/core/schedule-v2.d.ts +29 -1
  23. package/dist/core/schedule-v2.d.ts.map +1 -1
  24. package/dist/core/schedule-v2.js +107 -17
  25. package/dist/core/scheduler/types.d.ts +7 -1
  26. package/dist/core/scheduler/types.d.ts.map +1 -1
  27. package/dist/core/scheduler/windows.d.ts +6 -2
  28. package/dist/core/scheduler/windows.d.ts.map +1 -1
  29. package/dist/core/scheduler/windows.js +25 -10
  30. package/dist/core/telegram.d.ts.map +1 -1
  31. package/dist/core/telegram.js +13 -10
  32. package/dist/core/wrappers/bash.d.ts.map +1 -1
  33. package/dist/core/wrappers/bash.js +4 -0
  34. package/dist/db/git-state-repo.d.ts +16 -0
  35. package/dist/db/git-state-repo.d.ts.map +1 -0
  36. package/dist/db/git-state-repo.js +38 -0
  37. package/dist/db/schema.d.ts +1 -1
  38. package/dist/db/schema.d.ts.map +1 -1
  39. package/dist/db/schema.js +8 -0
  40. package/dist/i18n.d.ts +52 -0
  41. package/dist/i18n.d.ts.map +1 -0
  42. package/dist/i18n.js +292 -0
  43. package/dist/index.d.ts +50 -0
  44. package/dist/index.d.ts.map +1 -1
  45. package/dist/index.js +1020 -197
  46. package/dist/notifications.d.ts.map +1 -1
  47. package/dist/notifications.js +74 -40
  48. package/dist/rpc.d.ts +238 -2
  49. package/dist/rpc.d.ts.map +1 -1
  50. package/dist/rpc.js +79 -2
  51. package/dist/server.d.ts.map +1 -1
  52. package/dist/server.js +89 -48
  53. package/dist/settings.d.ts +3 -0
  54. package/dist/settings.d.ts.map +1 -1
  55. package/dist/settings.js +20 -8
  56. package/dist/task-transfer.d.ts +43 -3
  57. package/dist/task-transfer.d.ts.map +1 -1
  58. package/dist/task-transfer.js +94 -6
  59. package/dist/templates.d.ts +1 -1
  60. package/dist/templates.d.ts.map +1 -1
  61. package/dist/types.d.ts +11 -0
  62. package/dist/types.d.ts.map +1 -1
  63. package/dist/types.js +32 -0
  64. package/docs/ARCHITECTURE.md +37 -1
  65. package/docs/FEATURES.md +70 -0
  66. package/docs/README.ru.md +19 -3
  67. package/gui-experimental.cjs +9 -4
  68. package/locales/en.json +695 -0
  69. package/locales/ru.json +695 -0
  70. package/package.json +9 -3
  71. package/scripts/test-locale.mjs +44 -0
  72. package/src/core/dry-run.ts +244 -19
  73. package/src/core/file-watcher.ts +65 -10
  74. package/src/core/git-trigger.ts +373 -0
  75. package/src/core/glob.ts +226 -0
  76. package/src/core/matrix.ts +52 -26
  77. package/src/core/ps-wrapper.ts +7 -0
  78. package/src/core/schedule-gate.ts +67 -33
  79. package/src/core/schedule-v2.ts +152 -17
  80. package/src/core/scheduler/types.ts +7 -1
  81. package/src/core/scheduler/windows.ts +25 -10
  82. package/src/core/telegram.ts +16 -10
  83. package/src/core/wrappers/bash.ts +4 -0
  84. package/src/db/git-state-repo.ts +62 -0
  85. package/src/db/schema.ts +8 -0
  86. package/src/gui.tsx +772 -456
  87. package/src/i18n.ts +339 -0
  88. package/src/index.ts +1274 -212
  89. package/src/notifications.ts +83 -42
  90. package/src/rpc.ts +79 -2
  91. package/src/server.ts +89 -48
  92. package/src/settings.ts +38 -10
  93. package/src/task-transfer.ts +148 -5
  94. package/src/templates.ts +1 -1
  95. package/src/types.ts +37 -0
@@ -8,7 +8,11 @@ import {
8
8
  deleteTask,
9
9
  } from "./db/tasks-repo.js";
10
10
  import { normalizeOneShotRunAt } from "./core/one-shot.js";
11
- import { isValidIanaTimeZone, validateLaunchWindow } from "./core/schedule-v2.js";
11
+ import {
12
+ isValidIanaTimeZone,
13
+ normalizeActiveDays,
14
+ validateLaunchWindow,
15
+ } from "./core/schedule-v2.js";
12
16
  import { isValidSessionId } from "./core/session.js";
13
17
 
14
18
  /** Триггер задачи по событию из MCP-шины. */
@@ -115,10 +119,11 @@ export interface TaskDefinition {
115
119
  dependsOn?: string[];
116
120
  /**
117
121
  * Чем запускается задача: по расписанию ("cron", по умолчанию),
118
- * при изменении файла ("file"), по MCP-событию ("mcp-event") или
119
- * однократно в runAt ("once"). Для file/mcp-event/once расписание не нужно.
122
+ * при изменении файла ("file"), по новому коммиту в git ("git"),
123
+ * по MCP-событию ("mcp-event") или однократно в runAt ("once").
124
+ * Для file/git/mcp-event/once расписание не нужно.
120
125
  */
121
- triggerType?: "cron" | "file" | "mcp-event" | "once";
126
+ triggerType?: "cron" | "file" | "git" | "mcp-event" | "once";
122
127
  /** Абсолютное время однократного запуска (ISO-8601, triggerType "once"). */
123
128
  runAt?: string;
124
129
  /**
@@ -170,8 +175,47 @@ export interface TaskDefinition {
170
175
  notBefore?: string;
171
176
  /** Конец окна запуска "HH:MM"; может быть меньше notBefore (через полночь). */
172
177
  notAfter?: string;
178
+ /**
179
+ * Разрешённые дни недели для окна и cron (Спринт 27): 0 = воскресенье … 6 = суббота.
180
+ * Пусто — все дни.
181
+ */
182
+ activeDays?: number[];
183
+ /**
184
+ * Поведение вне окна запуска или в неразрешённый день (Спринт 27):
185
+ * "postpone" (по умолчанию) — ждать открытия окна, "skip" — пропустить,
186
+ * "run" — выполнить всё равно.
187
+ */
188
+ windowPolicy?: "skip" | "postpone" | "run";
189
+ /**
190
+ * Git-триггер (Спринт 27): запускать при новых коммитах в рабочем каталоге.
191
+ * До первого запуска плагин запоминает текущий HEAD без запуска задачи.
192
+ */
193
+ gitBranch?: string;
194
+ /** Glob-маски путей через запятую: запускать только при изменениях в них. */
195
+ gitPaths?: string[];
196
+ /** Glob-маски путей, изменения в которых не считаются триггером. */
197
+ gitIgnore?: string[];
198
+ /** Период опроса git, секунды (минимум 5, по умолчанию 60). */
199
+ gitPollSeconds?: number;
200
+ /** Glob-маски файлов для triggerType "file" (Спринт 27). */
201
+ watchGlobs?: string[];
202
+ /** Glob-маски игнорируемых файлов для triggerType "file". */
203
+ watchIgnore?: string[];
173
204
  /** Пауза до даты (ISO, Спринт 19): плагин включит задачу автоматически. */
174
205
  pausedUntil?: string;
206
+ /**
207
+ * Бессрочная пауза (Спринт 27.5.8): true — задача отключена в планировщике
208
+ * без даты автовозобновления. Флаг переживает update (пересоздание) и
209
+ * degraded-режим, когда список задач ОС недоступен.
210
+ */
211
+ paused?: boolean;
212
+ /**
213
+ * Windows-режим входа (Спринт 27.5.4): true — задача запускается и без входа
214
+ * пользователя (schtasks /ru SYSTEM, session 0). По умолчанию false —
215
+ * интерактивная задача (Interactive only, только при активном входе).
216
+ * На Linux/macOS игнорируется: cron работает без входа, launchd — при входе.
217
+ */
218
+ runWhenLoggedOff?: boolean;
175
219
  /** Когда задача была создана — защита от ложного catch-up сразу после создания. */
176
220
  createdAt?: string;
177
221
  }
@@ -294,6 +338,7 @@ export async function buildExportJson(
294
338
  ? { dependsOn: definition.dependsOn }
295
339
  : {}),
296
340
  ...(definition?.triggerType === "file" ? { triggerType: "file" as const } : {}),
341
+ ...(definition?.triggerType === "git" ? { triggerType: "git" as const } : {}),
297
342
  ...(definition?.triggerType === "mcp-event"
298
343
  ? { triggerType: "mcp-event" as const }
299
344
  : {}),
@@ -317,7 +362,31 @@ export async function buildExportJson(
317
362
  ...(definition?.timezone ? { timezone: definition.timezone } : {}),
318
363
  ...(definition?.notBefore ? { notBefore: definition.notBefore } : {}),
319
364
  ...(definition?.notAfter ? { notAfter: definition.notAfter } : {}),
365
+ // Спринт 27: дни недели, политика окна и git/glob-триггеры.
366
+ ...(Array.isArray(definition?.activeDays) && definition.activeDays.length > 0
367
+ ? { activeDays: definition.activeDays }
368
+ : {}),
369
+ ...(definition?.windowPolicy ? { windowPolicy: definition.windowPolicy } : {}),
370
+ ...(definition?.gitBranch ? { gitBranch: definition.gitBranch } : {}),
371
+ ...(Array.isArray(definition?.gitPaths) && definition.gitPaths.length > 0
372
+ ? { gitPaths: definition.gitPaths }
373
+ : {}),
374
+ ...(Array.isArray(definition?.gitIgnore) && definition.gitIgnore.length > 0
375
+ ? { gitIgnore: definition.gitIgnore }
376
+ : {}),
377
+ ...(definition?.gitPollSeconds !== undefined
378
+ ? { gitPollSeconds: definition.gitPollSeconds }
379
+ : {}),
380
+ ...(Array.isArray(definition?.watchGlobs) && definition.watchGlobs.length > 0
381
+ ? { watchGlobs: definition.watchGlobs }
382
+ : {}),
383
+ ...(Array.isArray(definition?.watchIgnore) && definition.watchIgnore.length > 0
384
+ ? { watchIgnore: definition.watchIgnore }
385
+ : {}),
320
386
  ...(definition?.pausedUntil ? { pausedUntil: definition.pausedUntil } : {}),
387
+ ...(definition?.paused === true ? { paused: true } : {}),
388
+ // Спринт 27.5.10: режим входа переживает перенос между профилями.
389
+ ...(definition?.runWhenLoggedOff === true ? { runWhenLoggedOff: true } : {}),
321
390
  ...(Array.isArray(definition?.allowedTools) && definition.allowedTools.length > 0
322
391
  ? { allowedTools: definition.allowedTools }
323
392
  : {}),
@@ -402,9 +471,11 @@ export function parseImportJson(raw: string): ParsedImport {
402
471
  const schedule =
403
472
  typeof source.schedule === "string" ? source.schedule.trim() : "";
404
473
  const prompt = typeof source.prompt === "string" ? source.prompt.trim() : "";
405
- const triggerType: "cron" | "file" | "mcp-event" | "once" =
474
+ const triggerType: "cron" | "file" | "git" | "mcp-event" | "once" =
406
475
  source.triggerType === "file"
407
476
  ? "file"
477
+ : source.triggerType === "git"
478
+ ? "git"
408
479
  : source.triggerType === "mcp-event"
409
480
  ? "mcp-event"
410
481
  : source.triggerType === "once"
@@ -558,6 +629,62 @@ export function parseImportJson(raw: string): ParsedImport {
558
629
  const priority = normalizePriority(source.priority);
559
630
  const workspaceId = readOptionalString(source.workspaceId);
560
631
 
632
+ // Спринт 27: git-триггер, glob-маски и временные окна.
633
+ if (triggerType === "git" && !workspaceId && !workingDirectory) {
634
+ errors.push(
635
+ `Запись ${position}${name ? ` (${name})` : ""}: для git-триггера нужна рабочая директория (workingDirectory или workspaceId).`
636
+ );
637
+ return;
638
+ }
639
+ const readStringList = (value: unknown): string[] | undefined => {
640
+ if (!Array.isArray(value)) return undefined;
641
+ const items = value
642
+ .filter((entry): entry is string => typeof entry === "string" && Boolean(entry.trim()))
643
+ .map((entry) => entry.trim());
644
+ return items.length > 0 ? items : undefined;
645
+ };
646
+ const gitBranch = readOptionalString(source.gitBranch);
647
+ const gitPaths = readStringList(source.gitPaths);
648
+ const gitIgnore = readStringList(source.gitIgnore);
649
+ const watchGlobs = readStringList(source.watchGlobs);
650
+ const watchIgnore = readStringList(source.watchIgnore);
651
+ const gitPollSeconds =
652
+ typeof source.gitPollSeconds === "number" &&
653
+ Number.isFinite(source.gitPollSeconds) &&
654
+ source.gitPollSeconds > 0
655
+ ? Math.floor(source.gitPollSeconds)
656
+ : undefined;
657
+ const rawDays = Array.isArray(source.activeDays) ? source.activeDays : undefined;
658
+ let activeDays: number[] | undefined;
659
+ if (rawDays) {
660
+ const days = rawDays.filter(
661
+ (value): value is number =>
662
+ typeof value === "number" && Number.isInteger(value) && value >= 0 && value <= 6
663
+ );
664
+ if (days.length !== rawDays.length) {
665
+ errors.push(
666
+ `Запись ${position}${name ? ` (${name})` : ""}: activeDays должен содержать числа 0..6 (0 = воскресенье).`
667
+ );
668
+ return;
669
+ }
670
+ activeDays = normalizeActiveDays(days);
671
+ }
672
+ let windowPolicy: "skip" | "postpone" | "run" | undefined;
673
+ if (source.windowPolicy !== undefined) {
674
+ if (
675
+ source.windowPolicy === "skip" ||
676
+ source.windowPolicy === "postpone" ||
677
+ source.windowPolicy === "run"
678
+ ) {
679
+ windowPolicy = source.windowPolicy;
680
+ } else {
681
+ errors.push(
682
+ `Запись ${position}${name ? ` (${name})` : ""}: неизвестный windowPolicy «${String(source.windowPolicy)}» (ожидается skip, postpone или run).`
683
+ );
684
+ return;
685
+ }
686
+ }
687
+
561
688
  // Планирование 2.0 (Спринт 19): IANA-зона, окно запуска, пауза до даты.
562
689
  const timezone = readOptionalString(source.timezone);
563
690
  if (timezone && !isValidIanaTimeZone(timezone)) {
@@ -579,6 +706,11 @@ export function parseImportJson(raw: string): ParsedImport {
579
706
  `датой в формате ISO (например 2026-12-01T09:00:00Z).`
580
707
  );
581
708
  }
709
+ // Спринт 27.5.8: бессрочная пауза импортируется вместе с задачей.
710
+ const pausedFlag = source.paused === true;
711
+ // Спринт 27.5.10: режим входа. Только явный `true` делает задачу фоновой;
712
+ // всё остальное (false, null, строка) означает интерактивную задачу.
713
+ const runWhenLoggedOffFlag = source.runWhenLoggedOff === true;
582
714
 
583
715
  // Ограничения инструментов (Спринт 14): массив непустых строк без дублей.
584
716
  // Пустой allowedTools отклоняется с явной ошибкой (избегаем «запрещено всё»).
@@ -781,7 +913,18 @@ export function parseImportJson(raw: string): ParsedImport {
781
913
  ...(timezone !== undefined ? { timezone } : {}),
782
914
  ...(notBefore !== undefined ? { notBefore } : {}),
783
915
  ...(notAfter !== undefined ? { notAfter } : {}),
916
+ ...(activeDays !== undefined ? { activeDays } : {}),
917
+ ...(windowPolicy !== undefined ? { windowPolicy } : {}),
918
+ ...(gitBranch !== undefined ? { gitBranch } : {}),
919
+ ...(gitPaths !== undefined ? { gitPaths } : {}),
920
+ ...(gitIgnore !== undefined ? { gitIgnore } : {}),
921
+ ...(gitPollSeconds !== undefined ? { gitPollSeconds } : {}),
922
+ ...(watchGlobs !== undefined ? { watchGlobs } : {}),
923
+ ...(watchIgnore !== undefined ? { watchIgnore } : {}),
784
924
  ...(pausedUntil !== undefined ? { pausedUntil } : {}),
925
+ ...(pausedFlag ? { paused: true } : {}),
926
+ // Спринт 27.5.10: сохраняем режим входа при переносе задачи.
927
+ ...(runWhenLoggedOffFlag ? { runWhenLoggedOff: true } : {}),
785
928
  ...(mcpEvent ? { mcpEvent } : {}),
786
929
  ...(allowedTools !== undefined ? { allowedTools } : {}),
787
930
  ...(deniedTools !== undefined ? { deniedTools } : {}),
package/src/templates.ts CHANGED
@@ -34,7 +34,7 @@ export interface TaskTemplate {
34
34
  nextTaskOnError?: string;
35
35
  /** DAG-зависимости: задачи, которые должны успешно завершиться раньше этой. */
36
36
  dependsOn?: string[];
37
- triggerType?: "cron" | "file" | "mcp-event";
37
+ triggerType?: "cron" | "file" | "git" | "mcp-event";
38
38
  /** Параметры MCP-события (для triggerType === "mcp-event"). */
39
39
  mcpEvent?: { server: string; event: string; filter?: string };
40
40
  watchPath?: string;
package/src/types.ts CHANGED
@@ -54,6 +54,43 @@ export function sanitizeName(name: string): string {
54
54
  return result || "task";
55
55
  }
56
56
 
57
+ /**
58
+ * Проверяет имя задачи до создания файлов и записи в БД.
59
+ *
60
+ * Разрешены буквы (включая кириллицу), цифры, пробел, «_», «-» и «.».
61
+ * Спецсимволы оболочки (`& | < > ^ % " ' ; ( ) \``, обратный слэш, слэш)
62
+ * и управляющие символы запрещены: даже при безопасном вызове schtasks
63
+ * такие имена ломают пути файлов и переносимы между платформами.
64
+ *
65
+ * @returns текст ошибки или null, если имя допустимо.
66
+ */
67
+ export function validateTaskName(raw: string): string | null {
68
+ const name = raw.trim();
69
+ if (!name) {
70
+ return "Имя задачи не может быть пустым.";
71
+ }
72
+ if (/[\u0000-\u001f\u007f]/.test(name)) {
73
+ return "Имя задачи не должно содержать управляющие символы.";
74
+ }
75
+ const invalid = name.match(/[^\p{L}\p{N}_\-. ]/u);
76
+ if (invalid) {
77
+ return (
78
+ `Имя задачи содержит недопустимый символ «${invalid[0]}». ` +
79
+ "Разрешены буквы (включая кириллицу), цифры, пробел, «_», «-» и «.»."
80
+ );
81
+ }
82
+ // schtasks ограничивает /tn в 237 символов вместе с папкой планировщика.
83
+ // Префикс "\OpenCode\windows-scheduler\" занимает 28 символов, остаётся 209 на имя задачи.
84
+ const MAX_TASK_NAME_LENGTH = 209;
85
+ if (name.length > MAX_TASK_NAME_LENGTH) {
86
+ return (
87
+ `Имя задачи "${name}" слишком длинное (${name.length} символов, максимум ${MAX_TASK_NAME_LENGTH} ` +
88
+ `с учётом папки планировщика). Сократите имя или имя workspace (для клонов матрицы).`
89
+ );
90
+ }
91
+ return null;
92
+ }
93
+
57
94
  /**
58
95
  * Схема аргументов для schedule_job.
59
96
  * schedule принимает только 5-полевые cron-выражения.