agent-steward 0.0.1 → 0.0.2
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.
- package/CHANGELOG.md +376 -0
- package/CROSS_PLATFORM.md +149 -0
- package/README.md +306 -15
- package/ROADMAP-STRATEGY.md +147 -0
- package/ROADMAP.md +1069 -0
- package/dist/core/analytics.d.ts +132 -0
- package/dist/core/analytics.d.ts.map +1 -0
- package/dist/core/analytics.js +290 -0
- package/dist/core/audit.d.ts +96 -0
- package/dist/core/audit.d.ts.map +1 -0
- package/dist/core/audit.js +297 -0
- package/dist/core/cron-to-schtasks.d.ts +20 -0
- package/dist/core/cron-to-schtasks.d.ts.map +1 -0
- package/dist/core/cron-to-schtasks.js +250 -0
- package/dist/core/dry-run.d.ts +102 -0
- package/dist/core/dry-run.d.ts.map +1 -0
- package/dist/core/dry-run.js +447 -0
- package/dist/core/file-watcher.d.ts +31 -0
- package/dist/core/file-watcher.d.ts.map +1 -0
- package/dist/core/file-watcher.js +186 -0
- package/dist/core/git-trigger.d.ts +82 -0
- package/dist/core/git-trigger.d.ts.map +1 -0
- package/dist/core/git-trigger.js +312 -0
- package/dist/core/glob.d.ts +38 -0
- package/dist/core/glob.d.ts.map +1 -0
- package/dist/core/glob.js +233 -0
- package/dist/core/local-ai.d.ts +52 -0
- package/dist/core/local-ai.d.ts.map +1 -0
- package/dist/core/local-ai.js +119 -0
- package/dist/core/lock.d.ts +57 -0
- package/dist/core/lock.d.ts.map +1 -0
- package/dist/core/lock.js +195 -0
- package/dist/core/matrix.d.ts +167 -0
- package/dist/core/matrix.d.ts.map +1 -0
- package/dist/core/matrix.js +724 -0
- package/dist/core/native-notify.d.ts +36 -0
- package/dist/core/native-notify.d.ts.map +1 -0
- package/dist/core/native-notify.js +113 -0
- package/dist/core/one-shot.d.ts +68 -0
- package/dist/core/one-shot.d.ts.map +1 -0
- package/dist/core/one-shot.js +139 -0
- package/dist/core/otel.d.ts +4 -0
- package/dist/core/otel.d.ts.map +1 -0
- package/dist/core/otel.js +98 -0
- package/dist/core/permissions.d.ts +69 -0
- package/dist/core/permissions.d.ts.map +1 -0
- package/dist/core/permissions.js +143 -0
- package/dist/core/prometheus.d.ts +23 -0
- package/dist/core/prometheus.d.ts.map +1 -0
- package/dist/core/prometheus.js +146 -0
- package/dist/core/ps-wrapper.d.ts +73 -0
- package/dist/core/ps-wrapper.d.ts.map +1 -0
- package/dist/core/ps-wrapper.js +1071 -0
- package/dist/core/record-history.d.ts +25 -0
- package/dist/core/record-history.d.ts.map +1 -0
- package/dist/core/record-history.js +471 -0
- package/dist/core/retention.d.ts +29 -0
- package/dist/core/retention.d.ts.map +1 -0
- package/dist/core/retention.js +98 -0
- package/dist/core/savings.d.ts +70 -0
- package/dist/core/savings.d.ts.map +1 -0
- package/dist/core/savings.js +87 -0
- package/dist/core/schedule-gate.d.ts +2 -0
- package/dist/core/schedule-gate.d.ts.map +1 -0
- package/dist/core/schedule-gate.js +211 -0
- package/dist/core/schedule-v2.d.ts +116 -0
- package/dist/core/schedule-v2.d.ts.map +1 -0
- package/dist/core/schedule-v2.js +586 -0
- package/dist/core/scheduler/index.d.ts +32 -0
- package/dist/core/scheduler/index.d.ts.map +1 -0
- package/dist/core/scheduler/index.js +63 -0
- package/dist/core/scheduler/linux.d.ts +44 -0
- package/dist/core/scheduler/linux.d.ts.map +1 -0
- package/dist/core/scheduler/linux.js +225 -0
- package/dist/core/scheduler/logs.d.ts +11 -0
- package/dist/core/scheduler/logs.d.ts.map +1 -0
- package/dist/core/scheduler/logs.js +34 -0
- package/dist/core/scheduler/mac.d.ts +40 -0
- package/dist/core/scheduler/mac.d.ts.map +1 -0
- package/dist/core/scheduler/mac.js +207 -0
- package/dist/core/scheduler/posix.d.ts +40 -0
- package/dist/core/scheduler/posix.d.ts.map +1 -0
- package/dist/core/scheduler/posix.js +89 -0
- package/dist/core/scheduler/registry.d.ts +41 -0
- package/dist/core/scheduler/registry.d.ts.map +1 -0
- package/dist/core/scheduler/registry.js +57 -0
- package/dist/core/scheduler/types.d.ts +86 -0
- package/dist/core/scheduler/types.d.ts.map +1 -0
- package/dist/core/scheduler/types.js +1 -0
- package/dist/core/scheduler/windows.d.ts +99 -0
- package/dist/core/scheduler/windows.d.ts.map +1 -0
- package/dist/core/scheduler/windows.js +596 -0
- package/dist/core/secrets.d.ts +66 -0
- package/dist/core/secrets.d.ts.map +1 -0
- package/dist/core/secrets.js +433 -0
- package/dist/core/self-analysis.d.ts +117 -0
- package/dist/core/self-analysis.d.ts.map +1 -0
- package/dist/core/self-analysis.js +539 -0
- package/dist/core/self-analysis.test.d.ts +2 -0
- package/dist/core/self-analysis.test.d.ts.map +1 -0
- package/dist/core/self-analysis.test.js +219 -0
- package/dist/core/session.d.ts +42 -0
- package/dist/core/session.d.ts.map +1 -0
- package/dist/core/session.js +134 -0
- package/dist/core/shutdown.d.ts +26 -0
- package/dist/core/shutdown.d.ts.map +1 -0
- package/dist/core/shutdown.js +49 -0
- package/dist/core/structured-log.d.ts +84 -0
- package/dist/core/structured-log.d.ts.map +1 -0
- package/dist/core/structured-log.js +146 -0
- package/dist/core/summary.d.ts +69 -0
- package/dist/core/summary.d.ts.map +1 -0
- package/dist/core/summary.js +250 -0
- package/dist/core/telegram.d.ts +55 -0
- package/dist/core/telegram.d.ts.map +1 -0
- package/dist/core/telegram.js +344 -0
- package/dist/core/triage-chain.d.ts +40 -0
- package/dist/core/triage-chain.d.ts.map +1 -0
- package/dist/core/triage-chain.js +80 -0
- package/dist/core/triage-compare.d.ts +68 -0
- package/dist/core/triage-compare.d.ts.map +1 -0
- package/dist/core/triage-compare.js +184 -0
- package/dist/core/triage-rules.d.ts +23 -0
- package/dist/core/triage-rules.d.ts.map +1 -0
- package/dist/core/triage-rules.js +196 -0
- package/dist/core/triage-shadow.d.ts +91 -0
- package/dist/core/triage-shadow.d.ts.map +1 -0
- package/dist/core/triage-shadow.js +160 -0
- package/dist/core/triage-worker.d.ts +55 -0
- package/dist/core/triage-worker.d.ts.map +1 -0
- package/dist/core/triage-worker.js +314 -0
- package/dist/core/triage.d.ts +76 -0
- package/dist/core/triage.d.ts.map +1 -0
- package/dist/core/triage.js +271 -0
- package/dist/core/watch-paths.d.ts +6 -0
- package/dist/core/watch-paths.d.ts.map +1 -0
- package/dist/core/watch-paths.js +62 -0
- package/dist/core/wrappers/bash.d.ts +95 -0
- package/dist/core/wrappers/bash.d.ts.map +1 -0
- package/dist/core/wrappers/bash.js +413 -0
- package/dist/db/git-state-repo.d.ts +16 -0
- package/dist/db/git-state-repo.d.ts.map +1 -0
- package/dist/db/git-state-repo.js +38 -0
- package/dist/db/history-repo.d.ts +110 -0
- package/dist/db/history-repo.d.ts.map +1 -0
- package/dist/db/history-repo.js +300 -0
- package/dist/db/index.d.ts +47 -0
- package/dist/db/index.d.ts.map +1 -0
- package/dist/db/index.js +120 -0
- package/dist/db/metrics-repo.d.ts +46 -0
- package/dist/db/metrics-repo.d.ts.map +1 -0
- package/dist/db/metrics-repo.js +103 -0
- package/dist/db/migrate.d.ts +24 -0
- package/dist/db/migrate.d.ts.map +1 -0
- package/dist/db/migrate.js +244 -0
- package/dist/db/recovery.d.ts +11 -0
- package/dist/db/recovery.d.ts.map +1 -0
- package/dist/db/recovery.js +38 -0
- package/dist/db/schema.d.ts +24 -0
- package/dist/db/schema.d.ts.map +1 -0
- package/dist/db/schema.js +170 -0
- package/dist/db/settings-repo.d.ts +8 -0
- package/dist/db/settings-repo.d.ts.map +1 -0
- package/dist/db/settings-repo.js +27 -0
- package/dist/db/tasks-repo.d.ts +26 -0
- package/dist/db/tasks-repo.d.ts.map +1 -0
- package/dist/db/tasks-repo.js +120 -0
- package/dist/db/templates-repo.d.ts +17 -0
- package/dist/db/templates-repo.d.ts.map +1 -0
- package/dist/db/templates-repo.js +57 -0
- package/dist/gui-experimental.cjs +1 -0
- package/dist/history.d.ts +60 -0
- package/dist/history.d.ts.map +1 -0
- package/dist/history.js +70 -0
- package/dist/i18n.d.ts +75 -0
- package/dist/i18n.d.ts.map +1 -0
- package/dist/i18n.js +357 -0
- package/dist/index.d.ts +858 -0
- package/dist/index.d.ts.map +1 -0
- package/dist/index.js +5179 -0
- package/dist/integrations.d.ts +72 -0
- package/dist/integrations.d.ts.map +1 -0
- package/dist/integrations.js +233 -0
- package/dist/notifications.d.ts +199 -0
- package/dist/notifications.d.ts.map +1 -0
- package/dist/notifications.js +967 -0
- package/dist/profiles.d.ts +60 -0
- package/dist/profiles.d.ts.map +1 -0
- package/dist/profiles.js +227 -0
- package/dist/rpc.d.ts +3806 -0
- package/dist/rpc.d.ts.map +1 -0
- package/dist/rpc.js +1507 -0
- package/dist/schtasks.d.ts +32 -0
- package/dist/schtasks.d.ts.map +1 -0
- package/dist/schtasks.js +45 -0
- package/dist/server.d.ts +128 -0
- package/dist/server.d.ts.map +1 -0
- package/dist/server.js +2413 -0
- package/dist/settings.d.ts +389 -0
- package/dist/settings.d.ts.map +1 -0
- package/dist/settings.js +770 -0
- package/dist/shared/jobs-view.d.ts +59 -0
- package/dist/shared/jobs-view.d.ts.map +1 -0
- package/dist/shared/jobs-view.js +146 -0
- package/dist/skill.d.ts +15 -0
- package/dist/skill.d.ts.map +1 -0
- package/dist/skill.js +93 -0
- package/dist/task-transfer.d.ts +252 -0
- package/dist/task-transfer.d.ts.map +1 -0
- package/dist/task-transfer.js +628 -0
- package/dist/templates.d.ts +57 -0
- package/dist/templates.d.ts.map +1 -0
- package/dist/templates.js +16 -0
- package/dist/types.d.ts +96 -0
- package/dist/types.d.ts.map +1 -0
- package/dist/types.js +130 -0
- package/dist/version.d.ts +8 -0
- package/dist/version.d.ts.map +1 -0
- package/dist/version.js +27 -0
- package/dist/workspaces.d.ts +113 -0
- package/dist/workspaces.d.ts.map +1 -0
- package/dist/workspaces.js +393 -0
- package/docs/ARCHITECTURE.md +457 -0
- package/docs/COMPATIBILITY.md +233 -0
- package/docs/CONCEPT.md +230 -0
- package/docs/CROSS_PLATFORM.ru.md +150 -0
- package/docs/CROSS_PLATFORM.zh.md +146 -0
- package/docs/FAQ.md +52 -0
- package/docs/FAQ.ru.md +53 -0
- package/docs/FAQ.zh.md +43 -0
- package/docs/FEATURES.md +698 -0
- package/docs/FEATURES.zh.md +655 -0
- package/docs/LOCAL-AI.md +300 -0
- package/docs/MIGRATION.md +355 -0
- package/docs/README.ru.md +268 -0
- package/docs/README.zh.md +305 -0
- package/docs/SAVINGS.md +61 -0
- package/docs/SAVINGS.ru.md +60 -0
- package/docs/SAVINGS.zh.md +52 -0
- package/docs/V1-V2-COMPATIBILITY-PLAN.md +366 -0
- package/docs/ZH-LOCALE-PLAN.md +324 -0
- package/docs/dashboard.png +0 -0
- package/docs/spikes/local-model-structured-output.md +81 -0
- package/docs/spikes/ollama-qwen3-4b-smoke.json +28 -0
- package/docs/spikes/ollama-qwen3-4b.json +163 -0
- package/gui-experimental.cjs +9 -0
- package/index.js +1 -0
- package/locales/en.json +780 -0
- package/locales/ru.json +780 -0
- package/locales/zh.json +780 -0
- package/package.json +133 -13
- package/scripts/bench-local.mjs +321 -0
- package/scripts/check-zh-locale.mjs +218 -0
- package/scripts/demo-dashboard.mjs +209 -0
- package/scripts/run-tests.mjs +236 -0
- package/scripts/spike-local-structured.mjs +182 -0
- package/scripts/test-locale.mjs +45 -0
- package/skills/scheduled-job-best-practices/SKILL.md +158 -0
- package/skills/scheduled-job-best-practices/references/recipes.md +163 -0
- package/src/core/analytics.ts +424 -0
- package/src/core/audit.ts +418 -0
- package/src/core/cron-to-schtasks.ts +288 -0
- package/src/core/dry-run.ts +601 -0
- package/src/core/file-watcher.ts +245 -0
- package/src/core/git-trigger.ts +391 -0
- package/src/core/glob.ts +226 -0
- package/src/core/local-ai.ts +173 -0
- package/src/core/lock.ts +219 -0
- package/src/core/matrix.ts +947 -0
- package/src/core/native-notify.ts +157 -0
- package/src/core/one-shot.ts +189 -0
- package/src/core/otel.ts +128 -0
- package/src/core/permissions.ts +200 -0
- package/src/core/prometheus.ts +215 -0
- package/src/core/ps-wrapper.ts +1140 -0
- package/src/core/record-history.ts +615 -0
- package/src/core/retention.ts +141 -0
- package/src/core/savings.ts +150 -0
- package/src/core/schedule-gate.ts +253 -0
- package/src/core/schedule-v2.ts +668 -0
- package/src/core/scheduler/index.ts +82 -0
- package/src/core/scheduler/linux.ts +257 -0
- package/src/core/scheduler/logs.ts +37 -0
- package/src/core/scheduler/mac.ts +270 -0
- package/src/core/scheduler/posix.ts +114 -0
- package/src/core/scheduler/registry.ts +99 -0
- package/src/core/scheduler/types.ts +90 -0
- package/src/core/scheduler/windows.ts +711 -0
- package/src/core/secrets.ts +503 -0
- package/src/core/self-analysis.ts +744 -0
- package/src/core/session.ts +150 -0
- package/src/core/shutdown.ts +69 -0
- package/src/core/structured-log.ts +214 -0
- package/src/core/summary.ts +318 -0
- package/src/core/telegram.ts +436 -0
- package/src/core/triage-chain.ts +125 -0
- package/src/core/triage-compare.ts +277 -0
- package/src/core/triage-rules.ts +238 -0
- package/src/core/triage-shadow.ts +240 -0
- package/src/core/triage-worker.ts +344 -0
- package/src/core/triage.ts +366 -0
- package/src/core/watch-paths.ts +70 -0
- package/src/core/wrappers/bash.ts +532 -0
- package/src/db/git-state-repo.ts +62 -0
- package/src/db/history-repo.ts +492 -0
- package/src/db/index.ts +166 -0
- package/src/db/metrics-repo.ts +170 -0
- package/src/db/migrate.ts +328 -0
- package/src/db/recovery.ts +46 -0
- package/src/db/schema.ts +188 -0
- package/src/db/settings-repo.ts +31 -0
- package/src/db/tasks-repo.ts +162 -0
- package/src/db/templates-repo.ts +77 -0
- package/src/gui.tsx +5222 -0
- package/src/history.ts +128 -0
- package/src/i18n.ts +413 -0
- package/src/index.ts +6605 -0
- package/src/integrations.ts +297 -0
- package/src/notifications.ts +1346 -0
- package/src/profiles.ts +254 -0
- package/src/rpc.ts +1609 -0
- package/src/schtasks.ts +75 -0
- package/src/server.ts +2662 -0
- package/src/settings.ts +1369 -0
- package/src/shared/jobs-view.ts +188 -0
- package/src/skill.ts +113 -0
- package/src/task-transfer.ts +944 -0
- package/src/templates.ts +67 -0
- package/src/tui-v1.tsx +341 -0
- package/src/tui.tsx +329 -0
- package/src/types.ts +191 -0
- package/src/version.ts +27 -0
- package/src/workspaces.ts +487 -0
|
@@ -0,0 +1,668 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Расширенный cron и окна запуска (Спринт 19).
|
|
3
|
+
*
|
|
4
|
+
* Два режима регистрации в ОС:
|
|
5
|
+
* - «родной» (флаги schtasks / строки crontab / plist launchd) — только для
|
|
6
|
+
* простых выражений и системной таймзоны;
|
|
7
|
+
* - «опрос раз в минуту» (MINUTE /mo 1 + node-gate в обёртке) — для всего
|
|
8
|
+
* остального (timezone != system, списки, L, #, комбинации). Обёртка
|
|
9
|
+
* вызывает dist/core/schedule-gate.js, который сам решает, пора ли запускать.
|
|
10
|
+
*
|
|
11
|
+
* Здесь живёт только чистая математика: парсинг, совпадение, ближайший запуск.
|
|
12
|
+
* Никакого I/O и обращения к ОС.
|
|
13
|
+
*/
|
|
14
|
+
import { convertCronToSchTasks } from "./cron-to-schtasks.js";
|
|
15
|
+
import { t } from "../i18n.js";
|
|
16
|
+
import type { CronConversion } from "../types.js";
|
|
17
|
+
|
|
18
|
+
/** Ограничение на поиск ближайшего запуска. */
|
|
19
|
+
const MAX_SEARCH_DAYS = 5 * 366;
|
|
20
|
+
|
|
21
|
+
const MONTH_NAMES: Record<string, number> = {
|
|
22
|
+
JAN: 1, FEB: 2, MAR: 3, APR: 4, MAY: 5, JUN: 6,
|
|
23
|
+
JUL: 7, AUG: 8, SEP: 9, OCT: 10, NOV: 11, DEC: 12,
|
|
24
|
+
};
|
|
25
|
+
const DOW_NAMES: Record<string, number> = {
|
|
26
|
+
SUN: 0, MON: 1, TUE: 2, WED: 3, THU: 4, FRI: 5, SAT: 6,
|
|
27
|
+
};
|
|
28
|
+
|
|
29
|
+
export interface ZonedParts {
|
|
30
|
+
year: number; month: number; day: number;
|
|
31
|
+
hour: number; minute: number; second: number; ms: number;
|
|
32
|
+
weekday: number; // 0=Вс..6=Сб
|
|
33
|
+
}
|
|
34
|
+
|
|
35
|
+
/** Кэш форматтеров Intl по таймзоне (создание Intl.DateTimeFormat недёшево). */
|
|
36
|
+
const dtfCache = new Map<string, Intl.DateTimeFormat>();
|
|
37
|
+
|
|
38
|
+
function getDtf(timeZone: string): Intl.DateTimeFormat {
|
|
39
|
+
const cached = dtfCache.get(timeZone);
|
|
40
|
+
if (cached) return cached;
|
|
41
|
+
// hourCycle h23: 00..23, без «24».
|
|
42
|
+
const dtf = new Intl.DateTimeFormat("en-US", {
|
|
43
|
+
timeZone,
|
|
44
|
+
year: "numeric", month: "numeric", day: "numeric",
|
|
45
|
+
hour: "numeric", minute: "numeric", second: "numeric",
|
|
46
|
+
hourCycle: "h23",
|
|
47
|
+
});
|
|
48
|
+
dtfCache.set(timeZone, dtf);
|
|
49
|
+
return dtf;
|
|
50
|
+
}
|
|
51
|
+
|
|
52
|
+
export function isValidIanaTimeZone(tz: string): boolean {
|
|
53
|
+
const t = (tz || "").trim();
|
|
54
|
+
if (!t) return false;
|
|
55
|
+
try {
|
|
56
|
+
new Intl.DateTimeFormat("en-US", { timeZone: t });
|
|
57
|
+
return true;
|
|
58
|
+
} catch {
|
|
59
|
+
return false;
|
|
60
|
+
}
|
|
61
|
+
}
|
|
62
|
+
|
|
63
|
+
/** Системная таймзона (IANA) или "UTC", если её не удалось определить. */
|
|
64
|
+
export function systemTimeZone(): string {
|
|
65
|
+
try {
|
|
66
|
+
return Intl.DateTimeFormat().resolvedOptions().timeZone || "UTC";
|
|
67
|
+
} catch {
|
|
68
|
+
return "UTC";
|
|
69
|
+
}
|
|
70
|
+
}
|
|
71
|
+
|
|
72
|
+
/** Части даты в заданной инстанции (или в системной локали, если tz не задан). */
|
|
73
|
+
export function zonedParts(date: Date, timeZone?: string): ZonedParts {
|
|
74
|
+
if (timeZone && timeZone !== Intl.DateTimeFormat().resolvedOptions().timeZone) {
|
|
75
|
+
const parts = getDtf(timeZone).formatToParts(date);
|
|
76
|
+
const bag: Record<string, number> = {};
|
|
77
|
+
for (const p of parts) {
|
|
78
|
+
if (p.type === "year" || p.type === "month" || p.type === "day"
|
|
79
|
+
|| p.type === "hour" || p.type === "minute" || p.type === "second") {
|
|
80
|
+
bag[p.type] = Number(p.value);
|
|
81
|
+
}
|
|
82
|
+
}
|
|
83
|
+
const asUtc = new Date(Date.UTC(bag.year, bag.month - 1, bag.day));
|
|
84
|
+
return {
|
|
85
|
+
year: bag.year, month: bag.month, day: bag.day,
|
|
86
|
+
hour: bag.hour, minute: bag.minute, second: bag.second, ms: date.getUTCMilliseconds(),
|
|
87
|
+
weekday: asUtc.getUTCDay(),
|
|
88
|
+
};
|
|
89
|
+
}
|
|
90
|
+
return {
|
|
91
|
+
year: date.getFullYear(), month: date.getMonth() + 1, day: date.getDate(),
|
|
92
|
+
hour: date.getHours(), minute: date.getMinutes(), second: date.getSeconds(),
|
|
93
|
+
ms: date.getMilliseconds(), weekday: date.getDay(),
|
|
94
|
+
};
|
|
95
|
+
}
|
|
96
|
+
|
|
97
|
+
/** Стенные часы → UTC, итеративно учитывая смещение (DST-safe). null — несуществующее время. */
|
|
98
|
+
export function wallToUtc(y: number, m: number, d: number, h: number, mi: number, timeZone?: string): Date | null {
|
|
99
|
+
const tz = timeZone || Intl.DateTimeFormat().resolvedOptions().timeZone;
|
|
100
|
+
const target = Date.UTC(y, m - 1, d, h, mi);
|
|
101
|
+
const matches = (ms: number): boolean => {
|
|
102
|
+
const p = zonedParts(new Date(ms), tz);
|
|
103
|
+
return p.year === y && p.month === m && p.day === d && p.hour === h && p.minute === mi;
|
|
104
|
+
};
|
|
105
|
+
let guess = target;
|
|
106
|
+
for (let i = 0; i < 4; i += 1) {
|
|
107
|
+
const p = zonedParts(new Date(guess), tz);
|
|
108
|
+
const actual = Date.UTC(p.year, p.month - 1, p.day, p.hour, p.minute);
|
|
109
|
+
const delta = target - actual;
|
|
110
|
+
if (delta === 0) break;
|
|
111
|
+
guess += delta;
|
|
112
|
+
}
|
|
113
|
+
// При переходе на зимнее время настенное время существует дважды. Для
|
|
114
|
+
// «следующего запуска» берём ПЕРВОЕ (более раннее) вхождение, а не то, к
|
|
115
|
+
// которому сошлась итерация. Обычно совпадение одно, тогда результат тот же.
|
|
116
|
+
const probes = [0, -30, 30, -60, 60, -90, 90, -120, 120].map(
|
|
117
|
+
(minutes) => guess + minutes * 60_000
|
|
118
|
+
);
|
|
119
|
+
let best: number | null = null;
|
|
120
|
+
for (const ms of probes) {
|
|
121
|
+
if (!matches(ms)) continue;
|
|
122
|
+
if (best === null || ms < best) best = ms;
|
|
123
|
+
}
|
|
124
|
+
return best === null ? null : new Date(best);
|
|
125
|
+
}
|
|
126
|
+
|
|
127
|
+
function lastDayOfMonth(y: number, m: number): number {
|
|
128
|
+
return new Date(Date.UTC(y, m, 0)).getUTCDate();
|
|
129
|
+
}
|
|
130
|
+
|
|
131
|
+
function nthWeekdayOfMonth(y: number, m: number, weekday: number, n: number): number | null {
|
|
132
|
+
const firstDow = new Date(Date.UTC(y, m - 1, 1)).getUTCDay();
|
|
133
|
+
const first = 1 + ((weekday - firstDow + 7) % 7);
|
|
134
|
+
const dom = first + 7 * (n - 1);
|
|
135
|
+
return dom <= lastDayOfMonth(y, m) ? dom : null;
|
|
136
|
+
}
|
|
137
|
+
|
|
138
|
+
function expandField(token: string, min: number, max: number, names?: Record<string, number>): Set<number> {
|
|
139
|
+
const result = new Set<number>();
|
|
140
|
+
const items = token.split(",");
|
|
141
|
+
for (const raw of items) {
|
|
142
|
+
let item = raw.trim().toUpperCase();
|
|
143
|
+
if (!item)
|
|
144
|
+
throw new Error(t("schedule.error.cronEmptyItem", { token }));
|
|
145
|
+
if (names && names[item] !== undefined) item = String(names[item]);
|
|
146
|
+
// шаг: a-b/n или */n
|
|
147
|
+
const stepMatch = item.match(/^(.*)\/([0-9]+)$/);
|
|
148
|
+
let step = 1;
|
|
149
|
+
if (stepMatch) {
|
|
150
|
+
item = (stepMatch[1] ?? "").trim();
|
|
151
|
+
step = Number(stepMatch[2]);
|
|
152
|
+
if (!Number.isInteger(step) || step < 1) {
|
|
153
|
+
throw new Error(
|
|
154
|
+
t("schedule.error.cronStepInvalid", {
|
|
155
|
+
step: stepMatch[2],
|
|
156
|
+
raw,
|
|
157
|
+
})
|
|
158
|
+
);
|
|
159
|
+
}
|
|
160
|
+
if (item === "")
|
|
161
|
+
throw new Error(t("schedule.error.cronStepMissing", { raw }));
|
|
162
|
+
}
|
|
163
|
+
if (item === "*" || item === "") {
|
|
164
|
+
for (let v = min; v <= max; v += step) result.add(v);
|
|
165
|
+
continue;
|
|
166
|
+
}
|
|
167
|
+
const rangeMatch = item.match(/^([0-9A-Z]+)-([0-9A-Z]+)$/);
|
|
168
|
+
if (rangeMatch) {
|
|
169
|
+
let aToken = rangeMatch[1];
|
|
170
|
+
let bToken = rangeMatch[2];
|
|
171
|
+
if (names && names[aToken] !== undefined) aToken = String(names[aToken]);
|
|
172
|
+
if (names && names[bToken] !== undefined) bToken = String(names[bToken]);
|
|
173
|
+
const a = Number(aToken);
|
|
174
|
+
const b = Number(bToken);
|
|
175
|
+
if (!Number.isFinite(a) || !Number.isFinite(b)) {
|
|
176
|
+
throw new Error(t("schedule.error.cronRangeInvalid", { item }));
|
|
177
|
+
}
|
|
178
|
+
if (a < min || b > max || a > b) {
|
|
179
|
+
throw new Error(
|
|
180
|
+
t("schedule.error.cronRangeBounds", { item, min, max })
|
|
181
|
+
);
|
|
182
|
+
}
|
|
183
|
+
for (let v = a; v <= b; v += step) result.add(v);
|
|
184
|
+
continue;
|
|
185
|
+
}
|
|
186
|
+
const num = Number(item);
|
|
187
|
+
if (!Number.isInteger(num) || num < min || num > max) {
|
|
188
|
+
throw new Error(
|
|
189
|
+
t("schedule.error.cronValueBounds", { raw, min, max })
|
|
190
|
+
);
|
|
191
|
+
}
|
|
192
|
+
result.add(num);
|
|
193
|
+
}
|
|
194
|
+
return result;
|
|
195
|
+
}
|
|
196
|
+
|
|
197
|
+
export interface ParsedCron {
|
|
198
|
+
/** Исходное выражение (после расширения @every). */
|
|
199
|
+
raw: string;
|
|
200
|
+
minute: Set<number>;
|
|
201
|
+
hour: Set<number>;
|
|
202
|
+
/** Дни месяца или null, если поле = «*» и не содержит L. */
|
|
203
|
+
dayOfMonth: Set<number> | null;
|
|
204
|
+
/** true — поле содержит «L» (последний день месяца). */
|
|
205
|
+
lastDom: boolean;
|
|
206
|
+
month: Set<number>;
|
|
207
|
+
/** День недели 0(Вс)..6(Сб) или null, если поле = «*» и не содержит «#». */
|
|
208
|
+
dayOfWeek: Set<number> | null;
|
|
209
|
+
/** Пары {weekday, n} для «#». */
|
|
210
|
+
nthWeekday: Array<{ weekday: number; n: number }>;
|
|
211
|
+
}
|
|
212
|
+
|
|
213
|
+
/** Разворачивает «@every 15m|2h|1d» в обычный cron. */
|
|
214
|
+
export function normalizeCron(expr: string): string {
|
|
215
|
+
const trimmed = expr.trim();
|
|
216
|
+
const match = trimmed.match(/^@every\s+(\d+)([mhd])$/i);
|
|
217
|
+
if (!match) return trimmed;
|
|
218
|
+
const n = Number(match[1]);
|
|
219
|
+
const unit = match[2].toLowerCase();
|
|
220
|
+
if (unit === "m" && n >= 1 && n < 60) return `*/${n} * * * *`;
|
|
221
|
+
if (unit === "h" && n >= 1 && n <= 23) return `0 */${n} * * *`;
|
|
222
|
+
if (unit === "d" && n >= 1 && n <= 31) return `0 0 */${n} * *`;
|
|
223
|
+
throw new Error(
|
|
224
|
+
t("schedule.error.everyInterval", { value: `${n}${unit}` })
|
|
225
|
+
);
|
|
226
|
+
}
|
|
227
|
+
|
|
228
|
+
/** Парсит cron-выражение; бросает Error с понятным сообщением. */
|
|
229
|
+
export function parseCron(expr: string): ParsedCron {
|
|
230
|
+
const raw = normalizeCron(expr);
|
|
231
|
+
const fields = raw.split(/\s+/);
|
|
232
|
+
if (fields.length !== 5) {
|
|
233
|
+
throw new Error(
|
|
234
|
+
t("schedule.error.cronFields", { count: fields.length, raw })
|
|
235
|
+
);
|
|
236
|
+
}
|
|
237
|
+
const [minF, hourF, domF, monthF, dowF] = fields;
|
|
238
|
+
|
|
239
|
+
const minute = expandField(minF, 0, 59);
|
|
240
|
+
const hour = expandField(hourF, 0, 23);
|
|
241
|
+
const month = expandField(monthF, 1, 12, MONTH_NAMES);
|
|
242
|
+
|
|
243
|
+
// dom: «*» + опциональный «L» в списке (например «15,L»).
|
|
244
|
+
let dayOfMonth: Set<number> | null = null;
|
|
245
|
+
let lastDom = false;
|
|
246
|
+
{
|
|
247
|
+
const tokens = domF.trim().toUpperCase().split(",").map((s) => s.trim());
|
|
248
|
+
const kept: string[] = [];
|
|
249
|
+
for (const token of tokens) {
|
|
250
|
+
if (token === "L") { lastDom = true; continue; }
|
|
251
|
+
kept.push(token);
|
|
252
|
+
}
|
|
253
|
+
if (domF.trim() !== "*") {
|
|
254
|
+
dayOfMonth = kept.length > 0 ? expandField(kept.join(","), 1, 31) : new Set();
|
|
255
|
+
}
|
|
256
|
+
}
|
|
257
|
+
|
|
258
|
+
// dow: «*» + имена + «d#n».
|
|
259
|
+
let dayOfWeek: Set<number> | null = null;
|
|
260
|
+
const nthWeekday: Array<{ weekday: number; n: number }> = [];
|
|
261
|
+
{
|
|
262
|
+
const tokens = dowF.trim().toUpperCase().split(",").map((s) => s.trim());
|
|
263
|
+
const kept: string[] = [];
|
|
264
|
+
for (const token of tokens) {
|
|
265
|
+
const hash = token.match(/^([0-9A-Z]+)#([1-5])$/);
|
|
266
|
+
if (hash) {
|
|
267
|
+
let dToken = hash[1];
|
|
268
|
+
if (DOW_NAMES[dToken] !== undefined) dToken = String(DOW_NAMES[dToken]);
|
|
269
|
+
const weekday = Number(dToken);
|
|
270
|
+
if (!Number.isInteger(weekday) || weekday < 0 || weekday > 7) {
|
|
271
|
+
throw new Error(
|
|
272
|
+
t("schedule.error.weekdayBounds", {
|
|
273
|
+
value: hash[1],
|
|
274
|
+
field: dowF,
|
|
275
|
+
})
|
|
276
|
+
);
|
|
277
|
+
}
|
|
278
|
+
nthWeekday.push({ weekday: weekday % 7, n: Number(hash[2]) });
|
|
279
|
+
continue;
|
|
280
|
+
}
|
|
281
|
+
if (token === "L") {
|
|
282
|
+
throw new Error(t("schedule.error.lastDomOnly"));
|
|
283
|
+
}
|
|
284
|
+
kept.push(token);
|
|
285
|
+
}
|
|
286
|
+
if (dowF.trim() !== "*") {
|
|
287
|
+
dayOfWeek = kept.length > 0 ? expandField(kept.join(","), 0, 7, DOW_NAMES) : new Set();
|
|
288
|
+
// 0 и 7 — оба воскресенье.
|
|
289
|
+
const mapped = new Set<number>();
|
|
290
|
+
for (const d of dayOfWeek) mapped.add(d % 7);
|
|
291
|
+
dayOfWeek = mapped;
|
|
292
|
+
}
|
|
293
|
+
}
|
|
294
|
+
|
|
295
|
+
return { raw, minute, hour, dayOfMonth, lastDom, month, dayOfWeek, nthWeekday };
|
|
296
|
+
}
|
|
297
|
+
|
|
298
|
+
function domMatches(p: { year: number; month: number; day: number }, spec: ParsedCron): boolean {
|
|
299
|
+
const last = lastDayOfMonth(p.year, p.month);
|
|
300
|
+
if (spec.dayOfMonth && spec.dayOfMonth.has(p.day)) return true;
|
|
301
|
+
if (spec.lastDom && p.day === last) return true;
|
|
302
|
+
return false;
|
|
303
|
+
}
|
|
304
|
+
|
|
305
|
+
function dowMatches(p: { year: number; month: number; day: number; weekday: number }, spec: ParsedCron): boolean {
|
|
306
|
+
if (spec.dayOfWeek && spec.dayOfWeek.has(p.weekday)) return true;
|
|
307
|
+
for (const { weekday, n } of spec.nthWeekday) {
|
|
308
|
+
const dom = nthWeekdayOfMonth(p.year, p.month, weekday, n);
|
|
309
|
+
if (dom === p.day) return true;
|
|
310
|
+
}
|
|
311
|
+
return false;
|
|
312
|
+
}
|
|
313
|
+
|
|
314
|
+
/** true, если cron срабатывает в указанную минуту (в системной или заданной tz). */
|
|
315
|
+
export function cronMatches(spec: ParsedCron, date: Date, timeZone?: string): boolean {
|
|
316
|
+
const p = zonedParts(date, timeZone);
|
|
317
|
+
if (!spec.minute.has(p.minute)) return false;
|
|
318
|
+
if (!spec.hour.has(p.hour)) return false;
|
|
319
|
+
if (!spec.month.has(p.month)) return false;
|
|
320
|
+
const domAny = spec.dayOfMonth === null && !spec.lastDom;
|
|
321
|
+
const dowAny = spec.dayOfWeek === null && spec.nthWeekday.length === 0;
|
|
322
|
+
const dm = domMatches(p, spec);
|
|
323
|
+
const dw = dowMatches(p, spec);
|
|
324
|
+
// Vixie OR-семантика: обе группы ограничены — достаточно совпадения одной.
|
|
325
|
+
if (domAny && dowAny) return true;
|
|
326
|
+
if (domAny) return dw;
|
|
327
|
+
if (dowAny) return dm;
|
|
328
|
+
return dm || dw;
|
|
329
|
+
}
|
|
330
|
+
|
|
331
|
+
function iterateDay(p: { year: number; month: number; day: number }, delta: 1 | -1): { year: number; month: number; day: number } {
|
|
332
|
+
const d = new Date(Date.UTC(p.year, p.month - 1, p.day + delta));
|
|
333
|
+
return { year: d.getUTCFullYear(), month: d.getUTCMonth() + 1, day: d.getUTCDate() };
|
|
334
|
+
}
|
|
335
|
+
|
|
336
|
+
function candidatesOnDay(
|
|
337
|
+
spec: ParsedCron,
|
|
338
|
+
y: number,
|
|
339
|
+
m: number,
|
|
340
|
+
d: number,
|
|
341
|
+
notBefore: { hour: number; minute: number } | null,
|
|
342
|
+
notAfter: { hour: number; minute: number } | null,
|
|
343
|
+
): Array<{ hour: number; minute: number }> {
|
|
344
|
+
const hours = [...spec.hour].sort((a, b) => a - b);
|
|
345
|
+
const minutes = [...spec.minute].sort((a, b) => a - b);
|
|
346
|
+
const result: Array<{ hour: number; minute: number }> = [];
|
|
347
|
+
for (const hour of hours) {
|
|
348
|
+
for (const minute of minutes) {
|
|
349
|
+
if (notBefore) {
|
|
350
|
+
if (hour < notBefore.hour || (hour === notBefore.hour && minute < notBefore.minute)) continue;
|
|
351
|
+
}
|
|
352
|
+
if (notAfter) {
|
|
353
|
+
if (hour > notAfter.hour || (hour === notAfter.hour && minute > notAfter.minute)) continue;
|
|
354
|
+
}
|
|
355
|
+
result.push({ hour, minute });
|
|
356
|
+
}
|
|
357
|
+
}
|
|
358
|
+
return result;
|
|
359
|
+
}
|
|
360
|
+
|
|
361
|
+
/**
|
|
362
|
+
* Ближайший запуск после `from` (или null, если найти не удалось за 5 лет).
|
|
363
|
+
* `timeZone` — IANA; по умолчанию системная.
|
|
364
|
+
*/
|
|
365
|
+
export function nextRun(expr: string, from: Date, timeZone?: string): Date | null {
|
|
366
|
+
const spec = parseCron(expr);
|
|
367
|
+
const base = from.getTime();
|
|
368
|
+
const origin = zonedParts(from, timeZone);
|
|
369
|
+
let cursor = { year: origin.year, month: origin.month, day: origin.day };
|
|
370
|
+
// Не считать время дня на первом дне: только строго после from.
|
|
371
|
+
let firstDay = true;
|
|
372
|
+
for (let i = 0; i < MAX_SEARCH_DAYS; i += 1) {
|
|
373
|
+
if (dayMatches(cursor.year, cursor.month, cursor.day, spec)) {
|
|
374
|
+
const nb = firstDay
|
|
375
|
+
? { hour: origin.hour, minute: origin.minute + 1 } // строго позже минуты from
|
|
376
|
+
: null;
|
|
377
|
+
const candidates = candidatesOnDay(spec, cursor.year, cursor.month, cursor.day, nb, null);
|
|
378
|
+
for (const cand of candidates) {
|
|
379
|
+
const at = wallToUtc(cursor.year, cursor.month, cursor.day, cand.hour, cand.minute, timeZone);
|
|
380
|
+
if (at && at.getTime() > base) return at;
|
|
381
|
+
}
|
|
382
|
+
}
|
|
383
|
+
firstDay = false;
|
|
384
|
+
cursor = iterateDay(cursor, 1);
|
|
385
|
+
}
|
|
386
|
+
return null;
|
|
387
|
+
}
|
|
388
|
+
|
|
389
|
+
/** Последний запуск не позже `from` (или null). */
|
|
390
|
+
export function prevRun(expr: string, from: Date, timeZone?: string): Date | null {
|
|
391
|
+
const spec = parseCron(expr);
|
|
392
|
+
const base = from.getTime();
|
|
393
|
+
const origin = zonedParts(from, timeZone);
|
|
394
|
+
let cursor = { year: origin.year, month: origin.month, day: origin.day };
|
|
395
|
+
let firstDay = true;
|
|
396
|
+
for (let i = 0; i < MAX_SEARCH_DAYS; i += 1) {
|
|
397
|
+
if (dayMatches(cursor.year, cursor.month, cursor.day, spec)) {
|
|
398
|
+
const na = firstDay
|
|
399
|
+
? { hour: origin.hour, minute: origin.minute } // включая текущую минуту
|
|
400
|
+
: null;
|
|
401
|
+
const candidates = candidatesOnDay(spec, cursor.year, cursor.month, cursor.day, null, na);
|
|
402
|
+
for (let i2 = candidates.length - 1; i2 >= 0; i2 -= 1) {
|
|
403
|
+
const cand = candidates[i2];
|
|
404
|
+
const at = wallToUtc(cursor.year, cursor.month, cursor.day, cand.hour, cand.minute, timeZone);
|
|
405
|
+
if (at && at.getTime() <= base) return at;
|
|
406
|
+
}
|
|
407
|
+
}
|
|
408
|
+
firstDay = false;
|
|
409
|
+
cursor = iterateDay(cursor, -1);
|
|
410
|
+
}
|
|
411
|
+
return null;
|
|
412
|
+
}
|
|
413
|
+
|
|
414
|
+
function dayMatches(y: number, m: number, d: number, spec: ParsedCron): boolean {
|
|
415
|
+
if (!spec.month.has(m)) return false;
|
|
416
|
+
const domAny = spec.dayOfMonth === null && !spec.lastDom;
|
|
417
|
+
const date = new Date(Date.UTC(y, m - 1, d));
|
|
418
|
+
const weekday = date.getUTCDay();
|
|
419
|
+
const p = { year: y, month: m, day: d, weekday };
|
|
420
|
+
if (domAny && spec.dayOfWeek === null && spec.nthWeekday.length === 0) return true;
|
|
421
|
+
const dm = domMatches({ year: y, month: m, day: d }, spec);
|
|
422
|
+
const dw = dowMatches(p, spec);
|
|
423
|
+
const dowAny = spec.dayOfWeek === null && spec.nthWeekday.length === 0;
|
|
424
|
+
if (domAny) return dw;
|
|
425
|
+
if (dowAny) return dm;
|
|
426
|
+
return dm || dw;
|
|
427
|
+
}
|
|
428
|
+
|
|
429
|
+
function dayStartUtc(y: number, m: number, d: number, timeZone?: string): Date {
|
|
430
|
+
const d0 = wallToUtc(y, m, d, 0, 0, timeZone);
|
|
431
|
+
return d0 ?? new Date(Date.UTC(y, m - 1, d, 0, 0));
|
|
432
|
+
}
|
|
433
|
+
|
|
434
|
+
|
|
435
|
+
// ---------------------------------------------------------------------------
|
|
436
|
+
// Окна запуска (notBefore/notAfter, «дд:мм» 24ч, можно через полночь).
|
|
437
|
+
|
|
438
|
+
const DAILY_TIME_RE = /^([01]\d|2[0-3]):[0-5]\d$/;
|
|
439
|
+
|
|
440
|
+
export function isValidDailyTime(value: string): boolean {
|
|
441
|
+
return DAILY_TIME_RE.test((value || "").trim());
|
|
442
|
+
}
|
|
443
|
+
|
|
444
|
+
function dailyTimeToMinutes(value: string): number {
|
|
445
|
+
const [h, m] = value.trim().split(":").map(Number);
|
|
446
|
+
return h * 60 + m;
|
|
447
|
+
}
|
|
448
|
+
|
|
449
|
+
/** Проверяет пару окна; возвращает текст ошибки или null. */
|
|
450
|
+
export function validateLaunchWindow(notBefore?: string | null, notAfter?: string | null): string | null {
|
|
451
|
+
if (notBefore === undefined && notAfter === undefined) return null;
|
|
452
|
+
const nb = notBefore?.trim() ?? "";
|
|
453
|
+
const na = notAfter?.trim() ?? "";
|
|
454
|
+
if (!nb && !na) return null;
|
|
455
|
+
if (nb && !isValidDailyTime(nb))
|
|
456
|
+
return t("schedule.error.notBeforeFormat", { value: nb });
|
|
457
|
+
if (na && !isValidDailyTime(na))
|
|
458
|
+
return t("schedule.error.notAfterFormat", { value: na });
|
|
459
|
+
if (!nb || !na) return t("schedule.error.windowTogether");
|
|
460
|
+
if (nb === na) return t("schedule.error.windowEmpty");
|
|
461
|
+
return null;
|
|
462
|
+
}
|
|
463
|
+
|
|
464
|
+
function wallMinutes(date: Date, timeZone?: string): { minutes: number; seconds: number; ms: number } {
|
|
465
|
+
const p = zonedParts(date, timeZone);
|
|
466
|
+
return { minutes: p.hour * 60 + p.minute, seconds: p.second, ms: p.ms };
|
|
467
|
+
}
|
|
468
|
+
|
|
469
|
+
/** Мы внутри окна запуска? */
|
|
470
|
+
export function isInWindow(now: Date, notBefore?: string | null, notAfter?: string | null, timeZone?: string): boolean {
|
|
471
|
+
if (validateLaunchWindow(notBefore, notAfter) !== null) return true; // невалидное окно не должно блокировать
|
|
472
|
+
if (!notBefore?.trim() && !notAfter?.trim()) return true;
|
|
473
|
+
const start = dailyTimeToMinutes(notBefore as string);
|
|
474
|
+
const end = dailyTimeToMinutes(notAfter as string);
|
|
475
|
+
const { minutes } = wallMinutes(now, timeZone);
|
|
476
|
+
if (start < end) return minutes >= start && minutes < end;
|
|
477
|
+
return minutes >= start || minutes < end; // через полночь
|
|
478
|
+
}
|
|
479
|
+
|
|
480
|
+
/** Сколько мс ждать до открытия окна (0 — уже открыто / окно не задано). */
|
|
481
|
+
export function windowDelayMs(now: Date, notBefore?: string | null, notAfter?: string | null, timeZone?: string): number {
|
|
482
|
+
if (validateLaunchWindow(notBefore, notAfter) !== null) return 0;
|
|
483
|
+
if (!notBefore?.trim() && !notAfter?.trim()) return 0;
|
|
484
|
+
if (isInWindow(now, notBefore, notAfter, timeZone)) return 0;
|
|
485
|
+
const start = dailyTimeToMinutes(notBefore as string);
|
|
486
|
+
const { minutes, seconds, ms } = wallMinutes(now, timeZone);
|
|
487
|
+
const deltaMin = (start - minutes + 1440) % 1440;
|
|
488
|
+
const deltaSec = deltaMin * 60 - seconds;
|
|
489
|
+
return Math.max(0, deltaSec * 1000 - ms);
|
|
490
|
+
}
|
|
491
|
+
|
|
492
|
+
// ---------------------------------------------------------------------------
|
|
493
|
+
// Дни недели и политика вне окна (Спринт 27).
|
|
494
|
+
|
|
495
|
+
/** 0=Вс..6=Сб. Пустой/полный список трактуется как «все дни» (undefined). */
|
|
496
|
+
export function normalizeActiveDays(days?: number[] | null): number[] | undefined {
|
|
497
|
+
if (!Array.isArray(days)) return undefined;
|
|
498
|
+
const unique = [
|
|
499
|
+
...new Set(
|
|
500
|
+
days
|
|
501
|
+
.map((value) => Math.floor(Number(value)))
|
|
502
|
+
.filter((value) => Number.isInteger(value) && value >= 0 && value <= 6)
|
|
503
|
+
),
|
|
504
|
+
].sort((a, b) => a - b);
|
|
505
|
+
if (unique.length === 0 || unique.length === 7) return undefined;
|
|
506
|
+
return unique;
|
|
507
|
+
}
|
|
508
|
+
|
|
509
|
+
/** Разрешён ли день недели (в поясе задачи). */
|
|
510
|
+
export function isActiveDay(now: Date, days?: number[] | null, timeZone?: string): boolean {
|
|
511
|
+
const normalized = normalizeActiveDays(days);
|
|
512
|
+
if (!normalized) return true;
|
|
513
|
+
return normalized.includes(zonedParts(now, timeZone).weekday);
|
|
514
|
+
}
|
|
515
|
+
|
|
516
|
+
export interface ActiveWindowOptions {
|
|
517
|
+
notBefore?: string | null;
|
|
518
|
+
notAfter?: string | null;
|
|
519
|
+
days?: number[] | null;
|
|
520
|
+
timeZone?: string;
|
|
521
|
+
}
|
|
522
|
+
|
|
523
|
+
export interface ActiveWindowState {
|
|
524
|
+
/** Можно запускать сейчас. */
|
|
525
|
+
active: boolean;
|
|
526
|
+
/** Почему нельзя (человекочитаемо, для dry-run и логов). */
|
|
527
|
+
reason?: string;
|
|
528
|
+
/** Ближайшее открытие окна; null — не требуется или не найдено. */
|
|
529
|
+
nextOpenAt: Date | null;
|
|
530
|
+
}
|
|
531
|
+
|
|
532
|
+
const WINDOW_SCAN_MINUTES = 8 * 24 * 60;
|
|
533
|
+
|
|
534
|
+
/** Ближайшая минута, когда и день, и окно разрешают запуск. */
|
|
535
|
+
export function nextWindowOpenAt(now: Date, options: ActiveWindowOptions): Date | null {
|
|
536
|
+
const { notBefore, notAfter, timeZone } = options;
|
|
537
|
+
const normalizedDays = normalizeActiveDays(options.days);
|
|
538
|
+
const hasWindow = Boolean((notBefore || "").trim() || (notAfter || "").trim());
|
|
539
|
+
if (!hasWindow && !normalizedDays) return null;
|
|
540
|
+
const invalidWindow = validateLaunchWindow(notBefore, notAfter) !== null;
|
|
541
|
+
for (let i = 1; i <= WINDOW_SCAN_MINUTES; i++) {
|
|
542
|
+
const candidate = new Date(now.getTime() + i * 60_000);
|
|
543
|
+
const dayOk =
|
|
544
|
+
!normalizedDays || normalizedDays.includes(zonedParts(candidate, timeZone).weekday);
|
|
545
|
+
const windowOk = invalidWindow || isInWindow(candidate, notBefore, notAfter, timeZone);
|
|
546
|
+
if (dayOk && windowOk) return candidate;
|
|
547
|
+
}
|
|
548
|
+
return null;
|
|
549
|
+
}
|
|
550
|
+
|
|
551
|
+
/** Состояние окна с учётом дней недели. */
|
|
552
|
+
export function activeWindowState(now: Date, options: ActiveWindowOptions = {}): ActiveWindowState {
|
|
553
|
+
const normalizedDays = normalizeActiveDays(options.days);
|
|
554
|
+
const dayOk =
|
|
555
|
+
!normalizedDays ||
|
|
556
|
+
normalizedDays.includes(zonedParts(now, options.timeZone).weekday);
|
|
557
|
+
const windowOk = isInWindow(now, options.notBefore, options.notAfter, options.timeZone);
|
|
558
|
+
if (dayOk && windowOk) return { active: true, nextOpenAt: null };
|
|
559
|
+
|
|
560
|
+
const reasons: string[] = [];
|
|
561
|
+
if (!dayOk) {
|
|
562
|
+
const days = (normalizedDays ?? [])
|
|
563
|
+
.map((d) => t(`schedule.weekday.${d}`))
|
|
564
|
+
.join(", ");
|
|
565
|
+
reasons.push(t("schedule.reason.dayNotAllowed", { days }));
|
|
566
|
+
}
|
|
567
|
+
if (!windowOk) {
|
|
568
|
+
reasons.push(
|
|
569
|
+
t("schedule.reason.outsideWindow", {
|
|
570
|
+
notBefore: options.notBefore,
|
|
571
|
+
notAfter: options.notAfter,
|
|
572
|
+
})
|
|
573
|
+
);
|
|
574
|
+
}
|
|
575
|
+
return {
|
|
576
|
+
active: false,
|
|
577
|
+
reason: reasons.join("; "),
|
|
578
|
+
nextOpenAt: nextWindowOpenAt(now, options),
|
|
579
|
+
};
|
|
580
|
+
}
|
|
581
|
+
|
|
582
|
+
/** Сколько мс до следующего разрешённого окна (0 — можно запускать). */
|
|
583
|
+
export function nextWindowOpenDelayMs(now: Date, options: ActiveWindowOptions = {}): number {
|
|
584
|
+
const state = activeWindowState(now, options);
|
|
585
|
+
if (state.active) return 0;
|
|
586
|
+
return state.nextOpenAt ? Math.max(0, state.nextOpenAt.getTime() - now.getTime()) : 0;
|
|
587
|
+
}
|
|
588
|
+
|
|
589
|
+
// ---------------------------------------------------------------------------
|
|
590
|
+
// Проверка совместимости с schtasks (родной режим).
|
|
591
|
+
|
|
592
|
+
/**
|
|
593
|
+
* true, если выражение умеет оформить Windows Task Scheduler «родными»
|
|
594
|
+
* флагами (MINUTE/HOURLY/DAILY/WEEKLY) и парсится строгим конвертером.
|
|
595
|
+
* Используется для выбора между флагами и минутным опросом.
|
|
596
|
+
*/
|
|
597
|
+
export function isNativeSchtasksExpr(expr: string): boolean {
|
|
598
|
+
try {
|
|
599
|
+
convertCronToSchTasks(normalizeCron(expr));
|
|
600
|
+
return true;
|
|
601
|
+
} catch {
|
|
602
|
+
return false;
|
|
603
|
+
}
|
|
604
|
+
}
|
|
605
|
+
|
|
606
|
+
/** Конвертер для родного режима; бросает Error для неподдерживаемых. */
|
|
607
|
+
export function convertForSchtasks(expr: string): CronConversion {
|
|
608
|
+
return convertCronToSchTasks(normalizeCron(expr));
|
|
609
|
+
}
|
|
610
|
+
|
|
611
|
+
// ---------------------------------------------------------------------------
|
|
612
|
+
// Политика планирования одной задачи (общий код для Windows-бека и index.ts).
|
|
613
|
+
|
|
614
|
+
/** Аргументы schedule-gate, которые запекаются во враппер (cron/tz/окно/пернос). */
|
|
615
|
+
export interface ScheduleGateSpec {
|
|
616
|
+
/**
|
|
617
|
+
* Cron-выражение для повторной проверки внутри обёртки. Задаётся только в
|
|
618
|
+
* poll-режиме: при родном триггере ОС уже сработала точно по cron, и повторная
|
|
619
|
+
* проверка ломала бы ручной запуск и catch-up.
|
|
620
|
+
*/
|
|
621
|
+
cron?: string;
|
|
622
|
+
tz?: string;
|
|
623
|
+
notBefore?: string;
|
|
624
|
+
notAfter?: string;
|
|
625
|
+
/** Разрешённые дни недели (0=Вс..6=Сб); пусто — все дни. */
|
|
626
|
+
days?: number[];
|
|
627
|
+
/** Поведение вне окна: skip — пропустить, run — выполнить всё равно. */
|
|
628
|
+
windowPolicy?: "skip" | "run";
|
|
629
|
+
}
|
|
630
|
+
|
|
631
|
+
/**
|
|
632
|
+
* true, если ОС-триггер не выражает расписание (чужой IANA-таймзона или
|
|
633
|
+
* не конвертируемо в флаги schtasks) — нужен минутный опрос + gate.
|
|
634
|
+
*/
|
|
635
|
+
export function needsPollMode(expr: string, timezone?: string | null): boolean {
|
|
636
|
+
const tz = (timezone || "").trim();
|
|
637
|
+
if (tz && tz !== systemTimeZone()) return true;
|
|
638
|
+
return !isNativeSchtasksExpr(expr);
|
|
639
|
+
}
|
|
640
|
+
|
|
641
|
+
/**
|
|
642
|
+
* Аргументы schedule-gate для враппера, либо undefined — если врапперу гейт
|
|
643
|
+
* не нужен (нативный cron + системный таймзона + окно не задано).
|
|
644
|
+
* Окно запуска всегда требует gate (перенос реализует враппер).
|
|
645
|
+
*/
|
|
646
|
+
export function buildScheduleGate(
|
|
647
|
+
expr: string,
|
|
648
|
+
timezone?: string | null,
|
|
649
|
+
notBefore?: string,
|
|
650
|
+
notAfter?: string,
|
|
651
|
+
days?: number[] | null,
|
|
652
|
+
windowPolicy?: string | null
|
|
653
|
+
): ScheduleGateSpec | undefined {
|
|
654
|
+
const tz = (timezone || "").trim() || undefined;
|
|
655
|
+
const poll = needsPollMode(expr, tz);
|
|
656
|
+
const normalizedDays = normalizeActiveDays(days);
|
|
657
|
+
const policy = windowPolicy === "skip" || windowPolicy === "run" ? windowPolicy : undefined;
|
|
658
|
+
if (!poll && !(notBefore && notAfter) && !normalizedDays) return undefined;
|
|
659
|
+
// cron проверяем только в poll-режиме (см. комментарий у ScheduleGateSpec).
|
|
660
|
+
return {
|
|
661
|
+
...(poll ? { cron: expr } : {}),
|
|
662
|
+
tz,
|
|
663
|
+
notBefore,
|
|
664
|
+
notAfter,
|
|
665
|
+
...(normalizedDays ? { days: normalizedDays } : {}),
|
|
666
|
+
...(policy ? { windowPolicy: policy } : {}),
|
|
667
|
+
};
|
|
668
|
+
}
|