opencode-windows-scheduler 1.5.2 → 1.5.5

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 (231) hide show
  1. package/CHANGELOG.md +107 -2
  2. package/CROSS_PLATFORM.md +107 -71
  3. package/LICENSE +21 -21
  4. package/README.md +74 -26
  5. package/ROADMAP-STRATEGY.md +11 -4
  6. package/ROADMAP.md +322 -112
  7. package/dist/core/analytics.d.ts +3 -0
  8. package/dist/core/analytics.d.ts.map +1 -1
  9. package/dist/core/analytics.js +4 -0
  10. package/dist/core/audit.d.ts +2 -1
  11. package/dist/core/audit.d.ts.map +1 -1
  12. package/dist/core/audit.js +32 -1
  13. package/dist/core/cron-to-schtasks.d.ts.map +1 -1
  14. package/dist/core/cron-to-schtasks.js +21 -4
  15. package/dist/core/file-watcher.d.ts.map +1 -1
  16. package/dist/core/file-watcher.js +16 -1
  17. package/dist/core/git-trigger.d.ts +4 -2
  18. package/dist/core/git-trigger.d.ts.map +1 -1
  19. package/dist/core/git-trigger.js +34 -16
  20. package/dist/core/local-ai.d.ts +52 -0
  21. package/dist/core/local-ai.d.ts.map +1 -0
  22. package/dist/core/local-ai.js +119 -0
  23. package/dist/core/lock.d.ts +14 -0
  24. package/dist/core/lock.d.ts.map +1 -1
  25. package/dist/core/lock.js +81 -4
  26. package/dist/core/matrix.d.ts.map +1 -1
  27. package/dist/core/matrix.js +3 -2
  28. package/dist/core/native-notify.d.ts.map +1 -1
  29. package/dist/core/native-notify.js +3 -0
  30. package/dist/core/one-shot.d.ts +7 -1
  31. package/dist/core/one-shot.d.ts.map +1 -1
  32. package/dist/core/one-shot.js +15 -2
  33. package/dist/core/permissions.d.ts +69 -0
  34. package/dist/core/permissions.d.ts.map +1 -0
  35. package/dist/core/permissions.js +143 -0
  36. package/dist/core/ps-wrapper.d.ts +9 -30
  37. package/dist/core/ps-wrapper.d.ts.map +1 -1
  38. package/dist/core/ps-wrapper.js +477 -108
  39. package/dist/core/record-history.d.ts +11 -0
  40. package/dist/core/record-history.d.ts.map +1 -1
  41. package/dist/core/record-history.js +106 -4
  42. package/dist/core/savings.d.ts +70 -0
  43. package/dist/core/savings.d.ts.map +1 -0
  44. package/dist/core/savings.js +87 -0
  45. package/dist/core/schedule-gate.js +7 -3
  46. package/dist/core/schedule-v2.js +1 -1
  47. package/dist/core/scheduler/index.d.ts +13 -1
  48. package/dist/core/scheduler/index.d.ts.map +1 -1
  49. package/dist/core/scheduler/index.js +35 -4
  50. package/dist/core/scheduler/linux.d.ts +4 -1
  51. package/dist/core/scheduler/linux.d.ts.map +1 -1
  52. package/dist/core/scheduler/linux.js +53 -20
  53. package/dist/core/scheduler/mac.d.ts +2 -1
  54. package/dist/core/scheduler/mac.d.ts.map +1 -1
  55. package/dist/core/scheduler/mac.js +24 -6
  56. package/dist/core/scheduler/posix.d.ts +1 -1
  57. package/dist/core/scheduler/posix.d.ts.map +1 -1
  58. package/dist/core/scheduler/posix.js +2 -2
  59. package/dist/core/scheduler/registry.d.ts +3 -2
  60. package/dist/core/scheduler/registry.d.ts.map +1 -1
  61. package/dist/core/scheduler/registry.js +6 -5
  62. package/dist/core/scheduler/windows.d.ts +49 -1
  63. package/dist/core/scheduler/windows.d.ts.map +1 -1
  64. package/dist/core/scheduler/windows.js +219 -34
  65. package/dist/core/secrets.d.ts +5 -3
  66. package/dist/core/secrets.d.ts.map +1 -1
  67. package/dist/core/secrets.js +86 -8
  68. package/dist/core/self-analysis.d.ts +117 -0
  69. package/dist/core/self-analysis.d.ts.map +1 -0
  70. package/dist/core/self-analysis.js +539 -0
  71. package/dist/core/session.d.ts +11 -3
  72. package/dist/core/session.d.ts.map +1 -1
  73. package/dist/core/session.js +34 -5
  74. package/dist/core/shutdown.d.ts +26 -0
  75. package/dist/core/shutdown.d.ts.map +1 -0
  76. package/dist/core/shutdown.js +49 -0
  77. package/dist/core/summary.d.ts +69 -0
  78. package/dist/core/summary.d.ts.map +1 -0
  79. package/dist/core/summary.js +250 -0
  80. package/dist/core/telegram.d.ts +10 -0
  81. package/dist/core/telegram.d.ts.map +1 -1
  82. package/dist/core/telegram.js +228 -47
  83. package/dist/core/triage-chain.d.ts +40 -0
  84. package/dist/core/triage-chain.d.ts.map +1 -0
  85. package/dist/core/triage-chain.js +80 -0
  86. package/dist/core/triage-compare.d.ts +68 -0
  87. package/dist/core/triage-compare.d.ts.map +1 -0
  88. package/dist/core/triage-compare.js +184 -0
  89. package/dist/core/triage-rules.d.ts +23 -0
  90. package/dist/core/triage-rules.d.ts.map +1 -0
  91. package/dist/core/triage-rules.js +196 -0
  92. package/dist/core/triage-shadow.d.ts +91 -0
  93. package/dist/core/triage-shadow.d.ts.map +1 -0
  94. package/dist/core/triage-shadow.js +160 -0
  95. package/dist/core/triage-worker.d.ts +55 -0
  96. package/dist/core/triage-worker.d.ts.map +1 -0
  97. package/dist/core/triage-worker.js +314 -0
  98. package/dist/core/triage.d.ts +76 -0
  99. package/dist/core/triage.d.ts.map +1 -0
  100. package/dist/core/triage.js +271 -0
  101. package/dist/core/watch-paths.d.ts +6 -0
  102. package/dist/core/watch-paths.d.ts.map +1 -0
  103. package/dist/core/watch-paths.js +62 -0
  104. package/dist/core/wrappers/bash.d.ts +15 -3
  105. package/dist/core/wrappers/bash.d.ts.map +1 -1
  106. package/dist/core/wrappers/bash.js +153 -120
  107. package/dist/db/history-repo.d.ts +1 -1
  108. package/dist/db/history-repo.d.ts.map +1 -1
  109. package/dist/db/history-repo.js +29 -14
  110. package/dist/db/schema.d.ts +1 -1
  111. package/dist/db/schema.d.ts.map +1 -1
  112. package/dist/db/schema.js +31 -0
  113. package/dist/history.d.ts +2 -2
  114. package/dist/history.d.ts.map +1 -1
  115. package/dist/history.js +3 -3
  116. package/dist/i18n.d.ts +25 -2
  117. package/dist/i18n.d.ts.map +1 -1
  118. package/dist/i18n.js +75 -10
  119. package/dist/index.d.ts +66 -3
  120. package/dist/index.d.ts.map +1 -1
  121. package/dist/index.js +527 -68
  122. package/dist/integrations.d.ts +9 -1
  123. package/dist/integrations.d.ts.map +1 -1
  124. package/dist/integrations.js +34 -6
  125. package/dist/notifications.d.ts +30 -2
  126. package/dist/notifications.d.ts.map +1 -1
  127. package/dist/notifications.js +289 -10
  128. package/dist/profiles.d.ts +1 -1
  129. package/dist/profiles.d.ts.map +1 -1
  130. package/dist/profiles.js +21 -3
  131. package/dist/rpc.d.ts +401 -5
  132. package/dist/rpc.d.ts.map +1 -1
  133. package/dist/rpc.js +138 -5
  134. package/dist/server.d.ts +20 -0
  135. package/dist/server.d.ts.map +1 -1
  136. package/dist/server.js +136 -14
  137. package/dist/settings.d.ts +167 -3
  138. package/dist/settings.d.ts.map +1 -1
  139. package/dist/settings.js +322 -3
  140. package/dist/task-transfer.d.ts +8 -1
  141. package/dist/task-transfer.d.ts.map +1 -1
  142. package/dist/task-transfer.js +2 -2
  143. package/dist/types.d.ts +8 -1
  144. package/dist/types.d.ts.map +1 -1
  145. package/dist/types.js +23 -5
  146. package/dist/workspaces.d.ts +9 -0
  147. package/dist/workspaces.d.ts.map +1 -1
  148. package/dist/workspaces.js +25 -0
  149. package/docs/ARCHITECTURE.md +48 -28
  150. package/docs/CONCEPT.md +230 -0
  151. package/docs/CROSS_PLATFORM.ru.md +150 -0
  152. package/docs/CROSS_PLATFORM.zh.md +146 -0
  153. package/docs/FAQ.md +52 -0
  154. package/docs/FAQ.ru.md +53 -0
  155. package/docs/FAQ.zh.md +43 -0
  156. package/docs/FEATURES.md +141 -44
  157. package/docs/FEATURES.zh.md +655 -0
  158. package/docs/LOCAL-AI.md +300 -0
  159. package/docs/MIGRATION.md +17 -0
  160. package/docs/README.ru.md +22 -16
  161. package/docs/README.zh.md +286 -0
  162. package/docs/SAVINGS.md +61 -0
  163. package/docs/SAVINGS.ru.md +60 -0
  164. package/docs/SAVINGS.zh.md +52 -0
  165. package/docs/ZH-LOCALE-PLAN.md +324 -0
  166. package/docs/spikes/local-model-structured-output.md +81 -0
  167. package/docs/spikes/ollama-qwen3-4b-smoke.json +28 -0
  168. package/docs/spikes/ollama-qwen3-4b.json +163 -0
  169. package/gui-experimental.cjs +8 -8
  170. package/locales/en.json +85 -0
  171. package/locales/ru.json +85 -0
  172. package/locales/zh.json +780 -0
  173. package/package.json +31 -7
  174. package/scripts/bench-local.mjs +321 -0
  175. package/scripts/check-zh-locale.mjs +218 -0
  176. package/scripts/run-tests.mjs +236 -0
  177. package/scripts/spike-local-structured.mjs +182 -0
  178. package/scripts/test-locale.mjs +4 -3
  179. package/skills/scheduled-job-best-practices/SKILL.md +6 -3
  180. package/skills/scheduled-job-best-practices/references/recipes.md +40 -0
  181. package/src/core/analytics.ts +10 -0
  182. package/src/core/audit.ts +39 -1
  183. package/src/core/cron-to-schtasks.ts +23 -4
  184. package/src/core/file-watcher.ts +20 -1
  185. package/src/core/git-trigger.ts +34 -16
  186. package/src/core/local-ai.ts +173 -0
  187. package/src/core/lock.ts +88 -3
  188. package/src/core/matrix.ts +5 -1
  189. package/src/core/native-notify.ts +3 -0
  190. package/src/core/one-shot.ts +18 -2
  191. package/src/core/permissions.ts +200 -0
  192. package/src/core/ps-wrapper.ts +492 -108
  193. package/src/core/record-history.ts +111 -4
  194. package/src/core/savings.ts +150 -0
  195. package/src/core/schedule-gate.ts +9 -3
  196. package/src/core/schedule-v2.ts +1 -1
  197. package/src/core/scheduler/index.ts +41 -3
  198. package/src/core/scheduler/linux.ts +67 -22
  199. package/src/core/scheduler/mac.ts +24 -7
  200. package/src/core/scheduler/posix.ts +2 -2
  201. package/src/core/scheduler/registry.ts +7 -5
  202. package/src/core/scheduler/windows.ts +237 -32
  203. package/src/core/secrets.ts +101 -7
  204. package/src/core/self-analysis.ts +744 -0
  205. package/src/core/session.ts +40 -5
  206. package/src/core/shutdown.ts +69 -0
  207. package/src/core/summary.ts +318 -0
  208. package/src/core/telegram.ts +266 -55
  209. package/src/core/triage-chain.ts +125 -0
  210. package/src/core/triage-compare.ts +277 -0
  211. package/src/core/triage-rules.ts +238 -0
  212. package/src/core/triage-shadow.ts +240 -0
  213. package/src/core/triage-worker.ts +344 -0
  214. package/src/core/triage.ts +366 -0
  215. package/src/core/watch-paths.ts +70 -0
  216. package/src/core/wrappers/bash.ts +181 -138
  217. package/src/db/history-repo.ts +31 -18
  218. package/src/db/schema.ts +31 -0
  219. package/src/gui.tsx +551 -14
  220. package/src/history.ts +7 -3
  221. package/src/i18n.ts +87 -13
  222. package/src/index.ts +649 -71
  223. package/src/integrations.ts +50 -6
  224. package/src/notifications.ts +468 -5
  225. package/src/profiles.ts +21 -3
  226. package/src/rpc.ts +143 -5
  227. package/src/server.ts +135 -16
  228. package/src/settings.ts +582 -5
  229. package/src/task-transfer.ts +10 -3
  230. package/src/types.ts +24 -5
  231. package/src/workspaces.ts +22 -0
package/src/settings.ts CHANGED
@@ -2,7 +2,12 @@ import crypto from "node:crypto";
2
2
  import fs from "node:fs/promises";
3
3
  import path from "node:path";
4
4
  import { PLUGIN_DIR } from "./types.js";
5
- import { DEFAULT_LOCALE, normalizeLocale, SUPPORTED_LOCALES, messageIn, t, type Locale } from "./i18n.js";
5
+ import { DEFAULT_LOCALE, normalizeLocale, normalizeLocaleMode, SUPPORTED_LOCALES, messageIn, t, type Locale, type LocaleMode } from "./i18n.js";
6
+ import {
7
+ DEFAULT_PERMISSION_POLICY,
8
+ normalizePolicy,
9
+ type PermissionPolicy,
10
+ } from "./core/permissions.js";
6
11
 
7
12
  /** Настройки webhook-уведомлений (Discord/Slack/generic). */
8
13
  export interface WebhookNotificationSettings {
@@ -49,6 +54,102 @@ export interface MatrixNotificationSettings {
49
54
  /** Периодичность дайджеста. */
50
55
  export type DigestFrequency = "daily" | "weekly";
51
56
 
57
+ /** Режим локального триажа уведомлений. */
58
+ export type TriageMode = "off" | "rules" | "llm" | "auto";
59
+
60
+ /**
61
+ * Что делать, если LLM-триаж недоступен или не уверен.
62
+ *
63
+ * `rules` — применить правила; `notify` — не применять правила и отправить
64
+ * уведомление. `skip` — устаревшее имя `notify`, сохранено для совместимости.
65
+ */
66
+ export type TriageFallback = "rules" | "notify" | "skip";
67
+
68
+ /** Поле уведомления, по которому проверяется правило. */
69
+ export type TriageRuleField = "status" | "task" | "error" | "cost";
70
+
71
+ /** Оператор сравнения правила. */
72
+ export type TriageRuleOperator =
73
+ | "equals"
74
+ | "contains"
75
+ | "regex"
76
+ | "gt"
77
+ | "lt"
78
+ | "gte"
79
+ | "lte";
80
+
81
+ /** Что делать с уведомлением при совпадении правила. */
82
+ export type TriageRuleAction = "notify" | "skip";
83
+
84
+ /** Категория и серьёзность, которые выставляет правило. */
85
+ export type TriageRuleCategory =
86
+ | "quality"
87
+ | "timeout"
88
+ | "permission"
89
+ | "network"
90
+ | "unknown";
91
+ export type TriageRuleSeverity = "low" | "medium" | "high";
92
+
93
+ /**
94
+ * Правило триажа (Спринт 30.4).
95
+ *
96
+ * Правила проверяются по убыванию `priority`; при равном приоритете —
97
+ * в порядке массива. Срабатывает только первое совпавшее правило.
98
+ */
99
+ export interface TriageRule {
100
+ /** Стабильный идентификатор для логов и отчётов. */
101
+ id?: string;
102
+ field: TriageRuleField;
103
+ operator: TriageRuleOperator;
104
+ /** Строка для status/task/error, число для cost. */
105
+ value: string | number;
106
+ category?: TriageRuleCategory;
107
+ severity?: TriageRuleSeverity;
108
+ /** Уверенность правила (0..1), по умолчанию 0.8. */
109
+ confidence?: number;
110
+ action?: TriageRuleAction;
111
+ /** Человекочитаемая причина; иначе собирается из id и условия. */
112
+ reason?: string;
113
+ /** Чем больше, тем раньше проверяется. По умолчанию 0. */
114
+ priority?: number;
115
+ }
116
+
117
+ /** Настройки локального триажа уведомлений (Спринт 30). */
118
+ export interface TriageSettings {
119
+ /** off — триаж выключен; rules — только правила; llm — только модель; auto — модель, затем правила. */
120
+ mode: TriageMode;
121
+ /** База Ollama/OpenAI-совместимого API; по умолчанию локальная Ollama. */
122
+ baseUrl: string;
123
+ /** Идентификатор модели, например qwen3:4b. */
124
+ model: string;
125
+ /** Таймаут запроса к модели в мс (1000..120000). */
126
+ timeoutMs: number;
127
+ /** Поведение при отказе модели: правила или пропустить триаж (fail-open). */
128
+ fallback: TriageFallback;
129
+ /** Минимальная уверенность модели (0..1); ниже порога срабатывает fallback. */
130
+ confidenceThreshold: number;
131
+ /**
132
+ * Пользовательские правила. `undefined` — встроенный набор,
133
+ * пустой массив — правил нет.
134
+ */
135
+ rules?: TriageRule[];
136
+ /** Shadow-режим триажа (Спринт 30.6): решения логируются, но не подавляются. */
137
+ shadow?: TriageShadowSettings;
138
+ }
139
+
140
+ /** Shadow-режим триажа (Спринт 30.6). */
141
+ export interface TriageShadowSettings {
142
+ /** Включён ли shadow-режим. По умолчанию true. */
143
+ enabled: boolean;
144
+ /** Сколько дней длится shadow-период. По умолчанию 14. */
145
+ days: number;
146
+ /** Момент начала shadow-периода (ISO). null — ещё не Started. */
147
+ startedAt: string | null;
148
+ }
149
+
150
+ /** Дни shadow-периода по умолчанию. */
151
+ export const DEFAULT_SHADOW_DAYS = 14;
152
+
52
153
  /** Дайджест по истории запусков (Спринт 20). */
53
154
  export interface DigestSettings {
54
155
  /** Включён ли дайджест. */
@@ -131,6 +232,64 @@ export interface NotificationSettings {
131
232
  matrix?: MatrixNotificationSettings;
132
233
  /** Периодический дайджест. */
133
234
  digest?: DigestSettings;
235
+ /** Локальный триаж уведомлений. */
236
+ triage?: TriageSettings;
237
+ /** Дедуп уведомлений (Спринт 31.2). */
238
+ dedup?: NotificationDedupSettings;
239
+ /** Семантический дедуп через эмбеддинги (Спринт 31.1). */
240
+ embedding?: NotificationEmbeddingSettings;
241
+ /** Краткое саммари уведомления (Спринт 31.3). */
242
+ summary?: NotificationSummarySettings;
243
+ }
244
+
245
+ /**
246
+ * Саммари уведомления (Спринт 31.3): три строки для Telegram и тостов.
247
+ * Модель возвращает строгий JSON; при отказе — детерминированное усечение.
248
+ */
249
+ export interface NotificationSummarySettings {
250
+ /** Включено ли саммари. По умолчанию false. */
251
+ enabled: boolean;
252
+ /** Максимум строк (1..3). По умолчанию 3. */
253
+ maxLines: number;
254
+ /** Максимум символов в строке. По умолчанию 120. */
255
+ maxCharsPerLine: number;
256
+ /** Таймаут запроса к модели в мс. По умолчанию 8000. */
257
+ timeoutMs: number;
258
+ }
259
+
260
+ /**
261
+ * Дедуп уведомлений (Спринт 31.2): группирует похожие уведомления о задаче
262
+ * в окне времени, показывает счётчик повторов и не подавляет важные.
263
+ */
264
+ export interface NotificationDedupSettings {
265
+ /** Включён ли дедуп. По умолчанию false. */
266
+ enabled: boolean;
267
+ /** Окно группировки в минутах. По умолчанию 60. */
268
+ windowMinutes: number;
269
+ /** Подавлять дубликаты (false — только считать и дописывать в сообщение). */
270
+ suppressDuplicates: boolean;
271
+ /** Статусы, которые никогда не подавляются (всегда доставляются). */
272
+ importantStatuses: string[];
273
+ /** Максимальный счётчик в сообщении. */
274
+ maxCount: number;
275
+ }
276
+
277
+ /**
278
+ * Семантический дедуп через эмбеддинги (Спринт 31.1): группирует уведомления
279
+ * по смыслу текста, а не только по задаче+статусу. Векторы хранятся в SQLite,
280
+ * сравнение — косинусным сходством брутфорсом по порогу.
281
+ */
282
+ export interface NotificationEmbeddingSettings {
283
+ /** Включён ли семантический дедуп. По умолчанию false. */
284
+ enabled: boolean;
285
+ /** Подавлять семантически похожие уведомления. По умолчанию false. */
286
+ suppressDuplicates: boolean;
287
+ /** Окно группировки в минутах. По умолчанию 60. */
288
+ windowMinutes: number;
289
+ /** Порог косинусного сходства (0..1): выше — строже требуется совпадение. */
290
+ threshold: number;
291
+ /** Максимальное число векторов в таблице (старые удаляются). */
292
+ maxVectors: number;
134
293
  }
135
294
 
136
295
  /**
@@ -189,6 +348,12 @@ export interface AuditSettings {
189
348
  maxRecords: number;
190
349
  }
191
350
 
351
+ /** Политика прав фоновых задач (Спринт 32, релиз 1.6). */
352
+ export interface PermissionSettings {
353
+ /** hybrid — без shell/question; secure — только чтение; legacy — как в 1.5.x. */
354
+ defaultPolicy: PermissionPolicy;
355
+ }
356
+
192
357
  /**
193
358
  * Глобальные настройки плагина, которые меняются из GUI.
194
359
  * Хранятся в settings.json рядом с tasks.json / history.json.
@@ -196,8 +361,17 @@ export interface AuditSettings {
196
361
  export interface SchedulerSettings {
197
362
  /** Максимум одновременно выполняющихся задач. 0 — без ограничения. */
198
363
  maxConcurrent: number;
199
- /** Язык интерфейса (Спринт 28): ru по умолчанию, en — опционально. */
200
- locale: Locale;
364
+ /**
365
+ * Язык интерфейса (Спринт 28, режим `auto` — T7): `ru` по умолчанию,
366
+ * `en`/`zh` — явный выбор, `auto` — следовать за языком OpenCode.
367
+ */
368
+ locale: LocaleMode;
369
+ /**
370
+ * Последняя известная локаль интерфейса OpenCode (T7/S24): серверный процесс
371
+ * не видит `ctx.locale`, но рендерит уведомления, дайджест и дашборд.
372
+ * Применяется только при `locale: "auto"`.
373
+ */
374
+ uiLocale: Locale;
201
375
  /** Зимняя тема оформления GUI (снежинки, морозные рамки, градиент). */
202
376
  winterMode: boolean;
203
377
  /** Уведомления о завершении задач. */
@@ -208,6 +382,8 @@ export interface SchedulerSettings {
208
382
  integrations: IntegrationSettings;
209
383
  /** Журнал аудита мутаций (Спринт 26). */
210
384
  audit: AuditSettings;
385
+ /** Политика прав фоновых задач (Спринт 32). */
386
+ permissions: PermissionSettings;
211
387
  }
212
388
 
213
389
  export const SETTINGS_FILE = path.join(PLUGIN_DIR, "settings.json");
@@ -241,6 +417,25 @@ export function defaultAuditSettings(): AuditSettings {
241
417
  };
242
418
  }
243
419
 
420
+ /** Политика прав по умолчанию: гибрид (без shell/question). */
421
+ export function defaultPermissionsSettings(): PermissionSettings {
422
+ return { defaultPolicy: DEFAULT_PERMISSION_POLICY };
423
+ }
424
+
425
+ /** Приводит настройки прав к безопасному виду. */
426
+ function normalizePermissionsSettings(
427
+ value: unknown,
428
+ fallback: PermissionSettings
429
+ ): PermissionSettings {
430
+ if (!value || typeof value !== "object" || Array.isArray(value)) {
431
+ return { ...fallback };
432
+ }
433
+ const raw = value as Partial<PermissionSettings>;
434
+ return {
435
+ defaultPolicy: normalizePolicy(raw.defaultPolicy, fallback.defaultPolicy),
436
+ };
437
+ }
438
+
244
439
  /** Приводит настройки аудита к безопасному виду. */
245
440
  function normalizeAuditSettings(
246
441
  value: unknown,
@@ -373,6 +568,39 @@ export function defaultNotifications(): NotificationSettings {
373
568
  time: "09:00",
374
569
  lastSentAt: null,
375
570
  },
571
+ triage: {
572
+ mode: "off",
573
+ baseUrl: "http://127.0.0.1:11434",
574
+ model: "qwen3:4b",
575
+ timeoutMs: 60_000,
576
+ fallback: "rules",
577
+ confidenceThreshold: 0.6,
578
+ shadow: {
579
+ enabled: true,
580
+ days: DEFAULT_SHADOW_DAYS,
581
+ startedAt: null,
582
+ },
583
+ },
584
+ dedup: {
585
+ enabled: false,
586
+ windowMinutes: 60,
587
+ suppressDuplicates: false,
588
+ importantStatuses: ["error", "timeout"],
589
+ maxCount: 999,
590
+ },
591
+ embedding: {
592
+ enabled: false,
593
+ suppressDuplicates: false,
594
+ windowMinutes: 60,
595
+ threshold: 0.85,
596
+ maxVectors: 10_000,
597
+ },
598
+ summary: {
599
+ enabled: false,
600
+ maxLines: 3,
601
+ maxCharsPerLine: 120,
602
+ timeoutMs: 8_000,
603
+ },
376
604
  };
377
605
  }
378
606
 
@@ -404,6 +632,18 @@ function normalizeIntInRange(
404
632
  return Math.min(max, Math.max(min, Math.floor(n)));
405
633
  }
406
634
 
635
+ /** Приводит число с плавающей точкой к безопасному диапазону. */
636
+ function normalizeFloatInRange(
637
+ value: unknown,
638
+ fallback: number,
639
+ min: number,
640
+ max: number
641
+ ): number {
642
+ const n = Number(value);
643
+ if (!Number.isFinite(n)) return fallback;
644
+ return Math.min(max, Math.max(min, n));
645
+ }
646
+
407
647
  /** Приводит время HH:MM к безопасному виду. */
408
648
  function normalizeDailyTime(value: unknown, fallback: string): string {
409
649
  if (typeof value === "string" && /^([01]\d|2[0-3]):[0-5]\d$/.test(value.trim())) {
@@ -468,6 +708,299 @@ function localizedTemplate(
468
708
  return builtin ? t(key) : raw;
469
709
  }
470
710
 
711
+ /** Приводит режим триажа к допустимому значению. */
712
+ function normalizeTriageMode(value: unknown, fallback: TriageMode): TriageMode {
713
+ return value === "off" || value === "rules" || value === "llm" || value === "auto"
714
+ ? value
715
+ : fallback;
716
+ }
717
+
718
+ /**
719
+ * Приводит fallback триажа к допустимому значению.
720
+ *
721
+ * Старое имя `skip` означает «пропустить правила и отправить уведомление»,
722
+ * поэтому нормализуется в однозначное `notify`.
723
+ */
724
+ function normalizeTriageFallback(value: unknown, fallback: TriageFallback): TriageFallback {
725
+ if (value === "rules" || value === "notify") return value;
726
+ if (value === "skip") return "notify";
727
+ return fallback === "skip" ? "notify" : fallback;
728
+ }
729
+
730
+ /** Приводит порог уверенности к диапазону 0..1. */
731
+ function normalizeConfidence(value: unknown, fallback: number): number {
732
+ const n = Number(value);
733
+ if (!Number.isFinite(n)) return fallback;
734
+ return Math.min(1, Math.max(0, n));
735
+ }
736
+
737
+ const TRIAGE_RULE_FIELDS: readonly TriageRuleField[] = ["status", "task", "error", "cost"];
738
+ const TRIAGE_RULE_OPERATORS: readonly TriageRuleOperator[] = [
739
+ "equals",
740
+ "contains",
741
+ "regex",
742
+ "gt",
743
+ "lt",
744
+ "gte",
745
+ "lte",
746
+ ];
747
+ const TRIAGE_RULE_CATEGORIES: readonly TriageRuleCategory[] = [
748
+ "quality",
749
+ "timeout",
750
+ "permission",
751
+ "network",
752
+ "unknown",
753
+ ];
754
+ const TRIAGE_RULE_SEVERITIES: readonly TriageRuleSeverity[] = ["low", "medium", "high"];
755
+
756
+ /** Допустимые операторы для поля: текст сравнивается строками, cost — числами. */
757
+ function ruleOperatorAllowed(field: TriageRuleField, operator: TriageRuleOperator): boolean {
758
+ return field === "cost"
759
+ ? operator !== "contains" && operator !== "regex"
760
+ : operator === "equals" || operator === "contains" || operator === "regex";
761
+ }
762
+
763
+ /** Нормализует одно правило; невалидное возвращает null (правило отбрасывается). */
764
+ function normalizeTriageRule(value: unknown): TriageRule | null {
765
+ const raw = asRecord(value);
766
+ if (!raw) return null;
767
+
768
+ const field = TRIAGE_RULE_FIELDS.includes(raw.field as TriageRuleField)
769
+ ? (raw.field as TriageRuleField)
770
+ : null;
771
+ const operator = TRIAGE_RULE_OPERATORS.includes(raw.operator as TriageRuleOperator)
772
+ ? (raw.operator as TriageRuleOperator)
773
+ : null;
774
+ if (!field || !operator || !ruleOperatorAllowed(field, operator)) return null;
775
+
776
+ let ruleValue: string | number;
777
+ if (field === "cost") {
778
+ const n = Number(raw.value);
779
+ if (!Number.isFinite(n) || n < 0) return null;
780
+ ruleValue = n;
781
+ } else {
782
+ if (typeof raw.value !== "string" || !raw.value.trim()) return null;
783
+ ruleValue = raw.value.trim().slice(0, 500);
784
+ }
785
+
786
+ if (operator === "regex") {
787
+ try {
788
+ new RegExp(String(ruleValue), "iu");
789
+ } catch {
790
+ return null;
791
+ }
792
+ }
793
+
794
+ const rule: TriageRule = { field, operator, value: ruleValue };
795
+ if (typeof raw.id === "string" && raw.id.trim()) rule.id = raw.id.trim().slice(0, 64);
796
+ if (TRIAGE_RULE_CATEGORIES.includes(raw.category as TriageRuleCategory)) {
797
+ rule.category = raw.category as TriageRuleCategory;
798
+ }
799
+ if (TRIAGE_RULE_SEVERITIES.includes(raw.severity as TriageRuleSeverity)) {
800
+ rule.severity = raw.severity as TriageRuleSeverity;
801
+ }
802
+ if (raw.confidence !== undefined) rule.confidence = normalizeConfidence(raw.confidence, 0.8);
803
+ if (raw.action === "notify" || raw.action === "skip") rule.action = raw.action;
804
+ if (typeof raw.reason === "string" && raw.reason.trim()) {
805
+ rule.reason = raw.reason.trim().slice(0, 300);
806
+ }
807
+ const priority = Number(raw.priority);
808
+ rule.priority = Number.isFinite(priority)
809
+ ? Math.min(10_000, Math.max(-10_000, Math.trunc(priority)))
810
+ : 0;
811
+ return rule;
812
+ }
813
+
814
+ /** Нормализует массив правил; undefined сохраняет встроенный набор. */
815
+ function normalizeTriageRules(
816
+ value: unknown,
817
+ fallback: TriageRule[] | undefined
818
+ ): TriageRule[] | undefined {
819
+ if (value === undefined) return fallback?.map((rule) => ({ ...rule }));
820
+ if (!Array.isArray(value)) return fallback?.map((rule) => ({ ...rule }));
821
+ return value
822
+ .slice(0, 200)
823
+ .map(normalizeTriageRule)
824
+ .filter((rule): rule is TriageRule => rule !== null);
825
+ }
826
+
827
+ /** Нормализует настройки shadow-режима триажа. */
828
+ function normalizeTriageShadow(
829
+ value: unknown,
830
+ fallback: TriageShadowSettings
831
+ ): TriageShadowSettings {
832
+ if (!value || typeof value !== "object" || Array.isArray(value)) {
833
+ return { ...fallback };
834
+ }
835
+ const raw = value as Partial<TriageShadowSettings>;
836
+ return {
837
+ enabled: typeof raw.enabled === "boolean" ? raw.enabled : fallback.enabled,
838
+ days: normalizeIntInRange(raw.days, fallback.days, 1, 365),
839
+ startedAt:
840
+ typeof raw.startedAt === "string" && raw.startedAt.trim()
841
+ ? raw.startedAt.trim()
842
+ : null,
843
+ };
844
+ }
845
+
846
+ function normalizeDedupSettings(
847
+ value: unknown,
848
+ fallback: NotificationDedupSettings
849
+ ): NotificationDedupSettings {
850
+ if (!value || typeof value !== "object" || Array.isArray(value)) {
851
+ return { ...fallback };
852
+ }
853
+ const raw = value as Partial<NotificationDedupSettings>;
854
+ return {
855
+ enabled: typeof raw.enabled === "boolean" ? raw.enabled : fallback.enabled,
856
+ windowMinutes: normalizeIntInRange(
857
+ raw.windowMinutes,
858
+ fallback.windowMinutes,
859
+ 1,
860
+ 10_080
861
+ ),
862
+ suppressDuplicates:
863
+ typeof raw.suppressDuplicates === "boolean"
864
+ ? raw.suppressDuplicates
865
+ : fallback.suppressDuplicates,
866
+ importantStatuses:
867
+ Array.isArray(raw.importantStatuses) &&
868
+ raw.importantStatuses.every((s) => typeof s === "string")
869
+ ? raw.importantStatuses.map((s) => String(s)).slice(0, 32)
870
+ : fallback.importantStatuses,
871
+ maxCount: normalizeIntInRange(raw.maxCount, fallback.maxCount, 1, 10_000),
872
+ };
873
+ }
874
+
875
+ /** Нормализация настроек семантического дедупа (Спринт 31.1). */
876
+ function normalizeEmbeddingSettings(
877
+ value: unknown,
878
+ fallback: NotificationEmbeddingSettings
879
+ ): NotificationEmbeddingSettings {
880
+ if (!value || typeof value !== "object" || Array.isArray(value)) {
881
+ return { ...fallback };
882
+ }
883
+ const raw = value as Partial<NotificationEmbeddingSettings>;
884
+ return {
885
+ enabled: typeof raw.enabled === "boolean" ? raw.enabled : fallback.enabled,
886
+ suppressDuplicates:
887
+ typeof raw.suppressDuplicates === "boolean"
888
+ ? raw.suppressDuplicates
889
+ : fallback.suppressDuplicates,
890
+ windowMinutes: normalizeIntInRange(
891
+ raw.windowMinutes,
892
+ fallback.windowMinutes,
893
+ 1,
894
+ 10_080
895
+ ),
896
+ threshold: normalizeFloatInRange(
897
+ raw.threshold,
898
+ fallback.threshold,
899
+ 0,
900
+ 1
901
+ ),
902
+ maxVectors: normalizeIntInRange(
903
+ raw.maxVectors,
904
+ fallback.maxVectors,
905
+ 100,
906
+ 100_000
907
+ ),
908
+ };
909
+ }
910
+
911
+ /** Нормализует настройки саммари уведомлений (Спринт 31.3). */
912
+ function normalizeSummarySettings(
913
+ value: unknown,
914
+ fallback: NotificationSummarySettings
915
+ ): NotificationSummarySettings {
916
+ if (!value || typeof value !== "object" || Array.isArray(value)) {
917
+ return { ...fallback };
918
+ }
919
+ const raw = value as Partial<NotificationSummarySettings>;
920
+ return {
921
+ enabled: typeof raw.enabled === "boolean" ? raw.enabled : fallback.enabled,
922
+ maxLines: normalizeIntInRange(raw.maxLines, fallback.maxLines, 1, 3),
923
+ maxCharsPerLine: normalizeIntInRange(
924
+ raw.maxCharsPerLine,
925
+ fallback.maxCharsPerLine,
926
+ 20,
927
+ 500
928
+ ),
929
+ timeoutMs: normalizeIntInRange(raw.timeoutMs, fallback.timeoutMs, 1000, 120_000),
930
+ };
931
+ }
932
+
933
+ /** Текущий shadow-период ещё активен? (ничего не меняет, только читает). */
934
+ export function isShadowActive(shadow: TriageShadowSettings | undefined): boolean {
935
+ if (!shadow || !shadow.enabled || !shadow.startedAt) return false;
936
+ const started = new Date(shadow.startedAt).getTime();
937
+ if (!Number.isFinite(started)) return false;
938
+ const now = Date.now();
939
+ const days = Number.isFinite(shadow.days) && shadow.days > 0 ? shadow.days : DEFAULT_SHADOW_DAYS;
940
+ return now - started < days * 24 * 60 * 60 * 1000;
941
+ }
942
+
943
+ /** Начать shadow-период, если ещё не Started. Возвращает нормализованные настройки shadow. */
944
+ export function startShadow(shadow: TriageShadowSettings | undefined): TriageShadowSettings {
945
+ const nowIso = new Date().toISOString();
946
+ if (!shadow) {
947
+ return { enabled: true, days: DEFAULT_SHADOW_DAYS, startedAt: nowIso };
948
+ }
949
+ if (!shadow.startedAt) {
950
+ return { ...shadow, startedAt: nowIso };
951
+ }
952
+ return { ...shadow };
953
+ }
954
+
955
+ /**
956
+ * Настройки shadow после сохранения: включённый режим без даты старта
957
+ * получает текущий момент, выключенный — сбрасывает дату.
958
+ */
959
+ export function settleShadowOnSave(
960
+ shadow: TriageShadowSettings | undefined
961
+ ): TriageShadowSettings {
962
+ if (!shadow) return startShadow(undefined);
963
+ if (!shadow.enabled) return { ...shadow, startedAt: null };
964
+ return startShadow(shadow);
965
+ }
966
+
967
+ /**
968
+ * Приводит настройки триажа к безопасному виду.
969
+ *
970
+ * Экспортируется, чтобы RPC-сравнение «до/после» валидировало пользовательский
971
+ * ввод той же схемой, что и сохранённые настройки.
972
+ */
973
+ export function normalizeTriageSettings(
974
+ value: unknown,
975
+ fallback: TriageSettings
976
+ ): TriageSettings {
977
+ const fallbackShadow =
978
+ fallback.shadow ?? defaultNotifications().triage!.shadow!;
979
+ const raw = asRecord(value);
980
+ const rules = normalizeTriageRules(raw?.rules, fallback.rules);
981
+ return {
982
+ mode: normalizeTriageMode(raw?.mode, fallback.mode),
983
+ baseUrl: normalizeHttpBase(raw?.baseUrl, fallback.baseUrl),
984
+ model:
985
+ typeof raw?.model === "string" && raw.model.trim()
986
+ ? raw.model.trim().slice(0, 200)
987
+ : fallback.model,
988
+ timeoutMs: normalizeIntInRange(
989
+ raw?.timeoutMs,
990
+ fallback.timeoutMs,
991
+ 1_000,
992
+ 120_000
993
+ ),
994
+ fallback: normalizeTriageFallback(raw?.fallback, fallback.fallback),
995
+ confidenceThreshold: normalizeConfidence(
996
+ raw?.confidenceThreshold,
997
+ fallback.confidenceThreshold
998
+ ),
999
+ ...(rules !== undefined ? { rules } : {}),
1000
+ shadow: normalizeTriageShadow(raw?.shadow, fallbackShadow),
1001
+ };
1002
+ }
1003
+
471
1004
  /** Приводит настройки уведомлений к безопасному виду. */
472
1005
  function normalizeNotifications(
473
1006
  value: unknown,
@@ -481,6 +1014,8 @@ function normalizeNotifications(
481
1014
  const fallbackTelegram = fallback.telegram ?? defaultNotifications().telegram!;
482
1015
  const fallbackNative = fallback.native ?? defaultNotifications().native!;
483
1016
  const fallbackQuiet = fallback.quietHours ?? defaultNotifications().quietHours!;
1017
+ const fallbackTriage = fallback.triage ?? defaultNotifications().triage!;
1018
+ const fallbackShadow = fallbackTriage.shadow ?? defaultNotifications().triage!.shadow!;
484
1019
 
485
1020
  const raw = asRecord(value);
486
1021
  if (!raw) {
@@ -497,6 +1032,11 @@ function normalizeNotifications(
497
1032
  telegram: { ...fallbackTelegram },
498
1033
  native: { ...fallbackNative },
499
1034
  quietHours: { ...fallbackQuiet },
1035
+ triage: {
1036
+ ...fallbackTriage,
1037
+ rules: fallbackTriage.rules?.map((rule) => ({ ...rule })),
1038
+ shadow: { ...fallbackShadow },
1039
+ },
500
1040
  dashboardUrl: fallback.dashboardUrl ?? "",
501
1041
  };
502
1042
  }
@@ -509,6 +1049,7 @@ function normalizeNotifications(
509
1049
  const rawTelegram = asRecord(raw.telegram);
510
1050
  const rawNative = asRecord(raw.native);
511
1051
  const rawQuiet = asRecord(raw.quietHours);
1052
+ const rawTriage = asRecord(raw.triage);
512
1053
 
513
1054
  const frequency: DigestFrequency =
514
1055
  rawDigest?.frequency === "weekly" || rawDigest?.frequency === "daily"
@@ -652,6 +1193,19 @@ function normalizeNotifications(
652
1193
  time: normalizeDailyTime(rawDigest?.time, fallbackDigest.time),
653
1194
  lastSentAt,
654
1195
  },
1196
+ triage: normalizeTriageSettings(rawTriage, fallbackTriage),
1197
+ dedup: normalizeDedupSettings(
1198
+ raw.dedup,
1199
+ fallback.dedup ?? defaultNotifications().dedup!
1200
+ ),
1201
+ embedding: normalizeEmbeddingSettings(
1202
+ raw.embedding,
1203
+ fallback.embedding ?? defaultNotifications().embedding!
1204
+ ),
1205
+ summary: normalizeSummarySettings(
1206
+ raw.summary,
1207
+ fallback.summary ?? defaultNotifications().summary!
1208
+ ),
655
1209
  };
656
1210
  }
657
1211
 
@@ -703,6 +1257,7 @@ export async function loadSettings(): Promise<SchedulerSettings> {
703
1257
  const fallbackHistory = defaultHistorySettings();
704
1258
  const fallbackIntegrations = defaultIntegrations();
705
1259
  const fallbackAudit = defaultAuditSettings();
1260
+ const fallbackPermissions = defaultPermissionsSettings();
706
1261
  try {
707
1262
  const raw = await fs.readFile(SETTINGS_FILE, "utf8");
708
1263
  const parsed = JSON.parse(raw) as Partial<SchedulerSettings> | null;
@@ -711,7 +1266,8 @@ export async function loadSettings(): Promise<SchedulerSettings> {
711
1266
  parsed?.maxConcurrent,
712
1267
  DEFAULT_MAX_CONCURRENT
713
1268
  ),
714
- locale: normalizeLocale(parsed?.locale, DEFAULT_LOCALE),
1269
+ locale: normalizeLocaleMode(parsed?.locale, DEFAULT_LOCALE),
1270
+ uiLocale: normalizeLocale(parsed?.uiLocale, DEFAULT_LOCALE),
715
1271
  winterMode: normalizeWinterMode(
716
1272
  parsed?.winterMode,
717
1273
  DEFAULT_WINTER_MODE
@@ -726,16 +1282,22 @@ export async function loadSettings(): Promise<SchedulerSettings> {
726
1282
  fallbackIntegrations
727
1283
  ),
728
1284
  audit: normalizeAuditSettings(parsed?.audit, fallbackAudit),
1285
+ permissions: normalizePermissionsSettings(
1286
+ parsed?.permissions,
1287
+ fallbackPermissions
1288
+ ),
729
1289
  };
730
1290
  } catch {
731
1291
  return {
732
1292
  maxConcurrent: DEFAULT_MAX_CONCURRENT,
733
1293
  locale: DEFAULT_LOCALE,
1294
+ uiLocale: DEFAULT_LOCALE,
734
1295
  winterMode: DEFAULT_WINTER_MODE,
735
1296
  notifications: fallbackNotifications,
736
1297
  history: fallbackHistory,
737
1298
  integrations: fallbackIntegrations,
738
1299
  audit: fallbackAudit,
1300
+ permissions: fallbackPermissions,
739
1301
  };
740
1302
  }
741
1303
  }
@@ -752,8 +1314,12 @@ export async function saveSettings(
752
1314
  : current.maxConcurrent,
753
1315
  locale:
754
1316
  patch.locale !== undefined
755
- ? normalizeLocale(patch.locale, current.locale)
1317
+ ? normalizeLocaleMode(patch.locale, current.locale)
756
1318
  : current.locale,
1319
+ uiLocale:
1320
+ patch.uiLocale !== undefined
1321
+ ? normalizeLocale(patch.uiLocale, current.uiLocale)
1322
+ : current.uiLocale,
757
1323
  winterMode:
758
1324
  patch.winterMode !== undefined
759
1325
  ? normalizeWinterMode(patch.winterMode, current.winterMode)
@@ -774,6 +1340,10 @@ export async function saveSettings(
774
1340
  patch.audit !== undefined
775
1341
  ? normalizeAuditSettings(patch.audit, current.audit)
776
1342
  : current.audit,
1343
+ permissions:
1344
+ patch.permissions !== undefined
1345
+ ? normalizePermissionsSettings(patch.permissions, current.permissions)
1346
+ : current.permissions,
777
1347
  };
778
1348
 
779
1349
  // Удобство: при включении хуков без явных учётных данных генерируем их,
@@ -786,6 +1356,13 @@ export async function saveSettings(
786
1356
  }
787
1357
  }
788
1358
 
1359
+ // Удобство: включённый shadow-режим без даты старта стартует при первом сохранении.
1360
+ // Иначе shadow не логировал бы решения, а триаж реально подавлял бы уведомления.
1361
+ const triage = next.notifications.triage;
1362
+ if (triage) {
1363
+ triage.shadow = settleShadowOnSave(triage.shadow);
1364
+ }
1365
+
789
1366
  await fs.mkdir(PLUGIN_DIR, { recursive: true });
790
1367
  await fs.writeFile(SETTINGS_FILE, JSON.stringify(next, null, 2), "utf8");
791
1368
  return next;