@0xmaxma/claude-gateway 1.6.9 → 1.7.0

package/dist/agent/dreaming/migrate.js

@@ -0,0 +1,374 @@
+"use strict";
+/**
+ * One-shot memory migration (planning-65) — drain an over-budget MEMORY.md that
+ * accumulated task-log before write-routing existed.
+ *
+ * Two deterministic passes, both non-destructive (content is relocated, never
+ * deleted — everything stays searchable via `memory_search`):
+ *
+ *   Pass 1 — terminal sweep: reuse the shipped compactor (#337) to move
+ *   MERGED/CLOSED/✅-marked blocks to `memory/archive/completed.md`.
+ *
+ *   Pass 2 — episodic route-out: an injected classifier (`routeOut`, in
+ *   production a print-only reviewer) proposes which REMAINING MEMORY.md blocks
+ *   are episodic task-log. Each surviving proposal moves the block's text to
+ *   `memory/<topic>.md` and removes the block from MEMORY.md. Pinned sections
+ *   (`## User`, `## Feedback`, `## Preferences`) are hard-excluded — never moved.
+ *
+ * `mode:"propose"` writes a `.dreaming/migration-plan.md` review file and mutates
+ * MEMORY.md not at all (beyond Pass 1's deterministic sweep, which is always safe
+ * and idempotent). `mode:"apply"` performs the moves (archive-first, then one
+ * backed-up atomic rewrite of MEMORY.md).
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.pinnedRanges = pinnedRanges;
+exports.isTargetPinned = isTargetPinned;
+exports.migrateMemory = migrateMemory;
+exports.makeRouteOut = makeRouteOut;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const compactor_1 = require("./compactor");
+const episodic_1 = require("./episodic");
+const audit_1 = require("./audit");
+/** h2 sections whose entries are durable and must NEVER be routed to episodic. */
+const PINNED_SECTION_RE = /^##\s+(user|feedback|preference|preferences|profile)\b/i;
+const SECTION_RE = /^#{1,2}\s/;
+function readOnDisk(filePath) {
+    try {
+        return fs.readFileSync(filePath, 'utf8');
+    }
+    catch {
+        return '';
+    }
+}
+function atomicWrite(filePath, content) {
+    const dir = path.dirname(filePath);
+    fs.mkdirSync(dir, { recursive: true });
+    const tmp = path.join(dir, `.tmp-migrate-${process.pid}-${process.hrtime.bigint().toString(36)}`);
+    try {
+        fs.writeFileSync(tmp, content, 'utf8');
+        fs.renameSync(tmp, filePath);
+    }
+    catch (err) {
+        try {
+            fs.rmSync(tmp, { force: true });
+        }
+        catch {
+            /* best-effort */
+        }
+        throw err;
+    }
+}
+/** Char range [start,end) of each pinned section in `memory` (heading → next h1/h2). */
+function pinnedRanges(memory) {
+    const lines = memory.split('\n');
+    const ranges = [];
+    let offset = 0;
+    let openStart = -1;
+    for (const line of lines) {
+        const lineLen = line.length + 1; // +1 for the split '\n'
+        if (SECTION_RE.test(line)) {
+            // Close a currently-open pinned section at this heading.
+            if (openStart >= 0) {
+                ranges.push([openStart, offset]);
+                openStart = -1;
+            }
+            if (PINNED_SECTION_RE.test(line))
+                openStart = offset;
+        }
+        offset += lineLen;
+    }
+    if (openStart >= 0)
+        ranges.push([openStart, memory.length]);
+    return ranges;
+}
+function inPinned(index, ranges) {
+    return ranges.some(([s, e]) => index >= s && index < e);
+}
+/** True iff the block at `original.indexOf(target)` sits inside a pinned section. */
+function isTargetPinned(memory, target) {
+    if (!target)
+        return false;
+    const at = memory.indexOf(target);
+    if (at === -1)
+        return false;
+    return inPinned(at, pinnedRanges(memory));
+}
+/**
+ * Validate route-out proposals against the current MEMORY.md: keep only episodic
+ * `add`s with a topic + content whose `target` block occurs EXACTLY once and is
+ * NOT inside a pinned section.
+ */
+function planMoves(memory, proposals) {
+    const ranges = pinnedRanges(memory);
+    const out = [];
+    for (const p of proposals) {
+        if (p.tier !== 'episodic' || p.op !== 'add' || !p.topic || !p.content)
+            continue;
+        const target = p.target ?? '';
+        if (!target)
+            continue;
+        const first = memory.indexOf(target);
+        if (first === -1)
+            continue; // block not found → skip
+        if (memory.indexOf(target, first + target.length) !== -1)
+            continue; // ambiguous → skip
+        if (inPinned(first, ranges))
+            continue; // pinned section → never move
+        out.push({ proposal: p, index: first });
+    }
+    return out;
+}
+/** Remove each planned block from `memory` in one pass (splice by index, desc). */
+function removeBlocks(memory, planned) {
+    let next = memory;
+    const sorted = [...planned].sort((a, b) => b.index - a.index);
+    for (const { proposal, index } of sorted) {
+        const target = proposal.target ?? '';
+        // Re-resolve against the ORIGINAL memory offset; splice literally.
+        next = next.slice(0, index) + next.slice(index + target.length);
+    }
+    // Collapse the blank-line gaps left by removed blocks.
+    return next.replace(/\n{3,}/g, '\n\n');
+}
+/**
+ * Run the migration. Never throws on a per-pass error — returns what it managed
+ * to do. In `apply` mode the episodic notes are written BEFORE MEMORY.md is
+ * rewritten (archive-first), and MEMORY.md is backed up before the atomic write.
+ */
+async function migrateMemory(workspaceDir, opts) {
+    const now = opts.now ?? Date.now();
+    const episodicDir = opts.episodicArchiveDir || episodic_1.DEFAULT_EPISODIC_DIR;
+    const memPath = path.join(workspaceDir, 'MEMORY.md');
+    const before = readOnDisk(memPath).length;
+    // Pass 1 — deterministic terminal sweep (always safe, idempotent). Skipped by
+    // the nightly dream, which already ran the compactor this tick (planning-67).
+    let terminalArchived = 0;
+    if (!opts.skipTerminalSweep) {
+        try {
+            terminalArchived = (0, compactor_1.compactCompletedEntries)(workspaceDir, now).archivedCount;
+        }
+        catch {
+            terminalArchived = 0;
+        }
+    }
+    // Pass 2 — episodic route-out (gated on an injected classifier).
+    const memory = readOnDisk(memPath);
+    let planned = [];
+    if (opts.routeOut && memory.trim()) {
+        let proposals = [];
+        try {
+            proposals = (await opts.routeOut(memory)) ?? [];
+        }
+        catch {
+            proposals = [];
+        }
+        planned = planMoves(memory, proposals);
+    }
+    if (opts.mode === 'propose') {
+        // Write a human-review plan; mutate MEMORY.md not at all in Pass 2.
+        let planPath;
+        try {
+            const dir = path.join(workspaceDir, audit_1.DREAMING_DIR);
+            fs.mkdirSync(dir, { recursive: true });
+            planPath = path.join(dir, 'migration-plan.md');
+            const lines = [
+                '# Memory migration plan (planning-65)',
+                '',
+                `Terminal sweep archived: ${terminalArchived} block(s) → memory/archive/completed.md`,
+                `Episodic route-out proposed: ${planned.length} block(s)`,
+                '',
+                '## Proposed episodic moves (MEMORY.md → memory/<topic>.md)',
+                '',
+                ...planned.map((m) => `- → \`memory/${m.proposal.topic}.md\` — ${m.proposal.reason || '(episodic task-log)'}\n` +
+                    `  \`\`\`\n  ${(m.proposal.target ?? '').replace(/\n/g, '\n  ')}\n  \`\`\``),
+                '',
+                '_Run with --apply to perform these moves (pinned sections excluded, content stays searchable)._',
+            ];
+            atomicWrite(planPath, lines.join('\n') + '\n');
+        }
+        catch {
+            planPath = undefined;
+        }
+        return {
+            terminalArchived,
+            episodicMoved: 0,
+            episodicPlanned: planned.length,
+            planPath,
+            memoryCharsBefore: before,
+            memoryCharsAfter: readOnDisk(memPath).length,
+        };
+    }
+    // apply mode — archive first, then one backed-up rewrite of MEMORY.md.
+    let episodicMoved = 0;
+    if (planned.length > 0) {
+        const moved = [];
+        for (const m of planned) {
+            const res = (0, episodic_1.appendEpisodicNote)(workspaceDir, episodicDir, m.proposal.topic, m.proposal.content, now);
+            if (res.ok)
+                moved.push(m);
+        }
+        if (moved.length > 0) {
+            // CAS: only rewrite if MEMORY.md is unchanged since we read it.
+            if (readOnDisk(memPath) === memory) {
+                const next = removeBlocks(memory, moved);
+                try {
+                    const dir = path.join(workspaceDir, audit_1.DREAMING_DIR, 'backups');
+                    fs.mkdirSync(dir, { recursive: true });
+                    atomicWrite(path.join(dir, `MEMORY.md.${now}.migrate.bak`), memory);
+                }
+                catch {
+                    /* best-effort backup */
+                }
+                atomicWrite(memPath, next);
+                episodicMoved = moved.length;
+            }
+        }
+    }
+    return {
+        terminalArchived,
+        episodicMoved,
+        episodicPlanned: planned.length,
+        memoryCharsBefore: before,
+        memoryCharsAfter: readOnDisk(memPath).length,
+    };
+}
+// ── Route-out classifier (shared by the migrate CLI and the nightly dream) ──────
+const ROUTE_OUT_PROMPT = `You migrate an AI agent's MEMORY.md. MEMORY.md is injected into every prompt, so it must hold ONLY durable facts (user preferences, standing rules, identity, lessons). EPISODIC task-log — a record of what happened (completed/merged work, PR/issue status, dated progress notes) — must move to a searchable archive.
+
+You are given the current MEMORY.md. Identify the blocks that are EPISODIC task-log and should move out. For each, return the EXACT block text to remove (verbatim, so it can be located) and the note to archive.
+
+NEVER move blocks under a "## User", "## Feedback", or "## Preferences" section — those are durable and pinned.
+
+Respond with STRICT JSON only (no prose/fences):
+{"moves":[{"target":"<exact block text from MEMORY.md to remove>","topic":"<lowercase-kebab-slug>","content":"<text to archive>","reason":"<why episodic>"}]}
+- topic MUST match ^[a-z0-9-]{1,64}$. moves: [] if nothing should move.`;
+/** Extract the first balanced top-level JSON object from free text (fence-safe). */
+function extractJson(text) {
+    const start = text.indexOf('{');
+    if (start < 0)
+        return null;
+    let depth = 0;
+    let inStr = false;
+    let esc = false;
+    for (let i = start; i < text.length; i++) {
+        const ch = text[i];
+        if (inStr) {
+            if (esc)
+                esc = false;
+            else if (ch === '\\')
+                esc = true;
+            else if (ch === '"')
+                inStr = false;
+        }
+        else if (ch === '"')
+            inStr = true;
+        else if (ch === '{')
+            depth++;
+        else if (ch === '}') {
+            depth--;
+            if (depth === 0)
+                return text.slice(start, i + 1);
+        }
+    }
+    return null;
+}
+/** Unwrap a `claude -p --output-format json` envelope, else return stdout as-is. */
+function parseEnvelope(stdout) {
+    try {
+        const env = JSON.parse(stdout);
+        return typeof env['result'] === 'string' ? env['result'] : stdout;
+    }
+    catch {
+        return stdout;
+    }
+}
+/**
+ * Build the injected route-out classifier that `migrateMemory` consumes, backed by
+ * a print-only claude spawn (no tools, untrusted input — same safety model as the
+ * dreaming reviewer). Injectable `spawn` keeps it fully testable without a model.
+ */
+function makeRouteOut(spawn) {
+    return async (memory) => {
+        const prompt = `${ROUTE_OUT_PROMPT}\n\n<current_memory>\n${memory}\n</current_memory>\n\nOutput the JSON now:`;
+        let stdout = '';
+        try {
+            const r = await spawn([], prompt);
+            if (r.timedOut)
+                return [];
+            stdout = r.stdout;
+        }
+        catch {
+            return [];
+        }
+        const jsonStr = extractJson(parseEnvelope(stdout));
+        if (!jsonStr)
+            return [];
+        let parsed;
+        try {
+            parsed = JSON.parse(jsonStr);
+        }
+        catch {
+            return [];
+        }
+        const moves = parsed?.['moves'];
+        if (!Array.isArray(moves))
+            return [];
+        const out = [];
+        for (const m of moves) {
+            if (!m || typeof m !== 'object')
+                continue;
+            const o = m;
+            const target = typeof o['target'] === 'string' ? o['target'] : '';
+            const content = typeof o['content'] === 'string' ? o['content'] : '';
+            const topic = o['topic'];
+            if (!target || !content || !(0, episodic_1.isValidTopicSlug)(topic))
+                continue;
+            out.push({
+                op: 'add',
+                tier: 'episodic',
+                topic,
+                content,
+                target,
+                reason: typeof o['reason'] === 'string' ? o['reason'] : '',
+                score: 1,
+                recallCount: 0,
+            });
+        }
+        return out;
+    };
+}
+//# sourceMappingURL=migrate.js.map

package/dist/agent/dreaming/migrate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"migrate.js","sourceRoot":"","sources":["../../../src/agent/dreaming/migrate.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA4EH,oCAmBC;AAOD,wCAKC;AA8CD,sCAsGC;AAoDD,oCA0CC;AA3VD,uCAAyB;AACzB,2CAA6B;AAE7B,2CAAsD;AACtD,yCAAwF;AACxF,mCAAuC;AAIvC,kFAAkF;AAClF,MAAM,iBAAiB,GAAG,yDAAyD,CAAC;AACpF,MAAM,UAAU,GAAG,WAAW,CAAC;AAqC/B,SAAS,UAAU,CAAC,QAAgB;IAClC,IAAI,CAAC;QACH,OAAO,EAAE,CAAC,YAAY,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;IAC3C,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;AACH,CAAC;AAED,SAAS,WAAW,CAAC,QAAgB,EAAE,OAAe;IACpD,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;IACnC,EAAE,CAAC,SAAS,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACvC,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,gBAAgB,OAAO,CAAC,GAAG,IAAI,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;IAClG,IAAI,CAAC;QACH,EAAE,CAAC,aAAa,CAAC,GAAG,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC;QACvC,EAAE,CAAC,UAAU,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC;IAC/B,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,IAAI,CAAC;YACH,EAAE,CAAC,MAAM,CAAC,GAAG,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;QAClC,CAAC;QAAC,MAAM,CAAC;YACP,iBAAiB;QACnB,CAAC;QACD,MAAM,GAAG,CAAC;IACZ,CAAC;AACH,CAAC;AAED,wFAAwF;AACxF,SAAgB,YAAY,CAAC,MAAc;IACzC,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IACjC,MAAM,MAAM,GAA4B,EAAE,CAAC;IAC3C,IAAI,MAAM,GAAG,CAAC,CAAC;IACf,IAAI,SAAS,GAAG,CAAC,CAAC,CAAC;IACnB,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,OAAO,GAAG,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,wBAAwB;QACzD,IAAI,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;YAC1B,yDAAyD;YACzD,IAAI,SAAS,IAAI,CAAC,EAAE,CAAC;gBACnB,MAAM,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC,CAAC;gBACjC,SAAS,GAAG,CAAC,CAAC,CAAC;YACjB,CAAC;YACD,IAAI,iBAAiB,CAAC,IAAI,CAAC,IAAI,CAAC;gBAAE,SAAS,GAAG,MAAM,CAAC;QACvD,CAAC;QACD,MAAM,IAAI,OAAO,CAAC;IACpB,CAAC;IACD,IAAI,SAAS,IAAI,CAAC;QAAE,MAAM,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC;IAC5D,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,SAAS,QAAQ,CAAC,KAAa,EAAE,MAA+B;IAC9D,OAAO,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,IAAI,CAAC,IAAI,KAAK,GAAG,CAAC,CAAC,CAAC;AAC1D,CAAC;AAED,qFAAqF;AACrF,SAAgB,cAAc,CAAC,MAAc,EAAE,MAAc;IAC3D,IAAI,CAAC,MAAM;QAAE,OAAO,KAAK,CAAC;IAC1B,MAAM,EAAE,GAAG,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;IAClC,IAAI,EAAE,KAAK,CAAC,CAAC;QAAE,OAAO,KAAK,CAAC;IAC5B,OAAO,QAAQ,CAAC,EAAE,EAAE,YAAY,CAAC,MAAM,CAAC,CAAC,CAAC;AAC5C,CAAC;AAOD;;;;GAIG;AACH,SAAS,SAAS,CAAC,MAAc,EAAE,SAA0B;IAC3D,MAAM,MAAM,GAAG,YAAY,CAAC,MAAM,CAAC,CAAC;IACpC,MAAM,GAAG,GAAkB,EAAE,CAAC;IAC9B,KAAK,MAAM,CAAC,IAAI,SAAS,EAAE,CAAC;QAC1B,IAAI,CAAC,CAAC,IAAI,KAAK,UAAU,IAAI,CAAC,CAAC,EAAE,KAAK,KAAK,IAAI,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC,CAAC,OAAO;YAAE,SAAS;QAChF,MAAM,MAAM,GAAG,CAAC,CAAC,MAAM,IAAI,EAAE,CAAC;QAC9B,IAAI,CAAC,MAAM;YAAE,SAAS;QACtB,MAAM,KAAK,GAAG,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;QACrC,IAAI,KAAK,KAAK,CAAC,CAAC;YAAE,SAAS,CAAC,yBAAyB;QACrD,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,EAAE,KAAK,GAAG,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YAAE,SAAS,CAAC,mBAAmB;QACvF,IAAI,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;YAAE,SAAS,CAAC,8BAA8B;QACrE,GAAG,CAAC,IAAI,CAAC,EAAE,QAAQ,EAAE,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC;IAC1C,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,mFAAmF;AACnF,SAAS,YAAY,CAAC,MAAc,EAAE,OAAsB;IAC1D,IAAI,IAAI,GAAG,MAAM,CAAC;IAClB,MAAM,MAAM,GAAG,CAAC,GAAG,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC;IAC9D,KAAK,MAAM,EAAE,QAAQ,EAAE,KAAK,EAAE,IAAI,MAAM,EAAE,CAAC;QACzC,MAAM,MAAM,GAAG,QAAQ,CAAC,MAAM,IAAI,EAAE,CAAC;QACrC,mEAAmE;QACnE,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC;IAClE,CAAC;IACD,uDAAuD;IACvD,OAAO,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;AACzC,CAAC;AAED;;;;GAIG;AACI,KAAK,UAAU,aAAa,CACjC,YAAoB,EACpB,IAAoB;IAEpB,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,IAAI,IAAI,CAAC,GAAG,EAAE,CAAC;IACnC,MAAM,WAAW,GAAG,IAAI,CAAC,kBAAkB,IAAI,+BAAoB,CAAC;IACpE,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,WAAW,CAAC,CAAC;IACrD,MAAM,MAAM,GAAG,UAAU,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC;IAE1C,8EAA8E;IAC9E,8EAA8E;IAC9E,IAAI,gBAAgB,GAAG,CAAC,CAAC;IACzB,IAAI,CAAC,IAAI,CAAC,iBAAiB,EAAE,CAAC;QAC5B,IAAI,CAAC;YACH,gBAAgB,GAAG,IAAA,mCAAuB,EAAC,YAAY,EAAE,GAAG,CAAC,CAAC,aAAa,CAAC;QAC9E,CAAC;QAAC,MAAM,CAAC;YACP,gBAAgB,GAAG,CAAC,CAAC;QACvB,CAAC;IACH,CAAC;IAED,iEAAiE;IACjE,MAAM,MAAM,GAAG,UAAU,CAAC,OAAO,CAAC,CAAC;IACnC,IAAI,OAAO,GAAkB,EAAE,CAAC;IAChC,IAAI,IAAI,CAAC,QAAQ,IAAI,MAAM,CAAC,IAAI,EAAE,EAAE,CAAC;QACnC,IAAI,SAAS,GAAoB,EAAE,CAAC;QACpC,IAAI,CAAC;YACH,SAAS,GAAG,CAAC,MAAM,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,CAAC;QAClD,CAAC;QAAC,MAAM,CAAC;YACP,SAAS,GAAG,EAAE,CAAC;QACjB,CAAC;QACD,OAAO,GAAG,SAAS,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;IACzC,CAAC;IAED,IAAI,IAAI,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;QAC5B,oEAAoE;QACpE,IAAI,QAA4B,CAAC;QACjC,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,oBAAY,CAAC,CAAC;YAClD,EAAE,CAAC,SAAS,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;YACvC,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,mBAAmB,CAAC,CAAC;YAC/C,MAAM,KAAK,GAAG;gBACZ,uCAAuC;gBACvC,EAAE;gBACF,4BAA4B,gBAAgB,yCAAyC;gBACrF,gCAAgC,OAAO,CAAC,MAAM,WAAW;gBACzD,EAAE;gBACF,4DAA4D;gBAC5D,EAAE;gBACF,GAAG,OAAO,CAAC,GAAG,CACZ,CAAC,CAAC,EAAE,EAAE,CACJ,gBAAgB,CAAC,CAAC,QAAQ,CAAC,KAAK,WAAW,CAAC,CAAC,QAAQ,CAAC,MAAM,IAAI,qBAAqB,IAAI;oBACzF,eAAe,CAAC,CAAC,CAAC,QAAQ,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,MAAM,CAAC,YAAY,CAC9E;gBACD,EAAE;gBACF,iGAAiG;aAClG,CAAC;YACF,WAAW,CAAC,QAAQ,EAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,CAAC;QACjD,CAAC;QAAC,MAAM,CAAC;YACP,QAAQ,GAAG,SAAS,CAAC;QACvB,CAAC;QACD,OAAO;YACL,gBAAgB;YAChB,aAAa,EAAE,CAAC;YAChB,eAAe,EAAE,OAAO,CAAC,MAAM;YAC/B,QAAQ;YACR,iBAAiB,EAAE,MAAM;YACzB,gBAAgB,EAAE,UAAU,CAAC,OAAO,CAAC,CAAC,MAAM;SAC7C,CAAC;IACJ,CAAC;IAED,uEAAuE;IACvE,IAAI,aAAa,GAAG,CAAC,CAAC;IACtB,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACvB,MAAM,KAAK,GAAkB,EAAE,CAAC;QAChC,KAAK,MAAM,CAAC,IAAI,OAAO,EAAE,CAAC;YACxB,MAAM,GAAG,GAAG,IAAA,6BAAkB,EAAC,YAAY,EAAE,WAAW,EAAE,CAAC,CAAC,QAAQ,CAAC,KAAM,EAAE,CAAC,CAAC,QAAQ,CAAC,OAAQ,EAAE,GAAG,CAAC,CAAC;YACvG,IAAI,GAAG,CAAC,EAAE;gBAAE,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAC5B,CAAC;QACD,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACrB,gEAAgE;YAChE,IAAI,UAAU,CAAC,OAAO,CAAC,KAAK,MAAM,EAAE,CAAC;gBACnC,MAAM,IAAI,GAAG,YAAY,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;gBACzC,IAAI,CAAC;oBACH,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,oBAAY,EAAE,SAAS,CAAC,CAAC;oBAC7D,EAAE,CAAC,SAAS,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;oBACvC,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,aAAa,GAAG,cAAc,CAAC,EAAE,MAAM,CAAC,CAAC;gBACtE,CAAC;gBAAC,MAAM,CAAC;oBACP,wBAAwB;gBAC1B,CAAC;gBACD,WAAW,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;gBAC3B,aAAa,GAAG,KAAK,CAAC,MAAM,CAAC;YAC/B,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO;QACL,gBAAgB;QAChB,aAAa;QACb,eAAe,EAAE,OAAO,CAAC,MAAM;QAC/B,iBAAiB,EAAE,MAAM;QACzB,gBAAgB,EAAE,UAAU,CAAC,OAAO,CAAC,CAAC,MAAM;KAC7C,CAAC;AACJ,CAAC;AAED,mFAAmF;AAEnF,MAAM,gBAAgB,GAAG;;;;;;;;wEAQ+C,CAAC;AAEzE,oFAAoF;AACpF,SAAS,WAAW,CAAC,IAAY;IAC/B,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IAChC,IAAI,KAAK,GAAG,CAAC;QAAE,OAAO,IAAI,CAAC;IAC3B,IAAI,KAAK,GAAG,CAAC,CAAC;IACd,IAAI,KAAK,GAAG,KAAK,CAAC;IAClB,IAAI,GAAG,GAAG,KAAK,CAAC;IAChB,KAAK,IAAI,CAAC,GAAG,KAAK,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACzC,MAAM,EAAE,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;QACnB,IAAI,KAAK,EAAE,CAAC;YACV,IAAI,GAAG;gBAAE,GAAG,GAAG,KAAK,CAAC;iBAChB,IAAI,EAAE,KAAK,IAAI;gBAAE,GAAG,GAAG,IAAI,CAAC;iBAC5B,IAAI,EAAE,KAAK,GAAG;gBAAE,KAAK,GAAG,KAAK,CAAC;QACrC,CAAC;aAAM,IAAI,EAAE,KAAK,GAAG;YAAE,KAAK,GAAG,IAAI,CAAC;aAC/B,IAAI,EAAE,KAAK,GAAG;YAAE,KAAK,EAAE,CAAC;aACxB,IAAI,EAAE,KAAK,GAAG,EAAE,CAAC;YACpB,KAAK,EAAE,CAAC;YACR,IAAI,KAAK,KAAK,CAAC;gBAAE,OAAO,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;QACnD,CAAC;IACH,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,oFAAoF;AACpF,SAAS,aAAa,CAAC,MAAc;IACnC,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAA4B,CAAC;QAC1D,OAAO,OAAO,GAAG,CAAC,QAAQ,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAE,GAAG,CAAC,QAAQ,CAAY,CAAC,CAAC,CAAC,MAAM,CAAC;IAChF,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,MAAM,CAAC;IAChB,CAAC;AACH,CAAC;AAED;;;;GAIG;AACH,SAAgB,YAAY,CAAC,KAAoB;IAC/C,OAAO,KAAK,EAAE,MAAc,EAA4B,EAAE;QACxD,MAAM,MAAM,GAAG,GAAG,gBAAgB,yBAAyB,MAAM,6CAA6C,CAAC;QAC/G,IAAI,MAAM,GAAG,EAAE,CAAC;QAChB,IAAI,CAAC;YACH,MAAM,CAAC,GAAG,MAAM,KAAK,CAAC,EAAE,EAAE,MAAM,CAAC,CAAC;YAClC,IAAI,CAAC,CAAC,QAAQ;gBAAE,OAAO,EAAE,CAAC;YAC1B,MAAM,GAAG,CAAC,CAAC,MAAM,CAAC;QACpB,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,EAAE,CAAC;QACZ,CAAC;QACD,MAAM,OAAO,GAAG,WAAW,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC,CAAC;QACnD,IAAI,CAAC,OAAO;YAAE,OAAO,EAAE,CAAC;QACxB,IAAI,MAAe,CAAC;QACpB,IAAI,CAAC;YACH,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QAC/B,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,EAAE,CAAC;QACZ,CAAC;QACD,MAAM,KAAK,GAAI,MAAkC,EAAE,CAAC,OAAO,CAAC,CAAC;QAC7D,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;YAAE,OAAO,EAAE,CAAC;QACrC,MAAM,GAAG,GAAoB,EAAE,CAAC;QAChC,KAAK,MAAM,CAAC,IAAI,KAAK,EAAE,CAAC;YACtB,IAAI,CAAC,CAAC,IAAI,OAAO,CAAC,KAAK,QAAQ;gBAAE,SAAS;YAC1C,MAAM,CAAC,GAAG,CAA4B,CAAC;YACvC,MAAM,MAAM,GAAG,OAAO,CAAC,CAAC,QAAQ,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;YAClE,MAAM,OAAO,GAAG,OAAO,CAAC,CAAC,SAAS,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;YACrE,MAAM,KAAK,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC;YACzB,IAAI,CAAC,MAAM,IAAI,CAAC,OAAO,IAAI,CAAC,IAAA,2BAAgB,EAAC,KAAK,CAAC;gBAAE,SAAS;YAC9D,GAAG,CAAC,IAAI,CAAC;gBACP,EAAE,EAAE,KAAK;gBACT,IAAI,EAAE,UAAU;gBAChB,KAAK;gBACL,OAAO;gBACP,MAAM;gBACN,MAAM,EAAE,OAAO,CAAC,CAAC,QAAQ,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,EAAE;gBAC1D,KAAK,EAAE,CAAC;gBACR,WAAW,EAAE,CAAC;aACf,CAAC,CAAC;QACL,CAAC;QACD,OAAO,GAAG,CAAC;IACb,CAAC,CAAC;AACJ,CAAC"}

package/dist/agent/dreaming/report.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Parse the dream audit trail (`.dreaming/DREAMS.md` + `promotions.jsonl`) into a
+ * structured, newest-first list of runs for the dashboard's "Nightly dreaming" tab.
+ *
+ * DREAMS.md is the source of truth for *every* run (including no-change / skipped
+ * nights) — it carries the header (iso + outcome + mode), summary, and the
+ * tokens/sessions footer. promotions.jsonl carries the structured proposal ops
+ * (with full `content`), all ops of one run sharing that run's `ts`. The two are
+ * joined by `ts` (DREAMS.md's iso parses back to exactly the promotions `ts`).
+ *
+ * Pure + deterministic (no clock, no disk) so it is unit-testable. Both inputs are
+ * untrusted on-disk text — every field is defensively coerced.
+ */
+export interface DreamProposalView {
+    /** Position within its run's proposal list — the accept target the UI sends back. */
+    index: number;
+    op: string;
+    file: string;
+    target?: string;
+    content?: string;
+    reason: string;
+    score: number;
+    recallCount: number;
+    /** True when this proposal was applied to memory via a manual dashboard accept. */
+    accepted: boolean;
+}
+export interface DreamRunReport {
+    ts: number;
+    iso: string;
+    outcome: string;
+    mode: string;
+    summary: string;
+    tokens: number;
+    sessions: number;
+    applied: number | null;
+    proposals: DreamProposalView[];
+}
+export declare function parseDreamReport(dreamsMd: string, promotionsJsonl: string, acceptedJsonl?: string): DreamRunReport[];
+//# sourceMappingURL=report.d.ts.map

package/dist/agent/dreaming/report.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"report.d.ts","sourceRoot":"","sources":["../../../src/agent/dreaming/report.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,MAAM,WAAW,iBAAiB;IAChC,qFAAqF;IACrF,KAAK,EAAE,MAAM,CAAC;IACd,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,mFAAmF;IACnF,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,SAAS,EAAE,iBAAiB,EAAE,CAAC;CAChC;AAyED,wBAAgB,gBAAgB,CAC9B,QAAQ,EAAE,MAAM,EAChB,eAAe,EAAE,MAAM,EACvB,aAAa,SAAK,GACjB,cAAc,EAAE,CA6BlB"}

package/dist/agent/dreaming/report.js

@@ -0,0 +1,121 @@
+"use strict";
+/**
+ * Parse the dream audit trail (`.dreaming/DREAMS.md` + `promotions.jsonl`) into a
+ * structured, newest-first list of runs for the dashboard's "Nightly dreaming" tab.
+ *
+ * DREAMS.md is the source of truth for *every* run (including no-change / skipped
+ * nights) — it carries the header (iso + outcome + mode), summary, and the
+ * tokens/sessions footer. promotions.jsonl carries the structured proposal ops
+ * (with full `content`), all ops of one run sharing that run's `ts`. The two are
+ * joined by `ts` (DREAMS.md's iso parses back to exactly the promotions `ts`).
+ *
+ * Pure + deterministic (no clock, no disk) so it is unit-testable. Both inputs are
+ * untrusted on-disk text — every field is defensively coerced.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseDreamReport = parseDreamReport;
+function groupPromotionsByTs(jsonl, acceptedKeys) {
+    const byTs = new Map();
+    for (const raw of jsonl.split('\n')) {
+        const line = raw.trim();
+        if (!line)
+            continue;
+        let o;
+        try {
+            o = JSON.parse(line);
+        }
+        catch {
+            continue; // skip a malformed line rather than fail the whole report
+        }
+        const ts = Number(o.ts);
+        if (!Number.isFinite(ts))
+            continue;
+        const arr = byTs.get(ts) ?? [];
+        const index = arr.length; // position within this run — the accept target
+        const view = {
+            index,
+            op: String(o.op ?? ''),
+            file: o.tier === 'episodic' && typeof o.topic === 'string'
+                ? `memory/${o.topic}.md`
+                : String(o.file ?? ''),
+            target: typeof o.target === 'string' ? o.target : undefined,
+            content: typeof o.content === 'string' ? o.content : undefined,
+            reason: String(o.reason ?? ''),
+            score: Number(o.score) || 0,
+            recallCount: Number(o.recallCount) || 0,
+            accepted: acceptedKeys.has(`${ts}:${index}`),
+        };
+        arr.push(view);
+        byTs.set(ts, arr);
+    }
+    return byTs;
+}
+/** Parse `accepted.jsonl` into a set of `"<ts>:<index>"` keys. */
+function parseAcceptedKeys(acceptedJsonl) {
+    const keys = new Set();
+    for (const raw of acceptedJsonl.split('\n')) {
+        const line = raw.trim();
+        if (!line)
+            continue;
+        try {
+            const o = JSON.parse(line);
+            const ts = Number(o.ts);
+            const idx = Number(o.index);
+            if (Number.isFinite(ts) && Number.isFinite(idx))
+                keys.add(`${ts}:${idx}`);
+        }
+        catch {
+            /* skip malformed line */
+        }
+    }
+    return keys;
+}
+/** First meaningful prose line(s) after the header, before the first bullet / italic / rule. */
+function extractSummary(sectionLines) {
+    const out = [];
+    for (let i = 1; i < sectionLines.length; i++) {
+        const l = sectionLines[i].trim();
+        if (!l) {
+            if (out.length)
+                break; // blank after we've collected summary → done
+            continue; // leading blank → keep looking
+        }
+        if (l.startsWith('- ') || l.startsWith('_') || l.startsWith('---') || l.startsWith('## '))
+            break;
+        out.push(l);
+    }
+    return out.join(' ');
+}
+function parseDreamReport(dreamsMd, promotionsJsonl, acceptedJsonl = '') {
+    const acceptedKeys = parseAcceptedKeys(acceptedJsonl);
+    const byTs = groupPromotionsByTs(promotionsJsonl, acceptedKeys);
+    const runs = [];
+    // Each run is a "## <iso> — <outcome> (<mode>)" section.
+    const sections = dreamsMd.split(/\n(?=## )/);
+    for (const sec of sections) {
+        const lines = sec.split('\n');
+        const header = lines[0].match(/^## (\S+) — (.+?) \((propose|auto)\)\s*$/);
+        if (!header)
+            continue;
+        const iso = header[1];
+        const ts = Date.parse(iso);
+        if (!Number.isFinite(ts))
+            continue;
+        const tok = sec.match(/_tokens: (\d+), sessions: (\d+)_/);
+        const app = sec.match(/applied (\d+) op/);
+        runs.push({
+            ts,
+            iso,
+            outcome: header[2].trim(),
+            mode: header[3],
+            summary: extractSummary(lines),
+            tokens: tok ? Number(tok[1]) : 0,
+            sessions: tok ? Number(tok[2]) : 0,
+            applied: app ? Number(app[1]) : null,
+            proposals: byTs.get(ts) ?? [],
+        });
+    }
+    runs.sort((a, b) => b.ts - a.ts); // newest first
+    return runs;
+}
+//# sourceMappingURL=report.js.map

package/dist/agent/dreaming/report.js.map

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

package/dist/agent/dreaming/reviewer.d.ts

@@ -0,0 +1,43 @@
+/**
+ * Dream reviewer — turns a lookback transcript slice into memory-consolidation
+ * *proposals*. Same safety model as the skill-learning reviewer:
+ *   - print-only: `claude -p`, NO tools, NO `--dangerously-skip-permissions`.
+ *     The transcript is untrusted (prompt-injection surface); the model can only
+ *     emit a JSON proposal — the gateway, not the model, owns any write. In
+ *     propose mode nothing is written to memory at all.
+ *   - async spawn only (reuses `makeClaudeSpawn`); NEVER `spawnSync`.
+ *   - never throws — any failure resolves to zero proposals.
+ */
+import { type ClaudeSpawnFn } from '../skill-learning/reviewer';
+import type { DreamReviewResult, ResolvedDreamingCfg } from './types';
+export interface DreamReviewerInput {
+    /** The lookback transcript slice to consolidate (already trimmed by the caller). */
+    transcript: string;
+    /** Current MEMORY.md content, so the reviewer proposes deltas, not duplicates. */
+    currentMemory: string;
+    /** Current USER.md content. */
+    currentUser: string;
+    /**
+     * TRUE on-disk size of MEMORY.md in chars (NOT the truncated context above) and
+     * its soft budget. When present and over budget, the reviewer is told to enter
+     * net-shrink mode (#337). Optional so callers/tests can omit budget signalling.
+     */
+    memoryChars?: number;
+    memoryBudget?: number;
+    /**
+     * Write routing (planning-65): when true, the reviewer is told the two-tier
+     * contract (durable → MEMORY.md/USER.md, episodic task-log → memory/<topic>.md)
+     * and may emit `tier:"episodic"` ops. When false/absent it behaves exactly as
+     * before (durable ops only) — a clean kill-switch.
+     */
+    writeRouting?: boolean;
+}
+/** Exposed for tests: the exact prompt fed to the reviewer for a given input. */
+export declare function buildDreamPrompt(input: DreamReviewerInput): string;
+/** Coerce a parsed envelope into a safe review result. Any deviation ⇒ empty proposals. */
+export declare function coerceReview(raw: unknown, tokensSpent: number): DreamReviewResult;
+/**
+ * Run the dream reviewer. Never throws — any failure resolves to zero proposals.
+ */
+export declare function runDreamReviewer(input: DreamReviewerInput, cfg: ResolvedDreamingCfg, spawnFn?: ClaudeSpawnFn): Promise<DreamReviewResult>;
+//# sourceMappingURL=reviewer.d.ts.map

package/dist/agent/dreaming/reviewer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reviewer.d.ts","sourceRoot":"","sources":["../../../src/agent/dreaming/reviewer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAmB,KAAK,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAEjF,OAAO,KAAK,EAAiB,iBAAiB,EAAa,mBAAmB,EAAE,MAAM,SAAS,CAAC;AAEhG,MAAM,WAAW,kBAAkB;IACjC,oFAAoF;IACpF,UAAU,EAAE,MAAM,CAAC;IACnB,kFAAkF;IAClF,aAAa,EAAE,MAAM,CAAC;IACtB,+BAA+B;IAC/B,WAAW,EAAE,MAAM,CAAC;IACpB;;;;OAIG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB;;;;;OAKG;IACH,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB;AAmED,iFAAiF;AACjF,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,kBAAkB,GAAG,MAAM,CAElE;AAqGD,2FAA2F;AAC3F,wBAAgB,YAAY,CAAC,GAAG,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,GAAG,iBAAiB,CAWjF;AAED;;GAEG;AACH,wBAAsB,gBAAgB,CACpC,KAAK,EAAE,kBAAkB,EACzB,GAAG,EAAE,mBAAmB,EACxB,OAAO,CAAC,EAAE,aAAa,GACtB,OAAO,CAAC,iBAAiB,CAAC,CA0C5B"}