@openrig/cli 0.4.8 → 0.5.1

package/node_modules/@openrig/daemon/dist/domain/spec-library-workflow-scanner.d.ts

@@ -0,0 +1,140 @@
+import type Database from "better-sqlite3";
+import type { WorkflowExitKind, WorkflowAgentHarness, WorkflowGateSpec } from "./workflow-types.js";
+import type { WorkflowSpecCache } from "./workflow-spec-cache.js";
+import type { EventBus } from "./event-bus.js";
+export interface SpecLibraryWorkflowEntry {
+    id: string;
+    kind: "workflow";
+    name: string;
+    version: string;
+    /** "builtin" when source_path is under workflowBuiltinSpecsDir; else "user_file". */
+    sourceType: "builtin" | "user_file";
+    sourcePath: string;
+    relativePath: string;
+    updatedAt: string;
+    summary?: string;
+    /** True iff sourcePath is under the daemon's bundled built-in dir. */
+    isBuiltIn: boolean;
+    /** Cheap counts surfaced in the row summary line. */
+    rolesCount: number;
+    stepsCount: number;
+    terminalTurnRule: string;
+    targetRig: string | null;
+    /**
+     * Slice 11 (workflow-spec-folder-discovery) — diagnostic state.
+     * "valid" rows have parsed payload and are operable.
+     * "error" rows came from a malformed YAML in the workflows folder
+     * scan; Library UI renders them with error styling and surfaces
+     * the errorMessage so the operator can fix the file in place.
+     */
+    status: "valid" | "error";
+    /** Populated only when status === "error" — concrete parse/validate diagnostic. */
+    errorMessage: string | null;
+}
+export interface SpecLibraryWorkflowReview {
+    kind: "workflow";
+    name: string;
+    version: string;
+    purpose: string | null;
+    targetRig: string | null;
+    terminalTurnRule: string;
+    rolesCount: number;
+    stepsCount: number;
+    isBuiltIn: boolean;
+    sourcePath: string;
+    cachedAt: string;
+    /** Topology graph projection: nodes from `roles`, edges derived from
+     *  each step's next_hop.suggested_roles → next-step ids. Same shape
+     *  Slice Story View v1 uses for its Topology tab — consumers reuse
+     *  the same UI primitives for rendering.
+     *
+     *  OPR.0.4.6.WF4 Q1 (arch-ruled): the projection ADDS branch edges
+     *  from `next_hop.on` (routingType 'branch' + the triggering exit),
+     *  corrects the false-terminal defect (a step with on-targets is not
+     *  terminal), and projects optional harness/host/gate node fields —
+     *  all byte-identity-by-omission: a suggested-roles-only spec with no
+     *  on/harness/host/gate projects EXACTLY as before (no 'branch' edge,
+     *  no branchOn key, no optional node key). */
+    topology: {
+        nodes: Array<{
+            stepId: string;
+            role: string;
+            objective: string | null;
+            preferredTarget: string | null;
+            isEntry: boolean;
+            isTerminal: boolean;
+            /** OPR.0.4.6.WF4 Q1-P1 — OMITTED when the step declares none. */
+            harness?: WorkflowAgentHarness;
+            host?: string;
+            gate?: WorkflowGateSpec;
+        }>;
+        edges: Array<{
+            fromStepId: string;
+            toStepId: string;
+            /** OPR.0.4.6.WF4 Q1-P2 — closed-vocabulary extension of 'direct'. */
+            routingType: "direct" | "branch";
+            /** The triggering exit; present on 'branch' edges ONLY. */
+            branchOn?: WorkflowExitKind;
+        }>;
+    };
+    /** Per-step list rendered below the graph. */
+    steps: Array<{
+        stepId: string;
+        role: string;
+        objective: string | null;
+        allowedExits: string[];
+        /** Resolved destinations from next_hop.suggested_roles → step ids. */
+        allowedNextSteps: Array<{
+            stepId: string;
+            role: string;
+        }>;
+    }>;
+}
+export interface ScanWorkflowSpecsOpts {
+    db: Database.Database;
+    /** Absolute path to the daemon's bundled builtin starter dir;
+     *  null/undefined → no isBuiltIn detection (all rows render as user_file). */
+    workflowBuiltinSpecsDir: string | null;
+}
+export declare function scanWorkflowSpecs(opts: ScanWorkflowSpecsOpts): SpecLibraryWorkflowEntry[];
+export declare function getWorkflowReview(opts: ScanWorkflowSpecsOpts & {
+    name: string;
+    version: string;
+}): SpecLibraryWorkflowReview | null;
+export declare function workflowLibraryId(name: string, version: string): string;
+export declare function parseWorkflowLibraryId(id: string): {
+    name: string;
+    version: string;
+} | null;
+export interface ScanWorkflowSpecFolderOpts {
+    /** SQLite handle (used for direct lookups). */
+    db: Database.Database;
+    /** Cache handle for readThrough / writeDiagnostic / removeBySourcePath. */
+    cache: WorkflowSpecCache;
+    /** Absolute path to the workspace's workflows folder
+     *  (typically `<workspace.specs_root>/workflows`). Missing folder
+     *  → empty scan summary; not an error. */
+    folder: string;
+    /** Daemon's bundled builtin starter dir; used to skip removal logic
+     *  for built-in rows (the scanner only owns the folder it walks). */
+    builtinDir: string | null;
+    /** Optional EventBus — when wired, the scanner emits a
+     *  workflow_spec.removed audit event for each cache row removed because
+     *  its source file disappeared (OQ-4 acceptance: deletion + audit log).
+     *  Omitted in unit tests that don't care about emission. */
+    eventBus?: EventBus;
+}
+export interface ScanWorkflowSpecFolderResult {
+    /** Total YAML/YML files found in folder. */
+    scanned: number;
+    /** Files parsed + cached successfully on this scan. */
+    valid: number;
+    /** Files that failed parse/validate; recorded as diagnostic rows. */
+    errors: number;
+    /** Cache rows removed because their source_path no longer exists. */
+    removed: number;
+    /** Files skipped via mtime check (unchanged since last scan). */
+    skipped: number;
+}
+export declare function scanWorkflowSpecFolder(opts: ScanWorkflowSpecFolderOpts): ScanWorkflowSpecFolderResult;
+//# sourceMappingURL=spec-library-workflow-scanner.d.ts.map

package/node_modules/@openrig/daemon/dist/domain/spec-library-workflow-scanner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spec-library-workflow-scanner.d.ts","sourceRoot":"","sources":["../../src/domain/spec-library-workflow-scanner.ts"],"names":[],"mappings":"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"}

package/node_modules/@openrig/daemon/dist/domain/spec-library-workflow-scanner.js

@@ -0,0 +1,347 @@
+// Workflows in Spec Library + Activation Lens v0 — workflow scanner.
+//
+// SpecLibraryService knows how to classify rig + agent YAML files. This
+// scanner adds workflow_specs as a third library kind by reading
+// directly from the workflow_specs SQLite cache (PL-004 Phase D) +
+// re-parsing each cached row to extract the per-step routing for the
+// review payload's topology graph.
+//
+// The cache is the single source of truth for which workflow_specs the
+// daemon has seen — both built-in starters (seeded at startup by
+// loadStarterWorkflowSpecs) and
+// operator-authored specs at workspace paths that the workspace-
+// surface reconciliation contract has read through. Reading from the
+// cache (rather than re-walking directories) means: no new env config,
+// no duplicate parse logic, and the scanner stays consistent with
+// `rig workflow specs` (same rows, same source-of-truth).
+//
+// Built-in detection: a row's `source_path` is "built in" iff it falls
+// under the daemon's workflowBuiltinSpecsDir (the same `path.sep`
+// boundary check used by /api/workflow/specs).
+import * as path from "node:path";
+import { existsSync, readdirSync, readFileSync, statSync } from "node:fs";
+import { createHash } from "node:crypto";
+export function scanWorkflowSpecs(opts) {
+    let rows = [];
+    try {
+        rows = opts.db.prepare(`SELECT * FROM workflow_specs ORDER BY name, version`).all();
+    }
+    catch {
+        // workflow_specs table absent (test harness without the migration):
+        // empty library. Same graceful degradation as Slice Story View
+        // v0's slice indexer.
+        return [];
+    }
+    const out = [];
+    for (const row of rows) {
+        const status = row.status === "error" ? "error" : "valid";
+        const isBuiltIn = opts.workflowBuiltinSpecsDir
+            ? isUnderDir(row.source_path, opts.workflowBuiltinSpecsDir)
+            : false;
+        // Slice 11 — diagnostic rows render without parsed payload. Use the
+        // file basename as the row label (already stored in name by
+        // writeDiagnostic) and zero counts; errorMessage carries the reason.
+        if (status === "error") {
+            out.push({
+                // Diagnostic rows don't have stable name+version (version is
+                // empty when YAML couldn't be parsed); the library id falls
+                // back to source_path so the UI can route uniquely.
+                id: `workflow:error:${row.source_path}`,
+                kind: "workflow",
+                name: row.name,
+                version: row.version,
+                sourceType: isBuiltIn ? "builtin" : "user_file",
+                sourcePath: row.source_path,
+                relativePath: row.source_path,
+                updatedAt: row.cached_at,
+                summary: row.error_message ?? undefined,
+                isBuiltIn,
+                rolesCount: 0,
+                stepsCount: 0,
+                terminalTurnRule: row.coordination_terminal_turn_rule || "hot_potato",
+                targetRig: null,
+                status: "error",
+                errorMessage: row.error_message ?? null,
+            });
+            continue;
+        }
+        let roles;
+        let steps;
+        try {
+            roles = JSON.parse(row.roles_json);
+            steps = JSON.parse(row.steps_json);
+        }
+        catch {
+            // Malformed JSON in cache — skip with no entry; the daemon's
+            // /api/workflow/specs surface will surface the row anyway.
+            continue;
+        }
+        out.push({
+            // Stable id derived from name+version so the SpecLibrary's review
+            // endpoint can resolve workflow entries the same way it resolves
+            // rig/agent entries by id.
+            id: workflowLibraryId(row.name, row.version),
+            kind: "workflow",
+            name: row.name,
+            version: row.version,
+            sourceType: isBuiltIn ? "builtin" : "user_file",
+            sourcePath: row.source_path,
+            relativePath: row.source_path,
+            updatedAt: row.cached_at,
+            summary: row.purpose ?? undefined,
+            isBuiltIn,
+            rolesCount: Object.keys(roles ?? {}).length,
+            stepsCount: Array.isArray(steps) ? steps.length : 0,
+            terminalTurnRule: row.coordination_terminal_turn_rule || "hot_potato",
+            targetRig: row.target_rig,
+            status: "valid",
+            errorMessage: null,
+        });
+    }
+    return out;
+}
+export function getWorkflowReview(opts) {
+    let row;
+    try {
+        row = opts.db.prepare(`SELECT * FROM workflow_specs WHERE name = ? AND version = ?`).get(opts.name, opts.version);
+    }
+    catch {
+        return null;
+    }
+    if (!row)
+        return null;
+    let roles;
+    let steps;
+    try {
+        roles = JSON.parse(row.roles_json);
+        steps = JSON.parse(row.steps_json);
+    }
+    catch {
+        return null;
+    }
+    const isBuiltIn = opts.workflowBuiltinSpecsDir
+        ? isUnderDir(row.source_path, opts.workflowBuiltinSpecsDir)
+        : false;
+    // Project the topology — same shape as Slice Story View v1 uses.
+    const stepByRole = new Map();
+    for (const step of steps ?? []) {
+        if (!stepByRole.has(step.actor_role))
+            stepByRole.set(step.actor_role, step);
+    }
+    const entryRole = row.entry_role
+        ?? steps?.[0]?.actor_role;
+    const entryStepId = entryRole ? stepByRole.get(entryRole)?.id : undefined;
+    const stepIds = new Set((steps ?? []).map((s) => s.id));
+    const topologyNodes = (steps ?? []).map((step) => {
+        const roleSpec = roles[step.actor_role] ?? {};
+        // OPR.0.4.6.WF4 Q1-P3: a step with next_hop.on targets is NOT terminal
+        // (the false-terminal defect for branch-only steps like build/verify).
+        const hasOnTargets = Object.keys(step.next_hop?.on ?? {}).length > 0;
+        return {
+            stepId: step.id,
+            role: step.actor_role,
+            objective: step.objective ?? null,
+            preferredTarget: roleSpec.preferred_targets?.[0] ?? null,
+            isEntry: step.id === entryStepId,
+            isTerminal: !(step.next_hop?.suggested_roles?.length) && !hasOnTargets,
+            // OPR.0.4.6.WF4 Q1-P1: optional node fields, OMITTED when absent
+            // (byte-identity-by-omission — a step with none adds no key).
+            ...(step.harness ? { harness: step.harness } : {}),
+            ...(step.host ? { host: step.host } : {}),
+            ...(step.gate ? { gate: step.gate } : {}),
+        };
+    });
+    const topologyEdges = [];
+    for (const step of steps ?? []) {
+        for (const role of step.next_hop?.suggested_roles ?? []) {
+            const target = stepByRole.get(role);
+            if (!target)
+                continue;
+            topologyEdges.push({ fromStepId: step.id, toStepId: target.id, routingType: "direct" });
+        }
+        // OPR.0.4.6.WF4 Q1-P2: branch edges from next_hop.on (exit → successor
+        // STEP ID). Absent `on` pushes nothing ⇒ suggested-roles-only specs
+        // project a byte-identical edge array. The exit label rides `branchOn`.
+        for (const [exit, targetStepId] of Object.entries(step.next_hop?.on ?? {})) {
+            if (!targetStepId || !stepIds.has(targetStepId))
+                continue;
+            topologyEdges.push({
+                fromStepId: step.id,
+                toStepId: targetStepId,
+                routingType: "branch",
+                branchOn: exit,
+            });
+        }
+    }
+    const stepDetails = (steps ?? []).map((step) => ({
+        stepId: step.id,
+        role: step.actor_role,
+        objective: step.objective ?? null,
+        allowedExits: [...(step.allowed_exits ?? [])],
+        allowedNextSteps: (step.next_hop?.suggested_roles ?? [])
+            .map((role) => {
+            const target = stepByRole.get(role);
+            return target ? { stepId: target.id, role } : null;
+        })
+            .filter((x) => x !== null),
+    }));
+    return {
+        kind: "workflow",
+        name: row.name,
+        version: row.version,
+        purpose: row.purpose,
+        targetRig: row.target_rig,
+        terminalTurnRule: row.coordination_terminal_turn_rule || "hot_potato",
+        rolesCount: Object.keys(roles ?? {}).length,
+        stepsCount: (steps ?? []).length,
+        isBuiltIn,
+        sourcePath: row.source_path,
+        cachedAt: row.cached_at,
+        topology: { nodes: topologyNodes, edges: topologyEdges },
+        steps: stepDetails,
+    };
+}
+export function workflowLibraryId(name, version) {
+    return `workflow:${name}:${version}`;
+}
+export function parseWorkflowLibraryId(id) {
+    if (!id.startsWith("workflow:"))
+        return null;
+    const rest = id.slice("workflow:".length);
+    // version may be numeric or an arbitrary string; split on the LAST `:`.
+    const lastColon = rest.lastIndexOf(":");
+    if (lastColon === -1)
+        return null;
+    return { name: rest.slice(0, lastColon), version: rest.slice(lastColon + 1) };
+}
+function isUnderDir(childPath, parentDir) {
+    const child = path.resolve(childPath);
+    const parent = path.resolve(parentDir);
+    if (child === parent)
+        return false;
+    const parentWithSep = parent.endsWith(path.sep) ? parent : `${parent}${path.sep}`;
+    return child.startsWith(parentWithSep);
+}
+function isWorkflowYamlFile(name) {
+    return /\.ya?ml$/i.test(name);
+}
+export function scanWorkflowSpecFolder(opts) {
+    const result = {
+        scanned: 0,
+        valid: 0,
+        errors: 0,
+        removed: 0,
+        skipped: 0,
+    };
+    if (!existsSync(opts.folder))
+        return result;
+    let entries = [];
+    try {
+        entries = readdirSync(opts.folder);
+    }
+    catch {
+        return result;
+    }
+    const seenPaths = new Set();
+    for (const entry of entries) {
+        if (!isWorkflowYamlFile(entry))
+            continue;
+        const filePath = path.join(opts.folder, entry);
+        let mtimeMs = 0;
+        try {
+            const stat = statSync(filePath);
+            if (!stat.isFile())
+                continue;
+            mtimeMs = stat.mtimeMs;
+        }
+        catch {
+            continue;
+        }
+        seenPaths.add(filePath);
+        result.scanned += 1;
+        // mtime check (OQ-3): if the cache has a row at this source_path
+        // whose cached_at is at or after the file's mtime, the file is
+        // unchanged since last scan — skip the re-parse work entirely.
+        //
+        // Compare at second-resolution because some filesystems (HFS+, FAT)
+        // round mtime down to whole seconds while cached_at carries ms
+        // precision; without this floor a freshly-written file whose mtime
+        // is `T - 999ms` would always look "newer" than its cached_at at
+        // exactly `T` and never skip.
+        const cachedAt = opts.db
+            .prepare(`SELECT cached_at FROM workflow_specs WHERE source_path = ?`)
+            .get(filePath);
+        if (cachedAt) {
+            const cachedAtMs = Date.parse(cachedAt.cached_at);
+            const cachedAtSec = Math.floor(cachedAtMs / 1000);
+            const mtimeSec = Math.floor(mtimeMs / 1000);
+            if (Number.isFinite(cachedAtMs) && cachedAtSec >= mtimeSec) {
+                result.skipped += 1;
+                continue;
+            }
+        }
+        // Parse + validate via cache. If readThrough throws (parse or
+        // validation error), record a diagnostic row keyed by source_path
+        // so the Library UI can render the error inline.
+        try {
+            opts.cache.readThrough(filePath);
+            result.valid += 1;
+        }
+        catch (err) {
+            // Diagnostic: hash the raw content best-effort so we can detect
+            // edits that fix the error (mtime alone is fine; this is for
+            // bookkeeping). Use the empty string when content is unreadable.
+            const message = err instanceof Error ? err.message : String(err);
+            let sourceHash = "";
+            try {
+                sourceHash = createHash("sha256").update(readFileSync(filePath, "utf-8")).digest("hex");
+            }
+            catch {
+                // unreadable / disappeared between stat and read; treat as
+                // empty hash so the next scan re-evaluates
+                sourceHash = "";
+            }
+            opts.cache.writeDiagnostic({
+                sourcePath: filePath,
+                sourceHash,
+                errorMessage: message,
+            });
+            result.errors += 1;
+        }
+    }
+    // OQ-4 deletion: cache rows whose source_path lives under the scanned
+    // folder AND whose file is no longer present on disk get removed. We
+    // scope the removal by source_path prefix to avoid touching built-in
+    // rows or rows the scanner doesn't own (e.g., other workflows folders).
+    const folderPrefix = opts.folder.endsWith(path.sep) ? opts.folder : `${opts.folder}${path.sep}`;
+    const cachedUnderFolder = opts.db
+        .prepare(`SELECT source_path, spec_id, name, version FROM workflow_specs WHERE source_path LIKE ?`)
+        .all(`${folderPrefix}%`);
+    for (const row of cachedUnderFolder) {
+        if (seenPaths.has(row.source_path))
+            continue;
+        const removed = opts.cache.removeBySourcePath(row.source_path);
+        if (removed > 0) {
+            result.removed += removed;
+            // OQ-4 audit-log: record the disappearance so operators can trace
+            // which spec was reaped when. Emission failures must not abort the
+            // scan — the cache row is already gone and the next scan would be
+            // a no-op for this path.
+            if (opts.eventBus) {
+                try {
+                    opts.eventBus.emit({
+                        type: "workflow_spec.removed",
+                        sourcePath: row.source_path,
+                        specId: row.spec_id ?? null,
+                        specName: row.name ?? null,
+                        specVersion: row.version ?? null,
+                        reason: "file_disappeared",
+                    });
+                }
+                catch { /* best-effort audit emission */ }
+            }
+        }
+    }
+    return result;
+}
+//# sourceMappingURL=spec-library-workflow-scanner.js.map

package/node_modules/@openrig/daemon/dist/domain/spec-library-workflow-scanner.js.map

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

package/node_modules/@openrig/daemon/dist/domain/spec-live-conformance.d.ts

@@ -0,0 +1,60 @@
+import type { RigSpec } from "./types.js";
+/**
+ * Build B — spec-vs-live topology conformance.
+ *
+ * A rig spec is consumed as AUTHORITATIVE by everything that recreates or describes a rig
+ * (instantiation, `rig validate`, bundle export, pod-bundle vendoring) and is MAINTAINED by nothing
+ * that mutates one. `rig expand` adds a pod to a running rig through the daemon; no code path writes
+ * the rigRoot spec back. So drift is not an accident to be prevented here — with no writer it is
+ * guaranteed — and this module does not try to prevent it.
+ *
+ * What it does is make the drift SAYABLE at the two moments it causes damage: a bundle export, which
+ * copies the spec verbatim and would otherwise ship a smaller rig than the one running, in silence;
+ * and an explicit conformance check, which is how a later spec write-back gets VERIFIED instead of
+ * eyeballed.
+ *
+ * REPORTING ONLY. Nothing here mutates a spec or blocks an export.
+ */
+export interface Topology {
+    /** Pod ids, e.g. `orch`. */
+    pods: string[];
+    /** Fully-qualified seat ids, e.g. `orch.lead`. */
+    seats: string[];
+}
+export interface ConformanceResult {
+    conforms: boolean;
+    spec: {
+        pods: number;
+        seats: number;
+    };
+    live: {
+        pods: number;
+        seats: number;
+    };
+    /** Running but undeclared — what a bundle export would silently DROP. */
+    podsMissingFromSpec: string[];
+    seatsMissingFromSpec: string[];
+    /** Declared but not running — what a re-instantiation would try to bring up. */
+    podsMissingFromLive: string[];
+    seatsMissingFromLive: string[];
+    /**
+     * A single actionable line naming the REAL delta, or null when the topologies agree.
+     *
+     * Null-on-conformance is the contract, not an implementation detail. A check that warns every
+     * time trains its reader to skim, and the one export that matters then reads like the ninety-six
+     * before it. Callers may print this whenever it is non-null and print nothing when it is not.
+     */
+    message: string | null;
+}
+export declare function compareSpecToLive(spec: Topology, live: Topology): ConformanceResult;
+/** Pods and seats as the SPEC declares them. */
+export declare function topologyFromRigSpec(spec: Pick<RigSpec, "pods">): Topology;
+/**
+ * Pods and seats as the DAEMON is actually running them, derived from node logical ids
+ * (`<pod>.<member>`). Malformed or empty ids are skipped rather than guessed at — an id we cannot
+ * parse is not evidence of a pod.
+ */
+export declare function topologyFromLiveLogicalIds(logicalIds: readonly (string | null | undefined)[]): Topology;
+/** The one-line export banner. Null when there is nothing to say. */
+export declare function bundleExportWarning(result: ConformanceResult): string | null;
+//# sourceMappingURL=spec-live-conformance.d.ts.map

package/node_modules/@openrig/daemon/dist/domain/spec-live-conformance.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spec-live-conformance.d.ts","sourceRoot":"","sources":["../../src/domain/spec-live-conformance.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAE1C;;;;;;;;;;;;;;;GAeG;AAEH,MAAM,WAAW,QAAQ;IACvB,4BAA4B;IAC5B,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,kDAAkD;IAClD,KAAK,EAAE,MAAM,EAAE,CAAC;CACjB;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,EAAE,OAAO,CAAC;IAClB,IAAI,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;IACtC,IAAI,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;IACtC,yEAAyE;IACzE,mBAAmB,EAAE,MAAM,EAAE,CAAC;IAC9B,oBAAoB,EAAE,MAAM,EAAE,CAAC;IAC/B,gFAAgF;IAChF,mBAAmB,EAAE,MAAM,EAAE,CAAC;IAC9B,oBAAoB,EAAE,MAAM,EAAE,CAAC;IAC/B;;;;;;OAMG;IACH,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;CACxB;AAYD,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,QAAQ,GAAG,iBAAiB,CAuCnF;AAED,gDAAgD;AAChD,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,IAAI,CAAC,OAAO,EAAE,MAAM,CAAC,GAAG,QAAQ,CAWzE;AAED;;;;GAIG;AACH,wBAAgB,0BAA0B,CAAC,UAAU,EAAE,SAAS,CAAC,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC,EAAE,GAAG,QAAQ,CAavG;AAED,qEAAqE;AACrE,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,iBAAiB,GAAG,MAAM,GAAG,IAAI,CAG5E"}