agent-steward 0.0.4 → 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 (190) hide show
  1. package/CHANGELOG.md +134 -2
  2. package/CROSS_PLATFORM.md +19 -0
  3. package/README.md +52 -7
  4. package/ROADMAP-STRATEGY.md +21 -18
  5. package/ROADMAP.md +140 -159
  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/execution.d.ts +203 -0
  10. package/dist/core/execution.d.ts.map +1 -0
  11. package/dist/core/execution.js +309 -0
  12. package/dist/core/gate-integrity.d.ts +35 -0
  13. package/dist/core/gate-integrity.d.ts.map +1 -0
  14. package/dist/core/gate-integrity.js +132 -0
  15. package/dist/core/git-trigger.d.ts.map +1 -1
  16. package/dist/core/git-trigger.js +14 -2
  17. package/dist/core/guard-run.d.ts +4 -0
  18. package/dist/core/guard-run.d.ts.map +1 -0
  19. package/dist/core/guard-run.js +101 -0
  20. package/dist/core/guard.d.ts +52 -0
  21. package/dist/core/guard.d.ts.map +1 -0
  22. package/dist/core/guard.js +362 -0
  23. package/dist/core/lock.d.ts +41 -0
  24. package/dist/core/lock.d.ts.map +1 -1
  25. package/dist/core/lock.js +141 -29
  26. package/dist/core/matrix.d.ts.map +1 -1
  27. package/dist/core/matrix.js +75 -15
  28. package/dist/core/mission.d.ts +83 -0
  29. package/dist/core/mission.d.ts.map +1 -0
  30. package/dist/core/mission.js +334 -0
  31. package/dist/core/pipeline-apply.d.ts +38 -0
  32. package/dist/core/pipeline-apply.d.ts.map +1 -0
  33. package/dist/core/pipeline-apply.js +117 -0
  34. package/dist/core/pipeline-io.d.ts +13 -0
  35. package/dist/core/pipeline-io.d.ts.map +1 -0
  36. package/dist/core/pipeline-io.js +64 -0
  37. package/dist/core/pipeline-map.d.ts +46 -0
  38. package/dist/core/pipeline-map.d.ts.map +1 -0
  39. package/dist/core/pipeline-map.js +196 -0
  40. package/dist/core/pipeline-spec.d.ts +109 -0
  41. package/dist/core/pipeline-spec.d.ts.map +1 -0
  42. package/dist/core/pipeline-spec.js +554 -0
  43. package/dist/core/ps-wrapper.d.ts +19 -2
  44. package/dist/core/ps-wrapper.d.ts.map +1 -1
  45. package/dist/core/ps-wrapper.js +250 -62
  46. package/dist/core/record-history.d.ts.map +1 -1
  47. package/dist/core/record-history.js +130 -29
  48. package/dist/core/router/rules.d.ts.map +1 -1
  49. package/dist/core/router/rules.js +6 -0
  50. package/dist/core/scheduler/linux.d.ts +8 -1
  51. package/dist/core/scheduler/linux.d.ts.map +1 -1
  52. package/dist/core/scheduler/linux.js +34 -9
  53. package/dist/core/scheduler/mac.d.ts +44 -2
  54. package/dist/core/scheduler/mac.d.ts.map +1 -1
  55. package/dist/core/scheduler/mac.js +126 -15
  56. package/dist/core/scheduler/windows.d.ts.map +1 -1
  57. package/dist/core/scheduler/windows.js +15 -12
  58. package/dist/core/structured-log.d.ts +7 -1
  59. package/dist/core/structured-log.d.ts.map +1 -1
  60. package/dist/core/worktree-run.d.ts +4 -0
  61. package/dist/core/worktree-run.d.ts.map +1 -0
  62. package/dist/core/worktree-run.js +164 -0
  63. package/dist/core/worktree.d.ts +115 -0
  64. package/dist/core/worktree.d.ts.map +1 -0
  65. package/dist/core/worktree.js +462 -0
  66. package/dist/core/wrappers/bash.d.ts +17 -0
  67. package/dist/core/wrappers/bash.d.ts.map +1 -1
  68. package/dist/core/wrappers/bash.js +175 -24
  69. package/dist/db/capability-repo.d.ts +43 -2
  70. package/dist/db/capability-repo.d.ts.map +1 -1
  71. package/dist/db/capability-repo.js +96 -11
  72. package/dist/db/history-repo.d.ts +38 -5
  73. package/dist/db/history-repo.d.ts.map +1 -1
  74. package/dist/db/history-repo.js +88 -25
  75. package/dist/db/metrics-repo.js +2 -2
  76. package/dist/db/recovery.d.ts.map +1 -1
  77. package/dist/db/recovery.js +5 -4
  78. package/dist/db/run-journal.d.ts +33 -5
  79. package/dist/db/run-journal.d.ts.map +1 -1
  80. package/dist/db/run-journal.js +78 -14
  81. package/dist/db/run-resume.d.ts +5 -0
  82. package/dist/db/run-resume.d.ts.map +1 -1
  83. package/dist/db/run-resume.js +9 -2
  84. package/dist/db/runs-repo.d.ts +19 -2
  85. package/dist/db/runs-repo.d.ts.map +1 -1
  86. package/dist/db/runs-repo.js +22 -6
  87. package/dist/db/schema.d.ts +2 -2
  88. package/dist/db/schema.d.ts.map +1 -1
  89. package/dist/db/schema.js +63 -2
  90. package/dist/history.d.ts +1 -1
  91. package/dist/history.d.ts.map +1 -1
  92. package/dist/i18n.d.ts +5 -0
  93. package/dist/i18n.d.ts.map +1 -1
  94. package/dist/i18n.js +11 -4
  95. package/dist/index.d.ts +136 -2
  96. package/dist/index.d.ts.map +1 -1
  97. package/dist/index.js +378 -14
  98. package/dist/notifications.d.ts +22 -0
  99. package/dist/notifications.d.ts.map +1 -1
  100. package/dist/notifications.js +36 -8
  101. package/dist/profiles.d.ts.map +1 -1
  102. package/dist/profiles.js +25 -4
  103. package/dist/rpc.d.ts +246 -0
  104. package/dist/rpc.d.ts.map +1 -1
  105. package/dist/rpc.js +117 -0
  106. package/dist/server.d.ts +15 -0
  107. package/dist/server.d.ts.map +1 -1
  108. package/dist/server.js +77 -18
  109. package/dist/settings.d.ts +2 -2
  110. package/dist/settings.d.ts.map +1 -1
  111. package/dist/settings.js +3 -3
  112. package/dist/shared/jobs-view.d.ts +1 -1
  113. package/dist/shared/jobs-view.d.ts.map +1 -1
  114. package/dist/shared/jobs-view.js +2 -0
  115. package/dist/task-transfer.d.ts +16 -0
  116. package/dist/task-transfer.d.ts.map +1 -1
  117. package/dist/task-transfer.js +16 -0
  118. package/docs/ARCHITECTURE.md +281 -65
  119. package/docs/COMPATIBILITY.md +2 -2
  120. package/docs/CONCEPT.md +18 -4
  121. package/docs/CROSS_PLATFORM.ru.md +20 -0
  122. package/docs/CROSS_PLATFORM.zh.md +18 -0
  123. package/docs/EXECUTION-LOOP.md +22 -7
  124. package/docs/FEATURES.md +65 -4
  125. package/docs/FEATURES.zh.md +52 -4
  126. package/docs/MIGRATION.md +2 -2
  127. package/docs/PIPELINE.md +293 -0
  128. package/docs/README.ru.md +42 -3
  129. package/docs/README.zh.md +43 -3
  130. package/docs/SAFETY.md +23 -3
  131. package/gui-experimental.cjs +9 -8
  132. package/locales/en.json +17 -1
  133. package/locales/ru.json +17 -1
  134. package/locales/zh.json +17 -1
  135. package/opencode.pipeline.yaml +35 -0
  136. package/package.json +23 -4
  137. package/scripts/test-home.mjs +83 -0
  138. package/src/cli.ts +412 -0
  139. package/src/core/dry-run.ts +2 -2
  140. package/src/core/execution.ts +538 -0
  141. package/src/core/file-watcher.ts +2 -2
  142. package/src/core/gate-integrity.ts +160 -0
  143. package/src/core/git-trigger.ts +18 -5
  144. package/src/core/guard-run.ts +119 -0
  145. package/src/core/guard.ts +431 -0
  146. package/src/core/lock.ts +178 -37
  147. package/src/core/matrix.ts +95 -50
  148. package/src/core/mission.ts +485 -0
  149. package/src/core/native-notify.ts +1 -1
  150. package/src/core/pipeline-apply.ts +158 -0
  151. package/src/core/pipeline-io.ts +79 -0
  152. package/src/core/pipeline-map.ts +264 -0
  153. package/src/core/pipeline-spec.ts +775 -0
  154. package/src/core/ps-wrapper.ts +263 -63
  155. package/src/core/record-history.ts +164 -77
  156. package/src/core/router/rules.ts +6 -0
  157. package/src/core/schedule-gate.ts +1 -1
  158. package/src/core/scheduler/at-fallback.ts +1 -1
  159. package/src/core/scheduler/linux.ts +40 -11
  160. package/src/core/scheduler/logs.ts +2 -2
  161. package/src/core/scheduler/mac.ts +174 -14
  162. package/src/core/scheduler/registry.ts +2 -2
  163. package/src/core/scheduler/windows.ts +19 -15
  164. package/src/core/secrets.ts +8 -8
  165. package/src/core/structured-log.ts +22 -5
  166. package/src/core/telegram.ts +2 -2
  167. package/src/core/triage-worker.ts +7 -7
  168. package/src/core/triage.ts +2 -2
  169. package/src/core/worktree-run.ts +199 -0
  170. package/src/core/worktree.ts +600 -0
  171. package/src/core/wrappers/bash.ts +190 -23
  172. package/src/db/capability-repo.ts +127 -10
  173. package/src/db/history-repo.ts +129 -22
  174. package/src/db/metrics-repo.ts +2 -2
  175. package/src/db/recovery.ts +5 -4
  176. package/src/db/run-journal.ts +100 -13
  177. package/src/db/run-resume.ts +17 -1
  178. package/src/db/runs-repo.ts +36 -6
  179. package/src/db/schema.ts +65 -2
  180. package/src/gui.tsx +177 -13
  181. package/src/history.ts +1 -1
  182. package/src/i18n.ts +12 -4
  183. package/src/index.ts +524 -4
  184. package/src/notifications.ts +38 -8
  185. package/src/profiles.ts +26 -4
  186. package/src/rpc.ts +128 -0
  187. package/src/server.ts +94 -18
  188. package/src/settings.ts +5 -5
  189. package/src/shared/jobs-view.ts +3 -1
  190. package/src/task-transfer.ts +31 -0
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.
@@ -1 +1 @@
1
- {"version":3,"file":"matrix.d.ts","sourceRoot":"","sources":["../../src/core/matrix.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAaxE,kEAAkE;AAClE,eAAO,MAAM,sBAAsB,qBAAqB,CAAC;AAEzD,gDAAgD;AAChD,wBAAgB,eAAe,CAAC,UAAU,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,GAAG,MAAM,CASjF;AAED,+CAA+C;AAC/C,wBAAgB,kBAAkB,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAE7D;AAED,sDAAsD;AACtD,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAE1D;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,cAAc,GAAG,cAAc,EAAE,CA2EvE;AAkBD,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;CAC3B;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,0CAA0C;IAC1C,MAAM,EAAE,SAAS,GAAG,OAAO,GAAG,SAAS,GAAG,SAAS,GAAG,OAAO,CAAC;IAC9D,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,iBAAiB,EAAE,CAAC;CAC7B;AAED,oEAAoE;AACpE,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,MAAM,GAAG,eAAe,CAyExE;AAED,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,UAAU,GAAG,YAAY,CAAC;IACpC,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,kFAAkF;IAClF,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAED,kEAAkE;AAClE,wBAAgB,wBAAwB,CACtC,MAAM,EAAE,YAAY,GAAG,SAAS,EAChC,WAAW,EAAE,MAAM,GAClB,MAAM,CAYR;AAED;;;;;;GAMG;AACH,wBAAsB,SAAS,CAAC,IAAI,EAAE,cAAc,GAAG,OAAO,CAAC,eAAe,CAAC,CA6E9E;AAED;;;;GAIG;AACH,wBAAsB,uBAAuB,CAC3C,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAyC7B;AAED;;;;;;GAMG;AACH,wBAAsB,uBAAuB,CAC3C,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,MAAM,EAAE,CAAC,CA4DnB;AAED;;;;GAIG;AACH,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,cAAc,GAAG,cAAc,GAAG,SAAS,CAoC3F;AAED,yEAAyE;AACzE,wBAAgB,oBAAoB,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,EAAE,CAYjE;AAoBD,kEAAkE;AAClE,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,cAAc,CAAC;IACvB,wDAAwD;IACxD,OAAO,EAAE,cAAc,EAAE,CAAC;IAC1B,MAAM,EAAE,cAAc,EAAE,CAAC;IACzB,MAAM,EAAE,cAAc,EAAE,CAAC;IACzB,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,0DAA0D;IAC1D,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,cAAc,GAAG,cAAc,CAsDrE;AAED,2EAA2E;AAC3E,MAAM,WAAW,eAAe;IAC9B,WAAW,CAAC,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;IACjD,WAAW,CAAC,CAAC,UAAU,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;IAC/D,WAAW,CAAC,CAAC,UAAU,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;IAC/D,4EAA4E;IAC5E,cAAc,CAAC,CAAC,MAAM,EAAE,cAAc,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,GAAG,MAAM,GAAG,SAAS,CAAC;CAC3F;AAED,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;;GAGG;AACH,wBAAsB,gBAAgB,CACpC,MAAM,EAAE,cAAc,EACtB,KAAK,GAAE,eAAoB,GAC1B,OAAO,CAAC,gBAAgB,CAAC,CAuB3B;AAED,qEAAqE;AACrE,wBAAgB,0BAA0B,CACxC,QAAQ,EAAE,MAAM,GACf,MAAM,GAAG,SAAS,CAKpB;AAED;;;GAGG;AACH,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,wBAAgB,sBAAsB,CACpC,QAAQ,EAAE,MAAM,GACf,gBAAgB,GAAG,SAAS,CAO9B;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,CACpC,QAAQ,EAAE,MAAM,GACf,MAAM,GAAG,SAAS,CAQpB;AAED;;;;GAIG;AACH,wBAAgB,uBAAuB,IAAI,MAAM,EAAE,CAoBlD;AAED,8CAA8C;AAC9C,MAAM,WAAW,kBAAkB;IACjC,MAAM,EAAE,MAAM,CAAC;IACf,0DAA0D;IAC1D,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,2EAA2E;IAC3E,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,2DAA2D;IAC3D,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,SAAS,EAAE,eAAe,CAAC;CAC5B;AAED;;;;;GAKG;AACH,wBAAsB,yBAAyB,CAC7C,UAAU,EAAE,MAAM,EAClB,MAAM,SAAmC,GACxC,OAAO,CAAC,kBAAkB,CAAC,CAyE7B;AAED,8DAA8D;AAC9D,wBAAgB,YAAY,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAEtD;AAED;;;;GAIG;AACH,wBAAsB,wBAAwB,CAC5C,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,eAAe,GAAG,SAAS,CAAC,CAmFtC"}
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"}