common-memory-core 0.2.0

package/dist/pi-extension/extraction-runtime.js

@@ -0,0 +1,87 @@
+import { randomUUID } from 'node:crypto';
+import { SessionIngress } from '../v2/session.js';
+const processState = globalThis;
+export const piProcessInstance = processState.__commonMemoryPiInstance ??= randomUUID();
+/** Host lifecycle adapter. Delivery, rather than successful assistant completion, is evidence. */
+export class PiCaptureRuntime {
+    #writer;
+    ingress;
+    #sessions = new Map();
+    #abort = new AbortController();
+    #timer;
+    #stable = false;
+    #closed = false;
+    #closing;
+    #running;
+    constructor(writer, options = {}) {
+        this.#writer = writer;
+        this.ingress = new SessionIngress(writer.store, options);
+        this.#timer = setInterval(() => this.check(), 1000);
+        this.#timer.unref();
+    }
+    start(sessionId, entries) { this.bind(sessionId, entries); this.#stable = true; this.check(); }
+    input(input) { this.#writer.store.transaction(() => { const key = this.key(input.sessionId); this.#writer.store.stageInput({ ...input, sessionId: key }); this.ingress.reserve(key, 0); }); }
+    delivered(sessionId, text, timestamp, hasUnsupportedContent = false) { this.#writer.store.transaction(() => { const key = this.key(sessionId); this.#writer.store.delivered(key, text, timestamp, hasUnsupportedContent); this.ingress.reserve(key, 0); }); }
+    bind(sessionId, entries) {
+        const key = this.key(sessionId);
+        this.#writer.store.bind(key, entries, input => {
+            const turn = this.#writer.store.db.prepare("SELECT turnId FROM session_turns WHERE sessionId=? AND state='open' ORDER BY id DESC LIMIT 1").get(key);
+            this.ingress.capture(key, { id: input.entryId, turnId: turn ? String(turn.turnId) : input.entryId, ...(entries.find(e => e.id === input.entryId)?.sequence !== undefined ? { sequence: entries.find(e => e.id === input.entryId).sequence } : {}), role: 'user', text: input.text, source: input.source, scope: input.scope, observedAt: input.observedAt });
+        });
+    }
+    cancelInputs(sessionId) { this.#writer.store.cancelInputs(this.key(sessionId)); }
+    busy() { this.#stable = false; }
+    settled(sessionId, entries, state = 'settled') { this.bind(sessionId, entries); this.cancelInputs(sessionId); const key = this.key(sessionId); for (const row of this.#writer.store.db.prepare("SELECT turnId FROM session_turns WHERE sessionId=? AND state='open'").all(key))
+        this.ingress.settle(key, String(row.turnId), state); this.#stable = true; this.check(); }
+    key(sessionId) { let key = this.#sessions.get(sessionId); if (!key) {
+        key = this.ingress.open({ client: 'pi', processInstance: piProcessInstance, sessionId });
+        this.#sessions.set(sessionId, key);
+    } return key; }
+    context(sessionId, entries) {
+        const key = this.key(sessionId), turn = this.#writer.store.db.prepare("SELECT turnId FROM session_turns WHERE sessionId=? AND state='open' ORDER BY id DESC LIMIT 1").get(key);
+        if (!turn)
+            return;
+        const first = this.#writer.store.db.prepare("SELECT observedAt,scope FROM session_messages WHERE sessionId=? AND role='user' AND turn=(SELECT id FROM session_turns WHERE sessionId=? AND turnId=?) ORDER BY id LIMIT 1").get(key, key, turn.turnId);
+        if (!first)
+            return;
+        for (const e of entries)
+            if (e.timestamp >= Date.parse(String(first.observedAt)))
+                this.ingress.capture(key, { ...(e.sequence !== undefined ? { sequence: e.sequence } : {}), id: e.id, turnId: String(turn.turnId), role: e.role, text: e.text, source: 'conversation_context', scope: String(first.scope), observedAt: new Date(e.timestamp).toISOString() });
+    }
+    end(sessionId) { this.ingress.end(this.key(sessionId)); }
+    flush() { this.#writer.store.requestFlush(); this.check(); }
+    check() {
+        if (this.#closed || !this.#stable || this.#running)
+            return;
+        this.#running = this.#writer.run({ signal: this.#abort.signal }).then(result => {
+            if (result && typeof result === 'object' && 'outcome' in result && result.outcome === 'failed')
+                process.stderr.write('[common-memory] maintenance failed; inspect common-memory status for the diagnostic code.\n');
+        }).catch(() => {
+            process.stderr.write("[common-memory] maintenance failed; durable queue retained. Run common-memory status.\n");
+        }).finally(() => { this.#running = undefined; });
+    }
+    shutdown() {
+        if (this.#closing)
+            return this.#closing;
+        this.#closed = true;
+        clearInterval(this.#timer);
+        this.#abort.abort();
+        let flushFailed = false;
+        try {
+            this.#writer.store.requestFlush();
+        }
+        catch {
+            flushFailed = true;
+        }
+        return this.#closing = Promise.resolve(this.#running).then(async () => {
+            try {
+                await this.#writer.close();
+            }
+            finally {
+                if (flushFailed)
+                    throw new Error('Common Memory shutdown flush failed; resources closed');
+            }
+        });
+    }
+}
+//# sourceMappingURL=extraction-runtime.js.map

package/dist/pi-extension/extraction-runtime.js.map

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

package/dist/pi-extension/index.d.ts

@@ -0,0 +1,19 @@
+import type { ExtensionAPI } from "@earendil-works/pi-coding-agent";
+import { type CommonMemoryConfig } from "../config/config.js";
+import { PiCaptureRuntime, type SessionUserEntry } from "./extraction-runtime.js";
+export declare function createCommonMemoryPiExtension(options?: {
+    runtimeFactory?: () => PiCaptureRuntime;
+    resolveScope?: (cwd: string) => string;
+    configFactory?: () => CommonMemoryConfig | null;
+}): (pi: ExtensionAPI) => void;
+export declare function branchUsers(entries: readonly unknown[]): SessionUserEntry[];
+declare const _default: (pi: ExtensionAPI) => void;
+export default _default;
+export declare function branchContext(entries: readonly unknown[]): {
+    sequence: number;
+    id: string;
+    role: 'assistant' | 'tool';
+    text: string;
+    timestamp: number;
+}[];
+//# sourceMappingURL=index.d.ts.map

package/dist/pi-extension/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/pi-extension/index.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,YAAY,EAAoB,MAAM,iCAAiC,CAAC;AACtF,OAAO,EAAc,KAAK,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAI1E,OAAO,EAAE,gBAAgB,EAAE,KAAK,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAElF,wBAAgB,6BAA6B,CAAC,OAAO,GAAE;IAAC,cAAc,CAAC,EAAE,MAAM,gBAAgB,CAAC;IAAC,YAAY,CAAC,EAAE,CAAC,GAAG,EAAC,MAAM,KAAK,MAAM,CAAC;IAAC,aAAa,CAAC,EAAE,MAAM,kBAAkB,GAAG,IAAI,CAAA;CAAM,IACnL,IAAI,YAAY,KAAG,IAAI,CAsEhC;AACD,wBAAgB,WAAW,CAAC,OAAO,EAAC,SAAS,OAAO,EAAE,GAAE,gBAAgB,EAAE,CAOzE;6BA9Ea,YAAY,KAAG,IAAI;AAsFjC,wBAA+C;AAE/C,wBAAgB,aAAa,CAAC,OAAO,EAAC,SAAS,OAAO,EAAE,GAAE;IAAC,QAAQ,EAAC,MAAM,CAAC;IAAA,EAAE,EAAC,MAAM,CAAC;IAAA,IAAI,EAAC,WAAW,GAAC,MAAM,CAAC;IAAA,IAAI,EAAC,MAAM,CAAC;IAAA,SAAS,EAAC,MAAM,CAAA;CAAC,EAAE,CAE3I"}

package/dist/pi-extension/index.js

@@ -0,0 +1,172 @@
+import { Type } from 'typebox';
+import { MEMORY_READ_GUIDANCE, MEMORY_READ_DESCRIPTION } from '../v2/read-guidance.js';
+import { launchSessionDrain } from '../cli/session-drain.js';
+const snapshots = globalThis.__commonMemoryPiSnapshots ??= new Map();
+import { loadConfig } from "../config/config.js";
+import { createConfiguredWriter } from "../config/runtime.js";
+import { ProjectRegistry } from "../v2/registry.js";
+import { readAuthorizedMemory, renderMemoryView } from "../v2/reader.js";
+import { PiCaptureRuntime } from "./extraction-runtime.js";
+export function createCommonMemoryPiExtension(options = {}) {
+    return (pi) => {
+        let runtime;
+        let registry;
+        let config;
+        // Only a valid configuration is cached; an unconfigured host is re-checked on the next event.
+        const cfg = () => {
+            config ??= (options.configFactory ? options.configFactory() : loadConfig()) ?? undefined;
+            if (!config)
+                throw new Error("Common Memory is not configured");
+            registry ??= new ProjectRegistry(config.dataRoot);
+            return config;
+        };
+        const get = () => {
+            if (runtime)
+                return runtime;
+            if (options.runtimeFactory)
+                return runtime = options.runtimeFactory();
+            // Pi only captures delivered user turns; without permission to disclose them there is nothing to capture.
+            const current = cfg();
+            if (!current.disclosure.allowedProvenance.includes("user_explicit"))
+                throw new Error("Delivered user evidence is not authorized for disclosure");
+            runtime = new PiCaptureRuntime(createConfiguredWriter(current), current.sessionCache);
+            if (!options.configFactory)
+                launchSessionDrain();
+            return runtime;
+        };
+        const safe = (fn) => { try {
+            fn(get());
+        }
+        catch {
+            process.stderr.write("[common-memory] capture unavailable; inspect common-memory status.\n");
+        } };
+        const bind = (ctx) => safe(r => r.bind(ctx.sessionManager.getSessionId(), branchUsers(ctx.sessionManager.getBranch())));
+        const snapshotKey = (ctx) => `${cfg().dataRoot}:${ctx.sessionManager.getSessionId()}`;
+        const read = (ctx, contextId) => {
+            const current = cfg(), project = registry.resolve(ctx.cwd);
+            const contexts = ['global', ...(project ? [`project:${project.id}`] : [])].filter(scope => current.disclosure.allowedScopes.includes(scope));
+            if (contextId !== undefined && !contexts.includes(contextId))
+                throw new Error('CONTEXT_UNAVAILABLE');
+            return readAuthorizedMemory({ dataRoot: current.dataRoot, contexts: contextId ? [contextId] : contexts });
+        };
+        pi.on("session_start", (event, ctx) => {
+            try {
+                const key = snapshotKey(ctx);
+                if (!snapshots.has(key))
+                    snapshots.set(key, event.reason === 'startup' ? renderMemoryView(read(ctx)) : 'Automatic memory read was not requested for this session lifecycle action. ' + MEMORY_READ_GUIDANCE);
+            }
+            catch {
+                process.stderr.write('[common-memory] startup read unavailable.\n');
+            }
+            safe(r => r.start(ctx.sessionManager.getSessionId(), branchUsers(ctx.sessionManager.getBranch())));
+        });
+        pi.registerTool({ name: 'memory_read', label: 'Read memory', description: MEMORY_READ_DESCRIPTION, promptSnippet: 'Read authorized personal and project memory when needed.', promptGuidelines: [MEMORY_READ_GUIDANCE], parameters: Type.Object({ contextId: Type.Optional(Type.String({ maxLength: 160 })) }), execute: async (_id, input, _signal, _update, ctx) => { const view = read(ctx, input.contextId); return { content: [{ type: 'text', text: renderMemoryView(view) }], details: view }; } });
+        pi.on("input", (event, ctx) => {
+            safe(r => { if (!ctx.hasPendingMessages())
+                r.cancelInputs(ctx.sessionManager.getSessionId()); const project = registry?.resolve(ctx.cwd); const scope = options.resolveScope?.(ctx.cwd) ?? (project ? `project:${project.id}` : "global"); r.input({ sessionId: ctx.sessionManager.getSessionId(), text: event.text, source: event.source, scope, parentEntryId: ctx.sessionManager.getLeafId(), hasUnsupportedContent: (event.images?.length ?? 0) > 0, ...(event.streamingBehavior ? { streamingBehavior: event.streamingBehavior } : {}) }); });
+            return { action: "continue" };
+        });
+        // Reading is independent of capture: no Writer, model or API key is needed to disclose current memory.
+        pi.on("before_agent_start", (event, ctx) => {
+            try {
+                const key = snapshotKey(ctx);
+                // Freeze only our appended block; the host owns the current base system prompt.
+                if (!snapshots.has(key))
+                    snapshots.set(key, renderMemoryView(read(ctx)));
+                return { systemPrompt: `${event.systemPrompt}\n\n## Common Memory\n${snapshots.get(key)}\n\n${MEMORY_READ_GUIDANCE}` };
+            }
+            catch {
+                process.stderr.write("[common-memory] memory unavailable for this turn; inspect common-memory status.\n");
+                return undefined;
+            }
+        });
+        pi.on("agent_start", () => safe(r => r.busy()));
+        pi.on("message_end", (event, ctx) => {
+            if (event.message.role !== "user") {
+                const sessionId = ctx.sessionManager.getSessionId();
+                setImmediate(() => { if (runtime && ctx.sessionManager.getSessionId() === sessionId)
+                    safe(r => { r.bind(sessionId, branchUsers(ctx.sessionManager.getBranch())); r.context(sessionId, branchContext(ctx.sessionManager.getBranch())); }); });
+                return;
+            }
+            const text = messageText(event.message.content);
+            if (!text)
+                return;
+            const unsupported = hasNonTextContent(event.message.content);
+            safe(r => r.delivered(ctx.sessionManager.getSessionId(), text, event.message.timestamp, unsupported));
+            // Pi appends its stable entry after this callback, so binding is deliberately deferred.
+            const sessionId = ctx.sessionManager.getSessionId();
+            setImmediate(() => { if (runtime && ctx.sessionManager.getSessionId() === sessionId)
+                bind(ctx); });
+        });
+        pi.on("agent_settled", (_event, ctx) => safe(r => { r.bind(ctx.sessionManager.getSessionId(), branchUsers(ctx.sessionManager.getBranch())); r.context(ctx.sessionManager.getSessionId(), branchContext(ctx.sessionManager.getBranch())); r.settled(ctx.sessionManager.getSessionId(), branchUsers(ctx.sessionManager.getBranch()), branchInterrupted(ctx.sessionManager.getBranch()) ? 'interrupted' : 'settled'); }));
+        pi.on("session_before_switch", (_event, ctx) => { bind(ctx); safe(r => { r.cancelInputs(ctx.sessionManager.getSessionId()); }); });
+        pi.on("session_before_compact", (_event, ctx) => { bind(ctx); });
+        pi.on("session_before_tree", (_event, ctx) => { bind(ctx); safe(r => { r.cancelInputs(ctx.sessionManager.getSessionId()); }); });
+        pi.on("session_shutdown", async (event, ctx) => { if (event.reason === 'quit') {
+            try {
+                snapshots.delete(snapshotKey(ctx));
+            }
+            catch { /* unconfigured */ }
+        } if (runtime) {
+            try {
+                bind(ctx);
+                runtime.context(ctx.sessionManager.getSessionId(), branchContext(ctx.sessionManager.getBranch()));
+                runtime.cancelInputs(ctx.sessionManager.getSessionId());
+                if (event.reason === 'quit') {
+                    runtime.end(ctx.sessionManager.getSessionId());
+                    launchSessionDrain();
+                }
+            }
+            finally {
+                try {
+                    await runtime.shutdown();
+                }
+                finally {
+                    runtime = undefined;
+                    config = undefined;
+                    registry = undefined;
+                }
+            }
+        } });
+        pi.registerCommand("memory-refresh", { description: "Replace the frozen Common Memory snapshot", handler: async (_args, ctx) => { config = undefined; registry = undefined; const body = renderMemoryView(read(ctx)); snapshots.set(snapshotKey(ctx), body); } });
+        pi.registerCommand("memory-flush", { description: "Queue Common Memory maintenance", handler: async (_args, ctx) => { bind(ctx); safe(r => r.flush()); } });
+    };
+}
+export function branchUsers(entries) {
+    return entries.flatMap((value, sequence) => {
+        if (!value || typeof value !== "object")
+            return [];
+        const entry = value;
+        const message = entry.message;
+        if (entry.type !== "message" || typeof entry.id !== "string" || message?.role !== "user" || typeof message.timestamp !== "number")
+            return [];
+        const text = messageText(message.content);
+        return text ? [{ id: entry.id, text, timestamp: message.timestamp, sequence }] : [];
+    });
+}
+function messageText(content) {
+    if (typeof content === "string")
+        return content;
+    if (!Array.isArray(content))
+        return "";
+    const text = content.flatMap(part => part && typeof part === "object" && part.type === "text" && typeof part.text === "string" ? [part.text] : []).join("\n");
+    return text || (hasNonTextContent(content) ? "[unsupported non-text user content]" : "");
+}
+function hasNonTextContent(content) { return typeof content !== "string" && (!Array.isArray(content) || content.some(part => !part || typeof part !== "object" || part.type !== "text" || typeof part.text !== "string")); }
+export default createCommonMemoryPiExtension();
+export function branchContext(entries) {
+    return entries.flatMap((value, sequence) => { if (!value || typeof value !== 'object')
+        return []; const e = value, m = e.message; if (e.type !== 'message' || typeof e.id !== 'string' || !m || !['assistant', 'toolResult'].includes(String(m.role)) || typeof m.timestamp !== 'number')
+        return []; const text = messageText(m.content); return text ? [{ sequence, id: e.id, role: m.role === 'assistant' ? 'assistant' : 'tool', text, timestamp: m.timestamp }] : []; });
+}
+function branchInterrupted(entries) {
+    for (const value of [...entries].reverse()) {
+        if (!value || typeof value !== 'object')
+            continue;
+        const m = value.message;
+        if (m?.role === 'assistant')
+            return m.stopReason === 'aborted' || m.stopReason === 'error';
+    }
+    return false;
+}
+//# sourceMappingURL=index.js.map

package/dist/pi-extension/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/pi-extension/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,SAAS,CAAC;AAC/B,OAAO,EAAE,oBAAoB,EAAE,uBAAuB,EAAE,MAAM,wBAAwB,CAAC;AACvF,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAC7D,MAAM,SAAS,GAAI,UAAkF,CAAC,yBAAyB,KAAK,IAAI,GAAG,EAAiB,CAAC;AAE7J,OAAO,EAAE,UAAU,EAA2B,MAAM,qBAAqB,CAAC;AAC1E,OAAO,EAAE,sBAAsB,EAAE,MAAM,sBAAsB,CAAC;AAC9D,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,EAAE,oBAAoB,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACzE,OAAO,EAAE,gBAAgB,EAAyB,MAAM,yBAAyB,CAAC;AAElF,MAAM,UAAU,6BAA6B,CAAC,UAA6I,EAAE;IAC3L,OAAO,CAAC,EAAgB,EAAQ,EAAE;QAChC,IAAI,OAAqC,CAAC;QAC1C,IAAI,QAAqC,CAAC;QAC1C,IAAI,MAAsC,CAAC;QAC3C,8FAA8F;QAC9F,MAAM,GAAG,GAAG,GAAuB,EAAE;YACnC,MAAM,KAAK,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC,CAAC,OAAO,CAAC,aAAa,EAAE,CAAC,CAAC,CAAC,UAAU,EAAE,CAAC,IAAI,SAAS,CAAC;YACzF,IAAI,CAAC,MAAM;gBAAE,MAAM,IAAI,KAAK,CAAC,iCAAiC,CAAC,CAAC;YAChE,QAAQ,KAAK,IAAI,eAAe,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;YAClD,OAAO,MAAM,CAAC;QAChB,CAAC,CAAC;QACF,MAAM,GAAG,GAAG,GAAqB,EAAE;YACjC,IAAI,OAAO;gBAAE,OAAO,OAAO,CAAC;YAC5B,IAAI,OAAO,CAAC,cAAc;gBAAE,OAAO,OAAO,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC;YACtE,0GAA0G;YAC1G,MAAM,OAAO,GAAG,GAAG,EAAE,CAAC;YACtB,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,iBAAiB,CAAC,QAAQ,CAAC,eAAe,CAAC;gBAAE,MAAM,IAAI,KAAK,CAAC,0DAA0D,CAAC,CAAC;YACjJ,OAAO,GAAG,IAAI,gBAAgB,CAAC,sBAAsB,CAAC,OAAO,CAAC,EAAC,OAAO,CAAC,YAAY,CAAC,CAAC;YACrF,IAAG,CAAC,OAAO,CAAC,aAAa;gBAAC,kBAAkB,EAAE,CAAC;YAC/C,OAAO,OAAO,CAAC;QACjB,CAAC,CAAC;QACF,MAAM,IAAI,GAAG,CAAC,EAA6B,EAAQ,EAAE,GAAG,IAAI,CAAC;YAAC,EAAE,CAAC,GAAG,EAAE,CAAC,CAAC;QAAC,CAAC;QAAC,MAAM,CAAC;YAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,sEAAsE,CAAC,CAAC;QAAC,CAAC,CAAC,CAAC,CAAC;QACrL,MAAM,IAAI,GAAG,CAAC,GAAoB,EAAQ,EAAE,CAAC,IAAI,CAAC,CAAC,CAAA,EAAE,CAAA,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,cAAc,CAAC,YAAY,EAAE,EAAC,WAAW,CAAC,GAAG,CAAC,cAAc,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC,CAAC;QAC5I,MAAM,WAAW,GAAC,CAAC,GAAoB,EAAC,EAAE,CAAA,GAAG,GAAG,EAAE,CAAC,QAAQ,IAAI,GAAG,CAAC,cAAc,CAAC,YAAY,EAAE,EAAE,CAAC;QACnG,MAAM,IAAI,GAAC,CAAC,GAAoB,EAAC,SAAiB,EAAC,EAAE;YACnD,MAAM,OAAO,GAAC,GAAG,EAAE,EAAC,OAAO,GAAC,QAAS,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;YACvD,MAAM,QAAQ,GAAC,CAAC,QAAQ,EAAC,GAAG,CAAC,OAAO,CAAA,CAAC,CAAA,CAAC,WAAW,OAAO,CAAC,EAAE,EAAE,CAAC,CAAA,CAAC,CAAA,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAA,EAAE,CAAA,OAAO,CAAC,UAAU,CAAC,aAAa,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC;YACpI,IAAG,SAAS,KAAG,SAAS,IAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC,SAAS,CAAC;gBAAC,MAAM,IAAI,KAAK,CAAC,qBAAqB,CAAC,CAAC;YAC/F,OAAO,oBAAoB,CAAC,EAAC,QAAQ,EAAC,OAAO,CAAC,QAAQ,EAAC,QAAQ,EAAC,SAAS,CAAA,CAAC,CAAA,CAAC,SAAS,CAAC,CAAA,CAAC,CAAA,QAAQ,EAAC,CAAC,CAAC;QACnG,CAAC,CAAC;QACF,EAAE,CAAC,EAAE,CAAC,eAAe,EAAE,CAAC,KAAK,EAAC,GAAG,EAAC,EAAE;YAClC,IAAI,CAAC;gBAAA,MAAM,GAAG,GAAC,WAAW,CAAC,GAAG,CAAC,CAAC;gBAAA,IAAG,CAAC,SAAS,CAAC,GAAG,CAAC,GAAG,CAAC;oBAAC,SAAS,CAAC,GAAG,CAAC,GAAG,EAAC,KAAK,CAAC,MAAM,KAAG,SAAS,CAAA,CAAC,CAAA,gBAAgB,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAA,CAAC,CAAA,6EAA6E,GAAC,oBAAoB,CAAC,CAAC;YAAA,CAAC;YAAA,MAAM,CAAC;gBAAA,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,6CAA6C,CAAC,CAAC;YAAA,CAAC;YAC/S,IAAI,CAAC,CAAC,CAAA,EAAE,CAAA,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,cAAc,CAAC,YAAY,EAAE,EAAC,WAAW,CAAC,GAAG,CAAC,cAAc,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC,CAAC;QAClG,CAAC,CAAC,CAAC;QACH,EAAE,CAAC,YAAY,CAAC,EAAC,IAAI,EAAC,aAAa,EAAC,KAAK,EAAC,aAAa,EAAC,WAAW,EAAC,uBAAuB,EAAC,aAAa,EAAC,0DAA0D,EAAC,gBAAgB,EAAC,CAAC,oBAAoB,CAAC,EAAC,UAAU,EAAC,IAAI,CAAC,MAAM,CAAC,EAAC,SAAS,EAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,EAAC,SAAS,EAAC,GAAG,EAAC,CAAC,CAAC,EAAC,CAAC,EAAC,OAAO,EAAC,KAAK,EAAC,GAAG,EAAC,KAAK,EAAC,OAAO,EAAC,OAAO,EAAC,GAAG,EAAC,EAAE,GAAC,MAAM,IAAI,GAAC,IAAI,CAAC,GAAG,EAAC,KAAK,CAAC,SAAS,CAAC,CAAC,CAAA,OAAO,EAAC,OAAO,EAAC,CAAC,EAAC,IAAI,EAAC,MAAM,EAAC,IAAI,EAAC,gBAAgB,CAAC,IAAI,CAAC,EAAC,CAAC,EAAC,OAAO,EAAC,IAAI,EAAC,CAAC,CAAA,CAAC,EAAC,CAAC,CAAC;QAC/b,EAAE,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,KAAK,EAAC,GAAG,EAAC,EAAE;YAC1B,IAAI,CAAC,CAAC,CAAA,EAAE,GAAE,IAAG,CAAC,GAAG,CAAC,kBAAkB,EAAE;gBAAC,CAAC,CAAC,YAAY,CAAC,GAAG,CAAC,cAAc,CAAC,YAAY,EAAE,CAAC,CAAC,CAAC,MAAM,OAAO,GAAG,QAAQ,EAAE,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,MAAM,KAAK,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,WAAW,OAAO,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,EAAC,SAAS,EAAC,GAAG,CAAC,cAAc,CAAC,YAAY,EAAE,EAAC,IAAI,EAAC,KAAK,CAAC,IAAI,EAAC,MAAM,EAAC,KAAK,CAAC,MAAM,EAAC,KAAK,EAAC,aAAa,EAAC,GAAG,CAAC,cAAc,CAAC,SAAS,EAAE,EAAC,qBAAqB,EAAC,CAAC,KAAK,CAAC,MAAM,EAAE,MAAM,IAAE,CAAC,CAAC,GAAC,CAAC,EAAC,GAAG,CAAC,KAAK,CAAC,iBAAiB,CAAA,CAAC,CAAA,EAAC,iBAAiB,EAAC,KAAK,CAAC,iBAAiB,EAAC,CAAA,CAAC,CAAA,EAAE,CAAC,EAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;YACvf,OAAO,EAAC,MAAM,EAAC,UAAU,EAAC,CAAC;QAC7B,CAAC,CAAC,CAAC;QACH,uGAAuG;QACvG,EAAE,CAAC,EAAE,CAAC,oBAAoB,EAAE,CAAC,KAAK,EAAC,GAAG,EAAC,EAAE;YACvC,IAAI,CAAC;gBACH,MAAM,GAAG,GAAC,WAAW,CAAC,GAAG,CAAC,CAAC;gBAC3B,gFAAgF;gBAChF,IAAG,CAAC,SAAS,CAAC,GAAG,CAAC,GAAG,CAAC;oBAAC,SAAS,CAAC,GAAG,CAAC,GAAG,EAAC,gBAAgB,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;gBACtE,OAAO,EAAC,YAAY,EAAC,GAAG,KAAK,CAAC,YAAY,yBAAyB,SAAS,CAAC,GAAG,CAAC,GAAG,CAAC,OAAO,oBAAoB,EAAE,EAAC,CAAC;YACtH,CAAC;YAAC,MAAM,CAAC;gBAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,mFAAmF,CAAC,CAAC;gBAAC,OAAO,SAAS,CAAC;YAAC,CAAC;QAC1I,CAAC,CAAC,CAAC;QACH,EAAE,CAAC,EAAE,CAAC,aAAa,EAAE,GAAE,EAAE,CAAA,IAAI,CAAC,CAAC,CAAA,EAAE,CAAA,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;QAC5C,EAAE,CAAC,EAAE,CAAC,aAAa,EAAE,CAAC,KAAK,EAAC,GAAG,EAAC,EAAE;YAChC,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;gBAClC,MAAM,SAAS,GAAC,GAAG,CAAC,cAAc,CAAC,YAAY,EAAE,CAAC;gBAClD,YAAY,CAAC,GAAE,EAAE,GAAC,IAAG,OAAO,IAAE,GAAG,CAAC,cAAc,CAAC,YAAY,EAAE,KAAG,SAAS;oBAAC,IAAI,CAAC,CAAC,CAAA,EAAE,GAAC,CAAC,CAAC,IAAI,CAAC,SAAS,EAAC,WAAW,CAAC,GAAG,CAAC,cAAc,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC,CAAA,CAAC,CAAC,OAAO,CAAC,SAAS,EAAC,aAAa,CAAC,GAAG,CAAC,cAAc,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC,CAAA,CAAC,CAAC,CAAC,CAAA,CAAC,CAAC,CAAC;gBAC5N,OAAO;YACT,CAAC;YACD,MAAM,IAAI,GAAG,WAAW,CAAC,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;YAAC,IAAI,CAAC,IAAI;gBAAE,OAAO;YACnE,MAAM,WAAW,GAAC,iBAAiB,CAAC,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;YAC3D,IAAI,CAAC,CAAC,CAAA,EAAE,CAAA,CAAC,CAAC,SAAS,CAAC,GAAG,CAAC,cAAc,CAAC,YAAY,EAAE,EAAC,IAAI,EAAC,KAAK,CAAC,OAAO,CAAC,SAAS,EAAC,WAAW,CAAC,CAAC,CAAC;YACjG,wFAAwF;YACxF,MAAM,SAAS,GAAC,GAAG,CAAC,cAAc,CAAC,YAAY,EAAE,CAAC;YAClD,YAAY,CAAC,GAAE,EAAE,GAAE,IAAG,OAAO,IAAI,GAAG,CAAC,cAAc,CAAC,YAAY,EAAE,KAAG,SAAS;gBAAE,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QAChG,CAAC,CAAC,CAAC;QACH,EAAE,CAAC,EAAE,CAAC,eAAe,EAAE,CAAC,MAAM,EAAC,GAAG,EAAC,EAAE,CAAA,IAAI,CAAC,CAAC,CAAA,EAAE,GAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,cAAc,CAAC,YAAY,EAAE,EAAC,WAAW,CAAC,GAAG,CAAC,cAAc,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC,CAAA,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC,YAAY,EAAE,EAAC,aAAa,CAAC,GAAG,CAAC,cAAc,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC,CAAA,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC,YAAY,EAAE,EAAC,WAAW,CAAC,GAAG,CAAC,cAAc,CAAC,SAAS,EAAE,CAAC,EAAC,iBAAiB,CAAC,GAAG,CAAC,cAAc,CAAC,SAAS,EAAE,CAAC,CAAA,CAAC,CAAA,aAAa,CAAA,CAAC,CAAA,SAAS,CAAC,CAAC,CAAA,CAAC,CAAC,CAAC,CAAC;QACtY,EAAE,CAAC,EAAE,CAAC,uBAAuB,EAAE,CAAC,MAAM,EAAC,GAAG,EAAC,EAAE,GAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAA,IAAI,CAAC,CAAC,CAAA,EAAE,GAAC,CAAC,CAAC,YAAY,CAAC,GAAG,CAAC,cAAc,CAAC,YAAY,EAAE,CAAC,CAAC,CAAA,CAAC,CAAC,CAAC,CAAA,CAAC,CAAC,CAAC;QACzH,EAAE,CAAC,EAAE,CAAC,wBAAwB,EAAE,CAAC,MAAM,EAAC,GAAG,EAAC,EAAE,GAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAA,CAAC,CAAC,CAAC;QAC5D,EAAE,CAAC,EAAE,CAAC,qBAAqB,EAAE,CAAC,MAAM,EAAC,GAAG,EAAC,EAAE,GAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAA,IAAI,CAAC,CAAC,CAAA,EAAE,GAAC,CAAC,CAAC,YAAY,CAAC,GAAG,CAAC,cAAc,CAAC,YAAY,EAAE,CAAC,CAAC,CAAA,CAAC,CAAC,CAAC,CAAA,CAAC,CAAC,CAAC;QACvH,EAAE,CAAC,EAAE,CAAC,kBAAkB,EAAE,KAAK,EAAE,KAAK,EAAC,GAAG,EAAC,EAAE,GAAE,IAAG,KAAK,CAAC,MAAM,KAAG,MAAM,EAAC,CAAC;YAAA,IAAG,CAAC;gBAAA,SAAS,CAAC,MAAM,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC;YAAA,CAAC;YAAA,MAAK,CAAC,CAAA,kBAAkB,CAAA,CAAC;QAAA,CAAC,CAAC,IAAG,OAAO,EAAC,CAAC;YAAA,IAAI,CAAC;gBAAC,IAAI,CAAC,GAAG,CAAC,CAAC;gBAAA,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC,YAAY,EAAE,EAAC,aAAa,CAAC,GAAG,CAAC,cAAc,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC;gBAAA,OAAO,CAAC,YAAY,CAAC,GAAG,CAAC,cAAc,CAAC,YAAY,EAAE,CAAC,CAAC;gBAAA,IAAG,KAAK,CAAC,MAAM,KAAG,MAAM,EAAC,CAAC;oBAAA,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,cAAc,CAAC,YAAY,EAAE,CAAC,CAAC;oBAAA,kBAAkB,EAAE,CAAC;gBAAA,CAAC;YAAC,CAAC;oBAAS,CAAC;gBAAC,IAAI,CAAC;oBAAC,MAAM,OAAO,CAAC,QAAQ,EAAE,CAAC;gBAAC,CAAC;wBAAS,CAAC;oBAAC,OAAO,GAAC,SAAS,CAAC;oBAAA,MAAM,GAAC,SAAS,CAAC;oBAAA,QAAQ,GAAC,SAAS,CAAC;gBAAC,CAAC;YAAC,CAAC;QAAA,CAAC,CAAC,CAAC,CAAC,CAAC;QACxhB,EAAE,CAAC,eAAe,CAAC,gBAAgB,EAAC,EAAC,WAAW,EAAC,2CAA2C,EAAC,OAAO,EAAC,KAAK,EAAE,KAAK,EAAC,GAAG,EAAC,EAAE,GAAC,MAAM,GAAC,SAAS,CAAC,CAAA,QAAQ,GAAC,SAAS,CAAC,CAAA,MAAM,IAAI,GAAC,gBAAgB,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAA,SAAS,CAAC,GAAG,CAAC,WAAW,CAAC,GAAG,CAAC,EAAC,IAAI,CAAC,CAAC,CAAA,CAAC,EAAC,CAAC,CAAC;QAC7O,EAAE,CAAC,eAAe,CAAC,cAAc,EAAC,EAAC,WAAW,EAAC,iCAAiC,EAAC,OAAO,EAAC,KAAK,EAAE,KAAK,EAAC,GAAG,EAAC,EAAE,GAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAA,IAAI,CAAC,CAAC,CAAA,EAAE,CAAA,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC,CAAA,CAAC,EAAC,CAAC,CAAC;IAChJ,CAAC,CAAC;AACJ,CAAC;AACD,MAAM,UAAU,WAAW,CAAC,OAA0B;IACpD,OAAO,OAAO,CAAC,OAAO,CAAC,CAAC,KAAK,EAAC,QAAQ,EAAC,EAAE;QACvC,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ;YAAE,OAAO,EAAE,CAAC;QACnD,MAAM,KAAK,GAAC,KAA+B,CAAC;QAAC,MAAM,OAAO,GAAC,KAAK,CAAC,OAA6C,CAAC;QAC/G,IAAG,KAAK,CAAC,IAAI,KAAG,SAAS,IAAI,OAAO,KAAK,CAAC,EAAE,KAAG,QAAQ,IAAI,OAAO,EAAE,IAAI,KAAG,MAAM,IAAI,OAAO,OAAO,CAAC,SAAS,KAAG,QAAQ;YAAE,OAAO,EAAE,CAAC;QACpI,MAAM,IAAI,GAAC,WAAW,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;QAAC,OAAO,IAAI,CAAC,CAAC,CAAC,CAAC,EAAC,EAAE,EAAC,KAAK,CAAC,EAAE,EAAC,IAAI,EAAC,SAAS,EAAC,OAAO,CAAC,SAAS,EAAC,QAAQ,EAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IACxH,CAAC,CAAC,CAAC;AACL,CAAC;AACD,SAAS,WAAW,CAAC,OAAe;IAClC,IAAG,OAAO,OAAO,KAAG,QAAQ;QAAE,OAAO,OAAO,CAAC;IAC7C,IAAG,CAAC,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC;QAAE,OAAO,EAAE,CAAC;IACtC,MAAM,IAAI,GAAC,OAAO,CAAC,OAAO,CAAC,IAAI,CAAA,EAAE,CAAA,IAAI,IAAI,OAAO,IAAI,KAAG,QAAQ,IAAI,IAAI,CAAC,IAAI,KAAG,MAAM,IAAI,OAAO,IAAI,CAAC,IAAI,KAAG,QAAQ,CAAA,CAAC,CAAA,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA,CAAC,CAAA,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAChJ,OAAO,IAAI,IAAI,CAAC,iBAAiB,CAAC,OAAO,CAAC,CAAA,CAAC,CAAA,qCAAqC,CAAA,CAAC,CAAA,EAAE,CAAC,CAAC;AACvF,CAAC;AACD,SAAS,iBAAiB,CAAC,OAAe,IAAY,OAAO,OAAO,OAAO,KAAG,QAAQ,IAAI,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,IAAI,CAAA,EAAE,CAAA,CAAC,IAAI,IAAI,OAAO,IAAI,KAAG,QAAQ,IAAI,IAAI,CAAC,IAAI,KAAG,MAAM,IAAI,OAAO,IAAI,CAAC,IAAI,KAAG,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC;AAClO,eAAe,6BAA6B,EAAE,CAAC;AAE/C,MAAM,UAAU,aAAa,CAAC,OAA0B;IACtD,OAAO,OAAO,CAAC,OAAO,CAAC,CAAC,KAAK,EAAC,QAAQ,EAAC,EAAE,GAAC,IAAG,CAAC,KAAK,IAAE,OAAO,KAAK,KAAG,QAAQ;QAAC,OAAO,EAAE,CAAC,CAAA,MAAM,CAAC,GAAC,KAA+B,EAAC,CAAC,GAAC,CAAC,CAAC,OAA2C,CAAC,CAAA,IAAG,CAAC,CAAC,IAAI,KAAG,SAAS,IAAE,OAAO,CAAC,CAAC,EAAE,KAAG,QAAQ,IAAE,CAAC,CAAC,IAAE,CAAC,CAAC,WAAW,EAAC,YAAY,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAE,OAAO,CAAC,CAAC,SAAS,KAAG,QAAQ;QAAC,OAAO,EAAE,CAAC,CAAA,MAAM,IAAI,GAAC,WAAW,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAA,OAAO,IAAI,CAAA,CAAC,CAAA,CAAC,EAAC,QAAQ,EAAC,EAAE,EAAC,CAAC,CAAC,EAAE,EAAC,IAAI,EAAC,CAAC,CAAC,IAAI,KAAG,WAAW,CAAA,CAAC,CAAA,WAAoB,CAAA,CAAC,CAAA,MAAe,EAAC,IAAI,EAAC,SAAS,EAAC,CAAC,CAAC,SAAS,EAAC,CAAC,CAAA,CAAC,CAAA,EAAE,CAAC,CAAA,CAAC,CAAC,CAAC;AACre,CAAC;AAED,SAAS,iBAAiB,CAAC,OAA0B;IACnD,KAAI,MAAM,KAAK,IAAI,CAAC,GAAG,OAAO,CAAC,CAAC,OAAO,EAAE,EAAC,CAAC;QAAA,IAAG,CAAC,KAAK,IAAE,OAAO,KAAK,KAAG,QAAQ;YAAC,SAAS;QAAA,MAAM,CAAC,GAAE,KAAsD,CAAC,OAAO,CAAC;QAAA,IAAG,CAAC,EAAE,IAAI,KAAG,WAAW;YAAC,OAAO,CAAC,CAAC,UAAU,KAAG,SAAS,IAAE,CAAC,CAAC,UAAU,KAAG,OAAO,CAAC;IAAA,CAAC;IAAA,OAAO,KAAK,CAAC;AAChQ,CAAC"}

package/dist/v2/canonical.d.ts

@@ -0,0 +1,53 @@
+export interface Section {
+    ref: string;
+    title: string;
+    body: string;
+}
+export interface DocumentSnapshot {
+    target: string;
+    path: string;
+    content: string;
+    hash: string;
+    sections: Section[];
+}
+export interface SectionOperation {
+    op: 'put_section' | 'remove_section';
+    target: string;
+    section: string | null;
+    title?: string;
+    body?: string;
+}
+export declare function digest(content: string): string;
+export declare function syncDirectory(path: string): void;
+/** Reject symlinks in every existing ancestor, including the configured root. */
+export declare function safeDirectory(path: string): void;
+export declare function readRegular(path: string, options?: {
+    createParents?: boolean;
+}): string | null;
+export declare function atomicWrite(path: string, content: string): void;
+export declare function targetInfo(target: string): {
+    relative: string;
+    title: string;
+};
+export interface CanonicalStoreOptions {
+    hardLimitBytes?: number;
+    checkpoint?: (phase: string) => void;
+}
+export declare class CanonicalStore {
+    #private;
+    readonly root: string;
+    readonly hardLimitBytes: number;
+    constructor(dataRoot: string, options?: CanonicalStoreOptions);
+    snapshot(projectIds?: string[]): DocumentSnapshot[];
+    apply(snapshot: DocumentSnapshot[], operations: SectionOperation[]): Map<string, string>;
+    commit(snapshot: DocumentSnapshot[], updates: Map<string, string>, receipt: {
+        id: string;
+        [key: string]: unknown;
+    }, beforePublish?: () => void): void;
+    recover(): void;
+    receipts(): {
+        id: string;
+        [key: string]: unknown;
+    }[];
+}
+//# sourceMappingURL=canonical.d.ts.map

package/dist/v2/canonical.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"canonical.d.ts","sourceRoot":"","sources":["../../src/v2/canonical.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,OAAO;IAAG,GAAG,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE;AACrE,MAAM,WAAW,gBAAgB;IAAG,MAAM,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,OAAO,EAAE,CAAA;CAAE;AACtH,MAAM,WAAW,gBAAgB;IAAG,EAAE,EAAE,aAAa,GAAG,gBAAgB,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE;AAGjJ,wBAAgB,MAAM,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAA+D;AAC9G,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAgI;AACjL,iFAAiF;AACjF,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAKhD;AAWD,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,GAAE;IAAE,aAAa,CAAC,EAAE,OAAO,CAAA;CAAO,GAAG,MAAM,GAAG,IAAI,CAMlG;AACD,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAI/D;AAwBD,wBAAgB,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAK9E;AACD,MAAM,WAAW,qBAAqB;IAAG,cAAc,CAAC,EAAE,MAAM,CAAC;IAAC,UAAU,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAA;CAAE;AACxG,qBAAa,cAAc;;IACzB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;gBAEpB,QAAQ,EAAE,MAAM,EAAE,OAAO,GAAE,qBAA0B;IACjE,QAAQ,CAAC,UAAU,GAAE,MAAM,EAAO,GAAG,gBAAgB,EAAE;IAMvD,KAAK,CAAC,QAAQ,EAAE,gBAAgB,EAAE,EAAE,UAAU,EAAE,gBAAgB,EAAE,GAAG,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC;IAsBxF,MAAM,CAAC,QAAQ,EAAE,gBAAgB,EAAE,EAAE,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,OAAO,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;KAAE,EAAE,aAAa,GAAE,MAAM,IAAe,GAAG,IAAI;IAe/J,OAAO,IAAI,IAAI;IAqBf,QAAQ,IAAI;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;KAAE,EAAE;CAIrD"}