nodedex 0.1.0

package/dist/middleware/reflect/describe-roots.js

@@ -0,0 +1,266 @@
+// ═══════════════════════════════════════════════════════════════════════════════
+// Recognition Layer — STEP 1: THE DESCRIBER (root description maintainer)
+// ═══════════════════════════════════════════════════════════════════════════════
+//
+// Design: docs/PIPELINE-RECOGNITION-LAYER-DESIGN.md §3 + §6.
+//
+// JOB: give every project ROOT a SURFACE description — "what this project is
+// about" = DOMAIN + OWNER, one line, signpost-not-textbook. This is the FUEL the
+// recognizer (step 2, not built yet) compares new knowledge against. The
+// recognizer only READS descriptions; the DESCRIBER is the sole maintainer
+// (Rule 5 producer split — the only other writer is the create-path's initial
+// essence). The recognizer NEVER writes descriptions.
+//
+// WHY a separate async worker (NOT folded into Stage AUDIT): AUDIT's contract is
+// "no LLM, no mutate — flag only" (stage-audit-graph.ts). The describer DOES
+// call the LLM and DOES write the root's essence, so it mirrors the flag-REVIEWER
+// pattern (async LLM worker that mutates), not AUDIT. Default OFF
+// (NODEDEX_DESCRIBER_ENABLED=on) so upgrading never silently starts LLM spend.
+//
+// LAZY (cost): only (re)describe a root when it's worth it — never described, OR
+// grew by >= growthThreshold members since the last describe (tracked via
+// content.last_described_member_count). Bounded per tick (maxRootsPerTick).
+//
+// Meaning-first: the description is the root's SCOPE identity (domain + owner) —
+// NOT the leaf unique{} CLAIM identity. Surface only: the members ARE the
+// contents; the description is a signpost, it does not enumerate them.
+import { intFromEnv } from "./config.js";
+import { getLLMProvider } from "../../engine/providers/index.js";
+import { budgetTripped } from "./cost-guard.js";
+// ─── Config (env-controlled; all have safe defaults) ────────────────────────────
+function describerEnabled() {
+    // Default ON (agent-facing root signposts — locked-on per release decision); set =off for dev/test.
+    return (process.env.NODEDEX_DESCRIBER_ENABLED ?? "").toLowerCase() !== "off";
+}
+function describerIntervalMs() {
+    return intFromEnv("NODEDEX_DESCRIBER_INTERVAL_MS", 1_800_000); // 30 min (slow background)
+}
+function minMembers() {
+    return intFromEnv("NODEDEX_DESCRIBER_MIN_MEMBERS", 2); // a 1-member root has no real "domain" yet
+}
+function growthThreshold() {
+    return intFromEnv("NODEDEX_DESCRIBER_GROWTH", 5); // re-describe after +5 members
+}
+function maxRootsPerTick() {
+    return intFromEnv("NODEDEX_DESCRIBER_MAX_PER_TICK", 3); // bound LLM calls per tick
+}
+function maxMembersInPrompt() {
+    return intFromEnv("NODEDEX_DESCRIBER_MAX_MEMBERS_IN_PROMPT", 40); // bound input tokens
+}
+/** Returns the reason a root needs (re)describing, or false. Pure. */
+export function rootNeedsDescription(inp, opts) {
+    if (inp.memberCount < opts.minMembers)
+        return false;
+    if (inp.lastDescribedCount === null)
+        return "never";
+    if (inp.memberCount - inp.lastDescribedCount >= opts.growthThreshold)
+        return "grew";
+    return false;
+}
+export function selectRootsNeedingDescription(inputs, opts) {
+    const out = [];
+    for (const inp of inputs) {
+        const r = rootNeedsDescription(inp, opts);
+        if (r)
+            out.push({ ...inp, reason: r });
+    }
+    return out;
+}
+// ─── Prompt + schema ────────────────────────────────────────────────────────────
+export const DESCRIBE_ROOT_PROMPT = `You are writing a one-line SURFACE description of a project root in a knowledge graph.
+Its ONLY job: let a later step decide "does a new piece of knowledge belong in THIS project?"
+
+Capture TWO things in one line:
+  1. DOMAIN — what this project is about (the topic).
+  2. OWNER / SCOPE — whose it is (a client/customer name, a system name, or "personal")
+     IF the members reveal one. Omit only if genuinely unknown.
+
+RULES:
+  - SIGNPOST, not table-of-contents. Do NOT list the individual members/decisions/facts.
+  - Surface only. ONE line, <= 140 characters.
+  - Base it ONLY on the MEMBERS shown. Never invent a domain or owner the members don't evidence.
+  - Plain language. No label syntax, no underscores.`;
+const DESCRIBE_ROOT_SCHEMA = {
+    type: "object",
+    properties: { description: { type: "string" } },
+    required: ["description"],
+};
+export function buildDescribeInput(root, members, cap) {
+    const head = `PROJECT ROOT label: ${root.label}\n` +
+        `Current description (may be stale/generic): "${root.essence ?? ""}"\n\n` +
+        `MEMBERS (${members.length} total${members.length > cap ? `, showing ${cap}` : ""}):`;
+    const lines = members.slice(0, cap).map((m) => {
+        let concepts = [];
+        try {
+            const p = JSON.parse(m.concepts ?? "[]");
+            if (Array.isArray(p))
+                concepts = p;
+        }
+        catch { /* tolerate */ }
+        const c = concepts.length ? ` (${concepts.slice(0, 6).join(", ")})` : "";
+        return `- [${m.type}] ${m.essence ?? ""}${c}`;
+    });
+    return `${head}\n${lines.join("\n")}`;
+}
+// ─── LLM describe (one root) ────────────────────────────────────────────────────
+export async function describeRoot(provider, root, members) {
+    const userInput = buildDescribeInput(root, members, maxMembersInPrompt());
+    const r = await provider.generateStructured(DESCRIBE_ROOT_PROMPT, userInput, DESCRIBE_ROOT_SCHEMA, { thinkingBudget: 512, maxOutputTokens: 512 });
+    const desc = r.result?.description?.trim();
+    return {
+        description: desc && desc.length > 0 ? desc : null,
+        rateLimited: r.rateLimited,
+        usage: r.usage,
+    };
+}
+/**
+ * One describer tick: find roots needing a (re)description, describe up to
+ * `limit` of them, write essence + the lazy marker. Async (LLM). Bounded.
+ */
+export async function runDescriberTick(opts) {
+    const t0 = Date.now();
+    const result = {
+        roots_total: 0, roots_needing: 0, described: 0,
+        llm_calls: 0, rate_limited: 0, errors: 0, wall_ms: 0,
+    };
+    const limit = opts.limit ?? maxRootsPerTick();
+    let all;
+    try {
+        all = opts.db.getAllBlocks();
+    }
+    catch (e) {
+        result.errors += 1;
+        result.wall_ms = Date.now() - t0;
+        console.warn(`[describer] getAllBlocks threw: ${e?.message ?? e}`);
+        return result;
+    }
+    const roots = all.filter((b) => b.type === "project");
+    result.roots_total = roots.length;
+    // members grouped by their project_id (one pass)
+    const membersByRoot = new Map();
+    for (const b of all) {
+        if (b.type === "project")
+            continue;
+        const pid = b.project_id;
+        if (!pid)
+            continue;
+        let arr = membersByRoot.get(pid);
+        if (!arr) {
+            arr = [];
+            membersByRoot.set(pid, arr);
+        }
+        arr.push(b);
+    }
+    const inputs = roots.map((root) => {
+        let lastDescribedCount = null;
+        try {
+            const c = JSON.parse(root.content ?? "{}");
+            const v = c?.last_described_member_count;
+            if (typeof v === "number" && Number.isFinite(v))
+                lastDescribedCount = v;
+        }
+        catch { /* tolerate */ }
+        return { root, memberCount: membersByRoot.get(root.id)?.length ?? 0, lastDescribedCount };
+    });
+    const candidates = selectRootsNeedingDescription(inputs, {
+        minMembers: minMembers(),
+        growthThreshold: growthThreshold(),
+    });
+    result.roots_needing = candidates.length;
+    for (const cand of candidates.slice(0, limit)) {
+        const members = membersByRoot.get(cand.root.id) ?? [];
+        if (members.length === 0)
+            continue; // defensive (selection gates on minMembers>=1)
+        try {
+            result.llm_calls += 1;
+            const { description, rateLimited } = await describeRoot(opts.provider, cand.root, members);
+            if (rateLimited) {
+                result.rate_limited += 1;
+                continue;
+            }
+            if (!description)
+                continue;
+            // Merge the lazy marker into existing content; write essence + enriched_at.
+            let content = {};
+            try {
+                const c = JSON.parse(cand.root.content ?? "{}");
+                if (c && typeof c === "object")
+                    content = c;
+            }
+            catch { /* tolerate */ }
+            content.last_described_member_count = cand.memberCount;
+            opts.db.updateBlock(cand.root.id, { essence: description, content, enriched_at: new Date().toISOString() }, `describer: ${cand.reason} (members=${cand.memberCount})`, "describer");
+            result.described += 1;
+        }
+        catch (e) {
+            result.errors += 1;
+            console.warn(`[describer] root ${cand.root.label} threw: ${e?.message ?? e}`);
+        }
+    }
+    result.wall_ms = Date.now() - t0;
+    return result;
+}
+// ─── Timer wrapper (env-gated, default OFF — mirrors flag-reviewer-startup) ──────
+let _handle = null;
+let _inFlight = false;
+async function tick(db) {
+    if (_inFlight) {
+        console.log("[describer] tick still running, skipping this interval");
+        return;
+    }
+    _inFlight = true;
+    try {
+        // Cost breaker (production gap 2, Phase B): self-gate before spending.
+        const budget = await budgetTripped();
+        if (budget?.tripped) {
+            console.warn(`[describer] tick skipped — cost breaker: ${budget.reason}`);
+            return;
+        }
+        const provider = getLLMProvider();
+        if (!provider.isAvailable()) {
+            console.warn("[describer] provider unavailable — skipping tick");
+            return;
+        }
+        const res = await runDescriberTick({ db, provider });
+        if (res.described > 0 || res.errors > 0 || res.rate_limited > 0) {
+            console.log(`[describer] tick: roots=${res.roots_total} needing=${res.roots_needing} ` +
+                `described=${res.described} llm=${res.llm_calls} rate_limited=${res.rate_limited} ` +
+                `errors=${res.errors} wall_ms=${res.wall_ms}`);
+        }
+    }
+    catch (e) {
+        console.warn(`[describer] tick threw: ${e?.message ?? e}`);
+    }
+    finally {
+        _inFlight = false;
+    }
+}
+/** Start the describer timer. Idempotent; returns true if started. Default OFF. */
+export function startDescriberTimer(db) {
+    if (!describerEnabled()) {
+        console.log("[describer] disabled (set NODEDEX_DESCRIBER_ENABLED=on to enable)");
+        return false;
+    }
+    if (_handle !== null)
+        return false;
+    const intervalMs = describerIntervalMs();
+    console.log(`[describer] starting: interval=${intervalMs}ms`);
+    _handle = setInterval(() => {
+        tick(db).catch((e) => console.warn(`[describer] interval tick rejected: ${e?.message ?? e}`));
+    }, intervalMs);
+    if (typeof _handle.unref === "function")
+        _handle.unref();
+    return true;
+}
+/** Stop the describer timer. Used on shutdown + by tests. */
+export function stopDescriberTimer() {
+    if (_handle !== null) {
+        clearInterval(_handle);
+        _handle = null;
+    }
+}
+/** For tests only — reports whether the timer is currently running. */
+export function _isDescriberTimerRunningForTests() {
+    return _handle !== null;
+}
+//# sourceMappingURL=describe-roots.js.map

package/dist/middleware/reflect/describe-roots.js.map

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

package/dist/middleware/reflect/flag-reviewer-startup.d.ts

@@ -0,0 +1,16 @@
+import type { WorkspaceDB } from "../../store/database.js";
+/**
+ * Start the flag-reviewer interval timer. Idempotent — calling twice after
+ * the first call is a no-op. Returns true if the timer started, false if
+ * disabled or already running.
+ */
+export declare function startFlagReviewer(db: WorkspaceDB): boolean;
+/**
+ * Stop the flag-reviewer interval timer. Used on shutdown + by tests.
+ */
+export declare function stopFlagReviewer(): void;
+/**
+ * For tests only — reports whether the timer is currently running.
+ */
+export declare function _isFlagReviewerRunningForTests(): boolean;
+//# sourceMappingURL=flag-reviewer-startup.d.ts.map

package/dist/middleware/reflect/flag-reviewer-startup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"flag-reviewer-startup.d.ts","sourceRoot":"","sources":["../../../src/middleware/reflect/flag-reviewer-startup.ts"],"names":[],"mappings":"AAkBA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAuD3D;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,EAAE,EAAE,WAAW,GAAG,OAAO,CAmB1D;AAED;;GAEG;AACH,wBAAgB,gBAAgB,IAAI,IAAI,CAKvC;AAED;;GAEG;AACH,wBAAgB,8BAA8B,IAAI,OAAO,CAExD"}

package/dist/middleware/reflect/flag-reviewer-startup.js

@@ -0,0 +1,107 @@
+// ═══════════════════════════════════════════════════════════════════════════════
+// DEBT 5 Slice 2 Sub-step 2.2 — FLAG REVIEWER STARTUP / WORKER WRAPPER
+// ═══════════════════════════════════════════════════════════════════════════════
+//
+// Env-gated setInterval wrapper around runFlagReviewerTick (flag-reviewer.ts).
+// Pattern reference: arc-inactivity-timer.ts — same shape (singleton handle,
+// in-flight guard, unref so tests/shutdown aren't blocked, idempotent start/
+// stop, test inspector).
+//
+// Worker runs ONLY when NODEDEX_FLAG_REVIEWER_ENABLED=on. Default off so
+// upgrading does not silently start LLM spend.
+//
+// Per-tick policy:
+//   - One tick at a time (in-flight guard) — if a tick is still running
+//     when next interval fires, skip and log.
+//   - Tick errors do NOT crash the process (try/catch around runReviewerTick).
+//   - Each tick logs reviewed-count / verdicts / cost.
+import { getLLMProvider } from "../../engine/providers/index.js";
+import { runFlagReviewerTick } from "./flag-reviewer.js";
+import { budgetTripped } from "./cost-guard.js";
+import { intFromEnv } from "./config.js";
+let _intervalHandle = null;
+let _inFlight = false;
+function flagReviewerEnabled() {
+    // Default ON (self-cleaning loop locked-on — validated 2026-06-20); set =off for dev/test.
+    return (process.env.NODEDEX_FLAG_REVIEWER_ENABLED ?? "").toLowerCase() !== "off";
+}
+function getIntervalMs() {
+    return intFromEnv("NODEDEX_FLAG_REVIEWER_INTERVAL_MS", 300_000); // default 5 min
+}
+async function tick(db) {
+    if (_inFlight) {
+        console.log("[flag-reviewer] tick still running, skipping this interval");
+        return;
+    }
+    _inFlight = true;
+    try {
+        // Cost breaker (production gap 2, Phase B): this autonomous worker self-gates
+        // on the budget before spending. No-op when no budget is configured.
+        const budget = await budgetTripped();
+        if (budget?.tripped) {
+            console.warn(`[flag-reviewer] tick skipped — cost breaker: ${budget.reason}`);
+            return;
+        }
+        const provider = getLLMProvider();
+        if (!provider.isAvailable()) {
+            console.warn("[flag-reviewer] provider unavailable — skipping tick");
+            return;
+        }
+        const result = await runFlagReviewerTick({ db, provider });
+        if (result.reviewed === 0 && result.errors === 0) {
+            // Quiet skip — common case (no pending flags). Don't spam the log.
+            return;
+        }
+        const costStr = result.cost_usd === null ? "?" : `$${result.cost_usd.toFixed(4)}`;
+        console.log(`[flag-reviewer] tick: reviewed=${result.reviewed} ` +
+            `verdicts={merge:${result.verdicts.merge}, leave:${result.verdicts.leave}, split:${result.verdicts.split}} ` +
+            `actions=${result.actions_executed} routed=${result.routed_to_agent} errors=${result.errors} cost=${costStr}`);
+    }
+    catch (e) {
+        console.warn(`[flag-reviewer] tick threw: ${e?.message ?? e}`);
+    }
+    finally {
+        _inFlight = false;
+    }
+}
+/**
+ * Start the flag-reviewer interval timer. Idempotent — calling twice after
+ * the first call is a no-op. Returns true if the timer started, false if
+ * disabled or already running.
+ */
+export function startFlagReviewer(db) {
+    if (!flagReviewerEnabled()) {
+        console.log("[flag-reviewer] disabled (set NODEDEX_FLAG_REVIEWER_ENABLED=on to enable)");
+        return false;
+    }
+    if (_intervalHandle !== null)
+        return false;
+    const intervalMs = getIntervalMs();
+    // Default ON (validated: clear-case auto-merge is correct + recoverable; weak evidence is routed, not merged); set =off for dev/test.
+    const autoMerge = (process.env.NODEDEX_FLAG_AUTO_MERGE ?? "on").toLowerCase() !== "off";
+    console.log(`[flag-reviewer] starting: interval=${intervalMs}ms auto_merge=${autoMerge ? "ON (Level 2)" : "OFF (Level 1 verdict-only)"}`);
+    _intervalHandle = setInterval(() => {
+        tick(db).catch((e) => {
+            console.warn(`[flag-reviewer] interval-fired tick rejected: ${e?.message ?? e}`);
+        });
+    }, intervalMs);
+    if (typeof _intervalHandle.unref === "function")
+        _intervalHandle.unref();
+    return true;
+}
+/**
+ * Stop the flag-reviewer interval timer. Used on shutdown + by tests.
+ */
+export function stopFlagReviewer() {
+    if (_intervalHandle !== null) {
+        clearInterval(_intervalHandle);
+        _intervalHandle = null;
+    }
+}
+/**
+ * For tests only — reports whether the timer is currently running.
+ */
+export function _isFlagReviewerRunningForTests() {
+    return _intervalHandle !== null;
+}
+//# sourceMappingURL=flag-reviewer-startup.js.map

package/dist/middleware/reflect/flag-reviewer-startup.js.map

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

package/dist/middleware/reflect/flag-reviewer.d.ts

@@ -0,0 +1,69 @@
+import type Database from "better-sqlite3";
+import type { WorkspaceDB } from "../../store/database.js";
+import type { LLMProvider } from "../../engine/ai-provider.js";
+import type { PipelineFlag, ReviewerContext, ReviewerVerdictOutput, BlockReviewSnapshot, FlagReviewerTickResult } from "./types.js";
+/** Load a BlockReviewSnapshot from the blocks table. Returns null if the block
+ *  was archived/deleted between flag-write and reviewer-tick (we don't
+ *  re-resurrect — the flag becomes stale, reviewer skips it).  */
+export declare function loadBlockSnapshot(db: Database.Database, blockId: string): BlockReviewSnapshot | null;
+/** Walk part_of relations up to the project root. Returns the chain of LABELS
+ *  from root → block. Bounded depth (default 8) — graph cycles or pathological
+ *  depths return whatever we walked.  */
+export declare function loadScopeChain(db: Database.Database, blockId: string, maxDepth?: number): string[];
+export declare function buildReviewerContext(db: Database.Database, flag: PipelineFlag): ReviewerContext | null;
+export declare function buildReviewerInput(ctx: ReviewerContext): string;
+export declare function callReviewerLLM(provider: LLMProvider, ctx: ReviewerContext): Promise<{
+    result: ReviewerVerdictOutput | null;
+    model?: string;
+    rateLimited: boolean;
+}>;
+/**
+ * Execute a merge verdict — wire supersedes (winner → loser) AND archive the
+ * loser so the duplicate actually collapses.
+ *
+ * ⚠ DESIGN NOTE — relaxes the "facts permanent on supersede" rule for the
+ * confirmed-duplicate-merge case (surfaced to user 2026-05-31):
+ *
+ * database.ts:1192-1199 auto-archives a supersede TARGET only when it's a
+ * 'blueprint' or 'decision' — facts/constraints/dead_ends/questions are
+ * treated as permanent historical records (a contradicted fact stays visible).
+ * That rule is correct for GENERIC supersede ("B replaces A's claim; both are
+ * history"). It is WRONG for a reviewer-confirmed DUPLICATE, which is a
+ * different operation: "A and B are the SAME thing captured twice — collapse
+ * to one." A duplicate fact is not two historical records; keeping both is
+ * noise, not history. Slice 1's atomic_dup_candidate is PRECISELY duplicate
+ * facts (same source_excerpt + same primary_value), so relying on the
+ * type-conditional supersede-archive would leave every confirmed fact-dup
+ * un-merged.
+ *
+ * Therefore executeMerge archives the loser DIRECTLY (db.archiveBlock) instead
+ * of relying on the supersede side-effect. Charter Rule 2 honored: archive
+ * (recoverable via /api/blocks), never delete. Containment: this only runs at
+ * Level 2 (NODEDEX_FLAG_AUTO_MERGE=on, default OFF) on a high-confidence
+ * reviewer 'merge' verdict — both opt-in gates.
+ *
+ * Returns the action_taken value to write to the flag row.
+ */
+export declare function executeMerge(db: WorkspaceDB, winnerBlockId: string, loserBlockId: string): 'archived_loser_and_wired_superseded_by' | 'none';
+export interface RunReviewerTickOpts {
+    db: WorkspaceDB;
+    provider: LLMProvider;
+    /** Override the env-controlled auto-merge gate (used by REST manual-review
+     *  endpoint, which passes execute=true explicitly).  */
+    forceAutoMerge?: boolean;
+}
+/**
+ * One reviewer tick: read up to N pending flags, review each, write verdicts.
+ * Returns per-tick result for telemetry + log.
+ *
+ * This is the SINGLE PUBLIC entry point — flag-reviewer-startup.ts wraps it
+ * in setInterval, REST /api/flags/:id/review (Sub-step 2.4) can also invoke
+ * it synchronously for a specific flag (via filtered getPendingFlags +
+ * forceAutoMerge from request body).
+ *
+ * Per-flag failure is contained: errors increment the counter and the flag
+ * stays unreviewed (next tick picks it up). One bad flag does NOT crash the
+ * whole tick.
+ */
+export declare function runFlagReviewerTick(opts: RunReviewerTickOpts): Promise<FlagReviewerTickResult>;
+//# sourceMappingURL=flag-reviewer.d.ts.map

package/dist/middleware/reflect/flag-reviewer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"flag-reviewer.d.ts","sourceRoot":"","sources":["../../../src/middleware/reflect/flag-reviewer.ts"],"names":[],"mappings":"AAqCA,OAAO,KAAK,QAAQ,MAAM,gBAAgB,CAAC;AAC3C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAC;AAC/D,OAAO,KAAK,EACV,YAAY,EACZ,eAAe,EACf,qBAAqB,EACrB,mBAAmB,EACnB,sBAAsB,EAEvB,MAAM,YAAY,CAAC;AAsFpB;;kEAEkE;AAClE,wBAAgB,iBAAiB,CAC/B,EAAE,EAAE,QAAQ,CAAC,QAAQ,EACrB,OAAO,EAAE,MAAM,GACd,mBAAmB,GAAG,IAAI,CAmC5B;AAED;;yCAEyC;AACzC,wBAAgB,cAAc,CAC5B,EAAE,EAAE,QAAQ,CAAC,QAAQ,EACrB,OAAO,EAAE,MAAM,EACf,QAAQ,SAAI,GACX,MAAM,EAAE,CAiBV;AAED,wBAAgB,oBAAoB,CAClC,EAAE,EAAE,QAAQ,CAAC,QAAQ,EACrB,IAAI,EAAE,YAAY,GACjB,eAAe,GAAG,IAAI,CAgBxB;AAmBD,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,eAAe,GAAG,MAAM,CAgB/D;AAED,wBAAsB,eAAe,CACnC,QAAQ,EAAE,WAAW,EACrB,GAAG,EAAE,eAAe,GACnB,OAAO,CAAC;IAAE,MAAM,EAAE,qBAAqB,GAAG,IAAI,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,OAAO,CAAA;CAAE,CAAC,CAqBzF;AAID;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,wBAAgB,YAAY,CAC1B,EAAE,EAAE,WAAW,EACf,aAAa,EAAE,MAAM,EACrB,YAAY,EAAE,MAAM,GACnB,wCAAwC,GAAG,MAAM,CA2DnD;AAID,MAAM,WAAW,mBAAmB;IAClC,EAAE,EAAE,WAAW,CAAC;IAChB,QAAQ,EAAE,WAAW,CAAC;IACtB;4DACwD;IACxD,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B;AAED;;;;;;;;;;;;GAYG;AACH,wBAAsB,mBAAmB,CACvC,IAAI,EAAE,mBAAmB,GACxB,OAAO,CAAC,sBAAsB,CAAC,CAgKjC"}