opencode-windows-scheduler 1.5.2 → 1.5.4

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 (64) hide show
  1. package/CHANGELOG.md +46 -1
  2. package/LICENSE +21 -21
  3. package/README.md +3 -2
  4. package/ROADMAP-STRATEGY.md +5 -4
  5. package/ROADMAP.md +251 -72
  6. package/dist/core/local-ai.d.ts +52 -0
  7. package/dist/core/local-ai.d.ts.map +1 -0
  8. package/dist/core/local-ai.js +119 -0
  9. package/dist/core/ps-wrapper.d.ts +2 -30
  10. package/dist/core/ps-wrapper.d.ts.map +1 -1
  11. package/dist/core/ps-wrapper.js +211 -39
  12. package/dist/core/triage-chain.d.ts +34 -0
  13. package/dist/core/triage-chain.d.ts.map +1 -0
  14. package/dist/core/triage-chain.js +70 -0
  15. package/dist/core/triage-rules.d.ts +23 -0
  16. package/dist/core/triage-rules.d.ts.map +1 -0
  17. package/dist/core/triage-rules.js +174 -0
  18. package/dist/core/triage-shadow.d.ts +47 -0
  19. package/dist/core/triage-shadow.d.ts.map +1 -0
  20. package/dist/core/triage-shadow.js +48 -0
  21. package/dist/core/triage.d.ts +76 -0
  22. package/dist/core/triage.d.ts.map +1 -0
  23. package/dist/core/triage.js +271 -0
  24. package/dist/gui-experimental.cjs +1 -0
  25. package/dist/i18n.d.ts.map +1 -1
  26. package/dist/i18n.js +34 -7
  27. package/dist/index.d.ts +27 -0
  28. package/dist/index.d.ts.map +1 -1
  29. package/dist/index.js +187 -2
  30. package/dist/notifications.d.ts.map +1 -1
  31. package/dist/notifications.js +9 -1
  32. package/dist/rpc.d.ts +259 -0
  33. package/dist/rpc.d.ts.map +1 -1
  34. package/dist/rpc.js +58 -0
  35. package/dist/settings.d.ts +80 -0
  36. package/dist/settings.d.ts.map +1 -1
  37. package/dist/settings.js +199 -0
  38. package/docs/ARCHITECTURE.md +9 -7
  39. package/docs/FEATURES.md +22 -2
  40. package/docs/LOCAL-AI.md +202 -0
  41. package/docs/MIGRATION.md +17 -0
  42. package/docs/README.ru.md +5 -4
  43. package/docs/spikes/local-model-structured-output.md +81 -0
  44. package/docs/spikes/ollama-qwen3-4b-smoke.json +28 -0
  45. package/docs/spikes/ollama-qwen3-4b.json +163 -0
  46. package/gui-experimental.cjs +8 -8
  47. package/locales/en.json +32 -0
  48. package/locales/ru.json +32 -0
  49. package/package.json +9 -2
  50. package/scripts/bench-local.mjs +321 -0
  51. package/scripts/spike-local-structured.mjs +182 -0
  52. package/skills/scheduled-job-best-practices/references/recipes.md +40 -0
  53. package/src/core/local-ai.ts +173 -0
  54. package/src/core/ps-wrapper.ts +218 -38
  55. package/src/core/triage-chain.ts +116 -0
  56. package/src/core/triage-rules.ts +215 -0
  57. package/src/core/triage-shadow.ts +96 -0
  58. package/src/core/triage.ts +366 -0
  59. package/src/gui.tsx +4761 -4533
  60. package/src/i18n.ts +32 -9
  61. package/src/index.ts +222 -2
  62. package/src/notifications.ts +16 -0
  63. package/src/rpc.ts +58 -0
  64. package/src/settings.ts +318 -0
package/dist/rpc.js CHANGED
@@ -53,6 +53,8 @@ const TaskItem = {
53
53
  properties: {
54
54
  name: { type: "string" },
55
55
  schedule: { type: "string" },
56
+ /** Hotfix 1.5.3.1: лимит времени задачи в секундах (null - по умолчанию). */
57
+ timeoutSeconds: { type: ["number", "null"] },
56
58
  status: { type: "string" },
57
59
  nextRun: { type: ["string", "null"] },
58
60
  /** LLM-модель задачи (null — модель OpenCode по умолчанию). */
@@ -513,6 +515,62 @@ const NotificationSettingsSchema = {
513
515
  },
514
516
  required: ["enabled", "frequency", "time"],
515
517
  },
518
+ triage: {
519
+ type: "object",
520
+ properties: {
521
+ mode: { type: "string", enum: ["off", "rules", "llm", "auto"] },
522
+ baseUrl: { type: "string" },
523
+ model: { type: "string" },
524
+ timeoutMs: { type: "number" },
525
+ fallback: { type: "string", enum: ["rules", "skip"] },
526
+ confidenceThreshold: { type: "number" },
527
+ rules: {
528
+ type: "array",
529
+ items: {
530
+ type: "object",
531
+ properties: {
532
+ id: { type: "string" },
533
+ field: {
534
+ type: "string",
535
+ enum: ["status", "task", "error", "cost"],
536
+ },
537
+ operator: {
538
+ type: "string",
539
+ enum: ["equals", "contains", "regex", "gt", "lt", "gte", "lte"],
540
+ },
541
+ value: { type: ["string", "number"] },
542
+ category: {
543
+ type: "string",
544
+ enum: ["quality", "timeout", "permission", "network", "unknown"],
545
+ },
546
+ severity: { type: "string", enum: ["low", "medium", "high"] },
547
+ confidence: { type: "number" },
548
+ action: { type: "string", enum: ["notify", "skip"] },
549
+ reason: { type: "string" },
550
+ priority: { type: "number" },
551
+ },
552
+ required: ["field", "operator", "value"],
553
+ },
554
+ },
555
+ shadow: {
556
+ type: "object",
557
+ properties: {
558
+ enabled: { type: "boolean" },
559
+ days: { type: "number" },
560
+ startedAt: { type: ["string", "null"] },
561
+ },
562
+ required: ["enabled", "days", "startedAt"],
563
+ },
564
+ },
565
+ required: [
566
+ "mode",
567
+ "baseUrl",
568
+ "model",
569
+ "timeoutMs",
570
+ "fallback",
571
+ "confidenceThreshold",
572
+ ],
573
+ },
516
574
  },
517
575
  required: ["enabled", "onlyOnError"],
518
576
  };
@@ -39,6 +39,75 @@ export interface MatrixNotificationSettings {
39
39
  }
40
40
  /** Периодичность дайджеста. */
41
41
  export type DigestFrequency = "daily" | "weekly";
42
+ /** Режим локального триажа уведомлений. */
43
+ export type TriageMode = "off" | "rules" | "llm" | "auto";
44
+ /** Что делать, если LLM-триаж недоступен или не уверен. */
45
+ export type TriageFallback = "rules" | "skip";
46
+ /** Поле уведомления, по которому проверяется правило. */
47
+ export type TriageRuleField = "status" | "task" | "error" | "cost";
48
+ /** Оператор сравнения правила. */
49
+ export type TriageRuleOperator = "equals" | "contains" | "regex" | "gt" | "lt" | "gte" | "lte";
50
+ /** Что делать с уведомлением при совпадении правила. */
51
+ export type TriageRuleAction = "notify" | "skip";
52
+ /** Категория и серьёзность, которые выставляет правило. */
53
+ export type TriageRuleCategory = "quality" | "timeout" | "permission" | "network" | "unknown";
54
+ export type TriageRuleSeverity = "low" | "medium" | "high";
55
+ /**
56
+ * Правило триажа (Спринт 30.4).
57
+ *
58
+ * Правила проверяются по убыванию `priority`; при равном приоритете —
59
+ * в порядке массива. Срабатывает только первое совпавшее правило.
60
+ */
61
+ export interface TriageRule {
62
+ /** Стабильный идентификатор для логов и отчётов. */
63
+ id?: string;
64
+ field: TriageRuleField;
65
+ operator: TriageRuleOperator;
66
+ /** Строка для status/task/error, число для cost. */
67
+ value: string | number;
68
+ category?: TriageRuleCategory;
69
+ severity?: TriageRuleSeverity;
70
+ /** Уверенность правила (0..1), по умолчанию 0.8. */
71
+ confidence?: number;
72
+ action?: TriageRuleAction;
73
+ /** Человекочитаемая причина; иначе собирается из id и условия. */
74
+ reason?: string;
75
+ /** Чем больше, тем раньше проверяется. По умолчанию 0. */
76
+ priority?: number;
77
+ }
78
+ /** Настройки локального триажа уведомлений (Спринт 30). */
79
+ export interface TriageSettings {
80
+ /** off — триаж выключен; rules — только правила; llm — только модель; auto — модель, затем правила. */
81
+ mode: TriageMode;
82
+ /** База Ollama/OpenAI-совместимого API; по умолчанию локальная Ollama. */
83
+ baseUrl: string;
84
+ /** Идентификатор модели, например qwen3:4b. */
85
+ model: string;
86
+ /** Таймаут запроса к модели в мс (1000..120000). */
87
+ timeoutMs: number;
88
+ /** Поведение при отказе модели: правила или пропустить триаж (fail-open). */
89
+ fallback: TriageFallback;
90
+ /** Минимальная уверенность модели (0..1); ниже порога срабатывает fallback. */
91
+ confidenceThreshold: number;
92
+ /**
93
+ * Пользовательские правила. `undefined` — встроенный набор,
94
+ * пустой массив — правил нет.
95
+ */
96
+ rules?: TriageRule[];
97
+ /** Shadow-режим триажа (Спринт 30.6): решения логируются, но не подавляются. */
98
+ shadow?: TriageShadowSettings;
99
+ }
100
+ /** Shadow-режим триажа (Спринт 30.6). */
101
+ export interface TriageShadowSettings {
102
+ /** Включён ли shadow-режим. По умолчанию true. */
103
+ enabled: boolean;
104
+ /** Сколько дней длится shadow-период. По умолчанию 14. */
105
+ days: number;
106
+ /** Момент начала shadow-периода (ISO). null — ещё не Started. */
107
+ startedAt: string | null;
108
+ }
109
+ /** Дни shadow-периода по умолчанию. */
110
+ export declare const DEFAULT_SHADOW_DAYS = 14;
42
111
  /** Дайджест по истории запусков (Спринт 20). */
43
112
  export interface DigestSettings {
44
113
  /** Включён ли дайджест. */
@@ -116,6 +185,8 @@ export interface NotificationSettings {
116
185
  matrix?: MatrixNotificationSettings;
117
186
  /** Периодический дайджест. */
118
187
  digest?: DigestSettings;
188
+ /** Локальный триаж уведомлений. */
189
+ triage?: TriageSettings;
119
190
  }
120
191
  /**
121
192
  * Ретеншн истории (Спринт 18).
@@ -218,6 +289,15 @@ export declare function generateHookCredentials(): {
218
289
  export declare function defaultHistorySettings(): HistorySettings;
219
290
  /** Значения уведомлений по умолчанию: всё выключено, только ошибки. */
220
291
  export declare function defaultNotifications(): NotificationSettings;
292
+ /** Текущий shadow-период ещё активен? (ничего не меняет, только читает). */
293
+ export declare function isShadowActive(shadow: TriageShadowSettings | undefined): boolean;
294
+ /** Начать shadow-период, если ещё не Started. Возвращает нормализованные настройки shadow. */
295
+ export declare function startShadow(shadow: TriageShadowSettings | undefined): TriageShadowSettings;
296
+ /**
297
+ * Настройки shadow после сохранения: включённый режим без даты старта
298
+ * получает текущий момент, выключенный — сбрасывает дату.
299
+ */
300
+ export declare function settleShadowOnSave(shadow: TriageShadowSettings | undefined): TriageShadowSettings;
221
301
  /** Читает настройки. Битый/отсутствующий файл — значения по умолчанию. */
222
302
  export declare function loadSettings(): Promise<SchedulerSettings>;
223
303
  /** Сохраняет настройки (частичное обновление поверх текущих). */
@@ -1 +1 @@
1
- {"version":3,"file":"settings.d.ts","sourceRoot":"","sources":["../src/settings.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"settings.d.ts","sourceRoot":"","sources":["../src/settings.ts"],"names":[],"mappings":"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"}
package/dist/settings.js CHANGED
@@ -3,6 +3,8 @@ import fs from "node:fs/promises";
3
3
  import path from "node:path";
4
4
  import { PLUGIN_DIR } from "./types.js";
5
5
  import { DEFAULT_LOCALE, normalizeLocale, SUPPORTED_LOCALES, messageIn, t } from "./i18n.js";
6
+ /** Дни shadow-периода по умолчанию. */
7
+ export const DEFAULT_SHADOW_DAYS = 14;
6
8
  export const SETTINGS_FILE = path.join(PLUGIN_DIR, "settings.json");
7
9
  export const DEFAULT_MAX_CONCURRENT = 1;
8
10
  export const DEFAULT_WINTER_MODE = false;
@@ -143,6 +145,19 @@ export function defaultNotifications() {
143
145
  time: "09:00",
144
146
  lastSentAt: null,
145
147
  },
148
+ triage: {
149
+ mode: "off",
150
+ baseUrl: "http://127.0.0.1:11434",
151
+ model: "qwen3:4b",
152
+ timeoutMs: 45000,
153
+ fallback: "rules",
154
+ confidenceThreshold: 0.6,
155
+ shadow: {
156
+ enabled: true,
157
+ days: DEFAULT_SHADOW_DAYS,
158
+ startedAt: null,
159
+ },
160
+ },
146
161
  };
147
162
  }
148
163
  /** Приводит значение лимита к безопасному целому (>= 0). */
@@ -224,6 +239,160 @@ function localizedTemplate(value, key, fallback) {
224
239
  const builtin = SUPPORTED_LOCALES.some((locale) => messageIn(locale, key) === raw);
225
240
  return builtin ? t(key) : raw;
226
241
  }
242
+ /** Приводит режим триажа к допустимому значению. */
243
+ function normalizeTriageMode(value, fallback) {
244
+ return value === "off" || value === "rules" || value === "llm" || value === "auto"
245
+ ? value
246
+ : fallback;
247
+ }
248
+ /** Приводит fallback триажа к допустимому значению. */
249
+ function normalizeTriageFallback(value, fallback) {
250
+ return value === "rules" || value === "skip" ? value : fallback;
251
+ }
252
+ /** Приводит порог уверенности к диапазону 0..1. */
253
+ function normalizeConfidence(value, fallback) {
254
+ const n = Number(value);
255
+ if (!Number.isFinite(n))
256
+ return fallback;
257
+ return Math.min(1, Math.max(0, n));
258
+ }
259
+ const TRIAGE_RULE_FIELDS = ["status", "task", "error", "cost"];
260
+ const TRIAGE_RULE_OPERATORS = [
261
+ "equals",
262
+ "contains",
263
+ "regex",
264
+ "gt",
265
+ "lt",
266
+ "gte",
267
+ "lte",
268
+ ];
269
+ const TRIAGE_RULE_CATEGORIES = [
270
+ "quality",
271
+ "timeout",
272
+ "permission",
273
+ "network",
274
+ "unknown",
275
+ ];
276
+ const TRIAGE_RULE_SEVERITIES = ["low", "medium", "high"];
277
+ /** Допустимые операторы для поля: текст сравнивается строками, cost — числами. */
278
+ function ruleOperatorAllowed(field, operator) {
279
+ return field === "cost"
280
+ ? operator !== "contains" && operator !== "regex"
281
+ : operator === "equals" || operator === "contains" || operator === "regex";
282
+ }
283
+ /** Нормализует одно правило; невалидное возвращает null (правило отбрасывается). */
284
+ function normalizeTriageRule(value) {
285
+ const raw = asRecord(value);
286
+ if (!raw)
287
+ return null;
288
+ const field = TRIAGE_RULE_FIELDS.includes(raw.field)
289
+ ? raw.field
290
+ : null;
291
+ const operator = TRIAGE_RULE_OPERATORS.includes(raw.operator)
292
+ ? raw.operator
293
+ : null;
294
+ if (!field || !operator || !ruleOperatorAllowed(field, operator))
295
+ return null;
296
+ let ruleValue;
297
+ if (field === "cost") {
298
+ const n = Number(raw.value);
299
+ if (!Number.isFinite(n) || n < 0)
300
+ return null;
301
+ ruleValue = n;
302
+ }
303
+ else {
304
+ if (typeof raw.value !== "string" || !raw.value.trim())
305
+ return null;
306
+ ruleValue = raw.value.trim().slice(0, 500);
307
+ }
308
+ if (operator === "regex") {
309
+ try {
310
+ new RegExp(String(ruleValue), "i");
311
+ }
312
+ catch {
313
+ return null;
314
+ }
315
+ }
316
+ const rule = { field, operator, value: ruleValue };
317
+ if (typeof raw.id === "string" && raw.id.trim())
318
+ rule.id = raw.id.trim().slice(0, 64);
319
+ if (TRIAGE_RULE_CATEGORIES.includes(raw.category)) {
320
+ rule.category = raw.category;
321
+ }
322
+ if (TRIAGE_RULE_SEVERITIES.includes(raw.severity)) {
323
+ rule.severity = raw.severity;
324
+ }
325
+ if (raw.confidence !== undefined)
326
+ rule.confidence = normalizeConfidence(raw.confidence, 0.8);
327
+ if (raw.action === "notify" || raw.action === "skip")
328
+ rule.action = raw.action;
329
+ if (typeof raw.reason === "string" && raw.reason.trim()) {
330
+ rule.reason = raw.reason.trim().slice(0, 300);
331
+ }
332
+ const priority = Number(raw.priority);
333
+ rule.priority = Number.isFinite(priority)
334
+ ? Math.min(10000, Math.max(-10000, Math.trunc(priority)))
335
+ : 0;
336
+ return rule;
337
+ }
338
+ /** Нормализует массив правил; undefined сохраняет встроенный набор. */
339
+ function normalizeTriageRules(value, fallback) {
340
+ if (value === undefined)
341
+ return fallback?.map((rule) => ({ ...rule }));
342
+ if (!Array.isArray(value))
343
+ return fallback?.map((rule) => ({ ...rule }));
344
+ return value
345
+ .slice(0, 200)
346
+ .map(normalizeTriageRule)
347
+ .filter((rule) => rule !== null);
348
+ }
349
+ /** Нормализует настройки shadow-режима триажа. */
350
+ function normalizeTriageShadow(value, fallback) {
351
+ if (!value || typeof value !== "object" || Array.isArray(value)) {
352
+ return { ...fallback };
353
+ }
354
+ const raw = value;
355
+ return {
356
+ enabled: typeof raw.enabled === "boolean" ? raw.enabled : fallback.enabled,
357
+ days: normalizeIntInRange(raw.days, fallback.days, 1, 365),
358
+ startedAt: typeof raw.startedAt === "string" && raw.startedAt.trim()
359
+ ? raw.startedAt.trim()
360
+ : null,
361
+ };
362
+ }
363
+ /** Текущий shadow-период ещё активен? (ничего не меняет, только читает). */
364
+ export function isShadowActive(shadow) {
365
+ if (!shadow || !shadow.enabled || !shadow.startedAt)
366
+ return false;
367
+ const started = new Date(shadow.startedAt).getTime();
368
+ if (!Number.isFinite(started))
369
+ return false;
370
+ const now = Date.now();
371
+ const days = Number.isFinite(shadow.days) && shadow.days > 0 ? shadow.days : DEFAULT_SHADOW_DAYS;
372
+ return now - started < days * 24 * 60 * 60 * 1000;
373
+ }
374
+ /** Начать shadow-период, если ещё не Started. Возвращает нормализованные настройки shadow. */
375
+ export function startShadow(shadow) {
376
+ const nowIso = new Date().toISOString();
377
+ if (!shadow) {
378
+ return { enabled: true, days: DEFAULT_SHADOW_DAYS, startedAt: nowIso };
379
+ }
380
+ if (!shadow.startedAt) {
381
+ return { ...shadow, startedAt: nowIso };
382
+ }
383
+ return { ...shadow };
384
+ }
385
+ /**
386
+ * Настройки shadow после сохранения: включённый режим без даты старта
387
+ * получает текущий момент, выключенный — сбрасывает дату.
388
+ */
389
+ export function settleShadowOnSave(shadow) {
390
+ if (!shadow)
391
+ return startShadow(undefined);
392
+ if (!shadow.enabled)
393
+ return { ...shadow, startedAt: null };
394
+ return startShadow(shadow);
395
+ }
227
396
  /** Приводит настройки уведомлений к безопасному виду. */
228
397
  function normalizeNotifications(value, fallback) {
229
398
  const fallbackWebhook = fallback.webhook ?? defaultNotifications().webhook;
@@ -234,6 +403,8 @@ function normalizeNotifications(value, fallback) {
234
403
  const fallbackTelegram = fallback.telegram ?? defaultNotifications().telegram;
235
404
  const fallbackNative = fallback.native ?? defaultNotifications().native;
236
405
  const fallbackQuiet = fallback.quietHours ?? defaultNotifications().quietHours;
406
+ const fallbackTriage = fallback.triage ?? defaultNotifications().triage;
407
+ const fallbackShadow = fallbackTriage.shadow ?? defaultNotifications().triage.shadow;
237
408
  const raw = asRecord(value);
238
409
  if (!raw) {
239
410
  return {
@@ -249,6 +420,11 @@ function normalizeNotifications(value, fallback) {
249
420
  telegram: { ...fallbackTelegram },
250
421
  native: { ...fallbackNative },
251
422
  quietHours: { ...fallbackQuiet },
423
+ triage: {
424
+ ...fallbackTriage,
425
+ rules: fallbackTriage.rules?.map((rule) => ({ ...rule })),
426
+ shadow: { ...fallbackShadow },
427
+ },
252
428
  dashboardUrl: fallback.dashboardUrl ?? "",
253
429
  };
254
430
  }
@@ -260,12 +436,17 @@ function normalizeNotifications(value, fallback) {
260
436
  const rawTelegram = asRecord(raw.telegram);
261
437
  const rawNative = asRecord(raw.native);
262
438
  const rawQuiet = asRecord(raw.quietHours);
439
+ const rawTriage = asRecord(raw.triage);
263
440
  const frequency = rawDigest?.frequency === "weekly" || rawDigest?.frequency === "daily"
264
441
  ? rawDigest.frequency
265
442
  : fallbackDigest.frequency;
266
443
  const lastSentAt = typeof rawDigest?.lastSentAt === "string" && rawDigest.lastSentAt.trim()
267
444
  ? rawDigest.lastSentAt.trim()
268
445
  : null;
446
+ // `rules` отсутствует, если используется встроенный набор. Ключ с явным
447
+ // `undefined` нельзя отдавать по RPC: JSON-схема превращает неописанные
448
+ // поля в Schema.Json, которая отвергает undefined ("Expected JSON value").
449
+ const triageRules = normalizeTriageRules(rawTriage?.rules, fallbackTriage.rules);
269
450
  return {
270
451
  enabled: typeof raw.enabled === "boolean" ? raw.enabled : fallback.enabled,
271
452
  onlyOnError: typeof raw.onlyOnError === "boolean" ? raw.onlyOnError : fallback.onlyOnError,
@@ -350,6 +531,18 @@ function normalizeNotifications(value, fallback) {
350
531
  time: normalizeDailyTime(rawDigest?.time, fallbackDigest.time),
351
532
  lastSentAt,
352
533
  },
534
+ triage: {
535
+ mode: normalizeTriageMode(rawTriage?.mode, fallbackTriage.mode),
536
+ baseUrl: normalizeHttpBase(rawTriage?.baseUrl, fallbackTriage.baseUrl),
537
+ model: typeof rawTriage?.model === "string" && rawTriage.model.trim()
538
+ ? rawTriage.model.trim().slice(0, 200)
539
+ : fallbackTriage.model,
540
+ timeoutMs: normalizeIntInRange(rawTriage?.timeoutMs, fallbackTriage.timeoutMs, 1000, 120000),
541
+ fallback: normalizeTriageFallback(rawTriage?.fallback, fallbackTriage.fallback),
542
+ confidenceThreshold: normalizeConfidence(rawTriage?.confidenceThreshold, fallbackTriage.confidenceThreshold),
543
+ ...(triageRules !== undefined ? { rules: triageRules } : {}),
544
+ shadow: normalizeTriageShadow(rawTriage?.shadow, fallbackShadow),
545
+ },
353
546
  };
354
547
  }
355
548
  /** Приводит настройки интеграций к безопасному виду. */
@@ -445,6 +638,12 @@ export async function saveSettings(patch) {
445
638
  next.integrations.hooks.secret = generated.secret;
446
639
  }
447
640
  }
641
+ // Удобство: включённый shadow-режим без даты старта стартует при первом сохранении.
642
+ // Иначе shadow не логировал бы решения, а триаж реально подавлял бы уведомления.
643
+ const triage = next.notifications.triage;
644
+ if (triage) {
645
+ triage.shadow = settleShadowOnSave(triage.shadow);
646
+ }
448
647
  await fs.mkdir(PLUGIN_DIR, { recursive: true });
449
648
  await fs.writeFile(SETTINGS_FILE, JSON.stringify(next, null, 2), "utf8");
450
649
  return next;
@@ -33,15 +33,16 @@ model, the modules, the data model and the extension points.
33
33
  The wrapper reports the result back to the database, not to the plugin host.
34
34
  4. **One source of truth for definitions is SQLite.** OS entries are derived artifacts:
35
35
  they can always be recreated from the database with export/import.
36
- 5. **Local first.** No network services, no telemetry, no accounts. The dashboard binds
37
- to localhost only.
36
+ 5. **Local first.** No network services, no telemetry, no accounts by default. The dashboard binds
37
+ to localhost only. Local AI triage (Ollama) is optional and connects only when explicitly enabled
38
+ via `manage_local_ai`.
38
39
 
39
40
  ## Process model
40
41
 
41
42
  ```
42
43
  ┌─────────────────────────────┐
43
44
  │ OpenCode (plugin host) │
44
- │ • agent tools (12) │
45
+ │ • agent tools (25) │
45
46
  │ • sidebar GUI (gui.tsx) │
46
47
  │ • RPC ↔ sidebar │
47
48
  │ • dashboard HTTP server │
@@ -121,7 +122,7 @@ from their clones instead of their own last run.
121
122
 
122
123
  | Path | Role |
123
124
  | --- | --- |
124
- | `src/index.ts` | Plugin lifecycle, 24 agent tools, RPC handlers, task CRUD, view assembly |
125
+ | `src/index.ts` | Plugin lifecycle, 25 agent tools, RPC handlers, task CRUD, view assembly |
125
126
  | `src/rpc.ts` | JSON-schema contracts for every RPC method |
126
127
  | `src/gui.tsx` | OpenCode sidebar panel (SolidJS, built to `gui-experimental.cjs`) |
127
128
  | `src/server.ts` | Local web dashboard HTTP server and HTML rendering |
@@ -130,7 +131,7 @@ from their clones instead of their own last run.
130
131
  | `src/profiles.ts` | Profile directory resolution: per-profile plugin dir (base for `default`, `<base>/profiles/<name>` for named profiles); profile name, marker, port, create/delete/switch |
131
132
  | `src/workspaces.ts` | Workspace registry and path validation; env pairs and `.env` file resolution with secret masking |
132
133
  | `src/templates.ts` | Reusable task templates |
133
- | `src/settings.ts` | Plugin settings: notifications, history retention, audit, interface locale |
134
+ | `src/settings.ts` | Plugin settings: notifications, history retention, audit, interface locale, local AI/triage |
134
135
  | `src/i18n.ts` | Interface locale (`ru` default, `en`), JSON catalogs in `locales/`, ICU subset (`{param}`, `plural`) via built-in `Intl`, fallback to `ru` |
135
136
  | `src/notifications.ts` | Multi-channel delivery (webhook, Telegram, native OS) with retries/backoff, templates, task filters, quiet hours, matrix and stuck-clone notifications, daily/weekly digest |
136
137
  | `src/core/telegram.ts` | Telegram Bot API `sendMessage`: parse-mode escaping, dashboard link, token validation and masking |
@@ -149,6 +150,7 @@ from their clones instead of their own last run.
149
150
  | `src/core/dry-run.ts` | Pipeline simulation (no execution) |
150
151
  | `src/core/lock.ts` | Single-instance lock manager |
151
152
  | `src/core/file-watcher.ts` | chokidar-based file triggers |
153
+ | `src/core/local-ai.ts` | Local AI triage: LLM classifier with rules fallback, shadow mode, fail-open, manage_local_ai backing |
152
154
  | `src/core/cron-to-schtasks.ts` | Cron → Task Scheduler translation |
153
155
  | `src/core/schedule-v2.ts` | Extended cron parser/matcher, timezone math, launch windows, poll-mode decisions |
154
156
  | `src/core/schedule-gate.ts` | Wrapper-side gate: cron re-check (poll mode), window postpone, defer-file |
@@ -311,9 +313,9 @@ never requires a manual migration.
311
313
 
312
314
  | Interface | Audience | Entry point |
313
315
  | --- | --- | --- |
314
- | Agent tools | AI agent | 24 tools registered via `ctx.tool.transform` |
316
+ | Agent tools | AI agent | 25 tools registered via `ctx.tool.transform` |
315
317
  | Agent skill | AI agent | `skills/scheduled-job-best-practices` |
316
- | RPC | Sidebar GUI | `src/rpc.ts` contracts, ~30 methods |
318
+ | RPC | Sidebar GUI | `src/rpc.ts` contracts, 44 methods |
317
319
  | Sidebar GUI | Human | `gui-experimental.cjs` |
318
320
  | Web dashboard | Human | `startDashboardServer` (localhost, random/fixed port) |
319
321
 
package/docs/FEATURES.md CHANGED
@@ -557,10 +557,10 @@ the `cleanup_history` RPC and the GUI's «Очистить сейчас» button
557
557
 
558
558
  ## Agent interface
559
559
 
560
- Twenty-four tools: `schedule_task`, `list_tasks`, `update_task`, `delete_task`,
560
+ Twenty-five tools: `schedule_task`, `list_tasks`, `update_task`, `delete_task`,
561
561
  `run_task_now`, `pause_task`, `resume_task`, `get_history`, `get_task_logs`, `dry_run`,
562
562
  `manage_workspaces`, `matrix_control` (results/cancel/cleanup/preview), `get_metrics`,
563
- `get_analytics`, `manage_settings`, `manage_templates`, `manage_profiles`,
563
+ `get_analytics`, `manage_settings`, `manage_local_ai`, `manage_templates`, `manage_profiles`,
564
564
  `transfer_tasks`, `send_notification`, `get_dashboard_info`, `cleanup_history`,
565
565
  `manage_secrets`, `get_audit_log`,
566
566
  `emit_event`.
@@ -570,6 +570,26 @@ least privilege, Quality Gates, timeout, matrix concurrency, DAG rules and a
570
570
  create → dry-run → run-now → inspect loop. It is registered automatically by the
571
571
  plugin, no installation step required.
572
572
 
573
+ The `manage_local_ai` tool reads, updates and tests the local triage settings
574
+ (`action: "get" | "update" | "test"`); see [LOCAL-AI.md](LOCAL-AI.md).
575
+
576
+ ## Local assistant (triage)
577
+
578
+ An optional offline model classifies failed and partial runs to decide whether a
579
+ notification is worth sending. It is opt-in and fail-open: without a model the
580
+ rules engine or direct delivery takes over, and notifications are never blocked.
581
+ It never changes run status, retries, Quality Gates, DAG dependencies or history.
582
+
583
+ - `mode`: `off` (default), `rules`, `llm` or `auto` (model, then rules).
584
+ - `fallback`: `rules` (default) or `skip` when the model fails or is unsure.
585
+ - `confidenceThreshold`: minimum model confidence (0..1).
586
+ - Shadow mode logs decisions without suppressing notifications, so triage can be
587
+ evaluated safely before it is enforced.
588
+
589
+ Setup, model tiers by RAM, the `npm run bench:local` benchmark, shadow workflow
590
+ and troubleshooting (including `OLLAMA_CONTEXT_LENGTH`) are documented in
591
+ [LOCAL-AI.md](LOCAL-AI.md).
592
+
573
593
  ## Platform support
574
594
 
575
595
  | Capability | Windows | Linux | macOS |