opencode-windows-scheduler 1.1.0 → 1.2.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 (144) hide show
  1. package/CHANGELOG.md +60 -1
  2. package/README.md +18 -8
  3. package/README.ru.md +13 -3
  4. package/ROADMAP-STRATEGY.md +2 -2
  5. package/ROADMAP.md +51 -18
  6. package/dist/core/analytics.d.ts +10 -0
  7. package/dist/core/analytics.d.ts.map +1 -1
  8. package/dist/core/analytics.js +21 -0
  9. package/dist/core/dry-run.d.ts +18 -1
  10. package/dist/core/dry-run.d.ts.map +1 -1
  11. package/dist/core/dry-run.js +49 -3
  12. package/dist/core/matrix.d.ts.map +1 -1
  13. package/dist/core/matrix.js +10 -0
  14. package/dist/core/one-shot.d.ts +62 -0
  15. package/dist/core/one-shot.d.ts.map +1 -0
  16. package/dist/core/one-shot.js +126 -0
  17. package/dist/core/otel.d.ts +4 -0
  18. package/dist/core/otel.d.ts.map +1 -0
  19. package/dist/core/otel.js +98 -0
  20. package/dist/core/prometheus.d.ts +23 -0
  21. package/dist/core/prometheus.d.ts.map +1 -0
  22. package/dist/core/prometheus.js +146 -0
  23. package/dist/core/ps-wrapper.d.ts +36 -2
  24. package/dist/core/ps-wrapper.d.ts.map +1 -1
  25. package/dist/core/ps-wrapper.js +124 -4
  26. package/dist/core/record-history.d.ts.map +1 -1
  27. package/dist/core/record-history.js +9 -0
  28. package/dist/core/schedule-gate.d.ts +2 -0
  29. package/dist/core/schedule-gate.d.ts.map +1 -0
  30. package/dist/core/schedule-gate.js +182 -0
  31. package/dist/core/schedule-v2.d.ts +88 -0
  32. package/dist/core/schedule-v2.d.ts.map +1 -0
  33. package/dist/core/schedule-v2.js +496 -0
  34. package/dist/core/scheduler/linux.d.ts +12 -3
  35. package/dist/core/scheduler/linux.d.ts.map +1 -1
  36. package/dist/core/scheduler/linux.js +80 -3
  37. package/dist/core/scheduler/mac.d.ts.map +1 -1
  38. package/dist/core/scheduler/mac.js +17 -3
  39. package/dist/core/scheduler/posix.d.ts.map +1 -1
  40. package/dist/core/scheduler/posix.js +3 -0
  41. package/dist/core/scheduler/registry.d.ts +4 -0
  42. package/dist/core/scheduler/registry.d.ts.map +1 -1
  43. package/dist/core/scheduler/types.d.ts +20 -3
  44. package/dist/core/scheduler/types.d.ts.map +1 -1
  45. package/dist/core/scheduler/windows.d.ts.map +1 -1
  46. package/dist/core/scheduler/windows.js +23 -2
  47. package/dist/core/session.d.ts +34 -0
  48. package/dist/core/session.d.ts.map +1 -0
  49. package/dist/core/session.js +105 -0
  50. package/dist/core/structured-log.d.ts +84 -0
  51. package/dist/core/structured-log.d.ts.map +1 -0
  52. package/dist/core/structured-log.js +137 -0
  53. package/dist/core/wrappers/bash.d.ts +24 -0
  54. package/dist/core/wrappers/bash.d.ts.map +1 -1
  55. package/dist/core/wrappers/bash.js +70 -3
  56. package/dist/db/history-repo.d.ts +8 -0
  57. package/dist/db/history-repo.d.ts.map +1 -1
  58. package/dist/db/history-repo.js +76 -6
  59. package/dist/db/metrics-repo.d.ts +3 -0
  60. package/dist/db/metrics-repo.d.ts.map +1 -1
  61. package/dist/db/metrics-repo.js +16 -8
  62. package/dist/db/migrate.d.ts.map +1 -1
  63. package/dist/db/migrate.js +8 -1
  64. package/dist/db/schema.d.ts +1 -1
  65. package/dist/db/schema.d.ts.map +1 -1
  66. package/dist/db/schema.js +19 -0
  67. package/dist/gui-experimental.cjs +1 -0
  68. package/dist/history.d.ts +7 -0
  69. package/dist/history.d.ts.map +1 -1
  70. package/dist/history.js +13 -0
  71. package/dist/index.d.ts +137 -1
  72. package/dist/index.d.ts.map +1 -1
  73. package/dist/index.js +1323 -78
  74. package/dist/integrations.d.ts +64 -0
  75. package/dist/integrations.d.ts.map +1 -0
  76. package/dist/integrations.js +205 -0
  77. package/dist/notifications.d.ts +112 -6
  78. package/dist/notifications.d.ts.map +1 -1
  79. package/dist/notifications.js +396 -34
  80. package/dist/profiles.d.ts +60 -0
  81. package/dist/profiles.d.ts.map +1 -0
  82. package/dist/profiles.js +209 -0
  83. package/dist/rpc.d.ts +592 -4
  84. package/dist/rpc.d.ts.map +1 -1
  85. package/dist/rpc.js +233 -6
  86. package/dist/server.d.ts +2 -0
  87. package/dist/server.d.ts.map +1 -1
  88. package/dist/server.js +473 -58
  89. package/dist/settings.d.ts +95 -0
  90. package/dist/settings.d.ts.map +1 -1
  91. package/dist/settings.js +186 -8
  92. package/dist/shared/jobs-view.d.ts +43 -5
  93. package/dist/shared/jobs-view.d.ts.map +1 -1
  94. package/dist/shared/jobs-view.js +125 -7
  95. package/dist/task-transfer.d.ts +32 -3
  96. package/dist/task-transfer.d.ts.map +1 -1
  97. package/dist/task-transfer.js +101 -3
  98. package/dist/types.d.ts.map +1 -1
  99. package/dist/types.js +3 -11
  100. package/dist/workspaces.d.ts +43 -0
  101. package/dist/workspaces.d.ts.map +1 -1
  102. package/dist/workspaces.js +174 -8
  103. package/docs/ARCHITECTURE.md +32 -12
  104. package/docs/FEATURES.md +186 -10
  105. package/gui-experimental.cjs +4 -2
  106. package/package.json +15 -2
  107. package/scripts/demo-dashboard.mjs +12 -2
  108. package/src/core/analytics.ts +36 -0
  109. package/src/core/dry-run.ts +65 -4
  110. package/src/core/matrix.ts +10 -0
  111. package/src/core/one-shot.ts +173 -0
  112. package/src/core/otel.ts +128 -0
  113. package/src/core/prometheus.ts +215 -0
  114. package/src/core/ps-wrapper.ts +144 -4
  115. package/src/core/record-history.ts +13 -0
  116. package/src/core/schedule-gate.ts +213 -0
  117. package/src/core/schedule-v2.ts +533 -0
  118. package/src/core/scheduler/linux.ts +90 -3
  119. package/src/core/scheduler/mac.ts +35 -4
  120. package/src/core/scheduler/posix.ts +3 -0
  121. package/src/core/scheduler/registry.ts +4 -0
  122. package/src/core/scheduler/types.ts +20 -3
  123. package/src/core/scheduler/windows.ts +24 -2
  124. package/src/core/session.ts +115 -0
  125. package/src/core/structured-log.ts +205 -0
  126. package/src/core/wrappers/bash.ts +98 -2
  127. package/src/db/history-repo.ts +90 -7
  128. package/src/db/metrics-repo.ts +19 -7
  129. package/src/db/migrate.ts +7 -1
  130. package/src/db/schema.ts +25 -0
  131. package/src/gui.tsx +3832 -2868
  132. package/src/history.ts +17 -0
  133. package/src/index.ts +1670 -117
  134. package/src/integrations.ts +253 -0
  135. package/src/notifications.ts +516 -40
  136. package/src/profiles.ts +236 -0
  137. package/src/rpc.ts +244 -6
  138. package/src/server.ts +506 -58
  139. package/src/settings.ts +336 -9
  140. package/src/shared/jobs-view.ts +158 -8
  141. package/src/task-transfer.ts +151 -5
  142. package/src/tui.tsx +290 -14
  143. package/src/types.ts +3 -13
  144. package/src/workspaces.ts +214 -8
@@ -1,6 +1,6 @@
1
1
  import fs from "node:fs/promises";
2
2
  import path from "node:path";
3
- import { PLUGIN_DIR, WRAPPER_DIR } from "../types.js";
3
+ import { PLUGIN_DIR, LOCK_DIR, WRAPPER_DIR, sanitizeName } from "../types.js";
4
4
  /**
5
5
  * Путь к единому generic-обёртке PowerShell, которая реализует запуск opencode run
6
6
  * с таймаутом и lock-логикой.
@@ -42,7 +42,10 @@ export const WRAPPER_SCRIPT = `param(
42
42
  [string]$RecorderFile,
43
43
  [string]$QualityGate,
44
44
  [string]$BeforeScript,
45
- [string]$AfterScript
45
+ [string]$AfterScript,
46
+ [string]$EnvFile,
47
+ [string]$SessionMode,
48
+ [string]$SessionId
46
49
  )
47
50
 
48
51
  [Console]::OutputEncoding = [System.Text.Encoding]::UTF8
@@ -287,14 +290,34 @@ try {
287
290
  if (-not $script:skipMainTask) {
288
291
  $prompt = Get-Content -Path $PromptFile -Raw -Encoding UTF8
289
292
 
293
+ # Спринт 21: env-переменные workspace. Файл пишет плагин, значения не логируются.
294
+ if ($EnvFile -and (Test-Path -LiteralPath $EnvFile)) {
295
+ try {
296
+ Get-Content -Path $EnvFile -Encoding UTF8 | ForEach-Object {
297
+ $line = $_.Trim()
298
+ if ($line -and -not $line.StartsWith("#") -and $line -match "^([A-Za-z_][A-Za-z0-9_]*)=(.*)$") {
299
+ Set-Item -Path ("env:" + $matches[1]) -Value $matches[2]
300
+ }
301
+ }
302
+ Write-Log "[windows-scheduler] Переменные окружения workspace загружены."
303
+ } catch {
304
+ Write-Log "[windows-scheduler] Не удалось загрузить env-файл workspace: $($_.Exception.Message)"
305
+ }
306
+ }
307
+
290
308
  # Получаем путь к скрипту opencode (.ps1 или .cmd)
291
309
  $opencodeCmd = Get-Command opencode | Select-Object -ExpandProperty Source
292
310
 
293
- # Формируем аргументы для opencode run
311
+ # Формируем аргументы для opencode run (Спринт 24: сессия).
294
312
  $opencodeArgs = @("run")
295
313
  if ($Model) {
296
314
  $opencodeArgs += @("--model", $Model)
297
315
  }
316
+ if ($SessionMode -eq 'reuse' -and $SessionId) {
317
+ $opencodeArgs += @("--session", $SessionId)
318
+ } elseif ($SessionMode -eq 'last') {
319
+ $opencodeArgs += @("--continue")
320
+ }
298
321
  if ($prompt) {
299
322
  $opencodeArgs += $prompt
300
323
  }
@@ -461,8 +484,14 @@ export function lockFilePath(taskName) {
461
484
  * @param workspaceName имя workspace для git-контекста в логе (опционально)
462
485
  * @param allowedTools список разрешённых инструментов (спринт 14, опционально)
463
486
  * @param deniedTools список запрещённых инструментов (спринт 14, опционально)
487
+ * @param scheduleGate гейт расписания (спринт 19): проверка cron в таймзоне
488
+ * и окна запуска перед стартом PowerShell-обёртки.
489
+ * @param envFile env-файл workspace (спринт 21, опционально)
490
+ * @param sessionMode режим сессии OpenCode (спринт 24): "new" (по умолчанию,
491
+ * без флагов), "reuse" (--session $SessionId), "last" (--continue)
492
+ * @param sessionId идентификатор сессии для режима "reuse" (спринт 24, опционально)
464
493
  */
465
- export async function writeWrapperCmd(sanitizedName, taskName, promptFile, timeoutSeconds, lockFile, workdir, logFile, recorderFile, qualityGate, model, beforeScript, afterScript, workspaceName, allowedTools, deniedTools) {
494
+ export async function writeWrapperCmd(sanitizedName, taskName, promptFile, timeoutSeconds, lockFile, workdir, logFile, recorderFile, qualityGate, model, beforeScript, afterScript, workspaceName, allowedTools, deniedTools, scheduleGate, envFile, sessionMode, sessionId) {
466
495
  await fs.mkdir(WRAPPER_DIR, { recursive: true });
467
496
  const cmdPath = path.join(WRAPPER_DIR, `run-${sanitizedName}.cmd`);
468
497
  const ps1Path = path.join(WRAPPER_DIR, WRAPPER_FILENAME);
@@ -526,13 +555,104 @@ export async function writeWrapperCmd(sanitizedName, taskName, promptFile, timeo
526
555
  psArgs.push(`${flag} "${safe}"`);
527
556
  }
528
557
  }
558
+ // Спринт 21: env-файл workspace (пары KEY=VALUE). Значения не логируются.
559
+ if (envFile?.trim()) {
560
+ const safeEnvFile = envFile.replace(/[\r\n"]+/g, "").trim();
561
+ if (safeEnvFile) {
562
+ psArgs.push(`-EnvFile "${safeEnvFile}"`);
563
+ }
564
+ }
565
+ // Спринт 24: режим сессии OpenCode. sessionId передаём только для reuse.
566
+ const safeSessionMode = sessionMode === "reuse" || sessionMode === "last" ? sessionMode : "new";
567
+ if (safeSessionMode !== "new") {
568
+ psArgs.push(`-SessionMode "${safeSessionMode}"`);
569
+ if (safeSessionMode === "reuse") {
570
+ const safeSessionId = (sessionId ?? "").replace(/[\r\n"]+/g, "").trim();
571
+ if (safeSessionId) {
572
+ psArgs.push(`-SessionId "${safeSessionId}"`);
573
+ }
574
+ }
575
+ }
529
576
  const lines = ["@echo off", "chcp 65001 >nul"];
530
577
  // Рабочая директория: всегда переходим в неё ДО запуска PowerShell.
531
578
  // По умолчанию — текущая папка проекта (process.cwd()). Это критично для
532
579
  // MCP: opencode run подхватывает opencode.json из рабочей директории.
533
580
  const effectiveWorkdir = workdir?.trim() || process.cwd();
534
581
  lines.push(`cd /d "${effectiveWorkdir}"`);
582
+ // Спринт 19: гейт расписания ДО PowerShell. Проверяет, что cron реально
583
+ // сработал сейчас (для poll-режима и чужих таймзон), и при необходимости
584
+ // переносит запуск до открытия окна notBefore..notAfter.
585
+ // Exit 3 — «не сейчас», выходим тихо, не считая это запуском задачи.
586
+ if (scheduleGate?.gateFile) {
587
+ const gateArgs = [`node "${scheduleGate.gateFile}"`];
588
+ if (scheduleGate.cron?.trim()) {
589
+ gateArgs.push(`--cron "${scheduleGate.cron.replace(/[\r\n"]+/g, " ").trim()}"`);
590
+ }
591
+ if (scheduleGate.tz?.trim()) {
592
+ gateArgs.push(`--tz "${scheduleGate.tz.trim()}"`);
593
+ }
594
+ if (scheduleGate.notBefore?.trim()) {
595
+ gateArgs.push(`--not-before ${scheduleGate.notBefore.trim()}`);
596
+ }
597
+ if (scheduleGate.notAfter?.trim()) {
598
+ gateArgs.push(`--not-after ${scheduleGate.notAfter.trim()}`);
599
+ }
600
+ if (scheduleGate.deferFile?.trim()) {
601
+ gateArgs.push(`--defer-file "${scheduleGate.deferFile.trim()}"`);
602
+ }
603
+ // Маркер ручного запуска: run_task_now/файловый триггер/MCP-событие
604
+ // создают его перед вызовом schtasks /run, чтобы gate не отсекал запуск
605
+ // по cron. Без этого run_task_now был тихим no-op для poll-режима.
606
+ if (scheduleGate.forceFile?.trim()) {
607
+ gateArgs.push(`--force-file "${scheduleGate.forceFile.trim()}"`);
608
+ }
609
+ // append к логу задачи, чтобы перенос/пропуск был виден в истории запусков
610
+ if (logFile?.trim()) {
611
+ gateArgs.push(`>> "${logFile.trim()}" 2>&1`);
612
+ }
613
+ lines.push(gateArgs.join(" "));
614
+ lines.push(`if "%errorlevel%"=="3" exit /b 0`);
615
+ }
535
616
  lines.push(psArgs.join(" "));
536
617
  await fs.writeFile(cmdPath, lines.join("\r\n"), "utf8");
537
618
  return cmdPath;
538
619
  }
620
+ // ---------------------------------------------------------------------------
621
+ // Маркер ручного запуска.
622
+ /** Сколько живёт маркер ручного запуска (должно совпадать с schedule-gate.ts). */
623
+ export const FORCE_FILE_TTL_MS = 2 * 60 * 1000;
624
+ /**
625
+ * Путь к маркеру немедленного запуска задачи.
626
+ *
627
+ * Лежит рядом с lock-файлом и вычисляется из того же санитизированного имени,
628
+ * поэтому обёртка (--force-file) и агент указывают на один и тот же файл.
629
+ */
630
+ export function forceFilePath(taskName) {
631
+ return `${lockFilePath(sanitizeName(taskName))}.force`;
632
+ }
633
+ /**
634
+ * Создаёт маркер «запустить сейчас» перед вызовом планировщика ОС.
635
+ *
636
+ * Зачем: для poll-режима (нестандартный cron/чужая таймзона/окно запуска)
637
+ * обёртка всегда прогоняет schedule-gate, и ручной запуск вне cron-окна
638
+ * молча завершался с exit 3 — инструмент рапортовал success, но задача не
639
+ * выполнялась. Gate поглощает свежий маркер и пропускает проверку расписания.
640
+ *
641
+ * Маркер самоуничтожается через FORCE_FILE_TTL_MS, если задача так и не
642
+ * стартовала (например, отключена в планировщике), чтобы не влиять на
643
+ * последующие плановые запуски.
644
+ */
645
+ export async function requestImmediateRun(taskName) {
646
+ const file = forceFilePath(taskName);
647
+ await fs.mkdir(LOCK_DIR, { recursive: true });
648
+ await fs.writeFile(file, new Date().toISOString(), "utf8");
649
+ const timer = setTimeout(() => {
650
+ void fs.unlink(file).catch(() => {
651
+ /* маркер уже поглощён gate'ом или удалён вручную */
652
+ });
653
+ }, FORCE_FILE_TTL_MS);
654
+ // Таймер не должен удерживать процесс хоста.
655
+ if (typeof timer.unref === "function")
656
+ timer.unref();
657
+ return file;
658
+ }
@@ -1 +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"}
1
+ {"version":3,"file":"record-history.d.ts","sourceRoot":"","sources":["../../src/core/record-history.ts"],"names":[],"mappings":"AAQA,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"}
@@ -5,6 +5,7 @@ import { notifyTaskCompletion } from "../notifications.js";
5
5
  import { finishRun, getHistory, recordRun, startRun } from "../db/history-repo.js";
6
6
  import { getSetting, setSetting } from "../db/settings-repo.js";
7
7
  import { getTask, listTasks } from "../db/tasks-repo.js";
8
+ import { rotateSessionIfNeeded } from "./session.js";
8
9
  import { advanceMatrixAfterClone, finalizeMatrixIfComplete, } from "./matrix.js";
9
10
  const RETRY_STATE_KEY = "retry_state";
10
11
  /**
@@ -336,6 +337,14 @@ async function handleCompletion(taskName, st, chainTarget, error, durationMs) {
336
337
  }
337
338
  }
338
339
  }
340
+ // Спринт 24: учёт запусков сессии (sessionRunCount) и ротация reuse-сессии
341
+ // при достижении sessionMaxRuns. Не должна ломать завершение запуска.
342
+ try {
343
+ await rotateSessionIfNeeded(taskName);
344
+ }
345
+ catch (err) {
346
+ console.warn(`[windows-scheduler] Не удалось обновить состояние сессии "${taskName}": ${err instanceof Error ? err.message : String(err)}`);
347
+ }
339
348
  }
340
349
  /**
341
350
  * Скрипт вызывается и как CLI (node record-history.js ...), и импортируется
@@ -0,0 +1,2 @@
1
+ export {};
2
+ //# sourceMappingURL=schedule-gate.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"schedule-gate.d.ts","sourceRoot":"","sources":["../../src/core/schedule-gate.ts"],"names":[],"mappings":""}
@@ -0,0 +1,182 @@
1
+ /**
2
+ * schedule-gate: вызывается враппером (.cmd / bash) сразу после срабатывания
3
+ * планировщика, ДО запуска агента.
4
+ *
5
+ * Проверяет расширенное cron-выражение и окно запуска (notBefore/notAfter):
6
+ * node dist/core/schedule-gate.js --cron "0 9 * * *" [--tz "Europe/Moscow"]
7
+ * [--not-before 22:00 --not-after 06:00]
8
+ * [--defer-file "C:\...\name.lock.defer"]
9
+ * [--force-file "C:\...\name.lock.force"]
10
+ * [--now 2026-11-13T12:00:00.000Z] (для тестов)
11
+ *
12
+ * --force-file — маркер ручного запуска (run_task_now, файловый триггер,
13
+ * catch-up). Если файл существует и моложе FORCE_TTL_MS, проверка cron/окна
14
+ * пропускается, а маркер удаляется. Протухший маркер не действует — иначе
15
+ * забытый файл однажды обошёл бы расписание.
16
+ *
17
+ * Коды выхода:
18
+ * 0 — можно запускать (wrapper выполняет агента);
19
+ * 3 — не время (cron не совпал, уже есть отложенный запуск или не в окне),
20
+ * wrapper тихо завершается;
21
+ * 1 — некорректные аргументы (ошибка логируется; запуск разрешён, чтобы не
22
+ * ломать задачу из-за опечатки в конфигурации).
23
+ *
24
+ * Окно запуска реализовано как ПЕРЕНОС, а не пропуск: если cron совпал, но
25
+ * сейчас вне окна, gate ждёт открытия окна. Дубликаты отложенных запусков
26
+ * отсекаются по defer-файлу (атомарное создание); файл запись удаляет сам gate
27
+ * после пробуждения; если файл протух (> 25 часов) — считается stale и
28
+ * перезаписывается.
29
+ */
30
+ import fs from "node:fs";
31
+ import { cronMatches, isValidIanaTimeZone, isInWindow, parseCron, validateLaunchWindow, windowDelayMs, } from "./schedule-v2.js";
32
+ const STALE_DEFER_MS = 25 * 60 * 60 * 1000;
33
+ /** Сколько живёт маркер ручного запуска. */
34
+ const FORCE_TTL_MS = 2 * 60 * 1000;
35
+ function argValue(args, name) {
36
+ const idx = args.indexOf(name);
37
+ if (idx === -1 || idx + 1 >= args.length)
38
+ return undefined;
39
+ return args[idx + 1];
40
+ }
41
+ function sleepMs(ms) {
42
+ return new Promise((resolve) => setTimeout(resolve, ms));
43
+ }
44
+ /** true, если defer-файл сейчас занят другим отложенным запуском. */
45
+ function deferFileBusy(path, nowMs) {
46
+ try {
47
+ const raw = fs.readFileSync(path, "utf8").trim();
48
+ const ts = Date.parse(raw);
49
+ if (Number.isFinite(ts) && nowMs - ts < STALE_DEFER_MS)
50
+ return true;
51
+ // Протухший файл — удаляем и занимаем сами.
52
+ fs.unlinkSync(path);
53
+ return false;
54
+ }
55
+ catch {
56
+ return false;
57
+ }
58
+ }
59
+ /** Атомарно занимает defer-слот; true, если занят успешно. */
60
+ function acquireDefer(path, nowMs) {
61
+ try {
62
+ const fd = fs.openSync(path, "wx");
63
+ fs.writeSync(fd, new Date(nowMs).toISOString());
64
+ fs.closeSync(fd);
65
+ return true;
66
+ }
67
+ catch {
68
+ return false;
69
+ }
70
+ }
71
+ function releaseDefer(path) {
72
+ try {
73
+ fs.unlinkSync(path);
74
+ }
75
+ catch {
76
+ /* удалён раньше — не страшно */
77
+ }
78
+ }
79
+ /**
80
+ * Проверяет и поглощает маркер ручного запуска.
81
+ *
82
+ * Возвращает true, если маркер свежий (значит, запуск инициирован вручную:
83
+ * инструментом, файловым триггером, MCP-событием или catch-up) — тогда гейт
84
+ * расписания не должен блокировать запуск. Маркер удаляется в любом случае.
85
+ *
86
+ * Возраст считается по реальным часам, а не по --now, иначе тестовый --now
87
+ * ломал бы проверку. Протухший маркер (например, задача не стартовала)
88
+ * просто удаляется и не влияет на расписание.
89
+ */
90
+ function consumeForceMarker(path) {
91
+ try {
92
+ const stat = fs.statSync(path);
93
+ fs.unlinkSync(path);
94
+ return Date.now() - stat.mtimeMs <= FORCE_TTL_MS;
95
+ }
96
+ catch {
97
+ return false;
98
+ }
99
+ }
100
+ async function main() {
101
+ const args = process.argv.slice(2);
102
+ const cronExpr = argValue(args, "--cron");
103
+ const tz = argValue(args, "--tz");
104
+ const notBefore = argValue(args, "--not-before");
105
+ const notAfter = argValue(args, "--not-after");
106
+ const deferFile = argValue(args, "--defer-file");
107
+ const forceFile = argValue(args, "--force-file");
108
+ const nowArg = argValue(args, "--now");
109
+ const now = nowArg ? new Date(nowArg) : new Date();
110
+ if (Number.isNaN(now.getTime())) {
111
+ console.error(`[schedule-gate] Некорректное значение --now: ${nowArg}`);
112
+ return 1;
113
+ }
114
+ // Ручной запуск (run_task_now, файловый триггер, MCP-событие, catch-up):
115
+ // маркер свежий — расписание и окно не проверяем.
116
+ if (forceFile && consumeForceMarker(forceFile)) {
117
+ console.error("[schedule-gate] Ручной запуск — проверка расписания пропущена.");
118
+ return 0;
119
+ }
120
+ // Невалидный timezone/окно — не блокируем задачу, логируем и продолжаем.
121
+ const zone = tz && isValidIanaTimeZone(tz) ? tz : undefined;
122
+ if (tz && !zone) {
123
+ console.error(`[schedule-gate] Неизвестный timezone «${tz}» — игнорируем его.`);
124
+ }
125
+ const windowError = validateLaunchWindow(notBefore, notAfter);
126
+ if (windowError) {
127
+ console.error(`[schedule-gate] Окно запуска игнорируется: ${windowError}`);
128
+ }
129
+ const windowOk = !windowError && !!notBefore && !!notAfter;
130
+ let spec = null;
131
+ if (cronExpr) {
132
+ try {
133
+ spec = parseCron(cronExpr);
134
+ }
135
+ catch (err) {
136
+ console.error(`[schedule-gate] Невалидный cron «${cronExpr}»: ${err instanceof Error ? err.message : String(err)} — пропускаем проверку cron.`);
137
+ }
138
+ }
139
+ if (spec && !cronMatches(spec, now, zone)) {
140
+ // По расширенному cron сейчас не время.
141
+ return 3;
142
+ }
143
+ if (windowOk && !isInWindow(now, notBefore, notAfter, zone)) {
144
+ const wait = windowDelayMs(now, notBefore, notAfter, zone);
145
+ if (wait <= 0)
146
+ return 0;
147
+ // ПЕРЕНОС: ждём открытия окна. Откладываем один запуск, остальные тики
148
+ // отсекаются по defer-файлу.
149
+ if (deferFile) {
150
+ if (deferFileBusy(deferFile, now.getTime())) {
151
+ console.error("[schedule-gate] Отложенный запуск уже ожидает открытия окна.");
152
+ return 3;
153
+ }
154
+ if (!acquireDefer(deferFile, now.getTime())) {
155
+ console.error("[schedule-gate] Не удалось захватить defer-файл — пропускаем.");
156
+ return 3;
157
+ }
158
+ }
159
+ console.error(`[schedule-gate] Вне окна ${notBefore}–${notAfter} — запуск перенесён на ~${Math.round(wait / 60000)} мин.`);
160
+ let remaining = wait;
161
+ let woke = now;
162
+ while (remaining > 0) {
163
+ const chunk = Math.min(remaining, 60000);
164
+ await sleepMs(chunk);
165
+ remaining -= chunk;
166
+ woke = new Date();
167
+ if (isInWindow(woke, notBefore, notAfter, zone))
168
+ break;
169
+ }
170
+ if (deferFile)
171
+ releaseDefer(deferFile);
172
+ if (!isInWindow(woke, notBefore, notAfter, zone)) {
173
+ console.error("[schedule-gate] Окно не открылось за отведённое время — не запускаем.");
174
+ return 3;
175
+ }
176
+ }
177
+ return 0;
178
+ }
179
+ main().then((code) => process.exit(code), (err) => {
180
+ console.error(`[schedule-gate] Непредвиденная ошибка: ${err instanceof Error ? err.message : String(err)} — запускаем.`);
181
+ process.exit(1);
182
+ });
@@ -0,0 +1,88 @@
1
+ import type { CronConversion } from "../types.js";
2
+ export interface ZonedParts {
3
+ year: number;
4
+ month: number;
5
+ day: number;
6
+ hour: number;
7
+ minute: number;
8
+ second: number;
9
+ ms: number;
10
+ weekday: number;
11
+ }
12
+ export declare function isValidIanaTimeZone(tz: string): boolean;
13
+ /** Системная таймзона (IANA) или "UTC", если её не удалось определить. */
14
+ export declare function systemTimeZone(): string;
15
+ /** Части даты в заданной инстанции (или в системной локали, если tz не задан). */
16
+ export declare function zonedParts(date: Date, timeZone?: string): ZonedParts;
17
+ /** Стенные часы → UTC, итеративно учитывая смещение (DST-safe). null — несуществующее время. */
18
+ export declare function wallToUtc(y: number, m: number, d: number, h: number, mi: number, timeZone?: string): Date | null;
19
+ export interface ParsedCron {
20
+ /** Исходное выражение (после расширения @every). */
21
+ raw: string;
22
+ minute: Set<number>;
23
+ hour: Set<number>;
24
+ /** Дни месяца или null, если поле = «*» и не содержит L. */
25
+ dayOfMonth: Set<number> | null;
26
+ /** true — поле содержит «L» (последний день месяца). */
27
+ lastDom: boolean;
28
+ month: Set<number>;
29
+ /** День недели 0(Вс)..6(Сб) или null, если поле = «*» и не содержит «#». */
30
+ dayOfWeek: Set<number> | null;
31
+ /** Пары {weekday, n} для «#». */
32
+ nthWeekday: Array<{
33
+ weekday: number;
34
+ n: number;
35
+ }>;
36
+ }
37
+ /** Разворачивает «@every 15m|2h|1d» в обычный cron. */
38
+ export declare function normalizeCron(expr: string): string;
39
+ /** Парсит cron-выражение; бросает Error с понятным сообщением. */
40
+ export declare function parseCron(expr: string): ParsedCron;
41
+ /** true, если cron срабатывает в указанную минуту (в системной или заданной tz). */
42
+ export declare function cronMatches(spec: ParsedCron, date: Date, timeZone?: string): boolean;
43
+ /**
44
+ * Ближайший запуск после `from` (или null, если найти не удалось за 5 лет).
45
+ * `timeZone` — IANA; по умолчанию системная.
46
+ */
47
+ export declare function nextRun(expr: string, from: Date, timeZone?: string): Date | null;
48
+ /** Последний запуск не позже `from` (или null). */
49
+ export declare function prevRun(expr: string, from: Date, timeZone?: string): Date | null;
50
+ export declare function isValidDailyTime(value: string): boolean;
51
+ /** Проверяет пару окна; возвращает текст ошибки или null. */
52
+ export declare function validateLaunchWindow(notBefore?: string | null, notAfter?: string | null): string | null;
53
+ /** Мы внутри окна запуска? */
54
+ export declare function isInWindow(now: Date, notBefore?: string | null, notAfter?: string | null, timeZone?: string): boolean;
55
+ /** Сколько мс ждать до открытия окна (0 — уже открыто / окно не задано). */
56
+ export declare function windowDelayMs(now: Date, notBefore?: string | null, notAfter?: string | null, timeZone?: string): number;
57
+ /**
58
+ * true, если выражение умеет оформить Windows Task Scheduler «родными»
59
+ * флагами (MINUTE/HOURLY/DAILY/WEEKLY) и парсится строгим конвертером.
60
+ * Используется для выбора между флагами и минутным опросом.
61
+ */
62
+ export declare function isNativeSchtasksExpr(expr: string): boolean;
63
+ /** Конвертер для родного режима; бросает Error для неподдерживаемых. */
64
+ export declare function convertForSchtasks(expr: string): CronConversion;
65
+ /** Аргументы schedule-gate, которые запекаются во враппер (cron/tz/окно/пернос). */
66
+ export interface ScheduleGateSpec {
67
+ /**
68
+ * Cron-выражение для повторной проверки внутри обёртки. Задаётся только в
69
+ * poll-режиме: при родном триггере ОС уже сработала точно по cron, и повторная
70
+ * проверка ломала бы ручной запуск и catch-up.
71
+ */
72
+ cron?: string;
73
+ tz?: string;
74
+ notBefore?: string;
75
+ notAfter?: string;
76
+ }
77
+ /**
78
+ * true, если ОС-триггер не выражает расписание (чужой IANA-таймзона или
79
+ * не конвертируемо в флаги schtasks) — нужен минутный опрос + gate.
80
+ */
81
+ export declare function needsPollMode(expr: string, timezone?: string | null): boolean;
82
+ /**
83
+ * Аргументы schedule-gate для враппера, либо undefined — если врапперу гейт
84
+ * не нужен (нативный cron + системный таймзона + окно не задано).
85
+ * Окно запуска всегда требует gate (перенос реализует враппер).
86
+ */
87
+ export declare function buildScheduleGate(expr: string, timezone?: string | null, notBefore?: string, notAfter?: string): ScheduleGateSpec | undefined;
88
+ //# sourceMappingURL=schedule-v2.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"schedule-v2.d.ts","sourceRoot":"","sources":["../../src/core/schedule-v2.ts"],"names":[],"mappings":"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"}