agent-steward 0.0.1 → 0.0.3

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (345) hide show
  1. package/CHANGELOG.md +399 -0
  2. package/CROSS_PLATFORM.md +151 -0
  3. package/README.md +307 -15
  4. package/ROADMAP-STRATEGY.md +196 -0
  5. package/ROADMAP.md +184 -0
  6. package/dist/core/analytics.d.ts +132 -0
  7. package/dist/core/analytics.d.ts.map +1 -0
  8. package/dist/core/analytics.js +290 -0
  9. package/dist/core/audit.d.ts +96 -0
  10. package/dist/core/audit.d.ts.map +1 -0
  11. package/dist/core/audit.js +297 -0
  12. package/dist/core/cron-to-schtasks.d.ts +12 -0
  13. package/dist/core/cron-to-schtasks.d.ts.map +1 -0
  14. package/dist/core/cron-to-schtasks.js +175 -0
  15. package/dist/core/dry-run.d.ts +102 -0
  16. package/dist/core/dry-run.d.ts.map +1 -0
  17. package/dist/core/dry-run.js +447 -0
  18. package/dist/core/file-watcher.d.ts +31 -0
  19. package/dist/core/file-watcher.d.ts.map +1 -0
  20. package/dist/core/file-watcher.js +186 -0
  21. package/dist/core/git-trigger.d.ts +82 -0
  22. package/dist/core/git-trigger.d.ts.map +1 -0
  23. package/dist/core/git-trigger.js +312 -0
  24. package/dist/core/glob.d.ts +38 -0
  25. package/dist/core/glob.d.ts.map +1 -0
  26. package/dist/core/glob.js +233 -0
  27. package/dist/core/local-ai.d.ts +52 -0
  28. package/dist/core/local-ai.d.ts.map +1 -0
  29. package/dist/core/local-ai.js +119 -0
  30. package/dist/core/lock.d.ts +57 -0
  31. package/dist/core/lock.d.ts.map +1 -0
  32. package/dist/core/lock.js +193 -0
  33. package/dist/core/matrix.d.ts +167 -0
  34. package/dist/core/matrix.d.ts.map +1 -0
  35. package/dist/core/matrix.js +724 -0
  36. package/dist/core/native-notify.d.ts +36 -0
  37. package/dist/core/native-notify.d.ts.map +1 -0
  38. package/dist/core/native-notify.js +113 -0
  39. package/dist/core/one-shot.d.ts +90 -0
  40. package/dist/core/one-shot.d.ts.map +1 -0
  41. package/dist/core/one-shot.js +182 -0
  42. package/dist/core/otel.d.ts +4 -0
  43. package/dist/core/otel.d.ts.map +1 -0
  44. package/dist/core/otel.js +98 -0
  45. package/dist/core/permissions.d.ts +69 -0
  46. package/dist/core/permissions.d.ts.map +1 -0
  47. package/dist/core/permissions.js +143 -0
  48. package/dist/core/prometheus.d.ts +23 -0
  49. package/dist/core/prometheus.d.ts.map +1 -0
  50. package/dist/core/prometheus.js +146 -0
  51. package/dist/core/ps-wrapper.d.ts +73 -0
  52. package/dist/core/ps-wrapper.d.ts.map +1 -0
  53. package/dist/core/ps-wrapper.js +1091 -0
  54. package/dist/core/record-history.d.ts +25 -0
  55. package/dist/core/record-history.d.ts.map +1 -0
  56. package/dist/core/record-history.js +471 -0
  57. package/dist/core/retention.d.ts +29 -0
  58. package/dist/core/retention.d.ts.map +1 -0
  59. package/dist/core/retention.js +98 -0
  60. package/dist/core/savings.d.ts +70 -0
  61. package/dist/core/savings.d.ts.map +1 -0
  62. package/dist/core/savings.js +87 -0
  63. package/dist/core/schedule-gate.d.ts +2 -0
  64. package/dist/core/schedule-gate.d.ts.map +1 -0
  65. package/dist/core/schedule-gate.js +211 -0
  66. package/dist/core/schedule-v2.d.ts +116 -0
  67. package/dist/core/schedule-v2.d.ts.map +1 -0
  68. package/dist/core/schedule-v2.js +586 -0
  69. package/dist/core/scheduler/at-fallback.d.ts +42 -0
  70. package/dist/core/scheduler/at-fallback.d.ts.map +1 -0
  71. package/dist/core/scheduler/at-fallback.js +70 -0
  72. package/dist/core/scheduler/index.d.ts +32 -0
  73. package/dist/core/scheduler/index.d.ts.map +1 -0
  74. package/dist/core/scheduler/index.js +63 -0
  75. package/dist/core/scheduler/linux.d.ts +46 -0
  76. package/dist/core/scheduler/linux.d.ts.map +1 -0
  77. package/dist/core/scheduler/linux.js +261 -0
  78. package/dist/core/scheduler/logs.d.ts +11 -0
  79. package/dist/core/scheduler/logs.d.ts.map +1 -0
  80. package/dist/core/scheduler/logs.js +34 -0
  81. package/dist/core/scheduler/mac.d.ts +46 -0
  82. package/dist/core/scheduler/mac.d.ts.map +1 -0
  83. package/dist/core/scheduler/mac.js +256 -0
  84. package/dist/core/scheduler/posix.d.ts +40 -0
  85. package/dist/core/scheduler/posix.d.ts.map +1 -0
  86. package/dist/core/scheduler/posix.js +100 -0
  87. package/dist/core/scheduler/registry.d.ts +43 -0
  88. package/dist/core/scheduler/registry.d.ts.map +1 -0
  89. package/dist/core/scheduler/registry.js +57 -0
  90. package/dist/core/scheduler/types.d.ts +86 -0
  91. package/dist/core/scheduler/types.d.ts.map +1 -0
  92. package/dist/core/scheduler/types.js +1 -0
  93. package/dist/core/scheduler/windows.d.ts +112 -0
  94. package/dist/core/scheduler/windows.d.ts.map +1 -0
  95. package/dist/core/scheduler/windows.js +749 -0
  96. package/dist/core/secrets.d.ts +66 -0
  97. package/dist/core/secrets.d.ts.map +1 -0
  98. package/dist/core/secrets.js +433 -0
  99. package/dist/core/self-analysis.d.ts +117 -0
  100. package/dist/core/self-analysis.d.ts.map +1 -0
  101. package/dist/core/self-analysis.js +539 -0
  102. package/dist/core/session.d.ts +42 -0
  103. package/dist/core/session.d.ts.map +1 -0
  104. package/dist/core/session.js +134 -0
  105. package/dist/core/shutdown.d.ts +26 -0
  106. package/dist/core/shutdown.d.ts.map +1 -0
  107. package/dist/core/shutdown.js +49 -0
  108. package/dist/core/structured-log.d.ts +84 -0
  109. package/dist/core/structured-log.d.ts.map +1 -0
  110. package/dist/core/structured-log.js +146 -0
  111. package/dist/core/summary.d.ts +69 -0
  112. package/dist/core/summary.d.ts.map +1 -0
  113. package/dist/core/summary.js +250 -0
  114. package/dist/core/telegram.d.ts +55 -0
  115. package/dist/core/telegram.d.ts.map +1 -0
  116. package/dist/core/telegram.js +344 -0
  117. package/dist/core/triage-chain.d.ts +40 -0
  118. package/dist/core/triage-chain.d.ts.map +1 -0
  119. package/dist/core/triage-chain.js +80 -0
  120. package/dist/core/triage-compare.d.ts +68 -0
  121. package/dist/core/triage-compare.d.ts.map +1 -0
  122. package/dist/core/triage-compare.js +184 -0
  123. package/dist/core/triage-rules.d.ts +23 -0
  124. package/dist/core/triage-rules.d.ts.map +1 -0
  125. package/dist/core/triage-rules.js +196 -0
  126. package/dist/core/triage-shadow.d.ts +91 -0
  127. package/dist/core/triage-shadow.d.ts.map +1 -0
  128. package/dist/core/triage-shadow.js +160 -0
  129. package/dist/core/triage-worker.d.ts +55 -0
  130. package/dist/core/triage-worker.d.ts.map +1 -0
  131. package/dist/core/triage-worker.js +314 -0
  132. package/dist/core/triage.d.ts +76 -0
  133. package/dist/core/triage.d.ts.map +1 -0
  134. package/dist/core/triage.js +271 -0
  135. package/dist/core/watch-paths.d.ts +6 -0
  136. package/dist/core/watch-paths.d.ts.map +1 -0
  137. package/dist/core/watch-paths.js +62 -0
  138. package/dist/core/wrappers/bash.d.ts +95 -0
  139. package/dist/core/wrappers/bash.d.ts.map +1 -0
  140. package/dist/core/wrappers/bash.js +413 -0
  141. package/dist/db/git-state-repo.d.ts +16 -0
  142. package/dist/db/git-state-repo.d.ts.map +1 -0
  143. package/dist/db/git-state-repo.js +38 -0
  144. package/dist/db/history-repo.d.ts +110 -0
  145. package/dist/db/history-repo.d.ts.map +1 -0
  146. package/dist/db/history-repo.js +300 -0
  147. package/dist/db/index.d.ts +49 -0
  148. package/dist/db/index.d.ts.map +1 -0
  149. package/dist/db/index.js +128 -0
  150. package/dist/db/metrics-repo.d.ts +46 -0
  151. package/dist/db/metrics-repo.d.ts.map +1 -0
  152. package/dist/db/metrics-repo.js +103 -0
  153. package/dist/db/migrate.d.ts +24 -0
  154. package/dist/db/migrate.d.ts.map +1 -0
  155. package/dist/db/migrate.js +244 -0
  156. package/dist/db/recovery.d.ts +11 -0
  157. package/dist/db/recovery.d.ts.map +1 -0
  158. package/dist/db/recovery.js +38 -0
  159. package/dist/db/run-journal.d.ts +60 -0
  160. package/dist/db/run-journal.d.ts.map +1 -0
  161. package/dist/db/run-journal.js +143 -0
  162. package/dist/db/run-resume.d.ts +48 -0
  163. package/dist/db/run-resume.d.ts.map +1 -0
  164. package/dist/db/run-resume.js +137 -0
  165. package/dist/db/runs-repo.d.ts +120 -0
  166. package/dist/db/runs-repo.d.ts.map +1 -0
  167. package/dist/db/runs-repo.js +319 -0
  168. package/dist/db/schema.d.ts +38 -0
  169. package/dist/db/schema.d.ts.map +1 -0
  170. package/dist/db/schema.js +325 -0
  171. package/dist/db/settings-repo.d.ts +8 -0
  172. package/dist/db/settings-repo.d.ts.map +1 -0
  173. package/dist/db/settings-repo.js +27 -0
  174. package/dist/db/tasks-repo.d.ts +26 -0
  175. package/dist/db/tasks-repo.d.ts.map +1 -0
  176. package/dist/db/tasks-repo.js +120 -0
  177. package/dist/db/templates-repo.d.ts +17 -0
  178. package/dist/db/templates-repo.d.ts.map +1 -0
  179. package/dist/db/templates-repo.js +57 -0
  180. package/dist/history.d.ts +60 -0
  181. package/dist/history.d.ts.map +1 -0
  182. package/dist/history.js +70 -0
  183. package/dist/i18n.d.ts +75 -0
  184. package/dist/i18n.d.ts.map +1 -0
  185. package/dist/i18n.js +357 -0
  186. package/dist/index.d.ts +858 -0
  187. package/dist/index.d.ts.map +1 -0
  188. package/dist/index.js +5209 -0
  189. package/dist/integrations.d.ts +72 -0
  190. package/dist/integrations.d.ts.map +1 -0
  191. package/dist/integrations.js +233 -0
  192. package/dist/notifications.d.ts +199 -0
  193. package/dist/notifications.d.ts.map +1 -0
  194. package/dist/notifications.js +967 -0
  195. package/dist/profiles.d.ts +64 -0
  196. package/dist/profiles.d.ts.map +1 -0
  197. package/dist/profiles.js +305 -0
  198. package/dist/rpc.d.ts +3915 -0
  199. package/dist/rpc.d.ts.map +1 -0
  200. package/dist/rpc.js +1596 -0
  201. package/dist/schtasks.d.ts +32 -0
  202. package/dist/schtasks.d.ts.map +1 -0
  203. package/dist/schtasks.js +45 -0
  204. package/dist/server.d.ts +128 -0
  205. package/dist/server.d.ts.map +1 -0
  206. package/dist/server.js +2414 -0
  207. package/dist/settings.d.ts +389 -0
  208. package/dist/settings.d.ts.map +1 -0
  209. package/dist/settings.js +770 -0
  210. package/dist/shared/jobs-view.d.ts +59 -0
  211. package/dist/shared/jobs-view.d.ts.map +1 -0
  212. package/dist/shared/jobs-view.js +146 -0
  213. package/dist/skill.d.ts +15 -0
  214. package/dist/skill.d.ts.map +1 -0
  215. package/dist/skill.js +93 -0
  216. package/dist/task-transfer.d.ts +252 -0
  217. package/dist/task-transfer.d.ts.map +1 -0
  218. package/dist/task-transfer.js +632 -0
  219. package/dist/templates.d.ts +57 -0
  220. package/dist/templates.d.ts.map +1 -0
  221. package/dist/templates.js +16 -0
  222. package/dist/types.d.ts +112 -0
  223. package/dist/types.d.ts.map +1 -0
  224. package/dist/types.js +158 -0
  225. package/dist/version.d.ts +8 -0
  226. package/dist/version.d.ts.map +1 -0
  227. package/dist/version.js +27 -0
  228. package/dist/workspaces.d.ts +113 -0
  229. package/dist/workspaces.d.ts.map +1 -0
  230. package/dist/workspaces.js +393 -0
  231. package/docs/ARCHITECTURE.md +559 -0
  232. package/docs/COMPATIBILITY.md +237 -0
  233. package/docs/CONCEPT.md +242 -0
  234. package/docs/CROSS_PLATFORM.ru.md +152 -0
  235. package/docs/CROSS_PLATFORM.zh.md +148 -0
  236. package/docs/FAQ.md +52 -0
  237. package/docs/FAQ.ru.md +53 -0
  238. package/docs/FAQ.zh.md +43 -0
  239. package/docs/FEATURES.md +699 -0
  240. package/docs/FEATURES.zh.md +656 -0
  241. package/docs/LOCAL-AI.md +300 -0
  242. package/docs/MIGRATION.md +363 -0
  243. package/docs/README.ru.md +287 -0
  244. package/docs/README.zh.md +306 -0
  245. package/docs/SAVINGS.md +61 -0
  246. package/docs/SAVINGS.ru.md +60 -0
  247. package/docs/SAVINGS.zh.md +52 -0
  248. package/docs/V1-V2-COMPATIBILITY-PLAN.md +366 -0
  249. package/docs/ZH-LOCALE-PLAN.md +324 -0
  250. package/docs/dashboard.png +0 -0
  251. package/docs/spikes/local-model-structured-output.md +81 -0
  252. package/docs/spikes/ollama-qwen3-4b-smoke.json +28 -0
  253. package/docs/spikes/ollama-qwen3-4b.json +163 -0
  254. package/gui-experimental.cjs +9 -0
  255. package/index.js +2 -0
  256. package/locales/en.json +781 -0
  257. package/locales/ru.json +781 -0
  258. package/locales/zh.json +781 -0
  259. package/package.json +154 -13
  260. package/scripts/bench-local.mjs +321 -0
  261. package/scripts/check-zh-locale.mjs +218 -0
  262. package/scripts/demo-dashboard.mjs +209 -0
  263. package/scripts/run-tests.mjs +236 -0
  264. package/scripts/spike-local-structured.mjs +182 -0
  265. package/scripts/test-locale.mjs +45 -0
  266. package/skills/scheduled-job-best-practices/SKILL.md +158 -0
  267. package/skills/scheduled-job-best-practices/references/recipes.md +163 -0
  268. package/src/core/analytics.ts +424 -0
  269. package/src/core/audit.ts +418 -0
  270. package/src/core/cron-to-schtasks.ts +209 -0
  271. package/src/core/dry-run.ts +601 -0
  272. package/src/core/file-watcher.ts +245 -0
  273. package/src/core/git-trigger.ts +391 -0
  274. package/src/core/glob.ts +226 -0
  275. package/src/core/local-ai.ts +173 -0
  276. package/src/core/lock.ts +219 -0
  277. package/src/core/matrix.ts +947 -0
  278. package/src/core/native-notify.ts +157 -0
  279. package/src/core/one-shot.ts +239 -0
  280. package/src/core/otel.ts +128 -0
  281. package/src/core/permissions.ts +200 -0
  282. package/src/core/prometheus.ts +215 -0
  283. package/src/core/ps-wrapper.ts +1160 -0
  284. package/src/core/record-history.ts +615 -0
  285. package/src/core/retention.ts +141 -0
  286. package/src/core/savings.ts +150 -0
  287. package/src/core/schedule-gate.ts +253 -0
  288. package/src/core/schedule-v2.ts +668 -0
  289. package/src/core/scheduler/at-fallback.ts +113 -0
  290. package/src/core/scheduler/index.ts +82 -0
  291. package/src/core/scheduler/linux.ts +308 -0
  292. package/src/core/scheduler/logs.ts +37 -0
  293. package/src/core/scheduler/mac.ts +322 -0
  294. package/src/core/scheduler/posix.ts +128 -0
  295. package/src/core/scheduler/registry.ts +101 -0
  296. package/src/core/scheduler/types.ts +90 -0
  297. package/src/core/scheduler/windows.ts +881 -0
  298. package/src/core/secrets.ts +503 -0
  299. package/src/core/self-analysis.ts +744 -0
  300. package/src/core/session.ts +150 -0
  301. package/src/core/shutdown.ts +69 -0
  302. package/src/core/structured-log.ts +214 -0
  303. package/src/core/summary.ts +318 -0
  304. package/src/core/telegram.ts +436 -0
  305. package/src/core/triage-chain.ts +125 -0
  306. package/src/core/triage-compare.ts +277 -0
  307. package/src/core/triage-rules.ts +238 -0
  308. package/src/core/triage-shadow.ts +240 -0
  309. package/src/core/triage-worker.ts +344 -0
  310. package/src/core/triage.ts +366 -0
  311. package/src/core/watch-paths.ts +70 -0
  312. package/src/core/wrappers/bash.ts +532 -0
  313. package/src/db/git-state-repo.ts +62 -0
  314. package/src/db/history-repo.ts +492 -0
  315. package/src/db/index.ts +176 -0
  316. package/src/db/metrics-repo.ts +170 -0
  317. package/src/db/migrate.ts +328 -0
  318. package/src/db/recovery.ts +46 -0
  319. package/src/db/run-journal.ts +212 -0
  320. package/src/db/run-resume.ts +220 -0
  321. package/src/db/runs-repo.ts +481 -0
  322. package/src/db/schema.ts +349 -0
  323. package/src/db/settings-repo.ts +31 -0
  324. package/src/db/tasks-repo.ts +162 -0
  325. package/src/db/templates-repo.ts +77 -0
  326. package/src/gui.tsx +5222 -0
  327. package/src/history.ts +128 -0
  328. package/src/i18n.ts +413 -0
  329. package/src/index.ts +6642 -0
  330. package/src/integrations.ts +297 -0
  331. package/src/notifications.ts +1346 -0
  332. package/src/profiles.ts +345 -0
  333. package/src/rpc.ts +1704 -0
  334. package/src/schtasks.ts +75 -0
  335. package/src/server.ts +2663 -0
  336. package/src/settings.ts +1369 -0
  337. package/src/shared/jobs-view.ts +188 -0
  338. package/src/skill.ts +113 -0
  339. package/src/task-transfer.ts +946 -0
  340. package/src/templates.ts +67 -0
  341. package/src/tui-v1.tsx +341 -0
  342. package/src/tui.tsx +329 -0
  343. package/src/types.ts +226 -0
  344. package/src/version.ts +27 -0
  345. package/src/workspaces.ts +487 -0
@@ -0,0 +1,52 @@
1
+ import type { TriageFallback, TriageMode, TriageSettings, TriageShadowSettings } from "../settings.js";
2
+ /**
3
+ * Настройки локального ассистента (Спринт 30.7 `manage_local_ai`).
4
+ *
5
+ * Здесь только чистые функции: слияние патча с текущими настройками
6
+ * триажа, нормализация значений и человекочитаемая сводка. Никаких
7
+ * сетевых вызовов и записи на диск — их делают инструмент и GUI.
8
+ */
9
+ export declare const LOCAL_AI_TIMEOUT_MIN = 1000;
10
+ export declare const LOCAL_AI_TIMEOUT_MAX = 120000;
11
+ export declare const LOCAL_AI_SELF_TEST_PROMPT = "\u0422\u0435\u0441\u0442 \u0441\u0432\u044F\u0437\u0438: \u0437\u0430\u0434\u0430\u0447\u0430 \u0437\u0430\u0432\u0435\u0440\u0448\u0438\u043B\u0430\u0441\u044C \u043E\u0448\u0438\u0431\u043A\u043E\u0439 Quality Gate (2 \u0443\u043F\u0430\u0432\u0448\u0438\u0445 \u0442\u0435\u0441\u0442\u0430).";
12
+ /** Патч настроек: любое подмножество полей. */
13
+ export interface LocalAiPatch {
14
+ mode?: TriageMode;
15
+ baseUrl?: string;
16
+ model?: string;
17
+ timeoutMs?: number;
18
+ fallback?: TriageFallback;
19
+ confidenceThreshold?: number;
20
+ shadow?: Partial<TriageShadowSettings>;
21
+ }
22
+ /** Сводка настроек для ответа инструмента и GUI. */
23
+ export interface LocalAiSummary {
24
+ mode: TriageMode;
25
+ baseUrl: string;
26
+ model: string;
27
+ timeoutMs: number;
28
+ fallback: TriageFallback;
29
+ confidenceThreshold: number;
30
+ /** Сколько пользовательских правил задано; null — встроенный набор. */
31
+ rules: number | null;
32
+ shadow: TriageShadowSettings;
33
+ /** Триаж реально спрашивает модель (mode llm/auto и заполнены baseUrl+model). */
34
+ llmReady: boolean;
35
+ /** Идёт shadow-период: решения пишутся в отчёт, но не подавляют. */
36
+ shadowActive: boolean;
37
+ /** Протокол по baseUrl: `.../v1` — OpenAI-совместимый, иначе Ollama. */
38
+ protocol: "openai" | "ollama";
39
+ }
40
+ /** Протокол по базовому URL — то же правило, что в `classifyNotification`. */
41
+ export declare function protocolFor(baseUrl: string): "openai" | "ollama";
42
+ /**
43
+ * Сливает патч с текущими настройками. Возвращает новые настройки и
44
+ * список имён изменённых полей (для ответа инструмента и аудита).
45
+ */
46
+ export declare function applyLocalAiPatch(current: TriageSettings, patch: LocalAiPatch): {
47
+ settings: TriageSettings;
48
+ changed: string[];
49
+ };
50
+ /** Компактная сводка настроек для ответа инструмента. */
51
+ export declare function summarizeLocalAi(settings: TriageSettings): LocalAiSummary;
52
+ //# sourceMappingURL=local-ai.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"local-ai.d.ts","sourceRoot":"","sources":["../../src/core/local-ai.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,cAAc,EACd,UAAU,EACV,cAAc,EACd,oBAAoB,EACrB,MAAM,gBAAgB,CAAC;AAGxB;;;;;;GAMG;AAEH,eAAO,MAAM,oBAAoB,OAAQ,CAAC;AAC1C,eAAO,MAAM,oBAAoB,SAAU,CAAC;AAC5C,eAAO,MAAM,yBAAyB,4SACoC,CAAC;AAE3E,+CAA+C;AAC/C,MAAM,WAAW,YAAY;IAC3B,IAAI,CAAC,EAAE,UAAU,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,cAAc,CAAC;IAC1B,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,MAAM,CAAC,EAAE,OAAO,CAAC,oBAAoB,CAAC,CAAC;CACxC;AAED,oDAAoD;AACpD,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,UAAU,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,cAAc,CAAC;IACzB,mBAAmB,EAAE,MAAM,CAAC;IAC5B,uEAAuE;IACvE,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,MAAM,EAAE,oBAAoB,CAAC;IAC7B,iFAAiF;IACjF,QAAQ,EAAE,OAAO,CAAC;IAClB,oEAAoE;IACpE,YAAY,EAAE,OAAO,CAAC;IACtB,wEAAwE;IACxE,QAAQ,EAAE,QAAQ,GAAG,QAAQ,CAAC;CAC/B;AAWD,8EAA8E;AAC9E,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,QAAQ,GAAG,QAAQ,CAGhE;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,cAAc,EACvB,KAAK,EAAE,YAAY,GAClB;IAAE,QAAQ,EAAE,cAAc,CAAC;IAAC,OAAO,EAAE,MAAM,EAAE,CAAA;CAAE,CAuEjD;AAED,yDAAyD;AACzD,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,cAAc,GAAG,cAAc,CAyBzE"}
@@ -0,0 +1,119 @@
1
+ import { DEFAULT_SHADOW_DAYS, isShadowActive } from "../settings.js";
2
+ /**
3
+ * Настройки локального ассистента (Спринт 30.7 `manage_local_ai`).
4
+ *
5
+ * Здесь только чистые функции: слияние патча с текущими настройками
6
+ * триажа, нормализация значений и человекочитаемая сводка. Никаких
7
+ * сетевых вызовов и записи на диск — их делают инструмент и GUI.
8
+ */
9
+ export const LOCAL_AI_TIMEOUT_MIN = 1000;
10
+ export const LOCAL_AI_TIMEOUT_MAX = 120000;
11
+ export const LOCAL_AI_SELF_TEST_PROMPT = "Тест связи: задача завершилась ошибкой Quality Gate (2 упавших теста).";
12
+ function clamp(value, min, max, fallback) {
13
+ if (!Number.isFinite(value))
14
+ return fallback;
15
+ return Math.min(max, Math.max(min, Math.round(value)));
16
+ }
17
+ function trimUrl(value) {
18
+ return value.trim().replace(/\/+$/, "");
19
+ }
20
+ /** Протокол по базовому URL — то же правило, что в `classifyNotification`. */
21
+ export function protocolFor(baseUrl) {
22
+ const trimmed = trimUrl(baseUrl);
23
+ return /\/v1$/i.test(trimmed) ? "openai" : "ollama";
24
+ }
25
+ /**
26
+ * Сливает патч с текущими настройками. Возвращает новые настройки и
27
+ * список имён изменённых полей (для ответа инструмента и аудита).
28
+ */
29
+ export function applyLocalAiPatch(current, patch) {
30
+ const next = { ...current, shadow: { ...current.shadow } };
31
+ const changed = [];
32
+ if (patch.mode !== undefined && patch.mode !== current.mode) {
33
+ next.mode = patch.mode;
34
+ changed.push("mode");
35
+ }
36
+ if (patch.baseUrl !== undefined) {
37
+ const baseUrl = trimUrl(patch.baseUrl);
38
+ if (baseUrl !== current.baseUrl) {
39
+ next.baseUrl = baseUrl;
40
+ changed.push("baseUrl");
41
+ }
42
+ }
43
+ if (patch.model !== undefined) {
44
+ const model = patch.model.trim().slice(0, 200);
45
+ if (model !== current.model) {
46
+ next.model = model;
47
+ changed.push("model");
48
+ }
49
+ }
50
+ if (patch.timeoutMs !== undefined) {
51
+ const timeoutMs = clamp(patch.timeoutMs, LOCAL_AI_TIMEOUT_MIN, LOCAL_AI_TIMEOUT_MAX, current.timeoutMs);
52
+ if (timeoutMs !== current.timeoutMs) {
53
+ next.timeoutMs = timeoutMs;
54
+ changed.push("timeoutMs");
55
+ }
56
+ }
57
+ if (patch.fallback !== undefined && patch.fallback !== current.fallback) {
58
+ next.fallback = patch.fallback;
59
+ changed.push("fallback");
60
+ }
61
+ if (patch.confidenceThreshold !== undefined) {
62
+ const threshold = clamp(patch.confidenceThreshold, 0, 1, current.confidenceThreshold);
63
+ if (threshold !== current.confidenceThreshold) {
64
+ next.confidenceThreshold = threshold;
65
+ changed.push("confidenceThreshold");
66
+ }
67
+ }
68
+ const shadow = next.shadow ?? {
69
+ enabled: false,
70
+ days: DEFAULT_SHADOW_DAYS,
71
+ startedAt: null,
72
+ };
73
+ const shadowPatch = patch.shadow;
74
+ if (shadowPatch && typeof shadowPatch === "object") {
75
+ if (shadowPatch.enabled !== undefined && Boolean(shadowPatch.enabled) !== shadow.enabled) {
76
+ shadow.enabled = Boolean(shadowPatch.enabled);
77
+ changed.push("shadow.enabled");
78
+ }
79
+ if (shadowPatch.days !== undefined) {
80
+ const days = clamp(shadowPatch.days, 1, 365, shadow.days);
81
+ if (days !== shadow.days) {
82
+ shadow.days = days;
83
+ changed.push("shadow.days");
84
+ }
85
+ }
86
+ if (shadowPatch.startedAt !== undefined && shadowPatch.startedAt !== shadow.startedAt) {
87
+ shadow.startedAt = shadowPatch.startedAt;
88
+ changed.push("shadow.startedAt");
89
+ }
90
+ }
91
+ next.shadow = shadow;
92
+ return { settings: next, changed };
93
+ }
94
+ /** Компактная сводка настроек для ответа инструмента. */
95
+ export function summarizeLocalAi(settings) {
96
+ const shadow = settings.shadow ?? {
97
+ enabled: false,
98
+ days: DEFAULT_SHADOW_DAYS,
99
+ startedAt: null,
100
+ };
101
+ const baseUrl = settings.baseUrl ?? "";
102
+ const model = settings.model ?? "";
103
+ return {
104
+ mode: settings.mode,
105
+ baseUrl,
106
+ model,
107
+ timeoutMs: settings.timeoutMs,
108
+ fallback: settings.fallback,
109
+ confidenceThreshold: settings.confidenceThreshold,
110
+ rules: Array.isArray(settings.rules) ? settings.rules.length : null,
111
+ shadow,
112
+ llmReady: settings.mode !== "off" &&
113
+ settings.mode !== "rules" &&
114
+ baseUrl.trim().length > 0 &&
115
+ model.trim().length > 0,
116
+ shadowActive: isShadowActive(shadow),
117
+ protocol: protocolFor(baseUrl),
118
+ };
119
+ }
@@ -0,0 +1,57 @@
1
+ /**
2
+ * Менеджер файловых блокировок для предотвращения наложения запусков одной задачи.
3
+ *
4
+ * Блокировка реализуется через атомарное создание файла с флагом 'wx' (exclusive create).
5
+ * Если файл уже существует — блокировка удерживается другим запуском.
6
+ * После завершения задачи файл удаляется.
7
+ * Зависшие блокировки (старше STALE_LOCK_MAX_AGE_MS) удаляются при инициализации.
8
+ */
9
+ export declare class LockManager {
10
+ private readonly lockDir;
11
+ constructor(lockDir?: string);
12
+ /** Имя lock-файла для задачи. */
13
+ private lockFileName;
14
+ /** Полный путь к lock-файлу задачи. */
15
+ private lockFilePath;
16
+ /** Публичный путь к lock-файлу (для ожидания/вытеснения зависших lock). */
17
+ pathFor(taskName: string): string;
18
+ /**
19
+ * Инициализация директории блокировок и очистка зависших (старых) файлов.
20
+ * Вызывается при старте плагина.
21
+ */
22
+ initialize(): Promise<void>;
23
+ /**
24
+ * Пытается захватить блокировку для задачи.
25
+ * Возвращает true, если блокировка захвачена (файл создан).
26
+ * Возвращает false, если блокировка уже удерживается другим запуском.
27
+ */
28
+ acquire(taskName: string): Promise<boolean>;
29
+ /**
30
+ * Освобождает блокировку задачи (удаляет lock-файл).
31
+ * Не выбрасывает ошибку, если файл уже удалён.
32
+ */
33
+ release(taskName: string): Promise<void>;
34
+ /**
35
+ * Проверяет, удерживается ли блокировка задачей в данный момент.
36
+ */
37
+ isLocked(taskName: string): Promise<boolean>;
38
+ }
39
+ /**
40
+ * Выполняет функцию с захватом файловых блокировок.
41
+ * Если блокировка уже удерживается — пропускает выполнение и возвращает null.
42
+ * Гарантирует освобождение блокировки в finally (включая при ошибках).
43
+ */
44
+ export declare function withLock<T>(lockManager: LockManager, taskName: string, fn: () => Promise<T>): Promise<T | null>;
45
+ /**
46
+ * Выполняет функцию с ожиданием освобождения файловой блокировки.
47
+ * В отличие от withLock не пропускает выполнение, а ждёт: критично для
48
+ * read-modify-write операций (crontab), где пропуск ломает состояние.
49
+ * Если lock удерживается дольше staleMs — считается осиротевшим и вытесняется
50
+ * атомарным rename (как в T-03), чтобы зависший процесс не блокировал навсегда.
51
+ */
52
+ export declare function withLockWait<T>(lockManager: LockManager, taskName: string, fn: () => Promise<T>, options?: {
53
+ timeoutMs?: number;
54
+ retryDelayMs?: number;
55
+ staleMs?: number;
56
+ }): Promise<T>;
57
+ //# sourceMappingURL=lock.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"lock.d.ts","sourceRoot":"","sources":["../../src/core/lock.ts"],"names":[],"mappings":"AAIA;;;;;;;GAOG;AACH,qBAAa,WAAW;IACtB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;gBAErB,OAAO,GAAE,MAAiB;IAItC,iCAAiC;IACjC,OAAO,CAAC,YAAY;IAIpB,uCAAuC;IACvC,OAAO,CAAC,YAAY;IAIpB,2EAA2E;IAC3E,OAAO,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM;IAIjC;;;OAGG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAiDjC;;;;OAIG;IACG,OAAO,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAgBjD;;;OAGG;IACG,OAAO,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAS9C;;OAEG;IACG,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;CAUnD;AAED;;;;GAIG;AACH,wBAAsB,QAAQ,CAAC,CAAC,EAC9B,WAAW,EAAE,WAAW,EACxB,QAAQ,EAAE,MAAM,EAChB,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GACnB,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC,CAenB;AAED;;;;;;GAMG;AACH,wBAAsB,YAAY,CAAC,CAAC,EAClC,WAAW,EAAE,WAAW,EACxB,QAAQ,EAAE,MAAM,EAChB,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EACpB,OAAO,GAAE;IAAE,SAAS,CAAC,EAAE,MAAM,CAAC;IAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAO,GAC5E,OAAO,CAAC,CAAC,CAAC,CA4CZ"}
@@ -0,0 +1,193 @@
1
+ import fs from "node:fs/promises";
2
+ import path from "node:path";
3
+ import { LOCK_DIR, STALE_LOCK_MAX_AGE_MS } from "../types.js";
4
+ /**
5
+ * Менеджер файловых блокировок для предотвращения наложения запусков одной задачи.
6
+ *
7
+ * Блокировка реализуется через атомарное создание файла с флагом 'wx' (exclusive create).
8
+ * Если файл уже существует — блокировка удерживается другим запуском.
9
+ * После завершения задачи файл удаляется.
10
+ * Зависшие блокировки (старше STALE_LOCK_MAX_AGE_MS) удаляются при инициализации.
11
+ */
12
+ export class LockManager {
13
+ constructor(lockDir = LOCK_DIR) {
14
+ this.lockDir = lockDir;
15
+ }
16
+ /** Имя lock-файла для задачи. */
17
+ lockFileName(taskName) {
18
+ return `${taskName}.lock`;
19
+ }
20
+ /** Полный путь к lock-файлу задачи. */
21
+ lockFilePath(taskName) {
22
+ return path.join(this.lockDir, this.lockFileName(taskName));
23
+ }
24
+ /** Публичный путь к lock-файлу (для ожидания/вытеснения зависших lock). */
25
+ pathFor(taskName) {
26
+ return this.lockFilePath(taskName);
27
+ }
28
+ /**
29
+ * Инициализация директории блокировок и очистка зависших (старых) файлов.
30
+ * Вызывается при старте плагина.
31
+ */
32
+ async initialize() {
33
+ await fs.mkdir(this.lockDir, { recursive: true });
34
+ const files = await fs.readdir(this.lockDir).catch(() => []);
35
+ const now = Date.now();
36
+ for (const file of files) {
37
+ const fullPath = path.join(this.lockDir, file);
38
+ // Каталог <task>.lock.d держит POSIX-обёртка (mkdir-блокировка).
39
+ // После kill -9 он остаётся навсегда, поэтому чистим его так же, как .lock.
40
+ const isLockFile = file.endsWith(".lock");
41
+ const isLockDir = file.endsWith(".lock.d");
42
+ const isStaleArtifact = /\.lock(\.d)?\.stale-/.test(file);
43
+ if (!isLockFile && !isLockDir && !isStaleArtifact)
44
+ continue;
45
+ try {
46
+ // Артефакт предыдущего вытеснения валидным lock быть не может,
47
+ // поэтому убираем его независимо от возраста.
48
+ if (isStaleArtifact) {
49
+ await fs.rm(fullPath, { recursive: true, force: true }).catch(() => { });
50
+ continue;
51
+ }
52
+ const stat = await fs.stat(fullPath);
53
+ const age = now - stat.mtimeMs;
54
+ if (age > STALE_LOCK_MAX_AGE_MS) {
55
+ // T-03: не удаляем lock напрямую. Два воркера могли одновременно
56
+ // снести один и тот же файл, после чего один из них удалял свежий
57
+ // lock, созданный другим, и задача запускалась повторно. Атомарный
58
+ // rename в уникальное имя выигрывает только один процесс; второй
59
+ // получает ENOENT и не трогает чужой lock.
60
+ const stalePath = `${fullPath}.stale-${process.pid}-${Date.now()}`;
61
+ try {
62
+ await fs.rename(fullPath, stalePath);
63
+ }
64
+ catch {
65
+ continue;
66
+ }
67
+ await fs.rm(stalePath, { recursive: true, force: true }).catch(() => { });
68
+ console.log(`[agent-steward] Вытеснен зависший lock: ${file} (возраст ${Math.round(age / 1000)} с)`);
69
+ }
70
+ }
71
+ catch {
72
+ // Игнорируем ошибки чтения отдельных файлов при очистке.
73
+ }
74
+ }
75
+ }
76
+ /**
77
+ * Пытается захватить блокировку для задачи.
78
+ * Возвращает true, если блокировка захвачена (файл создан).
79
+ * Возвращает false, если блокировка уже удерживается другим запуском.
80
+ */
81
+ async acquire(taskName) {
82
+ await fs.mkdir(this.lockDir, { recursive: true });
83
+ const lockPath = this.lockFilePath(taskName);
84
+ try {
85
+ // 'wx' — exclusive create: ошибка если файл уже существует.
86
+ await fs.writeFile(lockPath, String(Date.now()), { flag: "wx" });
87
+ return true;
88
+ }
89
+ catch (err) {
90
+ if (err.code === "EEXIST") {
91
+ return false;
92
+ }
93
+ throw err;
94
+ }
95
+ }
96
+ /**
97
+ * Освобождает блокировку задачи (удаляет lock-файл).
98
+ * Не выбрасывает ошибку, если файл уже удалён.
99
+ */
100
+ async release(taskName) {
101
+ const lockPath = this.lockFilePath(taskName);
102
+ try {
103
+ await fs.unlink(lockPath);
104
+ }
105
+ catch (err) {
106
+ if (err.code !== "ENOENT")
107
+ throw err;
108
+ }
109
+ }
110
+ /**
111
+ * Проверяет, удерживается ли блокировка задачей в данный момент.
112
+ */
113
+ async isLocked(taskName) {
114
+ const lockPath = this.lockFilePath(taskName);
115
+ try {
116
+ await fs.stat(lockPath);
117
+ return true;
118
+ }
119
+ catch (err) {
120
+ if (err.code === "ENOENT")
121
+ return false;
122
+ throw err;
123
+ }
124
+ }
125
+ }
126
+ /**
127
+ * Выполняет функцию с захватом файловых блокировок.
128
+ * Если блокировка уже удерживается — пропускает выполнение и возвращает null.
129
+ * Гарантирует освобождение блокировки в finally (включая при ошибках).
130
+ */
131
+ export async function withLock(lockManager, taskName, fn) {
132
+ const acquired = await lockManager.acquire(taskName);
133
+ if (!acquired) {
134
+ console.log(`[agent-steward] Запуск задачи "${taskName}" пропущен: удерживается активная блокировка.`);
135
+ return null;
136
+ }
137
+ try {
138
+ return await fn();
139
+ }
140
+ finally {
141
+ await lockManager.release(taskName);
142
+ }
143
+ }
144
+ /**
145
+ * Выполняет функцию с ожиданием освобождения файловой блокировки.
146
+ * В отличие от withLock не пропускает выполнение, а ждёт: критично для
147
+ * read-modify-write операций (crontab), где пропуск ломает состояние.
148
+ * Если lock удерживается дольше staleMs — считается осиротевшим и вытесняется
149
+ * атомарным rename (как в T-03), чтобы зависший процесс не блокировал навсегда.
150
+ */
151
+ export async function withLockWait(lockManager, taskName, fn, options = {}) {
152
+ const timeoutMs = options.timeoutMs ?? 15000;
153
+ const retryDelayMs = options.retryDelayMs ?? 50;
154
+ const staleMs = options.staleMs ?? 60000;
155
+ const deadline = Date.now() + timeoutMs;
156
+ const lockPath = lockManager.pathFor(taskName);
157
+ for (;;) {
158
+ if (await lockManager.acquire(taskName))
159
+ break;
160
+ // Осиротевший lock: короткая операция не может длиться дольше staleMs.
161
+ if (staleMs > 0) {
162
+ try {
163
+ const stat = await fs.stat(lockPath);
164
+ if (Date.now() - stat.mtimeMs > staleMs) {
165
+ // T-03-совместимое вытеснение: атомарный rename выигрывает ровно
166
+ // один процесс, остальные получают ENOENT и повторяют попытку.
167
+ const stalePath = `${lockPath}.stale-${process.pid}-${Date.now()}`;
168
+ try {
169
+ await fs.rename(lockPath, stalePath);
170
+ await fs.rm(stalePath, { force: true }).catch(() => { });
171
+ }
172
+ catch {
173
+ // Кто-то успел раньше — просто повторяем acquire.
174
+ }
175
+ continue;
176
+ }
177
+ }
178
+ catch {
179
+ // lock исчез — сразу пробуем acquire снова.
180
+ }
181
+ }
182
+ if (Date.now() >= deadline) {
183
+ throw new Error(`Не удалось получить блокировку "${taskName}" за ${timeoutMs} мс.`);
184
+ }
185
+ await new Promise((resolve) => setTimeout(resolve, retryDelayMs));
186
+ }
187
+ try {
188
+ return await fn();
189
+ }
190
+ finally {
191
+ await lockManager.release(taskName);
192
+ }
193
+ }
@@ -0,0 +1,167 @@
1
+ import type { MatrixConfig, TaskDefinition } from "../task-transfer.js";
2
+ /** Суффикс агрегирующей задачи, запускаемой после всех клонов. */
3
+ export declare const MATRIX_COMPLETE_SUFFIX = "-matrix-complete";
4
+ /** Имя клона: <родитель>-matrix-<workspace>. */
5
+ export declare function matrixCloneName(parentName: string, workspaceName: string): string;
6
+ /** Имя агрегирующей задачи matrix-complete. */
7
+ export declare function matrixCompleteName(parentName: string): string;
8
+ /** Проверяет, является ли имя агрегатором матрицы. */
9
+ export declare function isMatrixCompleteName(name: string): boolean;
10
+ /**
11
+ * Разворачивает задачу-шаблон в список клонов (без записи в БД).
12
+ * Бросает ошибку, если workspace не найден или список пуст.
13
+ */
14
+ export declare function expandMatrixTask(task: TaskDefinition): TaskDefinition[];
15
+ export interface MatrixCloneResult {
16
+ name: string;
17
+ workspaceId: string | null;
18
+ workspaceName: string | null;
19
+ status: string;
20
+ error: string | null;
21
+ finishedAt: string | null;
22
+ }
23
+ export interface MatrixAggregate {
24
+ parentId: string;
25
+ totalCount: number;
26
+ successCount: number;
27
+ errorCount: number;
28
+ pendingCount: number;
29
+ /** success | error | partial | running */
30
+ status: "success" | "error" | "partial" | "running" | "empty";
31
+ message: string;
32
+ clones: MatrixCloneResult[];
33
+ }
34
+ /** Собирает результаты клонов и вычисляет агрегированный статус. */
35
+ export declare function aggregateMatrixResults(parentId: string): MatrixAggregate;
36
+ export interface MatrixRunResult {
37
+ success: boolean;
38
+ parent: string;
39
+ strategy: "parallel" | "sequential";
40
+ started: string[];
41
+ skipped: string[];
42
+ /** Клоны, отложенные из-за matrix.concurrency (запустятся по мере завершения). */
43
+ queued: string[];
44
+ errors: string[];
45
+ }
46
+ /** Эффективный лимит одновременных клонов матрицы (Спринт 17). */
47
+ export declare function resolveMatrixConcurrency(matrix: MatrixConfig | undefined, totalClones: number): number;
48
+ /**
49
+ * Запускает клоны матрицы.
50
+ * - parallel: все клоны сразу, но не больше matrix.concurrency одновременно
51
+ * (остальные — в очереди matrixQueue на родителе);
52
+ * - sequential: только первый, остальные — по завершении предыдущего.
53
+ * - failureMode "stop": при ошибке немедленного запуска остальные не стартуют.
54
+ */
55
+ export declare function runMatrix(task: TaskDefinition): Promise<MatrixRunResult>;
56
+ /**
57
+ * Продолжает последовательную матрицу: запускает следующий клон после
58
+ * завершения текущего. Вызывается из record-history после финиша клона.
59
+ * Возвращает имя запущенного клона или undefined.
60
+ */
61
+ export declare function advanceSequentialMatrix(cloneName: string): Promise<string | undefined>;
62
+ /**
63
+ * Продолжает матрицу после завершения клона (Спринт 17):
64
+ * - sequential — запускает следующий клон по порядку workspaceIds;
65
+ * - parallel с matrix.concurrency — добирает клоны из очереди matrixQueue,
66
+ * пока не заполнены свободные слоты.
67
+ * Возвращает имена запущенных клонов.
68
+ */
69
+ export declare function advanceMatrixAfterClone(cloneName: string): Promise<string[]>;
70
+ /**
71
+ * Создаёт (или обновляет) виртуальную задачу matrix-complete:
72
+ * без workspace, dependsOn = все клоны. Запускается DAG-движком,
73
+ * когда все клоны успешны.
74
+ */
75
+ export declare function ensureMatrixCompleteTask(parent: TaskDefinition): TaskDefinition | undefined;
76
+ /** Удаляет клоны и агрегатор (используется при пересоздании матрицы). */
77
+ export declare function removeMatrixChildren(parentName: string): string[];
78
+ /** План синхронизации семьи матрицы с её текущим определением. */
79
+ export interface MatrixSyncPlan {
80
+ parent: TaskDefinition;
81
+ /** Какими клоны должны быть по текущему определению. */
82
+ desired: TaskDefinition[];
83
+ create: TaskDefinition[];
84
+ update: TaskDefinition[];
85
+ remove: string[];
86
+ /** Клоны в статусе running — их нельзя менять/удалять. */
87
+ running: string[];
88
+ warnings: string[];
89
+ }
90
+ /**
91
+ * Сравнивает текущих клонов матрицы с тем, что должно быть по определению
92
+ * родителя (workspaceIds/overrides/общие поля). Ничего не меняет в БД/ОС.
93
+ */
94
+ export declare function planMatrixSync(parent: TaskDefinition): MatrixSyncPlan;
95
+ /** Колбэки для применения плана синхронизации (реализуются в index.ts). */
96
+ export interface MatrixSyncHooks {
97
+ removeChild?(name: string): Promise<void> | void;
98
+ createChild?(definition: TaskDefinition): Promise<void> | void;
99
+ updateChild?(definition: TaskDefinition): Promise<void> | void;
100
+ /** Пересоздать/обновить/удалить агрегатор; возвращает имя или undefined. */
101
+ syncAggregator?(parent: TaskDefinition): Promise<string | undefined> | string | undefined;
102
+ }
103
+ export interface MatrixSyncResult {
104
+ parent: string;
105
+ created: string[];
106
+ updated: string[];
107
+ removed: string[];
108
+ running: string[];
109
+ warnings: string[];
110
+ aggregator?: string;
111
+ }
112
+ /**
113
+ * Синхронизирует клонов матрицы с её текущим определением, не удаляя
114
+ * выполняющиеся клоны. Используется при update_task матрицы (Спринт 17).
115
+ */
116
+ export declare function syncMatrixFamily(parent: TaskDefinition, hooks?: MatrixSyncHooks): Promise<MatrixSyncResult>;
117
+ /** Имя родителя по имени агрегатора (`<parent>-matrix-complete`). */
118
+ export declare function matrixParentOfCompleteTask(taskName: string): string | undefined;
119
+ /**
120
+ * План каскадного удаления: для матрицы-родителя возвращает её клоны
121
+ * и агрегатор. Для обычной задачи/клона возвращает undefined.
122
+ */
123
+ export interface MatrixFamilyPlan {
124
+ parent: string;
125
+ children: string[];
126
+ }
127
+ export declare function planMatrixFamilyDelete(taskName: string): MatrixFamilyPlan | undefined;
128
+ /**
129
+ * Защита от ручного удаления клона: клон живёт только в составе матрицы,
130
+ * поэтому удалять его поодиночке нельзя — иначе родитель останется
131
+ * с «пустым» workspace в списке и навсегда в статусе running.
132
+ * Возвращает текст ошибки или undefined, если удаление разрешено.
133
+ */
134
+ export declare function getMatrixDeletionGuard(taskName: string): string | undefined;
135
+ /**
136
+ * Осиротевшие задачи матриц: клоны, чей родитель уже удалён, и агрегаторы,
137
+ * у которых больше нет родителя-матрицы. Такие задачи нельзя запустить и
138
+ * они навсегда остаются в списке — их нужно вычищать.
139
+ */
140
+ export declare function findOrphanedMatrixTasks(): string[];
141
+ /** Результат отмены выполняющейся матрицы. */
142
+ export interface MatrixCancelResult {
143
+ parent: string;
144
+ /** Клоны, которые были незавершены и помечены отменой. */
145
+ cancelled: string[];
146
+ /** Из них те, что были в статусе running (их процесс нужно остановить). */
147
+ running: string[];
148
+ /** Клоны, которые уже завершились и не тронуты отменой. */
149
+ alreadyFinished: string[];
150
+ aggregate: MatrixAggregate;
151
+ }
152
+ /**
153
+ * Отмена матрицы «одной кнопкой»: все незавершённые клоны помечаются
154
+ * error-записью в истории с причиной отмены, после чего родителю пишется
155
+ * агрегированный итог. Реальные процессы клонов останавливает вызывающая
156
+ * сторона (index.ts), т.к. для этого нужен бэкенд планировщика ОС.
157
+ */
158
+ export declare function cancelPendingMatrixClones(parentName: string, reason?: string): Promise<MatrixCancelResult>;
159
+ /** Санитизированное имя клона для файлов промптов/обёрток. */
160
+ export declare function cloneFileKey(cloneName: string): string;
161
+ /**
162
+ * Вызывается после завершения клона: если все клоны матрицы уже финишировали,
163
+ * пишет агрегированную запись истории для родителя (status может быть
164
+ * success/error/partial) и запускает matrix-complete, если он создан.
165
+ */
166
+ export declare function finalizeMatrixIfComplete(cloneName: string): Promise<MatrixAggregate | undefined>;
167
+ //# sourceMappingURL=matrix.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"matrix.d.ts","sourceRoot":"","sources":["../../src/core/matrix.ts"],"names":[],"mappings":"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"}