agent-steward 0.0.3 → 0.0.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 (287) hide show
  1. package/CHANGELOG.md +154 -2
  2. package/CROSS_PLATFORM.md +19 -0
  3. package/README.md +54 -9
  4. package/ROADMAP-STRATEGY.md +23 -20
  5. package/ROADMAP.md +140 -143
  6. package/dist/cli.d.ts +3 -0
  7. package/dist/cli.d.ts.map +1 -0
  8. package/dist/cli.js +351 -0
  9. package/dist/core/dlq-api.d.ts +44 -0
  10. package/dist/core/dlq-api.d.ts.map +1 -0
  11. package/dist/core/dlq-api.js +68 -0
  12. package/dist/core/dry-run.d.ts.map +1 -1
  13. package/dist/core/dry-run.js +18 -1
  14. package/dist/core/execution.d.ts +203 -0
  15. package/dist/core/execution.d.ts.map +1 -0
  16. package/dist/core/execution.js +309 -0
  17. package/dist/core/gate-integrity.d.ts +35 -0
  18. package/dist/core/gate-integrity.d.ts.map +1 -0
  19. package/dist/core/gate-integrity.js +132 -0
  20. package/dist/core/git-trigger.d.ts.map +1 -1
  21. package/dist/core/git-trigger.js +14 -2
  22. package/dist/core/guard-run.d.ts +4 -0
  23. package/dist/core/guard-run.d.ts.map +1 -0
  24. package/dist/core/guard-run.js +101 -0
  25. package/dist/core/guard.d.ts +52 -0
  26. package/dist/core/guard.d.ts.map +1 -0
  27. package/dist/core/guard.js +362 -0
  28. package/dist/core/lock.d.ts +61 -4
  29. package/dist/core/lock.d.ts.map +1 -1
  30. package/dist/core/lock.js +213 -26
  31. package/dist/core/matrix.d.ts.map +1 -1
  32. package/dist/core/matrix.js +75 -15
  33. package/dist/core/mission.d.ts +83 -0
  34. package/dist/core/mission.d.ts.map +1 -0
  35. package/dist/core/mission.js +334 -0
  36. package/dist/core/one-shot.d.ts +5 -1
  37. package/dist/core/one-shot.d.ts.map +1 -1
  38. package/dist/core/one-shot.js +33 -8
  39. package/dist/core/opencode-cli.d.ts +28 -0
  40. package/dist/core/opencode-cli.d.ts.map +1 -0
  41. package/dist/core/opencode-cli.js +74 -0
  42. package/dist/core/opencode-models.d.ts +62 -0
  43. package/dist/core/opencode-models.d.ts.map +1 -0
  44. package/dist/core/opencode-models.js +277 -0
  45. package/dist/core/pipeline-apply.d.ts +38 -0
  46. package/dist/core/pipeline-apply.d.ts.map +1 -0
  47. package/dist/core/pipeline-apply.js +117 -0
  48. package/dist/core/pipeline-io.d.ts +13 -0
  49. package/dist/core/pipeline-io.d.ts.map +1 -0
  50. package/dist/core/pipeline-io.js +64 -0
  51. package/dist/core/pipeline-map.d.ts +46 -0
  52. package/dist/core/pipeline-map.d.ts.map +1 -0
  53. package/dist/core/pipeline-map.js +196 -0
  54. package/dist/core/pipeline-spec.d.ts +109 -0
  55. package/dist/core/pipeline-spec.d.ts.map +1 -0
  56. package/dist/core/pipeline-spec.js +554 -0
  57. package/dist/core/ps-wrapper.d.ts +19 -2
  58. package/dist/core/ps-wrapper.d.ts.map +1 -1
  59. package/dist/core/ps-wrapper.js +261 -63
  60. package/dist/core/record-history.d.ts +15 -0
  61. package/dist/core/record-history.d.ts.map +1 -1
  62. package/dist/core/record-history.js +183 -58
  63. package/dist/core/router/dispatch.d.ts +36 -0
  64. package/dist/core/router/dispatch.d.ts.map +1 -0
  65. package/dist/core/router/dispatch.js +59 -0
  66. package/dist/core/router/escalation.d.ts +47 -0
  67. package/dist/core/router/escalation.d.ts.map +1 -0
  68. package/dist/core/router/escalation.js +87 -0
  69. package/dist/core/router/planner.d.ts +53 -0
  70. package/dist/core/router/planner.d.ts.map +1 -0
  71. package/dist/core/router/planner.js +113 -0
  72. package/dist/core/router/rules.d.ts +46 -0
  73. package/dist/core/router/rules.d.ts.map +1 -0
  74. package/dist/core/router/rules.js +91 -0
  75. package/dist/core/run-panel-api.d.ts +94 -0
  76. package/dist/core/run-panel-api.d.ts.map +1 -0
  77. package/dist/core/run-panel-api.js +169 -0
  78. package/dist/core/schedule-gate.js +5 -1
  79. package/dist/core/schedule-v2.d.ts +34 -0
  80. package/dist/core/schedule-v2.d.ts.map +1 -1
  81. package/dist/core/schedule-v2.js +91 -5
  82. package/dist/core/scheduler/at-fallback.d.ts +55 -2
  83. package/dist/core/scheduler/at-fallback.d.ts.map +1 -1
  84. package/dist/core/scheduler/at-fallback.js +135 -5
  85. package/dist/core/scheduler/linux.d.ts +18 -2
  86. package/dist/core/scheduler/linux.d.ts.map +1 -1
  87. package/dist/core/scheduler/linux.js +63 -20
  88. package/dist/core/scheduler/mac.d.ts +44 -2
  89. package/dist/core/scheduler/mac.d.ts.map +1 -1
  90. package/dist/core/scheduler/mac.js +126 -15
  91. package/dist/core/scheduler/posix.d.ts.map +1 -1
  92. package/dist/core/scheduler/posix.js +25 -1
  93. package/dist/core/scheduler/registry.d.ts +11 -0
  94. package/dist/core/scheduler/registry.d.ts.map +1 -1
  95. package/dist/core/scheduler/registry.js +83 -21
  96. package/dist/core/scheduler/run-now.d.ts +16 -0
  97. package/dist/core/scheduler/run-now.d.ts.map +1 -0
  98. package/dist/core/scheduler/run-now.js +28 -0
  99. package/dist/core/scheduler/windows.d.ts.map +1 -1
  100. package/dist/core/scheduler/windows.js +15 -12
  101. package/dist/core/secrets.d.ts.map +1 -1
  102. package/dist/core/secrets.js +125 -28
  103. package/dist/core/session.d.ts.map +1 -1
  104. package/dist/core/session.js +18 -11
  105. package/dist/core/structured-log.d.ts +7 -1
  106. package/dist/core/structured-log.d.ts.map +1 -1
  107. package/dist/core/task-name.d.ts +24 -0
  108. package/dist/core/task-name.d.ts.map +1 -0
  109. package/dist/core/task-name.js +40 -0
  110. package/dist/core/worktree-run.d.ts +4 -0
  111. package/dist/core/worktree-run.d.ts.map +1 -0
  112. package/dist/core/worktree-run.js +164 -0
  113. package/dist/core/worktree.d.ts +115 -0
  114. package/dist/core/worktree.d.ts.map +1 -0
  115. package/dist/core/worktree.js +462 -0
  116. package/dist/core/wrappers/bash.d.ts +17 -0
  117. package/dist/core/wrappers/bash.d.ts.map +1 -1
  118. package/dist/core/wrappers/bash.js +224 -28
  119. package/dist/db/capability-repo.d.ts +124 -0
  120. package/dist/db/capability-repo.d.ts.map +1 -0
  121. package/dist/db/capability-repo.js +267 -0
  122. package/dist/db/history-repo.d.ts +46 -5
  123. package/dist/db/history-repo.d.ts.map +1 -1
  124. package/dist/db/history-repo.js +107 -25
  125. package/dist/db/index.d.ts +4 -0
  126. package/dist/db/index.d.ts.map +1 -1
  127. package/dist/db/index.js +39 -1
  128. package/dist/db/metrics-repo.js +2 -2
  129. package/dist/db/migrate.d.ts.map +1 -1
  130. package/dist/db/migrate.js +3 -1
  131. package/dist/db/recovery.d.ts.map +1 -1
  132. package/dist/db/recovery.js +5 -4
  133. package/dist/db/run-context.d.ts +103 -0
  134. package/dist/db/run-context.d.ts.map +1 -0
  135. package/dist/db/run-context.js +224 -0
  136. package/dist/db/run-dlq.d.ts +100 -0
  137. package/dist/db/run-dlq.d.ts.map +1 -0
  138. package/dist/db/run-dlq.js +191 -0
  139. package/dist/db/run-journal.d.ts +33 -5
  140. package/dist/db/run-journal.d.ts.map +1 -1
  141. package/dist/db/run-journal.js +78 -14
  142. package/dist/db/run-resume.d.ts +10 -2
  143. package/dist/db/run-resume.d.ts.map +1 -1
  144. package/dist/db/run-resume.js +39 -13
  145. package/dist/db/runs-repo.d.ts +32 -7
  146. package/dist/db/runs-repo.d.ts.map +1 -1
  147. package/dist/db/runs-repo.js +50 -11
  148. package/dist/db/schema.d.ts +2 -2
  149. package/dist/db/schema.d.ts.map +1 -1
  150. package/dist/db/schema.js +216 -3
  151. package/dist/db/settings-repo.d.ts +11 -0
  152. package/dist/db/settings-repo.d.ts.map +1 -1
  153. package/dist/db/settings-repo.js +25 -0
  154. package/dist/db/step-idempotency.d.ts +51 -0
  155. package/dist/db/step-idempotency.d.ts.map +1 -0
  156. package/dist/db/step-idempotency.js +136 -0
  157. package/dist/history.d.ts +1 -1
  158. package/dist/history.d.ts.map +1 -1
  159. package/dist/i18n.d.ts +5 -0
  160. package/dist/i18n.d.ts.map +1 -1
  161. package/dist/i18n.js +11 -4
  162. package/dist/index.d.ts +140 -6
  163. package/dist/index.d.ts.map +1 -1
  164. package/dist/index.js +480 -18
  165. package/dist/notifications.d.ts +22 -0
  166. package/dist/notifications.d.ts.map +1 -1
  167. package/dist/notifications.js +36 -8
  168. package/dist/profiles.d.ts.map +1 -1
  169. package/dist/profiles.js +25 -4
  170. package/dist/rpc.d.ts +924 -0
  171. package/dist/rpc.d.ts.map +1 -1
  172. package/dist/rpc.js +352 -0
  173. package/dist/server.d.ts +46 -0
  174. package/dist/server.d.ts.map +1 -1
  175. package/dist/server.js +172 -53
  176. package/dist/settings.d.ts +2 -2
  177. package/dist/settings.d.ts.map +1 -1
  178. package/dist/settings.js +3 -3
  179. package/dist/shared/jobs-view.d.ts +1 -1
  180. package/dist/shared/jobs-view.d.ts.map +1 -1
  181. package/dist/shared/jobs-view.js +2 -0
  182. package/dist/task-transfer.d.ts +16 -0
  183. package/dist/task-transfer.d.ts.map +1 -1
  184. package/dist/task-transfer.js +16 -0
  185. package/dist/types.d.ts.map +1 -1
  186. package/dist/types.js +7 -0
  187. package/dist/workspaces.d.ts +25 -3
  188. package/dist/workspaces.d.ts.map +1 -1
  189. package/dist/workspaces.js +43 -8
  190. package/docs/ARCHITECTURE.md +498 -58
  191. package/docs/COMPATIBILITY.md +2 -2
  192. package/docs/CONCEPT.md +185 -91
  193. package/docs/CROSS_PLATFORM.ru.md +20 -0
  194. package/docs/CROSS_PLATFORM.zh.md +18 -0
  195. package/docs/EXECUTION-LOOP.md +211 -0
  196. package/docs/FEATURES.md +65 -4
  197. package/docs/FEATURES.zh.md +52 -4
  198. package/docs/MIGRATION.md +2 -2
  199. package/docs/PIPELINE.md +293 -0
  200. package/docs/README.ru.md +44 -5
  201. package/docs/README.zh.md +46 -6
  202. package/docs/SAFETY.md +142 -0
  203. package/docs/SAVINGS.md +29 -0
  204. package/docs/SAVINGS.ru.md +29 -0
  205. package/docs/SAVINGS.zh.md +18 -0
  206. package/gui-experimental.cjs +9 -8
  207. package/locales/en.json +84 -1
  208. package/locales/ru.json +84 -1
  209. package/locales/zh.json +84 -1
  210. package/opencode.pipeline.yaml +35 -0
  211. package/package.json +46 -2
  212. package/scripts/audit-bundle.mjs +215 -0
  213. package/scripts/test-home.mjs +83 -0
  214. package/src/cli.ts +412 -0
  215. package/src/core/dlq-api.ts +98 -0
  216. package/src/core/dry-run.ts +27 -3
  217. package/src/core/execution.ts +538 -0
  218. package/src/core/file-watcher.ts +2 -2
  219. package/src/core/gate-integrity.ts +160 -0
  220. package/src/core/git-trigger.ts +18 -5
  221. package/src/core/guard-run.ts +119 -0
  222. package/src/core/guard.ts +431 -0
  223. package/src/core/lock.ts +244 -30
  224. package/src/core/matrix.ts +95 -50
  225. package/src/core/mission.ts +485 -0
  226. package/src/core/native-notify.ts +1 -1
  227. package/src/core/one-shot.ts +36 -8
  228. package/src/core/opencode-cli.ts +103 -0
  229. package/src/core/opencode-models.ts +315 -0
  230. package/src/core/pipeline-apply.ts +158 -0
  231. package/src/core/pipeline-io.ts +79 -0
  232. package/src/core/pipeline-map.ts +264 -0
  233. package/src/core/pipeline-spec.ts +775 -0
  234. package/src/core/ps-wrapper.ts +274 -64
  235. package/src/core/record-history.ts +229 -104
  236. package/src/core/router/dispatch.ts +94 -0
  237. package/src/core/router/escalation.ts +129 -0
  238. package/src/core/router/planner.ts +166 -0
  239. package/src/core/router/rules.ts +115 -0
  240. package/src/core/run-panel-api.ts +262 -0
  241. package/src/core/schedule-gate.ts +7 -3
  242. package/src/core/schedule-v2.ts +114 -5
  243. package/src/core/scheduler/at-fallback.ts +190 -5
  244. package/src/core/scheduler/linux.ts +72 -21
  245. package/src/core/scheduler/logs.ts +2 -2
  246. package/src/core/scheduler/mac.ts +174 -14
  247. package/src/core/scheduler/posix.ts +20 -1
  248. package/src/core/scheduler/registry.ts +107 -26
  249. package/src/core/scheduler/run-now.ts +32 -0
  250. package/src/core/scheduler/windows.ts +19 -15
  251. package/src/core/secrets.ts +131 -31
  252. package/src/core/session.ts +23 -10
  253. package/src/core/structured-log.ts +22 -5
  254. package/src/core/task-name.ts +67 -0
  255. package/src/core/telegram.ts +2 -2
  256. package/src/core/triage-worker.ts +7 -7
  257. package/src/core/triage.ts +2 -2
  258. package/src/core/worktree-run.ts +199 -0
  259. package/src/core/worktree.ts +600 -0
  260. package/src/core/wrappers/bash.ts +239 -27
  261. package/src/db/capability-repo.ts +402 -0
  262. package/src/db/history-repo.ts +151 -22
  263. package/src/db/index.ts +37 -1
  264. package/src/db/metrics-repo.ts +2 -2
  265. package/src/db/migrate.ts +3 -1
  266. package/src/db/recovery.ts +5 -4
  267. package/src/db/run-context.ts +370 -0
  268. package/src/db/run-dlq.ts +310 -0
  269. package/src/db/run-journal.ts +100 -13
  270. package/src/db/run-resume.ts +65 -13
  271. package/src/db/runs-repo.ts +66 -13
  272. package/src/db/schema.ts +218 -3
  273. package/src/db/settings-repo.ts +31 -0
  274. package/src/db/step-idempotency.ts +185 -0
  275. package/src/gui.tsx +692 -13
  276. package/src/history.ts +1 -1
  277. package/src/i18n.ts +12 -4
  278. package/src/index.ts +648 -8
  279. package/src/notifications.ts +38 -8
  280. package/src/profiles.ts +26 -4
  281. package/src/rpc.ts +379 -0
  282. package/src/server.ts +206 -54
  283. package/src/settings.ts +5 -5
  284. package/src/shared/jobs-view.ts +3 -1
  285. package/src/task-transfer.ts +31 -0
  286. package/src/types.ts +9 -0
  287. package/src/workspaces.ts +58 -9
package/dist/core/lock.js CHANGED
@@ -1,6 +1,118 @@
1
1
  import fs from "node:fs/promises";
2
2
  import path from "node:path";
3
+ import { randomUUID } from "node:crypto";
3
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
+ }
15
+ /**
16
+ * Проверяет, жив ли процесс-владелец lock-файла.
17
+ *
18
+ * `process.kill(pid, 0)` не посылает сигнал, а только проверяет существование.
19
+ * EPERM означает, что процесс есть, но у нас нет прав на сигнал — считаем живым.
20
+ * Остальные ошибки трактуем консервативно как «жив», чтобы не вытеснить
21
+ * чужую критическую секцию.
22
+ */
23
+ export function isProcessAlive(pid) {
24
+ if (!Number.isInteger(pid) || pid <= 0)
25
+ return false;
26
+ try {
27
+ process.kill(pid, 0);
28
+ return true;
29
+ }
30
+ catch (err) {
31
+ if (err?.code === "ESRCH")
32
+ return false;
33
+ return true;
34
+ }
35
+ }
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);
115
+ }
4
116
  /**
5
117
  * Менеджер файловых блокировок для предотвращения наложения запусков одной задачи.
6
118
  *
@@ -46,12 +158,22 @@ export class LockManager {
46
158
  // Артефакт предыдущего вытеснения валидным lock быть не может,
47
159
  // поэтому убираем его независимо от возраста.
48
160
  if (isStaleArtifact) {
49
- await fs.rm(fullPath, { recursive: true, force: true }).catch(() => { });
161
+ await fs.rm(fullPath, { recursive: true, force: true }).catch((err) => warnCleanupFailure(fullPath, err));
50
162
  continue;
51
163
  }
52
164
  const stat = await fs.stat(fullPath);
53
165
  const age = now - stat.mtimeMs;
54
166
  if (age > STALE_LOCK_MAX_AGE_MS) {
167
+ // P2-18/B7: возраст — только повод проверить владельца. Задача может
168
+ // легально работать дольше 24 ч (timeoutSeconds: 0), поэтому живой
169
+ // процесс не вытесняем: иначе после рестарта плагина появится дубль.
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;
176
+ }
55
177
  // T-03: не удаляем lock напрямую. Два воркера могли одновременно
56
178
  // снести один и тот же файл, после чего один из них удалял свежий
57
179
  // lock, созданный другим, и задача запускалась повторно. Атомарный
@@ -64,7 +186,7 @@ export class LockManager {
64
186
  catch {
65
187
  continue;
66
188
  }
67
- await fs.rm(stalePath, { recursive: true, force: true }).catch(() => { });
189
+ await fs.rm(stalePath, { recursive: true, force: true }).catch((err) => warnCleanupFailure(stalePath, err));
68
190
  console.log(`[agent-steward] Вытеснен зависший lock: ${file} (возраст ${Math.round(age / 1000)} с)`);
69
191
  }
70
192
  }
@@ -75,37 +197,89 @@ export class LockManager {
75
197
  }
76
198
  /**
77
199
  * Пытается захватить блокировку для задачи.
78
- * Возвращает true, если блокировка захвачена (файл создан).
79
- * Возвращает false, если блокировка уже удерживается другим запуском.
200
+ * Возвращает уникальный токен владельца (он же содержимое lock-файла) или
201
+ * null, если блокировка уже удерживается другим запуском.
202
+ *
203
+ * Токен нужен release(): процесс, чей lock был вытеснен по stale-таймауту,
204
+ * не должен удалять файл нового владельца.
80
205
  */
81
206
  async acquire(taskName) {
82
207
  await fs.mkdir(this.lockDir, { recursive: true });
83
208
  const lockPath = this.lockFilePath(taskName);
209
+ // B6: единый формат `<pid>-<iso>` (+ uuid для уникальности токена).
210
+ // PS-обёртка пишет тот же префикс, поэтому её stale-проверка видит PID,
211
+ // а не год из даты, и не вытесняет живой Node-лок.
212
+ const token = `${process.pid}-${new Date().toISOString()}-${randomUUID()}`;
84
213
  try {
85
214
  // 'wx' — exclusive create: ошибка если файл уже существует.
86
- await fs.writeFile(lockPath, String(Date.now()), { flag: "wx" });
87
- return true;
215
+ await fs.writeFile(lockPath, token, { flag: "wx" });
216
+ return token;
88
217
  }
89
218
  catch (err) {
90
- if (err.code === "EEXIST") {
91
- return false;
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") {
227
+ return null;
92
228
  }
93
229
  throw err;
94
230
  }
95
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
+ }
96
259
  /**
97
260
  * Освобождает блокировку задачи (удаляет lock-файл).
261
+ *
262
+ * Удаляет файл только если в нём лежит токен этого владельца. Если lock
263
+ * успели вытеснить и перехватить, release ничего не трогает и возвращает
264
+ * false — иначе старый процесс снёс бы чужую критическую секцию.
98
265
  * Не выбрасывает ошибку, если файл уже удалён.
99
266
  */
100
- async release(taskName) {
267
+ async release(taskName, token) {
101
268
  const lockPath = this.lockFilePath(taskName);
269
+ let current;
102
270
  try {
103
- await fs.unlink(lockPath);
271
+ current = await fs.readFile(lockPath, "utf8");
104
272
  }
105
273
  catch (err) {
106
- if (err.code !== "ENOENT")
107
- throw err;
274
+ if (err.code === "ENOENT")
275
+ return false;
276
+ throw err;
108
277
  }
278
+ if (current !== token)
279
+ return false;
280
+ // P3-39: на Windows unlink может кратковременно упасть EPERM, пока
281
+ // другие процессы читают lock для проверки владельца.
282
+ return this.unlinkWithRetry(lockPath);
109
283
  }
110
284
  /**
111
285
  * Проверяет, удерживается ли блокировка задачей в данный момент.
@@ -129,8 +303,8 @@ export class LockManager {
129
303
  * Гарантирует освобождение блокировки в finally (включая при ошибках).
130
304
  */
131
305
  export async function withLock(lockManager, taskName, fn) {
132
- const acquired = await lockManager.acquire(taskName);
133
- if (!acquired) {
306
+ const token = await lockManager.acquire(taskName);
307
+ if (!token) {
134
308
  console.log(`[agent-steward] Запуск задачи "${taskName}" пропущен: удерживается активная блокировка.`);
135
309
  return null;
136
310
  }
@@ -138,7 +312,7 @@ export async function withLock(lockManager, taskName, fn) {
138
312
  return await fn();
139
313
  }
140
314
  finally {
141
- await lockManager.release(taskName);
315
+ await lockManager.release(taskName, token);
142
316
  }
143
317
  }
144
318
  /**
@@ -154,25 +328,37 @@ export async function withLockWait(lockManager, taskName, fn, options = {}) {
154
328
  const staleMs = options.staleMs ?? 60000;
155
329
  const deadline = Date.now() + timeoutMs;
156
330
  const lockPath = lockManager.pathFor(taskName);
331
+ let token = null;
157
332
  for (;;) {
158
- if (await lockManager.acquire(taskName))
333
+ token = await lockManager.acquire(taskName);
334
+ if (token)
159
335
  break;
160
336
  // Осиротевший lock: короткая операция не может длиться дольше staleMs.
161
337
  if (staleMs > 0) {
162
338
  try {
163
339
  const stat = await fs.stat(lockPath);
164
340
  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(() => { });
341
+ // P2-18: staleMs — не приговор. Если владелец ещё жив, его
342
+ // критическая секция может быть легально долгой (crontab RMW,
343
+ // длинная задача). Вытесняем только мёртвый/неизвестный lock.
344
+ const content = await fs.readFile(lockPath, "utf8").catch(() => "");
345
+ const ownerPid = ownerPidFromToken(content);
346
+ if (ownerPid !== null && isProcessAlive(ownerPid)) {
347
+ // Ждём дальше; по deadline вернём понятную ошибку.
171
348
  }
172
- catch {
173
- // Кто-то успел раньше — просто повторяем acquire.
349
+ else {
350
+ // T-03-совместимое вытеснение: атомарный rename выигрывает ровно
351
+ // один процесс, остальные получают ENOENT и повторяют попытку.
352
+ const stalePath = `${lockPath}.stale-${process.pid}-${Date.now()}`;
353
+ try {
354
+ await fs.rename(lockPath, stalePath);
355
+ await fs.rm(stalePath, { force: true }).catch((err) => warnCleanupFailure(stalePath, err));
356
+ }
357
+ catch {
358
+ // Кто-то успел раньше — просто повторяем acquire.
359
+ }
360
+ continue;
174
361
  }
175
- continue;
176
362
  }
177
363
  }
178
364
  catch {
@@ -188,6 +374,7 @@ export async function withLockWait(lockManager, taskName, fn, options = {}) {
188
374
  return await fn();
189
375
  }
190
376
  finally {
191
- await lockManager.release(taskName);
377
+ if (token)
378
+ await lockManager.release(taskName, token);
192
379
  }
193
380
  }
@@ -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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"}
@@ -15,7 +15,25 @@ import { getHistory, 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>. */
@@ -249,6 +267,7 @@ export async function runMatrix(task) {
249
267
  catch (err) {
250
268
  const message = err instanceof Error ? err.message : String(err);
251
269
  errors.push(`${clone.name}: ${message}`);
270
+ logMatrixEvent(task.name, "start_failed", { cloneName: clone.name, error: message });
252
271
  if (failureMode === "stop") {
253
272
  const rest = clones
254
273
  .slice(clones.indexOf(clone) + 1)
@@ -264,11 +283,16 @@ export async function runMatrix(task) {
264
283
  saveTask({ ...task, matrixQueue: queueToSave.length > 0 ? queueToSave : undefined });
265
284
  }
266
285
  catch (err) {
267
- console.log(`[matrix] ${task.name}: не удалось сохранить очередь: ${err instanceof Error ? err.message : String(err)}`);
286
+ logMatrixEvent(task.name, "queue_save_failed", {
287
+ error: err instanceof Error ? err.message : String(err),
288
+ });
268
289
  }
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}`);
290
+ logMatrixEvent(task.name, "started", {
291
+ status: started.length > 0 ? "running" : "error",
292
+ reason: `strategy=${strategy}, failureMode=${failureMode}, ` +
293
+ `concurrency=${concurrency}, started=${started.length}, skipped=${skipped.length}, ` +
294
+ `queued=${queueToSave.length}, errors=${errors.length}`,
295
+ });
272
296
  return {
273
297
  success: errors.length === 0 || failureMode === "continue",
274
298
  parent: task.name,
@@ -309,7 +333,10 @@ export async function advanceSequentialMatrix(cloneName) {
309
333
  if ((parent.matrix.failureMode ?? "continue") === "stop") {
310
334
  const latest = latestCloneStatus(cloneName);
311
335
  if (latest.status === "error") {
312
- console.log(`[matrix] ${parent.name}: sequential остановлена после ошибки ${cloneName}`);
336
+ logMatrixEvent(parent.name, "sequential_stopped", {
337
+ cloneName,
338
+ status: "error",
339
+ });
313
340
  return undefined;
314
341
  }
315
342
  }
@@ -320,12 +347,16 @@ export async function advanceSequentialMatrix(cloneName) {
320
347
  const result = await createSchedulerBackend().runTask(next.name);
321
348
  if (result.alreadyRunning)
322
349
  return undefined;
323
- console.log(`[matrix] ${parent.name}: sequential -> ${next.name}`);
350
+ logMatrixEvent(parent.name, "advanced", {
351
+ cloneName: next.name,
352
+ status: "running",
353
+ reason: "sequential",
354
+ });
324
355
  return next.name;
325
356
  }
326
357
  catch (err) {
327
358
  const message = err instanceof Error ? err.message : String(err);
328
- console.log(`[matrix] ${parent.name}: не удалось запустить ${next.name}: ${message}`);
359
+ logMatrixEvent(parent.name, "start_failed", { cloneName: next.name, error: message });
329
360
  return undefined;
330
361
  }
331
362
  }
@@ -369,11 +400,17 @@ export async function advanceMatrixAfterClone(cloneName) {
369
400
  slots -= 1;
370
401
  if (result.alreadyRunning)
371
402
  slots += 0; // слот уже занят этим клоном
372
- console.log(`[matrix] ${parent.name}: из очереди -> ${nextName}`);
403
+ logMatrixEvent(parent.name, "queue_started", {
404
+ cloneName: nextName,
405
+ status: "running",
406
+ });
373
407
  }
374
408
  catch (err) {
375
409
  const message = err instanceof Error ? err.message : String(err);
376
- console.log(`[matrix] ${parent.name}: не удалось запустить из очереди ${nextName}: ${message}`);
410
+ logMatrixEvent(parent.name, "queue_start_failed", {
411
+ cloneName: nextName,
412
+ error: message,
413
+ });
377
414
  // Попытка запуска «съедает» слот: иначе при недоступном бэкенде
378
415
  // цикл уйдёт по всей очереди, проигнорировав лимит.
379
416
  slots -= 1;
@@ -387,7 +424,9 @@ export async function advanceMatrixAfterClone(cloneName) {
387
424
  saveTask({ ...parent, matrixQueue: queue.length > 0 ? queue : undefined });
388
425
  }
389
426
  catch (err) {
390
- console.log(`[matrix] ${parent.name}: не удалось сохранить очередь: ${err instanceof Error ? err.message : String(err)}`);
427
+ logMatrixEvent(parent.name, "queue_save_failed", {
428
+ error: err instanceof Error ? err.message : String(err),
429
+ });
391
430
  }
392
431
  return started;
393
432
  }
@@ -617,7 +656,9 @@ export async function cancelPendingMatrixClones(parentName, reason = t("matrix.c
617
656
  saveTask({ ...parent, matrixQueue: undefined });
618
657
  }
619
658
  catch (err) {
620
- console.log(`[matrix] ${parent.name}: не удалось очистить очередь: ${err instanceof Error ? err.message : String(err)}`);
659
+ logMatrixEvent(parent.name, "queue_clear_failed", {
660
+ error: err instanceof Error ? err.message : String(err),
661
+ });
621
662
  }
622
663
  }
623
664
  for (const clone of clones) {
@@ -637,7 +678,11 @@ export async function cancelPendingMatrixClones(parentName, reason = t("matrix.c
637
678
  cancelled.push(clone.name);
638
679
  }
639
680
  catch (err) {
640
- console.log(`[matrix] ${parent.name}: не удалось записать отмену клона ${clone.name}: ${err instanceof Error ? err.message : String(err)}`);
681
+ logMatrixEvent(parent.name, "cancelled", {
682
+ cloneName: clone.name,
683
+ status: "error",
684
+ error: err instanceof Error ? err.message : String(err),
685
+ });
641
686
  }
642
687
  }
643
688
  if (cancelled.length > 0 && clones.length > 0) {
@@ -704,19 +749,34 @@ export async function finalizeMatrixIfComplete(cloneName) {
704
749
  error: aggregate.errorCount,
705
750
  message: aggregate.message,
706
751
  });
752
+ const aggregateRunId = getHistory(parent.name, 1)[0]?.id;
753
+ logMatrixEvent(parent.name, "aggregated", {
754
+ status: finalStatus,
755
+ runId: aggregateRunId,
756
+ reason: `total=${aggregate.totalCount}, success=${aggregate.successCount}, ` +
757
+ `error=${aggregate.errorCount}`,
758
+ });
707
759
  }
708
760
  catch (err) {
709
- console.log(`[matrix] ${parent.name}: не удалось записать агрегат: ${err instanceof Error ? err.message : String(err)}`);
761
+ logMatrixEvent(parent.name, "aggregate_failed", {
762
+ error: err instanceof Error ? err.message : String(err),
763
+ });
710
764
  }
711
765
  if (parent.matrix.createAggregator) {
712
766
  const aggregator = getTask(matrixCompleteName(parent.name));
713
767
  if (aggregator) {
714
768
  try {
715
769
  await createSchedulerBackend().runTask(aggregator.name);
716
- console.log(`[matrix] ${parent.name}: запущен агрегатор ${aggregator.name}`);
770
+ logMatrixEvent(parent.name, "aggregator_started", {
771
+ cloneName: aggregator.name,
772
+ status: "running",
773
+ });
717
774
  }
718
775
  catch (err) {
719
- console.log(`[matrix] ${parent.name}: не удалось запустить агрегатор: ${err instanceof Error ? err.message : String(err)}`);
776
+ logMatrixEvent(parent.name, "aggregator_start_failed", {
777
+ cloneName: aggregator.name,
778
+ error: err instanceof Error ? err.message : String(err),
779
+ });
720
780
  }
721
781
  }
722
782
  }
@@ -0,0 +1,83 @@
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
+ /** AB-8.1: спецификация ad-hoc миссии (цель + safety-контракт). */
13
+ export interface MissionSpec {
14
+ /** Цель миссии — тот же промпт, что получил бы OpenCode. */
15
+ prompt: string;
16
+ /** Рабочая директория; по умолчанию — cwd процесса. */
17
+ cwd?: string;
18
+ /** Имя запуска в ledger; по умолчанию генерируется `ad-hoc-*`. */
19
+ taskName?: string;
20
+ /** Тип задачи для маршрутизатора; по умолчанию `mission` (local/direct). */
21
+ taskType?: string;
22
+ /** Модель OpenCode (пусто — модель по умолчанию). */
23
+ model?: string;
24
+ /** Режим сессии OpenCode. */
25
+ session?: SessionMode;
26
+ /** Идентификатор сессии для `session=reuse`. */
27
+ sessionId?: string;
28
+ /** Таймаут исполнения в секундах (по умолчанию 3600). */
29
+ timeoutSeconds?: number;
30
+ /** Quality Gate: команда, ненулевой код которой проваливает миссию. */
31
+ gate?: string;
32
+ /** Таймаут Quality Gate в секундах (по умолчанию 300). */
33
+ gateTimeoutSeconds?: number;
34
+ /** Политика прав: hybrid (по умолчанию), secure, legacy. */
35
+ policy?: RunPermissionPolicy;
36
+ /** Allowlist инструментов; непустой список блокирует остальные. */
37
+ allowedTools?: string[];
38
+ /** Denylist инструментов; выигрывает у allowlist. */
39
+ deniedTools?: string[];
40
+ /** Только построить план и показать трассировку, не исполняя. */
41
+ dryRun?: boolean;
42
+ }
43
+ /** Результат ad-hoc миссии. */
44
+ export interface MissionResult {
45
+ success: boolean;
46
+ dryRun: boolean;
47
+ runId: string | null;
48
+ status: ExecutionResult["status"] | "planned";
49
+ plan: ExecutionPlan;
50
+ description: string;
51
+ steps: ExecutionResult["steps"];
52
+ error: string | null;
53
+ logFile: string | null;
54
+ }
55
+ /** Зависимости для тестов: позволяют подменить исполнение без OpenCode. */
56
+ export interface MissionDependencies {
57
+ executor?: StepExecutor;
58
+ /** Хук после подготовки: тест может проверить отсутствие задач в ОС. */
59
+ onPrepared?: (info: {
60
+ taskName: string;
61
+ cwd: string;
62
+ }) => void;
63
+ }
64
+ /**
65
+ * AB-8.1: валидирует и нормализует вход. Возвращает безопасную копию спеки,
66
+ * чтобы CLI/RPC/GUI не могли передать нестроковые поля в обёртку.
67
+ */
68
+ export declare function normalizeMissionSpec(input: MissionSpec): MissionSpec;
69
+ /** Создаёт RunContext ad-hoc миссии (без task definition). */
70
+ export declare function createMissionContext(spec: MissionSpec): RunContext;
71
+ /**
72
+ * AB-8: единая точка входа ad-hoc миссии для CLI, RPC и GUI.
73
+ *
74
+ * Инварианты EXECUTION-LOOP §2.1: нет записи в планировщике ОС, работают
75
+ * GATE, политика прав, ledger (`runs`/`run_steps`) и аудит; параллельные
76
+ * обычные миссии в одном workspace не допускаются.
77
+ *
78
+ * W-3 (контракт dryRun): `dryRun: true` строит план и описание, но не захватывает
79
+ * `activeWorkspaces` и не пишет ledger (`runs`/`run_steps`) — это контракт, а не
80
+ * утечка контекста. Поэтому несколько dry-run в одном `cwd` проходят параллельно.
81
+ */
82
+ export declare function runMission(input: MissionSpec, dependencies?: MissionDependencies): Promise<MissionResult>;
83
+ //# 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,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;AAmLD;;;;;;;;;;GAUG;AACH,wBAAsB,UAAU,CAC9B,KAAK,EAAE,WAAW,EAClB,YAAY,GAAE,mBAAwB,GACrC,OAAO,CAAC,aAAa,CAAC,CAkExB"}