@vibe-agent-toolkit/cli 0.2.0-rc.3 → 0.2.0-rc.5

package/dist/commands/phase-utils.js

@@ -1,10 +1,7 @@
 /**
  * Shared utilities for top-level phase orchestration commands (vat build, vat verify, vat validate).
  */
-import { spawnSync } from 'node:child_process';
-import { safePath } from '@vibe-agent-toolkit/utils';
 import { Option } from 'commander';
-import * as YAML from 'yaml';
 import { createLogger } from '../utils/logger.js';
 import { writeYamlOutput } from '../utils/output.js';
 /**
@@ -55,61 +52,47 @@ export function rejectRetiredOnly(only, command, seconds) {
 }
 /** The phase outcome for "we did not learn what this phase would have said". */
 export const SYSTEM_ERROR = 'system-error';
-/**
- * Resolve the absolute path to the vat binary.
- * This file lives in commands/, one level above bin/.
- */
-export function resolveBinPath() {
-    // Use bin.js directly (not the vat.js wrapper) so phase subprocesses always
-    // run the same binary that is currently executing, regardless of cwd or
-    // context detection (which would pick up the adopter project's local install).
-    return safePath.resolve(safePath.join(import.meta.dirname, '../bin.js'));
-}
 /**
  * Create the shared phase command context: logger, startTime, and bin path.
  *
- * It used to THROW when the phase list came out empty — and it was called
- * before the command's try block, so an unroutable `--only` reached the user as
- * a raw Node stack trace with zero bytes of stdout and an exit 1 that looked
- * like "validation errors". `--only` routing is decided by
- * {@link decidePhaseSelection} and reported by {@link applyPhaseSelection} now,
- * which emit the command's normal structured document.
+ * Total by design: it builds the context and decides nothing.
+ *
+ * ⚠️ This runs BEFORE the command's try block, so anything that throws here
+ * reaches the user as a raw Node stack trace with zero bytes of stdout and an
+ * exit 1 indistinguishable from "validation errors". Phase routing therefore
+ * belongs to {@link decidePhaseSelection} and {@link applyPhaseSelection}, which
+ * emit the command's normal structured document.
  */
 export function createPhaseContext(debugFlag) {
     return {
         logger: createLogger(debugFlag ? { debug: true } : {}),
         startTime: Date.now(),
-        binPath: resolveBinPath(),
     };
 }
 /**
  * Decide what an orchestrator should do with its `--only` value and the phase
  * list its config produced.
  *
- * Shared by all three orchestrators because they used to disagree: `vat verify`
- * built its phase list without consulting the config at all, so `vat verify
- * --only skills` in a project with no `skills:` block exited 0 while `vat
- * validate --only skills` on the same project exited 1 — opposite verdicts on
- * the same question. (`vat verify` has since retired `--only` entirely and now
- * always passes `only: undefined`; `vat validate` and `vat build` still route
- * their own `--only` through here.)
+ * THE single decision site for all three orchestrators, so they cannot answer
+ * the same question differently. An orchestrator that builds its phase list
+ * without consulting the config exits 0 on `--only skills` in a project with no
+ * `skills:` block while another exits 1 — opposite verdicts on one question.
+ * `vat verify` has retired `--only` and always passes `only: undefined`;
+ * `vat validate` and `vat build` route their own `--only` through here.
  *
- * There used to be a third option, `emptyIsValid`, which existed solely so
- * `vat verify --only consistency` could run with an empty SUBPROCESS list
- * (consistency runs in-process). It was checked BEFORE `unreadableConfig`, so
- * `vat verify --only consistency` against an unparseable config answered the
- * confidently-wrong "no skills: block" instead of reporting the config error.
- * `--only` is gone from verify, `emptyIsValid` went with it, and that ordering
- * hazard cannot recur: nothing short-circuits ahead of the config-error arm.
+ * ⚠️ **Nothing may short-circuit ahead of the config-error arm.** A check
+ * evaluated before `unreadableConfig` answers a confident "not configured" for a
+ * tree whose config could not be parsed — which is the one answer this function
+ * must never give, because it is indistinguishable from a correct one.
  *
  * @param unreadableConfig - The config-load error, when the config exists but
  *   could not be parsed. A broken config is NOT "the phase is unconfigured":
  *   we do not know what it declares, so we must not answer with a confident
  *   "not configured". Only `vat verify` passes it, and only defensively — its
- *   phase builder pushes every subprocess phase when the config is unreadable
- *   (so the CHILD reports the real error), which makes the list non-empty and
- *   this arm unreachable by construction today. It is kept because the arm that
- *   would otherwise catch an empty list is the "not configured" lie.
+ *   phase builder pushes every configured phase when the config is unreadable
+ *   (so the phase itself reports the real error), which makes the list non-empty
+ *   and this arm unreachable by construction today. It is kept because the arm
+ *   that would otherwise catch an empty list is the "not configured" lie.
  */
 export function decidePhaseSelection(only, phases, vocab, options = {}) {
     const lower = vocab.noun.toLowerCase();
@@ -139,9 +122,9 @@ export function decidePhaseSelection(only, phases, vocab, options = {}) {
  * Act on a {@link PhaseSelection}: return the phases to run, or emit the
  * command's normal structured document and exit.
  *
- * Both terminal arms go through `writeYamlOutput` deliberately. A `--only`
- * failure used to be an uncaught throw, so the one output a scripted caller
- * parses — the YAML document on stdout — was never written at all.
+ * Both terminal arms go through `writeYamlOutput` deliberately: the YAML
+ * document on stdout is the one output a scripted caller parses, so a routing
+ * failure has to publish one rather than throw past it.
  */
 export function applyPhaseSelection(selection, logger, startTime) {
     if (selection.kind === 'run') {
@@ -172,46 +155,9 @@ const PHASE_STATUS_ORDER = ['success', 'warning', 'error', 'system-error'];
 export function worseOf(a, b) {
     return PHASE_STATUS_ORDER.indexOf(b) > PHASE_STATUS_ORDER.indexOf(a) ? b : a;
 }
-/** Every value a child may legitimately report as its own `status`. */
+/** Every value a phase may legitimately report as its own `status`. */
 const REPORTABLE_STATUSES = new Set(PHASE_STATUS_ORDER);
-/**
- * Parse the child's captured stdout into its reported document.
- *
- * Takes the LAST non-empty document in the stream: every orchestrated child
- * writes its summary last, and a child that happens to emit more than one
- * document must not make the summary unreadable.
- *
- * Empty stdout is NOT a failure — `vat skills validate` legitimately exits 0
- * printing nothing when there is no `skills:` block. Stdout that exists but
- * cannot be parsed IS a failure: the child crashed mid-answer, and the phase
- * must degrade to `system-error` rather than throw an unhandled exception out
- * of the orchestrator.
- */
-function parseChildReport(name, stdout) {
-    if (stdout === undefined || stdout === null || stdout.trim() === '') {
-        return {};
-    }
-    let documents;
-    try {
-        documents = YAML.parseAllDocuments(stdout);
-    }
-    catch (error) {
-        return { parseError: unparseableMessage(name, error) };
-    }
-    const last = documents.findLast((doc) => doc.contents !== null);
-    if (last === undefined) {
-        return {};
-    }
-    if (last.errors.length > 0) {
-        return { parseError: unparseableMessage(name, last.errors[0]) };
-    }
-    return { report: last.toJS() };
-}
-function unparseableMessage(name, cause) {
-    const detail = cause instanceof Error ? cause.message : String(cause);
-    return `Phase '${name}' wrote unparseable output on stdout: ${detail}`;
-}
-/** The status an exit code alone implies, before the child's report is read. */
+/** The status an exit code alone implies, before the phase's report is read. */
 function statusFromExitCode(status) {
     if (status === 0)
         return 'success';
@@ -219,7 +165,7 @@ function statusFromExitCode(status) {
         return 'error';
     return SYSTEM_ERROR;
 }
-/** The status the child claimed for itself, when it claimed a recognized one. */
+/** The status the phase claimed for itself, when it claimed a recognized one. */
 function statusFromReport(report) {
     if (typeof report !== 'object' || report === null)
         return undefined;
@@ -229,49 +175,30 @@ function statusFromReport(report) {
         : undefined;
 }
 /**
- * Map a spawn outcome to a phase outcome. The pure core of {@link runPhase}.
+ * Map what a phase produced to its outcome. The pure core of {@link runPhase}.
  *
- * Every branch that is NOT "the child ran and told us what it found" is a
- * system error, because the orchestrator learned nothing about the artifact:
+ * | exit code             | phase status   | why                                     |
+ * |-----------------------|----------------|-----------------------------------------|
+ * | 0                     | `success`      | ran, found nothing actionable           |
+ * | 1                     | `error`        | ran, found validation errors            |
+ * | 2 (or any other)      | `system-error` | the phase itself reported a system error |
  *
- * | spawn outcome            | phase status   | why                                        |
- * |--------------------------|----------------|--------------------------------------------|
- * | `error` set              | `system-error` | the child never ran                        |
- * | killed by a signal       | `system-error` | the child was cut off mid-answer           |
- * | no exit code, no signal  | `system-error` | there is no answer to read                 |
- * | stdout not parseable     | `system-error` | the child's answer cannot be read          |
- * | exit 0                   | `success`      | ran, found nothing actionable              |
- * | exit 1                   | `error`        | ran, found validation errors               |
- * | exit 2 (or any other)    | `system-error` | the child itself reported a system error    |
+ * The exit code is then reconciled with the phase's OWN reported `status`,
+ * worst-wins. An exit code has three values and cannot express `warning`:
+ * `vat skills validate` exits 0 while reporting `status: warning`, so its exit
+ * code alone reads as `success` — including on the tree VAT's CI dogfoods on
+ * VAT itself.
  *
- * The exit code is then reconciled with the child's OWN reported `status`,
- * worst-wins. An exit code has three values and cannot express `warning`, so
- * `vat skills validate` — which exits 0 while reporting `status: warning` —
- * was being recorded as `success` by every orchestrator, including the one
- * VAT's CI dogfoods on VAT itself.
+ * The table has no row for a signal kill, a missing status code, or a document
+ * that fails to parse, and that is the design rather than an omission. A phase
+ * runs in this process: there is no serialization step in which to lose a
+ * document, and no signal that could take a phase without taking the
+ * orchestrator with it.
  */
-export function phaseResultFromSpawn(name, outcome) {
-    if (outcome.error !== undefined) {
-        return { name, status: SYSTEM_ERROR, error: `Failed to spawn phase: ${outcome.error.message}` };
-    }
-    if (outcome.signal !== null) {
-        return {
-            name,
-            status: SYSTEM_ERROR,
-            signal: outcome.signal,
-            error: `Phase '${name}' was killed by signal ${outcome.signal}`,
-        };
-    }
-    if (outcome.status === null) {
-        return { name, status: SYSTEM_ERROR, error: `Phase '${name}' exited without a status code` };
-    }
-    const exitCode = outcome.status;
-    const { report, parseError } = parseChildReport(name, outcome.stdout);
-    if (parseError !== undefined) {
-        return { name, status: SYSTEM_ERROR, exitCode, error: parseError };
-    }
+export function phaseResultFromOutcome(name, outcome) {
+    const { exitCode, document } = outcome;
     const exitStatus = statusFromExitCode(exitCode);
-    const reported = statusFromReport(report);
+    const reported = statusFromReport(document);
     const status = reported === undefined ? exitStatus : worseOf(exitStatus, reported);
     return {
         name,
@@ -280,37 +207,64 @@ export function phaseResultFromSpawn(name, outcome) {
         ...(exitStatus === SYSTEM_ERROR
             ? { error: `Phase '${name}' exited with system-error code ${exitCode}` }
             : {}),
-        ...(report === undefined ? {} : { report }),
+        ...(document === undefined ? {} : { report: document }),
     };
 }
 /**
- * Cap on a captured child document, well above the ~2.3 MB a large real project
- * produces. spawnSync's 1 MB default would set ENOBUFS and hand back a
- * TRUNCATED (and therefore unparseable) document; exceeding this cap surfaces
- * as a loud `system-error`, never as a silently shortened report.
+ * End a command-line run from a phase outcome: publish the document, then exit.
+ *
+ * THE single place the two lanes diverge, so they cannot diverge anywhere else.
+ * A phase hands back the same `{ document, exitCode }` either way; this decides
+ * what a *command* does with it, while an orchestrator folds it into
+ * `phases[].report` instead.
+ *
+ * Three cases, and the middle one is the one to get right:
+ *   - an unexpected failure publishes the shared envelope through
+ *     `writeYamlOutput`, matching `handleCommandError`;
+ *   - a command's own report goes through the command's own `render`;
+ *   - no document at all (an unconfigured run, a dry run) publishes nothing.
+ *
+ * @param outcome - What the phase produced
+ * @param render - How this command publishes its OWN report shape
  */
-const MAX_PHASE_STDOUT_BYTES = 256 * 1024 * 1024;
+export function finishCommand(outcome, render) {
+    if (outcome.failed === true) {
+        writeYamlOutput(outcome.document);
+    }
+    else if (outcome.document !== undefined) {
+        render(outcome.document);
+    }
+    return process.exit(outcome.exitCode);
+}
 /**
- * Run a single phase by spawning the vat binary with the phase args.
+ * Run a single phase in THIS process and fold its outcome into a result.
+ *
+ * In THIS process, because everything an orchestrator reads back from a phase is
+ * the {@link PhaseOutcome} pair. A process per phase buys neither half of it and
+ * charges, on every phase, a full Node startup and the whole module graph again
+ * (~730 ms of remark per isolate), a parse cache whose miss counters restart
+ * from zero, and a worker pool built and torn down before the next phase begins.
+ * Phases run sequentially, so none of that cost is ever overlapped with work.
+ *
+ * The `catch` is a BACKSTOP, not the error path. Every phase function reports
+ * its own failures through `reportCommandError` and returns them as a document.
  *
- * stdout is CAPTURED, not inherited: the child's YAML document belongs in this
- * phase's `report`, and letting it stream onto the parent's stdout is what made
- * `vat validate`'s output a run of documents with no `---` between them.
- * stderr stays inherited — progress output is on stderr by design and must keep
- * streaming live rather than arriving in one lump at the end.
+ * ⚠️ This arm exists for a throw that escaped that handling. Sharing the
+ * orchestrator's process is what makes it load-bearing: an escaped throw aborts
+ * the orchestrator itself and silently skips every later phase.
  */
-export function runPhase(binPath, phase) {
-    const result = spawnSync(process.execPath, [binPath, ...phase.args], {
-        stdio: ['inherit', 'pipe', 'inherit'],
-        encoding: 'utf8',
-        maxBuffer: MAX_PHASE_STDOUT_BYTES,
-    });
-    return phaseResultFromSpawn(phase.name, {
-        status: result.status,
-        signal: result.signal,
-        error: result.error,
-        stdout: result.stdout,
-    });
+export async function runPhase(phase) {
+    try {
+        return phaseResultFromOutcome(phase.name, await phase.run());
+    }
+    catch (error) {
+        const detail = error instanceof Error ? error.message : String(error);
+        return {
+            name: phase.name,
+            status: SYSTEM_ERROR,
+            error: `Phase '${phase.name}' threw past its own error handling: ${detail}`,
+        };
+    }
 }
 /**
  * Worst-wins aggregate across phases. `system-error` outranks `error`: "we could
@@ -326,16 +280,16 @@ export function aggregatePhaseStatus(results) {
 /**
  * One phase's per-severity distribution, wherever that phase keeps it.
  *
- * An in-process phase holds its own findings and publishes {@link
- * PhaseResult.issueCounts}. A subprocess phase deliberately does not — the child
- * owns its findings, and its document rides verbatim in {@link
- * PhaseResult.report}. Reading only the former is why an orchestrator's header
- * could report `{0, 0, 0}` over children that had just reported 12 warnings.
+ * A phase that holds its own findings publishes {@link PhaseResult.issueCounts}.
+ * A phase that publishes its own document deliberately does not — it owns its
+ * findings, and its document rides verbatim in {@link PhaseResult.report}.
+ *
+ * ⚠️ Both places must be read. Reading only `issueCounts` makes an
+ * orchestrator's header report `{0, 0, 0}` over phases that just reported 12
+ * warnings.
  *
  * Absent or malformed counts read as zero rather than throwing: a phase that
- * published no distribution contributes nothing to the total, which is the same
- * answer as before this function existed — just no longer the answer for phases
- * that DID publish one.
+ * publishes no distribution contributes nothing to the total.
  */
 export function phaseIssueCounts(result) {
     if (result.issueCounts)
@@ -354,10 +308,10 @@ export function phaseIssueCounts(result) {
  * Sum every phase's distribution, so an orchestrator's header total reconciles
  * against the phases printed beneath it.
  *
- * The companion to {@link aggregatePhaseStatus}: status has always been
- * worst-wins ACROSS phases, and a header whose `status` can see the children
- * while its `issueCounts` cannot is the same contradiction in one document —
- * `status: warning` beside `warnings: 0`.
+ * The companion to {@link aggregatePhaseStatus}: status is worst-wins ACROSS
+ * phases, so a header whose `status` can see the phases while its `issueCounts`
+ * cannot publishes a contradiction in one document — `status: warning` beside
+ * `warnings: 0`.
  */
 export function aggregatePhaseIssueCounts(results) {
     const total = { errors: 0, warnings: 0, info: 0 };

package/dist/commands/phase-utils.js.map

@@ -1 +1 @@
-{"version":3,"file":"phase-utils.js","sourceRoot":"","sources":["../../src/commands/phase-utils.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"phase-utils.js","sourceRoot":"","sources":["../../src/commands/phase-utils.ts"],"names":[],"mappings":"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"}

package/dist/commands/resources/check-progress.d.ts

@@ -0,0 +1,145 @@
+/**
+ * The progress log a supervised `vat resources check` writes, and the reader
+ * that turns whatever survived into a report.
+ *
+ * ## 🚨 Why progress goes to a FILE, and never to stdout or IPC
+ *
+ * The run this log exists for is one that gets `SIGKILL`ed. That is not a design
+ * preference: a statement blocked inside synchronous `node:sqlite` never returns
+ * to the event loop, so nothing in-process can interrupt it — measured on Node
+ * 24.13.1, `worker.terminate()` never resolves against such a thread and the
+ * parent's own `process.exit()` does not exit either. An external `SIGKILL` is
+ * the only lever, and `SIGKILL` cannot be handled, deferred or flushed.
+ *
+ * So the child's report of what it has finished has to be DURABLE at every
+ * instant, not merely sent. stdout is buffered by the pipe and lost with the
+ * process; an IPC message needs a live event loop to be delivered, which is the
+ * exact resource the hung child does not have. An `appendFileSync` per unit is
+ * on disk before the next unit starts, which is the only property that matters.
+ *
+ * Keeping it off stdout has a second benefit worth stating: stdout stays the one
+ * parseable document this verb has always published, so `vat resources check |
+ * jq` is unaffected by a mechanism it should never have to know about.
+ *
+ * ## 🪤 The reader must expect DAMAGE, not merely tolerate it
+ *
+ * The signal lands wherever it lands, including part-way through a write, so the
+ * last line of a killed run's log is routinely half a JSON object. A reader that
+ * threw there would replace the bounded failure report with a stack trace at
+ * exactly the moment the report is the only thing the operator gets. A reader
+ * that GUESSED at a damaged line would be worse still: it would publish a cost
+ * record for a measurement nobody took, beside ones somebody did.
+ *
+ * Every line is therefore validated against a `.strict()` schema and silently
+ * dropped when it does not parse. That schema is also the whole of the format
+ * contract — there is no version integer here and there must never be one. This
+ * file is written and read by ONE process pair within ONE run of ONE build; the
+ * question a version integer pretends to answer ("can I read this?") is answered
+ * exactly and automatically by the schema the reader compiles with.
+ */
+import { z } from 'zod';
+declare const ProgressEntrySchema: z.ZodDiscriminatedUnion<"kind", [z.ZodObject<{
+    kind: z.ZodLiteral<"population">;
+    population: z.ZodUnion<[z.ZodLiteral<"derived">, z.ZodLiteral<"store">]>;
+    populationMs: z.ZodNumber;
+    membersEnumerated: z.ZodNumber;
+}, "strict", z.ZodTypeAny, {
+    kind: "population";
+    population: "derived" | "store";
+    populationMs: number;
+    membersEnumerated: number;
+}, {
+    kind: "population";
+    population: "derived" | "store";
+    populationMs: number;
+    membersEnumerated: number;
+}>, z.ZodObject<{
+    kind: z.ZodLiteral<"start">;
+    name: z.ZodString;
+}, "strict", z.ZodTypeAny, {
+    name: string;
+    kind: "start";
+}, {
+    name: string;
+    kind: "start";
+}>, z.ZodObject<{
+    kind: z.ZodLiteral<"check">;
+    name: z.ZodString;
+    durationMs: z.ZodNumber;
+    rows: z.ZodOptional<z.ZodNumber>;
+    broken: z.ZodOptional<z.ZodLiteral<true>>;
+}, "strict", z.ZodTypeAny, {
+    name: string;
+    kind: "check";
+    durationMs: number;
+    rows?: number | undefined;
+    broken?: true | undefined;
+}, {
+    name: string;
+    kind: "check";
+    durationMs: number;
+    rows?: number | undefined;
+    broken?: true | undefined;
+}>, z.ZodObject<{
+    kind: z.ZodLiteral<"checks-complete">;
+}, "strict", z.ZodTypeAny, {
+    kind: "checks-complete";
+}, {
+    kind: "checks-complete";
+}>]>;
+/** One line of the progress log. */
+export type ProgressEntry = z.infer<typeof ProgressEntrySchema>;
+/**
+ * What the run was doing when it was killed.
+ *
+ * `idle` and `reporting` are both real answers and neither is a fallback.
+ * `idle` is the gap between the population and the first statement — nothing had
+ * started. `reporting` is the opposite end: every check finished and the child
+ * was assembling and serialising its document. Naming a rule in either would
+ * blame one that did not hang, and collapsing the two would tell an operator
+ * "between the population and the first statement" about a run that completed
+ * forty rules.
+ */
+export type UnitInFlight = {
+    readonly kind: 'population';
+} | {
+    readonly kind: 'check';
+    readonly name: string;
+} | {
+    readonly kind: 'reporting';
+} | {
+    readonly kind: 'idle';
+};
+/**
+ * Read whatever of the log survived.
+ *
+ * @param text - The log's raw contents, tail damage and all
+ * @returns The lines that validate, in the order they were written
+ */
+export declare function parseProgressLog(text: string): ProgressEntry[];
+/**
+ * Which unit was running when the log stopped growing.
+ *
+ * 🔑 The population sentinel is keyed on the population line's ABSENCE rather
+ * than on there being no `start` lines. Those are different states: a run killed
+ * during population has no projection and no honest document, while a run killed
+ * between the population and the first statement has both.
+ *
+ * @param entries - What {@link parseProgressLog} recovered
+ * @returns The unit in flight
+ */
+export declare function unitInFlight(entries: readonly ProgressEntry[]): UnitInFlight;
+/**
+ * Open the log for append, and hand back the one-line-per-unit writer.
+ *
+ * ⚠️ `appendFileSync`, and it must stay synchronous. The child that writes these
+ * lines is about to enter a blocking native call; an asynchronous write would be
+ * queued behind work the event loop never gets back to, so the line naming the
+ * rule that hangs would exist only in memory — where `SIGKILL` destroys it.
+ *
+ * @param path - Where the supervisor is watching
+ * @returns A writer that appends one entry and returns once it is on disk
+ */
+export declare function createProgressWriter(path: string): (entry: ProgressEntry) => void;
+export {};
+//# sourceMappingURL=check-progress.d.ts.map

package/dist/commands/resources/check-progress.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"check-progress.d.ts","sourceRoot":"","sources":["../../../src/commands/resources/check-progress.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsCG;AAIH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AA0ExB,QAAA,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAKvB,CAAC;AAEH,oCAAoC;AACpC,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAEhE;;;;;;;;;;GAUG;AACH,MAAM,MAAM,YAAY,GACpB;IAAE,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAA;CAAE,GAC/B;IAAE,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GACjD;IAAE,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAA;CAAE,GAC9B;IAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC;AAE9B;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,aAAa,EAAE,CAQ9D;AAyBD;;;;;;;;;;GAUG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,SAAS,aAAa,EAAE,GAAG,YAAY,CAuB5E;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,CAAC,KAAK,EAAE,aAAa,KAAK,IAAI,CAKjF"}