crbro-memory 1.6.1 → 1.8.0

package/dist/sync/git.js

@@ -0,0 +1,178 @@
+"use strict";
+// ─── CRBRO Shared Memory: the git transport ──────────────────────
+//
+// Git is the whole backend. No service to run, no account to create, no bill:
+// a private repository is already storage, history, access control and a merge
+// engine, and the user picks where it lives.
+//
+// Two things about running git from inside an MCP server matter more than the
+// commands themselves. It must never wait for a human — there is no terminal
+// on the other end of stdio, so a credential prompt would hang the assistant
+// forever. And it must never rewrite what it stores: git on Windows converts
+// line endings by default, which turns one appended line into two different
+// lines on two machines, and the logs here are append-only.
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GITIGNORE = exports.GITATTRIBUTES = void 0;
+exports.git = git;
+exports.gitAvailable = gitAvailable;
+exports.hardenRepo = hardenRepo;
+exports.initSpace = initSpace;
+exports.cloneSpace = cloneSpace;
+exports.syncSpace = syncSpace;
+const node_child_process_1 = require("node:child_process");
+const node_fs_1 = require("node:fs");
+const node_path_1 = __importDefault(require("node:path"));
+/**
+ * Everything that could make git stop and ask a person something, turned off.
+ * Without this the server hangs on the first private repository it meets.
+ */
+const SILENT_ENV = {
+    GIT_TERMINAL_PROMPT: '0',
+    GIT_ASKPASS: '',
+    SSH_ASKPASS: '',
+    GIT_SSH_COMMAND: 'ssh -o BatchMode=yes -o StrictHostKeyChecking=accept-new',
+    GCM_INTERACTIVE: 'never',
+};
+function classify(stderr) {
+    const s = stderr.toLowerCase();
+    if (s.includes('could not resolve host') || s.includes('unable to access') ||
+        s.includes('network is unreachable') || s.includes('operation timed out'))
+        return 'offline';
+    if (s.includes('authentication failed') || s.includes('permission denied') ||
+        s.includes('could not read username') || s.includes('terminal prompts disabled'))
+        return 'auth';
+    if (s.includes('conflict'))
+        return 'conflict';
+    return undefined;
+}
+function git(args, cwd, timeoutMs = 20_000) {
+    const r = (0, node_child_process_1.spawnSync)('git', args, {
+        cwd,
+        encoding: 'utf-8',
+        timeout: timeoutMs,
+        windowsHide: true,
+        env: { ...process.env, ...SILENT_ENV },
+    });
+    if (r.error) {
+        const code = r.error.code;
+        return {
+            ok: false,
+            stdout: '',
+            stderr: String(r.error.message || ''),
+            reason: code === 'ENOENT' ? 'no_git' : 'timeout',
+        };
+    }
+    if (r.signal) {
+        return { ok: false, stdout: r.stdout || '', stderr: r.stderr || '', reason: 'timeout' };
+    }
+    const stderr = r.stderr || '';
+    return {
+        ok: r.status === 0,
+        stdout: r.stdout || '',
+        stderr,
+        reason: r.status === 0 ? undefined : classify(stderr),
+    };
+}
+/** Is git installed at all? */
+function gitAvailable() {
+    return git(['--version'], process.cwd(), 5_000).ok;
+}
+/**
+ * Settings that have to be on the repository itself, not on the machine.
+ *
+ * `core.autocrlf` ships enabled on Windows — verified true at system level on
+ * the machine this was built on — and it rewrites files on checkout. With
+ * append-only logs merged by union, the same line with two different endings
+ * becomes two lines, and the memory quietly duplicates itself. `* -text` in
+ * .gitattributes plus this setting stops it at both ends.
+ */
+function hardenRepo(dir) {
+    git(['config', 'core.autocrlf', 'false'], dir);
+    git(['config', 'core.safecrlf', 'false'], dir);
+    git(['config', 'merge.ours.driver', 'true'], dir);
+    // Identity, so committing works on a machine with no global git config.
+    if (!git(['config', 'user.email'], dir).stdout.trim()) {
+        git(['config', 'user.email', 'crbro@localhost'], dir);
+    }
+    if (!git(['config', 'user.name'], dir).stdout.trim()) {
+        git(['config', 'user.name', 'CRBRO'], dir);
+    }
+}
+exports.GITATTRIBUTES = '# CRBRO shared memory. Do not edit.\n' +
+    '# -text keeps git from rewriting line endings: these logs are append-only\n' +
+    '# and a rewritten ending turns one line into two on the next merge.\n' +
+    '* -text\n' +
+    '*.jsonl merge=union\n';
+exports.GITIGNORE = '# Local bookkeeping. Never shared.\n' +
+    '.local/\n';
+/** Prepare a brand-new space so the first person to clone finds real history. */
+async function initSpace(dir, remote, branch = 'main') {
+    await node_fs_1.promises.mkdir(dir, { recursive: true });
+    const init = git(['init', '-b', branch], dir);
+    if (!init.ok && !init.stdout.includes('Reinitialized')) {
+        const legacy = git(['init'], dir);
+        if (!legacy.ok)
+            return legacy;
+        git(['checkout', '-b', branch], dir);
+    }
+    hardenRepo(dir);
+    await node_fs_1.promises.writeFile(node_path_1.default.join(dir, '.gitattributes'), exports.GITATTRIBUTES, 'utf-8');
+    await node_fs_1.promises.writeFile(node_path_1.default.join(dir, '.gitignore'), exports.GITIGNORE, 'utf-8');
+    git(['remote', 'remove', 'origin'], dir);
+    const add = git(['remote', 'add', 'origin', remote], dir);
+    if (!add.ok)
+        return add;
+    git(['add', '-A', '.'], dir);
+    git(['commit', '-q', '-m', 'CRBRO shared space'], dir);
+    // Push the first commit before anyone clones. Skipping this is how two
+    // people end up with unrelated histories and a merge that refuses to run —
+    // each of them keeping their own half of the memory without noticing.
+    return git(['push', '-u', 'origin', `HEAD:${branch}`], dir, 30_000);
+}
+/** Clone an existing space. */
+function cloneSpace(dir, remote, branch = 'main') {
+    const parent = node_path_1.default.dirname(dir);
+    const name = node_path_1.default.basename(dir);
+    const r = git(['clone', '--branch', branch, remote, name], parent, 60_000);
+    if (r.ok)
+        hardenRepo(dir);
+    return r;
+}
+/**
+ * Bring in everyone else's notes and send ours.
+ * Offline is a normal outcome, not an error: the work stays local and goes out
+ * next time. Nothing here can lose a note, because nobody edits anyone's file.
+ */
+function syncSpace(dir, author, branch = 'main', timeoutMs = 30_000) {
+    git(['add', '-A', '.'], dir);
+    const hayCambios = !git(['diff', '--cached', '--quiet'], dir).ok;
+    if (hayCambios) {
+        git(['commit', '-q', '-m', `crbro ${author} ${new Date().toISOString()}`], dir);
+    }
+    const fetched = git(['fetch', 'origin', branch], dir, timeoutMs);
+    if (!fetched.ok)
+        return { pulled: fetched, pushed: null };
+    const merged = git(['merge', '--no-edit', '--allow-unrelated-histories', `origin/${branch}`], dir, timeoutMs);
+    if (!merged.ok) {
+        // Union merging makes this rare, but a hand-edited file could still clash.
+        // Keeping both sides and stopping beats guessing.
+        git(['merge', '--abort'], dir);
+        return { pulled: { ...merged, reason: 'conflict' }, pushed: null };
+    }
+    // Push, and if someone landed first, take their work and try once more.
+    let pushed = git(['push', 'origin', `HEAD:${branch}`], dir, timeoutMs);
+    for (let intento = 0; intento < 2 && !pushed.ok && pushed.reason !== 'auth'; intento++) {
+        if (!git(['fetch', 'origin', branch], dir, timeoutMs).ok)
+            break;
+        if (!git(['merge', '--no-edit', `origin/${branch}`], dir, timeoutMs).ok) {
+            git(['merge', '--abort'], dir);
+            break;
+        }
+        pushed = git(['push', 'origin', `HEAD:${branch}`], dir, timeoutMs);
+    }
+    return { pulled: merged, pushed };
+}
+//# sourceMappingURL=git.js.map

package/dist/sync/git.js.map

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

package/dist/sync/materialize.d.ts

@@ -0,0 +1,26 @@
+import type { Neuron } from '../types/index.js';
+import type { Op } from './ops.js';
+/** Fields that disagreed and were left alone, so a human can look. */
+export interface Divergence {
+    field: string;
+    mine: string;
+    theirs: string;
+    from: string;
+}
+export interface MergeReport {
+    facts_added: number;
+    facts_retracted: number;
+    facts_superseded: number;
+    decisions_added: number;
+    patterns_added: number;
+    tags_added: number;
+    authors: string[];
+    divergence: Divergence[];
+}
+export declare function applyOps(base: Neuron | null, ops: Op[], fallback?: {
+    id: string;
+}): {
+    neuron: Neuron;
+    report: MergeReport;
+};
+//# sourceMappingURL=materialize.d.ts.map

package/dist/sync/materialize.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"materialize.d.ts","sourceRoot":"","sources":["../../src/sync/materialize.ts"],"names":[],"mappings":"AAeA,OAAO,KAAK,EAAE,MAAM,EAA8B,MAAM,mBAAmB,CAAC;AAC5E,OAAO,KAAK,EAAE,EAAE,EAAgC,MAAM,UAAU,CAAC;AAGjE,sEAAsE;AACtE,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,WAAW;IAC1B,WAAW,EAAE,MAAM,CAAC;IACpB,eAAe,EAAE,MAAM,CAAC;IACxB,gBAAgB,EAAE,MAAM,CAAC;IACzB,eAAe,EAAE,MAAM,CAAC;IACxB,cAAc,EAAE,MAAM,CAAC;IACvB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,UAAU,EAAE,UAAU,EAAE,CAAC;CAC1B;AAqBD,wBAAgB,QAAQ,CACtB,IAAI,EAAE,MAAM,GAAG,IAAI,EACnB,GAAG,EAAE,EAAE,EAAE,EACT,QAAQ,CAAC,EAAE;IAAE,EAAE,EAAE,MAAM,CAAA;CAAE,GACxB;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,WAAW,CAAA;CAAE,CA6JzC"}

package/dist/sync/materialize.js

@@ -0,0 +1,192 @@
+"use strict";
+// ─── CRBRO Shared Memory: rebuilding a neuron from the logs ──────
+//
+// Everything hard about sharing memory lives in this file, and it is one pure
+// function. Given whatever the neuron looks like locally plus every note
+// anyone has written, produce the neuron. No disk, no network, no git.
+//
+// Three properties make the merge automatic, and every rule below is chosen to
+// preserve them:
+//   - order does not matter,
+//   - applying the same note twice changes nothing,
+//   - applying half the notes now and the rest later ends up the same.
+// Anything that needed a clock, a "latest wins", or a tie-break on wall time
+// would break them, which is why none of that is here.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.applyOps = applyOps;
+const fs_js_1 = require("../utils/fs.js");
+const ops_js_1 = require("./ops.js");
+/**
+ * How far along a fact's life it is. Merging takes the maximum, so a fact
+ * someone retracted can never come back to life because a stale log still
+ * calls it active. Truth about what is no longer true only moves one way.
+ */
+const RANK = { active: 0, superseded: 1, retracted: 2 };
+const BY_RANK = ['active', 'superseded', 'retracted'];
+function rankOf(s) {
+    return RANK[s || 'active'] ?? 0;
+}
+/** The earlier of two ISO dates. Empty strings lose. */
+function earliest(a, b) {
+    if (!a)
+        return b;
+    if (!b)
+        return a;
+    return a < b ? a : b;
+}
+function applyOps(base, ops, fallback) {
+    const report = {
+        facts_added: 0,
+        facts_retracted: 0,
+        facts_superseded: 0,
+        decisions_added: 0,
+        patterns_added: 0,
+        tags_added: 0,
+        authors: [],
+        divergence: [],
+    };
+    const neuronOp = ops.find(o => o.op === 'neuron');
+    const id = base?.id || neuronOp?.nid || fallback?.id || '';
+    // Start from what we already have. If we have nothing, the announcement
+    // gives us a name; if we do have it, ours stands and any disagreement is
+    // reported rather than resolved. Overwriting someone's local name because a
+    // teammate spelled it differently is not a merge, it is a stomp.
+    const neuron = base
+        ? { ...base, facts: [...base.facts], decisions: [...base.decisions], patterns: [...base.patterns], preferences: [...base.preferences], tags: [...base.tags], connections: [...base.connections] }
+        : {
+            id,
+            name: neuronOp && neuronOp.op === 'neuron' ? neuronOp.name : id,
+            domain: neuronOp && neuronOp.op === 'neuron' ? neuronOp.domain : 'general',
+            type: (neuronOp && neuronOp.op === 'neuron' ? neuronOp.ntype : 'project'),
+            created: (0, fs_js_1.now)(),
+            last_accessed: (0, fs_js_1.now)(),
+            access_count: 0,
+            heat: 0.5,
+            summary: '',
+            facts: [],
+            decisions: [],
+            patterns: [],
+            preferences: [],
+            connections: [],
+            tags: [],
+        };
+    if (base && neuronOp && neuronOp.op === 'neuron') {
+        if (neuronOp.name && base.name && (0, ops_js_1.normalizeText)(neuronOp.name) !== (0, ops_js_1.normalizeText)(base.name)) {
+            report.divergence.push({ field: 'name', mine: base.name, theirs: neuronOp.name, from: neuronOp.by });
+        }
+        if (neuronOp.domain && base.domain && neuronOp.domain !== base.domain && base.domain !== 'general') {
+            report.divergence.push({ field: 'domain', mine: base.domain, theirs: neuronOp.domain, from: neuronOp.by });
+        }
+    }
+    // ─── Facts: union by id, then the furthest-along status ───────
+    const byFid = new Map();
+    for (const f of neuron.facts) {
+        byFid.set(f.id || '', f);
+    }
+    // Facts stored before ids existed: index them by their text so an incoming
+    // note about the same sentence lands on the same fact instead of duplicating.
+    const byText = new Map();
+    for (const f of neuron.facts) {
+        byText.set((0, ops_js_1.normalizeText)(f.text), f);
+    }
+    const statusOps = [];
+    for (const op of ops) {
+        if (op.op === 'fact') {
+            const fo = op;
+            const existing = byFid.get(fo.fid) || byText.get((0, ops_js_1.normalizeText)(fo.text));
+            if (existing) {
+                // Same fact from two people. Keep the earliest date so provenance
+                // reflects who knew it first, and the higher confidence.
+                existing.id = existing.id || fo.fid;
+                existing.added = earliest(existing.added, fo.at);
+                existing.confidence = Math.max(existing.confidence ?? 1, fo.conf ?? 1);
+                continue;
+            }
+            const fact = {
+                text: fo.text,
+                confidence: fo.conf ?? 1,
+                added: fo.at,
+                source: `team:${fo.by}`,
+                id: fo.fid,
+                status: 'active',
+            };
+            neuron.facts.push(fact);
+            byFid.set(fo.fid, fact);
+            byText.set((0, ops_js_1.normalizeText)(fo.text), fact);
+            report.facts_added++;
+        }
+        else if (op.op === 'status') {
+            statusOps.push(op);
+        }
+    }
+    // Status is applied after every fact exists, so a note retracting a fact
+    // works no matter which log it arrived in or in what order.
+    for (const so of statusOps) {
+        const target = byFid.get(so.fid);
+        if (!target)
+            continue;
+        const antes = rankOf(target.status);
+        const despues = Math.max(antes, rankOf(so.to));
+        if (despues === antes)
+            continue;
+        target.status = BY_RANK[despues];
+        target.revised = so.at;
+        if (so.why)
+            target.revision_note = so.why;
+        if (target.status === 'retracted')
+            report.facts_retracted++;
+        else
+            report.facts_superseded++;
+    }
+    // ─── Decisions: union by (id, author) ────────────────────────
+    // Two people can reach the same decision for different reasons, and both
+    // reasons are worth keeping. Keying on the pair means neither is lost.
+    const seenDecision = new Set();
+    for (const d of neuron.decisions) {
+        seenDecision.add(`${d.id || (0, ops_js_1.normalizeText)(d.text)}|${d.by || ''}`);
+    }
+    for (const op of ops) {
+        if (op.op !== 'decision')
+            continue;
+        const dop = op;
+        const key = `${dop.did}|${dop.by}`;
+        if (seenDecision.has(key))
+            continue;
+        seenDecision.add(key);
+        neuron.decisions.push({
+            text: dop.text,
+            date: dop.at,
+            rationale: dop.why || '',
+            id: dop.did,
+            by: dop.by,
+        });
+        report.decisions_added++;
+    }
+    // ─── Patterns and tags: plain set union ──────────────────────
+    for (const op of ops) {
+        if (op.op === 'pattern') {
+            if (!neuron.patterns.some(p => (0, ops_js_1.normalizeText)(p) === (0, ops_js_1.normalizeText)(op.text))) {
+                neuron.patterns.push(op.text);
+                report.patterns_added++;
+            }
+        }
+        else if (op.op === 'tag') {
+            if (!neuron.tags.some(t => (0, ops_js_1.normalizeText)(t) === (0, ops_js_1.normalizeText)(op.text))) {
+                neuron.tags.push(op.text);
+                report.tags_added++;
+            }
+        }
+    }
+    // Deterministic order, so two machines holding the same knowledge produce
+    // byte-identical files. Without this, every sync would look like a change.
+    neuron.facts.sort((a, b) => {
+        const d = String(a.added || '').localeCompare(String(b.added || ''));
+        return d !== 0 ? d : String(a.id || '').localeCompare(String(b.id || ''));
+    });
+    neuron.decisions.sort((a, b) => String(a.date || '').localeCompare(String(b.date || '')));
+    neuron.patterns.sort();
+    neuron.tags.sort();
+    report.authors = [...new Set(ops.map(o => o.by).filter(Boolean))].sort();
+    return { neuron, report };
+}
+//# sourceMappingURL=materialize.js.map

package/dist/sync/materialize.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"materialize.js","sourceRoot":"","sources":["../../src/sync/materialize.ts"],"names":[],"mappings":";AAAA,oEAAoE;AACpE,EAAE;AACF,8EAA8E;AAC9E,yEAAyE;AACzE,uEAAuE;AACvE,EAAE;AACF,+EAA+E;AAC/E,iBAAiB;AACjB,6BAA6B;AAC7B,oDAAoD;AACpD,uEAAuE;AACvE,6EAA6E;AAC7E,uDAAuD;;AA6CvD,4BAiKC;AA5MD,0CAAqC;AAGrC,qCAAyC;AAqBzC;;;;GAIG;AACH,MAAM,IAAI,GAA+B,EAAE,MAAM,EAAE,CAAC,EAAE,UAAU,EAAE,CAAC,EAAE,SAAS,EAAE,CAAC,EAAE,CAAC;AACpF,MAAM,OAAO,GAAiB,CAAC,QAAQ,EAAE,YAAY,EAAE,WAAW,CAAC,CAAC;AAEpE,SAAS,MAAM,CAAC,CAAyB;IACvC,OAAO,IAAI,CAAC,CAAC,IAAI,QAAQ,CAAC,IAAI,CAAC,CAAC;AAClC,CAAC;AAED,wDAAwD;AACxD,SAAS,QAAQ,CAAC,CAAS,EAAE,CAAS;IACpC,IAAI,CAAC,CAAC;QAAE,OAAO,CAAC,CAAC;IACjB,IAAI,CAAC,CAAC;QAAE,OAAO,CAAC,CAAC;IACjB,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AACvB,CAAC;AAED,SAAgB,QAAQ,CACtB,IAAmB,EACnB,GAAS,EACT,QAAyB;IAEzB,MAAM,MAAM,GAAgB;QAC1B,WAAW,EAAE,CAAC;QACd,eAAe,EAAE,CAAC;QAClB,gBAAgB,EAAE,CAAC;QACnB,eAAe,EAAE,CAAC;QAClB,cAAc,EAAE,CAAC;QACjB,UAAU,EAAE,CAAC;QACb,OAAO,EAAE,EAAE;QACX,UAAU,EAAE,EAAE;KACf,CAAC;IAEF,MAAM,QAAQ,GAAG,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,QAAQ,CAAC,CAAC;IAClD,MAAM,EAAE,GAAG,IAAI,EAAE,EAAE,IAAI,QAAQ,EAAE,GAAG,IAAI,QAAQ,EAAE,EAAE,IAAI,EAAE,CAAC;IAE3D,wEAAwE;IACxE,yEAAyE;IACzE,4EAA4E;IAC5E,iEAAiE;IACjE,MAAM,MAAM,GAAW,IAAI;QACzB,CAAC,CAAC,EAAE,GAAG,IAAI,EAAE,KAAK,EAAE,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,EAAE,SAAS,EAAE,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,EAAE,QAAQ,EAAE,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC,EAAE,WAAW,EAAE,CAAC,GAAG,IAAI,CAAC,WAAW,CAAC,EAAE,IAAI,EAAE,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,EAAE,WAAW,EAAE,CAAC,GAAG,IAAI,CAAC,WAAW,CAAC,EAAE;QACjM,CAAC,CAAC;YACE,EAAE;YACF,IAAI,EAAE,QAAQ,IAAI,QAAQ,CAAC,EAAE,KAAK,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE;YAC/D,MAAM,EAAE,QAAQ,IAAI,QAAQ,CAAC,EAAE,KAAK,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS;YAC1E,IAAI,EAAE,CAAC,QAAQ,IAAI,QAAQ,CAAC,EAAE,KAAK,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAmB;YAC3F,OAAO,EAAE,IAAA,WAAG,GAAE;YACd,aAAa,EAAE,IAAA,WAAG,GAAE;YACpB,YAAY,EAAE,CAAC;YACf,IAAI,EAAE,GAAG;YACT,OAAO,EAAE,EAAE;YACX,KAAK,EAAE,EAAE;YACT,SAAS,EAAE,EAAE;YACb,QAAQ,EAAE,EAAE;YACZ,WAAW,EAAE,EAAE;YACf,WAAW,EAAE,EAAE;YACf,IAAI,EAAE,EAAE;SACT,CAAC;IAEN,IAAI,IAAI,IAAI,QAAQ,IAAI,QAAQ,CAAC,EAAE,KAAK,QAAQ,EAAE,CAAC;QACjD,IAAI,QAAQ,CAAC,IAAI,IAAI,IAAI,CAAC,IAAI,IAAI,IAAA,sBAAa,EAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,IAAA,sBAAa,EAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;YAC5F,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,CAAC,IAAI,EAAE,IAAI,EAAE,QAAQ,CAAC,EAAE,EAAE,CAAC,CAAC;QACvG,CAAC;QACD,IAAI,QAAQ,CAAC,MAAM,IAAI,IAAI,CAAC,MAAM,IAAI,QAAQ,CAAC,MAAM,KAAK,IAAI,CAAC,MAAM,IAAI,IAAI,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;YACnG,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,QAAQ,EAAE,IAAI,EAAE,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,CAAC,MAAM,EAAE,IAAI,EAAE,QAAQ,CAAC,EAAE,EAAE,CAAC,CAAC;QAC7G,CAAC;IACH,CAAC;IAED,iEAAiE;IACjE,MAAM,KAAK,GAAG,IAAI,GAAG,EAAgB,CAAC;IACtC,KAAK,MAAM,CAAC,IAAI,MAAM,CAAC,KAAK,EAAE,CAAC;QAC7B,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,EAAE,CAAC,CAAC,CAAC;IAC3B,CAAC;IACD,2EAA2E;IAC3E,8EAA8E;IAC9E,MAAM,MAAM,GAAG,IAAI,GAAG,EAAgB,CAAC;IACvC,KAAK,MAAM,CAAC,IAAI,MAAM,CAAC,KAAK,EAAE,CAAC;QAC7B,MAAM,CAAC,GAAG,CAAC,IAAA,sBAAa,EAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC;IACvC,CAAC;IAED,MAAM,SAAS,GAAe,EAAE,CAAC;IAEjC,KAAK,MAAM,EAAE,IAAI,GAAG,EAAE,CAAC;QACrB,IAAI,EAAE,CAAC,EAAE,KAAK,MAAM,EAAE,CAAC;YACrB,MAAM,EAAE,GAAG,EAAY,CAAC;YACxB,MAAM,QAAQ,GAAG,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,IAAI,MAAM,CAAC,GAAG,CAAC,IAAA,sBAAa,EAAC,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC;YACzE,IAAI,QAAQ,EAAE,CAAC;gBACb,kEAAkE;gBAClE,yDAAyD;gBACzD,QAAQ,CAAC,EAAE,GAAG,QAAQ,CAAC,EAAE,IAAI,EAAE,CAAC,GAAG,CAAC;gBACpC,QAAQ,CAAC,KAAK,GAAG,QAAQ,CAAC,QAAQ,CAAC,KAAK,EAAE,EAAE,CAAC,EAAE,CAAC,CAAC;gBACjD,QAAQ,CAAC,UAAU,GAAG,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,UAAU,IAAI,CAAC,EAAE,EAAE,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC;gBACvE,SAAS;YACX,CAAC;YACD,MAAM,IAAI,GAAS;gBACjB,IAAI,EAAE,EAAE,CAAC,IAAI;gBACb,UAAU,EAAE,EAAE,CAAC,IAAI,IAAI,CAAC;gBACxB,KAAK,EAAE,EAAE,CAAC,EAAE;gBACZ,MAAM,EAAE,QAAQ,EAAE,CAAC,EAAE,EAAE;gBACvB,EAAE,EAAE,EAAE,CAAC,GAAG;gBACV,MAAM,EAAE,QAAQ;aACjB,CAAC;YACF,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACxB,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;YACxB,MAAM,CAAC,GAAG,CAAC,IAAA,sBAAa,EAAC,EAAE,CAAC,IAAI,CAAC,EAAE,IAAI,CAAC,CAAC;YACzC,MAAM,CAAC,WAAW,EAAE,CAAC;QACvB,CAAC;aAAM,IAAI,EAAE,CAAC,EAAE,KAAK,QAAQ,EAAE,CAAC;YAC9B,SAAS,CAAC,IAAI,CAAC,EAAc,CAAC,CAAC;QACjC,CAAC;IACH,CAAC;IAED,yEAAyE;IACzE,4DAA4D;IAC5D,KAAK,MAAM,EAAE,IAAI,SAAS,EAAE,CAAC;QAC3B,MAAM,MAAM,GAAG,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC;QACjC,IAAI,CAAC,MAAM;YAAE,SAAS;QACtB,MAAM,KAAK,GAAG,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;QACpC,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,MAAM,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;QAC/C,IAAI,OAAO,KAAK,KAAK;YAAE,SAAS;QAChC,MAAM,CAAC,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;QACjC,MAAM,CAAC,OAAO,GAAG,EAAE,CAAC,EAAE,CAAC;QACvB,IAAI,EAAE,CAAC,GAAG;YAAE,MAAM,CAAC,aAAa,GAAG,EAAE,CAAC,GAAG,CAAC;QAC1C,IAAI,MAAM,CAAC,MAAM,KAAK,WAAW;YAAE,MAAM,CAAC,eAAe,EAAE,CAAC;;YACvD,MAAM,CAAC,gBAAgB,EAAE,CAAC;IACjC,CAAC;IAED,gEAAgE;IAChE,yEAAyE;IACzE,uEAAuE;IACvE,MAAM,YAAY,GAAG,IAAI,GAAG,EAAU,CAAC;IACvC,KAAK,MAAM,CAAC,IAAI,MAAM,CAAC,SAAS,EAAE,CAAC;QACjC,YAAY,CAAC,GAAG,CAAC,GAAI,CAAgC,CAAC,EAAE,IAAI,IAAA,sBAAa,EAAC,CAAC,CAAC,IAAI,CAAC,IAAK,CAAgC,CAAC,EAAE,IAAI,EAAE,EAAE,CAAC,CAAC;IACrI,CAAC;IACD,KAAK,MAAM,EAAE,IAAI,GAAG,EAAE,CAAC;QACrB,IAAI,EAAE,CAAC,EAAE,KAAK,UAAU;YAAE,SAAS;QACnC,MAAM,GAAG,GAAG,EAAgB,CAAC;QAC7B,MAAM,GAAG,GAAG,GAAG,GAAG,CAAC,GAAG,IAAI,GAAG,CAAC,EAAE,EAAE,CAAC;QACnC,IAAI,YAAY,CAAC,GAAG,CAAC,GAAG,CAAC;YAAE,SAAS;QACpC,YAAY,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACtB,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC;YACpB,IAAI,EAAE,GAAG,CAAC,IAAI;YACd,IAAI,EAAE,GAAG,CAAC,EAAE;YACZ,SAAS,EAAE,GAAG,CAAC,GAAG,IAAI,EAAE;YACxB,EAAE,EAAE,GAAG,CAAC,GAAG;YACX,EAAE,EAAE,GAAG,CAAC,EAAE;SACC,CAAC,CAAC;QACf,MAAM,CAAC,eAAe,EAAE,CAAC;IAC3B,CAAC;IAED,gEAAgE;IAChE,KAAK,MAAM,EAAE,IAAI,GAAG,EAAE,CAAC;QACrB,IAAI,EAAE,CAAC,EAAE,KAAK,SAAS,EAAE,CAAC;YACxB,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,IAAA,sBAAa,EAAC,CAAC,CAAC,KAAK,IAAA,sBAAa,EAAC,EAAE,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC;gBAC5E,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC;gBAC9B,MAAM,CAAC,cAAc,EAAE,CAAC;YAC1B,CAAC;QACH,CAAC;aAAM,IAAI,EAAE,CAAC,EAAE,KAAK,KAAK,EAAE,CAAC;YAC3B,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,IAAA,sBAAa,EAAC,CAAC,CAAC,KAAK,IAAA,sBAAa,EAAC,EAAE,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC;gBACxE,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC;gBAC1B,MAAM,CAAC,UAAU,EAAE,CAAC;YACtB,CAAC;QACH,CAAC;IACH,CAAC;IAED,0EAA0E;IAC1E,2EAA2E;IAC3E,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE;QACzB,MAAM,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,CAAC;QACrE,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;IAC5E,CAAC,CAAC,CAAC;IACH,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;IAC1F,MAAM,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC;IACvB,MAAM,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;IAEnB,MAAM,CAAC,OAAO,GAAG,CAAC,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;IAEzE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC;AAC5B,CAAC"}

package/dist/sync/ops.d.ts

@@ -0,0 +1,76 @@
+/** Bumped only if the shape changes in a way older clients cannot read. */
+export declare const OPS_VERSION = 1;
+export type OpKind = 'neuron' | 'fact' | 'status' | 'decision' | 'pattern' | 'tag';
+interface OpBase {
+    v: number;
+    op: OpKind;
+    /** Neuron this applies to. */
+    nid: string;
+    /** Who wrote it. Not a security claim — anyone with push access can write any name. */
+    by: string;
+    /** ISO timestamp. Used for display and for keeping the earliest date, never to decide a winner. */
+    at: string;
+}
+/** Announces a neuron. Its name/type/domain are only used if the receiver has no such neuron. */
+export interface NeuronOp extends OpBase {
+    op: 'neuron';
+    name: string;
+    ntype: string;
+    domain: string;
+}
+export interface FactOp extends OpBase {
+    op: 'fact';
+    fid: string;
+    text: string;
+    conf: number;
+    src?: string;
+}
+/**
+ * A fact stopped being current. Only ever moves forward:
+ * active → superseded → retracted, never back.
+ */
+export interface StatusOp extends OpBase {
+    op: 'status';
+    fid: string;
+    to: 'superseded' | 'retracted';
+    why?: string;
+}
+export interface DecisionOp extends OpBase {
+    op: 'decision';
+    did: string;
+    text: string;
+    why?: string;
+}
+export interface PatternOp extends OpBase {
+    op: 'pattern';
+    text: string;
+}
+export interface TagOp extends OpBase {
+    op: 'tag';
+    text: string;
+}
+export type Op = NeuronOp | FactOp | StatusOp | DecisionOp | PatternOp | TagOp;
+/**
+ * Same wording, same id, on every machine.
+ *
+ * Normalising first matters: one person's copy of a sentence may differ from
+ * another's by a stray double space or a different Unicode composition, and
+ * without this they would become two facts saying the same thing.
+ */
+export declare function normalizeText(text: string): string;
+export declare function entryId(text: string): string;
+/** Serialise one operation as a single line. */
+export declare function encodeOp(op: Op): string;
+/**
+ * Parse a log. Unreadable lines are skipped rather than thrown, because a log
+ * can be cut in half by a process dying mid-append or by a merge landing while
+ * we read. One bad line must never cost the other nine hundred.
+ */
+export declare function decodeOps(content: string): {
+    ops: Op[];
+    skipped: number;
+};
+/** Where a person's log for a neuron lives inside the space. */
+export declare function opsRelPath(neuronId: string, author: string, device: string): string;
+export {};
+//# sourceMappingURL=ops.d.ts.map

package/dist/sync/ops.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ops.d.ts","sourceRoot":"","sources":["../../src/sync/ops.ts"],"names":[],"mappings":"AAcA,2EAA2E;AAC3E,eAAO,MAAM,WAAW,IAAI,CAAC;AAE7B,MAAM,MAAM,MAAM,GAAG,QAAQ,GAAG,MAAM,GAAG,QAAQ,GAAG,UAAU,GAAG,SAAS,GAAG,KAAK,CAAC;AAEnF,UAAU,MAAM;IACd,CAAC,EAAE,MAAM,CAAC;IACV,EAAE,EAAE,MAAM,CAAC;IACX,8BAA8B;IAC9B,GAAG,EAAE,MAAM,CAAC;IACZ,uFAAuF;IACvF,EAAE,EAAE,MAAM,CAAC;IACX,mGAAmG;IACnG,EAAE,EAAE,MAAM,CAAC;CACZ;AAED,iGAAiG;AACjG,MAAM,WAAW,QAAS,SAAQ,MAAM;IACtC,EAAE,EAAE,QAAQ,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,MAAO,SAAQ,MAAM;IACpC,EAAE,EAAE,MAAM,CAAC;IACX,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED;;;GAGG;AACH,MAAM,WAAW,QAAS,SAAQ,MAAM;IACtC,EAAE,EAAE,QAAQ,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,EAAE,EAAE,YAAY,GAAG,WAAW,CAAC;IAC/B,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,UAAW,SAAQ,MAAM;IACxC,EAAE,EAAE,UAAU,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,SAAU,SAAQ,MAAM;IACvC,EAAE,EAAE,SAAS,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,KAAM,SAAQ,MAAM;IACnC,EAAE,EAAE,KAAK,CAAC;IACV,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,MAAM,EAAE,GAAG,QAAQ,GAAG,MAAM,GAAG,QAAQ,GAAG,UAAU,GAAG,SAAS,GAAG,KAAK,CAAC;AAE/E;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAElD;AAED,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAE5C;AAED,gDAAgD;AAChD,wBAAgB,QAAQ,CAAC,EAAE,EAAE,EAAE,GAAG,MAAM,CAEvC;AAED;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG;IAAE,GAAG,EAAE,EAAE,EAAE,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAyBzE;AAED,gEAAgE;AAChE,wBAAgB,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAEnF"}

package/dist/sync/ops.js

@@ -0,0 +1,75 @@
+"use strict";
+// ─── CRBRO Shared Memory: the operation log ──────────────────────
+//
+// Two people cannot share a neuron by copying the file back and forth: the
+// last save wins and the other person's work vanishes. So nobody ever shares
+// the neuron. Each person appends notes to their own log — "I added this
+// fact", "I retracted that one" — and every machine rebuilds the neuron from
+// all the logs it has.
+//
+// Nobody writes to anybody else's file, so there is nothing to collide. That
+// is the whole trick, and it is what makes the merge automatic: no conflict
+// can arise if no two writers touch the same bytes.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.OPS_VERSION = void 0;
+exports.normalizeText = normalizeText;
+exports.entryId = entryId;
+exports.encodeOp = encodeOp;
+exports.decodeOps = decodeOps;
+exports.opsRelPath = opsRelPath;
+const hash_js_1 = require("../utils/hash.js");
+/** Bumped only if the shape changes in a way older clients cannot read. */
+exports.OPS_VERSION = 1;
+/**
+ * Same wording, same id, on every machine.
+ *
+ * Normalising first matters: one person's copy of a sentence may differ from
+ * another's by a stray double space or a different Unicode composition, and
+ * without this they would become two facts saying the same thing.
+ */
+function normalizeText(text) {
+    return (text || '').normalize('NFC').replace(/\s+/g, ' ').trim();
+}
+function entryId(text) {
+    return (0, hash_js_1.contentHash)(normalizeText(text));
+}
+/** Serialise one operation as a single line. */
+function encodeOp(op) {
+    return JSON.stringify(op);
+}
+/**
+ * Parse a log. Unreadable lines are skipped rather than thrown, because a log
+ * can be cut in half by a process dying mid-append or by a merge landing while
+ * we read. One bad line must never cost the other nine hundred.
+ */
+function decodeOps(content) {
+    const ops = [];
+    let skipped = 0;
+    for (const line of (content || '').split('\n')) {
+        const t = line.trim();
+        if (!t)
+            continue;
+        try {
+            const parsed = JSON.parse(t);
+            if (!parsed || typeof parsed !== 'object' || !parsed.op || !parsed.nid) {
+                skipped++;
+                continue;
+            }
+            if (parsed.v > exports.OPS_VERSION) {
+                // Written by a newer CRBRO. Skipping is safer than half-understanding it.
+                skipped++;
+                continue;
+            }
+            ops.push(parsed);
+        }
+        catch {
+            skipped++;
+        }
+    }
+    return { ops, skipped };
+}
+/** Where a person's log for a neuron lives inside the space. */
+function opsRelPath(neuronId, author, device) {
+    return `neurons/${neuronId}/ops/${author}.${device}.jsonl`;
+}
+//# sourceMappingURL=ops.js.map

package/dist/sync/ops.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ops.js","sourceRoot":"","sources":["../../src/sync/ops.ts"],"names":[],"mappings":";AAAA,oEAAoE;AACpE,EAAE;AACF,2EAA2E;AAC3E,6EAA6E;AAC7E,yEAAyE;AACzE,6EAA6E;AAC7E,uBAAuB;AACvB,EAAE;AACF,6EAA6E;AAC7E,4EAA4E;AAC5E,oDAAoD;;;AAyEpD,sCAEC;AAED,0BAEC;AAGD,4BAEC;AAOD,8BAyBC;AAGD,gCAEC;AAvHD,8CAA+C;AAE/C,2EAA2E;AAC9D,QAAA,WAAW,GAAG,CAAC,CAAC;AA6D7B;;;;;;GAMG;AACH,SAAgB,aAAa,CAAC,IAAY;IACxC,OAAO,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;AACnE,CAAC;AAED,SAAgB,OAAO,CAAC,IAAY;IAClC,OAAO,IAAA,qBAAW,EAAC,aAAa,CAAC,IAAI,CAAC,CAAC,CAAC;AAC1C,CAAC;AAED,gDAAgD;AAChD,SAAgB,QAAQ,CAAC,EAAM;IAC7B,OAAO,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC;AAC5B,CAAC;AAED;;;;GAIG;AACH,SAAgB,SAAS,CAAC,OAAe;IACvC,MAAM,GAAG,GAAS,EAAE,CAAC;IACrB,IAAI,OAAO,GAAG,CAAC,CAAC;IAEhB,KAAK,MAAM,IAAI,IAAI,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;QAC/C,MAAM,CAAC,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;QACtB,IAAI,CAAC,CAAC;YAAE,SAAS;QACjB,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAO,CAAC;YACnC,IAAI,CAAC,MAAM,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,CAAC,MAAM,CAAC,EAAE,IAAI,CAAC,MAAM,CAAC,GAAG,EAAE,CAAC;gBACvE,OAAO,EAAE,CAAC;gBACV,SAAS;YACX,CAAC;YACD,IAAI,MAAM,CAAC,CAAC,GAAG,mBAAW,EAAE,CAAC;gBAC3B,0EAA0E;gBAC1E,OAAO,EAAE,CAAC;gBACV,SAAS;YACX,CAAC;YACD,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QACnB,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,EAAE,CAAC;QACZ,CAAC;IACH,CAAC;IAED,OAAO,EAAE,GAAG,EAAE,OAAO,EAAE,CAAC;AAC1B,CAAC;AAED,gEAAgE;AAChE,SAAgB,UAAU,CAAC,QAAgB,EAAE,MAAc,EAAE,MAAc;IACzE,OAAO,WAAW,QAAQ,QAAQ,MAAM,IAAI,MAAM,QAAQ,CAAC;AAC7D,CAAC"}