hivemind-context-governance 1.3.0

package/dist/dashboard/server.js

@@ -0,0 +1,282 @@
+/**
+ * HiveMind Dashboard Backend
+ *
+ * Provides HTTP API for dashboard data:
+ * - GET /api/state — Current brain state
+ * - GET /api/active — Active session content
+ * - GET /api/index — Project trajectory
+ * - GET /api/archives — List of archived sessions
+ * - GET /api/archives/:id — Specific archive content
+ * - GET /api/metrics — Session metrics
+ *
+ * Serves static dashboard files in production.
+ */
+import { createServer } from "http";
+import { readFile } from "fs/promises";
+import { existsSync } from "fs";
+import { join, basename } from "path";
+import { createStateManager } from "../lib/persistence.js";
+import { readActiveMd, listArchives, getPlanningPaths } from "../lib/planning-fs.js";
+import { createLogger } from "../lib/logging.js";
+// ─── CORS Headers ────────────────────────────────────────────────────
+const CORS_HEADERS = {
+    "Access-Control-Allow-Origin": "*",
+    "Access-Control-Allow-Methods": "GET, POST, OPTIONS",
+    "Access-Control-Allow-Headers": "Content-Type",
+    "Content-Type": "application/json",
+};
+// ─── Response Helpers ────────────────────────────────────────────────
+function sendJson(res, status, data) {
+    res.writeHead(status, CORS_HEADERS);
+    res.end(JSON.stringify(data));
+}
+function sendError(res, status, message) {
+    sendJson(res, status, { success: false, error: message });
+}
+// ─── Route Handlers ──────────────────────────────────────────────────
+async function handleGetState(config, res) {
+    try {
+        const stateManager = createStateManager(config.projectRoot);
+        const state = await stateManager.load();
+        if (!state) {
+            sendJson(res, 200, { success: true, data: null });
+            return;
+        }
+        sendJson(res, 200, { success: true, data: state });
+    }
+    catch (err) {
+        sendError(res, 500, `Failed to load state: ${err}`);
+    }
+}
+async function handleGetActive(config, res) {
+    try {
+        const activeMd = await readActiveMd(config.projectRoot);
+        sendJson(res, 200, { success: true, data: activeMd });
+    }
+    catch (err) {
+        sendError(res, 500, `Failed to load active.md: ${err}`);
+    }
+}
+async function handleGetIndex(config, res) {
+    try {
+        const paths = getPlanningPaths(config.projectRoot);
+        const content = await readFile(paths.indexPath, "utf-8");
+        sendJson(res, 200, { success: true, data: { content } });
+    }
+    catch (err) {
+        sendError(res, 500, `Failed to load index.md: ${err}`);
+    }
+}
+async function handleGetArchives(config, res) {
+    try {
+        const archives = await listArchives(config.projectRoot);
+        sendJson(res, 200, {
+            success: true,
+            data: archives.map((path) => ({
+                id: basename(path, ".md"),
+                path,
+            })),
+        });
+    }
+    catch (err) {
+        sendError(res, 500, `Failed to list archives: ${err}`);
+    }
+}
+async function handleGetArchive(config, archiveId, res) {
+    try {
+        const paths = getPlanningPaths(config.projectRoot);
+        const archivePath = join(paths.archiveDir, `${archiveId}.md`);
+        // Security: ensure path is within archive directory
+        if (!archivePath.startsWith(paths.archiveDir)) {
+            sendError(res, 403, "Invalid archive ID");
+            return;
+        }
+        if (!existsSync(archivePath)) {
+            sendError(res, 404, "Archive not found");
+            return;
+        }
+        const content = await readFile(archivePath, "utf-8");
+        sendJson(res, 200, { success: true, data: { id: archiveId, content } });
+    }
+    catch (err) {
+        sendError(res, 500, `Failed to load archive: ${err}`);
+    }
+}
+async function handleGetMetrics(config, res) {
+    try {
+        const stateManager = createStateManager(config.projectRoot);
+        const state = await stateManager.load();
+        const archives = await listArchives(config.projectRoot);
+        if (!state) {
+            sendJson(res, 200, {
+                success: true,
+                data: {
+                    hasSession: false,
+                    totalArchives: archives.length,
+                },
+            });
+            return;
+        }
+        sendJson(res, 200, {
+            success: true,
+            data: {
+                hasSession: true,
+                session: {
+                    id: state.session.id,
+                    mode: state.session.mode,
+                    status: state.session.governance_status,
+                    startTime: state.session.start_time,
+                },
+                hierarchy: state.hierarchy,
+                metrics: state.metrics,
+                totalArchives: archives.length,
+            },
+        });
+    }
+    catch (err) {
+        sendError(res, 500, `Failed to load metrics: ${err}`);
+    }
+}
+// ─── Router ──────────────────────────────────────────────────────────
+function route(config, req, res) {
+    const url = req.url ?? "/";
+    const method = req.method ?? "GET";
+    // CORS preflight
+    if (method === "OPTIONS") {
+        res.writeHead(204, CORS_HEADERS);
+        res.end();
+        return;
+    }
+    // Only accept GET requests for API
+    if (method !== "GET") {
+        sendError(res, 405, "Method not allowed");
+        return;
+    }
+    // API routes
+    if (url === "/api/state") {
+        handleGetState(config, res);
+        return;
+    }
+    if (url === "/api/active") {
+        handleGetActive(config, res);
+        return;
+    }
+    if (url === "/api/index") {
+        handleGetIndex(config, res);
+        return;
+    }
+    if (url === "/api/archives") {
+        handleGetArchives(config, res);
+        return;
+    }
+    if (url.startsWith("/api/archives/")) {
+        const archiveId = url.slice("/api/archives/".length);
+        handleGetArchive(config, archiveId, res);
+        return;
+    }
+    if (url === "/api/metrics") {
+        handleGetMetrics(config, res);
+        return;
+    }
+    if (url === "/api/health") {
+        sendJson(res, 200, { success: true, data: { status: "ok" } });
+        return;
+    }
+    // 404 for unknown routes
+    sendError(res, 404, "Not found");
+}
+export function createDashboardServer(projectRoot, options = {}) {
+    const config = {
+        projectRoot,
+        port: options.port ?? 0, // 0 = random available port
+        host: options.host ?? "127.0.0.1",
+    };
+    let server = null;
+    let serverUrl = "";
+    return {
+        get url() {
+            return serverUrl;
+        },
+        async start() {
+            // Ensure planning directory exists
+            const paths = getPlanningPaths(projectRoot);
+            if (!existsSync(paths.planningDir)) {
+                throw new Error(`HiveMind not initialized. Run 'hivemind init' first.`);
+            }
+            // Setup logging
+            const log = await createLogger(join(paths.planningDir, "logs"), "dashboard");
+            return new Promise((resolve, reject) => {
+                server = createServer((req, res) => {
+                    route(config, req, res);
+                });
+                server.listen(config.port, config.host, () => {
+                    const address = server?.address();
+                    if (address && typeof address === "object") {
+                        serverUrl = `http://${config.host}:${address.port}`;
+                        log.info(`Dashboard server started at ${serverUrl}`);
+                        resolve();
+                    }
+                    else {
+                        reject(new Error("Failed to get server address"));
+                    }
+                });
+                server.on("error", (err) => {
+                    reject(err);
+                });
+            });
+        },
+        async stop() {
+            return new Promise((resolve) => {
+                if (server) {
+                    server.close(() => resolve());
+                    server = null;
+                }
+                else {
+                    resolve();
+                }
+            });
+        },
+    };
+}
+// ─── CLI Entry Point ─────────────────────────────────────────────────
+async function main() {
+    const projectRoot = process.cwd();
+    const port = process.env.HIVEMIND_PORT
+        ? parseInt(process.env.HIVEMIND_PORT, 10)
+        : undefined;
+    const server = createDashboardServer(projectRoot, { port });
+    try {
+        await server.start();
+        // eslint-disable-next-line no-console
+        console.log(`HiveMind Dashboard running at ${server.url}`);
+        // eslint-disable-next-line no-console
+        console.log(`API endpoints:`);
+        // eslint-disable-next-line no-console
+        console.log(`  ${server.url}/api/state`);
+        // eslint-disable-next-line no-console
+        console.log(`  ${server.url}/api/metrics`);
+        // eslint-disable-next-line no-console
+        console.log(`  ${server.url}/api/active`);
+        // eslint-disable-next-line no-console
+        console.log(`  ${server.url}/api/archives`);
+        // eslint-disable-next-line no-console
+        console.log(`\nPress Ctrl+C to stop`);
+    }
+    catch (err) {
+        // eslint-disable-next-line no-console
+        console.error("Failed to start dashboard:", err);
+        process.exit(1);
+    }
+    // Graceful shutdown
+    process.on("SIGINT", async () => {
+        // eslint-disable-next-line no-console
+        console.log("\nShutting down...");
+        await server.stop();
+        process.exit(0);
+    });
+}
+// Run if called directly
+if (import.meta.url === `file://${process.argv[1]}`) {
+    main();
+}
+//# sourceMappingURL=server.js.map

package/dist/dashboard/server.js.map

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

package/dist/hooks/compaction.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Compaction Hook — Preserves hierarchy context across LLM compaction.
+ *
+ * Reads current brain state hierarchy and injects it into
+ * post-compaction context via output.context.push().
+ *
+ * P3: try/catch — never break compaction
+ * Budget-capped ≤500 tokens (~2000 chars)
+ */
+import type { Logger } from "../lib/logging.js";
+/**
+ * Creates the compaction hook.
+ *
+ * Hook factory pattern: captured logger + directory.
+ */
+export declare function createCompactionHook(log: Logger, directory: string): (_input: {
+    sessionID: string;
+}, output: {
+    context: string[];
+}) => Promise<void>;
+//# sourceMappingURL=compaction.d.ts.map

package/dist/hooks/compaction.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compaction.d.ts","sourceRoot":"","sources":["../../src/hooks/compaction.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAA;AAM/C;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,IAI/D,QAAQ;IAAE,SAAS,EAAE,MAAM,CAAA;CAAE,EAC7B,QAAQ;IAAE,OAAO,EAAE,MAAM,EAAE,CAAA;CAAE,KAC5B,OAAO,CAAC,IAAI,CAAC,CA4EjB"}

package/dist/hooks/compaction.js

@@ -0,0 +1,79 @@
+/**
+ * Compaction Hook — Preserves hierarchy context across LLM compaction.
+ *
+ * Reads current brain state hierarchy and injects it into
+ * post-compaction context via output.context.push().
+ *
+ * P3: try/catch — never break compaction
+ * Budget-capped ≤500 tokens (~2000 chars)
+ */
+import { createStateManager } from "../lib/persistence.js";
+/** Budget in characters (~500 tokens at ~4 chars/token) */
+const INJECTION_BUDGET_CHARS = 2000;
+/**
+ * Creates the compaction hook.
+ *
+ * Hook factory pattern: captured logger + directory.
+ */
+export function createCompactionHook(log, directory) {
+    const stateManager = createStateManager(directory);
+    return async (_input, output) => {
+        try {
+            const state = await stateManager.load();
+            if (!state) {
+                await log.debug("Compaction: no brain state to preserve");
+                return;
+            }
+            const lines = [];
+            lines.push("=== HiveMind Context (post-compaction) ===");
+            lines.push("");
+            // Session info
+            lines.push(`Session: ${state.session.id} | Status: ${state.session.governance_status} | Mode: ${state.session.mode}`);
+            lines.push("");
+            // Hierarchy — the most important context to preserve
+            lines.push("## Current Hierarchy");
+            if (state.hierarchy.trajectory) {
+                lines.push(`Trajectory: ${state.hierarchy.trajectory}`);
+            }
+            if (state.hierarchy.tactic) {
+                lines.push(`Tactic: ${state.hierarchy.tactic}`);
+            }
+            if (state.hierarchy.action) {
+                lines.push(`Action: ${state.hierarchy.action}`);
+            }
+            if (!state.hierarchy.trajectory &&
+                !state.hierarchy.tactic &&
+                !state.hierarchy.action) {
+                lines.push("No hierarchy set. Use map_context to set focus.");
+            }
+            lines.push("");
+            // Metrics
+            lines.push(`Turns: ${state.metrics.turn_count} | Drift: ${state.metrics.drift_score}/100 | Files: ${state.metrics.files_touched.length}`);
+            if (state.metrics.files_touched.length > 0) {
+                const maxFiles = 10;
+                const shown = state.metrics.files_touched.slice(0, maxFiles);
+                lines.push(`Files: ${shown.join(", ")}`);
+                if (state.metrics.files_touched.length > maxFiles) {
+                    lines.push(`  ... and ${state.metrics.files_touched.length - maxFiles} more`);
+                }
+            }
+            lines.push("");
+            lines.push("=== End HiveMind Context ===");
+            // Budget enforcement
+            let context = lines.join("\n");
+            if (context.length > INJECTION_BUDGET_CHARS) {
+                context =
+                    context.slice(0, INJECTION_BUDGET_CHARS - 30) +
+                        "\n=== End HiveMind Context ===";
+                await log.warn(`Compaction injection truncated: ${lines.join("\n").length} → ${context.length} chars`);
+            }
+            output.context.push(context);
+            await log.debug(`Compaction: injected ${context.length} chars`);
+        }
+        catch (error) {
+            // P3: Never break compaction — this is critical
+            await log.error(`Compaction hook error: ${error}`);
+        }
+    };
+}
+//# sourceMappingURL=compaction.js.map

package/dist/hooks/compaction.js.map

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

package/dist/hooks/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Hook barrel exports — HiveMind governance hooks
+ */
+export { createToolGateHook } from "./tool-gate.js";
+export type { ToolGateResult } from "./tool-gate.js";
+export { createSessionLifecycleHook } from "./session-lifecycle.js";
+export { createCompactionHook } from "./compaction.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/hooks/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAA;AACnD,YAAY,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAA;AACpD,OAAO,EAAE,0BAA0B,EAAE,MAAM,wBAAwB,CAAA;AACnE,OAAO,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAA"}

package/dist/hooks/index.js

@@ -0,0 +1,7 @@
+/**
+ * Hook barrel exports — HiveMind governance hooks
+ */
+export { createToolGateHook } from "./tool-gate.js";
+export { createSessionLifecycleHook } from "./session-lifecycle.js";
+export { createCompactionHook } from "./compaction.js";
+//# sourceMappingURL=index.js.map

package/dist/hooks/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/hooks/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAA;AAEnD,OAAO,EAAE,0BAA0B,EAAE,MAAM,wBAAwB,CAAA;AACnE,OAAO,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAA"}

package/dist/hooks/session-lifecycle.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Session Lifecycle Hook — Initialize/load brain state on session events.
+ *
+ * Handles:
+ *   - Session start: load existing state or create fresh
+ *   - System prompt injection: current hierarchy + governance status
+ *
+ * P3: try/catch — never break session lifecycle
+ * P5: Config cached in closure
+ */
+import type { Logger } from "../lib/logging.js";
+import type { HiveMindConfig } from "../schemas/config.js";
+/**
+ * Creates the session lifecycle hook (system prompt transform).
+ *
+ * Injects current session context into the system prompt:
+ *   - Hierarchy state (trajectory/tactic/action)
+ *   - Governance status (LOCKED/OPEN)
+ *   - Session metrics (drift score, turn count)
+ *
+ * Budget: ≤250 tokens (~1000 chars). ADD, not REPLACE.
+ */
+export declare function createSessionLifecycleHook(log: Logger, directory: string, config: HiveMindConfig): (input: {
+    sessionID?: string;
+}, output: {
+    system: string[];
+}) => Promise<void>;
+//# sourceMappingURL=session-lifecycle.d.ts.map

package/dist/hooks/session-lifecycle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-lifecycle.d.ts","sourceRoot":"","sources":["../../src/hooks/session-lifecycle.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAA;AAC/C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAA;AAS1D;;;;;;;;;GASG;AACH,wBAAgB,0BAA0B,CACxC,GAAG,EAAE,MAAM,EACX,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,cAAc,IAMpB,OAAO;IAAE,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE,EAC7B,QAAQ;IAAE,MAAM,EAAE,MAAM,EAAE,CAAA;CAAE,KAC3B,OAAO,CAAC,IAAI,CAAC,CA0FjB"}

package/dist/hooks/session-lifecycle.js

@@ -0,0 +1,94 @@
+/**
+ * Session Lifecycle Hook — Initialize/load brain state on session events.
+ *
+ * Handles:
+ *   - Session start: load existing state or create fresh
+ *   - System prompt injection: current hierarchy + governance status
+ *
+ * P3: try/catch — never break session lifecycle
+ * P5: Config cached in closure
+ */
+import { generateAgentBehaviorPrompt } from "../schemas/config.js";
+import { createStateManager } from "../lib/persistence.js";
+import { createBrainState, generateSessionId, } from "../schemas/brain-state.js";
+import { initializePlanningDirectory } from "../lib/planning-fs.js";
+/**
+ * Creates the session lifecycle hook (system prompt transform).
+ *
+ * Injects current session context into the system prompt:
+ *   - Hierarchy state (trajectory/tactic/action)
+ *   - Governance status (LOCKED/OPEN)
+ *   - Session metrics (drift score, turn count)
+ *
+ * Budget: ≤250 tokens (~1000 chars). ADD, not REPLACE.
+ */
+export function createSessionLifecycleHook(log, directory, config) {
+    const stateManager = createStateManager(directory);
+    const BUDGET_CHARS = 1000;
+    return async (input, output) => {
+        try {
+            if (!input.sessionID)
+                return;
+            // Load or create brain state
+            let state = await stateManager.load();
+            if (!state) {
+                // First session — initialize
+                await initializePlanningDirectory(directory);
+                const sessionId = generateSessionId();
+                state = createBrainState(sessionId, config);
+                await stateManager.save(state);
+            }
+            const lines = [];
+            lines.push("<hivemind-governance>");
+            // Session status
+            lines.push(`Session: ${state.session.governance_status} | Mode: ${state.session.mode} | Governance: ${state.session.governance_mode}`);
+            // Hierarchy context
+            if (state.hierarchy.trajectory) {
+                lines.push(`Trajectory: ${state.hierarchy.trajectory}`);
+            }
+            if (state.hierarchy.tactic) {
+                lines.push(`Tactic: ${state.hierarchy.tactic}`);
+            }
+            if (state.hierarchy.action) {
+                lines.push(`Action: ${state.hierarchy.action}`);
+            }
+            // No hierarchy = prompt to declare intent
+            if (!state.hierarchy.trajectory &&
+                !state.hierarchy.tactic &&
+                !state.hierarchy.action) {
+                if (config.governance_mode === "strict") {
+                    lines.push("No intent declared. Use declare_intent to unlock the session before writing.");
+                }
+                else {
+                    lines.push("Tip: Use declare_intent to set your work focus for better tracking.");
+                }
+            }
+            // Metrics summary
+            lines.push(`Turns: ${state.metrics.turn_count} | Drift: ${state.metrics.drift_score}/100 | Files: ${state.metrics.files_touched.length}`);
+            // Drift warning
+            if (state.metrics.drift_score < 50) {
+                lines.push("⚠ High drift detected. Use map_context to re-focus.");
+            }
+            lines.push("</hivemind-governance>");
+            // Inject mandatory agent behavior configuration
+            const agentConfigPrompt = generateAgentBehaviorPrompt(config.agent_behavior);
+            lines.push("");
+            lines.push(agentConfigPrompt);
+            // Budget enforcement
+            let injection = lines.join("\n");
+            if (injection.length > BUDGET_CHARS) {
+                injection =
+                    injection.slice(0, BUDGET_CHARS - 30) +
+                        "\n</agent-configuration>";
+                await log.warn(`System injection truncated: ${lines.join("\n").length} → ${injection.length} chars`);
+            }
+            output.system.push(injection);
+            await log.debug(`Session lifecycle: injected ${injection.length} chars`);
+        }
+        catch (error) {
+            // P3: Never break session lifecycle
+            await log.error(`Session lifecycle hook error: ${error}`);
+        }
+    };
+}
+//# sourceMappingURL=session-lifecycle.js.map

package/dist/hooks/session-lifecycle.js.map

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

package/dist/hooks/tool-gate.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Tool Gate Hook — Configurable governance enforcement.
+ *
+ * Intercepts tool calls and applies governance based on mode:
+ *   - strict: blocks writes until declare_intent called
+ *   - assisted: warns but allows
+ *   - permissive: silently allows, tracks for metrics
+ *
+ * P3: try/catch — never break tool execution
+ * P5: Config cached in closure — single disk read on first call
+ */
+import type { Logger } from "../lib/logging.js";
+import type { HiveMindConfig } from "../schemas/config.js";
+export interface ToolGateResult {
+    allowed: boolean;
+    error?: string;
+    warning?: string;
+}
+/**
+ * Creates the tool gate hook.
+ *
+ * Hook factory pattern — captures config + logger + directory.
+ */
+export declare function createToolGateHook(log: Logger, directory: string, config: HiveMindConfig): (input: {
+    sessionID: string;
+    tool: string;
+}) => Promise<ToolGateResult>;
+//# sourceMappingURL=tool-gate.d.ts.map

package/dist/hooks/tool-gate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-gate.d.ts","sourceRoot":"","sources":["../../src/hooks/tool-gate.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAA;AAC/C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAA;AAqD1D,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,OAAO,CAAA;IAChB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,OAAO,CAAC,EAAE,MAAM,CAAA;CACjB;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAChC,GAAG,EAAE,MAAM,EACX,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,cAAc,IAIR,OAAO;IACnB,SAAS,EAAE,MAAM,CAAA;IACjB,IAAI,EAAE,MAAM,CAAA;CACb,KAAG,OAAO,CAAC,cAAc,CAAC,CAqH5B"}