@ozzylabs/feedradar 0.1.4 → 0.1.5

package/dist/cli/_progress.d.ts

@@ -0,0 +1,138 @@
+import type { AgentProgressCallback } from "../agents/types.js";
+import { noopProgressReporter, type ProgressLevel, type ProgressReporter } from "../core/progress.js";
+/**
+ * Shared progress helpers for `radar research` / `review` / `update`.
+ *
+ * #197 wires `ProgressReporter` (ADR-0015) into the three agent-driven CLIs.
+ * The CLIs each follow the same phase-marker sequence (Loaded item / Loaded
+ * template / Spawning / Agent running / Agent completed / Frontmatter
+ * validated / Status transition), so the boilerplate lives here:
+ *
+ * - {@link parseProgressFlags} normalises `--verbose` / `--quiet` parsing
+ *   (extracting them from `argv` so the per-command `parseArgs` sees a clean
+ *   array)
+ * - {@link buildReporter} centralises the priority chain `RADAR_NO_PROGRESS=1`
+ *   > `--quiet` > `--verbose` > default. The reporter writes to `stderr` so it
+ *   never collides with the existing `io.log()` / `io.warn()` / `io.error()`
+ *   sinks that tests inject (those still drive stdout-like channels).
+ * - {@link buildAgentProgressCallback} adapts the adapter's
+ *   {@link AgentProgressCallback} (which receives raw stdout/stderr chunks)
+ *   into reporter calls. It tracks cumulative stdout bytes so the spinner row
+ *   shows `stdout: 4.2 KB`, and forwards chunks verbatim via `reporter.raw()`
+ *   when the reporter is in verbose mode.
+ * - {@link pollOutputFileSize} starts a 500ms `fs.stat` poll so the spinner
+ *   row can show how big the agent's output file is growing. The agent CLIs
+ *   write the report to disk as they go (or atomically at the end); polling
+ *   the file size is the only stream-agnostic way to surface "something is
+ *   actually happening" because most agent runners only emit chatty stdout
+ *   for tool calls, not for the report body itself.
+ *
+ * Naming convention follows ADR-0015 D4: every phase marker uses the verb-
+ * forms documented there (`Loaded …`, `Spawning …`, `Agent running…`,
+ * `Agent completed (…)`, `Status: … → …`).
+ */
+export interface ProgressFlagState {
+    /** Argv with `--verbose` / `--quiet` stripped. */
+    rest: string[];
+    /** Resolved verbosity level. */
+    level: ProgressLevel;
+    /** Saw `--verbose` flag explicitly. */
+    verbose: boolean;
+    /** Saw `--quiet` flag explicitly. */
+    quiet: boolean;
+}
+export declare class ProgressFlagError extends Error {
+    constructor(message: string);
+}
+/**
+ * Strip `--verbose` / `--quiet` from `argv` and return the resolved
+ * {@link ProgressLevel} plus the remaining argv for the command's own parser.
+ *
+ * Mutually exclusive: passing both raises {@link ProgressFlagError} so the
+ * caller can convert it into an exit-code-2 usage error consistent with the
+ * existing `parseArgs` style. `RADAR_NO_PROGRESS=1` is honoured at reporter
+ * construction time (see {@link buildReporter}); we do not mix env handling
+ * into argv parsing because env is global and argv is per-invocation.
+ */
+export declare function parseProgressFlags(argv: string[]): ProgressFlagState;
+export interface BuildReporterOptions {
+    level: ProgressLevel;
+    /** Test-only TTY override. Falls back to `process.stderr.isTTY` at runtime. */
+    tty?: boolean;
+    /** Test-only output stream override. Defaults to `process.stderr`. */
+    stream?: NodeJS.WritableStream;
+}
+/**
+ * Construct a {@link ProgressReporter} for a CLI invocation. Thin wrapper
+ * around {@link createProgressReporter} that records the helper's existence
+ * for grep-discoverability — production callers route through here so the
+ * defaulting logic stays in one place.
+ *
+ * `level: "quiet"` and `RADAR_NO_PROGRESS=1` both produce a no-op reporter
+ * (the env check happens inside `createProgressReporter`); the CLI keeps its
+ * pre-existing 1-line `io.log("research: wrote …")` summary as the only
+ * surviving signal, satisfying the issue's acceptance criterion 8.
+ */
+export declare function buildReporter(opts: BuildReporterOptions): ProgressReporter;
+/**
+ * Render a byte count for the spinner row. Uses binary prefixes (KiB / MiB)
+ * but renders them as `KB` / `MB` for readability — the spinner is a UX
+ * affordance, not a precise meter, and the ADR-0015 D4 examples show `4.2 KB`
+ * without binary-suffix pedantry.
+ */
+export declare function formatBytes(n: number): string;
+/**
+ * Bridge {@link AgentProgressCallback} (raw stdout / stderr chunks) to a
+ * {@link ProgressReporter}.
+ *
+ * On every chunk:
+ * - cumulative stdout byte count is folded into the spinner row via
+ *   `reporter.update({ stdout: "<formatted>" })`
+ * - `reporter.raw(text)` forwards the chunk verbatim. The reporter swallows
+ *   the call unless verbosity is `verbose`, so non-verbose callers pay only
+ *   the cost of the bridge function itself (no extra stderr writes).
+ *
+ * stderr chunks are also passed to `reporter.raw()` so `--verbose` users see
+ * agent CLI warnings inline. They don't update the `stdout:` metric (that
+ * key is intentionally tied to actual stdout volume so the spinner row stays
+ * comparable across runs).
+ */
+export declare function buildAgentProgressCallback(reporter: ProgressReporter): AgentProgressCallback;
+export interface OutputSizePollHandle {
+    /** Stop the poll loop. Safe to call multiple times. */
+    stop: () => void;
+}
+export interface OutputSizePollOptions {
+    /** Path to `fs.stat`. The agent should be writing here. */
+    path: string;
+    reporter: ProgressReporter;
+    /** Poll interval in milliseconds (default 500ms per ADR-0015 D5 / #197). */
+    intervalMs?: number;
+    /**
+     * Metric key on the spinner row. Defaults to `output` so the row reads
+     * `output: 4.2 KB`. Tests override for deterministic assertions.
+     */
+    metricKey?: string;
+}
+/**
+ * Poll the agent's output file with `fs.stat` every 500ms (configurable) and
+ * push the latest size onto the spinner row.
+ *
+ * Why polling instead of `fs.watch`: `fs.watch` is platform-flaky (Linux
+ * needs inotify, macOS uses FSEvents, WSL has its own quirks) and the agent
+ * may write atomically at the end with no intermediate `change` events. A
+ * 500ms `fs.stat` poll is reliable everywhere and the cost (one syscall per
+ * tick) is negligible next to the agent CLI spawn.
+ *
+ * The poll silently ignores `ENOENT` because the agent writes the file part-
+ * way through the run; we only start showing sizes once the file exists. Any
+ * other stat error is also swallowed (best-effort UX, the reporter must
+ * never abort the actual research operation).
+ */
+export declare function pollOutputFileSize(opts: OutputSizePollOptions): OutputSizePollHandle;
+/**
+ * Convenience: return a no-op reporter typed as a {@link ProgressReporter}.
+ * Re-exported here so CLI modules don't have to import from two places.
+ */
+export { noopProgressReporter };
+//# sourceMappingURL=_progress.d.ts.map

package/dist/cli/_progress.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"_progress.d.ts","sourceRoot":"","sources":["../../src/cli/_progress.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AAChE,OAAO,EAEL,oBAAoB,EACpB,KAAK,aAAa,EAClB,KAAK,gBAAgB,EACtB,MAAM,qBAAqB,CAAC;AAE7B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AAEH,MAAM,WAAW,iBAAiB;IAChC,kDAAkD;IAClD,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,gCAAgC;IAChC,KAAK,EAAE,aAAa,CAAC;IACrB,uCAAuC;IACvC,OAAO,EAAE,OAAO,CAAC;IACjB,qCAAqC;IACrC,KAAK,EAAE,OAAO,CAAC;CAChB;AAED,qBAAa,iBAAkB,SAAQ,KAAK;gBAC9B,OAAO,EAAE,MAAM;CAI5B;AAED;;;;;;;;;GASG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,iBAAiB,CAuBpE;AAED,MAAM,WAAW,oBAAoB;IACnC,KAAK,EAAE,aAAa,CAAC;IACrB,+EAA+E;IAC/E,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,sEAAsE;IACtE,MAAM,CAAC,EAAE,MAAM,CAAC,cAAc,CAAC;CAChC;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,oBAAoB,GAAG,gBAAgB,CAM1E;AAKD;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAI7C;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,0BAA0B,CAAC,QAAQ,EAAE,gBAAgB,GAAG,qBAAqB,CAS5F;AAED,MAAM,WAAW,oBAAoB;IACnC,uDAAuD;IACvD,IAAI,EAAE,MAAM,IAAI,CAAC;CAClB;AAED,MAAM,WAAW,qBAAqB;IACpC,2DAA2D;IAC3D,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,gBAAgB,CAAC;IAC3B,4EAA4E;IAC5E,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,qBAAqB,GAAG,oBAAoB,CAgDpF;AAED;;;GAGG;AACH,OAAO,EAAE,oBAAoB,EAAE,CAAC"}

package/dist/cli/_progress.js

@@ -0,0 +1,176 @@
+import { stat } from "node:fs/promises";
+import { createProgressReporter, noopProgressReporter, } from "../core/progress.js";
+export class ProgressFlagError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = "ProgressFlagError";
+    }
+}
+/**
+ * Strip `--verbose` / `--quiet` from `argv` and return the resolved
+ * {@link ProgressLevel} plus the remaining argv for the command's own parser.
+ *
+ * Mutually exclusive: passing both raises {@link ProgressFlagError} so the
+ * caller can convert it into an exit-code-2 usage error consistent with the
+ * existing `parseArgs` style. `RADAR_NO_PROGRESS=1` is honoured at reporter
+ * construction time (see {@link buildReporter}); we do not mix env handling
+ * into argv parsing because env is global and argv is per-invocation.
+ */
+export function parseProgressFlags(argv) {
+    const rest = [];
+    let verbose = false;
+    let quiet = false;
+    for (const arg of argv) {
+        if (arg === "--verbose") {
+            verbose = true;
+            continue;
+        }
+        if (arg === "--quiet") {
+            quiet = true;
+            continue;
+        }
+        rest.push(arg);
+    }
+    if (verbose && quiet) {
+        throw new ProgressFlagError("--verbose and --quiet are mutually exclusive");
+    }
+    let level;
+    if (quiet)
+        level = "quiet";
+    else if (verbose)
+        level = "verbose";
+    else
+        level = "normal";
+    return { rest, level, verbose, quiet };
+}
+/**
+ * Construct a {@link ProgressReporter} for a CLI invocation. Thin wrapper
+ * around {@link createProgressReporter} that records the helper's existence
+ * for grep-discoverability — production callers route through here so the
+ * defaulting logic stays in one place.
+ *
+ * `level: "quiet"` and `RADAR_NO_PROGRESS=1` both produce a no-op reporter
+ * (the env check happens inside `createProgressReporter`); the CLI keeps its
+ * pre-existing 1-line `io.log("research: wrote …")` summary as the only
+ * surviving signal, satisfying the issue's acceptance criterion 8.
+ */
+export function buildReporter(opts) {
+    return createProgressReporter({
+        level: opts.level,
+        tty: opts.tty,
+        stream: opts.stream,
+    });
+}
+const KIB = 1024;
+const MIB = KIB * 1024;
+/**
+ * Render a byte count for the spinner row. Uses binary prefixes (KiB / MiB)
+ * but renders them as `KB` / `MB` for readability — the spinner is a UX
+ * affordance, not a precise meter, and the ADR-0015 D4 examples show `4.2 KB`
+ * without binary-suffix pedantry.
+ */
+export function formatBytes(n) {
+    if (n < KIB)
+        return `${n} B`;
+    if (n < MIB)
+        return `${(n / KIB).toFixed(1)} KB`;
+    return `${(n / MIB).toFixed(1)} MB`;
+}
+/**
+ * Bridge {@link AgentProgressCallback} (raw stdout / stderr chunks) to a
+ * {@link ProgressReporter}.
+ *
+ * On every chunk:
+ * - cumulative stdout byte count is folded into the spinner row via
+ *   `reporter.update({ stdout: "<formatted>" })`
+ * - `reporter.raw(text)` forwards the chunk verbatim. The reporter swallows
+ *   the call unless verbosity is `verbose`, so non-verbose callers pay only
+ *   the cost of the bridge function itself (no extra stderr writes).
+ *
+ * stderr chunks are also passed to `reporter.raw()` so `--verbose` users see
+ * agent CLI warnings inline. They don't update the `stdout:` metric (that
+ * key is intentionally tied to actual stdout volume so the spinner row stays
+ * comparable across runs).
+ */
+export function buildAgentProgressCallback(reporter) {
+    let stdoutBytes = 0;
+    return (kind, text) => {
+        if (kind === "stdout") {
+            stdoutBytes += Buffer.byteLength(text, "utf8");
+            reporter.update({ stdout: formatBytes(stdoutBytes) });
+        }
+        reporter.raw(text);
+    };
+}
+/**
+ * Poll the agent's output file with `fs.stat` every 500ms (configurable) and
+ * push the latest size onto the spinner row.
+ *
+ * Why polling instead of `fs.watch`: `fs.watch` is platform-flaky (Linux
+ * needs inotify, macOS uses FSEvents, WSL has its own quirks) and the agent
+ * may write atomically at the end with no intermediate `change` events. A
+ * 500ms `fs.stat` poll is reliable everywhere and the cost (one syscall per
+ * tick) is negligible next to the agent CLI spawn.
+ *
+ * The poll silently ignores `ENOENT` because the agent writes the file part-
+ * way through the run; we only start showing sizes once the file exists. Any
+ * other stat error is also swallowed (best-effort UX, the reporter must
+ * never abort the actual research operation).
+ */
+export function pollOutputFileSize(opts) {
+    const intervalMs = opts.intervalMs ?? 500;
+    const metricKey = opts.metricKey ?? "output";
+    let stopped = false;
+    let timer = null;
+    let lastReportedSize = -1;
+    const tick = async () => {
+        if (stopped)
+            return;
+        try {
+            const s = await stat(opts.path);
+            if (s.size !== lastReportedSize) {
+                lastReportedSize = s.size;
+                opts.reporter.update({ [metricKey]: formatBytes(s.size) });
+            }
+        }
+        catch {
+            // ENOENT during the early phase of the agent run, or transient stat
+            // failure — silently ignore so the spinner UX never crashes the real
+            // operation.
+        }
+    };
+    // First tick on next macrotask so callers can return the handle before the
+    // poll begins. setInterval also schedules; we add the immediate call so the
+    // spinner picks up an existing file without waiting a full interval.
+    const startup = setTimeout(() => {
+        if (!stopped) {
+            void tick();
+            timer = setInterval(() => {
+                void tick();
+            }, intervalMs);
+            // Don't keep the event loop alive just for the poll.
+            if (typeof timer.unref === "function") {
+                timer.unref();
+            }
+        }
+    }, 0);
+    if (typeof startup.unref === "function") {
+        startup.unref();
+    }
+    return {
+        stop() {
+            stopped = true;
+            clearTimeout(startup);
+            if (timer) {
+                clearInterval(timer);
+                timer = null;
+            }
+        },
+    };
+}
+/**
+ * Convenience: return a no-op reporter typed as a {@link ProgressReporter}.
+ * Re-exported here so CLI modules don't have to import from two places.
+ */
+export { noopProgressReporter };
+//# sourceMappingURL=_progress.js.map

package/dist/cli/_progress.js.map

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

package/dist/cli/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":"AAYA,MAAM,WAAW,OAAO;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,GAAG,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;CAC1C;AAoCD,wBAAsB,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAoBvD"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":"AAaA,MAAM,WAAW,OAAO;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,GAAG,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;CAC1C;AAqCD,wBAAsB,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAoBvD"}

package/dist/cli/index.js

@@ -9,6 +9,7 @@ import { reviewCommand } from "./review.js";
 import { sourceCommand } from "./source.js";
 import { updateCommand } from "./update.js";
 import { watchCommand } from "./watch.js";
+import { workflowCommand } from "./workflow.js";
 const commands = [
     initCommand,
     sourceCommand,
@@ -18,6 +19,7 @@ const commands = [
     reviewCommand,
     updateCommand,
     doctorCommand,
+    workflowCommand,
 ];
 // Read the installed package's version at runtime so `radar --version`
 // tracks release-please bumps without a parallel source edit. The bin

package/dist/cli/index.js.map

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

package/dist/cli/research.d.ts

@@ -1,4 +1,15 @@
+import type { ProgressReporter } from "../core/progress.js";
 import type { Command } from "./index.js";
+/**
+ * Default hard-cap for `radar research --batch`.
+ *
+ * ADR-0014 D3a pins the default to 10: 2-10x the empirical detection rate
+ * (1-5 items per cron tick) while keeping LLM cost-per-tick bounded
+ * (~$0.01/item * 10 ~= $0.1). Generated workflow YAML embeds this same
+ * literal via `combined.template.yaml`, but the CLI re-enforces it so the
+ * cap also applies when the YAML is hand-edited.
+ */
+export declare const RESEARCH_BATCH_DEFAULT_MAX_ITEMS = 10;
 /** Sinks for the research command's user-facing output. Tests inject capturing sinks. */
 export interface ResearchIO {
     log?: (message: string) => void;
@@ -8,27 +19,14 @@ export interface ResearchIO {
 export interface ResearchCommandOptions {
     cwd?: string;
     io?: ResearchIO;
+    /**
+     * Test-only override for the {@link ProgressReporter}. When omitted, the
+     * CLI constructs one from `--verbose` / `--quiet` / `RADAR_NO_PROGRESS`
+     * and the TTY auto-detection table (ADR-0015 D2). Tests pin a no-op or a
+     * capturing reporter so assertions are deterministic.
+     */
+    progress?: ProgressReporter;
 }
-/**
- * Implementation of `radar research <item-id>` (single-item) and
- * `radar research --digest <id1> <id2> ...` (multi-item digest, ADR-0011).
- *
- * High-level flow (Phase 1):
- *   1. Parse + validate args (agent defaults to `claude-code`, template to
- *      `default` for single-item or `digest` for `--digest`).
- *   2. Locate `items/<sourceId>/<item-id>.yaml` for each id and parse it.
- *   3. Load `templates/<template-id>.md` (empty body when default is absent).
- *   4. Compute the output path:
- *        - single-item: `research/<YYYYMMDD>_<slug>_v1.md` (ADR-0003)
- *        - digest:      `research/<YYYYMMDD>_digest_<slug>_v1.md` (ADR-0011)
- *      Refuse to overwrite an existing file — re-runs go through `update`.
- *   5. Invoke the registered agent adapter; the agent writes the report.
- *   6. Validate the report's frontmatter against `ResearchFrontmatterSchema`.
- *   7. Transition every included item: `status` → `researched` and persist.
- *
- * Any step from 4 onward that fails surfaces a non-zero exit code with a
- * targeted message so the user can debug without re-reading the source.
- */
 export declare function runResearch(args: string[], options?: ResearchCommandOptions): Promise<number>;
 export declare const researchCommand: Command;
 //# sourceMappingURL=research.d.ts.map

package/dist/cli/research.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"research.d.ts","sourceRoot":"","sources":["../../src/cli/research.ts"],"names":[],"mappings":"AA4BA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAE1C,yFAAyF;AACzF,MAAM,WAAW,UAAU;IACzB,GAAG,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IAChC,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IACjC,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;CACnC;AAED,MAAM,WAAW,sBAAsB;IACrC,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,EAAE,CAAC,EAAE,UAAU,CAAC;CACjB;AAyND;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAsB,WAAW,CAC/B,IAAI,EAAE,MAAM,EAAE,EACd,OAAO,GAAE,sBAA2B,GACnC,OAAO,CAAC,MAAM,CAAC,CAiQjB;AAED,eAAO,MAAM,eAAe,EAAE,OAI7B,CAAC"}
+{"version":3,"file":"research.d.ts","sourceRoot":"","sources":["../../src/cli/research.ts"],"names":[],"mappings":"AAwBA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAY5D,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAE1C;;;;;;;;GAQG;AACH,eAAO,MAAM,gCAAgC,KAAK,CAAC;AAEnD,yFAAyF;AACzF,MAAM,WAAW,UAAU;IACzB,GAAG,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IAChC,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IACjC,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;CACnC;AAED,MAAM,WAAW,sBAAsB;IACrC,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,EAAE,CAAC,EAAE,UAAU,CAAC;IAChB;;;;;OAKG;IACH,QAAQ,CAAC,EAAE,gBAAgB,CAAC;CAC7B;AA4hBD,wBAAsB,WAAW,CAC/B,IAAI,EAAE,MAAM,EAAE,EACd,OAAO,GAAE,sBAA2B,GACnC,OAAO,CAAC,MAAM,CAAC,CAyHjB;AAED,eAAO,MAAM,eAAe,EAAE,OAI7B,CAAC"}