agent-steward 0.0.4 → 0.0.6

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 (279) hide show
  1. package/CHANGELOG.md +309 -2
  2. package/CROSS_PLATFORM.md +19 -0
  3. package/README.md +55 -8
  4. package/ROADMAP-STRATEGY.md +22 -19
  5. package/ROADMAP.md +230 -159
  6. package/dist/cli.d.ts +3 -0
  7. package/dist/cli.d.ts.map +1 -0
  8. package/dist/cli.js +356 -0
  9. package/dist/core/analytics.d.ts +6 -0
  10. package/dist/core/analytics.d.ts.map +1 -1
  11. package/dist/core/analytics.js +20 -3
  12. package/dist/core/audit.d.ts +6 -0
  13. package/dist/core/audit.d.ts.map +1 -1
  14. package/dist/core/audit.js +24 -0
  15. package/dist/core/budget.d.ts +118 -0
  16. package/dist/core/budget.d.ts.map +1 -0
  17. package/dist/core/budget.js +206 -0
  18. package/dist/core/cron-to-schtasks.d.ts.map +1 -1
  19. package/dist/core/cron-to-schtasks.js +38 -0
  20. package/dist/core/dry-run.d.ts +26 -1
  21. package/dist/core/dry-run.d.ts.map +1 -1
  22. package/dist/core/dry-run.js +199 -8
  23. package/dist/core/execution.d.ts +203 -0
  24. package/dist/core/execution.d.ts.map +1 -0
  25. package/dist/core/execution.js +309 -0
  26. package/dist/core/feedback.d.ts +192 -0
  27. package/dist/core/feedback.d.ts.map +1 -0
  28. package/dist/core/feedback.js +426 -0
  29. package/dist/core/gate-integrity.d.ts +71 -0
  30. package/dist/core/gate-integrity.d.ts.map +1 -0
  31. package/dist/core/gate-integrity.js +275 -0
  32. package/dist/core/git-trigger.d.ts.map +1 -1
  33. package/dist/core/git-trigger.js +14 -2
  34. package/dist/core/guard-run.d.ts +4 -0
  35. package/dist/core/guard-run.d.ts.map +1 -0
  36. package/dist/core/guard-run.js +101 -0
  37. package/dist/core/guard.d.ts +52 -0
  38. package/dist/core/guard.d.ts.map +1 -0
  39. package/dist/core/guard.js +362 -0
  40. package/dist/core/local-ai.d.ts.map +1 -1
  41. package/dist/core/local-ai.js +7 -3
  42. package/dist/core/lock.d.ts +41 -0
  43. package/dist/core/lock.d.ts.map +1 -1
  44. package/dist/core/lock.js +141 -29
  45. package/dist/core/matrix.d.ts +8 -0
  46. package/dist/core/matrix.d.ts.map +1 -1
  47. package/dist/core/matrix.js +132 -17
  48. package/dist/core/mission.d.ts +103 -0
  49. package/dist/core/mission.d.ts.map +1 -0
  50. package/dist/core/mission.js +374 -0
  51. package/dist/core/opencode-models.d.ts +2 -2
  52. package/dist/core/opencode-models.d.ts.map +1 -1
  53. package/dist/core/opencode-models.js +28 -21
  54. package/dist/core/opencode-usage.d.ts +35 -0
  55. package/dist/core/opencode-usage.d.ts.map +1 -0
  56. package/dist/core/opencode-usage.js +132 -0
  57. package/dist/core/pipeline-apply.d.ts +38 -0
  58. package/dist/core/pipeline-apply.d.ts.map +1 -0
  59. package/dist/core/pipeline-apply.js +117 -0
  60. package/dist/core/pipeline-io.d.ts +13 -0
  61. package/dist/core/pipeline-io.d.ts.map +1 -0
  62. package/dist/core/pipeline-io.js +78 -0
  63. package/dist/core/pipeline-map.d.ts +52 -0
  64. package/dist/core/pipeline-map.d.ts.map +1 -0
  65. package/dist/core/pipeline-map.js +208 -0
  66. package/dist/core/pipeline-spec.d.ts +109 -0
  67. package/dist/core/pipeline-spec.d.ts.map +1 -0
  68. package/dist/core/pipeline-spec.js +554 -0
  69. package/dist/core/ps-wrapper.d.ts +27 -2
  70. package/dist/core/ps-wrapper.d.ts.map +1 -1
  71. package/dist/core/ps-wrapper.js +424 -65
  72. package/dist/core/record-history.d.ts.map +1 -1
  73. package/dist/core/record-history.js +206 -33
  74. package/dist/core/router/rules.d.ts.map +1 -1
  75. package/dist/core/router/rules.js +6 -0
  76. package/dist/core/run-mode.d.ts +12 -0
  77. package/dist/core/run-mode.d.ts.map +1 -0
  78. package/dist/core/run-mode.js +17 -0
  79. package/dist/core/scheduler/linux.d.ts +8 -1
  80. package/dist/core/scheduler/linux.d.ts.map +1 -1
  81. package/dist/core/scheduler/linux.js +34 -9
  82. package/dist/core/scheduler/logs.d.ts +4 -0
  83. package/dist/core/scheduler/logs.d.ts.map +1 -1
  84. package/dist/core/scheduler/logs.js +25 -1
  85. package/dist/core/scheduler/mac.d.ts +44 -2
  86. package/dist/core/scheduler/mac.d.ts.map +1 -1
  87. package/dist/core/scheduler/mac.js +126 -15
  88. package/dist/core/scheduler/windows.d.ts.map +1 -1
  89. package/dist/core/scheduler/windows.js +15 -12
  90. package/dist/core/secrets.d.ts.map +1 -1
  91. package/dist/core/secrets.js +18 -8
  92. package/dist/core/self-analysis.d.ts +32 -2
  93. package/dist/core/self-analysis.d.ts.map +1 -1
  94. package/dist/core/self-analysis.js +38 -27
  95. package/dist/core/shutdown.d.ts +33 -2
  96. package/dist/core/shutdown.d.ts.map +1 -1
  97. package/dist/core/shutdown.js +58 -2
  98. package/dist/core/structured-log.d.ts +37 -1
  99. package/dist/core/structured-log.d.ts.map +1 -1
  100. package/dist/core/structured-log.js +37 -0
  101. package/dist/core/usage-surface.d.ts +25 -0
  102. package/dist/core/usage-surface.d.ts.map +1 -0
  103. package/dist/core/usage-surface.js +41 -0
  104. package/dist/core/worktree-run.d.ts +4 -0
  105. package/dist/core/worktree-run.d.ts.map +1 -0
  106. package/dist/core/worktree-run.js +164 -0
  107. package/dist/core/worktree.d.ts +115 -0
  108. package/dist/core/worktree.d.ts.map +1 -0
  109. package/dist/core/worktree.js +462 -0
  110. package/dist/core/wrappers/bash.d.ts +19 -0
  111. package/dist/core/wrappers/bash.d.ts.map +1 -1
  112. package/dist/core/wrappers/bash.js +230 -27
  113. package/dist/db/capability-repo.d.ts +43 -2
  114. package/dist/db/capability-repo.d.ts.map +1 -1
  115. package/dist/db/capability-repo.js +96 -11
  116. package/dist/db/history-repo.d.ts +70 -5
  117. package/dist/db/history-repo.d.ts.map +1 -1
  118. package/dist/db/history-repo.js +170 -29
  119. package/dist/db/metrics-repo.d.ts +20 -2
  120. package/dist/db/metrics-repo.d.ts.map +1 -1
  121. package/dist/db/metrics-repo.js +35 -13
  122. package/dist/db/migrate.d.ts.map +1 -1
  123. package/dist/db/migrate.js +37 -17
  124. package/dist/db/recovery.d.ts +3 -1
  125. package/dist/db/recovery.d.ts.map +1 -1
  126. package/dist/db/recovery.js +11 -5
  127. package/dist/db/run-journal.d.ts +33 -5
  128. package/dist/db/run-journal.d.ts.map +1 -1
  129. package/dist/db/run-journal.js +78 -14
  130. package/dist/db/run-resume.d.ts +5 -0
  131. package/dist/db/run-resume.d.ts.map +1 -1
  132. package/dist/db/run-resume.js +9 -2
  133. package/dist/db/runs-repo.d.ts +19 -2
  134. package/dist/db/runs-repo.d.ts.map +1 -1
  135. package/dist/db/runs-repo.js +91 -60
  136. package/dist/db/schema.d.ts +2 -2
  137. package/dist/db/schema.d.ts.map +1 -1
  138. package/dist/db/schema.js +132 -2
  139. package/dist/db/templates-repo.d.ts +2 -2
  140. package/dist/db/templates-repo.d.ts.map +1 -1
  141. package/dist/db/templates-repo.js +5 -3
  142. package/dist/history.d.ts +7 -2
  143. package/dist/history.d.ts.map +1 -1
  144. package/dist/history.js +4 -2
  145. package/dist/hook-output.d.ts +2 -0
  146. package/dist/hook-output.d.ts.map +1 -0
  147. package/dist/hook-output.js +31 -0
  148. package/dist/i18n.d.ts +5 -0
  149. package/dist/i18n.d.ts.map +1 -1
  150. package/dist/i18n.js +11 -4
  151. package/dist/index.d.ts +375 -47
  152. package/dist/index.d.ts.map +1 -1
  153. package/dist/index.js +1344 -192
  154. package/dist/notifications.d.ts +53 -2
  155. package/dist/notifications.d.ts.map +1 -1
  156. package/dist/notifications.js +168 -21
  157. package/dist/profiles.d.ts.map +1 -1
  158. package/dist/profiles.js +82 -10
  159. package/dist/rpc.d.ts +354 -0
  160. package/dist/rpc.d.ts.map +1 -1
  161. package/dist/rpc.js +145 -0
  162. package/dist/server.d.ts +32 -2
  163. package/dist/server.d.ts.map +1 -1
  164. package/dist/server.js +154 -30
  165. package/dist/settings.d.ts +44 -2
  166. package/dist/settings.d.ts.map +1 -1
  167. package/dist/settings.js +85 -3
  168. package/dist/shared/jobs-view.d.ts +1 -1
  169. package/dist/shared/jobs-view.d.ts.map +1 -1
  170. package/dist/shared/jobs-view.js +2 -0
  171. package/dist/task-transfer.d.ts +21 -0
  172. package/dist/task-transfer.d.ts.map +1 -1
  173. package/dist/task-transfer.js +64 -3
  174. package/dist/templates.d.ts +2 -2
  175. package/dist/templates.d.ts.map +1 -1
  176. package/dist/templates.js +3 -3
  177. package/dist/types.d.ts +22 -2
  178. package/dist/types.d.ts.map +1 -1
  179. package/dist/workspaces.d.ts.map +1 -1
  180. package/dist/workspaces.js +34 -11
  181. package/docs/ARCHITECTURE.md +319 -66
  182. package/docs/COMPATIBILITY.md +2 -2
  183. package/docs/CONCEPT.md +18 -4
  184. package/docs/CROSS_PLATFORM.ru.md +20 -0
  185. package/docs/CROSS_PLATFORM.zh.md +18 -0
  186. package/docs/EXECUTION-LOOP.md +28 -10
  187. package/docs/FEATURES.md +129 -7
  188. package/docs/FEATURES.zh.md +97 -6
  189. package/docs/MIGRATION.md +2 -2
  190. package/docs/PIPELINE.md +293 -0
  191. package/docs/QA-A2-GUI-TUI.md +205 -0
  192. package/docs/README.ru.md +43 -4
  193. package/docs/README.zh.md +44 -4
  194. package/docs/SAFETY.md +23 -3
  195. package/gui-experimental.cjs +9 -8
  196. package/locales/en.json +58 -3
  197. package/locales/ru.json +58 -3
  198. package/locales/zh.json +58 -3
  199. package/opencode.pipeline.yaml +35 -0
  200. package/package.json +36 -4
  201. package/scripts/check-eslint-baseline.mjs +139 -0
  202. package/scripts/gen-test-plan-counters.mjs +117 -0
  203. package/scripts/github-ci-fetch.ps1 +37 -0
  204. package/scripts/pl-commit.ps1 +112 -0
  205. package/scripts/qa-a2-commit.ps1 +104 -0
  206. package/scripts/test-home.mjs +107 -0
  207. package/skills/scheduled-job-best-practices/SKILL.md +95 -1
  208. package/skills/scheduled-job-best-practices/references/recipes.md +139 -0
  209. package/src/cli.ts +417 -0
  210. package/src/core/analytics.ts +27 -4
  211. package/src/core/audit.ts +25 -0
  212. package/src/core/budget.ts +340 -0
  213. package/src/core/cron-to-schtasks.ts +42 -0
  214. package/src/core/dry-run.ts +235 -12
  215. package/src/core/execution.ts +538 -0
  216. package/src/core/feedback.ts +582 -0
  217. package/src/core/file-watcher.ts +2 -2
  218. package/src/core/gate-integrity.ts +330 -0
  219. package/src/core/git-trigger.ts +18 -5
  220. package/src/core/guard-run.ts +119 -0
  221. package/src/core/guard.ts +431 -0
  222. package/src/core/local-ai.ts +7 -3
  223. package/src/core/lock.ts +178 -37
  224. package/src/core/matrix.ts +158 -52
  225. package/src/core/mission.ts +531 -0
  226. package/src/core/native-notify.ts +1 -1
  227. package/src/core/opencode-models.ts +30 -21
  228. package/src/core/opencode-usage.ts +182 -0
  229. package/src/core/pipeline-apply.ts +158 -0
  230. package/src/core/pipeline-io.ts +96 -0
  231. package/src/core/pipeline-map.ts +283 -0
  232. package/src/core/pipeline-spec.ts +775 -0
  233. package/src/core/ps-wrapper.ts +435 -66
  234. package/src/core/record-history.ts +258 -81
  235. package/src/core/router/rules.ts +6 -0
  236. package/src/core/run-mode.ts +19 -0
  237. package/src/core/schedule-gate.ts +1 -1
  238. package/src/core/scheduler/at-fallback.ts +1 -1
  239. package/src/core/scheduler/linux.ts +40 -11
  240. package/src/core/scheduler/logs.ts +34 -3
  241. package/src/core/scheduler/mac.ts +174 -14
  242. package/src/core/scheduler/registry.ts +2 -2
  243. package/src/core/scheduler/windows.ts +19 -15
  244. package/src/core/secrets.ts +26 -19
  245. package/src/core/self-analysis.ts +75 -29
  246. package/src/core/shutdown.ts +90 -4
  247. package/src/core/structured-log.ts +89 -5
  248. package/src/core/telegram.ts +2 -2
  249. package/src/core/triage-worker.ts +7 -7
  250. package/src/core/triage.ts +2 -2
  251. package/src/core/usage-surface.ts +70 -0
  252. package/src/core/worktree-run.ts +199 -0
  253. package/src/core/worktree.ts +600 -0
  254. package/src/core/wrappers/bash.ts +248 -26
  255. package/src/db/capability-repo.ts +127 -10
  256. package/src/db/history-repo.ts +281 -40
  257. package/src/db/metrics-repo.ts +40 -13
  258. package/src/db/migrate.ts +57 -32
  259. package/src/db/recovery.ts +12 -5
  260. package/src/db/run-journal.ts +100 -13
  261. package/src/db/run-resume.ts +17 -1
  262. package/src/db/runs-repo.ts +147 -65
  263. package/src/db/schema.ts +134 -2
  264. package/src/db/templates-repo.ts +5 -3
  265. package/src/gui.tsx +438 -18
  266. package/src/history.ts +11 -4
  267. package/src/hook-output.ts +39 -0
  268. package/src/i18n.ts +12 -4
  269. package/src/index.ts +1902 -320
  270. package/src/notifications.ts +227 -47
  271. package/src/profiles.ts +88 -10
  272. package/src/rpc.ts +158 -0
  273. package/src/server.ts +201 -41
  274. package/src/settings.ts +125 -5
  275. package/src/shared/jobs-view.ts +3 -1
  276. package/src/task-transfer.ts +90 -6
  277. package/src/templates.ts +3 -3
  278. package/src/types.ts +23 -2
  279. package/src/workspaces.ts +37 -14
package/dist/core/lock.js CHANGED
@@ -2,6 +2,16 @@ import fs from "node:fs/promises";
2
2
  import path from "node:path";
3
3
  import { randomUUID } from "node:crypto";
4
4
  import { LOCK_DIR, STALE_LOCK_MAX_AGE_MS } from "../types.js";
5
+ /**
6
+ * O-2: ошибки очистки больше не проглатываются молча. Прямой импорт
7
+ * `structured-log.ts` создал бы цикл (structured-log → secrets → lock), поэтому
8
+ * здесь используется `console.warn` — предупреждение всё равно видно в логе
9
+ * процесса и не ломает основной сценарий.
10
+ */
11
+ function warnCleanupFailure(target, error) {
12
+ const reason = error instanceof Error ? error.message : String(error);
13
+ console.warn(`[agent-steward] Не удалось удалить lock-артефакт «${target}»: ${reason}`);
14
+ }
5
15
  /**
6
16
  * Проверяет, жив ли процесс-владелец lock-файла.
7
17
  *
@@ -23,13 +33,85 @@ export function isProcessAlive(pid) {
23
33
  return true;
24
34
  }
25
35
  }
26
- /** PID владельца из токена lock-файла (`<pid>-<timestamp>-<uuid>`). */
27
- function ownerPidFromToken(content) {
28
- const match = /^(\d+)-/.exec(content.trim());
29
- if (!match)
30
- return null;
31
- const pid = Number.parseInt(match[1], 10);
32
- return Number.isInteger(pid) ? pid : null;
36
+ /** Достаёт ISO-время из первой части legacy PS-токена (`ISO|PID`). */
37
+ function parseIsoOrNull(value) {
38
+ const text = String(value ?? "").trim();
39
+ return /^\d{4}-\d{2}-\d{2}T/.test(text) ? text : null;
40
+ }
41
+ /**
42
+ * Разбирает содержимое lock-файла в едином для Node/PS/bash виде.
43
+ *
44
+ * Поддерживаемые форматы:
45
+ * `<pid>-<iso>` — единый формат (Node и PS, B6);
46
+ * `<pid>-<epoch>-<uuid>` — старый Node-токен;
47
+ * `<iso>|<pid>` — старый PS-токен (ISO|PID);
48
+ * `<pid>` — голый PID (pid-файл bash-обёртки).
49
+ *
50
+ * Порядок важен: legacy PS проверяется до `<pid>-…`, иначе год из ISO
51
+ * (`2026`) принимался за PID — именно это ломало межпроцессную совместимость.
52
+ */
53
+ export function parseLockToken(content) {
54
+ const text = String(content ?? "").trim();
55
+ if (!text)
56
+ return { pid: null, createdAt: null, format: "unknown" };
57
+ const withPipe = text.indexOf("|");
58
+ if (withPipe !== -1) {
59
+ const pid = Number.parseInt(text.slice(withPipe + 1).trim(), 10);
60
+ return {
61
+ pid: Number.isInteger(pid) && pid > 0 ? pid : null,
62
+ createdAt: parseIsoOrNull(text.slice(0, withPipe)),
63
+ format: "ps-legacy",
64
+ };
65
+ }
66
+ const unified = /^(\d+)-(\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}(?:\.\d+)?Z)(?:-.*)?$/i.exec(text);
67
+ if (unified) {
68
+ const pid = Number.parseInt(unified[1], 10);
69
+ return {
70
+ pid: Number.isInteger(pid) && pid > 0 ? pid : null,
71
+ createdAt: unified[2],
72
+ format: "unified",
73
+ };
74
+ }
75
+ // Старый Node мог добавить любой суффикс после epoch (`-live-owner`, uuid).
76
+ const legacyNode = /^(\d+)-(\d{10,})(?:-.*)?$/i.exec(text);
77
+ if (legacyNode) {
78
+ const pid = Number.parseInt(legacyNode[1], 10);
79
+ return {
80
+ pid: Number.isInteger(pid) && pid > 0 ? pid : null,
81
+ createdAt: null,
82
+ format: "node-legacy",
83
+ };
84
+ }
85
+ if (/^\d+$/.test(text)) {
86
+ const pid = Number.parseInt(text, 10);
87
+ // Голое число — PID (pid-файл bash), но не epoch из старого тестового
88
+ // lock: 1.7e12 не может быть PID и раньше не распознавалось владельцем.
89
+ return {
90
+ pid: Number.isInteger(pid) && pid > 0 && pid <= 2147483647 ? pid : null,
91
+ createdAt: null,
92
+ format: "pid",
93
+ };
94
+ }
95
+ return { pid: null, createdAt: null, format: "unknown" };
96
+ }
97
+ /** PID владельца из токена lock-файла (любой поддерживаемый формат). */
98
+ export function ownerPidFromToken(content) {
99
+ return parseLockToken(content).pid;
100
+ }
101
+ /**
102
+ * PID владельца lock-артефакта.
103
+ *
104
+ * B7: файловый lock Node/PS хранит токен в самом файле, а POSIX-обёртка
105
+ * держит каталог `<lock>.d` и пишет `<pid>-<iso>` в `<lock>.d/pid`.
106
+ * Раньше каталог вытеснялся только по возрасту, без чтения этого файла,
107
+ * поэтому легально долгая задача (> 24 ч) после рестарта плагина
108
+ * дублировалась. Нет pid-файла/не разобрался — возвращаем null,
109
+ * и решение принимает возраст (fallback).
110
+ */
111
+ export async function readLockOwnerPid(lockPath, isDir) {
112
+ const tokenPath = isDir ? path.join(lockPath, "pid") : lockPath;
113
+ const content = await fs.readFile(tokenPath, "utf8").catch(() => "");
114
+ return ownerPidFromToken(content);
33
115
  }
34
116
  /**
35
117
  * Менеджер файловых блокировок для предотвращения наложения запусков одной задачи.
@@ -76,22 +158,21 @@ export class LockManager {
76
158
  // Артефакт предыдущего вытеснения валидным lock быть не может,
77
159
  // поэтому убираем его независимо от возраста.
78
160
  if (isStaleArtifact) {
79
- await fs.rm(fullPath, { recursive: true, force: true }).catch(() => { });
161
+ await fs.rm(fullPath, { recursive: true, force: true }).catch((err) => warnCleanupFailure(fullPath, err));
80
162
  continue;
81
163
  }
82
164
  const stat = await fs.stat(fullPath);
83
165
  const age = now - stat.mtimeMs;
84
166
  if (age > STALE_LOCK_MAX_AGE_MS) {
85
- // P2-18: возраст — только повод проверить владельца. Задача может
167
+ // P2-18/B7: возраст — только повод проверить владельца. Задача может
86
168
  // легально работать дольше 24 ч (timeoutSeconds: 0), поэтому живой
87
169
  // процесс не вытесняем: иначе после рестарта плагина появится дубль.
88
- if (isLockFile) {
89
- const content = await fs.readFile(fullPath, "utf8").catch(() => "");
90
- const ownerPid = ownerPidFromToken(content);
91
- if (ownerPid !== null && isProcessAlive(ownerPid)) {
92
- console.log(`[agent-steward] Lock ${file} старше ${Math.round(age / 1000)} с, но процесс ${ownerPid} жив — оставляем.`);
93
- continue;
94
- }
170
+ // B7: для каталога `.lock.d` владелец лежит в `<dir>/pid`, а не в
171
+ // самом файле; без этого проверка смотрела только на `.lock`.
172
+ const ownerPid = await readLockOwnerPid(fullPath, isLockDir);
173
+ if (ownerPid !== null && isProcessAlive(ownerPid)) {
174
+ console.log(`[agent-steward] Lock ${file} старше ${Math.round(age / 1000)} с, но процесс ${ownerPid} жив — оставляем.`);
175
+ continue;
95
176
  }
96
177
  // T-03: не удаляем lock напрямую. Два воркера могли одновременно
97
178
  // снести один и тот же файл, после чего один из них удалял свежий
@@ -105,7 +186,7 @@ export class LockManager {
105
186
  catch {
106
187
  continue;
107
188
  }
108
- await fs.rm(stalePath, { recursive: true, force: true }).catch(() => { });
189
+ await fs.rm(stalePath, { recursive: true, force: true }).catch((err) => warnCleanupFailure(stalePath, err));
109
190
  console.log(`[agent-steward] Вытеснен зависший lock: ${file} (возраст ${Math.round(age / 1000)} с)`);
110
191
  }
111
192
  }
@@ -125,19 +206,56 @@ export class LockManager {
125
206
  async acquire(taskName) {
126
207
  await fs.mkdir(this.lockDir, { recursive: true });
127
208
  const lockPath = this.lockFilePath(taskName);
128
- const token = `${process.pid}-${Date.now()}-${randomUUID()}`;
209
+ // B6: единый формат `<pid>-<iso>` (+ uuid для уникальности токена).
210
+ // PS-обёртка пишет тот же префикс, поэтому её stale-проверка видит PID,
211
+ // а не год из даты, и не вытесняет живой Node-лок.
212
+ const token = `${process.pid}-${new Date().toISOString()}-${randomUUID()}`;
129
213
  try {
130
214
  // 'wx' — exclusive create: ошибка если файл уже существует.
131
215
  await fs.writeFile(lockPath, token, { flag: "wx" });
132
216
  return token;
133
217
  }
134
218
  catch (err) {
135
- if (err.code === "EEXIST") {
219
+ // P3-39: на Windows конкурентный create/delete того же lock-файла
220
+ // возвращает EPERM/EACCES/EBUSY вместо EEXIST. Это тот же случай
221
+ // «блокировка занята», а не ошибка прав: отдаём null, а withLockWait
222
+ // повторит попытку (withLock корректно пропустит запуск).
223
+ if (err.code === "EEXIST" ||
224
+ err.code === "EPERM" ||
225
+ err.code === "EACCES" ||
226
+ err.code === "EBUSY") {
136
227
  return null;
137
228
  }
138
229
  throw err;
139
230
  }
140
231
  }
232
+ /**
233
+ * Удаляет lock-файл, переживая кратковременные Windows-блокировки.
234
+ *
235
+ * На Windows unlink может вернуть EPERM/EACCES/EBUSY, пока другой процесс
236
+ * читает файл (проверка владельца в withLockWait) или файл ещё «висящий»
237
+ * после создания. Несколько коротких повторов решают гонку; ENOENT — уже
238
+ * удалён, это не ошибка.
239
+ */
240
+ async unlinkWithRetry(lockPath, attempts = 6) {
241
+ for (let i = 0; i < attempts; i += 1) {
242
+ try {
243
+ await fs.unlink(lockPath);
244
+ return true;
245
+ }
246
+ catch (err) {
247
+ if (err.code === "ENOENT")
248
+ return false;
249
+ const transient = err.code === "EPERM" || err.code === "EACCES" || err.code === "EBUSY";
250
+ if (transient && i < attempts - 1) {
251
+ await new Promise((resolve) => setTimeout(resolve, 10 * (i + 1)));
252
+ continue;
253
+ }
254
+ throw err;
255
+ }
256
+ }
257
+ return false;
258
+ }
141
259
  /**
142
260
  * Освобождает блокировку задачи (удаляет lock-файл).
143
261
  *
@@ -159,15 +277,9 @@ export class LockManager {
159
277
  }
160
278
  if (current !== token)
161
279
  return false;
162
- try {
163
- await fs.unlink(lockPath);
164
- return true;
165
- }
166
- catch (err) {
167
- if (err.code === "ENOENT")
168
- return false;
169
- throw err;
170
- }
280
+ // P3-39: на Windows unlink может кратковременно упасть EPERM, пока
281
+ // другие процессы читают lock для проверки владельца.
282
+ return this.unlinkWithRetry(lockPath);
171
283
  }
172
284
  /**
173
285
  * Проверяет, удерживается ли блокировка задачей в данный момент.
@@ -240,7 +352,7 @@ export async function withLockWait(lockManager, taskName, fn, options = {}) {
240
352
  const stalePath = `${lockPath}.stale-${process.pid}-${Date.now()}`;
241
353
  try {
242
354
  await fs.rename(lockPath, stalePath);
243
- await fs.rm(stalePath, { force: true }).catch(() => { });
355
+ await fs.rm(stalePath, { force: true }).catch((err) => warnCleanupFailure(stalePath, err));
244
356
  }
245
357
  catch {
246
358
  // Кто-то успел раньше — просто повторяем acquire.
@@ -12,6 +12,14 @@ export declare function isMatrixCompleteName(name: string): boolean;
12
12
  * Бросает ошибку, если workspace не найден или список пуст.
13
13
  */
14
14
  export declare function expandMatrixTask(task: TaskDefinition): TaskDefinition[];
15
+ /**
16
+ * QA-P3.7: задача считается матрицей, если у неё есть конфиг `matrix` либо
17
+ * в истории есть записи с каноническим префиксом клона `<name>-matrix-`
18
+ * (включая агрегатор `-matrix-complete`). Проверка истории важна для QA-P1.2:
19
+ * определение родителя могло быть удалено, но запуски клонов остались, и
20
+ * matrix_control должен продолжать их показывать.
21
+ */
22
+ export declare function isKnownMatrix(name: string): boolean;
15
23
  export interface MatrixCloneResult {
16
24
  name: string;
17
25
  workspaceId: string | null;
@@ -1 +1 @@
1
- {"version":3,"file":"matrix.d.ts","sourceRoot":"","sources":["../../src/core/matrix.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"matrix.d.ts","sourceRoot":"","sources":["../../src/core/matrix.ts"],"names":[],"mappings":"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"}
@@ -11,11 +11,29 @@
11
11
  */
12
12
  import { sanitizeName } from "../types.js";
13
13
  import { getTask, listMatrixClones, listTasks, saveTask, } from "../db/tasks-repo.js";
14
- import { getHistory, recordRun } from "../db/history-repo.js";
14
+ import { getHistory, getLatestHistoryByTask, recordRun } from "../db/history-repo.js";
15
15
  import { notifyMatrixCompletion } from "../notifications.js";
16
16
  import { getWorkspace } from "../workspaces.js";
17
17
  import { createSchedulerBackend } from "./scheduler/index.js";
18
+ import { appendStructuredLog } from "./structured-log.js";
18
19
  import { t } from "../i18n.js";
20
+ /**
21
+ * Матричные события идут в machine-readable runs.jsonl: человекочитаемый
22
+ * вывод планировщика не позволяет связать клон с родителем и запуском.
23
+ */
24
+ function logMatrixEvent(parentName, step, details = {}) {
25
+ appendStructuredLog({
26
+ event: `matrix.${step}`,
27
+ task: parentName,
28
+ matrixId: parentName,
29
+ cloneName: details.cloneName,
30
+ step,
31
+ status: details.status,
32
+ reason: details.reason,
33
+ error: details.error,
34
+ runId: details.runId,
35
+ });
36
+ }
19
37
  /** Суффикс агрегирующей задачи, запускаемой после всех клонов. */
20
38
  export const MATRIX_COMPLETE_SUFFIX = "-matrix-complete";
21
39
  /** Имя клона: <родитель>-matrix-<workspace>. */
@@ -120,10 +138,65 @@ function latestCloneStatus(cloneName) {
120
138
  finishedAt: last.finishedAt ?? null,
121
139
  };
122
140
  }
141
+ /**
142
+ * QA-F.2: клон матрицы может остаться только в истории — определение удаляется
143
+ * при реконфигурации матрицы (`syncMatrixFamily`) или `cleanup`, но аналитика
144
+ * продолжает показывать задачу по имени. История не хранит `matrixParentId`,
145
+ * поэтому родитель восстанавливается из канонического префикса имени клона
146
+ * `<parent>-matrix-<workspace>` (тот же, что порождает `matrixCloneName`).
147
+ */
148
+ function listMatrixClonesFromHistory(parentId) {
149
+ const prefix = `${parentId.trim()}-matrix-`.toLowerCase();
150
+ const clones = [];
151
+ const seen = new Set();
152
+ for (const record of getLatestHistoryByTask(5000)) {
153
+ const name = record.taskName?.trim();
154
+ if (!name)
155
+ continue;
156
+ const key = name.toLowerCase();
157
+ // Агрегатор `-matrix-complete` тоже содержит префикс, но это не клон.
158
+ if (!key.startsWith(prefix) || isMatrixCompleteName(name) || seen.has(key))
159
+ continue;
160
+ seen.add(key);
161
+ clones.push({ name, workspaceId: record.workspaceId ?? null });
162
+ }
163
+ return clones;
164
+ }
165
+ /**
166
+ * QA-P3.7: задача считается матрицей, если у неё есть конфиг `matrix` либо
167
+ * в истории есть записи с каноническим префиксом клона `<name>-matrix-`
168
+ * (включая агрегатор `-matrix-complete`). Проверка истории важна для QA-P1.2:
169
+ * определение родителя могло быть удалено, но запуски клонов остались, и
170
+ * matrix_control должен продолжать их показывать.
171
+ */
172
+ export function isKnownMatrix(name) {
173
+ const trimmed = name.trim();
174
+ if (!trimmed)
175
+ return false;
176
+ if (getTask(trimmed)?.matrix)
177
+ return true;
178
+ const prefix = `${trimmed}-matrix-`.toLowerCase();
179
+ return getLatestHistoryByTask(5000).some((record) => (record.taskName ?? "").trim().toLowerCase().startsWith(prefix));
180
+ }
123
181
  /** Собирает результаты клонов и вычисляет агрегированный статус. */
124
182
  export function aggregateMatrixResults(parentId) {
125
183
  const parent = getTask(parentId);
126
- const clones = listMatrixClones(parentId);
184
+ const definedClones = listMatrixClones(parentId);
185
+ // QA-F.2 / QA-P1.2: объединяем определения с клонами, оставшимися только
186
+ // в истории, чтобы matrix_control показывал тот же набор, что и аналитика.
187
+ // История — независимый источник:definition родителя может быть удалён
188
+ // (например, при чистке сирот), но запуски клонов остаются в истории, и
189
+ // аналитика по-прежнему их видит. Раньше здесь стоял guard `parent ? … : []`,
190
+ // из-за которого live-матрица __matrixprobe__ показывала «нет клонов», хотя
191
+ // история содержала __matrixprobe__-matrix-__mw__. Пустой агрегат остаётся
192
+ // только когда нет ни определений, ни записей истории с каноническим
193
+ // префиксом <parent>-matrix-.
194
+ const historyClones = listMatrixClonesFromHistory(parentId);
195
+ const known = new Set(definedClones.map((clone) => clone.name.toLowerCase()));
196
+ const clones = [
197
+ ...definedClones,
198
+ ...historyClones.filter((clone) => !known.has(clone.name.toLowerCase())),
199
+ ];
127
200
  const failureMode = parent?.matrix?.failureMode ?? "continue";
128
201
  const results = clones.map((clone) => {
129
202
  const workspace = clone.workspaceId ? getWorkspace(clone.workspaceId) : undefined;
@@ -249,6 +322,7 @@ export async function runMatrix(task) {
249
322
  catch (err) {
250
323
  const message = err instanceof Error ? err.message : String(err);
251
324
  errors.push(`${clone.name}: ${message}`);
325
+ logMatrixEvent(task.name, "start_failed", { cloneName: clone.name, error: message });
252
326
  if (failureMode === "stop") {
253
327
  const rest = clones
254
328
  .slice(clones.indexOf(clone) + 1)
@@ -264,11 +338,16 @@ export async function runMatrix(task) {
264
338
  saveTask({ ...task, matrixQueue: queueToSave.length > 0 ? queueToSave : undefined });
265
339
  }
266
340
  catch (err) {
267
- console.log(`[matrix] ${task.name}: не удалось сохранить очередь: ${err instanceof Error ? err.message : String(err)}`);
341
+ logMatrixEvent(task.name, "queue_save_failed", {
342
+ error: err instanceof Error ? err.message : String(err),
343
+ });
268
344
  }
269
- console.log(`[matrix] ${task.name}: strategy=${strategy}, failureMode=${failureMode}, ` +
270
- `concurrency=${concurrency}, started=${started.length}, skipped=${skipped.length}, ` +
271
- `queued=${queueToSave.length}, errors=${errors.length}`);
345
+ logMatrixEvent(task.name, "started", {
346
+ status: started.length > 0 ? "running" : "error",
347
+ reason: `strategy=${strategy}, failureMode=${failureMode}, ` +
348
+ `concurrency=${concurrency}, started=${started.length}, skipped=${skipped.length}, ` +
349
+ `queued=${queueToSave.length}, errors=${errors.length}`,
350
+ });
272
351
  return {
273
352
  success: errors.length === 0 || failureMode === "continue",
274
353
  parent: task.name,
@@ -309,7 +388,10 @@ export async function advanceSequentialMatrix(cloneName) {
309
388
  if ((parent.matrix.failureMode ?? "continue") === "stop") {
310
389
  const latest = latestCloneStatus(cloneName);
311
390
  if (latest.status === "error") {
312
- console.log(`[matrix] ${parent.name}: sequential остановлена после ошибки ${cloneName}`);
391
+ logMatrixEvent(parent.name, "sequential_stopped", {
392
+ cloneName,
393
+ status: "error",
394
+ });
313
395
  return undefined;
314
396
  }
315
397
  }
@@ -320,12 +402,16 @@ export async function advanceSequentialMatrix(cloneName) {
320
402
  const result = await createSchedulerBackend().runTask(next.name);
321
403
  if (result.alreadyRunning)
322
404
  return undefined;
323
- console.log(`[matrix] ${parent.name}: sequential -> ${next.name}`);
405
+ logMatrixEvent(parent.name, "advanced", {
406
+ cloneName: next.name,
407
+ status: "running",
408
+ reason: "sequential",
409
+ });
324
410
  return next.name;
325
411
  }
326
412
  catch (err) {
327
413
  const message = err instanceof Error ? err.message : String(err);
328
- console.log(`[matrix] ${parent.name}: не удалось запустить ${next.name}: ${message}`);
414
+ logMatrixEvent(parent.name, "start_failed", { cloneName: next.name, error: message });
329
415
  return undefined;
330
416
  }
331
417
  }
@@ -369,11 +455,17 @@ export async function advanceMatrixAfterClone(cloneName) {
369
455
  slots -= 1;
370
456
  if (result.alreadyRunning)
371
457
  slots += 0; // слот уже занят этим клоном
372
- console.log(`[matrix] ${parent.name}: из очереди -> ${nextName}`);
458
+ logMatrixEvent(parent.name, "queue_started", {
459
+ cloneName: nextName,
460
+ status: "running",
461
+ });
373
462
  }
374
463
  catch (err) {
375
464
  const message = err instanceof Error ? err.message : String(err);
376
- console.log(`[matrix] ${parent.name}: не удалось запустить из очереди ${nextName}: ${message}`);
465
+ logMatrixEvent(parent.name, "queue_start_failed", {
466
+ cloneName: nextName,
467
+ error: message,
468
+ });
377
469
  // Попытка запуска «съедает» слот: иначе при недоступном бэкенде
378
470
  // цикл уйдёт по всей очереди, проигнорировав лимит.
379
471
  slots -= 1;
@@ -387,7 +479,9 @@ export async function advanceMatrixAfterClone(cloneName) {
387
479
  saveTask({ ...parent, matrixQueue: queue.length > 0 ? queue : undefined });
388
480
  }
389
481
  catch (err) {
390
- console.log(`[matrix] ${parent.name}: не удалось сохранить очередь: ${err instanceof Error ? err.message : String(err)}`);
482
+ logMatrixEvent(parent.name, "queue_save_failed", {
483
+ error: err instanceof Error ? err.message : String(err),
484
+ });
391
485
  }
392
486
  return started;
393
487
  }
@@ -617,7 +711,9 @@ export async function cancelPendingMatrixClones(parentName, reason = t("matrix.c
617
711
  saveTask({ ...parent, matrixQueue: undefined });
618
712
  }
619
713
  catch (err) {
620
- console.log(`[matrix] ${parent.name}: не удалось очистить очередь: ${err instanceof Error ? err.message : String(err)}`);
714
+ logMatrixEvent(parent.name, "queue_clear_failed", {
715
+ error: err instanceof Error ? err.message : String(err),
716
+ });
621
717
  }
622
718
  }
623
719
  for (const clone of clones) {
@@ -637,7 +733,11 @@ export async function cancelPendingMatrixClones(parentName, reason = t("matrix.c
637
733
  cancelled.push(clone.name);
638
734
  }
639
735
  catch (err) {
640
- console.log(`[matrix] ${parent.name}: не удалось записать отмену клона ${clone.name}: ${err instanceof Error ? err.message : String(err)}`);
736
+ logMatrixEvent(parent.name, "cancelled", {
737
+ cloneName: clone.name,
738
+ status: "error",
739
+ error: err instanceof Error ? err.message : String(err),
740
+ });
641
741
  }
642
742
  }
643
743
  if (cancelled.length > 0 && clones.length > 0) {
@@ -704,19 +804,34 @@ export async function finalizeMatrixIfComplete(cloneName) {
704
804
  error: aggregate.errorCount,
705
805
  message: aggregate.message,
706
806
  });
807
+ const aggregateRunId = getHistory(parent.name, 1)[0]?.id;
808
+ logMatrixEvent(parent.name, "aggregated", {
809
+ status: finalStatus,
810
+ runId: aggregateRunId,
811
+ reason: `total=${aggregate.totalCount}, success=${aggregate.successCount}, ` +
812
+ `error=${aggregate.errorCount}`,
813
+ });
707
814
  }
708
815
  catch (err) {
709
- console.log(`[matrix] ${parent.name}: не удалось записать агрегат: ${err instanceof Error ? err.message : String(err)}`);
816
+ logMatrixEvent(parent.name, "aggregate_failed", {
817
+ error: err instanceof Error ? err.message : String(err),
818
+ });
710
819
  }
711
820
  if (parent.matrix.createAggregator) {
712
821
  const aggregator = getTask(matrixCompleteName(parent.name));
713
822
  if (aggregator) {
714
823
  try {
715
824
  await createSchedulerBackend().runTask(aggregator.name);
716
- console.log(`[matrix] ${parent.name}: запущен агрегатор ${aggregator.name}`);
825
+ logMatrixEvent(parent.name, "aggregator_started", {
826
+ cloneName: aggregator.name,
827
+ status: "running",
828
+ });
717
829
  }
718
830
  catch (err) {
719
- console.log(`[matrix] ${parent.name}: не удалось запустить агрегатор: ${err instanceof Error ? err.message : String(err)}`);
831
+ logMatrixEvent(parent.name, "aggregator_start_failed", {
832
+ cloneName: aggregator.name,
833
+ error: err instanceof Error ? err.message : String(err),
834
+ });
720
835
  }
721
836
  }
722
837
  }
@@ -0,0 +1,103 @@
1
+ /**
2
+ * AB-8: ad-hoc миссия (`run_mission`) — полоса B execution model.
3
+ *
4
+ * Миссия проходит тот же путь, что и зарегистрированная задача:
5
+ * `createRun → план → маршрут → исполнение → GATE → ledger`. Отличие только
6
+ * в источнике входа: задача не создаётся и не регистрируется в планировщике
7
+ * ОС. Исполнение идёт через обёртку (lock, таймаут, политика прав, Quality
8
+ * Gate, запись истории), но без `schtasks`/`crontab`/`launchd`.
9
+ */
10
+ import { type ExecutionPlan, type ExecutionResult, type RunContext, type RunPermissionPolicy, type StepExecutor } from "./execution.js";
11
+ import { type SessionMode } from "./session.js";
12
+ /**
13
+ * Маркер начала прогона в логе задачи/миссии.
14
+ *
15
+ * Лог НЕ очищается перед запуском: при падении до первого вывода обёртки он
16
+ * остался бы пустым и диагностировать причину было бы невозможно. Маркер
17
+ * разделяет прогоны в общем файле и подтверждает, что запуск действительно
18
+ * дошёл до подготовки обёртки.
19
+ */
20
+ export declare function formatLogRunMarker(kind: "run" | "mission" | "prepare", taskName: string, now?: Date): string;
21
+ /**
22
+ * Возвращает часть лога, относящуюся только к последнему запуску.
23
+ *
24
+ * Лог намеренно дописывается, а не очищается (иначе при падении до первого
25
+ * вывода обёртки диагностировать причину было бы невозможно). Маркеры
26
+ * `Run started`/`Mission started` разделяют прогоны: потребителям лога
27
+ * нужно показывать и разбирать только последний сегмент. `Task prepared`
28
+ * маркером запуска НЕ считается — он пишется при создании/редактировании
29
+ * задачи, когда реального прогона ещё не было.
30
+ */
31
+ export declare function extractLastRunLog(content: string): string;
32
+ /** AB-8.1: спецификация ad-hoc миссии (цель + safety-контракт). */
33
+ export interface MissionSpec {
34
+ /** Цель миссии — тот же промпт, что получил бы OpenCode. */
35
+ prompt: string;
36
+ /** Рабочая директория; по умолчанию — cwd процесса. */
37
+ cwd?: string;
38
+ /** Имя запуска в ledger; по умолчанию генерируется `ad-hoc-*`. */
39
+ taskName?: string;
40
+ /** Тип задачи для маршрутизатора; по умолчанию `mission` (local/direct). */
41
+ taskType?: string;
42
+ /** Модель OpenCode (пусто — модель по умолчанию). */
43
+ model?: string;
44
+ /** Режим сессии OpenCode. */
45
+ session?: SessionMode;
46
+ /** Идентификатор сессии для `session=reuse`. */
47
+ sessionId?: string;
48
+ /** Таймаут исполнения в секундах (по умолчанию 3600). */
49
+ timeoutSeconds?: number;
50
+ /** Quality Gate: команда, ненулевой код которой проваливает миссию. */
51
+ gate?: string;
52
+ /** Таймаут Quality Gate в секундах (по умолчанию 300). */
53
+ gateTimeoutSeconds?: number;
54
+ /** Политика прав: hybrid (по умолчанию), secure, legacy. */
55
+ policy?: RunPermissionPolicy;
56
+ /** Allowlist инструментов; непустой список блокирует остальные. */
57
+ allowedTools?: string[];
58
+ /** Denylist инструментов; выигрывает у allowlist. */
59
+ deniedTools?: string[];
60
+ /** Только построить план и показать трассировку, не исполняя. */
61
+ dryRun?: boolean;
62
+ }
63
+ /** Результат ad-hoc миссии. */
64
+ export interface MissionResult {
65
+ success: boolean;
66
+ dryRun: boolean;
67
+ runId: string | null;
68
+ status: ExecutionResult["status"] | "planned";
69
+ plan: ExecutionPlan;
70
+ description: string;
71
+ steps: ExecutionResult["steps"];
72
+ error: string | null;
73
+ logFile: string | null;
74
+ }
75
+ /** Зависимости для тестов: позволяют подменить исполнение без OpenCode. */
76
+ export interface MissionDependencies {
77
+ executor?: StepExecutor;
78
+ /** Хук после подготовки: тест может проверить отсутствие задач в ОС. */
79
+ onPrepared?: (info: {
80
+ taskName: string;
81
+ cwd: string;
82
+ }) => void;
83
+ }
84
+ /**
85
+ * AB-8.1: валидирует и нормализует вход. Возвращает безопасную копию спеки,
86
+ * чтобы CLI/RPC/GUI не могли передать нестроковые поля в обёртку.
87
+ */
88
+ export declare function normalizeMissionSpec(input: MissionSpec): MissionSpec;
89
+ /** Создаёт RunContext ad-hoc миссии (без task definition). */
90
+ export declare function createMissionContext(spec: MissionSpec): RunContext;
91
+ /**
92
+ * AB-8: единая точка входа ad-hoc миссии для CLI, RPC и GUI.
93
+ *
94
+ * Инварианты EXECUTION-LOOP §2.1: нет записи в планировщике ОС, работают
95
+ * GATE, политика прав, ledger (`runs`/`run_steps`) и аудит; параллельные
96
+ * обычные миссии в одном workspace не допускаются.
97
+ *
98
+ * W-3 (контракт dryRun): `dryRun: true` строит план и описание, но не захватывает
99
+ * `activeWorkspaces` и не пишет ledger (`runs`/`run_steps`) — это контракт, а не
100
+ * утечка контекста. Поэтому несколько dry-run в одном `cwd` проходят параллельно.
101
+ */
102
+ export declare function runMission(input: MissionSpec, dependencies?: MissionDependencies): Promise<MissionResult>;
103
+ //# sourceMappingURL=mission.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"mission.d.ts","sourceRoot":"","sources":["../../src/core/mission.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAQH,OAAO,EAKL,KAAK,aAAa,EAClB,KAAK,eAAe,EACpB,KAAK,UAAU,EACf,KAAK,mBAAmB,EACxB,KAAK,YAAY,EAClB,MAAM,gBAAgB,CAAC;AAQxB,OAAO,EAKL,KAAK,WAAW,EACjB,MAAM,cAAc,CAAC;AAGtB;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,KAAK,GAAG,SAAS,GAAG,SAAS,EACnC,QAAQ,EAAE,MAAM,EAChB,GAAG,GAAE,IAAiB,GACrB,MAAM,CAUR;AAED;;;;;;;;;GASG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CASzD;AAED,mEAAmE;AACnE,MAAM,WAAW,WAAW;IAC1B,4DAA4D;IAC5D,MAAM,EAAE,MAAM,CAAC;IACf,uDAAuD;IACvD,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,kEAAkE;IAClE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,4EAA4E;IAC5E,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,qDAAqD;IACrD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,6BAA6B;IAC7B,OAAO,CAAC,EAAE,WAAW,CAAC;IACtB,gDAAgD;IAChD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,yDAAyD;IACzD,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,uEAAuE;IACvE,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,0DAA0D;IAC1D,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,4DAA4D;IAC5D,MAAM,CAAC,EAAE,mBAAmB,CAAC;IAC7B,mEAAmE;IACnE,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,qDAAqD;IACrD,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB,iEAAiE;IACjE,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,+BAA+B;AAC/B,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,OAAO,CAAC;IAChB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,MAAM,EAAE,eAAe,CAAC,QAAQ,CAAC,GAAG,SAAS,CAAC;IAC9C,IAAI,EAAE,aAAa,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,eAAe,CAAC,OAAO,CAAC,CAAC;IAChC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;CACxB;AAED,2EAA2E;AAC3E,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,EAAE,YAAY,CAAC;IACxB,wEAAwE;IACxE,UAAU,CAAC,EAAE,CAAC,IAAI,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,KAAK,IAAI,CAAC;CAChE;AAoDD;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,WAAW,GAAG,WAAW,CAmDpE;AAED,8DAA8D;AAC9D,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,WAAW,GAAG,UAAU,CAsBlE;AAoLD;;;;;;;;;;GAUG;AACH,wBAAsB,UAAU,CAC9B,KAAK,EAAE,WAAW,EAClB,YAAY,GAAE,mBAAwB,GACrC,OAAO,CAAC,aAAa,CAAC,CAkExB"}