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
@@ -10,6 +10,11 @@ import { buildLaunchdCalendar, buildOneShotGuardCommand, launchdLabel } from "..
10
10
  import { systemTimeZone, } from "../schedule-v2.js";
11
11
  import { PosixSchedulerBase } from "./posix.js";
12
12
  const execFileAsync = promisify(execFile);
13
+ /** O-2: неудачная уборка temp/plist не проглатывается молча. */
14
+ function warnCleanupFailure(target, error) {
15
+ const reason = error instanceof Error ? error.message : String(error);
16
+ console.warn(`[agent-steward] Не удалось удалить plist «${target}»: ${reason}`);
17
+ }
13
18
  /** Папка пользовательских LaunchAgents. */
14
19
  const LAUNCH_AGENTS_DIR = path.join(os.homedir(), "Library", "LaunchAgents");
15
20
  /** Экранирует текст для XML. */
@@ -186,12 +191,108 @@ function buildPlist(label, entry) {
186
191
  "",
187
192
  ].join("\n");
188
193
  }
194
+ /** Ошибка запуска launchctl с командой, кодом выхода и stderr. */
195
+ export function describeLaunchctlError(args, err) {
196
+ const error = err;
197
+ const stderr = String(error.stderr ?? "").trim();
198
+ const stdout = String(error.stdout ?? "").trim();
199
+ const detail = stderr || stdout || error.message || "вывод пуст";
200
+ const status = error.code !== undefined
201
+ ? `код ${String(error.code)}`
202
+ : error.signal
203
+ ? `сигнал ${error.signal}`
204
+ : "без кода выхода";
205
+ return `launchctl ${args.join(" ")}: ${status}: ${detail}`;
206
+ }
207
+ /**
208
+ * Запускает launchctl и либо пробрасывает ошибку с stderr/exit code,
209
+ * либо глотает её (unload незагруженного агента — штатная ситуация).
210
+ */
211
+ export async function runLaunchctl(runner, args, options = {}) {
212
+ try {
213
+ await runner(args);
214
+ }
215
+ catch (err) {
216
+ if (options.tolerateFailure)
217
+ return;
218
+ const failure = new Error(describeLaunchctlError(args, err));
219
+ // target/lib проекта не включает ErrorOptions, поэтому cause ставим вручную.
220
+ failure.cause = err;
221
+ throw failure;
222
+ }
223
+ }
224
+ /**
225
+ * B5: `load -w` не только загружает агент, но и снимает Disabled,
226
+ * поэтому для приостановленной задачи его вызывать нельзя — иначе
227
+ * установка молча возобновляет задачу. Вместо этого `unload -w`
228
+ * фиксирует Disabled, чтобы launchd не загрузил агент при следующем входе.
229
+ */
230
+ export function planLaunchctlInstall(paused, plistPath) {
231
+ if (paused) {
232
+ return {
233
+ beforeWrite: ["unload", "-w", plistPath],
234
+ afterWrite: null,
235
+ };
236
+ }
237
+ return {
238
+ beforeWrite: ["unload", plistPath],
239
+ afterWrite: ["load", "-w", plistPath],
240
+ };
241
+ }
242
+ /**
243
+ * ML-1: macOS 13 (Darwin 22) заменяет `load`/`unload` на `bootstrap`/`bootout`
244
+ * с явным доменом `gui/<uid>`. `-w` у legacy-команды здесь не нужен: bootstrap
245
+ * сам регистрирует агент, а bootout — снимает регистрацию.
246
+ */
247
+ export function modernLaunchctlArgs(args, uid = process.getuid?.() ?? 501) {
248
+ const [command, ...rest] = args;
249
+ if (command !== "load" && command !== "unload")
250
+ return args;
251
+ const plist = rest.filter((part) => part !== "-w");
252
+ return [command === "load" ? "bootstrap" : "bootout", `gui/${uid}`, ...plist];
253
+ }
254
+ /** Современные команды доступны на macOS 13+ (Darwin 22+). */
255
+ export function supportsModernLaunchctl(platform = process.platform, release = os.release()) {
256
+ if (platform !== "darwin")
257
+ return true;
258
+ const darwinMajor = Number.parseInt(release.split(".")[0] ?? "", 10);
259
+ return Number.isFinite(darwinMajor) ? darwinMajor >= 22 : true;
260
+ }
261
+ /** Признак того, что launchctl не знает bootstrap/bootout (максимально старая macOS). */
262
+ function needsLegacyLaunchctlFallback(error) {
263
+ const source = error;
264
+ const text = `${String(source?.message ?? "")}\n${String(source?.stderr ?? "")}`;
265
+ return /unrecognized subcommand|unknown subcommand|invalid subcommand|unrecognized option|Usage:/i.test(text);
266
+ }
267
+ /**
268
+ * Выполняет launchctl через современные команды; при отсутствии поддержки
269
+ * (macOS < 13 или «unrecognized subcommand») повторяет legacy-аргументы.
270
+ */
271
+ export async function runLaunchctlModern(runner, args, options = {}) {
272
+ const modern = supportsModernLaunchctl() ? modernLaunchctlArgs(args) : args;
273
+ await runLaunchctl(async (call) => {
274
+ try {
275
+ await runner(call);
276
+ }
277
+ catch (err) {
278
+ if (modern !== args && needsLegacyLaunchctlFallback(err)) {
279
+ await runner(args);
280
+ return;
281
+ }
282
+ throw err;
283
+ }
284
+ }, modern, options);
285
+ }
189
286
  /**
190
287
  * Бэкенд планировщика macOS на основе launchd.
191
288
  *
192
289
  * Каждая задача — отдельный LaunchAgent:
193
290
  * ~/Library/LaunchAgents/com.opencode.scheduler.<name>.plist
194
- * Управление — через launchctl load/unload -w.
291
+ * Управление — через `launchctl bootstrap/bootout` (macOS ≥13), с фолбэком
292
+ * на legacy `load/unload -w` для более старых систем. `planLaunchctlInstall`
293
+ * намеренно остаётся на legacy-командах: обратная совместимость контракта.
294
+ * Ошибки загрузки не глотаются: битый plist должен вернуть ошибку установки,
295
+ * а не оставить задачу молча незапланированной.
195
296
  */
196
297
  export class MacScheduler extends PosixSchedulerBase {
197
298
  constructor(profile = getProfileName()) {
@@ -223,33 +324,43 @@ export class MacScheduler extends PosixSchedulerBase {
223
324
  plistPath(name) {
224
325
  return path.join(LAUNCH_AGENTS_DIR, `${this.label(name)}.plist`);
225
326
  }
226
- /** Выполняет launchctl, не считая ошибку фатальной (unload несуществующего). */
227
- async launchctl(args) {
228
- try {
229
- await execFileAsync("launchctl", args, { maxBuffer: 1024 * 1024 });
230
- }
231
- catch {
232
- // launchctl возвращает ошибку, если агент ещё не загружен — это нормально.
233
- }
327
+ /** Выполняет launchctl; tolerateFailure оставлен только для bootout/unload. */
328
+ async launchctl(args, options = {}) {
329
+ await runLaunchctlModern((call) => execFileAsync("launchctl", call, { maxBuffer: 1024 * 1024 }), args, options);
234
330
  }
235
331
  async installEntry(entry) {
236
332
  await fs.mkdir(LAUNCH_AGENTS_DIR, { recursive: true });
237
333
  const plistPath = this.plistPath(entry.name);
238
- await this.launchctl(["unload", plistPath]);
239
- await fs.writeFile(plistPath, buildPlist(this.label(entry.name), entry), "utf8");
240
- await this.launchctl(["load", "-w", plistPath]);
334
+ const plan = planLaunchctlInstall(entry.paused, plistPath);
335
+ // Агент мог быть не загружен — это не ошибка.
336
+ await this.launchctl(plan.beforeWrite, { tolerateFailure: true });
337
+ // Пишем в уникальный temp и переименовываем: launchctl не должен увидеть
338
+ // полузаписанный plist, если процесс упадёт посреди записи.
339
+ const tmpPath = `${plistPath}.${process.pid}.${Date.now()}.tmp`;
340
+ try {
341
+ await fs.writeFile(tmpPath, buildPlist(this.label(entry.name), entry), "utf8");
342
+ await fs.rename(tmpPath, plistPath);
343
+ }
344
+ catch (error) {
345
+ await fs.rm(tmpPath, { force: true }).catch((cleanupError) => warnCleanupFailure(tmpPath, cleanupError));
346
+ throw error;
347
+ }
348
+ if (plan.afterWrite) {
349
+ await this.launchctl(plan.afterWrite);
350
+ }
241
351
  }
242
352
  async uninstallEntry(entry) {
243
353
  const plistPath = this.plistPath(entry.name);
244
- await this.launchctl(["unload", "-w", plistPath]);
245
- await fs.unlink(plistPath).catch(() => { });
354
+ await this.launchctl(["unload", "-w", plistPath], { tolerateFailure: true });
355
+ await fs.unlink(plistPath).catch((error) => warnCleanupFailure(plistPath, error));
246
356
  }
247
357
  async applyPause(entry, paused) {
248
358
  const plistPath = this.plistPath(entry.name);
249
359
  if (paused) {
250
- await this.launchctl(["unload", "-w", plistPath]);
360
+ await this.launchctl(["unload", "-w", plistPath], { tolerateFailure: true });
251
361
  }
252
362
  else {
363
+ // Возобновление не должно «удаваться» молча при битом plist.
253
364
  await this.launchctl(["load", "-w", plistPath]);
254
365
  }
255
366
  }
@@ -1 +1 @@
1
- {"version":3,"file":"windows.d.ts","sourceRoot":"","sources":["../../../src/core/scheduler/windows.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"windows.d.ts","sourceRoot":"","sources":["../../../src/core/scheduler/windows.ts"],"names":[],"mappings":"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"}
@@ -7,22 +7,25 @@ import { buildScheduleFlags, convertCronToSchTasks } from "../cron-to-schtasks.j
7
7
  import { buildWindowsOneShotFlags } from "../one-shot.js";
8
8
  import { needsPollMode } from "../schedule-v2.js";
9
9
  const execFileAsync = promisify(execFile);
10
- /** Кэш формата даты локали Windows (ShortDatePattern), полученного через PowerShell. */
10
+ /** Кэш формата даты локали Windows (ShortDatePattern), полученного через PowerShell.
11
+ * Храним промис, а не готовую строку: параллельные вызовы ждут один и тот же
12
+ * результат и не запускают PowerShell по несколько раз (гонка при await). */
11
13
  let windowsDateFormatCache = null;
12
14
  /** Определяет формат даты системной локали через PowerShell (P1-8). */
13
15
  async function getWindowsDateFormat() {
14
- if (windowsDateFormatCache !== null)
15
- return windowsDateFormatCache;
16
- try {
17
- const { stdout } = await execFileAsync("powershell.exe", ["-NoProfile", "-Command", "(Get-Culture).DateTimeFormat.ShortDatePattern"], { maxBuffer: MAX_OUTPUT_BUFFER });
18
- const pattern = String(stdout).trim();
19
- windowsDateFormatCache = pattern || "dd.MM.yyyy";
20
- return windowsDateFormatCache;
21
- }
22
- catch {
23
- windowsDateFormatCache = "dd.MM.yyyy";
24
- return windowsDateFormatCache;
16
+ if (windowsDateFormatCache === null) {
17
+ windowsDateFormatCache = (async () => {
18
+ try {
19
+ const { stdout } = await execFileAsync("powershell.exe", ["-NoProfile", "-Command", "(Get-Culture).DateTimeFormat.ShortDatePattern"], { maxBuffer: MAX_OUTPUT_BUFFER });
20
+ const pattern = String(stdout).trim();
21
+ return pattern || "dd.MM.yyyy";
22
+ }
23
+ catch {
24
+ return "dd.MM.yyyy";
25
+ }
26
+ })();
25
27
  }
28
+ return windowsDateFormatCache;
26
29
  }
27
30
  /** Форматирует дату «никогда» (заглушка для file/git/mcp-триггеров) в формате локали. */
28
31
  async function buildNeverDate(format) {
@@ -12,7 +12,7 @@
12
12
  * запуск задачи: наблюдаемость не должна влиять на планировщик.
13
13
  */
14
14
  /** События структурированного лога. */
15
- export type StructuredLogEvent = "run.started" | "run.finished" | "hook.received" | string;
15
+ export type StructuredLogEvent = "run.started" | "run.finished" | "hook.received" | "matrix.started" | "matrix.advanced" | "matrix.queue_started" | "matrix.cancelled" | "matrix.aggregated" | "matrix.aggregator_started" | "matrix.error" | string;
16
16
  export interface StructuredLogRecord {
17
17
  /** Время записи (ISO). */
18
18
  ts: string;
@@ -42,6 +42,12 @@ export interface StructuredLogRecord {
42
42
  payloadBytes?: number;
43
43
  /** Причина отказа/пропуска. */
44
44
  reason?: string;
45
+ /** Родительская задача матрицы (matrixId === task для событий matrix.*). */
46
+ matrixId?: string;
47
+ /** Имя клона матрицы, к которому относится событие. */
48
+ cloneName?: string;
49
+ /** Шаг матричного сценария: started, advanced, cancelled, aggregated и т.п. */
50
+ step?: string;
45
51
  }
46
52
  export interface ReadStructuredLogsFilter {
47
53
  task?: string;
@@ -1 +1 @@
1
- {"version":3,"file":"structured-log.d.ts","sourceRoot":"","sources":["../../src/core/structured-log.ts"],"names":[],"mappings":"AAKA;;;;;;;;;;;;GAYG;AAEH,uCAAuC;AACvC,MAAM,MAAM,kBAAkB,GAAG,aAAa,GAAG,cAAc,GAAG,eAAe,GAAG,MAAM,CAAC;AAE3F,MAAM,WAAW,mBAAmB;IAClC,0BAA0B;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,kBAAkB,CAAC;IAC1B,qCAAqC;IACrC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,mEAAmE;IACnE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,2CAA2C;IAC3C,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,0CAA0C;IAC1C,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,iCAAiC;IACjC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,+BAA+B;IAC/B,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,wBAAwB;IACvC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,mCAAmC;IACnC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,kCAAkC;IAClC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,wBAAwB;IACvC,OAAO,EAAE,mBAAmB,EAAE,CAAC;IAC/B,sEAAsE;IACtE,KAAK,EAAE,MAAM,CAAC;IACd,mDAAmD;IACnD,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;CACd;AAED,8CAA8C;AAC9C,eAAO,MAAM,mBAAmB,QAAmC,CAAC;AACpE,eAAO,MAAM,sBAAsB,QAA6B,CAAC;AACjE,eAAO,MAAM,wBAAwB,QAAmB,CAAC;AAiCzD;;;GAGG;AACH,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,IAAI,CAAC,mBAAmB,EAAE,IAAI,CAAC,GAAG;IAAE,EAAE,CAAC,EAAE,MAAM,CAAA;CAAE,GACxD,OAAO,CAsBT;AAcD;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAChC,MAAM,GAAE,wBAA6B,GACpC,wBAAwB,CA4C1B;AAED,sDAAsD;AACtD,wBAAgB,mBAAmB,IAAI,IAAI,CAO1C"}
1
+ {"version":3,"file":"structured-log.d.ts","sourceRoot":"","sources":["../../src/core/structured-log.ts"],"names":[],"mappings":"AAKA;;;;;;;;;;;;GAYG;AAEH,uCAAuC;AACvC,MAAM,MAAM,kBAAkB,GAC1B,aAAa,GACb,cAAc,GACd,eAAe,GACf,gBAAgB,GAChB,iBAAiB,GACjB,sBAAsB,GACtB,kBAAkB,GAClB,mBAAmB,GACnB,2BAA2B,GAC3B,cAAc,GACd,MAAM,CAAC;AAEX,MAAM,WAAW,mBAAmB;IAClC,0BAA0B;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,kBAAkB,CAAC;IAC1B,qCAAqC;IACrC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,mEAAmE;IACnE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,2CAA2C;IAC3C,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,0CAA0C;IAC1C,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,iCAAiC;IACjC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,+BAA+B;IAC/B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,4EAA4E;IAC5E,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,uDAAuD;IACvD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,+EAA+E;IAC/E,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,wBAAwB;IACvC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,mCAAmC;IACnC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,kCAAkC;IAClC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,wBAAwB;IACvC,OAAO,EAAE,mBAAmB,EAAE,CAAC;IAC/B,sEAAsE;IACtE,KAAK,EAAE,MAAM,CAAC;IACd,mDAAmD;IACnD,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;CACd;AAED,8CAA8C;AAC9C,eAAO,MAAM,mBAAmB,QAAmC,CAAC;AACpE,eAAO,MAAM,sBAAsB,QAA6B,CAAC;AACjE,eAAO,MAAM,wBAAwB,QAAmB,CAAC;AAiCzD;;;GAGG;AACH,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,IAAI,CAAC,mBAAmB,EAAE,IAAI,CAAC,GAAG;IAAE,EAAE,CAAC,EAAE,MAAM,CAAA;CAAE,GACxD,OAAO,CAsBT;AAcD;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAChC,MAAM,GAAE,wBAA6B,GACpC,wBAAwB,CA4C1B;AAED,sDAAsD;AACtD,wBAAgB,mBAAmB,IAAI,IAAI,CAO1C"}
@@ -0,0 +1,4 @@
1
+ #!/usr/bin/env node
2
+ /** Точка входа для тестов: возвращает exit code, ничего не завершает. */
3
+ export declare function main(argv?: string[]): Promise<number>;
4
+ //# sourceMappingURL=worktree-run.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"worktree-run.d.ts","sourceRoot":"","sources":["../../src/core/worktree-run.ts"],"names":[],"mappings":";AAiLA,yEAAyE;AACzE,wBAAsB,IAAI,CAAC,IAAI,GAAE,MAAM,EAA0B,GAAG,OAAO,CAAC,MAAM,CAAC,CAOlF"}
@@ -0,0 +1,164 @@
1
+ #!/usr/bin/env node
2
+ /**
3
+ * W-1/W-2 (0.0.6): CLI-помощник обёртки для одноразовых git worktree.
4
+ *
5
+ * Создание (вызывается из сгенерированного .cmd/.sh):
6
+ * node worktree-run.js --repo "<workdir>" --task "<task name>" [--root <dir>] [--json]
7
+ * node worktree-run.js create --repo ... --task ...
8
+ *
9
+ * Очистка (после прогона и для остатков):
10
+ * node worktree-run.js cleanup --path "<worktree>" [--repo <root>] [--root <dir>] [--keep-branch] [--json]
11
+ * node worktree-run.js cleanup --stale [--root <dir>] [--max-age-hours <n>] [--json]
12
+ *
13
+ * При создании в stdout печатается только путь к worktree (одна строка) —
14
+ * обёртка ловит его и переходит туда. Диагностика и ошибки идут в stderr.
15
+ * При ошибке exit 1: обёртка обязана упасть fail-closed, а не работать в
16
+ * основном дереве.
17
+ */
18
+ import path from "node:path";
19
+ import { pathToFileURL } from "node:url";
20
+ import { cleanupStaleWorktrees, createRunWorktree, DEFAULT_STALE_AFTER_MS, removeRunWorktree, } from "./worktree.js";
21
+ function parseArgs(argv) {
22
+ const args = { mode: "create", keepBranch: false, stale: false, json: false };
23
+ let index = 0;
24
+ // Подкоманда необязательна: старые обёртки вызывают помощник без неё.
25
+ if (argv[0] === "create" || argv[0] === "cleanup") {
26
+ args.mode = argv[0];
27
+ index = 1;
28
+ }
29
+ for (; index < argv.length; index += 1) {
30
+ const flag = argv[index];
31
+ const value = argv[index + 1];
32
+ switch (flag) {
33
+ case "--json":
34
+ args.json = true;
35
+ break;
36
+ case "--keep-branch":
37
+ args.keepBranch = true;
38
+ break;
39
+ case "--stale":
40
+ args.stale = true;
41
+ break;
42
+ case "--repo":
43
+ case "--task":
44
+ case "--root":
45
+ case "--path":
46
+ case "--branch":
47
+ case "--max-age-hours": {
48
+ if (!value || value.startsWith("--")) {
49
+ return { args, error: `Флаг ${flag} требует значение.` };
50
+ }
51
+ if (flag === "--repo")
52
+ args.repo = value;
53
+ if (flag === "--task")
54
+ args.task = value;
55
+ if (flag === "--root")
56
+ args.root = value;
57
+ if (flag === "--path")
58
+ args.path = value;
59
+ if (flag === "--branch")
60
+ args.branch = value;
61
+ if (flag === "--max-age-hours") {
62
+ const hours = Number(value);
63
+ if (!Number.isFinite(hours) || hours < 0) {
64
+ return { args, error: "Флаг --max-age-hours требует неотрицательное число." };
65
+ }
66
+ args.maxAgeHours = hours;
67
+ }
68
+ index += 1;
69
+ break;
70
+ }
71
+ default:
72
+ return { args, error: `Неизвестный аргумент: ${flag}` };
73
+ }
74
+ }
75
+ return { args };
76
+ }
77
+ function usage() {
78
+ return [
79
+ "Использование:",
80
+ " worktree-run.js --repo <dir> --task <name> [--root <dir>] [--json]",
81
+ " worktree-run.js create --repo <dir> --task <name> [--root <dir>] [--json]",
82
+ " worktree-run.js cleanup --path <worktree> [--repo <root>] [--root <dir>] [--keep-branch] [--json]",
83
+ " worktree-run.js cleanup --stale [--root <dir>] [--max-age-hours <n>] [--json]",
84
+ ].join("\n");
85
+ }
86
+ async function runCreate(args) {
87
+ if (!args.repo || !args.task) {
88
+ process.stderr.write(`[worktree] ${usage()}\n`);
89
+ return 1;
90
+ }
91
+ // W-2.2: попутная уборка остатков. Не влияет на создание: ошибки уборки
92
+ // игнорируются, свежие worktree не трогаются.
93
+ await cleanupStaleWorktrees({ rootDir: args.root }).catch(() => undefined);
94
+ const result = await createRunWorktree({
95
+ repoDir: args.repo,
96
+ taskName: args.task,
97
+ rootDir: args.root,
98
+ });
99
+ if (!result.ok) {
100
+ process.stderr.write(`[worktree] ${result.error}\n`);
101
+ return 1;
102
+ }
103
+ process.stdout.write(args.json ? `${JSON.stringify(result.worktree)}\n` : `${result.worktree.path}\n`);
104
+ return 0;
105
+ }
106
+ async function runCleanup(args) {
107
+ if (args.stale && args.path) {
108
+ process.stderr.write("[worktree] Нельзя совмещать --stale и --path.\n");
109
+ return 1;
110
+ }
111
+ if (args.stale) {
112
+ const summary = await cleanupStaleWorktrees({
113
+ rootDir: args.root,
114
+ maxAgeMs: args.maxAgeHours === undefined
115
+ ? DEFAULT_STALE_AFTER_MS
116
+ : args.maxAgeHours * 60 * 60 * 1000,
117
+ });
118
+ process.stdout.write(args.json
119
+ ? `${JSON.stringify(summary)}\n`
120
+ : `[worktree] Удалено: ${summary.removed.length}, пропущено: ${summary.skipped.length}, sidecar: ${summary.pruned.length}, ошибок: ${summary.errors.length}${summary.locked ? " (уборка уже выполняется)" : ""}\n`);
121
+ if (summary.errors.length > 0) {
122
+ for (const error of summary.errors)
123
+ process.stderr.write(`[worktree] ${error}\n`);
124
+ return 1;
125
+ }
126
+ return 0;
127
+ }
128
+ if (!args.path) {
129
+ process.stderr.write(`[worktree] ${usage()}\n`);
130
+ return 1;
131
+ }
132
+ const result = await removeRunWorktree({
133
+ path: args.path,
134
+ repoRoot: args.repo,
135
+ branch: args.branch,
136
+ rootDir: args.root,
137
+ deleteBranch: !args.keepBranch,
138
+ });
139
+ if (!result.ok) {
140
+ process.stderr.write(`[worktree] ${result.error}\n`);
141
+ return 1;
142
+ }
143
+ if (args.json)
144
+ process.stdout.write(`${JSON.stringify({ ok: true, path: args.path })}\n`);
145
+ return 0;
146
+ }
147
+ /** Точка входа для тестов: возвращает exit code, ничего не завершает. */
148
+ export async function main(argv = process.argv.slice(2)) {
149
+ const parsed = parseArgs(argv);
150
+ if (parsed.error) {
151
+ process.stderr.write(`[worktree] ${parsed.error}\n`);
152
+ return 1;
153
+ }
154
+ return parsed.args.mode === "cleanup" ? runCleanup(parsed.args) : runCreate(parsed.args);
155
+ }
156
+ const invokedPath = process.argv[1] ? pathToFileURL(path.resolve(process.argv[1])).href : "";
157
+ if (import.meta.url === invokedPath) {
158
+ main().then((code) => {
159
+ process.exitCode = code;
160
+ }, (err) => {
161
+ process.stderr.write(`[worktree] ${err instanceof Error ? err.message : String(err)}\n`);
162
+ process.exitCode = 1;
163
+ });
164
+ }
@@ -0,0 +1,115 @@
1
+ /** Каталог одноразовых worktree. Лежит рядом с prompts/logs и вне репозитория. */
2
+ export declare const WORKTREE_ROOT_DIR: string;
3
+ /** Описание созданного worktree. */
4
+ export interface RunWorktree {
5
+ /** Абсолютный путь рабочей копии. */
6
+ path: string;
7
+ /** Ветка, созданная под запуск. */
8
+ branch: string;
9
+ /** Корень основного репозитория. */
10
+ repoRoot: string;
11
+ /** Коммит, от которого создан worktree. */
12
+ baseCommit: string;
13
+ /** Время создания (ISO-8601). */
14
+ createdAt: string;
15
+ /** Корень, в котором создан worktree (для безопасной очистки). */
16
+ rootDir: string;
17
+ }
18
+ export type CreateWorktreeResult = {
19
+ ok: true;
20
+ worktree: RunWorktree;
21
+ } | {
22
+ ok: false;
23
+ error: string;
24
+ };
25
+ export interface CreateWorktreeOptions {
26
+ /** Рабочая директория задачи: репозиторий (или его подкаталог). */
27
+ repoDir: string;
28
+ /** Имя задачи — основа для пути и ветки. */
29
+ taskName: string;
30
+ /** Куда создавать worktree. По умолчанию PLUGIN_DIR/worktrees. */
31
+ rootDir?: string;
32
+ /** Базовая ссылка (ветка/коммит). По умолчанию HEAD. */
33
+ baseRef?: string;
34
+ }
35
+ /**
36
+ * Возвращает корень git-репозитория для `dir` или null, если это не репозиторий.
37
+ * Работает и для подкаталога, и для уже связанного worktree.
38
+ */
39
+ export declare function isGitRepository(dir: string): Promise<string | null>;
40
+ /**
41
+ * Ошибки, которые стоит перепробовать: гонки lock-файлов и ANTIVIRUS/FS.
42
+ *
43
+ * W-2: общий `No such file` убран из списка. Он маскировал отсутствующий
44
+ * `baseRef` и повреждённый репозиторий под транзиентную гонку: `addWorktree`
45
+ * делал 3 попытки с задержками 50 + 100 мс, а затем возвращал ту же ошибку.
46
+ * Гонки lock-файлов по-прежнему распознаются по `index.lock`, `cannot lock ref`
47
+ * и `Unable to create` — `No such file` может встречаться внутри их текста,
48
+ * но сам по себе больше не является признаком транзиентности.
49
+ */
50
+ export declare function isTransientGitError(message: string): boolean;
51
+ /**
52
+ * Создаёт одноразовый worktree под запуск задачи.
53
+ *
54
+ * Никогда не бросает: ошибки git и файловой системы возвращаются как
55
+ * `{ok:false, error}` — обёртка должна упасть fail-closed с понятным сообщением.
56
+ */
57
+ export declare function createRunWorktree(options: CreateWorktreeOptions): Promise<CreateWorktreeResult>;
58
+ /** Результат удаления одного worktree. */
59
+ export type RemoveWorktreeResult = {
60
+ ok: true;
61
+ } | {
62
+ ok: false;
63
+ error: string;
64
+ };
65
+ export interface RemoveWorktreeOptions {
66
+ /** Абсолютный путь рабочей копии. */
67
+ path: string;
68
+ /** Корень основного репозитория (иначе берётся из sidecar). */
69
+ repoRoot?: string;
70
+ /** Ветка запуска (иначе берётся из sidecar). */
71
+ branch?: string;
72
+ /** Корень worktree (иначе берётся из sidecar или WORKTREE_ROOT_DIR). */
73
+ rootDir?: string;
74
+ /** Удалять ли ветку запуска. По умолчанию true. */
75
+ deleteBranch?: boolean;
76
+ }
77
+ /**
78
+ * Удаляет созданный плагином worktree и его ветку.
79
+ *
80
+ * Защита W-2.2: удаляется только путь внутри каталога worktree, только
81
+ * зарегистрированный в git (или оставшийся каталог со sidecar) и только
82
+ * ветка с префиксом `agent-steward/`. Повторный вызов идемпотентен.
83
+ */
84
+ export declare function removeRunWorktree(options: RemoveWorktreeOptions): Promise<RemoveWorktreeResult>;
85
+ /** Сколько живёт lock уборки, прежде чем считать его осиротевшим. */
86
+ export declare const CLEANUP_LOCK_STALE_MS: number;
87
+ /** По умолчанию осиротевшим считается worktree старше суток. */
88
+ export declare const DEFAULT_STALE_AFTER_MS: number;
89
+ export interface StaleCleanupOptions {
90
+ rootDir?: string;
91
+ /** Возраст, после которого worktree считается остатком. */
92
+ maxAgeMs?: number;
93
+ /** Текущее время (для тестов). */
94
+ now?: number;
95
+ }
96
+ export interface StaleCleanupResult {
97
+ /** Удалённые рабочие копии. */
98
+ removed: string[];
99
+ /** Свежие worktree, которые трогать нельзя. */
100
+ skipped: string[];
101
+ /** Sidecar без рабочей копии — убраны. */
102
+ pruned: string[];
103
+ errors: string[];
104
+ /** Уборку уже выполняет другой процесс. */
105
+ locked: boolean;
106
+ }
107
+ /**
108
+ * Убирает осиротевшие worktree старше `maxAgeMs` и sidecar без рабочей копии.
109
+ *
110
+ * Гонки W-2.2: уборка сериализуется каталогом `.cleanup-lock`; свежие worktree
111
+ * (моложе порога) не трогаются, поэтому активный запуск не будет удалён.
112
+ * Каталоги без sidecar не удаляются — это чужие данные.
113
+ */
114
+ export declare function cleanupStaleWorktrees(options?: StaleCleanupOptions): Promise<StaleCleanupResult>;
115
+ //# sourceMappingURL=worktree.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"worktree.d.ts","sourceRoot":"","sources":["../../src/core/worktree.ts"],"names":[],"mappings":"AAoBA,kFAAkF;AAClF,eAAO,MAAM,iBAAiB,QAAqC,CAAC;AAcpE,oCAAoC;AACpC,MAAM,WAAW,WAAW;IAC1B,qCAAqC;IACrC,IAAI,EAAE,MAAM,CAAC;IACb,mCAAmC;IACnC,MAAM,EAAE,MAAM,CAAC;IACf,oCAAoC;IACpC,QAAQ,EAAE,MAAM,CAAC;IACjB,2CAA2C;IAC3C,UAAU,EAAE,MAAM,CAAC;IACnB,iCAAiC;IACjC,SAAS,EAAE,MAAM,CAAC;IAClB,kEAAkE;IAClE,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,MAAM,oBAAoB,GAC5B;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,QAAQ,EAAE,WAAW,CAAA;CAAE,GACnC;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC;AAEjC,MAAM,WAAW,qBAAqB;IACpC,mEAAmE;IACnE,OAAO,EAAE,MAAM,CAAC;IAChB,4CAA4C;IAC5C,QAAQ,EAAE,MAAM,CAAC;IACjB,kEAAkE;IAClE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,wDAAwD;IACxD,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AA8BD;;;GAGG;AACH,wBAAsB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAKzE;AAwBD;;;;;;;;;GASG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAI5D;AAkDD;;;;;GAKG;AACH,wBAAsB,iBAAiB,CACrC,OAAO,EAAE,qBAAqB,GAC7B,OAAO,CAAC,oBAAoB,CAAC,CA4D/B;AAKD,0CAA0C;AAC1C,MAAM,MAAM,oBAAoB,GAAG;IAAE,EAAE,EAAE,IAAI,CAAA;CAAE,GAAG;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC;AAE/E,MAAM,WAAW,qBAAqB;IACpC,qCAAqC;IACrC,IAAI,EAAE,MAAM,CAAC;IACb,+DAA+D;IAC/D,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,gDAAgD;IAChD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,wEAAwE;IACxE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,mDAAmD;IACnD,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB;AAqED;;;;;;GAMG;AACH,wBAAsB,iBAAiB,CACrC,OAAO,EAAE,qBAAqB,GAC7B,OAAO,CAAC,oBAAoB,CAAC,CAmG/B;AAED,qEAAqE;AACrE,eAAO,MAAM,qBAAqB,QAAiB,CAAC;AAEpD,gEAAgE;AAChE,eAAO,MAAM,sBAAsB,QAAsB,CAAC;AAE1D,MAAM,WAAW,mBAAmB;IAClC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,2DAA2D;IAC3D,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,kCAAkC;IAClC,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,kBAAkB;IACjC,+BAA+B;IAC/B,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,+CAA+C;IAC/C,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,0CAA0C;IAC1C,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,2CAA2C;IAC3C,MAAM,EAAE,OAAO,CAAC;CACjB;AAgCD;;;;;;GAMG;AACH,wBAAsB,qBAAqB,CACzC,OAAO,GAAE,mBAAwB,GAChC,OAAO,CAAC,kBAAkB,CAAC,CA6E7B"}