opencode-windows-scheduler 1.5.0 → 1.5.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.
Files changed (87) hide show
  1. package/CHANGELOG.md +47 -1
  2. package/LICENSE +21 -21
  3. package/README.md +24 -2
  4. package/ROADMAP-STRATEGY.md +16 -16
  5. package/ROADMAP.md +649 -160
  6. package/dist/core/audit.d.ts +27 -0
  7. package/dist/core/audit.d.ts.map +1 -1
  8. package/dist/core/audit.js +60 -0
  9. package/dist/core/dry-run.d.ts +10 -0
  10. package/dist/core/dry-run.d.ts.map +1 -1
  11. package/dist/core/dry-run.js +55 -34
  12. package/dist/core/git-trigger.d.ts.map +1 -1
  13. package/dist/core/git-trigger.js +15 -9
  14. package/dist/core/matrix.d.ts.map +1 -1
  15. package/dist/core/matrix.js +48 -22
  16. package/dist/core/ps-wrapper.d.ts +1 -1
  17. package/dist/core/ps-wrapper.d.ts.map +1 -1
  18. package/dist/core/ps-wrapper.js +47 -10
  19. package/dist/core/schedule-v2.d.ts.map +1 -1
  20. package/dist/core/schedule-v2.js +29 -17
  21. package/dist/core/scheduler/types.d.ts +6 -0
  22. package/dist/core/scheduler/types.d.ts.map +1 -1
  23. package/dist/core/scheduler/windows.d.ts +6 -2
  24. package/dist/core/scheduler/windows.d.ts.map +1 -1
  25. package/dist/core/scheduler/windows.js +25 -10
  26. package/dist/core/secrets.d.ts +10 -3
  27. package/dist/core/secrets.d.ts.map +1 -1
  28. package/dist/core/secrets.js +28 -4
  29. package/dist/core/telegram.d.ts.map +1 -1
  30. package/dist/core/telegram.js +13 -10
  31. package/dist/core/wrappers/bash.d.ts +1 -0
  32. package/dist/core/wrappers/bash.d.ts.map +1 -1
  33. package/dist/core/wrappers/bash.js +91 -5
  34. package/dist/i18n.d.ts +52 -0
  35. package/dist/i18n.d.ts.map +1 -0
  36. package/dist/i18n.js +292 -0
  37. package/dist/index.d.ts +6 -0
  38. package/dist/index.d.ts.map +1 -1
  39. package/dist/index.js +788 -183
  40. package/dist/notifications.d.ts.map +1 -1
  41. package/dist/notifications.js +74 -40
  42. package/dist/rpc.d.ts +15 -2
  43. package/dist/rpc.d.ts.map +1 -1
  44. package/dist/rpc.js +6 -2
  45. package/dist/server.d.ts.map +1 -1
  46. package/dist/server.js +89 -48
  47. package/dist/settings.d.ts +3 -0
  48. package/dist/settings.d.ts.map +1 -1
  49. package/dist/settings.js +20 -8
  50. package/dist/task-transfer.d.ts +13 -0
  51. package/dist/task-transfer.d.ts.map +1 -1
  52. package/dist/task-transfer.js +11 -0
  53. package/dist/types.d.ts +11 -0
  54. package/dist/types.d.ts.map +1 -1
  55. package/dist/types.js +32 -0
  56. package/dist/workspaces.d.ts +2 -2
  57. package/dist/workspaces.d.ts.map +1 -1
  58. package/dist/workspaces.js +6 -4
  59. package/docs/ARCHITECTURE.md +96 -4
  60. package/docs/FEATURES.md +34 -5
  61. package/docs/README.ru.md +17 -1
  62. package/gui-experimental.cjs +9 -9
  63. package/locales/en.json +695 -0
  64. package/locales/ru.json +695 -0
  65. package/package.json +6 -3
  66. package/scripts/test-locale.mjs +44 -0
  67. package/src/core/audit.ts +89 -0
  68. package/src/core/dry-run.ts +76 -38
  69. package/src/core/git-trigger.ts +15 -9
  70. package/src/core/matrix.ts +52 -26
  71. package/src/core/ps-wrapper.ts +47 -10
  72. package/src/core/schedule-v2.ts +47 -17
  73. package/src/core/scheduler/types.ts +6 -0
  74. package/src/core/scheduler/windows.ts +25 -10
  75. package/src/core/secrets.ts +34 -10
  76. package/src/core/telegram.ts +16 -10
  77. package/src/core/wrappers/bash.ts +112 -5
  78. package/src/gui.tsx +575 -480
  79. package/src/i18n.ts +339 -0
  80. package/src/index.ts +960 -193
  81. package/src/notifications.ts +83 -42
  82. package/src/rpc.ts +6 -2
  83. package/src/server.ts +89 -48
  84. package/src/settings.ts +38 -10
  85. package/src/task-transfer.ts +24 -0
  86. package/src/types.ts +37 -0
  87. package/src/workspaces.ts +9 -4
package/src/i18n.ts ADDED
@@ -0,0 +1,339 @@
1
+ /**
2
+ * i18n-фундамент (Спринт 28).
3
+ *
4
+ * Каталоги строк живут в `<корень пакета>/locales/<locale>.json` — плоские
5
+ * ключи вида `"server.notFound"`. Загрузчик читает их синхронно при первом
6
+ * обращении и кэширует: файлы маленькие, а горячий путь — `t()` в рендере.
7
+ *
8
+ * Поддерживается ICU-подмножество без зависимостей:
9
+ * - `{name}` — подстановка параметра;
10
+ * - `{count, plural, one {…} few {…} many {…} other {…}}` — плюрализация
11
+ * через встроенный `Intl.PluralRules`; `#` внутри ветки — число.
12
+ *
13
+ * Русский — локаль по умолчанию (`DEFAULT_LOCALE`). Если ключа нет в текущей
14
+ * локали, берётся русский вариант; если нет и там — возвращается сам ключ,
15
+ * чтобы пропажа была видна, а не превращалась в пустую строку.
16
+ *
17
+ * Локаль процесса меняется через `setLocale()` — без перезапуска плагина.
18
+ */
19
+ import fs from "node:fs";
20
+ import path from "node:path";
21
+ import { fileURLToPath } from "node:url";
22
+
23
+ export type Locale = "ru" | "en";
24
+
25
+ /** Порядок важен для UI: первым идёт локаль по умолчанию. */
26
+ export const SUPPORTED_LOCALES: readonly Locale[] = ["ru", "en"];
27
+
28
+ /** Русский остаётся локалью по умолчанию (см. ROADMAP, спринт 28). */
29
+ export const DEFAULT_LOCALE: Locale = "ru";
30
+
31
+ /** Каталог модуля: `src/` при запуске из исходников, `dist/` из сборки. */
32
+ const MODULE_DIR = path.dirname(fileURLToPath(import.meta.url));
33
+
34
+ /** Каталоги, где может лежать `locales/` (оба варианта дают корень пакета). */
35
+ function candidateCatalogDirs(): string[] {
36
+ return [
37
+ path.resolve(MODULE_DIR, "../locales"),
38
+ path.resolve(MODULE_DIR, "locales"),
39
+ ];
40
+ }
41
+
42
+ const catalogs = new Map<Locale, Record<string, string>>();
43
+ const pluralRules = new Map<Locale, Intl.PluralRules>();
44
+
45
+ /**
46
+ * Локаль запуска: `OPENCODE_SCHEDULER_LOCALE=en` позволяет прогнать набор
47
+ * тестов на английском без правки настроек. Не задана — русский.
48
+ */
49
+ const INITIAL_LOCALE: Locale = normalizeLocale(
50
+ process.env.OPENCODE_SCHEDULER_LOCALE
51
+ );
52
+
53
+ let currentLocale: Locale = INITIAL_LOCALE;
54
+
55
+ /** true, если значение — поддерживаемая локаль. */
56
+ export function isLocale(value: unknown): value is Locale {
57
+ return (
58
+ typeof value === "string" &&
59
+ (SUPPORTED_LOCALES as readonly string[]).includes(value)
60
+ );
61
+ }
62
+
63
+ /** Приводит произвольное значение к поддерживаемой локали. */
64
+ export function normalizeLocale(
65
+ value: unknown,
66
+ fallback: Locale = DEFAULT_LOCALE
67
+ ): Locale {
68
+ return isLocale(value) ? value : fallback;
69
+ }
70
+
71
+ /** Текущая локаль процесса. */
72
+ export function getLocale(): Locale {
73
+ return currentLocale;
74
+ }
75
+
76
+ /**
77
+ * Переключает локаль процесса. Возвращает фактическую локаль (невалидное
78
+ * значение откатывается к локали по умолчанию).
79
+ */
80
+ export function setLocale(locale: unknown): Locale {
81
+ currentLocale = normalizeLocale(locale, DEFAULT_LOCALE);
82
+ return currentLocale;
83
+ }
84
+
85
+ /** Путь к файлу каталога или null, если файла нет. */
86
+ export function catalogPath(locale: Locale): string | null {
87
+ for (const dir of candidateCatalogDirs()) {
88
+ const file = path.join(dir, `${locale}.json`);
89
+ try {
90
+ if (fs.statSync(file).isFile()) return file;
91
+ } catch {
92
+ // Нет файла — пробуем следующий каталог.
93
+ }
94
+ }
95
+ return null;
96
+ }
97
+
98
+ /** Читает каталог с диска (с кэшем). Битый файл — пустой каталог. */
99
+ function readCatalog(locale: Locale): Record<string, string> {
100
+ const cached = catalogs.get(locale);
101
+ if (cached) return cached;
102
+
103
+ const file = catalogPath(locale);
104
+ const parsed: Record<string, string> = {};
105
+ if (file) {
106
+ try {
107
+ const raw = JSON.parse(fs.readFileSync(file, "utf8")) as unknown;
108
+ if (raw && typeof raw === "object" && !Array.isArray(raw)) {
109
+ for (const [key, value] of Object.entries(raw as Record<string, unknown>)) {
110
+ if (typeof value === "string" && value.length > 0) parsed[key] = value;
111
+ }
112
+ }
113
+ } catch (err: any) {
114
+ console.error(
115
+ `[i18n] Не удалось прочитать ${file}: ${
116
+ err instanceof Error ? err.message : String(err)
117
+ }`
118
+ );
119
+ }
120
+ }
121
+
122
+ catalogs.set(locale, parsed);
123
+ return parsed;
124
+ }
125
+
126
+ /**
127
+ * Регистрирует каталог, встроенный в GUI-бандл.
128
+ *
129
+ * В webview OpenCode нет доступа к файлам пакета: `document.currentScript`
130
+ * указывает на ресурс приложения, поэтому `catalogPath()` не находит
131
+ * `locales/*.json` и `t()` возвращает сырые ключи. GUI импортирует JSON на
132
+ * этапе сборки и кладёт его сюда — файлы на диске больше не нужны.
133
+ */
134
+ export function registerCatalog(
135
+ locale: Locale,
136
+ messages: Record<string, unknown>
137
+ ): void {
138
+ const parsed: Record<string, string> = {};
139
+ for (const [key, value] of Object.entries(messages)) {
140
+ if (typeof value === "string" && value.length > 0) parsed[key] = value;
141
+ }
142
+ catalogs.set(locale, parsed);
143
+ }
144
+
145
+ /** Список ключей каталога (отсортированный). */
146
+ export function catalogKeys(locale: Locale = currentLocale): string[] {
147
+ return Object.keys(readCatalog(locale)).sort();
148
+ }
149
+
150
+ /** true, если ключ есть в каталоге указанной локали. */
151
+ export function hasKey(key: string, locale: Locale = currentLocale): boolean {
152
+ return Object.prototype.hasOwnProperty.call(readCatalog(locale), key);
153
+ }
154
+
155
+ /** Значение ключа в конкретной локали без fallback; undefined — ключа нет. */
156
+ export function messageIn(locale: Locale, key: string): string | undefined {
157
+ return readCatalog(locale)[key];
158
+ }
159
+
160
+ /**
161
+ * Ключи, которых не хватает относительно русской локали.
162
+ * Пустой массив — каталог полный.
163
+ */
164
+ export function missingKeys(locale: Locale): string[] {
165
+ const base = new Set(catalogKeys(DEFAULT_LOCALE));
166
+ return catalogKeys(locale).filter((key) => !base.has(key));
167
+ }
168
+
169
+ /** Ключи, которые есть в русской локали, но отсутствуют в указанной. */
170
+ export function absentKeys(locale: Locale): string[] {
171
+ const target = new Set(catalogKeys(locale));
172
+ return catalogKeys(DEFAULT_LOCALE).filter((key) => !target.has(key));
173
+ }
174
+
175
+ /** Сбрасывает кэш каталогов и локаль к локали запуска (для тестов). */
176
+ export function resetI18n(): void {
177
+ catalogs.clear();
178
+ pluralRules.clear();
179
+ currentLocale = INITIAL_LOCALE;
180
+ }
181
+
182
+ /** Категория плюрализации для числа (`one`/`few`/`many`/`other`). */
183
+ function pluralCategory(count: number, locale: Locale): string {
184
+ let rules = pluralRules.get(locale);
185
+ if (!rules) {
186
+ rules = new Intl.PluralRules(locale);
187
+ pluralRules.set(locale, rules);
188
+ }
189
+ return rules.select(count);
190
+ }
191
+
192
+ /** Форматирует число для подстановки `#` в плюральной ветке. */
193
+ function formatCount(count: number, locale: Locale): string {
194
+ try {
195
+ return new Intl.NumberFormat(locale).format(count);
196
+ } catch {
197
+ return String(count);
198
+ }
199
+ }
200
+
201
+ /** Индекс парной `}` для `{` на позиции `openIndex`; -1 — не закрыта. */
202
+ function findClosingBrace(text: string, openIndex: number): number {
203
+ let depth = 0;
204
+ for (let i = openIndex; i < text.length; i++) {
205
+ const ch = text[i];
206
+ if (ch === "{") depth++;
207
+ else if (ch === "}") {
208
+ depth--;
209
+ if (depth === 0) return i;
210
+ }
211
+ }
212
+ return -1;
213
+ }
214
+
215
+ /** Индекс первой запятой верхнего уровня (вне фигурных скобок); -1 — нет. */
216
+ function topLevelCommaIndex(body: string): number {
217
+ let depth = 0;
218
+ for (let i = 0; i < body.length; i++) {
219
+ const ch = body[i];
220
+ if (ch === "{") depth++;
221
+ else if (ch === "}") depth--;
222
+ else if (ch === "," && depth === 0) return i;
223
+ }
224
+ return -1;
225
+ }
226
+
227
+ /**
228
+ * Разбирает ветки plural: `one {…} few {…} many {…} other {…}`.
229
+ * Ветки разделены пробелами/запятыми, содержимое — в фигурных скобках.
230
+ */
231
+ function parsePluralBranches(text: string): Record<string, string> {
232
+ const branches: Record<string, string> = {};
233
+ let i = 0;
234
+ while (i < text.length) {
235
+ while (i < text.length && /[\s,]/.test(text[i])) i++;
236
+ const keyStart = i;
237
+ while (i < text.length && text[i] !== "{") i++;
238
+ if (i >= text.length) break;
239
+ const key = text.slice(keyStart, i).trim();
240
+ const end = findClosingBrace(text, i);
241
+ if (end === -1) break;
242
+ if (key) branches[key] = text.slice(i + 1, end);
243
+ i = end + 1;
244
+ }
245
+ return branches;
246
+ }
247
+
248
+ /**
249
+ * Разворачивает шаблон: `{name}` и `{count, plural, …}`.
250
+ * `count` передаётся только внутри плюральной ветки — там `#` становится числом.
251
+ */
252
+ function renderTemplate(
253
+ template: string,
254
+ locale: Locale,
255
+ params: Record<string, unknown>,
256
+ count?: number
257
+ ): string {
258
+ let out = "";
259
+ let i = 0;
260
+ while (i < template.length) {
261
+ const ch = template[i];
262
+ if (ch === "#" && count !== undefined) {
263
+ out += formatCount(count, locale);
264
+ i++;
265
+ continue;
266
+ }
267
+ if (ch !== "{") {
268
+ out += ch;
269
+ i++;
270
+ continue;
271
+ }
272
+ const end = findClosingBrace(template, i);
273
+ if (end === -1) {
274
+ out += template.slice(i);
275
+ break;
276
+ }
277
+ out += renderExpression(template.slice(i + 1, end), locale, params);
278
+ i = end + 1;
279
+ }
280
+ return out;
281
+ }
282
+
283
+ /** Разворачивает одно выражение `{…}` (параметр или plural). */
284
+ function renderExpression(
285
+ body: string,
286
+ locale: Locale,
287
+ params: Record<string, unknown>
288
+ ): string {
289
+ const comma = topLevelCommaIndex(body);
290
+ const name = (comma === -1 ? body : body.slice(0, comma)).trim();
291
+ const value = params[name];
292
+
293
+ if (comma === -1) {
294
+ // Нет параметра — оставляем плейсхолдер, чтобы пропажа была видна.
295
+ return value === undefined || value === null ? `{${body}}` : String(value);
296
+ }
297
+
298
+ const rest = body.slice(comma + 1).trim();
299
+ const typeMatch = /^([a-zA-Z]+)/.exec(rest);
300
+ const type = typeMatch ? typeMatch[1] : "";
301
+
302
+ if (type === "plural") {
303
+ const numeric = Number(value);
304
+ const count = Number.isFinite(numeric) ? numeric : 0;
305
+ const branches = parsePluralBranches(rest.slice(type.length));
306
+ const category = pluralCategory(count, locale);
307
+ const chosen = branches[category] ?? branches.other ?? "";
308
+ return renderTemplate(chosen, locale, params, count);
309
+ }
310
+
311
+ // Неизвестный тип аргумента — подставляем значение как есть.
312
+ return value === undefined || value === null ? `{${body}}` : String(value);
313
+ }
314
+
315
+ /** Параметры подстановки: `{name}` или `count` для плюрализации. */
316
+ export type TranslateParams = Record<string, unknown>;
317
+
318
+ /**
319
+ * Переводит ключ. Отсутствующий ключ → русский вариант → сам ключ.
320
+ * Если сработал fallback, плюрализация тоже считается по русским правилам.
321
+ */
322
+ export function t(key: string, params?: TranslateParams): string {
323
+ const locale = currentLocale;
324
+ let template = readCatalog(locale)[key];
325
+ let renderLocale = locale;
326
+
327
+ if (template === undefined && locale !== DEFAULT_LOCALE) {
328
+ template = readCatalog(DEFAULT_LOCALE)[key];
329
+ renderLocale = DEFAULT_LOCALE;
330
+ }
331
+
332
+ if (template === undefined) return key;
333
+ return renderTemplate(template, renderLocale, params ?? {});
334
+ }
335
+
336
+ /** Все локали, у которых каталог реально найден на диске. */
337
+ export function availableLocales(): Locale[] {
338
+ return SUPPORTED_LOCALES.filter((locale) => catalogPath(locale) !== null);
339
+ }