opencode-windows-scheduler 1.4.0 → 1.5.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (63) hide show
  1. package/CHANGELOG.md +24 -0
  2. package/README.md +2 -2
  3. package/ROADMAP-STRATEGY.md +43 -24
  4. package/ROADMAP.md +280 -31
  5. package/dist/core/dry-run.d.ts +31 -0
  6. package/dist/core/dry-run.d.ts.map +1 -1
  7. package/dist/core/dry-run.js +129 -1
  8. package/dist/core/file-watcher.d.ts.map +1 -1
  9. package/dist/core/file-watcher.js +53 -10
  10. package/dist/core/git-trigger.d.ts +80 -0
  11. package/dist/core/git-trigger.d.ts.map +1 -0
  12. package/dist/core/git-trigger.js +288 -0
  13. package/dist/core/glob.d.ts +38 -0
  14. package/dist/core/glob.d.ts.map +1 -0
  15. package/dist/core/glob.js +233 -0
  16. package/dist/core/ps-wrapper.d.ts.map +1 -1
  17. package/dist/core/ps-wrapper.js +7 -0
  18. package/dist/core/schedule-gate.js +55 -30
  19. package/dist/core/schedule-v2.d.ts +29 -1
  20. package/dist/core/schedule-v2.d.ts.map +1 -1
  21. package/dist/core/schedule-v2.js +81 -3
  22. package/dist/core/scheduler/types.d.ts +1 -1
  23. package/dist/core/scheduler/types.d.ts.map +1 -1
  24. package/dist/core/wrappers/bash.d.ts.map +1 -1
  25. package/dist/core/wrappers/bash.js +4 -0
  26. package/dist/db/git-state-repo.d.ts +16 -0
  27. package/dist/db/git-state-repo.d.ts.map +1 -0
  28. package/dist/db/git-state-repo.js +38 -0
  29. package/dist/db/schema.d.ts +1 -1
  30. package/dist/db/schema.d.ts.map +1 -1
  31. package/dist/db/schema.js +8 -0
  32. package/dist/index.d.ts +44 -0
  33. package/dist/index.d.ts.map +1 -1
  34. package/dist/index.js +247 -26
  35. package/dist/rpc.d.ts +223 -0
  36. package/dist/rpc.d.ts.map +1 -1
  37. package/dist/rpc.js +73 -0
  38. package/dist/task-transfer.d.ts +30 -3
  39. package/dist/task-transfer.d.ts.map +1 -1
  40. package/dist/task-transfer.js +83 -6
  41. package/dist/templates.d.ts +1 -1
  42. package/dist/templates.d.ts.map +1 -1
  43. package/docs/ARCHITECTURE.md +1 -0
  44. package/docs/FEATURES.md +51 -0
  45. package/docs/README.ru.md +2 -2
  46. package/gui-experimental.cjs +9 -4
  47. package/package.json +6 -3
  48. package/src/core/dry-run.ts +188 -1
  49. package/src/core/file-watcher.ts +65 -10
  50. package/src/core/git-trigger.ts +367 -0
  51. package/src/core/glob.ts +226 -0
  52. package/src/core/ps-wrapper.ts +7 -0
  53. package/src/core/schedule-gate.ts +67 -33
  54. package/src/core/schedule-v2.ts +108 -3
  55. package/src/core/scheduler/types.ts +1 -1
  56. package/src/core/wrappers/bash.ts +4 -0
  57. package/src/db/git-state-repo.ts +62 -0
  58. package/src/db/schema.ts +8 -0
  59. package/src/gui.tsx +225 -4
  60. package/src/index.ts +338 -28
  61. package/src/rpc.ts +73 -0
  62. package/src/task-transfer.ts +124 -5
  63. package/src/templates.ts +1 -1
@@ -0,0 +1,38 @@
1
+ /**
2
+ * Glob-маски без внешних зависимостей (Спринт 27).
3
+ *
4
+ * Поддерживается подмножество, достаточное для фильтров файловых и git-триггеров:
5
+ * * — любые символы, кроме "/"
6
+ * ** — любые символы, включая "/" (в т.ч. ноль сегментов: `src/**\/x.ts`)
7
+ * ? — один символ, кроме "/"
8
+ * [abc] — класс символов, [a-z] — диапазон, [!abc] / [^abc] — отрицание
9
+ * {a,b} — альтернативы (в т.ч. вложенные)
10
+ * !pattern — отрицание маски (для ignore-списков, обрабатывается matchesAnyGlob)
11
+ *
12
+ * Пути нормализуются к POSIX-виду ("\" → "/"), ведущий "./" отбрасывается.
13
+ * На Windows сравнение регистронезависимое, на остальных платформах — точное.
14
+ */
15
+ /** Нормализует путь или маску: "/" как разделитель, без ведущего "./". */
16
+ export declare function normalizePath(value: unknown): string;
17
+ /**
18
+ * Преобразует glob-маску в регулярное выражение.
19
+ * Маска предполагается полной (от начала до конца строки).
20
+ */
21
+ export declare function globToRegExp(pattern: unknown): RegExp;
22
+ /** true, если путь матчится хотя бы одной маске. */
23
+ export declare function matchesGlob(path: unknown, pattern: unknown): boolean;
24
+ /**
25
+ * Проверяет путь по списку масок с поддержкой отрицаний.
26
+ * `!pattern` исключает совпадение; порядок важен (последнее правило побеждает).
27
+ */
28
+ export declare function matchesAnyGlob(path: unknown, patterns: unknown): boolean;
29
+ /** true, если путь не попал ни в одну маску из ignore-списка (или список пуст). */
30
+ export declare function isIgnored(path: unknown, ignore: unknown): boolean;
31
+ /**
32
+ * Отбирает файлы по include-маскам с учётом ignore-списка.
33
+ * Пустой include-список означает «любой файл».
34
+ */
35
+ export declare function filterPaths(files: string[], include?: string[] | null, ignore?: string[] | null): string[];
36
+ /** Относительный путь файла от каталога; null, если файл вне каталога. */
37
+ export declare function relativeTo(base: unknown, file: unknown): string | null;
38
+ //# sourceMappingURL=glob.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"glob.d.ts","sourceRoot":"","sources":["../../src/core/glob.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAIH,0EAA0E;AAC1E,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAOpD;AAOD;;;GAGG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,CAwFrD;AAqBD,oDAAoD;AACpD,wBAAgB,WAAW,CAAC,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,GAAG,OAAO,CAWpE;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,OAAO,EAAE,QAAQ,EAAE,OAAO,GAAG,OAAO,CAaxE;AAED,mFAAmF;AACnF,wBAAgB,SAAS,CAAC,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,GAAG,OAAO,CAUjE;AAED;;;GAGG;AACH,wBAAgB,WAAW,CACzB,KAAK,EAAE,MAAM,EAAE,EACf,OAAO,CAAC,EAAE,MAAM,EAAE,GAAG,IAAI,EACzB,MAAM,CAAC,EAAE,MAAM,EAAE,GAAG,IAAI,GACvB,MAAM,EAAE,CAUV;AAED,0EAA0E;AAC1E,wBAAgB,UAAU,CAAC,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI,CAatE"}
@@ -0,0 +1,233 @@
1
+ /**
2
+ * Glob-маски без внешних зависимостей (Спринт 27).
3
+ *
4
+ * Поддерживается подмножество, достаточное для фильтров файловых и git-триггеров:
5
+ * * — любые символы, кроме "/"
6
+ * ** — любые символы, включая "/" (в т.ч. ноль сегментов: `src/**\/x.ts`)
7
+ * ? — один символ, кроме "/"
8
+ * [abc] — класс символов, [a-z] — диапазон, [!abc] / [^abc] — отрицание
9
+ * {a,b} — альтернативы (в т.ч. вложенные)
10
+ * !pattern — отрицание маски (для ignore-списков, обрабатывается matchesAnyGlob)
11
+ *
12
+ * Пути нормализуются к POSIX-виду ("\" → "/"), ведущий "./" отбрасывается.
13
+ * На Windows сравнение регистронезависимое, на остальных платформах — точное.
14
+ */
15
+ const WINDOWS = process.platform === "win32";
16
+ /** Нормализует путь или маску: "/" как разделитель, без ведущего "./". */
17
+ export function normalizePath(value) {
18
+ let text = String(value ?? "").trim().replace(/\\/g, "/");
19
+ if (!text)
20
+ return "";
21
+ while (text.startsWith("./"))
22
+ text = text.slice(2);
23
+ // Схлопываем повторные слэши, но не трогаем начало (UNC уже приведён к "/").
24
+ text = text.replace(/\/{2,}/g, "/");
25
+ return text;
26
+ }
27
+ /** Экранирует символ регулярного выражения. */
28
+ function escapeRe(ch) {
29
+ return /[.+^$()|[\]\\]/.test(ch) ? `\\${ch}` : ch;
30
+ }
31
+ /**
32
+ * Преобразует glob-маску в регулярное выражение.
33
+ * Маска предполагается полной (от начала до конца строки).
34
+ */
35
+ export function globToRegExp(pattern) {
36
+ const source = normalizePath(pattern);
37
+ let out = "^";
38
+ const compile = (text) => {
39
+ let result = "";
40
+ let j = 0;
41
+ while (j < text.length) {
42
+ const ch = text[j];
43
+ if (ch === "*") {
44
+ if (text[j + 1] === "*") {
45
+ const isSegment = (j === 0 || text[j - 1] === "/") && text[j + 2] === "/";
46
+ if (isSegment) {
47
+ // "**/" — ноль или более сегментов пути.
48
+ result += "(?:[^/]+/)*";
49
+ j += 3;
50
+ continue;
51
+ }
52
+ if (j > 0 && text[j - 1] === "/") {
53
+ result += "(?:[^/]+/)*[^/]*";
54
+ }
55
+ else {
56
+ result += ".*";
57
+ }
58
+ j += 2;
59
+ continue;
60
+ }
61
+ result += "[^/]*";
62
+ j += 1;
63
+ continue;
64
+ }
65
+ if (ch === "?") {
66
+ result += "[^/]";
67
+ j += 1;
68
+ continue;
69
+ }
70
+ if (ch === "[") {
71
+ const close = text.indexOf("]", j + 1);
72
+ if (close === -1) {
73
+ result += "\\[";
74
+ j += 1;
75
+ continue;
76
+ }
77
+ let body = text.slice(j + 1, close);
78
+ if (body.startsWith("!"))
79
+ body = `^${body.slice(1)}`;
80
+ else if (body.startsWith("^"))
81
+ body = `\\${body}`;
82
+ result += `[${body}]`;
83
+ j = close + 1;
84
+ continue;
85
+ }
86
+ if (ch === "{") {
87
+ // Находим парную закрывающую скобку.
88
+ let depth = 0;
89
+ let end = -1;
90
+ for (let k = j; k < text.length; k++) {
91
+ if (text[k] === "{")
92
+ depth++;
93
+ else if (text[k] === "}") {
94
+ depth--;
95
+ if (depth === 0) {
96
+ end = k;
97
+ break;
98
+ }
99
+ }
100
+ }
101
+ if (end === -1) {
102
+ result += "\\{";
103
+ j += 1;
104
+ continue;
105
+ }
106
+ const body = text.slice(j + 1, end);
107
+ const parts = splitAlternatives(body);
108
+ result += `(?:${parts.map((part) => compile(part)).join("|")})`;
109
+ j = end + 1;
110
+ continue;
111
+ }
112
+ if (ch === "}") {
113
+ result += "\\}";
114
+ j += 1;
115
+ continue;
116
+ }
117
+ result += escapeRe(ch);
118
+ j += 1;
119
+ }
120
+ return result;
121
+ };
122
+ out += compile(source);
123
+ out += "$";
124
+ return new RegExp(out, WINDOWS ? "i" : "");
125
+ }
126
+ /** Разбивает "{a,b,c}" по запятым верхнего уровня. */
127
+ function splitAlternatives(body) {
128
+ const parts = [];
129
+ let depth = 0;
130
+ let current = "";
131
+ for (const ch of body) {
132
+ if (ch === "{")
133
+ depth++;
134
+ if (ch === "}")
135
+ depth--;
136
+ if (ch === "," && depth === 0) {
137
+ parts.push(current);
138
+ current = "";
139
+ continue;
140
+ }
141
+ current += ch;
142
+ }
143
+ parts.push(current);
144
+ return parts;
145
+ }
146
+ /** true, если путь матчится хотя бы одной маске. */
147
+ export function matchesGlob(path, pattern) {
148
+ const candidate = normalizePath(path);
149
+ if (!candidate)
150
+ return false;
151
+ const re = globToRegExp(pattern);
152
+ if (re.test(candidate))
153
+ return true;
154
+ // Маска каталога "src/**" должна матчить и сам "src".
155
+ const raw = normalizePath(pattern).replace(/\/$/, "");
156
+ if (raw.endsWith("/**")) {
157
+ return globToRegExp(raw.slice(0, -3)).test(candidate);
158
+ }
159
+ return false;
160
+ }
161
+ /**
162
+ * Проверяет путь по списку масок с поддержкой отрицаний.
163
+ * `!pattern` исключает совпадение; порядок важен (последнее правило побеждает).
164
+ */
165
+ export function matchesAnyGlob(path, patterns) {
166
+ if (!Array.isArray(patterns))
167
+ return false;
168
+ let matched = false;
169
+ for (const pattern of patterns) {
170
+ const text = String(pattern ?? "").trim();
171
+ if (!text)
172
+ continue;
173
+ if (text.startsWith("!")) {
174
+ if (matchesGlob(path, text.slice(1)))
175
+ matched = false;
176
+ }
177
+ else if (matchesGlob(path, text)) {
178
+ matched = true;
179
+ }
180
+ }
181
+ return matched;
182
+ }
183
+ /** true, если путь не попал ни в одну маску из ignore-списка (или список пуст). */
184
+ export function isIgnored(path, ignore) {
185
+ if (!Array.isArray(ignore) || ignore.length === 0)
186
+ return false;
187
+ const candidate = normalizePath(path);
188
+ for (const pattern of ignore) {
189
+ const text = String(pattern ?? "").trim();
190
+ if (!text)
191
+ continue;
192
+ if (text.startsWith("!"))
193
+ continue;
194
+ if (matchesGlob(candidate, text))
195
+ return true;
196
+ }
197
+ return false;
198
+ }
199
+ /**
200
+ * Отбирает файлы по include-маскам с учётом ignore-списка.
201
+ * Пустой include-список означает «любой файл».
202
+ */
203
+ export function filterPaths(files, include, ignore) {
204
+ const list = Array.isArray(files) ? files : [];
205
+ const includes = Array.isArray(include) ? include.filter(Boolean) : [];
206
+ return list.filter((file) => {
207
+ const path = normalizePath(file);
208
+ if (!path)
209
+ return false;
210
+ if (isIgnored(path, ignore))
211
+ return false;
212
+ if (includes.length === 0)
213
+ return true;
214
+ return matchesAnyGlob(path, includes);
215
+ });
216
+ }
217
+ /** Относительный путь файла от каталога; null, если файл вне каталога. */
218
+ export function relativeTo(base, file) {
219
+ const root = normalizePath(base).replace(/\/$/, "");
220
+ const target = normalizePath(file);
221
+ if (!root)
222
+ return target;
223
+ if (target === root)
224
+ return "";
225
+ const prefix = root.endsWith("/") ? root : `${root}/`;
226
+ if (WINDOWS) {
227
+ if (target.toLowerCase().startsWith(prefix.toLowerCase())) {
228
+ return target.slice(prefix.length);
229
+ }
230
+ return null;
231
+ }
232
+ return target.startsWith(prefix) ? target.slice(prefix.length) : null;
233
+ }
@@ -1 +1 @@
1
- {"version":3,"file":"ps-wrapper.d.ts","sourceRoot":"","sources":["../../src/core/ps-wrapper.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAQzD;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,eAAO,MAAM,cAAc,8yyBAmZ1B,CAAC;AAEF;;;GAGG;AACH,wBAAsB,aAAa,IAAI,OAAO,CAAC,MAAM,CAAC,CAOrD;AAED;;GAEG;AACH,wBAAsB,eAAe,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CASvF;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAErD;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,wBAAsB,eAAe,CACnC,aAAa,EAAE,MAAM,EACrB,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,MAAM,EAClB,cAAc,EAAE,MAAM,EACtB,QAAQ,EAAE,MAAM,EAChB,OAAO,CAAC,EAAE,MAAM,EAChB,OAAO,CAAC,EAAE,MAAM,EAChB,YAAY,CAAC,EAAE,MAAM,EACrB,WAAW,CAAC,EAAE,MAAM,EACpB,KAAK,CAAC,EAAE,MAAM,EACd,YAAY,CAAC,EAAE,MAAM,EACrB,WAAW,CAAC,EAAE,MAAM,EACpB,aAAa,CAAC,EAAE,MAAM,EACtB,YAAY,CAAC,EAAE,MAAM,EAAE,EACvB,WAAW,CAAC,EAAE,MAAM,EAAE,EACtB,YAAY,CAAC,EAAE,gBAAgB,GAAG;IAChC,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB,EACD,OAAO,CAAC,EAAE,MAAM,EAChB,WAAW,CAAC,EAAE,KAAK,GAAG,OAAO,GAAG,MAAM,EACtC,SAAS,CAAC,EAAE,MAAM,GACjB,OAAO,CAAC,MAAM,CAAC,CA6IjB;AAKD,kFAAkF;AAClF,eAAO,MAAM,iBAAiB,QAAgB,CAAC;AAE/C;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAEtD;AAED;;;;;;;;;;;GAWG;AACH,wBAAsB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAc3E"}
1
+ {"version":3,"file":"ps-wrapper.d.ts","sourceRoot":"","sources":["../../src/core/ps-wrapper.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAQzD;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,eAAO,MAAM,cAAc,8yyBAmZ1B,CAAC;AAEF;;;GAGG;AACH,wBAAsB,aAAa,IAAI,OAAO,CAAC,MAAM,CAAC,CAOrD;AAED;;GAEG;AACH,wBAAsB,eAAe,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CASvF;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAErD;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,wBAAsB,eAAe,CACnC,aAAa,EAAE,MAAM,EACrB,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,MAAM,EAClB,cAAc,EAAE,MAAM,EACtB,QAAQ,EAAE,MAAM,EAChB,OAAO,CAAC,EAAE,MAAM,EAChB,OAAO,CAAC,EAAE,MAAM,EAChB,YAAY,CAAC,EAAE,MAAM,EACrB,WAAW,CAAC,EAAE,MAAM,EACpB,KAAK,CAAC,EAAE,MAAM,EACd,YAAY,CAAC,EAAE,MAAM,EACrB,WAAW,CAAC,EAAE,MAAM,EACpB,aAAa,CAAC,EAAE,MAAM,EACtB,YAAY,CAAC,EAAE,MAAM,EAAE,EACvB,WAAW,CAAC,EAAE,MAAM,EAAE,EACtB,YAAY,CAAC,EAAE,gBAAgB,GAAG;IAChC,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB,EACD,OAAO,CAAC,EAAE,MAAM,EAChB,WAAW,CAAC,EAAE,KAAK,GAAG,OAAO,GAAG,MAAM,EACtC,SAAS,CAAC,EAAE,MAAM,GACjB,OAAO,CAAC,MAAM,CAAC,CAoJjB;AAKD,kFAAkF;AAClF,eAAO,MAAM,iBAAiB,QAAgB,CAAC;AAE/C;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAEtD;AAED;;;;;;;;;;;GAWG;AACH,wBAAsB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAc3E"}
@@ -597,6 +597,13 @@ export async function writeWrapperCmd(sanitizedName, taskName, promptFile, timeo
597
597
  if (scheduleGate.notAfter?.trim()) {
598
598
  gateArgs.push(`--not-after ${scheduleGate.notAfter.trim()}`);
599
599
  }
600
+ // Спринт 27: дни недели и политика окна.
601
+ if (Array.isArray(scheduleGate.days) && scheduleGate.days.length > 0) {
602
+ gateArgs.push(`--days ${scheduleGate.days.join(",")}`);
603
+ }
604
+ if (scheduleGate.windowPolicy) {
605
+ gateArgs.push(`--window-policy ${scheduleGate.windowPolicy}`);
606
+ }
600
607
  if (scheduleGate.deferFile?.trim()) {
601
608
  gateArgs.push(`--defer-file "${scheduleGate.deferFile.trim()}"`);
602
609
  }
@@ -28,10 +28,12 @@
28
28
  * перезаписывается.
29
29
  */
30
30
  import fs from "node:fs";
31
- import { cronMatches, isValidIanaTimeZone, isInWindow, parseCron, validateLaunchWindow, windowDelayMs, } from "./schedule-v2.js";
31
+ import { activeWindowState, cronMatches, isValidIanaTimeZone, normalizeActiveDays, parseCron, validateLaunchWindow, } from "./schedule-v2.js";
32
32
  const STALE_DEFER_MS = 25 * 60 * 60 * 1000;
33
33
  /** Сколько живёт маркер ручного запуска. */
34
34
  const FORCE_TTL_MS = 2 * 60 * 1000;
35
+ /** Дольше 12 часов перенос не ждём — тик просто пропускается. */
36
+ const MAX_POSTPONE_MS = 12 * 60 * 60 * 1000;
35
37
  function argValue(args, name) {
36
38
  const idx = args.indexOf(name);
37
39
  if (idx === -1 || idx + 1 >= args.length)
@@ -103,9 +105,18 @@ async function main() {
103
105
  const tz = argValue(args, "--tz");
104
106
  const notBefore = argValue(args, "--not-before");
105
107
  const notAfter = argValue(args, "--not-after");
108
+ const daysArg = argValue(args, "--days");
109
+ const policyArg = argValue(args, "--window-policy");
106
110
  const deferFile = argValue(args, "--defer-file");
107
111
  const forceFile = argValue(args, "--force-file");
108
112
  const nowArg = argValue(args, "--now");
113
+ const days = daysArg
114
+ ? normalizeActiveDays(daysArg
115
+ .split(",")
116
+ .map((value) => Number(value.trim()))
117
+ .filter((value) => Number.isFinite(value)))
118
+ : undefined;
119
+ const policy = policyArg === "skip" || policyArg === "run" ? policyArg : "postpone";
109
120
  const now = nowArg ? new Date(nowArg) : new Date();
110
121
  if (Number.isNaN(now.getTime())) {
111
122
  console.error(`[schedule-gate] Некорректное значение --now: ${nowArg}`);
@@ -126,7 +137,6 @@ async function main() {
126
137
  if (windowError) {
127
138
  console.error(`[schedule-gate] Окно запуска игнорируется: ${windowError}`);
128
139
  }
129
- const windowOk = !windowError && !!notBefore && !!notAfter;
130
140
  let spec = null;
131
141
  if (cronExpr) {
132
142
  try {
@@ -140,38 +150,53 @@ async function main() {
140
150
  // По расширенному cron сейчас не время.
141
151
  return 3;
142
152
  }
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] Отложенный запуск уже ожидает открытия окна.");
153
+ // Дни недели и окно запуска (Спринт 27). Политика вне окна:
154
+ // postpone (по умолчанию) — ждём открытия окна;
155
+ // skip — тихо пропускаем тик;
156
+ // run — выполняем, несмотря на окно.
157
+ const windowOptions = { notBefore, notAfter, days, timeZone: zone };
158
+ if (policy !== "run") {
159
+ const state = activeWindowState(now, windowOptions);
160
+ if (!state.active) {
161
+ if (policy === "skip") {
162
+ console.error(`[schedule-gate] Пропуск: ${state.reason ?? "вне окна"}.`);
152
163
  return 3;
153
164
  }
154
- if (!acquireDefer(deferFile, now.getTime())) {
155
- console.error("[schedule-gate] Не удалось захватить defer-файл — пропускаем.");
165
+ const wait = state.nextOpenAt
166
+ ? Math.max(0, state.nextOpenAt.getTime() - now.getTime())
167
+ : 0;
168
+ if (wait <= 0)
169
+ return 0;
170
+ if (wait > MAX_POSTPONE_MS) {
171
+ console.error(`[schedule-gate] ${state.reason ?? "вне окна"} — до открытия больше 12 часов, тик пропущен.`);
172
+ return 3;
173
+ }
174
+ // ПЕРЕНОС: ждём открытия окна. Откладываем один запуск, остальные тики
175
+ // отсекаются по defer-файлу.
176
+ if (deferFile) {
177
+ if (deferFileBusy(deferFile, now.getTime())) {
178
+ console.error("[schedule-gate] Отложенный запуск уже ожидает открытия окна.");
179
+ return 3;
180
+ }
181
+ if (!acquireDefer(deferFile, now.getTime())) {
182
+ console.error("[schedule-gate] Не удалось захватить defer-файл — пропускаем.");
183
+ return 3;
184
+ }
185
+ }
186
+ console.error(`[schedule-gate] ${state.reason ?? "Вне окна"} — запуск перенесён на ~${Math.round(wait / 60000)} мин.`);
187
+ let remaining = wait;
188
+ while (remaining > 0) {
189
+ const chunk = Math.min(remaining, 60000);
190
+ await sleepMs(chunk);
191
+ remaining -= chunk;
192
+ }
193
+ const woke = new Date();
194
+ if (deferFile)
195
+ releaseDefer(deferFile);
196
+ if (!activeWindowState(woke, windowOptions).active) {
197
+ console.error("[schedule-gate] Окно не открылось за отведённое время — не запускаем.");
156
198
  return 3;
157
199
  }
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
200
  }
176
201
  }
177
202
  return 0;
@@ -54,6 +54,30 @@ export declare function validateLaunchWindow(notBefore?: string | null, notAfter
54
54
  export declare function isInWindow(now: Date, notBefore?: string | null, notAfter?: string | null, timeZone?: string): boolean;
55
55
  /** Сколько мс ждать до открытия окна (0 — уже открыто / окно не задано). */
56
56
  export declare function windowDelayMs(now: Date, notBefore?: string | null, notAfter?: string | null, timeZone?: string): number;
57
+ /** 0=Вс..6=Сб. Пустой/полный список трактуется как «все дни» (undefined). */
58
+ export declare function normalizeActiveDays(days?: number[] | null): number[] | undefined;
59
+ /** Разрешён ли день недели (в поясе задачи). */
60
+ export declare function isActiveDay(now: Date, days?: number[] | null, timeZone?: string): boolean;
61
+ export interface ActiveWindowOptions {
62
+ notBefore?: string | null;
63
+ notAfter?: string | null;
64
+ days?: number[] | null;
65
+ timeZone?: string;
66
+ }
67
+ export interface ActiveWindowState {
68
+ /** Можно запускать сейчас. */
69
+ active: boolean;
70
+ /** Почему нельзя (человекочитаемо, для dry-run и логов). */
71
+ reason?: string;
72
+ /** Ближайшее открытие окна; null — не требуется или не найдено. */
73
+ nextOpenAt: Date | null;
74
+ }
75
+ /** Ближайшая минута, когда и день, и окно разрешают запуск. */
76
+ export declare function nextWindowOpenAt(now: Date, options: ActiveWindowOptions): Date | null;
77
+ /** Состояние окна с учётом дней недели. */
78
+ export declare function activeWindowState(now: Date, options?: ActiveWindowOptions): ActiveWindowState;
79
+ /** Сколько мс до следующего разрешённого окна (0 — можно запускать). */
80
+ export declare function nextWindowOpenDelayMs(now: Date, options?: ActiveWindowOptions): number;
57
81
  /**
58
82
  * true, если выражение умеет оформить Windows Task Scheduler «родными»
59
83
  * флагами (MINUTE/HOURLY/DAILY/WEEKLY) и парсится строгим конвертером.
@@ -73,6 +97,10 @@ export interface ScheduleGateSpec {
73
97
  tz?: string;
74
98
  notBefore?: string;
75
99
  notAfter?: string;
100
+ /** Разрешённые дни недели (0=Вс..6=Сб); пусто — все дни. */
101
+ days?: number[];
102
+ /** Поведение вне окна: skip — пропустить, run — выполнить всё равно. */
103
+ windowPolicy?: "skip" | "run";
76
104
  }
77
105
  /**
78
106
  * true, если ОС-триггер не выражает расписание (чужой IANA-таймзона или
@@ -84,5 +112,5 @@ export declare function needsPollMode(expr: string, timezone?: string | null): b
84
112
  * не нужен (нативный cron + системный таймзона + окно не задано).
85
113
  * Окно запуска всегда требует gate (перенос реализует враппер).
86
114
  */
87
- export declare function buildScheduleGate(expr: string, timezone?: string | null, notBefore?: string, notAfter?: string): ScheduleGateSpec | undefined;
115
+ export declare function buildScheduleGate(expr: string, timezone?: string | null, notBefore?: string, notAfter?: string, days?: number[] | null, windowPolicy?: string | null): ScheduleGateSpec | undefined;
88
116
  //# sourceMappingURL=schedule-v2.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"schedule-v2.d.ts","sourceRoot":"","sources":["../../src/core/schedule-v2.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"schedule-v2.d.ts","sourceRoot":"","sources":["../../src/core/schedule-v2.ts"],"names":[],"mappings":"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"}
@@ -452,6 +452,75 @@ export function windowDelayMs(now, notBefore, notAfter, timeZone) {
452
452
  return Math.max(0, deltaSec * 1000 - ms);
453
453
  }
454
454
  // ---------------------------------------------------------------------------
455
+ // Дни недели и политика вне окна (Спринт 27).
456
+ /** 0=Вс..6=Сб. Пустой/полный список трактуется как «все дни» (undefined). */
457
+ export function normalizeActiveDays(days) {
458
+ if (!Array.isArray(days))
459
+ return undefined;
460
+ const unique = [
461
+ ...new Set(days
462
+ .map((value) => Math.floor(Number(value)))
463
+ .filter((value) => Number.isInteger(value) && value >= 0 && value <= 6)),
464
+ ].sort((a, b) => a - b);
465
+ if (unique.length === 0 || unique.length === 7)
466
+ return undefined;
467
+ return unique;
468
+ }
469
+ /** Разрешён ли день недели (в поясе задачи). */
470
+ export function isActiveDay(now, days, timeZone) {
471
+ const normalized = normalizeActiveDays(days);
472
+ if (!normalized)
473
+ return true;
474
+ return normalized.includes(zonedParts(now, timeZone).weekday);
475
+ }
476
+ const WINDOW_SCAN_MINUTES = 8 * 24 * 60;
477
+ /** Ближайшая минута, когда и день, и окно разрешают запуск. */
478
+ export function nextWindowOpenAt(now, options) {
479
+ const { notBefore, notAfter, timeZone } = options;
480
+ const normalizedDays = normalizeActiveDays(options.days);
481
+ const hasWindow = Boolean((notBefore || "").trim() || (notAfter || "").trim());
482
+ if (!hasWindow && !normalizedDays)
483
+ return null;
484
+ const invalidWindow = validateLaunchWindow(notBefore, notAfter) !== null;
485
+ for (let i = 1; i <= WINDOW_SCAN_MINUTES; i++) {
486
+ const candidate = new Date(now.getTime() + i * 60000);
487
+ const dayOk = !normalizedDays || normalizedDays.includes(zonedParts(candidate, timeZone).weekday);
488
+ const windowOk = invalidWindow || isInWindow(candidate, notBefore, notAfter, timeZone);
489
+ if (dayOk && windowOk)
490
+ return candidate;
491
+ }
492
+ return null;
493
+ }
494
+ /** Состояние окна с учётом дней недели. */
495
+ export function activeWindowState(now, options = {}) {
496
+ const normalizedDays = normalizeActiveDays(options.days);
497
+ const dayOk = !normalizedDays ||
498
+ normalizedDays.includes(zonedParts(now, options.timeZone).weekday);
499
+ const windowOk = isInWindow(now, options.notBefore, options.notAfter, options.timeZone);
500
+ if (dayOk && windowOk)
501
+ return { active: true, nextOpenAt: null };
502
+ const reasons = [];
503
+ if (!dayOk) {
504
+ const names = ["Вс", "Пн", "Вт", "Ср", "Чт", "Пт", "Сб"];
505
+ reasons.push(`день недели не разрешён (${(normalizedDays ?? []).map((d) => names[d]).join(", ")})`);
506
+ }
507
+ if (!windowOk) {
508
+ reasons.push(`время вне окна ${options.notBefore}–${options.notAfter}`);
509
+ }
510
+ return {
511
+ active: false,
512
+ reason: reasons.join("; "),
513
+ nextOpenAt: nextWindowOpenAt(now, options),
514
+ };
515
+ }
516
+ /** Сколько мс до следующего разрешённого окна (0 — можно запускать). */
517
+ export function nextWindowOpenDelayMs(now, options = {}) {
518
+ const state = activeWindowState(now, options);
519
+ if (state.active)
520
+ return 0;
521
+ return state.nextOpenAt ? Math.max(0, state.nextOpenAt.getTime() - now.getTime()) : 0;
522
+ }
523
+ // ---------------------------------------------------------------------------
455
524
  // Проверка совместимости с schtasks (родной режим).
456
525
  /**
457
526
  * true, если выражение умеет оформить Windows Task Scheduler «родными»
@@ -486,11 +555,20 @@ export function needsPollMode(expr, timezone) {
486
555
  * не нужен (нативный cron + системный таймзона + окно не задано).
487
556
  * Окно запуска всегда требует gate (перенос реализует враппер).
488
557
  */
489
- export function buildScheduleGate(expr, timezone, notBefore, notAfter) {
558
+ export function buildScheduleGate(expr, timezone, notBefore, notAfter, days, windowPolicy) {
490
559
  const tz = (timezone || "").trim() || undefined;
491
560
  const poll = needsPollMode(expr, tz);
492
- if (!poll && !(notBefore && notAfter))
561
+ const normalizedDays = normalizeActiveDays(days);
562
+ const policy = windowPolicy === "skip" || windowPolicy === "run" ? windowPolicy : undefined;
563
+ if (!poll && !(notBefore && notAfter) && !normalizedDays)
493
564
  return undefined;
494
565
  // cron проверяем только в poll-режиме (см. комментарий у ScheduleGateSpec).
495
- return { ...(poll ? { cron: expr } : {}), tz, notBefore, notAfter };
566
+ return {
567
+ ...(poll ? { cron: expr } : {}),
568
+ tz,
569
+ notBefore,
570
+ notAfter,
571
+ ...(normalizedDays ? { days: normalizedDays } : {}),
572
+ ...(policy ? { windowPolicy: policy } : {}),
573
+ };
496
574
  }
@@ -1,6 +1,6 @@
1
1
  import type { ScheduledTaskInfo } from "../../types.js";
2
2
  /** Чем запускается задача. */
3
- export type TriggerType = "cron" | "file" | "mcp-event" | "once";
3
+ export type TriggerType = "cron" | "file" | "git" | "mcp-event" | "once";
4
4
  /**
5
5
  * Параметры создания задачи. Бэкенд сам решает, как преобразовать cron
6
6
  * в родное расписание ОС и как зарегистрировать команду запуска.
@@ -1 +1 @@
1
- {"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/core/scheduler/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAExD,8BAA8B;AAC9B,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,MAAM,GAAG,WAAW,GAAG,MAAM,CAAC;AAEjE;;;GAGG;AACH,MAAM,WAAW,iBAAiB;IAChC,sDAAsD;IACtD,IAAI,EAAE,MAAM,CAAC;IACb;;;;OAIG;IACH,OAAO,EAAE,MAAM,CAAC;IAChB,gFAAgF;IAChF,QAAQ,EAAE,MAAM,CAAC;IACjB,6DAA6D;IAC7D,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,6DAA6D;IAC7D,WAAW,CAAC,EAAE,WAAW,CAAC;IAC1B,yEAAyE;IACzE,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,4EAA4E;IAC5E,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,uEAAuE;IACvE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,qEAAqE;IACrE,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,mEAAmE;IACnE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,+EAA+E;IAC/E,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,+DAA+D;IAC/D,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,+DAA+D;IAC/D,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,qEAAqE;IACrE,YAAY,CAAC,EAAE;QACb,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,EAAE,CAAC,EAAE,MAAM,CAAC;QACZ,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,oEAAoE;QACpE,SAAS,CAAC,EAAE,MAAM,CAAC;KACpB,CAAC;CACH;AAED,sCAAsC;AACtC,MAAM,WAAW,aAAa;IAC5B,uEAAuE;IACvE,cAAc,EAAE,OAAO,CAAC;CACzB;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,gBAAgB;IAC/B,0DAA0D;IAC1D,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC,QAAQ,CAAC;IACnC,gEAAgE;IAChE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IAEvB,wCAAwC;IACxC,UAAU,CAAC,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACtD,+DAA+D;IAC/D,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACxC,mCAAmC;IACnC,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC;IAC9C,wDAAwD;IACxD,SAAS,IAAI,OAAO,CAAC,iBAAiB,EAAE,CAAC,CAAC;IAC1C,wCAAwC;IACxC,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACvC,uCAAuC;IACvC,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACzC"}
1
+ {"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/core/scheduler/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAExD,8BAA8B;AAC9B,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,MAAM,GAAG,KAAK,GAAG,WAAW,GAAG,MAAM,CAAC;AAEzE;;;GAGG;AACH,MAAM,WAAW,iBAAiB;IAChC,sDAAsD;IACtD,IAAI,EAAE,MAAM,CAAC;IACb;;;;OAIG;IACH,OAAO,EAAE,MAAM,CAAC;IAChB,gFAAgF;IAChF,QAAQ,EAAE,MAAM,CAAC;IACjB,6DAA6D;IAC7D,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,6DAA6D;IAC7D,WAAW,CAAC,EAAE,WAAW,CAAC;IAC1B,yEAAyE;IACzE,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,4EAA4E;IAC5E,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,uEAAuE;IACvE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,qEAAqE;IACrE,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,mEAAmE;IACnE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,+EAA+E;IAC/E,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,+DAA+D;IAC/D,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,+DAA+D;IAC/D,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,qEAAqE;IACrE,YAAY,CAAC,EAAE;QACb,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,EAAE,CAAC,EAAE,MAAM,CAAC;QACZ,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,oEAAoE;QACpE,SAAS,CAAC,EAAE,MAAM,CAAC;KACpB,CAAC;CACH;AAED,sCAAsC;AACtC,MAAM,WAAW,aAAa;IAC5B,uEAAuE;IACvE,cAAc,EAAE,OAAO,CAAC;CACzB;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,gBAAgB;IAC/B,0DAA0D;IAC1D,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC,QAAQ,CAAC;IACnC,gEAAgE;IAChE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IAEvB,wCAAwC;IACxC,UAAU,CAAC,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACtD,+DAA+D;IAC/D,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACxC,mCAAmC;IACnC,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC;IAC9C,wDAAwD;IACxD,SAAS,IAAI,OAAO,CAAC,iBAAiB,EAAE,CAAC,CAAC;IAC1C,wCAAwC;IACxC,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACvC,uCAAuC;IACvC,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACzC"}
@@ -1 +1 @@
1
- {"version":3,"file":"bash.d.ts","sourceRoot":"","sources":["../../../src/core/wrappers/bash.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAE1D,wCAAwC;AACxC,MAAM,WAAW,kBAAkB;IACjC,wDAAwD;IACxD,aAAa,EAAE,MAAM,CAAC;IACtB,uDAAuD;IACvD,QAAQ,EAAE,MAAM,CAAC;IACjB,0CAA0C;IAC1C,UAAU,EAAE,MAAM,CAAC;IACnB,6CAA6C;IAC7C,cAAc,EAAE,MAAM,CAAC;IACvB,uEAAuE;IACvE,QAAQ,EAAE,MAAM,CAAC;IACjB,iCAAiC;IACjC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,2DAA2D;IAC3D,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,0DAA0D;IAC1D,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,0DAA0D;IAC1D,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB,yBAAyB;IACzB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,kDAAkD;IAClD,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,wCAAwC;IACxC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,oFAAoF;IACpF,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,0DAA0D;IAC1D,WAAW,CAAC,EAAE,OAAO,eAAe,EAAE,WAAW,CAAC;IAClD,+CAA+C;IAC/C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,gEAAgE;IAChE,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,wEAAwE;IACxE,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;OAGG;IACH,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B;;;OAGG;IACH,YAAY,CAAC,EAAE,gBAAgB,GAAG;QAChC,QAAQ,EAAE,MAAM,CAAC;QACjB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,SAAS,CAAC,EAAE,MAAM,CAAC;KACpB,CAAC;IACF;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,kBAAkB,GAAG,MAAM,CAmR1E;AAED;;;GAGG;AACH,wBAAsB,gBAAgB,CACpC,OAAO,EAAE,kBAAkB,GAC1B,OAAO,CAAC,MAAM,CAAC,CAUjB;AAED,2DAA2D;AAC3D,wBAAgB,eAAe,CAAC,aAAa,EAAE,MAAM,GAAG,MAAM,CAE7D"}
1
+ {"version":3,"file":"bash.d.ts","sourceRoot":"","sources":["../../../src/core/wrappers/bash.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAE1D,wCAAwC;AACxC,MAAM,WAAW,kBAAkB;IACjC,wDAAwD;IACxD,aAAa,EAAE,MAAM,CAAC;IACtB,uDAAuD;IACvD,QAAQ,EAAE,MAAM,CAAC;IACjB,0CAA0C;IAC1C,UAAU,EAAE,MAAM,CAAC;IACnB,6CAA6C;IAC7C,cAAc,EAAE,MAAM,CAAC;IACvB,uEAAuE;IACvE,QAAQ,EAAE,MAAM,CAAC;IACjB,iCAAiC;IACjC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,2DAA2D;IAC3D,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,0DAA0D;IAC1D,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,0DAA0D;IAC1D,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB,yBAAyB;IACzB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,kDAAkD;IAClD,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,wCAAwC;IACxC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,oFAAoF;IACpF,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,0DAA0D;IAC1D,WAAW,CAAC,EAAE,OAAO,eAAe,EAAE,WAAW,CAAC;IAClD,+CAA+C;IAC/C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,gEAAgE;IAChE,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,wEAAwE;IACxE,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;OAGG;IACH,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B;;;OAGG;IACH,YAAY,CAAC,EAAE,gBAAgB,GAAG;QAChC,QAAQ,EAAE,MAAM,CAAC;QACjB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,SAAS,CAAC,EAAE,MAAM,CAAC;KACpB,CAAC;IACF;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,kBAAkB,GAAG,MAAM,CAuR1E;AAED;;;GAGG;AACH,wBAAsB,gBAAgB,CACpC,OAAO,EAAE,kBAAkB,GAC1B,OAAO,CAAC,MAAM,CAAC,CAUjB;AAED,2DAA2D;AAC3D,wBAAgB,eAAe,CAAC,aAAa,EAAE,MAAM,GAAG,MAAM,CAE7D"}
@@ -48,6 +48,8 @@ export function buildBashWrapperScript(options) {
48
48
  `SCHEDULE_TZ=${shellQuote(scheduleGate?.tz ?? "")}`,
49
49
  `SCHEDULE_NOT_BEFORE=${shellQuote(scheduleGate?.notBefore ?? "")}`,
50
50
  `SCHEDULE_NOT_AFTER=${shellQuote(scheduleGate?.notAfter ?? "")}`,
51
+ `SCHEDULE_DAYS=${shellQuote((scheduleGate?.days ?? []).join(","))}`,
52
+ `SCHEDULE_WINDOW_POLICY=${shellQuote(scheduleGate?.windowPolicy ?? "")}`,
51
53
  `SCHEDULE_DEFER_FILE=${shellQuote(scheduleGate?.deferFile ?? "")}`,
52
54
  `SCHEDULE_FORCE_FILE=${shellQuote(scheduleGate?.forceFile ?? "")}`,
53
55
  `ENV_FILE=${shellQuote(envFile ?? "")}`,
@@ -68,6 +70,8 @@ export function buildBashWrapperScript(options) {
68
70
  ' [ -n "$SCHEDULE_TZ" ] && SCHED_GATE_ARGS+=(--tz "$SCHEDULE_TZ")',
69
71
  ' [ -n "$SCHEDULE_NOT_BEFORE" ] && SCHED_GATE_ARGS+=(--not-before "$SCHEDULE_NOT_BEFORE")',
70
72
  ' [ -n "$SCHEDULE_NOT_AFTER" ] && SCHED_GATE_ARGS+=(--not-after "$SCHEDULE_NOT_AFTER")',
73
+ ' [ -n "$SCHEDULE_DAYS" ] && SCHED_GATE_ARGS+=(--days "$SCHEDULE_DAYS")',
74
+ ' [ -n "$SCHEDULE_WINDOW_POLICY" ] && SCHED_GATE_ARGS+=(--window-policy "$SCHEDULE_WINDOW_POLICY")',
71
75
  ' [ -n "$SCHEDULE_DEFER_FILE" ] && SCHED_GATE_ARGS+=(--defer-file "$SCHEDULE_DEFER_FILE")',
72
76
  ' [ -n "$SCHEDULE_FORCE_FILE" ] && SCHED_GATE_ARGS+=(--force-file "$SCHEDULE_FORCE_FILE")',
73
77
  ' if ! command -v node >/dev/null 2>&1; then',