agent-steward 0.0.1 → 0.0.3

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 (345) hide show
  1. package/CHANGELOG.md +399 -0
  2. package/CROSS_PLATFORM.md +151 -0
  3. package/README.md +307 -15
  4. package/ROADMAP-STRATEGY.md +196 -0
  5. package/ROADMAP.md +184 -0
  6. package/dist/core/analytics.d.ts +132 -0
  7. package/dist/core/analytics.d.ts.map +1 -0
  8. package/dist/core/analytics.js +290 -0
  9. package/dist/core/audit.d.ts +96 -0
  10. package/dist/core/audit.d.ts.map +1 -0
  11. package/dist/core/audit.js +297 -0
  12. package/dist/core/cron-to-schtasks.d.ts +12 -0
  13. package/dist/core/cron-to-schtasks.d.ts.map +1 -0
  14. package/dist/core/cron-to-schtasks.js +175 -0
  15. package/dist/core/dry-run.d.ts +102 -0
  16. package/dist/core/dry-run.d.ts.map +1 -0
  17. package/dist/core/dry-run.js +447 -0
  18. package/dist/core/file-watcher.d.ts +31 -0
  19. package/dist/core/file-watcher.d.ts.map +1 -0
  20. package/dist/core/file-watcher.js +186 -0
  21. package/dist/core/git-trigger.d.ts +82 -0
  22. package/dist/core/git-trigger.d.ts.map +1 -0
  23. package/dist/core/git-trigger.js +312 -0
  24. package/dist/core/glob.d.ts +38 -0
  25. package/dist/core/glob.d.ts.map +1 -0
  26. package/dist/core/glob.js +233 -0
  27. package/dist/core/local-ai.d.ts +52 -0
  28. package/dist/core/local-ai.d.ts.map +1 -0
  29. package/dist/core/local-ai.js +119 -0
  30. package/dist/core/lock.d.ts +57 -0
  31. package/dist/core/lock.d.ts.map +1 -0
  32. package/dist/core/lock.js +193 -0
  33. package/dist/core/matrix.d.ts +167 -0
  34. package/dist/core/matrix.d.ts.map +1 -0
  35. package/dist/core/matrix.js +724 -0
  36. package/dist/core/native-notify.d.ts +36 -0
  37. package/dist/core/native-notify.d.ts.map +1 -0
  38. package/dist/core/native-notify.js +113 -0
  39. package/dist/core/one-shot.d.ts +90 -0
  40. package/dist/core/one-shot.d.ts.map +1 -0
  41. package/dist/core/one-shot.js +182 -0
  42. package/dist/core/otel.d.ts +4 -0
  43. package/dist/core/otel.d.ts.map +1 -0
  44. package/dist/core/otel.js +98 -0
  45. package/dist/core/permissions.d.ts +69 -0
  46. package/dist/core/permissions.d.ts.map +1 -0
  47. package/dist/core/permissions.js +143 -0
  48. package/dist/core/prometheus.d.ts +23 -0
  49. package/dist/core/prometheus.d.ts.map +1 -0
  50. package/dist/core/prometheus.js +146 -0
  51. package/dist/core/ps-wrapper.d.ts +73 -0
  52. package/dist/core/ps-wrapper.d.ts.map +1 -0
  53. package/dist/core/ps-wrapper.js +1091 -0
  54. package/dist/core/record-history.d.ts +25 -0
  55. package/dist/core/record-history.d.ts.map +1 -0
  56. package/dist/core/record-history.js +471 -0
  57. package/dist/core/retention.d.ts +29 -0
  58. package/dist/core/retention.d.ts.map +1 -0
  59. package/dist/core/retention.js +98 -0
  60. package/dist/core/savings.d.ts +70 -0
  61. package/dist/core/savings.d.ts.map +1 -0
  62. package/dist/core/savings.js +87 -0
  63. package/dist/core/schedule-gate.d.ts +2 -0
  64. package/dist/core/schedule-gate.d.ts.map +1 -0
  65. package/dist/core/schedule-gate.js +211 -0
  66. package/dist/core/schedule-v2.d.ts +116 -0
  67. package/dist/core/schedule-v2.d.ts.map +1 -0
  68. package/dist/core/schedule-v2.js +586 -0
  69. package/dist/core/scheduler/at-fallback.d.ts +42 -0
  70. package/dist/core/scheduler/at-fallback.d.ts.map +1 -0
  71. package/dist/core/scheduler/at-fallback.js +70 -0
  72. package/dist/core/scheduler/index.d.ts +32 -0
  73. package/dist/core/scheduler/index.d.ts.map +1 -0
  74. package/dist/core/scheduler/index.js +63 -0
  75. package/dist/core/scheduler/linux.d.ts +46 -0
  76. package/dist/core/scheduler/linux.d.ts.map +1 -0
  77. package/dist/core/scheduler/linux.js +261 -0
  78. package/dist/core/scheduler/logs.d.ts +11 -0
  79. package/dist/core/scheduler/logs.d.ts.map +1 -0
  80. package/dist/core/scheduler/logs.js +34 -0
  81. package/dist/core/scheduler/mac.d.ts +46 -0
  82. package/dist/core/scheduler/mac.d.ts.map +1 -0
  83. package/dist/core/scheduler/mac.js +256 -0
  84. package/dist/core/scheduler/posix.d.ts +40 -0
  85. package/dist/core/scheduler/posix.d.ts.map +1 -0
  86. package/dist/core/scheduler/posix.js +100 -0
  87. package/dist/core/scheduler/registry.d.ts +43 -0
  88. package/dist/core/scheduler/registry.d.ts.map +1 -0
  89. package/dist/core/scheduler/registry.js +57 -0
  90. package/dist/core/scheduler/types.d.ts +86 -0
  91. package/dist/core/scheduler/types.d.ts.map +1 -0
  92. package/dist/core/scheduler/types.js +1 -0
  93. package/dist/core/scheduler/windows.d.ts +112 -0
  94. package/dist/core/scheduler/windows.d.ts.map +1 -0
  95. package/dist/core/scheduler/windows.js +749 -0
  96. package/dist/core/secrets.d.ts +66 -0
  97. package/dist/core/secrets.d.ts.map +1 -0
  98. package/dist/core/secrets.js +433 -0
  99. package/dist/core/self-analysis.d.ts +117 -0
  100. package/dist/core/self-analysis.d.ts.map +1 -0
  101. package/dist/core/self-analysis.js +539 -0
  102. package/dist/core/session.d.ts +42 -0
  103. package/dist/core/session.d.ts.map +1 -0
  104. package/dist/core/session.js +134 -0
  105. package/dist/core/shutdown.d.ts +26 -0
  106. package/dist/core/shutdown.d.ts.map +1 -0
  107. package/dist/core/shutdown.js +49 -0
  108. package/dist/core/structured-log.d.ts +84 -0
  109. package/dist/core/structured-log.d.ts.map +1 -0
  110. package/dist/core/structured-log.js +146 -0
  111. package/dist/core/summary.d.ts +69 -0
  112. package/dist/core/summary.d.ts.map +1 -0
  113. package/dist/core/summary.js +250 -0
  114. package/dist/core/telegram.d.ts +55 -0
  115. package/dist/core/telegram.d.ts.map +1 -0
  116. package/dist/core/telegram.js +344 -0
  117. package/dist/core/triage-chain.d.ts +40 -0
  118. package/dist/core/triage-chain.d.ts.map +1 -0
  119. package/dist/core/triage-chain.js +80 -0
  120. package/dist/core/triage-compare.d.ts +68 -0
  121. package/dist/core/triage-compare.d.ts.map +1 -0
  122. package/dist/core/triage-compare.js +184 -0
  123. package/dist/core/triage-rules.d.ts +23 -0
  124. package/dist/core/triage-rules.d.ts.map +1 -0
  125. package/dist/core/triage-rules.js +196 -0
  126. package/dist/core/triage-shadow.d.ts +91 -0
  127. package/dist/core/triage-shadow.d.ts.map +1 -0
  128. package/dist/core/triage-shadow.js +160 -0
  129. package/dist/core/triage-worker.d.ts +55 -0
  130. package/dist/core/triage-worker.d.ts.map +1 -0
  131. package/dist/core/triage-worker.js +314 -0
  132. package/dist/core/triage.d.ts +76 -0
  133. package/dist/core/triage.d.ts.map +1 -0
  134. package/dist/core/triage.js +271 -0
  135. package/dist/core/watch-paths.d.ts +6 -0
  136. package/dist/core/watch-paths.d.ts.map +1 -0
  137. package/dist/core/watch-paths.js +62 -0
  138. package/dist/core/wrappers/bash.d.ts +95 -0
  139. package/dist/core/wrappers/bash.d.ts.map +1 -0
  140. package/dist/core/wrappers/bash.js +413 -0
  141. package/dist/db/git-state-repo.d.ts +16 -0
  142. package/dist/db/git-state-repo.d.ts.map +1 -0
  143. package/dist/db/git-state-repo.js +38 -0
  144. package/dist/db/history-repo.d.ts +110 -0
  145. package/dist/db/history-repo.d.ts.map +1 -0
  146. package/dist/db/history-repo.js +300 -0
  147. package/dist/db/index.d.ts +49 -0
  148. package/dist/db/index.d.ts.map +1 -0
  149. package/dist/db/index.js +128 -0
  150. package/dist/db/metrics-repo.d.ts +46 -0
  151. package/dist/db/metrics-repo.d.ts.map +1 -0
  152. package/dist/db/metrics-repo.js +103 -0
  153. package/dist/db/migrate.d.ts +24 -0
  154. package/dist/db/migrate.d.ts.map +1 -0
  155. package/dist/db/migrate.js +244 -0
  156. package/dist/db/recovery.d.ts +11 -0
  157. package/dist/db/recovery.d.ts.map +1 -0
  158. package/dist/db/recovery.js +38 -0
  159. package/dist/db/run-journal.d.ts +60 -0
  160. package/dist/db/run-journal.d.ts.map +1 -0
  161. package/dist/db/run-journal.js +143 -0
  162. package/dist/db/run-resume.d.ts +48 -0
  163. package/dist/db/run-resume.d.ts.map +1 -0
  164. package/dist/db/run-resume.js +137 -0
  165. package/dist/db/runs-repo.d.ts +120 -0
  166. package/dist/db/runs-repo.d.ts.map +1 -0
  167. package/dist/db/runs-repo.js +319 -0
  168. package/dist/db/schema.d.ts +38 -0
  169. package/dist/db/schema.d.ts.map +1 -0
  170. package/dist/db/schema.js +325 -0
  171. package/dist/db/settings-repo.d.ts +8 -0
  172. package/dist/db/settings-repo.d.ts.map +1 -0
  173. package/dist/db/settings-repo.js +27 -0
  174. package/dist/db/tasks-repo.d.ts +26 -0
  175. package/dist/db/tasks-repo.d.ts.map +1 -0
  176. package/dist/db/tasks-repo.js +120 -0
  177. package/dist/db/templates-repo.d.ts +17 -0
  178. package/dist/db/templates-repo.d.ts.map +1 -0
  179. package/dist/db/templates-repo.js +57 -0
  180. package/dist/history.d.ts +60 -0
  181. package/dist/history.d.ts.map +1 -0
  182. package/dist/history.js +70 -0
  183. package/dist/i18n.d.ts +75 -0
  184. package/dist/i18n.d.ts.map +1 -0
  185. package/dist/i18n.js +357 -0
  186. package/dist/index.d.ts +858 -0
  187. package/dist/index.d.ts.map +1 -0
  188. package/dist/index.js +5209 -0
  189. package/dist/integrations.d.ts +72 -0
  190. package/dist/integrations.d.ts.map +1 -0
  191. package/dist/integrations.js +233 -0
  192. package/dist/notifications.d.ts +199 -0
  193. package/dist/notifications.d.ts.map +1 -0
  194. package/dist/notifications.js +967 -0
  195. package/dist/profiles.d.ts +64 -0
  196. package/dist/profiles.d.ts.map +1 -0
  197. package/dist/profiles.js +305 -0
  198. package/dist/rpc.d.ts +3915 -0
  199. package/dist/rpc.d.ts.map +1 -0
  200. package/dist/rpc.js +1596 -0
  201. package/dist/schtasks.d.ts +32 -0
  202. package/dist/schtasks.d.ts.map +1 -0
  203. package/dist/schtasks.js +45 -0
  204. package/dist/server.d.ts +128 -0
  205. package/dist/server.d.ts.map +1 -0
  206. package/dist/server.js +2414 -0
  207. package/dist/settings.d.ts +389 -0
  208. package/dist/settings.d.ts.map +1 -0
  209. package/dist/settings.js +770 -0
  210. package/dist/shared/jobs-view.d.ts +59 -0
  211. package/dist/shared/jobs-view.d.ts.map +1 -0
  212. package/dist/shared/jobs-view.js +146 -0
  213. package/dist/skill.d.ts +15 -0
  214. package/dist/skill.d.ts.map +1 -0
  215. package/dist/skill.js +93 -0
  216. package/dist/task-transfer.d.ts +252 -0
  217. package/dist/task-transfer.d.ts.map +1 -0
  218. package/dist/task-transfer.js +632 -0
  219. package/dist/templates.d.ts +57 -0
  220. package/dist/templates.d.ts.map +1 -0
  221. package/dist/templates.js +16 -0
  222. package/dist/types.d.ts +112 -0
  223. package/dist/types.d.ts.map +1 -0
  224. package/dist/types.js +158 -0
  225. package/dist/version.d.ts +8 -0
  226. package/dist/version.d.ts.map +1 -0
  227. package/dist/version.js +27 -0
  228. package/dist/workspaces.d.ts +113 -0
  229. package/dist/workspaces.d.ts.map +1 -0
  230. package/dist/workspaces.js +393 -0
  231. package/docs/ARCHITECTURE.md +559 -0
  232. package/docs/COMPATIBILITY.md +237 -0
  233. package/docs/CONCEPT.md +242 -0
  234. package/docs/CROSS_PLATFORM.ru.md +152 -0
  235. package/docs/CROSS_PLATFORM.zh.md +148 -0
  236. package/docs/FAQ.md +52 -0
  237. package/docs/FAQ.ru.md +53 -0
  238. package/docs/FAQ.zh.md +43 -0
  239. package/docs/FEATURES.md +699 -0
  240. package/docs/FEATURES.zh.md +656 -0
  241. package/docs/LOCAL-AI.md +300 -0
  242. package/docs/MIGRATION.md +363 -0
  243. package/docs/README.ru.md +287 -0
  244. package/docs/README.zh.md +306 -0
  245. package/docs/SAVINGS.md +61 -0
  246. package/docs/SAVINGS.ru.md +60 -0
  247. package/docs/SAVINGS.zh.md +52 -0
  248. package/docs/V1-V2-COMPATIBILITY-PLAN.md +366 -0
  249. package/docs/ZH-LOCALE-PLAN.md +324 -0
  250. package/docs/dashboard.png +0 -0
  251. package/docs/spikes/local-model-structured-output.md +81 -0
  252. package/docs/spikes/ollama-qwen3-4b-smoke.json +28 -0
  253. package/docs/spikes/ollama-qwen3-4b.json +163 -0
  254. package/gui-experimental.cjs +9 -0
  255. package/index.js +2 -0
  256. package/locales/en.json +781 -0
  257. package/locales/ru.json +781 -0
  258. package/locales/zh.json +781 -0
  259. package/package.json +154 -13
  260. package/scripts/bench-local.mjs +321 -0
  261. package/scripts/check-zh-locale.mjs +218 -0
  262. package/scripts/demo-dashboard.mjs +209 -0
  263. package/scripts/run-tests.mjs +236 -0
  264. package/scripts/spike-local-structured.mjs +182 -0
  265. package/scripts/test-locale.mjs +45 -0
  266. package/skills/scheduled-job-best-practices/SKILL.md +158 -0
  267. package/skills/scheduled-job-best-practices/references/recipes.md +163 -0
  268. package/src/core/analytics.ts +424 -0
  269. package/src/core/audit.ts +418 -0
  270. package/src/core/cron-to-schtasks.ts +209 -0
  271. package/src/core/dry-run.ts +601 -0
  272. package/src/core/file-watcher.ts +245 -0
  273. package/src/core/git-trigger.ts +391 -0
  274. package/src/core/glob.ts +226 -0
  275. package/src/core/local-ai.ts +173 -0
  276. package/src/core/lock.ts +219 -0
  277. package/src/core/matrix.ts +947 -0
  278. package/src/core/native-notify.ts +157 -0
  279. package/src/core/one-shot.ts +239 -0
  280. package/src/core/otel.ts +128 -0
  281. package/src/core/permissions.ts +200 -0
  282. package/src/core/prometheus.ts +215 -0
  283. package/src/core/ps-wrapper.ts +1160 -0
  284. package/src/core/record-history.ts +615 -0
  285. package/src/core/retention.ts +141 -0
  286. package/src/core/savings.ts +150 -0
  287. package/src/core/schedule-gate.ts +253 -0
  288. package/src/core/schedule-v2.ts +668 -0
  289. package/src/core/scheduler/at-fallback.ts +113 -0
  290. package/src/core/scheduler/index.ts +82 -0
  291. package/src/core/scheduler/linux.ts +308 -0
  292. package/src/core/scheduler/logs.ts +37 -0
  293. package/src/core/scheduler/mac.ts +322 -0
  294. package/src/core/scheduler/posix.ts +128 -0
  295. package/src/core/scheduler/registry.ts +101 -0
  296. package/src/core/scheduler/types.ts +90 -0
  297. package/src/core/scheduler/windows.ts +881 -0
  298. package/src/core/secrets.ts +503 -0
  299. package/src/core/self-analysis.ts +744 -0
  300. package/src/core/session.ts +150 -0
  301. package/src/core/shutdown.ts +69 -0
  302. package/src/core/structured-log.ts +214 -0
  303. package/src/core/summary.ts +318 -0
  304. package/src/core/telegram.ts +436 -0
  305. package/src/core/triage-chain.ts +125 -0
  306. package/src/core/triage-compare.ts +277 -0
  307. package/src/core/triage-rules.ts +238 -0
  308. package/src/core/triage-shadow.ts +240 -0
  309. package/src/core/triage-worker.ts +344 -0
  310. package/src/core/triage.ts +366 -0
  311. package/src/core/watch-paths.ts +70 -0
  312. package/src/core/wrappers/bash.ts +532 -0
  313. package/src/db/git-state-repo.ts +62 -0
  314. package/src/db/history-repo.ts +492 -0
  315. package/src/db/index.ts +176 -0
  316. package/src/db/metrics-repo.ts +170 -0
  317. package/src/db/migrate.ts +328 -0
  318. package/src/db/recovery.ts +46 -0
  319. package/src/db/run-journal.ts +212 -0
  320. package/src/db/run-resume.ts +220 -0
  321. package/src/db/runs-repo.ts +481 -0
  322. package/src/db/schema.ts +349 -0
  323. package/src/db/settings-repo.ts +31 -0
  324. package/src/db/tasks-repo.ts +162 -0
  325. package/src/db/templates-repo.ts +77 -0
  326. package/src/gui.tsx +5222 -0
  327. package/src/history.ts +128 -0
  328. package/src/i18n.ts +413 -0
  329. package/src/index.ts +6642 -0
  330. package/src/integrations.ts +297 -0
  331. package/src/notifications.ts +1346 -0
  332. package/src/profiles.ts +345 -0
  333. package/src/rpc.ts +1704 -0
  334. package/src/schtasks.ts +75 -0
  335. package/src/server.ts +2663 -0
  336. package/src/settings.ts +1369 -0
  337. package/src/shared/jobs-view.ts +188 -0
  338. package/src/skill.ts +113 -0
  339. package/src/task-transfer.ts +946 -0
  340. package/src/templates.ts +67 -0
  341. package/src/tui-v1.tsx +341 -0
  342. package/src/tui.tsx +329 -0
  343. package/src/types.ts +226 -0
  344. package/src/version.ts +27 -0
  345. package/src/workspaces.ts +487 -0
@@ -0,0 +1,1369 @@
1
+ import crypto from "node:crypto";
2
+ import fs from "node:fs/promises";
3
+ import path from "node:path";
4
+ import { PLUGIN_DIR } from "./types.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";
11
+
12
+ /** Настройки webhook-уведомлений (Discord/Slack/generic). */
13
+ export interface WebhookNotificationSettings {
14
+ /** Включён ли канал. */
15
+ enabled: boolean;
16
+ /** URL вебхука. */
17
+ url: string;
18
+ /** Таймаут запроса в мс (1000..120000). */
19
+ timeoutMs: number;
20
+ /** Сколько раз повторить при сетевой ошибке / 5xx / 429 (0..5). */
21
+ retryCount: number;
22
+ /** Базовая задержка backoff в мс; каждая следующая попытка ждёт вдвое дольше. */
23
+ retryDelayMs: number;
24
+ }
25
+
26
+ /** Настраиваемые шаблоны сообщений о завершении задачи. */
27
+ export interface NotificationTemplates {
28
+ /** Шаблон успеха. Плейсхолдеры: {task} {status} {duration} {error} {emoji}. */
29
+ success: string;
30
+ /** Шаблон ошибки. {error} разворачивается в «: текст» или пустую строку. */
31
+ error: string;
32
+ }
33
+
34
+ /** Фильтры по задачам: include имеет приоритет, exclude сильнее include. */
35
+ export interface NotificationFilters {
36
+ /** Уведомлять только эти задачи (пусто — все). Поддерживает `*`. */
37
+ include: string[];
38
+ /** Никогда не уведомлять эти задачи. Поддерживает `*`. */
39
+ exclude: string[];
40
+ }
41
+
42
+ /** Уведомления о матрицах (Спринт 20). */
43
+ export interface MatrixNotificationSettings {
44
+ /** Включены ли уведомления о матрицах. */
45
+ enabled: boolean;
46
+ /** Сообщать о partial (часть клонов упала). */
47
+ onPartial: boolean;
48
+ /** Сообщать, когда упали все клоны. */
49
+ onAllFailed: boolean;
50
+ /** Порог «матрица зависла» в минутах (0 — детектор выключен). */
51
+ stuckAfterMinutes: number;
52
+ }
53
+
54
+ /** Периодичность дайджеста. */
55
+ export type DigestFrequency = "daily" | "weekly";
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
+
153
+ /** Дайджест по истории запусков (Спринт 20). */
154
+ export interface DigestSettings {
155
+ /** Включён ли дайджест. */
156
+ enabled: boolean;
157
+ /** Ежедневно или еженедельно (по понедельникам). */
158
+ frequency: DigestFrequency;
159
+ /** Время отправки в формате HH:MM (локальное время сервера). */
160
+ time: string;
161
+ /** ISO-момент последней отправки — дедуп между перезапусками плагина. */
162
+ lastSentAt: string | null;
163
+ }
164
+
165
+ /** parse_mode для Telegram Bot API. Пустая строка — plain text. */
166
+ export type TelegramParseMode = "" | "HTML" | "Markdown" | "MarkdownV2";
167
+
168
+ /** Telegram-канал уведомлений (Спринт 25). */
169
+ export interface TelegramNotificationSettings {
170
+ /** Включён ли Telegram-канал. */
171
+ enabled: boolean;
172
+ /** Токен бота из @BotFather. Хранится только локально. */
173
+ botToken: string;
174
+ /** ID чата или канала-получателя. */
175
+ chatId: string;
176
+ /** Разметка сообщения; пусто — plain text. */
177
+ parseMode: TelegramParseMode;
178
+ /** Отправлять без звука. */
179
+ disableNotification: boolean;
180
+ /** ID темы в супергруппе (forum topic), null — обычное сообщение. */
181
+ messageThreadId: number | null;
182
+ /** Добавлять ссылку на локальный дашборд. */
183
+ includeDashboardLink: boolean;
184
+ /** База API; по умолчанию https://api.telegram.org. */
185
+ apiBase: string;
186
+ }
187
+
188
+ /** Нативные уведомления ОС (Спринт 25). */
189
+ export interface NativeNotificationSettings {
190
+ /** Windows Toast, macOS Notification Center, Linux notify-send. */
191
+ enabled: boolean;
192
+ /** Со звуком (где поддерживается). */
193
+ sound: boolean;
194
+ }
195
+
196
+ /** Тихие часы (Спринт 25): success/partial подавляются, ошибки проходят. */
197
+ export interface QuietHoursSettings {
198
+ /** Включён ли режим тихих часов. */
199
+ enabled: boolean;
200
+ /** Начало в HH:MM (локальное время). */
201
+ from: string;
202
+ /** Конец в HH:MM; диапазон может переходить через полночь. */
203
+ to: string;
204
+ }
205
+
206
+ /**
207
+ * Уведомления о завершении задач.
208
+ *
209
+ * Каналы: webhook (Discord/Slack/generic), Telegram Bot API и нативные
210
+ * уведомления ОС. Все каналы опциональны и не зависят друг от друга.
211
+ */
212
+ export interface NotificationSettings {
213
+ /** Главный выключатель уведомлений. */
214
+ enabled: boolean;
215
+ /** true — отправлять только при ошибке (экономит лимиты и не спамит). */
216
+ onlyOnError: boolean;
217
+ /** Webhook-канал. */
218
+ webhook?: WebhookNotificationSettings;
219
+ /** Telegram-канал. */
220
+ telegram?: TelegramNotificationSettings;
221
+ /** Нативные уведомления ОС. */
222
+ native?: NativeNotificationSettings;
223
+ /** Тихие часы. */
224
+ quietHours?: QuietHoursSettings;
225
+ /** Переопределение ссылки на дашборд; пусто — порт берётся у сервера. */
226
+ dashboardUrl?: string;
227
+ /** Шаблоны сообщений. */
228
+ templates?: NotificationTemplates;
229
+ /** Фильтры по задачам. */
230
+ filters?: NotificationFilters;
231
+ /** Уведомления о матрицах. */
232
+ matrix?: MatrixNotificationSettings;
233
+ /** Периодический дайджест. */
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;
293
+ }
294
+
295
+ /**
296
+ * Ретеншн истории (Спринт 18).
297
+ *
298
+ * Дашборд и метрики живут на агрегатах, поэтому удаление старых записей
299
+ * не искажает «Всего запусков» и стоимость: чистится только сырая история.
300
+ * 0 — соответствующее ограничение выключено.
301
+ */
302
+ export interface HistorySettings {
303
+ /** Удалять завершённые записи старше N дней (0 — не удалять по возрасту). */
304
+ retentionDays: number;
305
+ /** Хранить не более N последних записей (0 — без ограничения). */
306
+ maxRecords: number;
307
+ /** Когда последний раз запускалась автоочистка (ISO). */
308
+ lastCleanupAt: string | null;
309
+ /** Сколько записей удалила последняя очистка (для дашборда). */
310
+ lastCleanupDeleted: number;
311
+ }
312
+
313
+ /**
314
+ * Входящие webhook-триггеры (Спринт 22).
315
+ *
316
+ * Запрос: `POST /api/hooks/<task>?token=<token>` с заголовком
317
+ * `X-Scheduler-Signature: sha256=<hmac>` (совместим с `X-Hub-Signature-256`).
318
+ * Токен подтверждает, кто вызывает хук, HMAC — целостность тела запроса.
319
+ */
320
+ export interface HookSettings {
321
+ /** Включены ли входящие webhook-триггеры. */
322
+ enabled: boolean;
323
+ /** Общий токен в query-параметре `token` (сравнивается timing-safe). */
324
+ token: string;
325
+ /** Секрет для HMAC-SHA256 по сырому телу запроса. */
326
+ secret: string;
327
+ /** Требовать HMAC-подпись. Выключение допустимо только для локальных тестов. */
328
+ requireSignature: boolean;
329
+ /** Максимальный размер тела запроса в байтах (1 KiB..5 MiB). */
330
+ maxBodyBytes: number;
331
+ /** Допустимое расхождение `X-Scheduler-Timestamp` с текущим временем, секунды. 0 — не проверять. */
332
+ timestampToleranceSeconds: number;
333
+ }
334
+
335
+ /** Настройки внешних интеграций (Спринт 22). */
336
+ export interface IntegrationSettings {
337
+ /** Входящие webhook-триггеры из CI/CD. */
338
+ hooks: HookSettings;
339
+ }
340
+
341
+ /** Настройки журнала аудита (Спринт 26). */
342
+ export interface AuditSettings {
343
+ /** Вести журнал мутаций. */
344
+ enabled: boolean;
345
+ /** Сколько дней хранить записи; 0 — без ограничения по времени. */
346
+ retentionDays: number;
347
+ /** Максимум записей; старые удаляются первыми. */
348
+ maxRecords: number;
349
+ }
350
+
351
+ /** Политика прав фоновых задач (Спринт 32, релиз 1.6). */
352
+ export interface PermissionSettings {
353
+ /** hybrid — без shell/question; secure — только чтение; legacy — как в 1.5.x. */
354
+ defaultPolicy: PermissionPolicy;
355
+ }
356
+
357
+ /**
358
+ * Глобальные настройки плагина, которые меняются из GUI.
359
+ * Хранятся в settings.json рядом с tasks.json / history.json.
360
+ */
361
+ export interface SchedulerSettings {
362
+ /** Максимум одновременно выполняющихся задач. 0 — без ограничения. */
363
+ maxConcurrent: number;
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;
375
+ /** Зимняя тема оформления GUI (снежинки, морозные рамки, градиент). */
376
+ winterMode: boolean;
377
+ /** Уведомления о завершении задач. */
378
+ notifications: NotificationSettings;
379
+ /** Ретеншн истории запусков. */
380
+ history: HistorySettings;
381
+ /** Внешние интеграции: входящие webhook-триггеры. */
382
+ integrations: IntegrationSettings;
383
+ /** Журнал аудита мутаций (Спринт 26). */
384
+ audit: AuditSettings;
385
+ /** Политика прав фоновых задач (Спринт 32). */
386
+ permissions: PermissionSettings;
387
+ }
388
+
389
+ export const SETTINGS_FILE = path.join(PLUGIN_DIR, "settings.json");
390
+ export const DEFAULT_MAX_CONCURRENT = 1;
391
+ export const DEFAULT_WINTER_MODE = false;
392
+ export const DEFAULT_RETENTION_DAYS = 30;
393
+ export const DEFAULT_MAX_RECORDS = 5000;
394
+
395
+ /** Уведомления (Спринт 20): таймаут webhook, повторы и порог «зависшей» матрицы. */
396
+ export const DEFAULT_WEBHOOK_TIMEOUT_MS = 10_000;
397
+ export const DEFAULT_WEBHOOK_RETRY_COUNT = 2;
398
+ export const DEFAULT_WEBHOOK_RETRY_DELAY_MS = 1_000;
399
+ export const DEFAULT_STUCK_AFTER_MINUTES = 60;
400
+
401
+ /** Входящие хуки (Спринт 22): тело до 256 KiB, timestamp ±5 минут. */
402
+ export const DEFAULT_HOOK_MAX_BODY_BYTES = 256 * 1024;
403
+ export const DEFAULT_HOOK_TIMESTAMP_TOLERANCE_SECONDS = 300;
404
+ const MAX_HOOK_BODY_BYTES = 5 * 1024 * 1024;
405
+ const MAX_HOOK_CREDENTIAL_LENGTH = 512;
406
+
407
+ /** Аудит (Спринт 26): включён, 90 дней и не больше 10 000 записей. */
408
+ export const DEFAULT_AUDIT_RETENTION_DAYS = 90;
409
+ export const DEFAULT_AUDIT_MAX_RECORDS = 10_000;
410
+
411
+ /** Значения аудита по умолчанию. */
412
+ export function defaultAuditSettings(): AuditSettings {
413
+ return {
414
+ enabled: true,
415
+ retentionDays: DEFAULT_AUDIT_RETENTION_DAYS,
416
+ maxRecords: DEFAULT_AUDIT_MAX_RECORDS,
417
+ };
418
+ }
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
+
439
+ /** Приводит настройки аудита к безопасному виду. */
440
+ function normalizeAuditSettings(
441
+ value: unknown,
442
+ fallback: AuditSettings,
443
+ ): AuditSettings {
444
+ if (!value || typeof value !== "object" || Array.isArray(value)) {
445
+ return { ...fallback };
446
+ }
447
+ const raw = value as Partial<AuditSettings>;
448
+ return {
449
+ enabled: typeof raw.enabled === "boolean" ? raw.enabled : fallback.enabled,
450
+ retentionDays: normalizeRetentionLimit(
451
+ raw.retentionDays,
452
+ fallback.retentionDays,
453
+ ),
454
+ maxRecords: normalizeRetentionLimit(raw.maxRecords, fallback.maxRecords),
455
+ };
456
+ }
457
+
458
+ /** Значения интеграций по умолчанию: хуки выключены, подпись обязательна. */
459
+ export function defaultIntegrations(): IntegrationSettings {
460
+ return {
461
+ hooks: {
462
+ enabled: false,
463
+ token: "",
464
+ secret: "",
465
+ requireSignature: true,
466
+ maxBodyBytes: DEFAULT_HOOK_MAX_BODY_BYTES,
467
+ timestampToleranceSeconds: DEFAULT_HOOK_TIMESTAMP_TOLERANCE_SECONDS,
468
+ },
469
+ };
470
+ }
471
+
472
+ /** Генерирует криптостойкие учётные данные для входящего хука. */
473
+ export function generateHookCredentials(): { token: string; secret: string } {
474
+ return {
475
+ token: crypto.randomBytes(24).toString("hex"),
476
+ secret: crypto.randomBytes(32).toString("hex"),
477
+ };
478
+ }
479
+
480
+ /** Ретеншн по умолчанию: 30 дней и не больше 5000 записей. */
481
+ export function defaultHistorySettings(): HistorySettings {
482
+ return {
483
+ retentionDays: DEFAULT_RETENTION_DAYS,
484
+ maxRecords: DEFAULT_MAX_RECORDS,
485
+ lastCleanupAt: null,
486
+ lastCleanupDeleted: 0,
487
+ };
488
+ }
489
+
490
+ /** Приводит счётчик ретеншна к безопасному целому (>= 0). */
491
+ function normalizeRetentionLimit(value: unknown, fallback: number): number {
492
+ const n = Number(value);
493
+ if (!Number.isFinite(n)) return fallback;
494
+ const int = Math.floor(n);
495
+ return int >= 0 ? int : fallback;
496
+ }
497
+
498
+ /** Приводит настройки ретеншна к безопасному виду. */
499
+ function normalizeHistorySettings(
500
+ value: unknown,
501
+ fallback: HistorySettings,
502
+ ): HistorySettings {
503
+ if (!value || typeof value !== "object" || Array.isArray(value)) {
504
+ return { ...fallback };
505
+ }
506
+ const raw = value as Partial<HistorySettings>;
507
+ const lastCleanupAt =
508
+ typeof raw.lastCleanupAt === "string" && raw.lastCleanupAt.trim()
509
+ ? raw.lastCleanupAt.trim()
510
+ : null;
511
+ return {
512
+ retentionDays: normalizeRetentionLimit(raw.retentionDays, fallback.retentionDays),
513
+ maxRecords: normalizeRetentionLimit(raw.maxRecords, fallback.maxRecords),
514
+ lastCleanupAt,
515
+ lastCleanupDeleted: normalizeRetentionLimit(
516
+ raw.lastCleanupDeleted,
517
+ fallback.lastCleanupDeleted,
518
+ ),
519
+ };
520
+ }
521
+
522
+ /** Значения уведомлений по умолчанию: всё выключено, только ошибки. */
523
+ export function defaultNotifications(): NotificationSettings {
524
+ return {
525
+ enabled: false,
526
+ onlyOnError: true,
527
+ webhook: {
528
+ enabled: false,
529
+ url: "",
530
+ timeoutMs: DEFAULT_WEBHOOK_TIMEOUT_MS,
531
+ retryCount: DEFAULT_WEBHOOK_RETRY_COUNT,
532
+ retryDelayMs: DEFAULT_WEBHOOK_RETRY_DELAY_MS,
533
+ },
534
+ templates: {
535
+ success: t("notify.task.success"),
536
+ error: t("notify.task.error"),
537
+ },
538
+ filters: { include: [], exclude: [] },
539
+ telegram: {
540
+ enabled: false,
541
+ botToken: "",
542
+ chatId: "",
543
+ parseMode: "HTML",
544
+ disableNotification: false,
545
+ messageThreadId: null,
546
+ includeDashboardLink: true,
547
+ apiBase: "https://api.telegram.org",
548
+ },
549
+ native: {
550
+ enabled: false,
551
+ sound: true,
552
+ },
553
+ quietHours: {
554
+ enabled: false,
555
+ from: "22:00",
556
+ to: "08:00",
557
+ },
558
+ dashboardUrl: "",
559
+ matrix: {
560
+ enabled: true,
561
+ onPartial: true,
562
+ onAllFailed: true,
563
+ stuckAfterMinutes: DEFAULT_STUCK_AFTER_MINUTES,
564
+ },
565
+ digest: {
566
+ enabled: false,
567
+ frequency: "daily",
568
+ time: "09:00",
569
+ lastSentAt: null,
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
+ },
604
+ };
605
+ }
606
+
607
+ /** Приводит значение лимита к безопасному целому (>= 0). */
608
+ function normalizeMaxConcurrent(value: unknown, fallback: number): number {
609
+ const n = Number(value);
610
+ if (!Number.isFinite(n)) return fallback;
611
+ const int = Math.floor(n);
612
+ return int >= 0 ? int : fallback;
613
+ }
614
+
615
+ /** Приводит значение зимнего режима к boolean. */
616
+ function normalizeWinterMode(value: unknown, fallback: boolean): boolean {
617
+ if (typeof value === "boolean") return value;
618
+ if (value === "true") return true;
619
+ if (value === "false") return false;
620
+ return fallback;
621
+ }
622
+
623
+ /** Приводит значение к конечному целому в диапазоне [min, max]. */
624
+ function normalizeIntInRange(
625
+ value: unknown,
626
+ fallback: number,
627
+ min: number,
628
+ max: number,
629
+ ): number {
630
+ const n = Number(value);
631
+ if (!Number.isFinite(n)) return fallback;
632
+ return Math.min(max, Math.max(min, Math.floor(n)));
633
+ }
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
+
647
+ /** Приводит время HH:MM к безопасному виду. */
648
+ function normalizeDailyTime(value: unknown, fallback: string): string {
649
+ if (typeof value === "string" && /^([01]\d|2[0-3]):[0-5]\d$/.test(value.trim())) {
650
+ return value.trim();
651
+ }
652
+ return fallback;
653
+ }
654
+
655
+ /** Список имён задач: массив строк, обрезанных и без пустых значений. */
656
+ function normalizeNameList(value: unknown, fallback: string[]): string[] {
657
+ if (!Array.isArray(value)) return [...fallback];
658
+ return value
659
+ .filter((item): item is string => typeof item === "string")
660
+ .map((item) => item.trim())
661
+ .filter((item) => item.length > 0);
662
+ }
663
+
664
+ function asRecord(value: unknown): Record<string, unknown> | undefined {
665
+ return value && typeof value === "object" && !Array.isArray(value)
666
+ ? (value as Record<string, unknown>)
667
+ : undefined;
668
+ }
669
+
670
+ /** Приводит parse_mode Telegram к допустимому значению. */
671
+ function normalizeTelegramParseMode(
672
+ value: unknown,
673
+ fallback: TelegramParseMode,
674
+ ): TelegramParseMode {
675
+ return value === "" || value === "HTML" || value === "Markdown" || value === "MarkdownV2"
676
+ ? value
677
+ : fallback;
678
+ }
679
+
680
+ /** Проверяет http(s)-базу API; иначе возвращает fallback. */
681
+ function normalizeHttpBase(value: unknown, fallback: string): string {
682
+ if (typeof value !== "string") return fallback;
683
+ const trimmed = value.trim().replace(/\/+$/, "");
684
+ if (!trimmed) return fallback;
685
+ try {
686
+ const parsed = new URL(trimmed);
687
+ if (parsed.protocol !== "http:" && parsed.protocol !== "https:") return fallback;
688
+ return trimmed;
689
+ } catch {
690
+ return fallback;
691
+ }
692
+ }
693
+
694
+ /**
695
+ * Встроенный шаблон (ru или en) заменяется текущим переводом; пользовательский
696
+ * текст остаётся как есть. Иначе сохранённые при первой установке дефолты
697
+ * навсегда застывали бы на языке установки.
698
+ */
699
+ function localizedTemplate(
700
+ value: unknown,
701
+ key: string,
702
+ fallback: string,
703
+ ): string {
704
+ const raw = typeof value === "string" && value.trim() ? value : fallback;
705
+ const builtin = SUPPORTED_LOCALES.some(
706
+ (locale) => messageIn(locale, key) === raw,
707
+ );
708
+ return builtin ? t(key) : raw;
709
+ }
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
+
1004
+ /** Приводит настройки уведомлений к безопасному виду. */
1005
+ function normalizeNotifications(
1006
+ value: unknown,
1007
+ fallback: NotificationSettings,
1008
+ ): NotificationSettings {
1009
+ const fallbackWebhook = fallback.webhook ?? defaultNotifications().webhook!;
1010
+ const fallbackTemplates = fallback.templates ?? defaultNotifications().templates!;
1011
+ const fallbackFilters = fallback.filters ?? { include: [], exclude: [] };
1012
+ const fallbackMatrix = fallback.matrix ?? defaultNotifications().matrix!;
1013
+ const fallbackDigest = fallback.digest ?? defaultNotifications().digest!;
1014
+ const fallbackTelegram = fallback.telegram ?? defaultNotifications().telegram!;
1015
+ const fallbackNative = fallback.native ?? defaultNotifications().native!;
1016
+ const fallbackQuiet = fallback.quietHours ?? defaultNotifications().quietHours!;
1017
+ const fallbackTriage = fallback.triage ?? defaultNotifications().triage!;
1018
+ const fallbackShadow = fallbackTriage.shadow ?? defaultNotifications().triage!.shadow!;
1019
+
1020
+ const raw = asRecord(value);
1021
+ if (!raw) {
1022
+ return {
1023
+ ...fallback,
1024
+ webhook: { ...fallbackWebhook },
1025
+ templates: { ...fallbackTemplates },
1026
+ filters: {
1027
+ include: [...fallbackFilters.include],
1028
+ exclude: [...fallbackFilters.exclude],
1029
+ },
1030
+ matrix: { ...fallbackMatrix },
1031
+ digest: { ...fallbackDigest },
1032
+ telegram: { ...fallbackTelegram },
1033
+ native: { ...fallbackNative },
1034
+ quietHours: { ...fallbackQuiet },
1035
+ triage: {
1036
+ ...fallbackTriage,
1037
+ rules: fallbackTriage.rules?.map((rule) => ({ ...rule })),
1038
+ shadow: { ...fallbackShadow },
1039
+ },
1040
+ dashboardUrl: fallback.dashboardUrl ?? "",
1041
+ };
1042
+ }
1043
+
1044
+ const rawWebhook = asRecord(raw.webhook);
1045
+ const rawTemplates = asRecord(raw.templates);
1046
+ const rawFilters = asRecord(raw.filters);
1047
+ const rawMatrix = asRecord(raw.matrix);
1048
+ const rawDigest = asRecord(raw.digest);
1049
+ const rawTelegram = asRecord(raw.telegram);
1050
+ const rawNative = asRecord(raw.native);
1051
+ const rawQuiet = asRecord(raw.quietHours);
1052
+ const rawTriage = asRecord(raw.triage);
1053
+
1054
+ const frequency: DigestFrequency =
1055
+ rawDigest?.frequency === "weekly" || rawDigest?.frequency === "daily"
1056
+ ? rawDigest.frequency
1057
+ : fallbackDigest.frequency;
1058
+
1059
+ const lastSentAt =
1060
+ typeof rawDigest?.lastSentAt === "string" && rawDigest.lastSentAt.trim()
1061
+ ? rawDigest.lastSentAt.trim()
1062
+ : null;
1063
+
1064
+ return {
1065
+ enabled: typeof raw.enabled === "boolean" ? raw.enabled : fallback.enabled,
1066
+ onlyOnError:
1067
+ typeof raw.onlyOnError === "boolean" ? raw.onlyOnError : fallback.onlyOnError,
1068
+ webhook: {
1069
+ enabled:
1070
+ typeof rawWebhook?.enabled === "boolean"
1071
+ ? rawWebhook.enabled
1072
+ : fallbackWebhook.enabled,
1073
+ url:
1074
+ typeof rawWebhook?.url === "string"
1075
+ ? rawWebhook.url.trim()
1076
+ : fallbackWebhook.url,
1077
+ timeoutMs: normalizeIntInRange(
1078
+ rawWebhook?.timeoutMs,
1079
+ fallbackWebhook.timeoutMs,
1080
+ 1_000,
1081
+ 120_000,
1082
+ ),
1083
+ retryCount: normalizeIntInRange(
1084
+ rawWebhook?.retryCount,
1085
+ fallbackWebhook.retryCount,
1086
+ 0,
1087
+ 5,
1088
+ ),
1089
+ retryDelayMs: normalizeIntInRange(
1090
+ rawWebhook?.retryDelayMs,
1091
+ fallbackWebhook.retryDelayMs,
1092
+ 100,
1093
+ 60_000,
1094
+ ),
1095
+ },
1096
+ templates: {
1097
+ success: localizedTemplate(
1098
+ rawTemplates?.success,
1099
+ "notify.task.success",
1100
+ fallbackTemplates.success,
1101
+ ),
1102
+ error: localizedTemplate(
1103
+ rawTemplates?.error,
1104
+ "notify.task.error",
1105
+ fallbackTemplates.error,
1106
+ ),
1107
+ },
1108
+ filters: {
1109
+ include: normalizeNameList(rawFilters?.include, fallbackFilters.include),
1110
+ exclude: normalizeNameList(rawFilters?.exclude, fallbackFilters.exclude),
1111
+ },
1112
+ telegram: {
1113
+ enabled:
1114
+ typeof rawTelegram?.enabled === "boolean"
1115
+ ? rawTelegram.enabled
1116
+ : fallbackTelegram.enabled,
1117
+ botToken:
1118
+ typeof rawTelegram?.botToken === "string"
1119
+ ? rawTelegram.botToken.trim().slice(0, 512)
1120
+ : fallbackTelegram.botToken,
1121
+ chatId:
1122
+ typeof rawTelegram?.chatId === "string"
1123
+ ? rawTelegram.chatId.trim().slice(0, 128)
1124
+ : fallbackTelegram.chatId,
1125
+ parseMode: normalizeTelegramParseMode(
1126
+ rawTelegram?.parseMode,
1127
+ fallbackTelegram.parseMode,
1128
+ ),
1129
+ disableNotification:
1130
+ typeof rawTelegram?.disableNotification === "boolean"
1131
+ ? rawTelegram.disableNotification
1132
+ : fallbackTelegram.disableNotification,
1133
+ messageThreadId:
1134
+ rawTelegram?.messageThreadId === null
1135
+ ? null
1136
+ : Number.isFinite(Number(rawTelegram?.messageThreadId))
1137
+ ? Math.max(0, Math.floor(Number(rawTelegram?.messageThreadId)))
1138
+ : fallbackTelegram.messageThreadId,
1139
+ includeDashboardLink:
1140
+ typeof rawTelegram?.includeDashboardLink === "boolean"
1141
+ ? rawTelegram.includeDashboardLink
1142
+ : fallbackTelegram.includeDashboardLink,
1143
+ apiBase: normalizeHttpBase(rawTelegram?.apiBase, fallbackTelegram.apiBase),
1144
+ },
1145
+ native: {
1146
+ enabled:
1147
+ typeof rawNative?.enabled === "boolean"
1148
+ ? rawNative.enabled
1149
+ : fallbackNative.enabled,
1150
+ sound:
1151
+ typeof rawNative?.sound === "boolean"
1152
+ ? rawNative.sound
1153
+ : fallbackNative.sound,
1154
+ },
1155
+ quietHours: {
1156
+ enabled:
1157
+ typeof rawQuiet?.enabled === "boolean"
1158
+ ? rawQuiet.enabled
1159
+ : fallbackQuiet.enabled,
1160
+ from: normalizeDailyTime(rawQuiet?.from, fallbackQuiet.from),
1161
+ to: normalizeDailyTime(rawQuiet?.to, fallbackQuiet.to),
1162
+ },
1163
+ dashboardUrl:
1164
+ typeof raw.dashboardUrl === "string"
1165
+ ? raw.dashboardUrl.trim().slice(0, 500)
1166
+ : (fallback.dashboardUrl ?? ""),
1167
+ matrix: {
1168
+ enabled:
1169
+ typeof rawMatrix?.enabled === "boolean"
1170
+ ? rawMatrix.enabled
1171
+ : fallbackMatrix.enabled,
1172
+ onPartial:
1173
+ typeof rawMatrix?.onPartial === "boolean"
1174
+ ? rawMatrix.onPartial
1175
+ : fallbackMatrix.onPartial,
1176
+ onAllFailed:
1177
+ typeof rawMatrix?.onAllFailed === "boolean"
1178
+ ? rawMatrix.onAllFailed
1179
+ : fallbackMatrix.onAllFailed,
1180
+ stuckAfterMinutes: normalizeIntInRange(
1181
+ rawMatrix?.stuckAfterMinutes,
1182
+ fallbackMatrix.stuckAfterMinutes,
1183
+ 0,
1184
+ 10_080,
1185
+ ),
1186
+ },
1187
+ digest: {
1188
+ enabled:
1189
+ typeof rawDigest?.enabled === "boolean"
1190
+ ? rawDigest.enabled
1191
+ : fallbackDigest.enabled,
1192
+ frequency,
1193
+ time: normalizeDailyTime(rawDigest?.time, fallbackDigest.time),
1194
+ lastSentAt,
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
+ ),
1209
+ };
1210
+ }
1211
+
1212
+ /** Приводит настройки интеграций к безопасному виду. */
1213
+ function normalizeIntegrations(
1214
+ value: unknown,
1215
+ fallback: IntegrationSettings,
1216
+ ): IntegrationSettings {
1217
+ const fallbackHooks = fallback.hooks ?? defaultIntegrations().hooks;
1218
+ const raw = asRecord(value);
1219
+ const rawHooks = asRecord(raw?.hooks);
1220
+
1221
+ const readCredential = (input: unknown, previous: string): string => {
1222
+ if (typeof input !== "string") return previous;
1223
+ return input.trim().slice(0, MAX_HOOK_CREDENTIAL_LENGTH);
1224
+ };
1225
+
1226
+ return {
1227
+ hooks: {
1228
+ enabled:
1229
+ typeof rawHooks?.enabled === "boolean"
1230
+ ? rawHooks.enabled
1231
+ : fallbackHooks.enabled,
1232
+ token: readCredential(rawHooks?.token, fallbackHooks.token),
1233
+ secret: readCredential(rawHooks?.secret, fallbackHooks.secret),
1234
+ requireSignature:
1235
+ typeof rawHooks?.requireSignature === "boolean"
1236
+ ? rawHooks.requireSignature
1237
+ : fallbackHooks.requireSignature,
1238
+ maxBodyBytes: normalizeIntInRange(
1239
+ rawHooks?.maxBodyBytes,
1240
+ fallbackHooks.maxBodyBytes,
1241
+ 1_024,
1242
+ MAX_HOOK_BODY_BYTES,
1243
+ ),
1244
+ timestampToleranceSeconds: normalizeIntInRange(
1245
+ rawHooks?.timestampToleranceSeconds,
1246
+ fallbackHooks.timestampToleranceSeconds,
1247
+ 0,
1248
+ 86_400,
1249
+ ),
1250
+ },
1251
+ };
1252
+ }
1253
+
1254
+ /** Читает настройки. Битый/отсутствующий файл — значения по умолчанию. */
1255
+ export async function loadSettings(): Promise<SchedulerSettings> {
1256
+ const fallbackNotifications = defaultNotifications();
1257
+ const fallbackHistory = defaultHistorySettings();
1258
+ const fallbackIntegrations = defaultIntegrations();
1259
+ const fallbackAudit = defaultAuditSettings();
1260
+ const fallbackPermissions = defaultPermissionsSettings();
1261
+ try {
1262
+ const raw = await fs.readFile(SETTINGS_FILE, "utf8");
1263
+ const parsed = JSON.parse(raw) as Partial<SchedulerSettings> | null;
1264
+ return {
1265
+ maxConcurrent: normalizeMaxConcurrent(
1266
+ parsed?.maxConcurrent,
1267
+ DEFAULT_MAX_CONCURRENT,
1268
+ ),
1269
+ locale: normalizeLocaleMode(parsed?.locale, DEFAULT_LOCALE),
1270
+ uiLocale: normalizeLocale(parsed?.uiLocale, DEFAULT_LOCALE),
1271
+ winterMode: normalizeWinterMode(
1272
+ parsed?.winterMode,
1273
+ DEFAULT_WINTER_MODE,
1274
+ ),
1275
+ notifications: normalizeNotifications(
1276
+ parsed?.notifications,
1277
+ fallbackNotifications,
1278
+ ),
1279
+ history: normalizeHistorySettings(parsed?.history, fallbackHistory),
1280
+ integrations: normalizeIntegrations(
1281
+ parsed?.integrations,
1282
+ fallbackIntegrations,
1283
+ ),
1284
+ audit: normalizeAuditSettings(parsed?.audit, fallbackAudit),
1285
+ permissions: normalizePermissionsSettings(
1286
+ parsed?.permissions,
1287
+ fallbackPermissions,
1288
+ ),
1289
+ };
1290
+ } catch {
1291
+ return {
1292
+ maxConcurrent: DEFAULT_MAX_CONCURRENT,
1293
+ locale: DEFAULT_LOCALE,
1294
+ uiLocale: DEFAULT_LOCALE,
1295
+ winterMode: DEFAULT_WINTER_MODE,
1296
+ notifications: fallbackNotifications,
1297
+ history: fallbackHistory,
1298
+ integrations: fallbackIntegrations,
1299
+ audit: fallbackAudit,
1300
+ permissions: fallbackPermissions,
1301
+ };
1302
+ }
1303
+ }
1304
+
1305
+ /** Сохраняет настройки (частичное обновление поверх текущих). */
1306
+ export async function saveSettings(
1307
+ patch: Partial<SchedulerSettings>,
1308
+ ): Promise<SchedulerSettings> {
1309
+ const current = await loadSettings();
1310
+ const next: SchedulerSettings = {
1311
+ maxConcurrent:
1312
+ patch.maxConcurrent !== undefined
1313
+ ? normalizeMaxConcurrent(patch.maxConcurrent, current.maxConcurrent)
1314
+ : current.maxConcurrent,
1315
+ locale:
1316
+ patch.locale !== undefined
1317
+ ? normalizeLocaleMode(patch.locale, current.locale)
1318
+ : current.locale,
1319
+ uiLocale:
1320
+ patch.uiLocale !== undefined
1321
+ ? normalizeLocale(patch.uiLocale, current.uiLocale)
1322
+ : current.uiLocale,
1323
+ winterMode:
1324
+ patch.winterMode !== undefined
1325
+ ? normalizeWinterMode(patch.winterMode, current.winterMode)
1326
+ : current.winterMode,
1327
+ notifications:
1328
+ patch.notifications !== undefined
1329
+ ? normalizeNotifications(patch.notifications, current.notifications)
1330
+ : current.notifications,
1331
+ history:
1332
+ patch.history !== undefined
1333
+ ? normalizeHistorySettings(patch.history, current.history)
1334
+ : current.history,
1335
+ integrations:
1336
+ patch.integrations !== undefined
1337
+ ? normalizeIntegrations(patch.integrations, current.integrations)
1338
+ : current.integrations,
1339
+ audit:
1340
+ patch.audit !== undefined
1341
+ ? normalizeAuditSettings(patch.audit, current.audit)
1342
+ : current.audit,
1343
+ permissions:
1344
+ patch.permissions !== undefined
1345
+ ? normalizePermissionsSettings(patch.permissions, current.permissions)
1346
+ : current.permissions,
1347
+ };
1348
+
1349
+ // Удобство: при включении хуков без явных учётных данных генерируем их,
1350
+ // чтобы функция сразу работала, а секреты не приходилось придумывать вручную.
1351
+ if (next.integrations.hooks.enabled) {
1352
+ if (!next.integrations.hooks.token || !next.integrations.hooks.secret) {
1353
+ const generated = generateHookCredentials();
1354
+ if (!next.integrations.hooks.token) next.integrations.hooks.token = generated.token;
1355
+ if (!next.integrations.hooks.secret) next.integrations.hooks.secret = generated.secret;
1356
+ }
1357
+ }
1358
+
1359
+ // Удобство: включённый shadow-режим без даты старта стартует при первом сохранении.
1360
+ // Иначе shadow не логировал бы решения, а триаж реально подавлял бы уведомления.
1361
+ const triage = next.notifications.triage;
1362
+ if (triage) {
1363
+ triage.shadow = settleShadowOnSave(triage.shadow);
1364
+ }
1365
+
1366
+ await fs.mkdir(PLUGIN_DIR, { recursive: true });
1367
+ await fs.writeFile(SETTINGS_FILE, JSON.stringify(next, null, 2), "utf8");
1368
+ return next;
1369
+ }