opencode-windows-scheduler 1.5.4 → 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 (218) hide show
  1. package/CHANGELOG.md +65 -5
  2. package/CROSS_PLATFORM.md +107 -71
  3. package/README.md +72 -25
  4. package/ROADMAP-STRATEGY.md +6 -0
  5. package/ROADMAP.md +116 -85
  6. package/dist/core/analytics.d.ts +3 -0
  7. package/dist/core/analytics.d.ts.map +1 -1
  8. package/dist/core/analytics.js +4 -0
  9. package/dist/core/audit.d.ts +2 -1
  10. package/dist/core/audit.d.ts.map +1 -1
  11. package/dist/core/audit.js +32 -1
  12. package/dist/core/cron-to-schtasks.d.ts.map +1 -1
  13. package/dist/core/cron-to-schtasks.js +21 -4
  14. package/dist/core/file-watcher.d.ts.map +1 -1
  15. package/dist/core/file-watcher.js +16 -1
  16. package/dist/core/git-trigger.d.ts +4 -2
  17. package/dist/core/git-trigger.d.ts.map +1 -1
  18. package/dist/core/git-trigger.js +34 -16
  19. package/dist/core/lock.d.ts +14 -0
  20. package/dist/core/lock.d.ts.map +1 -1
  21. package/dist/core/lock.js +81 -4
  22. package/dist/core/matrix.d.ts.map +1 -1
  23. package/dist/core/matrix.js +3 -2
  24. package/dist/core/native-notify.d.ts.map +1 -1
  25. package/dist/core/native-notify.js +3 -0
  26. package/dist/core/one-shot.d.ts +7 -1
  27. package/dist/core/one-shot.d.ts.map +1 -1
  28. package/dist/core/one-shot.js +15 -2
  29. package/dist/core/permissions.d.ts +69 -0
  30. package/dist/core/permissions.d.ts.map +1 -0
  31. package/dist/core/permissions.js +143 -0
  32. package/dist/core/ps-wrapper.d.ts +9 -2
  33. package/dist/core/ps-wrapper.d.ts.map +1 -1
  34. package/dist/core/ps-wrapper.js +293 -96
  35. package/dist/core/record-history.d.ts +11 -0
  36. package/dist/core/record-history.d.ts.map +1 -1
  37. package/dist/core/record-history.js +106 -4
  38. package/dist/core/savings.d.ts +70 -0
  39. package/dist/core/savings.d.ts.map +1 -0
  40. package/dist/core/savings.js +87 -0
  41. package/dist/core/schedule-gate.js +7 -3
  42. package/dist/core/schedule-v2.js +1 -1
  43. package/dist/core/scheduler/index.d.ts +13 -1
  44. package/dist/core/scheduler/index.d.ts.map +1 -1
  45. package/dist/core/scheduler/index.js +35 -4
  46. package/dist/core/scheduler/linux.d.ts +4 -1
  47. package/dist/core/scheduler/linux.d.ts.map +1 -1
  48. package/dist/core/scheduler/linux.js +53 -20
  49. package/dist/core/scheduler/mac.d.ts +2 -1
  50. package/dist/core/scheduler/mac.d.ts.map +1 -1
  51. package/dist/core/scheduler/mac.js +24 -6
  52. package/dist/core/scheduler/posix.d.ts +1 -1
  53. package/dist/core/scheduler/posix.d.ts.map +1 -1
  54. package/dist/core/scheduler/posix.js +2 -2
  55. package/dist/core/scheduler/registry.d.ts +3 -2
  56. package/dist/core/scheduler/registry.d.ts.map +1 -1
  57. package/dist/core/scheduler/registry.js +6 -5
  58. package/dist/core/scheduler/windows.d.ts +49 -1
  59. package/dist/core/scheduler/windows.d.ts.map +1 -1
  60. package/dist/core/scheduler/windows.js +219 -34
  61. package/dist/core/secrets.d.ts +5 -3
  62. package/dist/core/secrets.d.ts.map +1 -1
  63. package/dist/core/secrets.js +86 -8
  64. package/dist/core/self-analysis.d.ts +117 -0
  65. package/dist/core/self-analysis.d.ts.map +1 -0
  66. package/dist/core/self-analysis.js +539 -0
  67. package/dist/core/session.d.ts +11 -3
  68. package/dist/core/session.d.ts.map +1 -1
  69. package/dist/core/session.js +34 -5
  70. package/dist/core/shutdown.d.ts +26 -0
  71. package/dist/core/shutdown.d.ts.map +1 -0
  72. package/dist/core/shutdown.js +49 -0
  73. package/dist/core/summary.d.ts +69 -0
  74. package/dist/core/summary.d.ts.map +1 -0
  75. package/dist/core/summary.js +250 -0
  76. package/dist/core/telegram.d.ts +10 -0
  77. package/dist/core/telegram.d.ts.map +1 -1
  78. package/dist/core/telegram.js +228 -47
  79. package/dist/core/triage-chain.d.ts +9 -3
  80. package/dist/core/triage-chain.d.ts.map +1 -1
  81. package/dist/core/triage-chain.js +15 -5
  82. package/dist/core/triage-compare.d.ts +68 -0
  83. package/dist/core/triage-compare.d.ts.map +1 -0
  84. package/dist/core/triage-compare.js +184 -0
  85. package/dist/core/triage-rules.d.ts.map +1 -1
  86. package/dist/core/triage-rules.js +22 -0
  87. package/dist/core/triage-shadow.d.ts +54 -10
  88. package/dist/core/triage-shadow.d.ts.map +1 -1
  89. package/dist/core/triage-shadow.js +138 -26
  90. package/dist/core/triage-worker.d.ts +55 -0
  91. package/dist/core/triage-worker.d.ts.map +1 -0
  92. package/dist/core/triage-worker.js +314 -0
  93. package/dist/core/triage.js +1 -1
  94. package/dist/core/watch-paths.d.ts +6 -0
  95. package/dist/core/watch-paths.d.ts.map +1 -0
  96. package/dist/core/watch-paths.js +62 -0
  97. package/dist/core/wrappers/bash.d.ts +15 -3
  98. package/dist/core/wrappers/bash.d.ts.map +1 -1
  99. package/dist/core/wrappers/bash.js +153 -120
  100. package/dist/db/history-repo.d.ts +1 -1
  101. package/dist/db/history-repo.d.ts.map +1 -1
  102. package/dist/db/history-repo.js +29 -14
  103. package/dist/db/schema.d.ts +1 -1
  104. package/dist/db/schema.d.ts.map +1 -1
  105. package/dist/db/schema.js +31 -0
  106. package/dist/history.d.ts +2 -2
  107. package/dist/history.d.ts.map +1 -1
  108. package/dist/history.js +3 -3
  109. package/dist/i18n.d.ts +25 -2
  110. package/dist/i18n.d.ts.map +1 -1
  111. package/dist/i18n.js +41 -3
  112. package/dist/index.d.ts +40 -4
  113. package/dist/index.d.ts.map +1 -1
  114. package/dist/index.js +345 -71
  115. package/dist/integrations.d.ts +9 -1
  116. package/dist/integrations.d.ts.map +1 -1
  117. package/dist/integrations.js +34 -6
  118. package/dist/notifications.d.ts +30 -2
  119. package/dist/notifications.d.ts.map +1 -1
  120. package/dist/notifications.js +287 -16
  121. package/dist/profiles.d.ts +1 -1
  122. package/dist/profiles.d.ts.map +1 -1
  123. package/dist/profiles.js +21 -3
  124. package/dist/rpc.d.ts +145 -8
  125. package/dist/rpc.d.ts.map +1 -1
  126. package/dist/rpc.js +81 -6
  127. package/dist/server.d.ts +20 -0
  128. package/dist/server.d.ts.map +1 -1
  129. package/dist/server.js +136 -14
  130. package/dist/settings.d.ts +89 -5
  131. package/dist/settings.d.ts.map +1 -1
  132. package/dist/settings.js +143 -23
  133. package/dist/task-transfer.d.ts +8 -1
  134. package/dist/task-transfer.d.ts.map +1 -1
  135. package/dist/task-transfer.js +2 -2
  136. package/dist/types.d.ts +8 -1
  137. package/dist/types.d.ts.map +1 -1
  138. package/dist/types.js +23 -5
  139. package/dist/workspaces.d.ts +9 -0
  140. package/dist/workspaces.d.ts.map +1 -1
  141. package/dist/workspaces.js +25 -0
  142. package/docs/ARCHITECTURE.md +40 -22
  143. package/docs/CONCEPT.md +230 -0
  144. package/docs/CROSS_PLATFORM.ru.md +150 -0
  145. package/docs/CROSS_PLATFORM.zh.md +146 -0
  146. package/docs/FAQ.md +52 -0
  147. package/docs/FAQ.ru.md +53 -0
  148. package/docs/FAQ.zh.md +43 -0
  149. package/docs/FEATURES.md +125 -48
  150. package/docs/FEATURES.zh.md +655 -0
  151. package/docs/LOCAL-AI.md +114 -16
  152. package/docs/README.ru.md +18 -13
  153. package/docs/README.zh.md +286 -0
  154. package/docs/SAVINGS.md +61 -0
  155. package/docs/SAVINGS.ru.md +60 -0
  156. package/docs/SAVINGS.zh.md +52 -0
  157. package/docs/ZH-LOCALE-PLAN.md +324 -0
  158. package/gui-experimental.cjs +8 -8
  159. package/locales/en.json +54 -1
  160. package/locales/ru.json +54 -1
  161. package/locales/zh.json +780 -0
  162. package/package.json +24 -7
  163. package/scripts/check-zh-locale.mjs +218 -0
  164. package/scripts/run-tests.mjs +236 -0
  165. package/scripts/test-locale.mjs +4 -3
  166. package/skills/scheduled-job-best-practices/SKILL.md +6 -3
  167. package/skills/scheduled-job-best-practices/references/recipes.md +1 -1
  168. package/src/core/analytics.ts +10 -0
  169. package/src/core/audit.ts +39 -1
  170. package/src/core/cron-to-schtasks.ts +23 -4
  171. package/src/core/file-watcher.ts +20 -1
  172. package/src/core/git-trigger.ts +34 -16
  173. package/src/core/lock.ts +88 -3
  174. package/src/core/matrix.ts +5 -1
  175. package/src/core/native-notify.ts +3 -0
  176. package/src/core/one-shot.ts +18 -2
  177. package/src/core/permissions.ts +200 -0
  178. package/src/core/ps-wrapper.ts +300 -96
  179. package/src/core/record-history.ts +111 -4
  180. package/src/core/savings.ts +150 -0
  181. package/src/core/schedule-gate.ts +9 -3
  182. package/src/core/schedule-v2.ts +1 -1
  183. package/src/core/scheduler/index.ts +41 -3
  184. package/src/core/scheduler/linux.ts +67 -22
  185. package/src/core/scheduler/mac.ts +24 -7
  186. package/src/core/scheduler/posix.ts +2 -2
  187. package/src/core/scheduler/registry.ts +7 -5
  188. package/src/core/scheduler/windows.ts +237 -32
  189. package/src/core/secrets.ts +101 -7
  190. package/src/core/self-analysis.ts +744 -0
  191. package/src/core/session.ts +40 -5
  192. package/src/core/shutdown.ts +69 -0
  193. package/src/core/summary.ts +318 -0
  194. package/src/core/telegram.ts +266 -55
  195. package/src/core/triage-chain.ts +15 -6
  196. package/src/core/triage-compare.ts +277 -0
  197. package/src/core/triage-rules.ts +23 -0
  198. package/src/core/triage-shadow.ts +176 -32
  199. package/src/core/triage-worker.ts +344 -0
  200. package/src/core/triage.ts +1 -1
  201. package/src/core/watch-paths.ts +70 -0
  202. package/src/core/wrappers/bash.ts +181 -138
  203. package/src/db/history-repo.ts +31 -18
  204. package/src/db/schema.ts +31 -0
  205. package/src/gui.tsx +5070 -4761
  206. package/src/history.ts +7 -3
  207. package/src/i18n.ts +55 -4
  208. package/src/index.ts +432 -74
  209. package/src/integrations.ts +50 -6
  210. package/src/notifications.ts +465 -18
  211. package/src/profiles.ts +21 -3
  212. package/src/rpc.ts +86 -6
  213. package/src/server.ts +135 -16
  214. package/src/settings.ts +305 -46
  215. package/src/task-transfer.ts +10 -3
  216. package/src/types.ts +24 -5
  217. package/src/workspaces.ts +22 -0
  218. package/dist/gui-experimental.cjs +0 -1
@@ -135,9 +135,167 @@ function resolveApiBase(apiBase?: string): string {
135
135
  return value;
136
136
  }
137
137
 
138
+ /** Лимит одного сообщения Telegram Bot API. */
139
+ export const TELEGRAM_MAX_MESSAGE_LENGTH = 4096;
140
+
141
+ /** Сколько раз повторяем отправку при HTTP 429. */
142
+ const TELEGRAM_MAX_RETRIES = 3;
143
+
144
+ /**
145
+ * Режет длинный текст на части по лимиту Bot API (4096 UTF-16 code units).
146
+ * Старается рвать по переводу строки, не разрывает surrogate pair и
147
+ * экранированный символ MarkdownV2 (`\x`).
148
+ */
149
+ export function splitTelegramMessage(
150
+ text: string,
151
+ limit = TELEGRAM_MAX_MESSAGE_LENGTH
152
+ ): string[] {
153
+ const value = String(text ?? "");
154
+ const max = Math.max(1, Math.floor(limit));
155
+ if (!value) return [""];
156
+ const chunks: string[] = [];
157
+ let rest = value;
158
+ while (rest.length > max) {
159
+ let cut = max;
160
+ const newline = rest.lastIndexOf("\n", max);
161
+ if (newline > max * 0.5) cut = newline + 1;
162
+ // Не разрываем surrogate pair (эмодзи и т.п.).
163
+ if (cut > 0 && cut < rest.length) {
164
+ const code = rest.charCodeAt(cut - 1);
165
+ if (code >= 0xd800 && code <= 0xdbff) cut -= 1;
166
+ }
167
+ // MarkdownV2: обратный слэш должен остаться вместе с экранируемым символом.
168
+ if (cut > 0 && rest[cut - 1] === "\\") cut -= 1;
169
+ if (cut <= 0) cut = max;
170
+ chunks.push(rest.slice(0, cut));
171
+ rest = rest.slice(cut);
172
+ }
173
+ chunks.push(rest);
174
+ return chunks;
175
+ }
176
+
177
+ /** Спецсимволы MarkdownV2 (должны совпадать с escapeTelegramText). */
178
+ const MARKDOWN_V2_SPECIAL = new Set("\\_*[]()~`>#+-=|{}.!".split(""));
179
+ /** Спецсимволы legacy Markdown. */
180
+ const MARKDOWN_SPECIAL = new Set("\\_*[]`".split(""));
181
+
182
+ /** Сколько UTF-16 code units займёт символ после экранирования. */
183
+ function escapedCharLength(ch: string, parseMode: TelegramParseMode): number {
184
+ if (parseMode === "HTML") {
185
+ if (ch === "&") return 5;
186
+ if (ch === "<" || ch === ">") return 4;
187
+ return ch.length;
188
+ }
189
+ if (parseMode === "MarkdownV2") {
190
+ return MARKDOWN_V2_SPECIAL.has(ch) ? ch.length + 1 : ch.length;
191
+ }
192
+ if (parseMode === "Markdown") {
193
+ return MARKDOWN_SPECIAL.has(ch) ? ch.length + 1 : ch.length;
194
+ }
195
+ return ch.length;
196
+ }
197
+
198
+ /** Длина текста после экранирования под parse_mode. */
199
+ function formattedLength(text: string, parseMode: TelegramParseMode): number {
200
+ let total = 0;
201
+ for (const ch of String(text ?? "")) {
202
+ total += escapedCharLength(ch, parseMode);
203
+ }
204
+ return total;
205
+ }
206
+
207
+ /**
208
+ * Возвращает индекс конца сырого чанка, который после экранирования
209
+ * укладывается в maxFormatted. Старается рвать по переводу строки и никогда
210
+ * не разрывает surrogate pair.
211
+ */
212
+ function cutRawChunk(
213
+ text: string,
214
+ start: number,
215
+ maxFormatted: number,
216
+ parseMode: TelegramParseMode
217
+ ): number {
218
+ let index = start;
219
+ let used = 0;
220
+ let lastNewline = -1;
221
+ while (index < text.length) {
222
+ const codePoint = text.codePointAt(index) as number;
223
+ const ch = String.fromCodePoint(codePoint);
224
+ const cost = escapedCharLength(ch, parseMode);
225
+ if (used + cost > maxFormatted) break;
226
+ used += cost;
227
+ index += ch.length;
228
+ if (ch === "\n") lastNewline = index;
229
+ }
230
+ if (index < text.length && index > start && lastNewline > start) {
231
+ const consumed = index - start;
232
+ if (lastNewline - start > consumed * 0.5) index = lastNewline;
233
+ }
234
+ if (index <= start) {
235
+ // Гарантируем прогресс хотя бы на один code point.
236
+ const codePoint = text.codePointAt(start) as number;
237
+ index = start + String.fromCodePoint(codePoint).length;
238
+ }
239
+ return index;
240
+ }
241
+
242
+ /**
243
+ * Режет СЫРОЙ текст так, чтобы каждый отформатированный чанк укладывался в
244
+ * лимит Telegram. Резать уже экранированный текст нельзя: HTML-сущности
245
+ * (&amp;, &lt;) и MarkdownV2-экранирование (\*) могут разорваться между
246
+ * сообщениями, и Bot API отвечает 400 «can't parse entities».
247
+ * linkReserve — запас под ссылку на дашборд в последнем чанке.
248
+ */
249
+ function splitRawMessageForSend(
250
+ text: string,
251
+ limit: number,
252
+ parseMode: TelegramParseMode,
253
+ linkReserve = 0
254
+ ): string[] {
255
+ const value = String(text ?? "");
256
+ const max = Math.max(1, Math.floor(limit));
257
+ if (!value) return [""];
258
+
259
+ const chunks: string[] = [];
260
+ let start = 0;
261
+ while (start < value.length) {
262
+ const end = cutRawChunk(value, start, max, parseMode);
263
+ chunks.push(value.slice(start, end));
264
+ start = end;
265
+ }
266
+
267
+ if (linkReserve > 0 && chunks.length > 0) {
268
+ const maxLast = Math.max(1, max - linkReserve);
269
+ const lastStart = value.length - chunks[chunks.length - 1].length;
270
+ if (formattedLength(value.slice(lastStart), parseMode) > maxLast) {
271
+ // Пересобираем хвост с меньшим лимитом, чтобы влезла ссылка.
272
+ chunks.splice(chunks.length - 1, 1);
273
+ let tailStart = lastStart;
274
+ while (tailStart < value.length) {
275
+ const end = cutRawChunk(value, tailStart, maxLast, parseMode);
276
+ chunks.push(value.slice(tailStart, end));
277
+ tailStart = end;
278
+ }
279
+ }
280
+ }
281
+ return chunks;
282
+ }
283
+
284
+ /** Пауза без утечки таймера. */
285
+ function sleep(ms: number): Promise<void> {
286
+ return new Promise((resolve) => {
287
+ const timer = setTimeout(resolve, ms);
288
+ // timer.unref?.() УБРАН: процесс не должен завершаться во время 429-ретрая,
289
+ // иначе уведомление теряется (record-history — короткоживущий процесс,
290
+ // event loop не удерживается unref-таймером).
291
+ });
292
+ }
293
+
138
294
  /**
139
295
  * Отправляет сообщение через Bot API `sendMessage`.
140
296
  *
297
+ * Длинный текст режется на части по 4096 символов. При HTTP 429 отправка
298
+ * повторяется с учётом `parameters.retry_after` (не более 3 повторов).
141
299
  * Бросает Error с безопасным текстом (токен замаскирован). Вызывающий код
142
300
  * обязан перехватить ошибку, чтобы уведомление не ломало задачу.
143
301
  */
@@ -155,71 +313,124 @@ export async function sendTelegramMessage(
155
313
 
156
314
  const apiBase = resolveApiBase(options.apiBase);
157
315
  const parseMode = options.parseMode ?? "";
158
- const body: Record<string, unknown> = {
159
- chat_id: target,
160
- text: formatTelegramText(
161
- text,
162
- parseMode,
163
- options.includeDashboardLink === false ? null : options.dashboardUrl
164
- ),
165
- };
166
- if (parseMode) body.parse_mode = parseMode;
167
- if (options.disableNotification) body.disable_notification = true;
168
- if (
169
- typeof options.messageThreadId === "number" &&
170
- Number.isFinite(options.messageThreadId) &&
171
- options.messageThreadId > 0
172
- ) {
173
- body.message_thread_id = Math.floor(options.messageThreadId);
174
- }
316
+ const dashboardUrl =
317
+ options.includeDashboardLink === false ? null : options.dashboardUrl;
318
+ // Ссылку добавляем только в последний чанк, поэтому её длину резервируем
319
+ // заранее: formatTelegramText("") возвращает ровно суффикс со ссылкой.
320
+ const linkSuffix = dashboardUrl
321
+ ? formatTelegramText("", parseMode, dashboardUrl)
322
+ : "";
323
+ const rawChunks = splitRawMessageForSend(
324
+ text,
325
+ TELEGRAM_MAX_MESSAGE_LENGTH,
326
+ parseMode,
327
+ linkSuffix.length
328
+ );
175
329
 
176
330
  const timeoutMs = Math.max(
177
331
  1_000,
178
332
  Math.floor(options.timeoutMs ?? DEFAULT_TIMEOUT_MS)
179
333
  );
180
334
  const fetchImpl = options.fetchImpl ?? fetch;
181
- const controller = new AbortController();
182
- const timer = setTimeout(() => controller.abort(), timeoutMs);
335
+ const url = `${apiBase}/bot${safeToken}/sendMessage`;
183
336
 
184
- try {
185
- const response = await fetchImpl(
186
- `${apiBase}/bot${safeToken}/sendMessage`,
187
- {
188
- method: "POST",
189
- headers: { "Content-Type": "application/json" },
190
- body: JSON.stringify(body),
191
- signal: controller.signal,
192
- }
337
+ for (let chunkIndex = 0; chunkIndex < rawChunks.length; chunkIndex++) {
338
+ const isLastChunk = chunkIndex === rawChunks.length - 1;
339
+ // Форматируем каждый сырой чанк отдельно: экранированные сущности
340
+ // (&amp;, \*) никогда не разрываются между сообщениями.
341
+ const chunk = formatTelegramText(
342
+ rawChunks[chunkIndex],
343
+ parseMode,
344
+ isLastChunk ? dashboardUrl : null
193
345
  );
346
+ let parseModeForChunk = parseMode;
347
+ let downgradedParseMode = false;
194
348
 
195
- const raw = await response.text().catch(() => "");
196
- let parsed: any = null;
197
- try {
198
- parsed = raw ? JSON.parse(raw) : null;
199
- } catch {
200
- parsed = null;
201
- }
349
+ for (let attempt = 0; ; attempt++) {
350
+ const body: Record<string, unknown> = { chat_id: target, text: chunk };
351
+ if (parseModeForChunk) body.parse_mode = parseModeForChunk;
352
+ if (options.disableNotification) body.disable_notification = true;
353
+ if (
354
+ typeof options.messageThreadId === "number" &&
355
+ Number.isFinite(options.messageThreadId) &&
356
+ options.messageThreadId > 0
357
+ ) {
358
+ body.message_thread_id = Math.floor(options.messageThreadId);
359
+ }
202
360
 
203
- if (!response.ok || parsed?.ok === false) {
204
- const description =
205
- (typeof parsed?.description === "string" && parsed.description) ||
206
- raw.slice(0, 200) ||
207
- `HTTP ${response.status}`;
208
- throw new Error(
209
- `Telegram API: ${sanitizeErrorText(description, safeToken)}`
210
- );
211
- }
212
- } catch (err: any) {
213
- if (err?.name === "AbortError") {
214
- throw new Error(
215
- t("notify.error.telegramTimeout", {
216
- seconds: Math.floor(timeoutMs / 1000),
217
- })
218
- );
361
+ const controller = new AbortController();
362
+ const timer = setTimeout(() => controller.abort(), timeoutMs);
363
+ try {
364
+ const response = await fetchImpl(url, {
365
+ method: "POST",
366
+ headers: { "Content-Type": "application/json" },
367
+ body: JSON.stringify(body),
368
+ signal: controller.signal,
369
+ });
370
+
371
+ const raw = await response.text().catch(() => "");
372
+ let parsed: any = null;
373
+ try {
374
+ parsed = raw ? JSON.parse(raw) : null;
375
+ } catch {
376
+ parsed = null;
377
+ }
378
+
379
+ if (response.status === 429 && attempt < TELEGRAM_MAX_RETRIES) {
380
+ const retryAfter = Number(parsed?.parameters?.retry_after);
381
+ const delaySeconds = Number.isFinite(retryAfter) && retryAfter > 0
382
+ ? Math.min(60, Math.ceil(retryAfter))
383
+ : Math.min(30, 2 ** attempt);
384
+ await sleep(delaySeconds * 1000);
385
+ continue;
386
+ }
387
+
388
+ const description =
389
+ (typeof parsed?.description === "string" && parsed.description) ||
390
+ raw.slice(0, 200) ||
391
+ `HTTP ${response.status}`;
392
+
393
+ // Страховка: если Telegram всё равно не разобрал разметку, повторяем
394
+ // тот же чанк без parse_mode — лучше без форматирования, чем потерять
395
+ // уведомление целиком.
396
+ if (
397
+ response.status === 400 &&
398
+ parseModeForChunk &&
399
+ !downgradedParseMode &&
400
+ /parse entities|can't parse|unsupported start tag|can't find end/i.test(
401
+ description
402
+ )
403
+ ) {
404
+ console.warn(
405
+ `[notify] Telegram отклонил разметку (${sanitizeErrorText(
406
+ description,
407
+ safeToken
408
+ )}) — чанк повторно отправлен без parse_mode. Проверьте шаблоны уведомлений.`
409
+ );
410
+ downgradedParseMode = true;
411
+ parseModeForChunk = "";
412
+ continue;
413
+ }
414
+
415
+ if (!response.ok || parsed?.ok === false) {
416
+ throw new Error(
417
+ `Telegram API: ${sanitizeErrorText(description, safeToken)}`
418
+ );
419
+ }
420
+ break;
421
+ } catch (err: any) {
422
+ if (err?.name === "AbortError") {
423
+ throw new Error(
424
+ t("notify.error.telegramTimeout", {
425
+ seconds: Math.floor(timeoutMs / 1000),
426
+ })
427
+ );
428
+ }
429
+ const message = err instanceof Error ? err.message : String(err);
430
+ throw new Error(sanitizeErrorText(message, safeToken));
431
+ } finally {
432
+ clearTimeout(timer);
433
+ }
219
434
  }
220
- const message = err instanceof Error ? err.message : String(err);
221
- throw new Error(sanitizeErrorText(message, safeToken));
222
- } finally {
223
- clearTimeout(timer);
224
435
  }
225
436
  }
@@ -6,8 +6,8 @@ import {
6
6
  type TriageVerdict,
7
7
  } from "./triage.js";
8
8
  import { evaluateTriageRules } from "./triage-rules.js";
9
- import { recordShadowDecision } from "./triage-shadow.js";
10
- import type { TriageSettings } from "../settings.js";
9
+ import { recordTriageOutcome } from "./triage-shadow.js";
10
+ import { isShadowActive, type TriageSettings } from "../settings.js";
11
11
 
12
12
  /** Что делать с уведомлением после триажа. */
13
13
  export type TriageAction = "notify" | "skip";
@@ -53,7 +53,8 @@ function ruleDecision(
53
53
  * - `rules` — решают только правила; нет совпадения = отправить.
54
54
  * - `llm`/`auto` — LLM классифицирует, но сам ничего не подавляет; при
55
55
  * ошибке, таймауте или низкой уверенности управление переходит к правилам
56
- * (если `fallback: "rules"`) либо уведомление отправляется без правил.
56
+ * (если `fallback: "rules"`) либо уведомление отправляется без правил
57
+ * (`fallback: "notify"`; устаревшее имя — `"skip"`).
57
58
  *
58
59
  * Функция никогда не бросает исключение и по умолчанию возвращает `notify`:
59
60
  * недоступный классификатор не должен терять уведомление.
@@ -86,7 +87,7 @@ export async function decideTriage(
86
87
  ? "low-confidence"
87
88
  : llm.failure ?? "invalid-response";
88
89
 
89
- if (settings.fallback === "skip") {
90
+ if (settings.fallback === "notify" || settings.fallback === "skip") {
90
91
  return {
91
92
  action: NOTIFY,
92
93
  source: "fallback",
@@ -105,12 +106,20 @@ export async function decideTriage(
105
106
  };
106
107
  }
107
108
 
108
- /** Записывает решение в shadow-журнал, если shadow-режим активен. */
109
+ /**
110
+ * Записывает решение в shadow-журнал, если shadow-режим активен.
111
+ *
112
+ * Оставлено для обратной совместимости; `notifyTaskCompletion` пишет все
113
+ * решения через `recordTriageOutcome` (31.8).
114
+ */
109
115
  export function recordShadow(
110
116
  input: TriageInput,
111
117
  decision: TriageDecision,
112
118
  shadow: TriageSettings["shadow"] | undefined
113
119
  ): void {
114
120
  if (!shadow || !shadow.enabled) return;
115
- recordShadowDecision(input, decision);
121
+ recordTriageOutcome(input, decision, {
122
+ shadowActive: isShadowActive(shadow),
123
+ suppressed: false,
124
+ });
116
125
  }
@@ -0,0 +1,277 @@
1
+ /**
2
+ * Сравнение решений триажа «до/после» (Спринт 31.5).
3
+ *
4
+ * Для одного события уведомления прогоняет цепочку триажа под двумя наборами
5
+ * настроек (текущие «before» и предлагаемые «after») и возвращает_diff_
6
+ * вердиктов, правил и итоговых сообщений. Это позволяет визуализировать
7
+ * эффект изменения правил или порога перед тем, как сохранить новые настройки.
8
+ *
9
+ * Модуль чистый (нет БД и HTTP), легко тестируется на фиксированных данных.
10
+ * `decideTriage` асинхронный, поэтому сама функция тоже асинхронная.
11
+ */
12
+ import { decideTriage, type TriageDecision } from "./triage-chain.js";
13
+ import type { TriageInput } from "./triage.js";
14
+ import {
15
+ defaultNotifications,
16
+ normalizeTriageSettings,
17
+ type TriageSettings,
18
+ } from "../settings.js";
19
+ import { formatNotificationMessage } from "../notifications.js";
20
+ import { t } from "../i18n.js";
21
+
22
+ /**
23
+ * Верхняя граница одного прогона сравнения.
24
+ *
25
+ * Сам классификатор уже ограничен `timeoutMs` и повторами, но два прогона
26
+ * (before/after) могут суммарно занять до нескольких минут. Для интерактивной
27
+ * кнопки «Сравнить» это слишком долго, поэтому решение ограничивается общим
28
+ * дедлайном; по его истечении возвращается безопасный fallback `notify`.
29
+ */
30
+ const DEFAULT_COMPARE_TIMEOUT_MS = 75_000;
31
+
32
+ /** Одно решение триажа с итоговым сообщением, которое было бы доставлено. */
33
+ export interface ComparedDecision {
34
+ action: TriageDecision["action"];
35
+ source: TriageDecision["source"];
36
+ /** id сработавшего правила, если было. */
37
+ ruleId?: string;
38
+ failure?: TriageDecision["failure"];
39
+ verdict?: {
40
+ category: string;
41
+ severity: string;
42
+ confidence: number;
43
+ reason: string;
44
+ };
45
+ attempts: number;
46
+ latencyMs: number;
47
+ /** Сообщение, которое было бы доставлено (или подавлялось бы). */
48
+ message: string;
49
+ /** Будет ли уведомление подавлено (не доставлено). */
50
+ suppressed: boolean;
51
+ }
52
+
53
+ /** Разница между «before» и «after» для одного поля. */
54
+ interface FieldDiff<Value> {
55
+ before: Value | null;
56
+ after: Value | null;
57
+ changed: boolean;
58
+ }
59
+
60
+ /** Итоговое сравнение для GUI-кнопки «Сравнить». */
61
+ export interface CompareTriageResult {
62
+ input: TriageInput;
63
+ before: ComparedDecision;
64
+ after: ComparedDecision;
65
+ /** Что изменилось между before и after. */
66
+ diff: {
67
+ action: FieldDiff<TriageDecision["action"]>;
68
+ source: FieldDiff<TriageDecision["source"]>;
69
+ ruleId: FieldDiff<string | undefined>;
70
+ failure: FieldDiff<string | undefined>;
71
+ confidence: FieldDiff<number | undefined>;
72
+ category: FieldDiff<string | undefined>;
73
+ severity: FieldDiff<string | undefined>;
74
+ reason: FieldDiff<string | undefined>;
75
+ suppressed: FieldDiff<boolean>;
76
+ message: FieldDiff<string>;
77
+ };
78
+ }
79
+
80
+ /** Поле изменилось? */
81
+ function changed<Value>(before: Value, after: Value): boolean {
82
+ return before !== after;
83
+ }
84
+
85
+ function verdictOf(decision: TriageDecision): ComparedDecision["verdict"] {
86
+ if (!decision.verdict) return undefined;
87
+ return {
88
+ category: decision.verdict.category,
89
+ severity: decision.verdict.severity,
90
+ confidence: decision.verdict.confidence,
91
+ reason: decision.verdict.reason,
92
+ };
93
+ }
94
+
95
+ /** Построить ComparedDecision из решения триажа. */
96
+ function toCompared(
97
+ input: TriageInput,
98
+ decision: TriageDecision,
99
+ baseMessage: string,
100
+ dedupCount: number
101
+ ): ComparedDecision {
102
+ const suppressed = decision.action === "skip";
103
+ const message = suppressed
104
+ ? baseMessage
105
+ : baseMessage + (dedupCount > 1 ? " " + dedupCountSuffix(dedupCount) : "");
106
+ return {
107
+ action: decision.action,
108
+ source: decision.source,
109
+ ruleId: decision.ruleId,
110
+ failure: decision.failure,
111
+ verdict: verdictOf(decision),
112
+ attempts: decision.attempts,
113
+ latencyMs: decision.latencyMs,
114
+ message,
115
+ suppressed,
116
+ };
117
+ }
118
+
119
+ function dedupCountSuffix(count: number): string {
120
+ return t("notify.dedup.count", { count });
121
+ }
122
+
123
+ /**
124
+ * Решение по таймауту сравнения: уведомление не теряется, но и не ждём
125
+ * зависший классификатор бесконечно.
126
+ */
127
+ function timeoutDecision(): TriageDecision {
128
+ return {
129
+ action: "notify",
130
+ source: "fallback",
131
+ failure: "timeout",
132
+ attempts: 0,
133
+ latencyMs: 0,
134
+ };
135
+ }
136
+
137
+ /**
138
+ * Запускает `decideTriage` с внешним дедлайном.
139
+ *
140
+ * Внутренний AbortController классификатора остаётся основным механизмом;
141
+ * этот таймер страхует GUI от суммы двух прогонов и повторов.
142
+ */
143
+ async function decideWithTimeout(
144
+ input: TriageInput,
145
+ settings: TriageSettings,
146
+ timeoutMs: number
147
+ ): Promise<TriageDecision> {
148
+ if (!Number.isFinite(timeoutMs) || timeoutMs <= 0) {
149
+ return decideTriage(input, settings);
150
+ }
151
+ let timer: ReturnType<typeof setTimeout> | undefined;
152
+ try {
153
+ return await Promise.race([
154
+ decideTriage(input, settings),
155
+ new Promise<TriageDecision>((resolve) => {
156
+ timer = setTimeout(() => resolve(timeoutDecision()), timeoutMs);
157
+ }),
158
+ ]);
159
+ } finally {
160
+ if (timer) clearTimeout(timer);
161
+ }
162
+ }
163
+
164
+ /**
165
+ * Прогоняет триаж под двумя наборами настроек и считает diff.
166
+ *
167
+ * `dedupCount` — сколько повторов уже есть для этой пары задача+статус
168
+ * (используется только для сообщения).
169
+ */
170
+ export async function compareTriage(
171
+ input: TriageInput,
172
+ beforeSettings: TriageSettings | undefined,
173
+ afterSettings: TriageSettings | undefined,
174
+ dedupCount = 1,
175
+ timeoutMs = DEFAULT_COMPARE_TIMEOUT_MS
176
+ ): Promise<CompareTriageResult> {
177
+ const durationMs =
178
+ typeof input.durationMs === "number" && Number.isFinite(input.durationMs)
179
+ ? input.durationMs
180
+ : 0;
181
+ const baseMessage = formatNotificationMessage(
182
+ {
183
+ taskName: input.taskName,
184
+ status: input.status,
185
+ durationMs,
186
+ error: input.error ?? undefined,
187
+ tokens: input.tokens ?? undefined,
188
+ costUsd: input.costUsd ?? undefined,
189
+ },
190
+ undefined
191
+ );
192
+
193
+ // before/after приходят из RPC как пользовательский ввод: нормализуем их
194
+ // той же схемой, что и сохранённые настройки, чтобы битые поля не роняли
195
+ // классификатор и не искажали сравнение.
196
+ const fallbackTriage = defaultNotifications().triage!;
197
+ const normalizedBefore = normalizeTriageSettings(beforeSettings, fallbackTriage);
198
+ const normalizedAfter = normalizeTriageSettings(afterSettings, fallbackTriage);
199
+
200
+ const [beforeDecision, afterDecision] = await Promise.all([
201
+ decideWithTimeout(input, normalizedBefore, timeoutMs),
202
+ decideWithTimeout(input, normalizedAfter, timeoutMs),
203
+ ]);
204
+
205
+ const before = toCompared(input, beforeDecision, baseMessage, dedupCount);
206
+ const after = toCompared(input, afterDecision, baseMessage, dedupCount);
207
+
208
+ return {
209
+ input,
210
+ before,
211
+ after,
212
+ diff: {
213
+ action: {
214
+ before: before.action,
215
+ after: after.action,
216
+ changed: changed(before.action, after.action),
217
+ },
218
+ source: {
219
+ before: before.source,
220
+ after: after.source,
221
+ changed: changed(before.source, after.source),
222
+ },
223
+ ruleId: {
224
+ before: before.ruleId ?? null,
225
+ after: after.ruleId ?? null,
226
+ changed: changed(before.ruleId ?? null, after.ruleId ?? null),
227
+ },
228
+ failure: {
229
+ before: before.failure ?? null,
230
+ after: after.failure ?? null,
231
+ changed: changed(before.failure ?? null, after.failure ?? null),
232
+ },
233
+ confidence: {
234
+ before: before.verdict?.confidence ?? null,
235
+ after: after.verdict?.confidence ?? null,
236
+ changed: changed(
237
+ before.verdict?.confidence ?? null,
238
+ after.verdict?.confidence ?? null
239
+ ),
240
+ },
241
+ category: {
242
+ before: before.verdict?.category ?? null,
243
+ after: after.verdict?.category ?? null,
244
+ changed: changed(
245
+ before.verdict?.category ?? null,
246
+ after.verdict?.category ?? null
247
+ ),
248
+ },
249
+ severity: {
250
+ before: before.verdict?.severity ?? null,
251
+ after: after.verdict?.severity ?? null,
252
+ changed: changed(
253
+ before.verdict?.severity ?? null,
254
+ after.verdict?.severity ?? null
255
+ ),
256
+ },
257
+ reason: {
258
+ before: before.verdict?.reason ?? null,
259
+ after: after.verdict?.reason ?? null,
260
+ changed: changed(
261
+ before.verdict?.reason ?? null,
262
+ after.verdict?.reason ?? null
263
+ ),
264
+ },
265
+ suppressed: {
266
+ before: before.suppressed,
267
+ after: after.suppressed,
268
+ changed: before.suppressed !== after.suppressed,
269
+ },
270
+ message: {
271
+ before: before.message,
272
+ after: after.message,
273
+ changed: before.message !== after.message,
274
+ },
275
+ },
276
+ };
277
+ }