opencode-windows-scheduler 1.5.0 → 1.5.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (67) hide show
  1. package/CHANGELOG.md +37 -1
  2. package/LICENSE +21 -21
  3. package/README.md +24 -2
  4. package/ROADMAP-STRATEGY.md +16 -16
  5. package/ROADMAP.md +410 -141
  6. package/dist/core/dry-run.d.ts +10 -0
  7. package/dist/core/dry-run.d.ts.map +1 -1
  8. package/dist/core/dry-run.js +55 -34
  9. package/dist/core/git-trigger.d.ts.map +1 -1
  10. package/dist/core/git-trigger.js +15 -9
  11. package/dist/core/matrix.d.ts.map +1 -1
  12. package/dist/core/matrix.js +48 -22
  13. package/dist/core/schedule-v2.d.ts.map +1 -1
  14. package/dist/core/schedule-v2.js +29 -17
  15. package/dist/core/scheduler/types.d.ts +6 -0
  16. package/dist/core/scheduler/types.d.ts.map +1 -1
  17. package/dist/core/scheduler/windows.d.ts +6 -2
  18. package/dist/core/scheduler/windows.d.ts.map +1 -1
  19. package/dist/core/scheduler/windows.js +25 -10
  20. package/dist/core/telegram.d.ts.map +1 -1
  21. package/dist/core/telegram.js +13 -10
  22. package/dist/i18n.d.ts +52 -0
  23. package/dist/i18n.d.ts.map +1 -0
  24. package/dist/i18n.js +292 -0
  25. package/dist/index.d.ts +6 -0
  26. package/dist/index.d.ts.map +1 -1
  27. package/dist/index.js +781 -179
  28. package/dist/notifications.d.ts.map +1 -1
  29. package/dist/notifications.js +74 -40
  30. package/dist/rpc.d.ts +15 -2
  31. package/dist/rpc.d.ts.map +1 -1
  32. package/dist/rpc.js +6 -2
  33. package/dist/server.d.ts.map +1 -1
  34. package/dist/server.js +89 -48
  35. package/dist/settings.d.ts +3 -0
  36. package/dist/settings.d.ts.map +1 -1
  37. package/dist/settings.js +20 -8
  38. package/dist/task-transfer.d.ts +13 -0
  39. package/dist/task-transfer.d.ts.map +1 -1
  40. package/dist/task-transfer.js +11 -0
  41. package/dist/types.d.ts +11 -0
  42. package/dist/types.d.ts.map +1 -1
  43. package/dist/types.js +32 -0
  44. package/docs/ARCHITECTURE.md +36 -1
  45. package/docs/FEATURES.md +19 -0
  46. package/docs/README.ru.md +17 -1
  47. package/gui-experimental.cjs +9 -9
  48. package/locales/en.json +695 -0
  49. package/locales/ru.json +695 -0
  50. package/package.json +6 -3
  51. package/scripts/test-locale.mjs +44 -0
  52. package/src/core/dry-run.ts +76 -38
  53. package/src/core/git-trigger.ts +15 -9
  54. package/src/core/matrix.ts +52 -26
  55. package/src/core/schedule-v2.ts +47 -17
  56. package/src/core/scheduler/types.ts +6 -0
  57. package/src/core/scheduler/windows.ts +25 -10
  58. package/src/core/telegram.ts +16 -10
  59. package/src/gui.tsx +575 -480
  60. package/src/i18n.ts +339 -0
  61. package/src/index.ts +943 -191
  62. package/src/notifications.ts +83 -42
  63. package/src/rpc.ts +6 -2
  64. package/src/server.ts +89 -48
  65. package/src/settings.ts +38 -10
  66. package/src/task-transfer.ts +24 -0
  67. package/src/types.ts +37 -0
@@ -12,6 +12,7 @@
12
12
  * Никакого I/O и обращения к ОС.
13
13
  */
14
14
  import { convertCronToSchTasks } from "./cron-to-schtasks.js";
15
+ import { t } from "../i18n.js";
15
16
  import type { CronConversion } from "../types.js";
16
17
 
17
18
  /** Ограничение на поиск ближайшего запуска. */
@@ -139,7 +140,8 @@ function expandField(token: string, min: number, max: number, names?: Record<str
139
140
  const items = token.split(",");
140
141
  for (const raw of items) {
141
142
  let item = raw.trim().toUpperCase();
142
- if (!item) throw new Error(`Пустой элемент в списке «${token}».`);
143
+ if (!item)
144
+ throw new Error(t("schedule.error.cronEmptyItem", { token }));
143
145
  if (names && names[item] !== undefined) item = String(names[item]);
144
146
  // шаг: a-b/n или */n
145
147
  const stepMatch = item.match(/^(.*)\/([0-9]+)$/);
@@ -148,9 +150,15 @@ function expandField(token: string, min: number, max: number, names?: Record<str
148
150
  item = (stepMatch[1] ?? "").trim();
149
151
  step = Number(stepMatch[2]);
150
152
  if (!Number.isInteger(step) || step < 1) {
151
- throw new Error(`Недопустимый шаг «/${stepMatch[2]}» в «${raw}».`);
153
+ throw new Error(
154
+ t("schedule.error.cronStepInvalid", {
155
+ step: stepMatch[2],
156
+ raw,
157
+ })
158
+ );
152
159
  }
153
- if (item === "") throw new Error(`Некорректный шаг в «${raw}»: перед «/» ничего нет.`);
160
+ if (item === "")
161
+ throw new Error(t("schedule.error.cronStepMissing", { raw }));
154
162
  }
155
163
  if (item === "*" || item === "") {
156
164
  for (let v = min; v <= max; v += step) result.add(v);
@@ -165,17 +173,21 @@ function expandField(token: string, min: number, max: number, names?: Record<str
165
173
  const a = Number(aToken);
166
174
  const b = Number(bToken);
167
175
  if (!Number.isFinite(a) || !Number.isFinite(b)) {
168
- throw new Error(`Недопустимый диапазон «${item}».`);
176
+ throw new Error(t("schedule.error.cronRangeInvalid", { item }));
169
177
  }
170
178
  if (a < min || b > max || a > b) {
171
- throw new Error(`Диапазон «${item}» вне границ ${min}..${max}.`);
179
+ throw new Error(
180
+ t("schedule.error.cronRangeBounds", { item, min, max })
181
+ );
172
182
  }
173
183
  for (let v = a; v <= b; v += step) result.add(v);
174
184
  continue;
175
185
  }
176
186
  const num = Number(item);
177
187
  if (!Number.isInteger(num) || num < min || num > max) {
178
- throw new Error(`Значение «${raw}» вне границ ${min}..${max}.`);
188
+ throw new Error(
189
+ t("schedule.error.cronValueBounds", { raw, min, max })
190
+ );
179
191
  }
180
192
  result.add(num);
181
193
  }
@@ -208,7 +220,9 @@ export function normalizeCron(expr: string): string {
208
220
  if (unit === "m" && n >= 1 && n < 60) return `*/${n} * * * *`;
209
221
  if (unit === "h" && n >= 1 && n <= 23) return `0 */${n} * * *`;
210
222
  if (unit === "d" && n >= 1 && n <= 31) return `0 0 */${n} * *`;
211
- throw new Error(`Неподдерживаемый интервал «@every ${n}${unit}» (m: 1..59, h: 1..23, d: 1..31).`);
223
+ throw new Error(
224
+ t("schedule.error.everyInterval", { value: `${n}${unit}` })
225
+ );
212
226
  }
213
227
 
214
228
  /** Парсит cron-выражение; бросает Error с понятным сообщением. */
@@ -216,7 +230,9 @@ export function parseCron(expr: string): ParsedCron {
216
230
  const raw = normalizeCron(expr);
217
231
  const fields = raw.split(/\s+/);
218
232
  if (fields.length !== 5) {
219
- throw new Error(`Ожидается 5 полей cron, получено ${fields.length}: «${raw}».`);
233
+ throw new Error(
234
+ t("schedule.error.cronFields", { count: fields.length, raw })
235
+ );
220
236
  }
221
237
  const [minF, hourF, domF, monthF, dowF] = fields;
222
238
 
@@ -252,13 +268,18 @@ export function parseCron(expr: string): ParsedCron {
252
268
  if (DOW_NAMES[dToken] !== undefined) dToken = String(DOW_NAMES[dToken]);
253
269
  const weekday = Number(dToken);
254
270
  if (!Number.isInteger(weekday) || weekday < 0 || weekday > 7) {
255
- throw new Error(`День недели «${hash[1]}» вне границ 0..7 в «${dowF}».`);
271
+ throw new Error(
272
+ t("schedule.error.weekdayBounds", {
273
+ value: hash[1],
274
+ field: dowF,
275
+ })
276
+ );
256
277
  }
257
278
  nthWeekday.push({ weekday: weekday % 7, n: Number(hash[2]) });
258
279
  continue;
259
280
  }
260
281
  if (token === "L") {
261
- throw new Error("«L» поддерживается только в поле дня месяца.");
282
+ throw new Error(t("schedule.error.lastDomOnly"));
262
283
  }
263
284
  kept.push(token);
264
285
  }
@@ -431,10 +452,12 @@ export function validateLaunchWindow(notBefore?: string | null, notAfter?: strin
431
452
  const nb = notBefore?.trim() ?? "";
432
453
  const na = notAfter?.trim() ?? "";
433
454
  if (!nb && !na) return null;
434
- if (nb && !isValidDailyTime(nb)) return `notBefore должен быть в формате HH:MM, не "${nb}".`;
435
- if (na && !isValidDailyTime(na)) return `notAfter должен быть в формате HH:MM, не "${na}".`;
436
- if (!nb || !na) return "notBefore и notAfter задаются вместе.";
437
- if (nb === na) return "notBefore и notAfter не могут совпадать (пустое окно).";
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");
438
461
  return null;
439
462
  }
440
463
 
@@ -536,11 +559,18 @@ export function activeWindowState(now: Date, options: ActiveWindowOptions = {}):
536
559
 
537
560
  const reasons: string[] = [];
538
561
  if (!dayOk) {
539
- const names = ["Вс", "Пн", "Вт", "Ср", "Чт", "Пт", "Сб"];
540
- reasons.push(`день недели не разрешён (${(normalizedDays ?? []).map((d) => names[d]).join(", ")})`);
562
+ const days = (normalizedDays ?? [])
563
+ .map((d) => t(`schedule.weekday.${d}`))
564
+ .join(", ");
565
+ reasons.push(t("schedule.reason.dayNotAllowed", { days }));
541
566
  }
542
567
  if (!windowOk) {
543
- reasons.push(`время вне окна ${options.notBefore}–${options.notAfter}`);
568
+ reasons.push(
569
+ t("schedule.reason.outsideWindow", {
570
+ notBefore: options.notBefore,
571
+ notAfter: options.notAfter,
572
+ })
573
+ );
544
574
  }
545
575
  return {
546
576
  active: false,
@@ -38,6 +38,12 @@ export interface CreateTaskOptions {
38
38
  notBefore?: string;
39
39
  /** Окно запуска «не позже» (HH:MM, 24ч). Парно с notBefore. */
40
40
  notAfter?: string;
41
+ /**
42
+ * Windows: запускать задачу и без входа пользователя (/ru SYSTEM).
43
+ * По умолчанию задача интерактивная — выполняется только при активном входе.
44
+ * На Linux/macOS не используется: cron и так работает без входа, launchd-агент — только при входе.
45
+ */
46
+ runWhenLoggedOff?: boolean;
41
47
  /** Аргументы schedule-gate для обёртки (расширенный cron / окно). */
42
48
  scheduleGate?: {
43
49
  cron?: string;
@@ -23,11 +23,11 @@ export const WINDOWS_TASK_PREFIX = `\\${TASK_FOLDER}\\${TASK_FOLDER_NAME}\\`;
23
23
  /**
24
24
  * Декодирует вывод консольных утилит Windows.
25
25
  *
26
- * cmd.exe запускается с `chcp 65001`, поэтому штатный вывод — UTF-8.
27
- * Но сам schtasks при ошибке (и при перенаправлении вывода) может отдать
28
- * байты в OEM-кодировке русской Windows (CP866), из-за чего Node, читающий
29
- * их как UTF-8, показывает «?????». Поэтому: если байты — валидный UTF-8,
30
- * декодируем как UTF-8, иначе пробуем CP866.
26
+ * `schtasks.exe` запускается напрямую, без `cmd.exe`, поэтому метасимволы
27
+ * в аргументах не исполняются. Вывод утилиты на русской Windows приходит
28
+ * в OEM-кодировке (CP866), из-за чего Node, читающий его как UTF-8,
29
+ * показывает «?????». Поэтому: если байты — валидный UTF-8, декодируем
30
+ * как UTF-8, иначе пробуем CP866.
31
31
  */
32
32
  function decodeConsoleOutput(buf: Buffer | string | undefined | null): string {
33
33
  if (!buf) return "";
@@ -81,13 +81,16 @@ export class SchtasksError extends Error {
81
81
  }
82
82
 
83
83
  /**
84
- * Выполняет команду schtasks через cmd.exe с chcp 65001 (стабильные
85
- * англоязычные ключи вывода) и windowsHide: true (без окон консоли).
84
+ * Выполняет `schtasks.exe` напрямую с массивом аргументов.
85
+ *
86
+ * Раньше команда собиралась в строку и запускалась через `cmd.exe /c`,
87
+ * из-за чего метасимволы (`&`, `|`, `"`) в имени задачи исполнялись
88
+ * оболочкой: можно было получить command injection и «фантомную» задачу.
89
+ * `execFile` передаёт каждый аргумент отдельно — оболочки в цепочке нет.
86
90
  */
87
91
  export async function runSchtasks(args: string[]): Promise<SchtasksResult> {
88
92
  try {
89
- const command = ["chcp", "65001", ">nul", "&", "schtasks", ...args].join(" ");
90
- const { stdout, stderr } = (await execFileAsync("cmd.exe", ["/c", command], {
93
+ const { stdout, stderr } = (await execFileAsync("schtasks", args, {
91
94
  windowsHide: true,
92
95
  encoding: "buffer",
93
96
  maxBuffer: MAX_OUTPUT_BUFFER,
@@ -167,6 +170,11 @@ export class WindowsScheduler implements SchedulerBackend {
167
170
  }
168
171
 
169
172
  const fullName = taskFullName(name);
173
+ // Спринт 27.5.4: по умолчанию задача интерактивная — schtasks запускает её
174
+ // только при активном входе пользователя (Interactive only). Для работы без
175
+ // входа нужен SYSTEM: он не требует пароля, но работает в session 0 без
176
+ // профиля пользователя (нет доступа к пользовательским файлам/сети/ключам).
177
+ const logonFlags = options.runWhenLoggedOff ? ["/ru", "SYSTEM"] : [];
170
178
  const args: string[] = [
171
179
  "/create",
172
180
  "/tn",
@@ -174,6 +182,7 @@ export class WindowsScheduler implements SchedulerBackend {
174
182
  "/tr",
175
183
  `"${command}"`,
176
184
  ...scheduleFlags,
185
+ ...logonFlags,
177
186
  "/f",
178
187
  ];
179
188
 
@@ -225,7 +234,9 @@ export class WindowsScheduler implements SchedulerBackend {
225
234
  }
226
235
 
227
236
  async listTasks(): Promise<ScheduledTaskInfo[]> {
228
- const args = ["/query", "/fo", "LIST"];
237
+ // /v нужен, чтобы ОС отдала «Режим входа» (Logon Mode): без него
238
+ // schtasks печатает только имя, время и состояние, а logonMode остаётся null.
239
+ const args = ["/query", "/v", "/fo", "LIST"];
229
240
 
230
241
  let result: SchtasksResult;
231
242
  try {
@@ -284,6 +295,8 @@ export class WindowsScheduler implements SchedulerBackend {
284
295
  const alreadyGone =
285
296
  text.includes("cannot find") ||
286
297
  text.includes("не удалось найти") ||
298
+ text.includes("не удается найти") ||
299
+ text.includes("не может найти") ||
287
300
  text.includes("не найдено") ||
288
301
  text.includes("the system cannot find the file specified") ||
289
302
  text.includes("no tasks") ||
@@ -477,6 +490,8 @@ function setTaskField(task: any, key: string, value: string): void {
477
490
  "следующее время запуска": "nextRunTime",
478
491
  состояние: "status",
479
492
  "режим входа": "logonMode",
493
+ // RU Windows 10/11 в /v печатает полную формулировку.
494
+ "режим входа в систему": "logonMode",
480
495
  "последнее время запуска": "lastRunTime",
481
496
  "последний результат": "lastResult",
482
497
  автор: "author",
@@ -1,3 +1,5 @@
1
+ import { t } from "../i18n.js";
2
+
1
3
  /**
2
4
  * Telegram Bot API: отправка уведомлений (Спринт 25).
3
5
  *
@@ -74,29 +76,29 @@ export function formatTelegramText(
74
76
  if (!url) return body;
75
77
 
76
78
  if (parseMode === "HTML") {
77
- return `${body}\n\n<a href="${escapeHtmlAttribute(url)}">📊 Открыть дашборд</a>`;
79
+ return `${body}\n\n<a href="${escapeHtmlAttribute(url)}">${t("notify.telegram.openDashboard")}</a>`;
78
80
  }
79
81
  if (parseMode === "MarkdownV2") {
80
82
  const escapedUrl = url.replace(/[)\\]/g, "\\$&");
81
- return `${body}\n\n[📊 Открыть дашборд](${escapedUrl})`;
83
+ return `${body}\n\n[${t("notify.telegram.openDashboard")}](${escapedUrl})`;
82
84
  }
83
85
  if (parseMode === "Markdown") {
84
86
  const escapedUrl = url.replace(/[)]/g, "\\)");
85
- return `${body}\n\n[📊 Открыть дашборд](${escapedUrl})`;
87
+ return `${body}\n\n[${t("notify.telegram.openDashboard")}](${escapedUrl})`;
86
88
  }
87
- return `${body}\n\n📊 Открыть дашборд: ${url}`;
89
+ return `${body}\n\n${t("notify.telegram.openDashboardUrl", { url })}`;
88
90
  }
89
91
 
90
92
  /** Проверяет формат токена бота; возвращает trimmed-значение. */
91
93
  export function validateTelegramToken(token: string): string {
92
94
  const value = (token ?? "").trim();
93
95
  if (!value) {
94
- throw new Error("Не задан токен Telegram-бота.");
96
+ throw new Error(t("notify.error.telegramTokenMissing"));
95
97
  }
96
98
  // Формат BotFather: <digits>:<base64-ish>. Проверяем достаточно мягко,
97
99
  // чтобы не ломать тестовые токены, но отсекать явный мусор.
98
100
  if (!/^\d+:[A-Za-z0-9_-]{5,}$/.test(value)) {
99
- throw new Error("Некорректный токен Telegram-бота.");
101
+ throw new Error(t("notify.error.telegramTokenInvalid"));
100
102
  }
101
103
  return value;
102
104
  }
@@ -125,10 +127,10 @@ function resolveApiBase(apiBase?: string): string {
125
127
  try {
126
128
  parsed = new URL(value);
127
129
  } catch {
128
- throw new Error("Некорректный адрес Telegram API.");
130
+ throw new Error(t("notify.error.telegramApiBaseInvalid"));
129
131
  }
130
132
  if (parsed.protocol !== "http:" && parsed.protocol !== "https:") {
131
- throw new Error("Telegram API поддерживает только http:// или https://.");
133
+ throw new Error(t("notify.error.telegramScheme"));
132
134
  }
133
135
  return value;
134
136
  }
@@ -148,7 +150,7 @@ export async function sendTelegramMessage(
148
150
  const safeToken = validateTelegramToken(token);
149
151
  const target = (chatId ?? "").trim();
150
152
  if (!target) {
151
- throw new Error("Не задан chat_id Telegram.");
153
+ throw new Error(t("notify.error.telegramChatMissing"));
152
154
  }
153
155
 
154
156
  const apiBase = resolveApiBase(options.apiBase);
@@ -209,7 +211,11 @@ export async function sendTelegramMessage(
209
211
  }
210
212
  } catch (err: any) {
211
213
  if (err?.name === "AbortError") {
212
- throw new Error(`Таймаут Telegram API (${Math.floor(timeoutMs / 1000)} с).`);
214
+ throw new Error(
215
+ t("notify.error.telegramTimeout", {
216
+ seconds: Math.floor(timeoutMs / 1000),
217
+ })
218
+ );
213
219
  }
214
220
  const message = err instanceof Error ? err.message : String(err);
215
221
  throw new Error(sanitizeErrorText(message, safeToken));