oh-my-claudecode 0.2.3 → 0.2.4

package/dist/cli/bind.js

@@ -0,0 +1,417 @@
+/**
+ * oh-my-claudecode bind — the CLI subcommand that drives the
+ * Necronomicon binding ritual.
+ *
+ * Architecture: a state-machine runner (`runBind`) reads `KV.bindState`,
+ * walks through each phase in `BIND_PHASE_ORDER`, invokes the matching
+ * `PhaseRunner`, and persists progress after every transition. Phases
+ * are injectable — tests pass fakes; production passes the real
+ * runners defined in `defaultPhaseRunners()`.
+ *
+ * Failure semantics: if any phase throws, `runBind` records the error
+ * into bindState, halts (does NOT run subsequent phases), and returns.
+ * The CLI entry point surfaces the error via the TUI and exits with
+ * a non-zero code. A re-run picks up from the failed phase and retries
+ * it — the state machine treats `failed` the same as `pending`.
+ *
+ * Cron-friendly: the same entry point is called from `bind --resume`
+ * which prints to stdout and exits, so a crontab can invoke it on
+ * an interval without an interactive session.
+ */
+import { existsSync, readdirSync, statSync } from "node:fs";
+import { homedir } from "node:os";
+import { join } from "node:path";
+import { KV } from "../features/yith-archive/state/schema.js";
+import { migrateSisyphusDir } from "./sisyphus-migrate.js";
+import { projectSummaryToObservations, scanProject, } from "./project-scan.js";
+import { BIND_PHASE_ORDER, firstPendingPhase, initialBindState, markPhase, } from "../features/yith-archive/state/bind-state.js";
+import { renderProgressBar, renderSectionHeader, renderStatusLine, formatBytes, formatDuration, } from "./tui.js";
+// ============================================================================
+// Phase label + runner
+// ============================================================================
+/** Human-readable label for each phase — what the user sees in the TUI. */
+function phaseLabel(phase) {
+    switch (phase) {
+        case "embedding_download":
+            return "Phase I: The Embedding Sigil";
+        case "claude_transcripts":
+            return "Phase II: Claude Code Transcripts";
+        case "opencode_import":
+            return "Phase III: Opencode Grimoire";
+        case "sisyphus_migrate":
+            return "Phase IV: Sisyphus Migration";
+        case "preliminary_seed":
+            return "Phase V: Project Code Scan";
+        case "pending_compression_trigger":
+            return "Phase VI: Sealing the Tome";
+    }
+}
+/**
+ * State-machine driver. Reads bindState, runs pending phases in order,
+ * persists progress after each, halts on first failure.
+ *
+ * Returns the final BindState so callers (the CLI entry point) can
+ * summarize what happened and exit with the right code.
+ */
+export async function runBind(opts) {
+    const { archive, tui, phases = defaultPhaseRunners(), force } = opts;
+    const kv = archive.kv;
+    // Load or create bindState.
+    let state = (await kv.get(KV.bindState, "current").catch(() => null)) ??
+        initialBindState();
+    // If the user asked for a forced re-run of specific phases, reset
+    // them to pending before walking the state machine.
+    if (force && force.length > 0) {
+        for (const phase of force) {
+            state = markPhase(state, phase, { status: "pending" });
+        }
+        await kv.set(KV.bindState, "current", state);
+        await kv.persist();
+    }
+    tui.line(renderSectionHeader("Necronomicon Binding Ritual"));
+    tui.line(renderStatusLine("info", `Necronomicon: ${necronomiconPath()}`));
+    // Report any already-completed phases so the user sees resume state.
+    for (const phase of BIND_PHASE_ORDER) {
+        if (state.phases[phase].status === "completed") {
+            tui.line(renderStatusLine("ok", `${phaseLabel(phase)} (already bound)`));
+        }
+    }
+    const started = Date.now();
+    while (true) {
+        const phase = firstPendingPhase(state);
+        if (phase === null)
+            break;
+        const runner = phases.find((p) => p.name === phase);
+        if (!runner) {
+            // No runner registered for this phase — treat as completed
+            // (phase isn't implemented yet). Mark it completed so we don't
+            // block forever, and note it in the details.
+            tui.line(renderStatusLine("warn", `${phaseLabel(phase)} — no runner registered, skipping`));
+            state = markPhase(state, phase, {
+                status: "completed",
+                details: { skipped: true, reason: "no runner registered" },
+            });
+            await kv.set(KV.bindState, "current", state);
+            await kv.persist();
+            continue;
+        }
+        // Mark in_progress, persist, announce.
+        state = markPhase(state, phase, { status: "in_progress" });
+        await kv.set(KV.bindState, "current", state);
+        await kv.persist();
+        tui.line(renderSectionHeader(phaseLabel(phase)));
+        const phaseStarted = Date.now();
+        try {
+            const result = await runner.run({ archive, tui });
+            const elapsed = formatDuration(Date.now() - phaseStarted);
+            state = markPhase(state, phase, {
+                status: "completed",
+                details: result.details,
+            });
+            await kv.set(KV.bindState, "current", state);
+            await kv.persist();
+            tui.line(renderStatusLine("ok", `${phaseLabel(phase)} — complete in ${elapsed}`));
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            state = markPhase(state, phase, { status: "failed", error: msg });
+            await kv.set(KV.bindState, "current", state);
+            await kv.persist();
+            tui.line(renderStatusLine("error", `${phaseLabel(phase)} — ${msg}`));
+            tui.line(renderStatusLine("info", "Re-run `oh-my-claudecode bind` to retry from this phase."));
+            return state;
+        }
+    }
+    const totalElapsed = formatDuration(Date.now() - started);
+    tui.line(renderSectionHeader("Binding Complete"));
+    tui.line(renderStatusLine("ok", `The Necronomicon is bound. Ritual elapsed: ${totalElapsed}`));
+    // Pending-compression teaser so the user knows what comes next.
+    const pending = await kv
+        .get(KV.pendingCompression, "state")
+        .catch(() => null);
+    if (pending && pending.count > 0) {
+        tui.line(renderStatusLine("info", `${pending.count} raw observations awaiting compression — ` +
+            `processed in the background or via /necronomicon-bind in a session.`));
+    }
+    return state;
+}
+// ============================================================================
+// Default phase runners
+// ============================================================================
+/** Path where the Necronomicon file lives on this machine. */
+function necronomiconPath() {
+    return join(homedir(), ".oh-my-claudecode", "yith", "necronomicon.json");
+}
+/**
+ * Walk the given root directory up to `maxDepth` levels deep looking
+ * for `.sisyphus/` subdirectories. Used by the sisyphus migration
+ * phase to find every legacy project that needs translating without
+ * requiring the user to enumerate them. Excludes well-known heavy
+ * paths (node_modules, .git, .cache) to keep the walk bounded.
+ */
+function findSisyphusDirs(root, maxDepth) {
+    const skip = new Set([
+        "node_modules",
+        ".git",
+        ".cache",
+        ".next",
+        "dist",
+        ".oh-my-claudecode",
+        ".claude",
+        ".npm",
+        ".npm-global",
+    ]);
+    const out = [];
+    const walk = (dir, depth) => {
+        if (depth > maxDepth)
+            return;
+        let entries;
+        try {
+            entries = readdirSync(dir);
+        }
+        catch {
+            return;
+        }
+        for (const entry of entries) {
+            if (skip.has(entry))
+                continue;
+            const full = join(dir, entry);
+            let s;
+            try {
+                s = statSync(full);
+            }
+            catch {
+                continue;
+            }
+            if (!s.isDirectory())
+                continue;
+            if (entry === ".sisyphus") {
+                out.push(full);
+                continue; // don't recurse into .sisyphus itself
+            }
+            walk(full, depth + 1);
+        }
+    };
+    walk(root, 0);
+    return out;
+}
+/**
+ * Production phase runners. Tests inject fakes; the CLI entry point
+ * uses these defaults.
+ *
+ * Each runner is a thin wrapper that calls the underlying feature
+ * (provider warmup, backfill function, opencode importer, etc.) and
+ * reports progress via the context's TUI writer.
+ *
+ * Phases B, C, and D (opencode_import, sisyphus_migrate,
+ * preliminary_seed) currently register placeholders that log a
+ * "pending implementation" status and complete without work. They
+ * get real implementations in their respective phase files.
+ */
+export function defaultPhaseRunners() {
+    return [
+        {
+            name: "embedding_download",
+            async run({ archive, tui }) {
+                const provider = archive.embeddingProvider;
+                if (!provider || typeof provider.warmUp !== "function") {
+                    tui.line(renderStatusLine("info", "No embedding provider configured — BM25-only mode, skipping model download."));
+                    return { details: { skipped: true, reason: "no embedding provider" } };
+                }
+                tui.line(renderStatusLine("pending", `Fetching ${provider.name ?? "embedding model"}...`));
+                let lastLoaded = 0;
+                let lastTotal = 0;
+                await provider.warmUp({
+                    onProgress: (e) => {
+                        if (e.phase === "downloading" && e.loaded && e.total) {
+                            lastLoaded = e.loaded;
+                            lastTotal = e.total;
+                            tui.replaceLastLine(renderProgressBar({
+                                current: e.loaded,
+                                total: e.total,
+                                label: `${formatBytes(e.loaded)} / ${formatBytes(e.total)}`,
+                            }));
+                        }
+                        else if (e.phase === "loading") {
+                            tui.line(renderStatusLine("pending", e.message ?? "Loading..."));
+                        }
+                        else if (e.phase === "ready") {
+                            tui.line(renderStatusLine("ok", e.message ?? "Embedding model ready"));
+                        }
+                    },
+                });
+                return {
+                    details: {
+                        bytesDownloaded: lastLoaded,
+                        totalBytes: lastTotal,
+                    },
+                };
+            },
+        },
+        {
+            name: "claude_transcripts",
+            async run({ archive, tui }) {
+                tui.line(renderStatusLine("pending", "Scanning ~/.claude/projects/ for transcripts..."));
+                const result = (await archive.sdk.trigger("mem::backfill-sessions", {
+                    allProjects: true,
+                    dryRun: false,
+                }));
+                const projects = result.totalProjects ?? 0;
+                const obs = result.totalObservationsCreated ?? 0;
+                const transcripts = result.totalTranscriptsScanned ?? 0;
+                tui.line(renderStatusLine("ok", `Ingested ${obs} raw observations from ${transcripts} transcripts across ${projects} projects`));
+                // Per-project breakdown — lets the user see which projects
+                // contributed what at a glance. Truncate at 10 to keep the
+                // output manageable for users with many projects.
+                const perProject = result.perProject ?? [];
+                for (const p of perProject.slice(0, 10)) {
+                    if (p.observationsCreated > 0) {
+                        tui.line(renderStatusLine("info", `${p.projectCwd}: ${p.observationsCreated} obs`));
+                    }
+                }
+                if (perProject.length > 10) {
+                    tui.line(renderStatusLine("info", `... and ${perProject.length - 10} more projects`));
+                }
+                return { details: { projects, observations: obs, transcripts } };
+            },
+        },
+        {
+            name: "opencode_import",
+            async run({ archive, tui }) {
+                // Check if an opencode database exists at the default path.
+                // The function handles "not found" gracefully, but we short-
+                // circuit here so the TUI output is clearer.
+                const defaultDb = join(homedir(), ".local", "share", "opencode", "opencode.db");
+                if (!existsSync(defaultDb)) {
+                    tui.line(renderStatusLine("info", "No opencode.db found — skipping opencode import."));
+                    return { details: { skipped: true, reason: "no opencode db" } };
+                }
+                tui.line(renderStatusLine("pending", `Reading opencode history from ${defaultDb}...`));
+                const result = (await archive.sdk.trigger("mem::import-opencode", {
+                    dbPath: defaultDb,
+                }));
+                if (!result.success) {
+                    throw new Error(result.error ?? "opencode import failed");
+                }
+                tui.line(renderStatusLine("ok", `Imported ${result.observationsCreated} opencode observations ` +
+                    `(${result.observationsSkipped} duplicates skipped) from ` +
+                    `${result.sessionsScanned} sessions across ${result.projectsScanned} projects.`));
+                return {
+                    details: {
+                        created: result.observationsCreated,
+                        skipped: result.observationsSkipped,
+                        sessions: result.sessionsScanned,
+                        projects: result.projectsScanned,
+                    },
+                };
+            },
+        },
+        {
+            name: "sisyphus_migrate",
+            async run({ tui }) {
+                // Walk the user's home for any `.sisyphus/` dirs to migrate.
+                // We don't go deeper than 5 levels — sisyphus dirs were always
+                // project-root-scoped.
+                tui.line(renderStatusLine("pending", "Scanning for .sisyphus directories..."));
+                const discovered = findSisyphusDirs(homedir(), 5);
+                if (discovered.length === 0) {
+                    tui.line(renderStatusLine("info", "No .sisyphus directories found."));
+                    return { details: { dirs: 0 } };
+                }
+                let migrated = 0;
+                for (const dir of discovered) {
+                    const projectRoot = join(dir, "..");
+                    const dest = join(projectRoot, ".elder-gods");
+                    const result = migrateSisyphusDir({ source: dir, dest });
+                    const copied = result.plansCopied +
+                        result.handoffsCopied +
+                        result.evidenceCopied +
+                        result.legacyCopied;
+                    if (copied > 0) {
+                        tui.line(renderStatusLine("ok", `${dir} → ${dest}: ${result.plansCopied} plans, ` +
+                            `${result.handoffsCopied} handoffs, ` +
+                            `${result.evidenceCopied} evidence files`));
+                        migrated++;
+                    }
+                }
+                return { details: { discovered: discovered.length, migrated } };
+            },
+        },
+        {
+            name: "preliminary_seed",
+            async run({ archive, tui }) {
+                // Scan every project directory we already know about (from
+                // the Claude Code transcripts phase) and emit synthesized
+                // preliminary observations. If the project dir no longer
+                // exists on disk, skip it with a warning.
+                tui.line(renderStatusLine("pending", "Scanning project code for preliminary memories..."));
+                // Re-enumerate sessions to find the set of project cwds.
+                const sessions = await archive.kv
+                    .list(KV.sessions)
+                    .catch(() => []);
+                const projectCwds = new Set();
+                for (const s of sessions) {
+                    if (s.project && s.project.startsWith("/")) {
+                        projectCwds.add(s.project);
+                    }
+                }
+                let scanned = 0;
+                let created = 0;
+                for (const cwd of projectCwds) {
+                    if (!existsSync(cwd))
+                        continue;
+                    try {
+                        const summary = await scanProject(cwd);
+                        const obs = projectSummaryToObservations(summary);
+                        const sessionId = `proj:${cwd}`;
+                        // Upsert a synthetic "project-scan" session so the
+                        // observations land somewhere the search index can find.
+                        await archive.kv.set(KV.sessions, sessionId, {
+                            id: sessionId,
+                            project: cwd,
+                            cwd,
+                            startedAt: new Date().toISOString(),
+                            status: "completed",
+                            observationCount: obs.length,
+                        });
+                        for (const o of obs) {
+                            const existing = await archive.kv
+                                .get(KV.observations(sessionId), o.id)
+                                .catch(() => null);
+                            if (existing)
+                                continue;
+                            await archive.kv.set(KV.observations(sessionId), o.id, { ...o, sessionId });
+                            created++;
+                        }
+                        scanned++;
+                    }
+                    catch (err) {
+                        tui.line(renderStatusLine("warn", `${cwd}: ${err instanceof Error ? err.message : String(err)}`));
+                    }
+                }
+                tui.line(renderStatusLine("ok", `Scanned ${scanned} projects, seeded ${created} preliminary observations.`));
+                return { details: { scanned, created } };
+            },
+        },
+        {
+            name: "pending_compression_trigger",
+            async run({ archive, tui }) {
+                const pending = await archive.kv
+                    .get(KV.pendingCompression, "state")
+                    .catch(() => null);
+                const count = pending?.count ?? 0;
+                if (count > 0) {
+                    tui.line(renderStatusLine("info", `${count} raw observations queued for compression. ` +
+                        `Run /necronomicon-bind inside Claude Code to process them, ` +
+                        `or install the cron entry with \`oh-my-claudecode bind --install-cron\` ` +
+                        `for unattended background compression via \`claude -p\`.`));
+                }
+                else {
+                    tui.line(renderStatusLine("ok", "No observations pending compression."));
+                }
+                return { details: { pendingCompression: count } };
+            },
+        },
+    ];
+}
+//# sourceMappingURL=bind.js.map

package/dist/cli/bind.js.map

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

package/dist/cli/index.js

@@ -1,8 +1,12 @@
 import { Command } from "commander";
 import * as path from "path";
 import { fileURLToPath } from "url";
+import { execFileSync } from "node:child_process";
 import { runInstall } from "./install.js";
 import { runDoctor, printYithFunctionCatalog } from "./doctor.js";
+import { runBind } from "./bind.js";
+import { buildClaudePSpawnCommand, buildCrontabLine, installCrontabEntry, parseIntervalSpec, } from "./bind-cron.js";
+import { TuiWriter } from "./tui.js";
 const __filename = fileURLToPath(import.meta.url);
 const __dirname = path.dirname(__filename);
 const PACKAGE_ROOT = path.resolve(__dirname, "../..");
@@ -54,5 +58,62 @@ program
     }
     console.log();
 });
+program
+    .command("bind")
+    .description("Run the Necronomicon binding ritual — download embedding model, " +
+    "ingest past transcripts, import opencode history, migrate sisyphus " +
+    "dirs, seed preliminary memories. Resumable.")
+    .option("--resume", "Cron-friendly: run only pending work and exit")
+    .option("--install-cron", "Install a system crontab entry that runs `bind --resume` on an interval")
+    .option("--interval <spec>", "Interval for the cron entry (e.g. 1h, 30m, 1d). Used with --install-cron.", "1h")
+    .option("--force <phase>", "Re-run a specific phase even if already completed")
+    .action(async (options) => {
+    if (options.installCron) {
+        // Install the crontab entry that runs `bind --resume`.
+        const schedule = parseIntervalSpec(options.interval ?? "1h");
+        const binCmd = process.argv[1] ?? "oh-my-claudecode";
+        const crontabBody = buildCrontabLine({
+            schedule,
+            command: `${binCmd} bind --resume`,
+        });
+        let current = "";
+        try {
+            current = execFileSync("crontab", ["-l"], {
+                encoding: "utf-8",
+                stdio: ["ignore", "pipe", "ignore"],
+            });
+        }
+        catch {
+            current = "";
+        }
+        const updated = installCrontabEntry(current, crontabBody);
+        execFileSync("crontab", ["-"], { input: updated });
+        console.log(`Installed crontab entry on schedule '${schedule}'. The cron ` +
+            `tick will run \`${binCmd} bind --resume\` to ingest new data ` +
+            `and drive compression via \`claude -p\`.`);
+        console.log(`Spawn command preview:\n  ${buildClaudePSpawnCommand({})}`);
+        return;
+    }
+    const { createYithArchive } = await import("../features/yith-archive/index.js");
+    const archive = createYithArchive();
+    const tui = new TuiWriter({
+        write: (s) => process.stdout.write(s),
+        isTTY: process.stdout.isTTY ?? false,
+    });
+    try {
+        await runBind({
+            archive,
+            tui,
+            force: options.force
+                ? [
+                    options.force,
+                ]
+                : undefined,
+        });
+    }
+    finally {
+        await archive.shutdown();
+    }
+});
 program.parse();
 //# sourceMappingURL=index.js.map

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/project-scan.d.ts

@@ -0,0 +1,94 @@
+import type { RawObservation } from "../features/yith-archive/types.js";
+/**
+ * Deep project scanner — Phase D of the binding ritual.
+ *
+ * Walks a project's directory tree (respecting .gitignore), parses
+ * the well-known package-manager metadata files, extracts README
+ * structure, counts language files by extension, and synthesizes a
+ * set of RawObservations summarizing the project. These observations
+ * get compressed into searchable memories later via the work-packet
+ * loop, so even brand-new projects with zero session history land in
+ * the Necronomicon with a useful baseline of context.
+ *
+ * Scope notes:
+ *   - Walk depth is capped at 6 to avoid pathological directory trees.
+ *   - File count is capped at 2000 so a leaked node_modules doesn't
+ *     hang the scan.
+ *   - Gitignore parsing is intentionally shallow — only the top-level
+ *     .gitignore is respected, and only literal and glob-star patterns.
+ *     Nested .gitignore files are skipped. This is a preliminary
+ *     scan, not a perfect build tool.
+ *   - Config file parsers cover the common cases (package.json,
+ *     Cargo.toml, pyproject.toml, go.mod, composer.json, Gemfile).
+ *     Rarer ones fall through to a "config file of unknown type"
+ *     observation with the filename only.
+ */
+export interface LanguageStats {
+    byExt: Record<string, number>;
+    primary: string;
+    total: number;
+}
+export interface ReadmeSections {
+    title: string | null;
+    firstParagraph: string | null;
+    headings: string[];
+}
+export interface PackageInfo {
+    name?: string;
+    version?: string;
+    description?: string;
+    runtimeDependencies: string[];
+    devDependencies: string[];
+    scripts: Record<string, string>;
+    entryPoint?: string;
+}
+export interface ProjectSummary {
+    path: string;
+    files: string[];
+    languages: LanguageStats;
+    packageInfo: PackageInfo | null;
+    readme: ReadmeSections | null;
+    configFiles: string[];
+    directoryTree: string;
+}
+/**
+ * Parse a .gitignore body into a flat list of patterns. Drops
+ * comment lines (# prefix) and empty lines. Trailing slashes on
+ * directory patterns are preserved so `isIgnored` can match them.
+ */
+export declare function parseGitignore(body: string): string[];
+/**
+ * Check whether a relative path matches any gitignore pattern.
+ * Supports literal names, `*.ext` globs, and trailing-slash
+ * directory patterns.
+ */
+export declare function isIgnored(relPath: string, patterns: string[]): boolean;
+/**
+ * Count file paths by extension and return the most-common one as
+ * the primary language indicator. Extensions include the leading dot
+ * so callers can distinguish `.ts` / `.tsx` / `.js` etc.
+ */
+export declare function summarizeLanguages(files: string[]): LanguageStats;
+/**
+ * Extract the top-level title, first paragraph, and H2 headings from
+ * a README markdown body. Used for the project-summary observation
+ * so downstream search has something to match against even when the
+ * README is the only source of truth about what the project does.
+ */
+export declare function extractReadmeSections(body: string): ReadmeSections;
+/**
+ * Parse a package.json body into a simplified PackageInfo summary.
+ * Returns null on malformed JSON — callers should handle the null
+ * case (e.g., emit a "malformed package.json" observation).
+ */
+export declare function parsePackageJson(body: string): PackageInfo | null;
+export declare function scanProject(root: string): Promise<ProjectSummary>;
+/**
+ * Emit a set of RawObservations synthesized from the scan results.
+ * Every observation gets a stable ID derived from the project path
+ * plus the observation kind, so re-running the scan produces the
+ * same IDs and the idempotent-upsert path in the write layer
+ * dedupes automatically.
+ */
+export declare function projectSummaryToObservations(summary: ProjectSummary): RawObservation[];
+//# sourceMappingURL=project-scan.d.ts.map

package/dist/cli/project-scan.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"project-scan.d.ts","sourceRoot":"","sources":["../../src/cli/project-scan.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAY,cAAc,EAAE,MAAM,mCAAmC,CAAA;AAEjF;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAMH,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAC7B,OAAO,EAAE,MAAM,CAAA;IACf,KAAK,EAAE,MAAM,CAAA;CACd;AAED,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;IACpB,cAAc,EAAE,MAAM,GAAG,IAAI,CAAA;IAC7B,QAAQ,EAAE,MAAM,EAAE,CAAA;CACnB;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,mBAAmB,EAAE,MAAM,EAAE,CAAA;IAC7B,eAAe,EAAE,MAAM,EAAE,CAAA;IACzB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAC/B,UAAU,CAAC,EAAE,MAAM,CAAA;CACpB;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,EAAE,MAAM,EAAE,CAAA;IACf,SAAS,EAAE,aAAa,CAAA;IACxB,WAAW,EAAE,WAAW,GAAG,IAAI,CAAA;IAC/B,MAAM,EAAE,cAAc,GAAG,IAAI,CAAA;IAC7B,WAAW,EAAE,MAAM,EAAE,CAAA;IACrB,aAAa,EAAE,MAAM,CAAA;CACtB;AAMD;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAQrD;AAED;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,OAAO,CAgBtE;AAMD;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,aAAa,CAiBjE;AAMD;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,GAAG,cAAc,CAoBlE;AAMD;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,IAAI,CA4BjE;AAgFD,wBAAsB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC,CAoEvE;AAiCD;;;;;;GAMG;AACH,wBAAgB,4BAA4B,CAC1C,OAAO,EAAE,cAAc,GACtB,cAAc,EAAE,CA2FlB"}