opencode-windows-scheduler 1.5.2 → 1.5.5

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (231) hide show
  1. package/CHANGELOG.md +107 -2
  2. package/CROSS_PLATFORM.md +107 -71
  3. package/LICENSE +21 -21
  4. package/README.md +74 -26
  5. package/ROADMAP-STRATEGY.md +11 -4
  6. package/ROADMAP.md +322 -112
  7. package/dist/core/analytics.d.ts +3 -0
  8. package/dist/core/analytics.d.ts.map +1 -1
  9. package/dist/core/analytics.js +4 -0
  10. package/dist/core/audit.d.ts +2 -1
  11. package/dist/core/audit.d.ts.map +1 -1
  12. package/dist/core/audit.js +32 -1
  13. package/dist/core/cron-to-schtasks.d.ts.map +1 -1
  14. package/dist/core/cron-to-schtasks.js +21 -4
  15. package/dist/core/file-watcher.d.ts.map +1 -1
  16. package/dist/core/file-watcher.js +16 -1
  17. package/dist/core/git-trigger.d.ts +4 -2
  18. package/dist/core/git-trigger.d.ts.map +1 -1
  19. package/dist/core/git-trigger.js +34 -16
  20. package/dist/core/local-ai.d.ts +52 -0
  21. package/dist/core/local-ai.d.ts.map +1 -0
  22. package/dist/core/local-ai.js +119 -0
  23. package/dist/core/lock.d.ts +14 -0
  24. package/dist/core/lock.d.ts.map +1 -1
  25. package/dist/core/lock.js +81 -4
  26. package/dist/core/matrix.d.ts.map +1 -1
  27. package/dist/core/matrix.js +3 -2
  28. package/dist/core/native-notify.d.ts.map +1 -1
  29. package/dist/core/native-notify.js +3 -0
  30. package/dist/core/one-shot.d.ts +7 -1
  31. package/dist/core/one-shot.d.ts.map +1 -1
  32. package/dist/core/one-shot.js +15 -2
  33. package/dist/core/permissions.d.ts +69 -0
  34. package/dist/core/permissions.d.ts.map +1 -0
  35. package/dist/core/permissions.js +143 -0
  36. package/dist/core/ps-wrapper.d.ts +9 -30
  37. package/dist/core/ps-wrapper.d.ts.map +1 -1
  38. package/dist/core/ps-wrapper.js +477 -108
  39. package/dist/core/record-history.d.ts +11 -0
  40. package/dist/core/record-history.d.ts.map +1 -1
  41. package/dist/core/record-history.js +106 -4
  42. package/dist/core/savings.d.ts +70 -0
  43. package/dist/core/savings.d.ts.map +1 -0
  44. package/dist/core/savings.js +87 -0
  45. package/dist/core/schedule-gate.js +7 -3
  46. package/dist/core/schedule-v2.js +1 -1
  47. package/dist/core/scheduler/index.d.ts +13 -1
  48. package/dist/core/scheduler/index.d.ts.map +1 -1
  49. package/dist/core/scheduler/index.js +35 -4
  50. package/dist/core/scheduler/linux.d.ts +4 -1
  51. package/dist/core/scheduler/linux.d.ts.map +1 -1
  52. package/dist/core/scheduler/linux.js +53 -20
  53. package/dist/core/scheduler/mac.d.ts +2 -1
  54. package/dist/core/scheduler/mac.d.ts.map +1 -1
  55. package/dist/core/scheduler/mac.js +24 -6
  56. package/dist/core/scheduler/posix.d.ts +1 -1
  57. package/dist/core/scheduler/posix.d.ts.map +1 -1
  58. package/dist/core/scheduler/posix.js +2 -2
  59. package/dist/core/scheduler/registry.d.ts +3 -2
  60. package/dist/core/scheduler/registry.d.ts.map +1 -1
  61. package/dist/core/scheduler/registry.js +6 -5
  62. package/dist/core/scheduler/windows.d.ts +49 -1
  63. package/dist/core/scheduler/windows.d.ts.map +1 -1
  64. package/dist/core/scheduler/windows.js +219 -34
  65. package/dist/core/secrets.d.ts +5 -3
  66. package/dist/core/secrets.d.ts.map +1 -1
  67. package/dist/core/secrets.js +86 -8
  68. package/dist/core/self-analysis.d.ts +117 -0
  69. package/dist/core/self-analysis.d.ts.map +1 -0
  70. package/dist/core/self-analysis.js +539 -0
  71. package/dist/core/session.d.ts +11 -3
  72. package/dist/core/session.d.ts.map +1 -1
  73. package/dist/core/session.js +34 -5
  74. package/dist/core/shutdown.d.ts +26 -0
  75. package/dist/core/shutdown.d.ts.map +1 -0
  76. package/dist/core/shutdown.js +49 -0
  77. package/dist/core/summary.d.ts +69 -0
  78. package/dist/core/summary.d.ts.map +1 -0
  79. package/dist/core/summary.js +250 -0
  80. package/dist/core/telegram.d.ts +10 -0
  81. package/dist/core/telegram.d.ts.map +1 -1
  82. package/dist/core/telegram.js +228 -47
  83. package/dist/core/triage-chain.d.ts +40 -0
  84. package/dist/core/triage-chain.d.ts.map +1 -0
  85. package/dist/core/triage-chain.js +80 -0
  86. package/dist/core/triage-compare.d.ts +68 -0
  87. package/dist/core/triage-compare.d.ts.map +1 -0
  88. package/dist/core/triage-compare.js +184 -0
  89. package/dist/core/triage-rules.d.ts +23 -0
  90. package/dist/core/triage-rules.d.ts.map +1 -0
  91. package/dist/core/triage-rules.js +196 -0
  92. package/dist/core/triage-shadow.d.ts +91 -0
  93. package/dist/core/triage-shadow.d.ts.map +1 -0
  94. package/dist/core/triage-shadow.js +160 -0
  95. package/dist/core/triage-worker.d.ts +55 -0
  96. package/dist/core/triage-worker.d.ts.map +1 -0
  97. package/dist/core/triage-worker.js +314 -0
  98. package/dist/core/triage.d.ts +76 -0
  99. package/dist/core/triage.d.ts.map +1 -0
  100. package/dist/core/triage.js +271 -0
  101. package/dist/core/watch-paths.d.ts +6 -0
  102. package/dist/core/watch-paths.d.ts.map +1 -0
  103. package/dist/core/watch-paths.js +62 -0
  104. package/dist/core/wrappers/bash.d.ts +15 -3
  105. package/dist/core/wrappers/bash.d.ts.map +1 -1
  106. package/dist/core/wrappers/bash.js +153 -120
  107. package/dist/db/history-repo.d.ts +1 -1
  108. package/dist/db/history-repo.d.ts.map +1 -1
  109. package/dist/db/history-repo.js +29 -14
  110. package/dist/db/schema.d.ts +1 -1
  111. package/dist/db/schema.d.ts.map +1 -1
  112. package/dist/db/schema.js +31 -0
  113. package/dist/history.d.ts +2 -2
  114. package/dist/history.d.ts.map +1 -1
  115. package/dist/history.js +3 -3
  116. package/dist/i18n.d.ts +25 -2
  117. package/dist/i18n.d.ts.map +1 -1
  118. package/dist/i18n.js +75 -10
  119. package/dist/index.d.ts +66 -3
  120. package/dist/index.d.ts.map +1 -1
  121. package/dist/index.js +527 -68
  122. package/dist/integrations.d.ts +9 -1
  123. package/dist/integrations.d.ts.map +1 -1
  124. package/dist/integrations.js +34 -6
  125. package/dist/notifications.d.ts +30 -2
  126. package/dist/notifications.d.ts.map +1 -1
  127. package/dist/notifications.js +289 -10
  128. package/dist/profiles.d.ts +1 -1
  129. package/dist/profiles.d.ts.map +1 -1
  130. package/dist/profiles.js +21 -3
  131. package/dist/rpc.d.ts +401 -5
  132. package/dist/rpc.d.ts.map +1 -1
  133. package/dist/rpc.js +138 -5
  134. package/dist/server.d.ts +20 -0
  135. package/dist/server.d.ts.map +1 -1
  136. package/dist/server.js +136 -14
  137. package/dist/settings.d.ts +167 -3
  138. package/dist/settings.d.ts.map +1 -1
  139. package/dist/settings.js +322 -3
  140. package/dist/task-transfer.d.ts +8 -1
  141. package/dist/task-transfer.d.ts.map +1 -1
  142. package/dist/task-transfer.js +2 -2
  143. package/dist/types.d.ts +8 -1
  144. package/dist/types.d.ts.map +1 -1
  145. package/dist/types.js +23 -5
  146. package/dist/workspaces.d.ts +9 -0
  147. package/dist/workspaces.d.ts.map +1 -1
  148. package/dist/workspaces.js +25 -0
  149. package/docs/ARCHITECTURE.md +48 -28
  150. package/docs/CONCEPT.md +230 -0
  151. package/docs/CROSS_PLATFORM.ru.md +150 -0
  152. package/docs/CROSS_PLATFORM.zh.md +146 -0
  153. package/docs/FAQ.md +52 -0
  154. package/docs/FAQ.ru.md +53 -0
  155. package/docs/FAQ.zh.md +43 -0
  156. package/docs/FEATURES.md +141 -44
  157. package/docs/FEATURES.zh.md +655 -0
  158. package/docs/LOCAL-AI.md +300 -0
  159. package/docs/MIGRATION.md +17 -0
  160. package/docs/README.ru.md +22 -16
  161. package/docs/README.zh.md +286 -0
  162. package/docs/SAVINGS.md +61 -0
  163. package/docs/SAVINGS.ru.md +60 -0
  164. package/docs/SAVINGS.zh.md +52 -0
  165. package/docs/ZH-LOCALE-PLAN.md +324 -0
  166. package/docs/spikes/local-model-structured-output.md +81 -0
  167. package/docs/spikes/ollama-qwen3-4b-smoke.json +28 -0
  168. package/docs/spikes/ollama-qwen3-4b.json +163 -0
  169. package/gui-experimental.cjs +8 -8
  170. package/locales/en.json +85 -0
  171. package/locales/ru.json +85 -0
  172. package/locales/zh.json +780 -0
  173. package/package.json +31 -7
  174. package/scripts/bench-local.mjs +321 -0
  175. package/scripts/check-zh-locale.mjs +218 -0
  176. package/scripts/run-tests.mjs +236 -0
  177. package/scripts/spike-local-structured.mjs +182 -0
  178. package/scripts/test-locale.mjs +4 -3
  179. package/skills/scheduled-job-best-practices/SKILL.md +6 -3
  180. package/skills/scheduled-job-best-practices/references/recipes.md +40 -0
  181. package/src/core/analytics.ts +10 -0
  182. package/src/core/audit.ts +39 -1
  183. package/src/core/cron-to-schtasks.ts +23 -4
  184. package/src/core/file-watcher.ts +20 -1
  185. package/src/core/git-trigger.ts +34 -16
  186. package/src/core/local-ai.ts +173 -0
  187. package/src/core/lock.ts +88 -3
  188. package/src/core/matrix.ts +5 -1
  189. package/src/core/native-notify.ts +3 -0
  190. package/src/core/one-shot.ts +18 -2
  191. package/src/core/permissions.ts +200 -0
  192. package/src/core/ps-wrapper.ts +492 -108
  193. package/src/core/record-history.ts +111 -4
  194. package/src/core/savings.ts +150 -0
  195. package/src/core/schedule-gate.ts +9 -3
  196. package/src/core/schedule-v2.ts +1 -1
  197. package/src/core/scheduler/index.ts +41 -3
  198. package/src/core/scheduler/linux.ts +67 -22
  199. package/src/core/scheduler/mac.ts +24 -7
  200. package/src/core/scheduler/posix.ts +2 -2
  201. package/src/core/scheduler/registry.ts +7 -5
  202. package/src/core/scheduler/windows.ts +237 -32
  203. package/src/core/secrets.ts +101 -7
  204. package/src/core/self-analysis.ts +744 -0
  205. package/src/core/session.ts +40 -5
  206. package/src/core/shutdown.ts +69 -0
  207. package/src/core/summary.ts +318 -0
  208. package/src/core/telegram.ts +266 -55
  209. package/src/core/triage-chain.ts +125 -0
  210. package/src/core/triage-compare.ts +277 -0
  211. package/src/core/triage-rules.ts +238 -0
  212. package/src/core/triage-shadow.ts +240 -0
  213. package/src/core/triage-worker.ts +344 -0
  214. package/src/core/triage.ts +366 -0
  215. package/src/core/watch-paths.ts +70 -0
  216. package/src/core/wrappers/bash.ts +181 -138
  217. package/src/db/history-repo.ts +31 -18
  218. package/src/db/schema.ts +31 -0
  219. package/src/gui.tsx +551 -14
  220. package/src/history.ts +7 -3
  221. package/src/i18n.ts +87 -13
  222. package/src/index.ts +649 -71
  223. package/src/integrations.ts +50 -6
  224. package/src/notifications.ts +468 -5
  225. package/src/profiles.ts +21 -3
  226. package/src/rpc.ts +143 -5
  227. package/src/server.ts +135 -16
  228. package/src/settings.ts +582 -5
  229. package/src/task-transfer.ts +10 -3
  230. package/src/types.ts +24 -5
  231. package/src/workspaces.ts +22 -0
@@ -0,0 +1,539 @@
1
+ /**
2
+ * Система самоанализа для планировщика OpenCode (Спринт 32).
3
+ *
4
+ * Анализирует здоровье системы, выявляет аномалии, тренды и генерирует
5
+ * рекомендации по оптимизации на основе исторических данных.
6
+ */
7
+ import { buildAnalytics, } from "./analytics.js";
8
+ // ==================== Health Score ====================
9
+ /** Рассчитывает общий балл здоровья системы. */
10
+ export function calculateHealthScore(report) {
11
+ const { totals, tasks, errors } = report;
12
+ // Компоненты здоровья (0-100)
13
+ const successRateScore = totals.successRate;
14
+ const errorRateScore = Math.max(0, 100 - (totals.error / Math.max(1, totals.total)) * 100);
15
+ const avgDurationScore = Math.min(100, Math.max(0, 100 - (totals.avgDurationMs / 300000) * 100)); // 5 минут = 0 баллов
16
+ const timeoutRateScore = Math.min(100, Math.max(0, 100 - (errors.filter(e => e.message.includes('timeout')).length / Math.max(1, totals.total)) * 100));
17
+ const crashRecoveryRateScore = Math.min(100, Math.max(0, 100 - (errors.filter(e => e.message.includes('Прервано')).length / Math.max(1, totals.total)) * 100));
18
+ // Взвешенная сумма
19
+ const score = Math.round(successRateScore * 0.35 +
20
+ errorRateScore * 0.25 +
21
+ avgDurationScore * 0.20 +
22
+ timeoutRateScore * 0.10 +
23
+ crashRecoveryRateScore * 0.10);
24
+ // Уровень здоровья
25
+ let level;
26
+ if (score >= 90)
27
+ level = "excellent";
28
+ else if (score >= 75)
29
+ level = "good";
30
+ else if (score >= 60)
31
+ level = "fair";
32
+ else if (score >= 40)
33
+ level = "poor";
34
+ else
35
+ level = "critical";
36
+ // Рекомендации
37
+ const recommendations = [];
38
+ if (successRateScore < 80) {
39
+ recommendations.push("Повысьте успешность запусков: проверьте Quality Gate и логи ошибок");
40
+ }
41
+ if (errorRateScore < 80) {
42
+ recommendations.push("Снизьте частоту ошибок: добавьте retryCount для флакких задач");
43
+ }
44
+ if (avgDurationScore < 70) {
45
+ recommendations.push("Оптимизируйте длительность: разбейте длинные задачи или увеличьте timeoutSeconds");
46
+ }
47
+ if (timeoutRateScore < 80) {
48
+ recommendations.push("Уменьшите количество таймаутов: увеличьте timeoutSeconds или упростите промпты");
49
+ }
50
+ if (crashRecoveryRateScore < 90) {
51
+ recommendations.push("Снизьте количество прерванных запусков: проверьте стабильность системы");
52
+ }
53
+ return {
54
+ score,
55
+ level,
56
+ components: {
57
+ successRate: successRateScore,
58
+ errorRate: errorRateScore,
59
+ avgDurationMs: avgDurationScore,
60
+ timeoutRate: timeoutRateScore,
61
+ crashRecoveryRate: crashRecoveryRateScore,
62
+ },
63
+ recommendations,
64
+ };
65
+ }
66
+ // ==================== Anomaly Detection ====================
67
+ /** Обнаруживает аномалии в данных. */
68
+ export function detectAnomalies(records, options = {}) {
69
+ const anomalies = [];
70
+ const now = options.now ?? new Date();
71
+ const windowDays = options.days ?? 14;
72
+ // Группируем записи по задачам
73
+ const byTask = new Map();
74
+ for (const record of records) {
75
+ const key = record.taskName.toLowerCase();
76
+ if (!byTask.has(key))
77
+ byTask.set(key, []);
78
+ byTask.get(key).push(record);
79
+ }
80
+ for (const [taskKey, taskRecords] of byTask) {
81
+ const taskName = taskRecords[0]?.taskName || taskKey;
82
+ // 1. Всплеск ошибок
83
+ const errorSpike = detectErrorSpike(taskRecords, windowDays);
84
+ if (errorSpike)
85
+ anomalies.push(errorSpike);
86
+ // 2. Всплеск длительности
87
+ const durationSpike = detectDurationSpike(taskRecords);
88
+ if (durationSpike)
89
+ anomalies.push(durationSpike);
90
+ // 3. Всплеск таймаутов
91
+ const timeoutSpike = detectTimeoutSpike(taskRecords);
92
+ if (timeoutSpike)
93
+ anomalies.push(timeoutSpike);
94
+ // 4. Всплеск стоимости
95
+ const costSpike = detectCostSpike(taskRecords);
96
+ if (costSpike)
97
+ anomalies.push(costSpike);
98
+ // 5. Необычные паттерны
99
+ const unusualPattern = detectUnusualPattern(taskRecords);
100
+ if (unusualPattern)
101
+ anomalies.push(unusualPattern);
102
+ // 6. Зависшие запуски
103
+ const stalledRun = detectStalledRun(taskRecords, now);
104
+ if (stalledRun)
105
+ anomalies.push(stalledRun);
106
+ }
107
+ return anomalies;
108
+ }
109
+ function detectErrorSpike(records, windowDays) {
110
+ if (records.length < 5)
111
+ return null;
112
+ const half = Math.floor(records.length / 2);
113
+ const older = records.slice(half);
114
+ const recent = records.slice(0, half);
115
+ const recentErrorRate = recent.filter(r => r.status === 'error').length / recent.length;
116
+ const olderErrorRate = older.filter(r => r.status === 'error').length / older.length;
117
+ // Всплеск ошибок: недавний период значительно хуже старого
118
+ if (olderErrorRate < 0.5 && recentErrorRate > olderErrorRate * 2 && recentErrorRate > 0.3) {
119
+ return {
120
+ type: "error_spike",
121
+ severity: Math.min(100, Math.round((recentErrorRate - olderErrorRate) * 100)),
122
+ description: `Всплеск ошибок: ${Math.round(recentErrorRate * 100)}% vs ${Math.round(olderErrorRate * 100)}% (старые данные)`,
123
+ affectedTasks: [records[0].taskName],
124
+ recommendations: [
125
+ "Проверьте логи ошибок за последнее время",
126
+ "Убедитесь, что Quality Gate настроен правильно",
127
+ "Рассмотрите добавление retryCount"
128
+ ],
129
+ metadata: {
130
+ recentErrorRate,
131
+ olderErrorRate,
132
+ windowDays
133
+ }
134
+ };
135
+ }
136
+ return null;
137
+ }
138
+ function detectDurationSpike(records) {
139
+ if (records.length < 5)
140
+ return null;
141
+ const durations = records
142
+ .map(r => r.durationMs || 0)
143
+ .filter(d => d > 0)
144
+ .sort((a, b) => a - b);
145
+ if (durations.length < 3)
146
+ return null;
147
+ const median = durations[Math.floor(durations.length / 2)];
148
+ const recentDuration = records[0]?.durationMs || 0;
149
+ if (recentDuration > median * 3) {
150
+ return {
151
+ type: "duration_spike",
152
+ severity: Math.min(100, Math.round((recentDuration / median - 1) * 50)),
153
+ description: `Аномальная длительность: ${Math.round(recentDuration / 1000)}с vs медиана ${Math.round(median / 1000)}с`,
154
+ affectedTasks: [records[0].taskName],
155
+ recommendations: [
156
+ "Проверьте, не завис ли процесс",
157
+ "Увеличьте timeoutSeconds если задача легитимно долгая",
158
+ "Рассмотрите разделение задачи на части"
159
+ ],
160
+ metadata: {
161
+ recentDuration,
162
+ medianDuration: median,
163
+ ratio: recentDuration / median
164
+ }
165
+ };
166
+ }
167
+ return null;
168
+ }
169
+ function detectTimeoutSpike(records) {
170
+ if (records.length < 5)
171
+ return null;
172
+ const timeoutCount = records.filter(r => r.error?.includes('timeout')).length;
173
+ const timeoutRate = timeoutCount / records.length;
174
+ if (timeoutRate > 0.2) {
175
+ return {
176
+ type: "timeout_spike",
177
+ severity: Math.min(100, Math.round(timeoutRate * 200)),
178
+ description: `Высокий процент таймаутов: ${Math.round(timeoutRate * 100)}%`,
179
+ affectedTasks: [records[0].taskName],
180
+ recommendations: [
181
+ "Увеличьте timeoutSeconds",
182
+ "Упростите промпты задачи",
183
+ "Проверьте производительность модели"
184
+ ],
185
+ metadata: {
186
+ timeoutCount,
187
+ totalRecords: records.length,
188
+ timeoutRate
189
+ }
190
+ };
191
+ }
192
+ return null;
193
+ }
194
+ function detectCostSpike(records) {
195
+ if (records.length < 5)
196
+ return null;
197
+ const costs = records
198
+ .map(r => r.costUsd || 0)
199
+ .filter(c => c > 0)
200
+ .sort((a, b) => a - b);
201
+ if (costs.length < 3)
202
+ return null;
203
+ const median = costs[Math.floor(costs.length / 2)];
204
+ const recentCost = records[0]?.costUsd || 0;
205
+ if (recentCost > median * 3) {
206
+ return {
207
+ type: "cost_spike",
208
+ severity: Math.min(100, Math.round((recentCost / median - 1) * 50)),
209
+ description: `Аномальные затраты: $${recentCost.toFixed(4)} vs медиана $${median.toFixed(4)}`,
210
+ affectedTasks: [records[0].taskName],
211
+ recommendations: [
212
+ "Проверьте, не используется ли более дорогая модель",
213
+ "Оптимизируйте промпты для снижения токенов",
214
+ "Рассмотрите использование локальной модели"
215
+ ],
216
+ metadata: {
217
+ recentCost,
218
+ medianCost: median,
219
+ ratio: recentCost / median
220
+ }
221
+ };
222
+ }
223
+ return null;
224
+ }
225
+ function detectUnusualPattern(records) {
226
+ if (records.length < 10)
227
+ return null;
228
+ // Проверяем паттерн: все подряд ошибки или все подряд успехи
229
+ const recent = records.slice(0, 5);
230
+ const allErrors = recent.every(r => r.status === 'error');
231
+ const allSuccess = recent.every(r => r.status === 'success');
232
+ if (allErrors) {
233
+ return {
234
+ type: "unusual_pattern",
235
+ severity: 80,
236
+ description: "5 подряд ошибок подряд",
237
+ affectedTasks: [records[0].taskName],
238
+ recommendations: [
239
+ "Проверьте, не сломалась ли зависимость",
240
+ "Проверьте доступность внешних сервисов",
241
+ "Рассмотрите приостановку задачи до устранения проблемы"
242
+ ],
243
+ metadata: {
244
+ pattern: "consecutive_errors",
245
+ count: 5
246
+ }
247
+ };
248
+ }
249
+ return null;
250
+ }
251
+ function detectStalledRun(records, now) {
252
+ const running = records.find(r => r.status === 'running');
253
+ if (!running)
254
+ return null;
255
+ const startedAt = new Date(running.startedAt);
256
+ const hoursRunning = (now.getTime() - startedAt.getTime()) / (1000 * 60 * 60);
257
+ if (hoursRunning > 2) {
258
+ return {
259
+ type: "stalled_run",
260
+ severity: Math.min(100, Math.round(hoursRunning * 10)),
261
+ description: `Зависший запуск: ${hoursRunning.toFixed(1)} часов`,
262
+ affectedTasks: [running.taskName],
263
+ recommendations: [
264
+ "Проверьте, не завис ли процесс",
265
+ "Рассмотрите принудительное завершение",
266
+ "Проверьте блокировки (lock file)"
267
+ ],
268
+ metadata: {
269
+ hoursRunning,
270
+ startedAt: running.startedAt,
271
+ taskId: running.id
272
+ }
273
+ };
274
+ }
275
+ return null;
276
+ }
277
+ // ==================== Trend Analysis ====================
278
+ /** Анализирует тренды метрик. */
279
+ export function analyzeTrends(records, options = {}) {
280
+ const trends = [];
281
+ const windowDays = options.days ?? 14;
282
+ // Разделяем на периоды
283
+ const half = Math.floor(records.length / 2);
284
+ const older = records.slice(half);
285
+ const recent = records.slice(0, half);
286
+ if (older.length < 3 || recent.length < 3)
287
+ return trends;
288
+ // 1. Тренд успешности
289
+ const olderSuccessRate = older.filter(r => r.status === 'success').length / older.length;
290
+ const recentSuccessRate = recent.filter(r => r.status === 'success').length / recent.length;
291
+ const successChange = ((recentSuccessRate - olderSuccessRate) / Math.max(olderSuccessRate, 0.01)) * 100;
292
+ trends.push({
293
+ metric: "success_rate",
294
+ direction: successChange > 5 ? "improving" : successChange < -5 ? "degrading" : "stable",
295
+ changePercent: successChange,
296
+ description: `Успешность: ${Math.round(olderSuccessRate * 100)}% → ${Math.round(recentSuccessRate * 100)}%`,
297
+ recommendations: successChange < -10 ? [
298
+ "Проверьте, что изменилось в последнее время",
299
+ "Проверьте логи ошибок"
300
+ ] : []
301
+ });
302
+ // 2. Тренд длительности
303
+ const olderDurations = older.map(r => r.durationMs || 0).filter(d => d > 0);
304
+ const recentDurations = recent.map(r => r.durationMs || 0).filter(d => d > 0);
305
+ if (olderDurations.length > 0 && recentDurations.length > 0) {
306
+ const olderAvgDuration = olderDurations.reduce((a, b) => a + b, 0) / olderDurations.length;
307
+ const recentAvgDuration = recentDurations.reduce((a, b) => a + b, 0) / recentDurations.length;
308
+ const durationChange = ((recentAvgDuration - olderAvgDuration) / Math.max(olderAvgDuration, 1)) * 100;
309
+ trends.push({
310
+ metric: "avg_duration",
311
+ direction: durationChange < -5 ? "improving" : durationChange > 5 ? "degrading" : "stable",
312
+ changePercent: durationChange,
313
+ description: `Средняя длительность: ${Math.round(olderAvgDuration / 1000)}с → ${Math.round(recentAvgDuration / 1000)}с`,
314
+ recommendations: durationChange > 20 ? [
315
+ "Оптимизируйте промпты",
316
+ "Проверьте, не увеличилась ли нагрузка"
317
+ ] : []
318
+ });
319
+ }
320
+ // 3. Тренд стоимости
321
+ const olderCosts = older.map(r => r.costUsd || 0).filter(c => c > 0);
322
+ const recentCosts = recent.map(r => r.costUsd || 0).filter(c => c > 0);
323
+ if (olderCosts.length > 0 && recentCosts.length > 0) {
324
+ const olderAvgCost = olderCosts.reduce((a, b) => a + b, 0) / olderCosts.length;
325
+ const recentAvgCost = recentCosts.reduce((a, b) => a + b, 0) / recentCosts.length;
326
+ const costChange = ((recentAvgCost - olderAvgCost) / Math.max(olderAvgCost, 0.001)) * 100;
327
+ trends.push({
328
+ metric: "avg_cost",
329
+ direction: costChange < -5 ? "improving" : costChange > 5 ? "degrading" : "stable",
330
+ changePercent: costChange,
331
+ description: `Средняя стоимость: $${olderAvgCost.toFixed(4)} → $${recentAvgCost.toFixed(4)}`,
332
+ recommendations: costChange > 20 ? [
333
+ "Проверьте, не используется ли более дорогая модель",
334
+ "Оптимизируйте промпты для снижения токенов"
335
+ ] : []
336
+ });
337
+ }
338
+ return trends;
339
+ }
340
+ // ==================== Recommendations ====================
341
+ /** Генерирует рекомендации по оптимизации. */
342
+ export function generateRecommendations(report, anomalies, trends) {
343
+ const recommendations = [];
344
+ // Если нет данных — не генерируем рекомендации
345
+ if (report.totals.total === 0) {
346
+ return recommendations;
347
+ }
348
+ // Рекомендации на основе здоровья
349
+ if (report.totals.successRate < 80) {
350
+ recommendations.push({
351
+ priority: 9,
352
+ category: "reliability",
353
+ title: "Повысьте успешность запусков",
354
+ description: `Текущая успешность ${report.totals.successRate}% ниже целевых 80%. Это может указывать на проблемы с Quality Gate, зависимостями или внешними сервисами.`,
355
+ expectedImpact: "Снизит количество повторных запусков и улучшит надёжность",
356
+ effort: "medium",
357
+ steps: [
358
+ "Проверьте логи ошибок за последние 7 дней",
359
+ "Убедитесь, что Quality Gate настроен правильно",
360
+ "Добавьте retryCount для флакких задач",
361
+ "Проверьте доступность внешних сервисов"
362
+ ]
363
+ });
364
+ }
365
+ // Рекомендации на основе аномалий
366
+ for (const anomaly of anomalies) {
367
+ if (anomaly.severity > 70) {
368
+ recommendations.push({
369
+ priority: Math.min(10, Math.round(anomaly.severity / 10)),
370
+ category: anomaly.type.includes('cost') ? "cost" : "performance",
371
+ title: `Устраните аномалию: ${anomaly.type}`,
372
+ description: anomaly.description,
373
+ expectedImpact: "Снизит нагрузку и улучшит стабильность",
374
+ effort: "medium",
375
+ steps: anomaly.recommendations
376
+ });
377
+ }
378
+ }
379
+ // Рекомендации на основе трендов
380
+ for (const trend of trends) {
381
+ if (trend.direction === "degrading" && Math.abs(trend.changePercent) > 20) {
382
+ recommendations.push({
383
+ priority: 7,
384
+ category: trend.metric.includes('cost') ? "cost" : "performance",
385
+ title: `Обратите внимание на тренд: ${trend.metric}`,
386
+ description: trend.description,
387
+ expectedImpact: "Предотвратит дальнейшее ухудшение",
388
+ effort: "low",
389
+ steps: trend.recommendations
390
+ });
391
+ }
392
+ }
393
+ // Рекомендации на основе затрат
394
+ if (report.totals.costUsd > 100) {
395
+ recommendations.push({
396
+ priority: 6,
397
+ category: "cost",
398
+ title: "Оптимизируйте затраты",
399
+ description: `Общие затраты за период: $${report.totals.costUsd.toFixed(2)}. Рассмотрите оптимизацию.`,
400
+ expectedImpact: "Снизит затраты на 20-40%",
401
+ effort: "medium",
402
+ steps: [
403
+ "Проверьте, не используется ли более дорогая модель для простых задач",
404
+ "Оптимизируйте промпты для снижения токенов",
405
+ "Рассмотрите использование локальной модели для простых задач",
406
+ "Настройте лимиты на задачи с высокими затратами"
407
+ ]
408
+ });
409
+ }
410
+ // Рекомендации на основе длительности
411
+ if (report.totals.avgDurationMs > 300000) { // 5 минут
412
+ recommendations.push({
413
+ priority: 5,
414
+ category: "performance",
415
+ title: "Оптимизируйте длительность задач",
416
+ description: `Средняя длительность: ${Math.round(report.totals.avgDurationMs / 1000)} секунд. Это может указывать на сложные промпты или медленные модели.`,
417
+ expectedImpact: "Снизит время ожидания и улучшит отзывчивость",
418
+ effort: "medium",
419
+ steps: [
420
+ "Разбейте длинные задачи на более мелкие",
421
+ "Упростите промпты",
422
+ "Проверьте, не используются ли медленные модели",
423
+ "Увеличьте timeoutSeconds если задачи легитимно долгие"
424
+ ]
425
+ });
426
+ }
427
+ // Рекомендации на основе таймаутов
428
+ const timeoutErrors = report.errors.filter(e => e.message.includes('timeout'));
429
+ if (timeoutErrors.length > 0) {
430
+ recommendations.push({
431
+ priority: 8,
432
+ category: "reliability",
433
+ title: "Устраните проблемы с таймаутами",
434
+ description: `Обнаружено ${timeoutErrors.length} ошибок таймаута. Это может указывать на слишком короткие таймауты или сложные задачи.`,
435
+ expectedImpact: "Снизит количество прерванных запусков",
436
+ effort: "low",
437
+ steps: [
438
+ "Увеличьте timeoutSeconds для затронутых задач",
439
+ "Упростите промпты",
440
+ "Проверьте производительность модели",
441
+ "Рассмотрите разделение сложных задач"
442
+ ]
443
+ });
444
+ }
445
+ // Рекомендации на основе крашей
446
+ const crashErrors = report.errors.filter(e => e.message.includes('Прервано'));
447
+ if (crashErrors.length > 0) {
448
+ recommendations.push({
449
+ priority: 7,
450
+ category: "reliability",
451
+ title: "Снизьте количество прерванных запусков",
452
+ description: `Обнаружено ${crashErrors.length} прерванных запусков. Это может указывать на нестабильность системы или перезагрузки.`,
453
+ expectedImpact: "Повысит надёжность выполнения задач",
454
+ effort: "medium",
455
+ steps: [
456
+ "Проверьте стабильность системы",
457
+ "Проверьте, нет ли конфликтов между задачами",
458
+ "Убедитесь, что задачи не превышают лимиты ресурсов",
459
+ "Рассмотрите настройку crash recovery"
460
+ ]
461
+ });
462
+ }
463
+ // Сортируем по приоритету
464
+ return recommendations.sort((a, b) => b.priority - a.priority);
465
+ }
466
+ // ==================== Main Function ====================
467
+ /** Генерирует полный отчёт самоанализа. */
468
+ export function generateSelfAnalysisReport(records, options = {}) {
469
+ const windowDays = options.days ?? 14;
470
+ const now = options.now ?? new Date();
471
+ // Базовая аналитика
472
+ const analyticsReport = buildAnalytics(records, {
473
+ days: windowDays,
474
+ now,
475
+ topLimit: options.topLimit,
476
+ tasks: options.tasks
477
+ });
478
+ // Health Score
479
+ const health = calculateHealthScore(analyticsReport);
480
+ // Anomalies
481
+ const anomalies = detectAnomalies(records, options);
482
+ // Trends
483
+ const trends = analyzeTrends(records, options);
484
+ // Recommendations
485
+ const recommendations = generateRecommendations(analyticsReport, anomalies, trends);
486
+ // Summary
487
+ const summary = generateSummary(health, anomalies, trends, recommendations);
488
+ return {
489
+ generatedAt: now.toISOString(),
490
+ windowDays,
491
+ health,
492
+ anomalies,
493
+ trends,
494
+ recommendations,
495
+ summary,
496
+ sources: {
497
+ historyRecords: records.length,
498
+ recordsInWindow: analyticsReport.sources.recordsInWindow,
499
+ tasksAnalyzed: analyticsReport.tasks.length
500
+ }
501
+ };
502
+ }
503
+ function generateSummary(health, anomalies, trends, recommendations) {
504
+ const parts = [];
505
+ // Здоровье
506
+ const levelNames = {
507
+ excellent: "отличное",
508
+ good: "хорошее",
509
+ fair: "удовлетворительное",
510
+ poor: "плохое",
511
+ critical: "критическое"
512
+ };
513
+ parts.push(`Здоровье системы: ${levelNames[health.level]} (${health.score}/100)`);
514
+ // Аномалии
515
+ if (anomalies.length > 0) {
516
+ const highSeverity = anomalies.filter(a => a.severity > 70).length;
517
+ if (highSeverity > 0) {
518
+ parts.push(`Обнаружено ${highSeverity} критических аномалий`);
519
+ }
520
+ else {
521
+ parts.push(`Обнаружено ${anomalies.length} аномалий (все некритические)`);
522
+ }
523
+ }
524
+ else {
525
+ parts.push("Критических аномалий не обнаружено");
526
+ }
527
+ // Тренды
528
+ const degradingTrends = trends.filter(t => t.direction === 'degrading').length;
529
+ if (degradingTrends > 0) {
530
+ parts.push(`${degradingTrends} метрик ухудшаются`);
531
+ }
532
+ // Рекомендации
533
+ const highPriority = recommendations.filter(r => r.priority >= 7).length;
534
+ if (highPriority > 0) {
535
+ parts.push(`${highPriority} рекомендаций высокого приоритета`);
536
+ }
537
+ return parts.join(". ") + ".";
538
+ }
539
+ // ==================== Export ====================
@@ -24,11 +24,19 @@ export declare function preservedSessionRunCount(previous: {
24
24
  sessionId?: string;
25
25
  sessionRunCount?: number;
26
26
  } | undefined, session: SessionMode, sessionId: string | undefined): number;
27
+ /** Путь к sidecar-файлу с актуальным id сессии задачи. */
28
+ export declare function sessionStatePath(taskName: string): string;
29
+ /**
30
+ * Записывает актуальный id сессии в sidecar-файл, который обёртка читает
31
+ * непосредственно перед запуском opencode. `undefined` удаляет файл.
32
+ * Никогда не бросает.
33
+ */
34
+ export declare function writeSessionStateFile(taskName: string, sessionId: string | undefined): Promise<void>;
27
35
  /**
28
36
  * Best-effort ротация переиспользуемой сессии после завершения запуска.
29
- * Удаляет сессию через opencode CLI, очищает sessionId в определении задачи
30
- * и пишет событие в structured log. Никогда не бросает — сбой ротации
31
- * не должен ломать историю запуска.
37
+ * Удаляет сессию через opencode CLI, генерирует новый id, обновляет
38
+ * определение задачи и sidecar-файл обёртки. Никогда не бросает — сбой
39
+ * ротации не должен ломать историю запуска.
32
40
  */
33
41
  export declare function rotateSessionIfNeeded(taskName: string): Promise<void>;
34
42
  //# sourceMappingURL=session.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"session.d.ts","sourceRoot":"","sources":["../../src/core/session.ts"],"names":[],"mappings":"AAKA,eAAO,MAAM,aAAa,mCAAoC,CAAC;AAC/D,MAAM,MAAM,WAAW,GAAG,CAAC,OAAO,aAAa,CAAC,CAAC,MAAM,CAAC,CAAC;AAIzD,wDAAwD;AACxD,wBAAgB,iBAAiB,IAAI,MAAM,CAU1C;AAED,kCAAkC;AAClC,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAEhE;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,OAAO,GAAG,WAAW,GAAG,SAAS,CAI5E;AAED,4DAA4D;AAC5D,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,WAAW,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAShF;AAED,iEAAiE;AACjE,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAE9E;AAED;;;;;GAKG;AACH,wBAAgB,wBAAwB,CACtC,QAAQ,EACJ;IAAE,OAAO,CAAC,EAAE,WAAW,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAAC,eAAe,CAAC,EAAE,MAAM,CAAA;CAAE,GACvE,SAAS,EACb,OAAO,EAAE,WAAW,EACpB,SAAS,EAAE,MAAM,GAAG,SAAS,GAC5B,MAAM,CAIR;AAED;;;;;GAKG;AACH,wBAAsB,qBAAqB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAmC3E"}
1
+ {"version":3,"file":"session.d.ts","sourceRoot":"","sources":["../../src/core/session.ts"],"names":[],"mappings":"AAQA,eAAO,MAAM,aAAa,mCAAoC,CAAC;AAC/D,MAAM,MAAM,WAAW,GAAG,CAAC,OAAO,aAAa,CAAC,CAAC,MAAM,CAAC,CAAC;AAIzD,wDAAwD;AACxD,wBAAgB,iBAAiB,IAAI,MAAM,CAU1C;AAED,kCAAkC;AAClC,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAEhE;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,OAAO,GAAG,WAAW,GAAG,SAAS,CAI5E;AAED,4DAA4D;AAC5D,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,WAAW,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAShF;AAED,iEAAiE;AACjE,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAE9E;AAED;;;;;GAKG;AACH,wBAAgB,wBAAwB,CACtC,QAAQ,EACJ;IAAE,OAAO,CAAC,EAAE,WAAW,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAAC,eAAe,CAAC,EAAE,MAAM,CAAA;CAAE,GACvE,SAAS,EACb,OAAO,EAAE,WAAW,EACpB,SAAS,EAAE,MAAM,GAAG,SAAS,GAC5B,MAAM,CAIR;AAED,0DAA0D;AAC1D,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAEzD;AAED;;;;GAIG;AACH,wBAAsB,qBAAqB,CACzC,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,MAAM,GAAG,SAAS,GAC5B,OAAO,CAAC,IAAI,CAAC,CAef;AAED;;;;;GAKG;AACH,wBAAsB,qBAAqB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAqC3E"}
@@ -1,7 +1,10 @@
1
1
  import crypto from "node:crypto";
2
+ import fs from "node:fs/promises";
3
+ import path from "node:path";
2
4
  import { execFile } from "node:child_process";
3
5
  import { getTask, saveTask } from "../db/tasks-repo.js";
4
6
  import { appendStructuredLog } from "./structured-log.js";
7
+ import { WRAPPER_DIR, sanitizeName } from "../types.js";
5
8
  export const SESSION_MODES = ["new", "reuse", "last"];
6
9
  const SESSION_ID_PATTERN = /^ses_[A-Za-z0-9]{10,64}$/;
7
10
  /** Генерация id сессии в формате `ses_<26+ base36>`. */
@@ -59,11 +62,35 @@ export function preservedSessionRunCount(previous, session, sessionId) {
59
62
  return 0;
60
63
  return previous.sessionRunCount ?? 0;
61
64
  }
65
+ /** Путь к sidecar-файлу с актуальным id сессии задачи. */
66
+ export function sessionStatePath(taskName) {
67
+ return path.join(WRAPPER_DIR, `${sanitizeName(taskName)}.session`);
68
+ }
69
+ /**
70
+ * Записывает актуальный id сессии в sidecar-файл, который обёртка читает
71
+ * непосредственно перед запуском opencode. `undefined` удаляет файл.
72
+ * Никогда не бросает.
73
+ */
74
+ export async function writeSessionStateFile(taskName, sessionId) {
75
+ try {
76
+ const file = sessionStatePath(taskName);
77
+ await fs.mkdir(WRAPPER_DIR, { recursive: true });
78
+ if (sessionId) {
79
+ await fs.writeFile(file, `${sessionId}\n`, "utf8");
80
+ }
81
+ else {
82
+ await fs.unlink(file).catch(() => undefined);
83
+ }
84
+ }
85
+ catch (error) {
86
+ console.warn(`[session] Не удалось обновить файл сессии задачи "${taskName}":`, error);
87
+ }
88
+ }
62
89
  /**
63
90
  * Best-effort ротация переиспользуемой сессии после завершения запуска.
64
- * Удаляет сессию через opencode CLI, очищает sessionId в определении задачи
65
- * и пишет событие в structured log. Никогда не бросает — сбой ротации
66
- * не должен ломать историю запуска.
91
+ * Удаляет сессию через opencode CLI, генерирует новый id, обновляет
92
+ * определение задачи и sidecar-файл обёртки. Никогда не бросает — сбой
93
+ * ротации не должен ломать историю запуска.
67
94
  */
68
95
  export async function rotateSessionIfNeeded(taskName) {
69
96
  try {
@@ -84,15 +111,17 @@ export async function rotateSessionIfNeeded(taskName) {
84
111
  // Удаление не должно мешать: просто фиксируем в логе ниже.
85
112
  }
86
113
  }
114
+ const newSessionId = generateSessionId();
87
115
  await saveTask({
88
116
  ...def,
89
- sessionId: undefined,
117
+ sessionId: newSessionId,
90
118
  sessionRunCount: 0,
91
119
  });
120
+ await writeSessionStateFile(taskName, newSessionId);
92
121
  appendStructuredLog({
93
122
  event: "session.rotated",
94
123
  task: taskName,
95
- reason: `maxRuns=${maxRuns} достигнут; сессия удалена и счётчик сброшен`,
124
+ reason: `maxRuns=${maxRuns} достигнут; сессия удалена, создана новая, счётчик сброшен`,
96
125
  });
97
126
  }
98
127
  else {
@@ -0,0 +1,26 @@
1
+ /**
2
+ * Д6: ворота выгрузки плагина.
3
+ *
4
+ * Позволяют перестать принимать новые запуски и дождаться уже начатых
5
+ * in-process операций (запуск задачи, matrix, DAG-триггер) перед закрытием
6
+ * SQLite и HTTP-сервера. Внешние процессы планировщика ОС эти ворота не
7
+ * отслеживают: их жизненным циклом управляет сама ОС.
8
+ */
9
+ export interface ShutdownWaitResult {
10
+ timedOut: boolean;
11
+ remaining: number;
12
+ }
13
+ export interface ShutdownGate {
14
+ /** true после begin(): новые запуски должны отклоняться. */
15
+ isShuttingDown(): boolean;
16
+ /** Переводит ворота в режим выгрузки. */
17
+ begin(): void;
18
+ /** Учитывает промис до его завершения (успех или ошибка). */
19
+ track<T>(promise: Promise<T>): Promise<T>;
20
+ /** Сколько операций ещё выполняется. */
21
+ activeCount(): number;
22
+ /** Ждёт завершения активных операций не дольше timeoutMs. */
23
+ waitForIdle(timeoutMs: number): Promise<ShutdownWaitResult>;
24
+ }
25
+ export declare function createShutdownGate(): ShutdownGate;
26
+ //# sourceMappingURL=shutdown.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"shutdown.d.ts","sourceRoot":"","sources":["../../src/core/shutdown.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,MAAM,WAAW,kBAAkB;IACjC,QAAQ,EAAE,OAAO,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,YAAY;IAC3B,4DAA4D;IAC5D,cAAc,IAAI,OAAO,CAAC;IAC1B,yCAAyC;IACzC,KAAK,IAAI,IAAI,CAAC;IACd,6DAA6D;IAC7D,KAAK,CAAC,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;IAC1C,wCAAwC;IACxC,WAAW,IAAI,MAAM,CAAC;IACtB,6DAA6D;IAC7D,WAAW,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAAC;CAC7D;AAED,wBAAgB,kBAAkB,IAAI,YAAY,CAyCjD"}