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
@@ -74,6 +74,29 @@ export const DEFAULT_TRIAGE_RULES: readonly TriageRule[] = [
74
74
  priority: 100,
75
75
  reason: "В ошибке есть признак проблемы качества.",
76
76
  },
77
+ {
78
+ id: "cost-high",
79
+ field: "cost",
80
+ operator: "gte",
81
+ value: 1,
82
+ category: "unknown",
83
+ severity: "high",
84
+ confidence: 0.85,
85
+ priority: 90,
86
+ reason: "Стоимость запуска $1 и выше.",
87
+ },
88
+ {
89
+ id: "task-important",
90
+ field: "task",
91
+ operator: "regex",
92
+ value:
93
+ "deploy|release|publish|production|backup|restore|migrat|релиз|бэкап|миграц",
94
+ category: "unknown",
95
+ severity: "high",
96
+ confidence: 0.8,
97
+ priority: 80,
98
+ reason: "Важная задача: deploy, release, backup или миграция.",
99
+ },
77
100
  {
78
101
  id: "status-error",
79
102
  field: "status",
@@ -2,18 +2,25 @@ import type { TriageDecision } from "./triage-chain.js";
2
2
  import type { TriageInput } from "./triage.js";
3
3
  import type { TriageShadowSettings } from "../settings.js";
4
4
  import { isShadowActive } from "../settings.js";
5
+ import { readAuditLog, recordAudit } from "./audit.js";
6
+ import { getDb } from "../db/index.js";
5
7
 
6
8
  /**
7
- * Shadow-режим триажа (Спринт 30.6).
9
+ * Аудит решений триажа (Спринт 31.8).
8
10
  *
9
- * Решения триажа фиксируются в памяти, но уведомления не подавляются.
10
- * Ведётся счётчик «false-skip» — сколько раз триаж хотел бы подавить
11
- * уведомление (action === "skip"), и сколько уведомлений в сумме
12
- * прошли бы через shadow-фильтр.
11
+ * Раньше решения хранились в памяти процесса `record-history`, который
12
+ * завершается сразу после запуска, поэтому shadow-отчёт в реальной
13
+ * эксплуатации всегда был пуст. Теперь каждое решение пишется в persistent
14
+ * журнал `audit_log` (action = `triage.decision`), а shadow-отчёт читает его.
15
+ *
16
+ * Запись никогда не бросает исключение и не мешает доставке уведомления.
13
17
  */
14
18
 
15
- /** Одно зафиксированное shadow-решение. */
19
+ export const TRIAGE_AUDIT_ACTION = "triage.decision";
20
+
21
+ /** Одно сохранённое решение триажа. */
16
22
  export interface ShadowDecisionRecord {
23
+ id: number;
17
24
  taskName: string;
18
25
  status: string;
19
26
  action: "notify" | "skip";
@@ -22,40 +29,144 @@ export interface ShadowDecisionRecord {
22
29
  failure?: TriageDecision["failure"];
23
30
  confidence?: number;
24
31
  latencyMs: number;
32
+ attempts: number;
33
+ /** Решение принято в shadow-периоде и не применялось к доставке. */
34
+ shadow: boolean;
35
+ /** Уведомление было реально подавлено (action === "skip" вне shadow). */
36
+ suppressed: boolean;
37
+ category?: string;
38
+ severity?: string;
39
+ reason?: string;
40
+ /** Решение принято фоновым процессом уже после доставки (31.7). */
41
+ async?: boolean;
25
42
  ts: string;
26
43
  }
27
44
 
28
- /** Накопленные shadow-решения (в памяти, сбрасываются при перезапуске процесса). */
29
- const shadowDecisions: ShadowDecisionRecord[] = [];
45
+ export interface TriageOutcomeOptions {
46
+ /** Shadow-период активен: решение только фиксируется, но не применяется. */
47
+ shadowActive?: boolean;
48
+ /** Уведомление было подавлено по этому решению. */
49
+ suppressed?: boolean;
50
+ /** Решение принято фоновым процессом уже после доставки (31.7). */
51
+ async?: boolean;
52
+ }
53
+
54
+ const ERROR_TEXT_LIMIT = 1000;
55
+
56
+ function truncate(value: string | null | undefined): string | null {
57
+ if (value == null) return null;
58
+ const text = String(value);
59
+ return text.length > ERROR_TEXT_LIMIT
60
+ ? `${text.slice(0, ERROR_TEXT_LIMIT)}…`
61
+ : text;
62
+ }
63
+
64
+ function detailsOf(record: { details: unknown }): Record<string, any> {
65
+ return record.details && typeof record.details === "object"
66
+ ? (record.details as Record<string, any>)
67
+ : {};
68
+ }
30
69
 
31
70
  /**
32
- * Записывает shadow-решение. Не выбрасывает исключений.
71
+ * Записывает решение триажа в persistent-аудит.
72
+ *
73
+ * Вызывать для режимов `rules`, `llm` и `auto`; для `off` решения нет.
74
+ * Возвращает id записи или null, если журнал недоступен.
33
75
  */
76
+ export function recordTriageOutcome(
77
+ input: TriageInput,
78
+ decision: TriageDecision,
79
+ options: TriageOutcomeOptions = {}
80
+ ): number | null {
81
+ const shadow = Boolean(options.shadowActive);
82
+ const suppressed = Boolean(options.suppressed);
83
+ return recordAudit({
84
+ action: TRIAGE_AUDIT_ACTION,
85
+ targetType: "task",
86
+ target: input.taskName ?? "",
87
+ actor: "system",
88
+ source: "triage",
89
+ details: {
90
+ status: input.status ?? "",
91
+ action: decision.action,
92
+ source: decision.source,
93
+ ruleId: decision.ruleId ?? null,
94
+ failure: decision.failure ?? null,
95
+ confidence: decision.verdict?.confidence ?? null,
96
+ category: decision.verdict?.category ?? null,
97
+ severity: decision.verdict?.severity ?? null,
98
+ reason: decision.verdict?.reason ?? null,
99
+ latencyMs: decision.latencyMs,
100
+ attempts: decision.attempts,
101
+ shadow,
102
+ suppressed,
103
+ async: Boolean(options.async),
104
+ error: truncate(input.error),
105
+ durationMs: input.durationMs ?? null,
106
+ tokens: input.tokens ?? null,
107
+ costUsd: input.costUsd ?? null,
108
+ },
109
+ });
110
+ }
111
+
112
+ /** Обратная совместимость: запись shadow-решения без деталей доставки. */
34
113
  export function recordShadowDecision(
35
114
  input: TriageInput,
36
115
  decision: TriageDecision
37
116
  ): void {
38
- shadowDecisions.push({
39
- taskName: input.taskName ?? "",
40
- status: input.status ?? "",
41
- action: decision.action,
42
- source: decision.source,
43
- ruleId: decision.ruleId,
44
- failure: decision.failure,
45
- confidence: decision.verdict?.confidence,
46
- latencyMs: decision.latencyMs,
47
- ts: new Date().toISOString(),
117
+ recordTriageOutcome(input, decision, { shadowActive: true });
118
+ }
119
+
120
+ /**
121
+ * Читает решения триажа из аудита (новые сверху).
122
+ *
123
+ * `shadow` не фильтруется здесь: отчёт и тесты сами решают, нужны им только
124
+ * shadow-записи или все решения.
125
+ */
126
+ export function readTriageDecisions(
127
+ filter: { since?: string; until?: string; taskName?: string; limit?: number } = {}
128
+ ): ShadowDecisionRecord[] {
129
+ const result = readAuditLog({
130
+ action: TRIAGE_AUDIT_ACTION,
131
+ target: filter.taskName,
132
+ since: filter.since,
133
+ until: filter.until,
134
+ limit: filter.limit ?? 5000,
135
+ });
136
+ return result.records.map((record) => {
137
+ const details = detailsOf(record);
138
+ return {
139
+ id: record.id,
140
+ taskName: record.target ?? "",
141
+ status: String(details.status ?? ""),
142
+ action: details.action === "skip" ? "skip" : "notify",
143
+ source: (details.source ?? "off") as TriageDecision["source"],
144
+ ruleId: details.ruleId ?? undefined,
145
+ failure: details.failure ?? undefined,
146
+ confidence:
147
+ typeof details.confidence === "number" ? details.confidence : undefined,
148
+ latencyMs: Number(details.latencyMs) || 0,
149
+ attempts: Number(details.attempts) || 0,
150
+ shadow: details.shadow === true,
151
+ suppressed: details.suppressed === true,
152
+ category: details.category ?? undefined,
153
+ severity: details.severity ?? undefined,
154
+ reason: details.reason ?? undefined,
155
+ async: details.async === true,
156
+ ts: record.ts,
157
+ };
48
158
  });
49
159
  }
50
160
 
51
- /** Сколько раз триаж хотел подавить уведомление (action === "skip"). */
161
+ /** Сколько раз триаж хотел подавить уведомление в shadow-периоде. */
52
162
  export function shadowSkipCount(): number {
53
- return shadowDecisions.filter((d) => d.action === "skip").length;
163
+ return readTriageDecisions().filter((d) => d.shadow && d.action === "skip")
164
+ .length;
54
165
  }
55
166
 
56
167
  /** Сколько уведомлений всего прошло через shadow-фильтр. */
57
168
  export function shadowTotalCount(): number {
58
- return shadowDecisions.length;
169
+ return readTriageDecisions().filter((d) => d.shadow).length;
59
170
  }
60
171
 
61
172
  /** Полный отчёт по shadow-режиму. */
@@ -68,29 +179,62 @@ export interface ShadowReport {
68
179
  wouldSuppress: number; // === skips (потенциально подавленные уведомления)
69
180
  bySource: Record<string, number>;
70
181
  decisions: ShadowDecisionRecord[];
182
+ /** Записей больше лимита чтения — статистика неполная. */
183
+ truncated: boolean;
71
184
  }
72
185
 
73
- /** Сформировать отчёт. */
186
+ /** Сформировать отчёт по persistent-журналу за текущий/прошлый период. */
74
187
  export function shadowReport(
75
188
  shadow: TriageShadowSettings | undefined
76
189
  ): ShadowReport {
190
+ const startedAt = shadow?.startedAt ?? null;
191
+ const days = shadow?.days ?? 0;
192
+ const until =
193
+ startedAt && days > 0
194
+ ? new Date(
195
+ new Date(startedAt).getTime() + days * 24 * 60 * 60 * 1000
196
+ ).toISOString()
197
+ : undefined;
198
+
199
+ const records = readTriageDecisions({
200
+ since: startedAt ?? undefined,
201
+ until,
202
+ limit: 5000,
203
+ }).filter((d) => d.shadow);
204
+
77
205
  const bySource: Record<string, number> = {};
78
- for (const d of shadowDecisions) {
206
+ for (const d of records) {
79
207
  bySource[d.source] = (bySource[d.source] ?? 0) + 1;
80
208
  }
209
+ const skips = records.filter((d) => d.action === "skip").length;
210
+
81
211
  return {
82
212
  active: isShadowActive(shadow),
83
- startedAt: shadow?.startedAt ?? null,
84
- days: shadow?.days ?? 0,
85
- total: shadowTotalCount(),
86
- skips: shadowSkipCount(),
87
- wouldSuppress: shadowSkipCount(),
213
+ startedAt,
214
+ days,
215
+ total: records.length,
216
+ skips,
217
+ wouldSuppress: skips,
88
218
  bySource,
89
- decisions: [...shadowDecisions],
219
+ decisions: records,
220
+ truncated: records.length >= 5000,
90
221
  };
91
222
  }
92
223
 
93
- /** Очистить накопленные shadow-решения (для тестов и сброса отчёта). */
224
+ /**
225
+ * Очищает только shadow-записи триажа. Обычный аудит решений (не shadow)
226
+ * остаётся, чтобы сброс отчёта не уничтожал историю эксплуатации.
227
+ */
94
228
  export function resetShadowDecisions(): void {
95
- shadowDecisions.length = 0;
229
+ try {
230
+ getDb()
231
+ .prepare(
232
+ `DELETE FROM audit_log
233
+ WHERE action = ?
234
+ AND json_extract(details_json, '$.shadow') = 1`
235
+ )
236
+ .run(TRIAGE_AUDIT_ACTION);
237
+ } catch {
238
+ // JSON1 недоступен или журнал ещё не создан — сбрасывать нечего.
239
+ }
96
240
  }
@@ -0,0 +1,344 @@
1
+ import fs from "node:fs";
2
+ import os from "node:os";
3
+ import path from "node:path";
4
+ import { randomUUID } from "node:crypto";
5
+ import { spawn } from "node:child_process";
6
+ import { fileURLToPath, pathToFileURL } from "node:url";
7
+ import { decideTriage, type TriageDecision } from "./triage-chain.js";
8
+ import { recordTriageOutcome } from "./triage-shadow.js";
9
+ import { isShadowActive, type TriageSettings } from "../settings.js";
10
+ import { redactSecretsInText } from "./secrets.js";
11
+ import { closeDb } from "../db/index.js";
12
+ import type { TriageInput } from "./triage.js";
13
+
14
+ /**
15
+ * Асинхронный триаж (Спринт 31.7).
16
+ *
17
+ * `record-history` — короткоживущий процесс: ждать в нём локальную модель
18
+ * 20–45 секунд нельзя, это задерживает уведомление, цепочки и снятие блокировки.
19
+ * Поэтому для режимов `llm`/`auto` уведомление доставляется сразу, а вердикт
20
+ * считается отдельным detached-процессом и пишется в persistent-аудит.
21
+ *
22
+ * В режиме `rules` триаж остаётся синхронным: правила должны успеть подавить
23
+ * уведомление до доставки.
24
+ */
25
+
26
+ export const TRIAGE_WORKER_FLAG = "--triage";
27
+
28
+ const JOB_PREFIX = "opencode-scheduler-triage-";
29
+ const ERROR_TEXT_LIMIT = 4000;
30
+ /** Сколько триаж-процессов может работать одновременно (защита Ollama). */
31
+ const MAX_CONCURRENT_WORKERS = 2;
32
+ /** Задание/слот старше этого возраста считается мусором. */
33
+ const STALE_TRIAGE_MS = 60 * 60 * 1000;
34
+ /** Сколько чужих заданий один воркер разбирает за запуск (дренаж очереди). */
35
+ const MAX_JOBS_PER_WORKER = 20;
36
+
37
+ /** Удаляет старые файлы заданий и зависшие слоты из временного каталога. */
38
+ export function pruneTriageArtifacts(dir: string, now = Date.now()): number {
39
+ let removed = 0;
40
+ let entries: string[];
41
+ try {
42
+ entries = fs.readdirSync(dir);
43
+ } catch {
44
+ return 0;
45
+ }
46
+ for (const entry of entries) {
47
+ if (!entry.startsWith(JOB_PREFIX)) continue;
48
+ if (!/\.(json|lock)$/.test(entry)) continue;
49
+ const full = path.join(dir, entry);
50
+ try {
51
+ const stat = fs.statSync(full);
52
+ if (now - stat.mtimeMs > STALE_TRIAGE_MS) {
53
+ fs.rmSync(full, { force: true });
54
+ removed += 1;
55
+ }
56
+ } catch {
57
+ // Файл уже удалён другим процессом.
58
+ }
59
+ }
60
+ return removed;
61
+ }
62
+
63
+ function processAlive(pid: number): boolean {
64
+ if (!Number.isInteger(pid) || pid <= 0) return false;
65
+ try {
66
+ process.kill(pid, 0);
67
+ return true;
68
+ } catch (err: any) {
69
+ return err?.code === "EPERM";
70
+ }
71
+ }
72
+
73
+ /**
74
+ * Пытается занять один из слотов воркера. Слот — файл с PID; слот мёртвого
75
+ * процесса переиспользуется. Возвращает путь к слоту или null.
76
+ */
77
+ function acquireWorkerSlot(dir: string): string | null {
78
+ for (let i = 0; i < MAX_CONCURRENT_WORKERS; i += 1) {
79
+ const slot = path.join(dir, `${JOB_PREFIX}slot-${i}.lock`);
80
+ try {
81
+ const fd = fs.openSync(slot, "wx", 0o600);
82
+ fs.writeFileSync(fd, String(process.pid));
83
+ fs.closeSync(fd);
84
+ return slot;
85
+ } catch (err: any) {
86
+ if (err?.code !== "EEXIST") continue;
87
+ let holder = 0;
88
+ try {
89
+ holder = parseInt(fs.readFileSync(slot, "utf8").trim(), 10);
90
+ } catch {
91
+ holder = 0;
92
+ }
93
+ if (!processAlive(holder)) {
94
+ try {
95
+ fs.rmSync(slot, { force: true });
96
+ const fd = fs.openSync(slot, "wx", 0o600);
97
+ fs.writeFileSync(fd, String(process.pid));
98
+ fs.closeSync(fd);
99
+ return slot;
100
+ } catch {
101
+ // Слот перехвачен другим процессом — пробуем следующий.
102
+ }
103
+ }
104
+ }
105
+ }
106
+ return null;
107
+ }
108
+
109
+ function releaseWorkerSlot(slot: string | null): void {
110
+ if (!slot) return;
111
+ try {
112
+ fs.rmSync(slot, { force: true });
113
+ } catch {
114
+ // Слот уже удалён.
115
+ }
116
+ }
117
+
118
+ /** Следующий файл задания в каталоге (для дренажа очереди). */
119
+ function nextPendingJob(dir: string, exclude: string): string | undefined {
120
+ try {
121
+ const candidates = fs
122
+ .readdirSync(dir)
123
+ .filter((entry) => entry.startsWith(JOB_PREFIX) && entry.endsWith(".json"))
124
+ .map((entry) => path.join(dir, entry))
125
+ .filter((file) => file !== exclude)
126
+ .map((file) => {
127
+ try {
128
+ return { file, mtime: fs.statSync(file).mtimeMs };
129
+ } catch {
130
+ return null;
131
+ }
132
+ })
133
+ .filter((item): item is { file: string; mtime: number } => item !== null)
134
+ .sort((a, b) => a.mtime - b.mtime);
135
+ return candidates[0]?.file;
136
+ } catch {
137
+ return undefined;
138
+ }
139
+ }
140
+
141
+ /** Снимок данных, который передаётся фоновому процессу. */
142
+ export interface TriageJobPayload {
143
+ version: 1;
144
+ createdAt: string;
145
+ input: TriageInput;
146
+ triage: TriageSettings;
147
+ shadowActive: boolean;
148
+ }
149
+
150
+ function sanitizeInput(input: TriageInput): TriageInput {
151
+ const error = input.error ? redactSecretsInText(input.error) : input.error;
152
+ return {
153
+ ...input,
154
+ error:
155
+ typeof error === "string" && error.length > ERROR_TEXT_LIMIT
156
+ ? `${error.slice(0, ERROR_TEXT_LIMIT)}…`
157
+ : error,
158
+ };
159
+ }
160
+
161
+ function safeUnlink(file: string | undefined): void {
162
+ if (!file) return;
163
+ try {
164
+ fs.unlinkSync(file);
165
+ } catch {
166
+ // Файл уже удалён или недоступен — это не ошибка фонового триажа.
167
+ }
168
+ }
169
+
170
+ /** Записывает задание для фонового процесса и возвращает путь к файлу. */
171
+ export function writeTriageJob(
172
+ input: TriageInput,
173
+ triage: TriageSettings,
174
+ options: { tmpDir?: string } = {}
175
+ ): string {
176
+ const payload: TriageJobPayload = {
177
+ version: 1,
178
+ createdAt: new Date().toISOString(),
179
+ input: sanitizeInput(input),
180
+ triage,
181
+ shadowActive: isShadowActive(triage.shadow),
182
+ };
183
+ const dir = options.tmpDir ?? os.tmpdir();
184
+ const file = path.join(dir, `${JOB_PREFIX}${randomUUID()}.json`);
185
+ fs.writeFileSync(file, JSON.stringify(payload), { encoding: "utf8", mode: 0o600 });
186
+ return file;
187
+ }
188
+
189
+ /** Читает и валидирует задание. Бросает исключение только при битом файле. */
190
+ export function readTriageJob(file: string): TriageJobPayload {
191
+ const raw = JSON.parse(fs.readFileSync(file, "utf8")) as Partial<TriageJobPayload>;
192
+ if (raw.version !== 1) throw new Error("unsupported triage job version");
193
+ if (!raw.input || typeof raw.input.taskName !== "string") {
194
+ throw new Error("invalid triage job input");
195
+ }
196
+ if (!raw.triage || typeof raw.triage.mode !== "string") {
197
+ throw new Error("invalid triage job settings");
198
+ }
199
+ return {
200
+ version: 1,
201
+ createdAt: typeof raw.createdAt === "string" ? raw.createdAt : "",
202
+ input: raw.input,
203
+ triage: raw.triage,
204
+ shadowActive: raw.shadowActive === true,
205
+ };
206
+ }
207
+
208
+ /**
209
+ * Выполняет задание: классифицирует событие и пишет решение в аудит.
210
+ *
211
+ * Возвращает `null`, если триаж выключен или задание не требует решения.
212
+ * Файл задания удаляет вызывающая сторона (CLI делает это в `finally`).
213
+ */
214
+ export async function runTriageJob(file: string): Promise<TriageDecision | null> {
215
+ const job = readTriageJob(file);
216
+ if (job.triage.mode === "off") return null;
217
+
218
+ const decision = await decideTriage(job.input, job.triage);
219
+ recordTriageOutcome(job.input, decision, {
220
+ shadowActive: job.shadowActive,
221
+ suppressed: false,
222
+ async: true,
223
+ });
224
+ return decision;
225
+ }
226
+
227
+ export interface ScheduleTriageOptions {
228
+ tmpDir?: string;
229
+ env?: NodeJS.ProcessEnv;
230
+ /** Для тестов: подменить spawn и не запускать реальный процесс. */
231
+ spawnFn?: typeof spawn;
232
+ }
233
+
234
+ /**
235
+ * Запускает detached-процесс триажа. Никогда не бросает исключение:
236
+ * уведомление уже доставлено, и сбой фонового аудита не должен его ломать.
237
+ */
238
+ export function scheduleTriageJob(
239
+ input: TriageInput,
240
+ triage: TriageSettings,
241
+ options: ScheduleTriageOptions = {}
242
+ ): { scheduled: boolean; file?: string; error?: string } {
243
+ let file: string | undefined;
244
+ try {
245
+ const dir = options.tmpDir ?? os.tmpdir();
246
+ pruneTriageArtifacts(dir);
247
+ file = writeTriageJob(input, triage, { tmpDir: dir });
248
+ } catch (err: any) {
249
+ return {
250
+ scheduled: false,
251
+ error: err instanceof Error ? err.message : String(err),
252
+ };
253
+ }
254
+
255
+ try {
256
+ const child = (options.spawnFn ?? spawn)(
257
+ process.execPath,
258
+ [fileURLToPath(import.meta.url), TRIAGE_WORKER_FLAG, file],
259
+ {
260
+ detached: true,
261
+ stdio: "ignore",
262
+ windowsHide: true,
263
+ env: options.env ?? process.env,
264
+ }
265
+ );
266
+ child.unref();
267
+ // Если процесс не стартовал, файл задания останется сиротой — убираем.
268
+ child.on?.("error", () => safeUnlink(file));
269
+ return { scheduled: true, file };
270
+ } catch (err: any) {
271
+ safeUnlink(file);
272
+ return {
273
+ scheduled: false,
274
+ file,
275
+ error: err instanceof Error ? err.message : String(err),
276
+ };
277
+ }
278
+ }
279
+
280
+ async function main(): Promise<void> {
281
+ const index = process.argv.indexOf(TRIAGE_WORKER_FLAG);
282
+ const file = index >= 0 ? process.argv[index + 1] : undefined;
283
+ if (!file) {
284
+ console.error("[windows-scheduler] triage worker: не указан файл задания");
285
+ process.exitCode = 1;
286
+ return;
287
+ }
288
+
289
+ const dir = path.dirname(file);
290
+ // Ограничиваем параллелизм: залп матрицы не должен поднимать N процессов
291
+ // и N запросов к Ollama. Не занявший слот воркер оставляет задание в
292
+ // очереди — его подберёт воркер, который освободится (см. drainQueue).
293
+ const slot = acquireWorkerSlot(dir);
294
+ if (!slot) {
295
+ return;
296
+ }
297
+
298
+ try {
299
+ await drainQueue(file);
300
+ } finally {
301
+ releaseWorkerSlot(slot);
302
+ try {
303
+ closeDb();
304
+ } catch {
305
+ // Процесс завершается — закрывать нечего.
306
+ }
307
+ }
308
+ }
309
+
310
+ /** Обрабатывает своё задание и до MAX_JOBS_PER_WORKER чужих из очереди. */
311
+ async function drainQueue(first: string): Promise<void> {
312
+ let current: string | undefined = first;
313
+ const dir = path.dirname(first);
314
+ for (let processed = 0; current && processed < MAX_JOBS_PER_WORKER; processed += 1) {
315
+ const file: string = current;
316
+ try {
317
+ await runTriageJob(file);
318
+ } catch (err: any) {
319
+ console.error(
320
+ `[windows-scheduler] triage worker: ${
321
+ err instanceof Error ? err.message : String(err)
322
+ }`
323
+ );
324
+ process.exitCode = 1;
325
+ } finally {
326
+ safeUnlink(file);
327
+ }
328
+ current = nextPendingJob(dir, file);
329
+ }
330
+ }
331
+
332
+ function isDirectInvocation(): boolean {
333
+ const entry = process.argv[1];
334
+ if (!entry) return false;
335
+ try {
336
+ return pathToFileURL(entry).href.toLowerCase() === import.meta.url.toLowerCase();
337
+ } catch {
338
+ return false;
339
+ }
340
+ }
341
+
342
+ if (isDirectInvocation()) {
343
+ void main();
344
+ }
@@ -253,7 +253,7 @@ export async function classifyNotification(
253
253
  const timeoutMs =
254
254
  Number.isFinite(settings.timeoutMs) && settings.timeoutMs > 0
255
255
  ? Math.floor(settings.timeoutMs)
256
- : 45_000;
256
+ : 60_000;
257
257
  const maxAttempts = Math.max(1, 1 + Math.max(0, options.retries ?? 1));
258
258
  const retryDelayMs = Math.max(0, options.retryDelayMs ?? 300);
259
259