@mneme-ai/core 1.91.0 → 1.92.0

package/dist/rainbow/boomerang.d.ts

@@ -0,0 +1,79 @@
+/**
+ * v1.92.0 -- RAINBOW: BOOMERANG (return-pad → MCP-watched inbox).
+ *
+ * Closes the HOMUNCULUS loop without requiring the Web AI to call MCP.
+ *
+ *   Editor AI (Mneme MCP) --soul--> Web AI (chatgpt/gemini)
+ *     ^                                            |
+ *     | inbox.jsonl                               | emits HOMUNCULUS RETURN
+ *     |                                            v
+ *   Mneme MCP watcher    <-- POST /return  --  return-pad (page)
+ *
+ * The page (SAME-SHELL or mobile) has a textarea + Send button. User
+ * pastes the Web AI's full reply (must contain HOMUNCULUS RETURN). The
+ * page POSTs the body to /return. The HTTP server validates + appends
+ * one line to `.mneme/inbox/homunculus-return.jsonl`. Mneme MCP daemon
+ * tails this file and surfaces new entries through the supersonic
+ * pulse so the editor AI sees "[BOOMERANG] new return -- ingest?".
+ *
+ * Zero credentials. Zero webhook. Zero new daemon process. Just append
+ * + tail of a local file that MCP already watches.
+ */
+import { type HomunculusReturn } from "../abyss/homunculus.js";
+export interface BoomerangEntry {
+    /** Stable per-entry id (12-hex). */
+    id: string;
+    /** Wall-clock when ingested. */
+    receivedAt: number;
+    /** Where the return was posted from (lan/same-shell/tunnel). */
+    source: "lan" | "same-shell" | "tunnel" | "manual";
+    /** Raw POST body. */
+    raw: string;
+    /** SHA-256 of raw (dedup signal). */
+    rawSha256: string;
+    /** Parsed HOMUNCULUS RETURN block (null if invalid). */
+    parsed: HomunculusReturn | null;
+    /** Whether the editor AI has acknowledged this entry. */
+    ingested: boolean;
+    /** Free-form note (filled when ingested=true). */
+    ingestNote?: string;
+}
+export interface IngestResult {
+    ok: boolean;
+    id: string;
+    parsed: HomunculusReturn | null;
+    /** Reason on failure (validation/io). */
+    error?: string;
+}
+export interface BoomerangInbox {
+    path: string;
+    ingest(args: {
+        raw: string;
+        source?: BoomerangEntry["source"];
+    }): IngestResult;
+    list(): BoomerangEntry[];
+    pending(): BoomerangEntry[];
+    markIngested(ids: string[], note?: string): number;
+}
+/** Open or create a BOOMERANG inbox at the given JSONL path. */
+export declare function openBoomerangInbox(path: string): BoomerangInbox;
+/** Render a one-line summary of a pending boomerang entry, for the
+ *  supersonic pulse. */
+export declare function formatPulseLine(entry: BoomerangEntry): string;
+/** Server-side helper: validate + handle a /return POST body and
+ *  produce a JSON response payload. Caller wires this into their
+ *  HTTP framework. */
+export interface ReturnPostResult {
+    status: number;
+    body: {
+        ok: boolean;
+        id?: string;
+        error?: string;
+    };
+}
+export declare function handleReturnPost(args: {
+    inbox: BoomerangInbox;
+    body: string;
+    source: BoomerangEntry["source"];
+}): ReturnPostResult;
+//# sourceMappingURL=boomerang.d.ts.map

package/dist/rainbow/boomerang.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"boomerang.d.ts","sourceRoot":"","sources":["../../src/rainbow/boomerang.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAMH,OAAO,EAAyB,KAAK,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAEtF,MAAM,WAAW,cAAc;IAC7B,oCAAoC;IACpC,EAAE,EAAE,MAAM,CAAC;IACX,gCAAgC;IAChC,UAAU,EAAE,MAAM,CAAC;IACnB,gEAAgE;IAChE,MAAM,EAAE,KAAK,GAAG,YAAY,GAAG,QAAQ,GAAG,QAAQ,CAAC;IACnD,qBAAqB;IACrB,GAAG,EAAE,MAAM,CAAC;IACZ,qCAAqC;IACrC,SAAS,EAAE,MAAM,CAAC;IAClB,wDAAwD;IACxD,MAAM,EAAE,gBAAgB,GAAG,IAAI,CAAC;IAChC,yDAAyD;IACzD,QAAQ,EAAE,OAAO,CAAC;IAClB,kDAAkD;IAClD,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,OAAO,CAAC;IACZ,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,gBAAgB,GAAG,IAAI,CAAC;IAChC,yCAAyC;IACzC,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,IAAI,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,cAAc,CAAC,QAAQ,CAAC,CAAA;KAAE,GAAG,YAAY,CAAC;IAC/E,IAAI,IAAI,cAAc,EAAE,CAAC;IACzB,OAAO,IAAI,cAAc,EAAE,CAAC;IAC5B,YAAY,CAAC,GAAG,EAAE,MAAM,EAAE,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;CACpD;AAUD,gEAAgE;AAChE,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,cAAc,CAyE/D;AAED;wBACwB;AACxB,wBAAgB,eAAe,CAAC,KAAK,EAAE,cAAc,GAAG,MAAM,CAU7D;AAED;;sBAEsB;AACtB,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE;QAAE,EAAE,EAAE,OAAO,CAAC;QAAC,EAAE,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CACpD;AAED,wBAAgB,gBAAgB,CAAC,IAAI,EAAE;IAAE,KAAK,EAAE,cAAc,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,cAAc,CAAC,QAAQ,CAAC,CAAA;CAAE,GAAG,gBAAgB,CAMlI"}

package/dist/rainbow/boomerang.js

@@ -0,0 +1,130 @@
+/**
+ * v1.92.0 -- RAINBOW: BOOMERANG (return-pad → MCP-watched inbox).
+ *
+ * Closes the HOMUNCULUS loop without requiring the Web AI to call MCP.
+ *
+ *   Editor AI (Mneme MCP) --soul--> Web AI (chatgpt/gemini)
+ *     ^                                            |
+ *     | inbox.jsonl                               | emits HOMUNCULUS RETURN
+ *     |                                            v
+ *   Mneme MCP watcher    <-- POST /return  --  return-pad (page)
+ *
+ * The page (SAME-SHELL or mobile) has a textarea + Send button. User
+ * pastes the Web AI's full reply (must contain HOMUNCULUS RETURN). The
+ * page POSTs the body to /return. The HTTP server validates + appends
+ * one line to `.mneme/inbox/homunculus-return.jsonl`. Mneme MCP daemon
+ * tails this file and surfaces new entries through the supersonic
+ * pulse so the editor AI sees "[BOOMERANG] new return -- ingest?".
+ *
+ * Zero credentials. Zero webhook. Zero new daemon process. Just append
+ * + tail of a local file that MCP already watches.
+ */
+import { appendFileSync, mkdirSync, existsSync, readFileSync, writeFileSync } from "node:fs";
+import { dirname } from "node:path";
+import { createHash, randomBytes } from "node:crypto";
+import { parseHomunculusReturn } from "../abyss/homunculus.js";
+function sha256(s) {
+    return createHash("sha256").update(s).digest("hex");
+}
+function randomId() {
+    return randomBytes(6).toString("hex");
+}
+/** Open or create a BOOMERANG inbox at the given JSONL path. */
+export function openBoomerangInbox(path) {
+    const dir = dirname(path);
+    if (!existsSync(dir))
+        mkdirSync(dir, { recursive: true });
+    if (!existsSync(path))
+        writeFileSync(path, "", "utf8");
+    function readAll() {
+        const text = readFileSync(path, "utf8");
+        const out = [];
+        for (const line of text.split(/\r?\n/)) {
+            if (!line.trim())
+                continue;
+            try {
+                const obj = JSON.parse(line);
+                out.push(obj);
+            }
+            catch {
+                // skip malformed lines (forward-compat)
+            }
+        }
+        return out;
+    }
+    function writeAll(entries) {
+        const buf = entries.map((e) => JSON.stringify(e)).join("\n") + (entries.length > 0 ? "\n" : "");
+        writeFileSync(path, buf, "utf8");
+    }
+    return {
+        path,
+        ingest({ raw, source }) {
+            if (typeof raw !== "string" || raw.length === 0) {
+                return { ok: false, id: "", parsed: null, error: "empty body" };
+            }
+            if (raw.length > 256 * 1024) {
+                return { ok: false, id: "", parsed: null, error: "body too large (>256KB)" };
+            }
+            const parsed = parseHomunculusReturn(raw);
+            if (!parsed) {
+                return { ok: false, id: "", parsed: null, error: "no HOMUNCULUS RETURN block detected" };
+            }
+            const rawSha256 = sha256(raw);
+            // Dedup: if exact sha already in the inbox, return existing id without re-appending.
+            const existing = readAll().find((e) => e.rawSha256 === rawSha256);
+            if (existing) {
+                return { ok: true, id: existing.id, parsed: existing.parsed };
+            }
+            const entry = {
+                id: randomId(),
+                receivedAt: Date.now(),
+                source: source ?? "manual",
+                raw,
+                rawSha256,
+                parsed,
+                ingested: false,
+            };
+            appendFileSync(path, JSON.stringify(entry) + "\n", "utf8");
+            return { ok: true, id: entry.id, parsed };
+        },
+        list: readAll,
+        pending: () => readAll().filter((e) => !e.ingested),
+        markIngested(ids, note) {
+            const all = readAll();
+            const idSet = new Set(ids);
+            let count = 0;
+            for (const e of all) {
+                if (idSet.has(e.id) && !e.ingested) {
+                    e.ingested = true;
+                    if (note)
+                        e.ingestNote = note;
+                    count++;
+                }
+            }
+            writeAll(all);
+            return count;
+        },
+    };
+}
+/** Render a one-line summary of a pending boomerang entry, for the
+ *  supersonic pulse. */
+export function formatPulseLine(entry) {
+    if (!entry.parsed)
+        return `[BOOMERANG ${entry.id}] (unparsed body, ${entry.raw.length}B)`;
+    const p = entry.parsed;
+    const counts = [
+        p.decisions.length > 0 ? `d:${p.decisions.length}` : null,
+        p.reasoning.length > 0 ? `r:${p.reasoning.length}` : null,
+        p.vaccines.length > 0 ? `v:${p.vaccines.length}` : null,
+        p.nextActions.length > 0 ? `n:${p.nextActions.length}` : null,
+    ].filter(Boolean).join(" ");
+    return `[BOOMERANG ${entry.id}] from ${p.returningFrom} -> ${p.originator} (${counts})`;
+}
+export function handleReturnPost(args) {
+    const r = args.inbox.ingest({ raw: args.body, source: args.source });
+    if (!r.ok) {
+        return { status: 400, body: { ok: false, error: r.error ?? "validation failed" } };
+    }
+    return { status: 200, body: { ok: true, id: r.id } };
+}
+//# sourceMappingURL=boomerang.js.map

package/dist/rainbow/boomerang.js.map

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

package/dist/rainbow/index.d.ts

@@ -16,4 +16,7 @@ export * from "./tunnel.js";
 export * from "./multi_paste.js";
 export * from "./resource_hints.js";
 export * from "./page_renderer.js";
+export * from "./same_shell.js";
+export * from "./phoenix.js";
+export * from "./boomerang.js";
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/rainbow/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC;AAC5B,cAAc,kBAAkB,CAAC;AACjC,cAAc,qBAAqB,CAAC;AACpC,cAAc,oBAAoB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/rainbow/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC;AAC5B,cAAc,kBAAkB,CAAC;AACjC,cAAc,qBAAqB,CAAC;AACpC,cAAc,oBAAoB,CAAC;AACnC,cAAc,iBAAiB,CAAC;AAChC,cAAc,cAAc,CAAC;AAC7B,cAAc,gBAAgB,CAAC"}

package/dist/rainbow/index.js

@@ -16,4 +16,7 @@ export * from "./tunnel.js";
 export * from "./multi_paste.js";
 export * from "./resource_hints.js";
 export * from "./page_renderer.js";
+export * from "./same_shell.js";
+export * from "./phoenix.js";
+export * from "./boomerang.js";
 //# sourceMappingURL=index.js.map

package/dist/rainbow/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/rainbow/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC;AAC5B,cAAc,kBAAkB,CAAC;AACjC,cAAc,qBAAqB,CAAC;AACpC,cAAc,oBAAoB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/rainbow/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC;AAC5B,cAAc,kBAAkB,CAAC;AACjC,cAAc,qBAAqB,CAAC;AACpC,cAAc,oBAAoB,CAAC;AACnC,cAAc,iBAAiB,CAAC;AAChC,cAAc,cAAc,CAAC;AAC7B,cAAc,gBAAgB,CAAC"}

package/dist/rainbow/page_renderer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"page_renderer.d.ts","sourceRoot":"","sources":["../../src/rainbow/page_renderer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,MAAM,CAAC;IACjB,oEAAoE;IACpE,WAAW,CAAC,EAAE,IAAI,GAAG,IAAI,CAAC;CAC3B;AAED,MAAM,WAAW,WAAW;IAC1B,UAAU,EAAE,MAAM,CAAC;IACnB,4EAA4E;IAC5E,KAAK,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,MAAM,CAAA;KAAE,CAAC;IAClC,4DAA4D;IAC5D,IAAI,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,MAAM,CAAA;KAAE,CAAC;IACjC,+CAA+C;IAC/C,UAAU,EAAE,MAAM,CAAC;IACnB,6DAA6D;IAC7D,SAAS,EAAE,OAAO,CAAC;IACnB,uCAAuC;IACvC,QAAQ,EAAE,OAAO,CAAC;IAClB,WAAW,CAAC,EAAE,IAAI,GAAG,IAAI,CAAC;CAC3B;AAmBD,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,eAAe,GAAG,MAAM,CAuG/D;AAED,wBAAgB,YAAY,CAAC,KAAK,EAAE,WAAW,GAAG,MAAM,CAkFvD"}
+{"version":3,"file":"page_renderer.d.ts","sourceRoot":"","sources":["../../src/rainbow/page_renderer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,MAAM,CAAC;IACjB,oEAAoE;IACpE,WAAW,CAAC,EAAE,IAAI,GAAG,IAAI,CAAC;CAC3B;AAED,MAAM,WAAW,WAAW;IAC1B,UAAU,EAAE,MAAM,CAAC;IACnB,4EAA4E;IAC5E,KAAK,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,MAAM,CAAA;KAAE,CAAC;IAClC,4DAA4D;IAC5D,IAAI,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,MAAM,CAAA;KAAE,CAAC;IACjC,+CAA+C;IAC/C,UAAU,EAAE,MAAM,CAAC;IACnB,6DAA6D;IAC7D,SAAS,EAAE,OAAO,CAAC;IACnB,uCAAuC;IACvC,QAAQ,EAAE,OAAO,CAAC;IAClB,WAAW,CAAC,EAAE,IAAI,GAAG,IAAI,CAAC;CAC3B;AAmBD,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,eAAe,GAAG,MAAM,CAuG/D;AAED,wBAAgB,YAAY,CAAC,KAAK,EAAE,WAAW,GAAG,MAAM,CA0FvD"}

package/dist/rainbow/page_renderer.js

@@ -170,6 +170,8 @@ h2{font-size:32px;text-align:center}
 .howto ol{padding-left:28px}
 .howto li{margin:8px 0}
 .warn-soft{background:rgba(241,196,15,0.2);border:1px solid rgba(241,196,15,0.4);padding:18px;border-radius:12px;font-size:17px;line-height:1.5;text-align:center;max-width:600px}
+.stop-help{background:rgba(0,0,0,0.35);padding:16px;border-radius:12px;font-size:14px;line-height:1.6;max-width:600px}
+.stop-help h4{font-size:16px;margin-bottom:8px}
 footer{font-size:14px;opacity:0.7;text-align:center;line-height:1.6;max-width:700px;padding:16px;background:rgba(0,0,0,0.2);border-radius:10px}
 </style></head><body>
 <button class="lang-btn" id="lang">ไทย</button>
@@ -196,6 +198,12 @@ footer{font-size:14px;opacity:0.7;text-align:center;line-height:1.6;max-width:70
 <div class="warn-soft">
   <span data-en="⚠ Honest truth: paste gives the AI READ-ONLY memory. For LIVE Mneme tool execution that AI must have Mneme installed (Cursor / Claude Code / Codex / VS Code MCP). Web AIs (chatgpt.com, gemini.com) read but can NOT call MCP. They CAN suggest next actions back via HOMUNCULUS RETURN block — paste it back to your editor AI to execute." data-th="⚠ ความจริง: paste ให้ AI เห็น MEMORY แบบอ่านอย่างเดียว. ถ้าจะให้ AI เรียก Mneme tools จริง AI ตัวนั้นต้องติดตั้ง Mneme (Cursor / Claude Code / Codex / VS Code MCP). Web AIs อ่านได้แต่เรียก MCP ไม่ได้. แต่มัน suggest next actions กลับมาเป็น HOMUNCULUS RETURN block ได้ — paste กลับไป editor AI เพื่อ execute"></span>
 </div>
+<div class="stop-help">
+  <h4 data-en="🛑 What the STOP button does" data-th="🛑 ปุ่ม STOP ทำอะไร"></h4>
+  <div data-en="Press STOP when you're DONE. It shuts down: (1) the local LAN server on this PC, (2) the public tunnel (if any), and (3) makes this page stop working. The QR will 404." data-th="กด STOP ตอนเสร็จแล้ว — มันจะปิด: (1) LAN server บน PC, (2) public tunnel (ถ้ามี), (3) หน้านี้จะใช้ไม่ได้แล้ว และ QR จะ 404"></div>
+  <div style="margin-top:8px" data-en="If you DON'T press STOP: server keeps running until you close this terminal or reboot. That's fine — it's local only. Public quick-tunnels self-expire after ~30 min of idle anyway." data-th="ถ้าไม่กด STOP: server จะรันไปเรื่อยๆ จนกว่าจะปิด terminal หรือ reboot. ไม่อันตราย เพราะเป็น local only. ส่วน quick-tunnel จะตายเองหลัง idle ~30 นาที"></div>
+  <div style="margin-top:8px" data-en="Closed the browser by accident? Just say to your editor AI: 'show handoff again'. The page regenerates with a fresh URL." data-th="เผลอปิด browser ไปแล้ว? บอก editor AI ของคุณ: 'show handoff again' หน้าจะ generate ใหม่พร้อม URL ใหม่"></div>
+</div>
 <footer>
   <span data-en="Soul ${input.soulTokens} tokens · ${tunnelMention}LAN :7741${pasteMention}" data-th="สมอง ${input.soulTokens} โทเค็น · ${tunnelMention}LAN :7741${pasteMention}"></span><br>
   <span data-en="Done? Click the red STOP button at top-right." data-th="เสร็จแล้ว? กดปุ่ม STOP สีแดงมุมขวาบน"></span>

package/dist/rainbow/page_renderer.js.map

@@ -1 +1 @@
-{"version":3,"file":"page_renderer.js","sourceRoot":"","sources":["../../src/rainbow/page_renderer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAuBH,SAAS,MAAM,CAAC,CAAS;IACvB,OAAO,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,eAAe,EAAE,QAAQ,CAAC,CAAC;AAC9D,CAAC;AAED,SAAS,UAAU,CAAC,CAAS;IAC3B,OAAO,CAAC;SACL,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC;SACtB,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC;SACrB,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC;SACrB,OAAO,CAAC,IAAI,EAAE,QAAQ,CAAC;SACvB,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;AAC5B,CAAC;AAED,SAAS,UAAU,CAAC,OAAe,EAAE,IAAI,GAAG,GAAG;IAC7C,OAAO,oDAAoD,IAAI,IAAI,IAAI,8BAA8B,kBAAkB,CAAC,OAAO,CAAC,EAAE,CAAC;AACrI,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,KAAsB;IACrD,MAAM,IAAI,GAAG,KAAK,CAAC,WAAW,IAAI,IAAI,CAAC;IACvC,OAAO,8BAA8B,IAAI;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;eA6D5B,MAAM,CAAC,KAAK,CAAC,QAAQ,CAAC;aACxB,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;wBAsCT,CAAC;AACzB,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,KAAkB;IAC7C,MAAM,IAAI,GAAG,KAAK,CAAC,WAAW,IAAI,IAAI,CAAC;IACvC,MAAM,OAAO,GAAG,UAAU,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;IAC3C,MAAM,OAAO,GAAG,UAAU,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;IAC3C,MAAM,MAAM,GAAG,UAAU,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACzC,MAAM,MAAM,GAAG,UAAU,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACzC,MAAM,GAAG,GAAG,UAAU,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;IACzC,MAAM,aAAa,GAAG,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC,sBAAsB,CAAC,CAAC,CAAC,EAAE,CAAC;IACpE,MAAM,YAAY,GAAG,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,mBAAmB,CAAC,CAAC,CAAC,EAAE,CAAC;IAE/D,OAAO,8BAA8B,IAAI;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;gCAiCX,OAAO,cAAc,OAAO;;kCAE1B,UAAU,CAAC,UAAU,CAAC,KAAK,CAAC,UAAU,EAAE,GAAG,CAAC,CAAC;qBAC1D,GAAG;+BACO,MAAM,cAAc,MAAM;;;;;;;;;;;;;;;wBAejC,KAAK,CAAC,UAAU,aAAa,aAAa,YAAY,YAAY,mBAAmB,KAAK,CAAC,UAAU,aAAa,aAAa,YAAY,YAAY;;;;;aAKlK,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC;;;;;;;;;;sBAUX,MAAM,CAAC,KAAK,CAAC,UAAU,CAAC;;;;eAI/B,CAAC;AAChB,CAAC"}
+{"version":3,"file":"page_renderer.js","sourceRoot":"","sources":["../../src/rainbow/page_renderer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAuBH,SAAS,MAAM,CAAC,CAAS;IACvB,OAAO,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,eAAe,EAAE,QAAQ,CAAC,CAAC;AAC9D,CAAC;AAED,SAAS,UAAU,CAAC,CAAS;IAC3B,OAAO,CAAC;SACL,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC;SACtB,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC;SACrB,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC;SACrB,OAAO,CAAC,IAAI,EAAE,QAAQ,CAAC;SACvB,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;AAC5B,CAAC;AAED,SAAS,UAAU,CAAC,OAAe,EAAE,IAAI,GAAG,GAAG;IAC7C,OAAO,oDAAoD,IAAI,IAAI,IAAI,8BAA8B,kBAAkB,CAAC,OAAO,CAAC,EAAE,CAAC;AACrI,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,KAAsB;IACrD,MAAM,IAAI,GAAG,KAAK,CAAC,WAAW,IAAI,IAAI,CAAC;IACvC,OAAO,8BAA8B,IAAI;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;eA6D5B,MAAM,CAAC,KAAK,CAAC,QAAQ,CAAC;aACxB,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;wBAsCT,CAAC;AACzB,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,KAAkB;IAC7C,MAAM,IAAI,GAAG,KAAK,CAAC,WAAW,IAAI,IAAI,CAAC;IACvC,MAAM,OAAO,GAAG,UAAU,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;IAC3C,MAAM,OAAO,GAAG,UAAU,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;IAC3C,MAAM,MAAM,GAAG,UAAU,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACzC,MAAM,MAAM,GAAG,UAAU,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACzC,MAAM,GAAG,GAAG,UAAU,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;IACzC,MAAM,aAAa,GAAG,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC,sBAAsB,CAAC,CAAC,CAAC,EAAE,CAAC;IACpE,MAAM,YAAY,GAAG,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,mBAAmB,CAAC,CAAC,CAAC,EAAE,CAAC;IAE/D,OAAO,8BAA8B,IAAI;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;gCAmCX,OAAO,cAAc,OAAO;;kCAE1B,UAAU,CAAC,UAAU,CAAC,KAAK,CAAC,UAAU,EAAE,GAAG,CAAC,CAAC;qBAC1D,GAAG;+BACO,MAAM,cAAc,MAAM;;;;;;;;;;;;;;;;;;;;;wBAqBjC,KAAK,CAAC,UAAU,aAAa,aAAa,YAAY,YAAY,mBAAmB,KAAK,CAAC,UAAU,aAAa,aAAa,YAAY,YAAY;;;;;aAKlK,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC;;;;;;;;;;sBAUX,MAAM,CAAC,KAAK,CAAC,UAAU,CAAC;;;;eAI/B,CAAC;AAChB,CAAC"}

package/dist/rainbow/phoenix.d.ts

@@ -0,0 +1,72 @@
+/**
+ * v1.92.0 -- RAINBOW: PHOENIX (tunnel watchdog + URL push).
+ *
+ * Quick tunnels (`cloudflared tunnel --url http://localhost:PORT`) die.
+ * They die when the process exits, when idle ~30 min, or randomly when
+ * the Cloudflare edge garbage-collects them. The user scans a QR five
+ * minutes later and gets HTTP 404.
+ *
+ * PHOENIX:
+ *   1. Periodically probes the tunnel URL with HEAD / GET.
+ *   2. If the probe fails N consecutive times -> respawn cloudflared.
+ *   3. Calls every onUrlChange listener with the new URL.
+ *   4. Exposes a /events SSE endpoint so the served PC + mobile pages
+ *      can subscribe and re-render their QR LIVE when the URL changes
+ *      -- without the user reopening the page.
+ *
+ * The page on the phone never has to be reloaded. The wizard never has
+ * to confess "the URL died."
+ */
+export interface TunnelProbeResult {
+    url: string;
+    ok: boolean;
+    status: number | null;
+    elapsedMs: number;
+    /** Reason for failure (network, http status, etc). */
+    reason?: string;
+}
+export interface PhoenixOptions {
+    /** Initial tunnel URL (already-spawned tunnel from startQuickTunnel). */
+    initialUrl: string;
+    /** Probe interval in ms. Default 30_000. */
+    probeIntervalMs?: number;
+    /** Consecutive failures before respawn. Default 2. */
+    failuresBeforeRespawn?: number;
+    /** Function to probe the URL. Default: fetch HEAD. */
+    probeFn?: (url: string) => Promise<TunnelProbeResult>;
+    /** Function that respawns the tunnel + returns the new URL. */
+    respawnFn: () => Promise<string | null>;
+    /** Optional logger. */
+    log?: (msg: string) => void;
+}
+export interface PhoenixHandle {
+    getUrl(): string;
+    /** Subscribe to URL changes. Returns an unsubscribe function. */
+    onUrlChange(cb: (newUrl: string, oldUrl: string) => void): () => void;
+    /** History of every probe + respawn (newest last). */
+    getHistory(): Array<{
+        when: number;
+        kind: "probe" | "respawn";
+        ok: boolean;
+        url: string;
+        note?: string;
+    }>;
+    /** Stop the watchdog. Tunnel itself is NOT killed -- caller owns it. */
+    stop(): void;
+}
+export declare function createPhoenix(opts: PhoenixOptions): PhoenixHandle;
+/** Inline JS for the served page so it can SUBSCRIBE to URL changes via
+ *  Server-Sent Events. The page polls /events; when the server emits a
+ *  url-change event, the page replaces its QR <img> src + URL text.
+ *
+ *  Server side: open SSE response, send `event: url-change\ndata: NEW_URL\n\n`
+ *  each time PHOENIX fires onUrlChange. */
+export declare function renderPhoenixSubscriberScript(input: {
+    eventsUrl: string;
+    qrImgId: string;
+    urlTextId: string;
+}): string;
+/** Format the SSE wire payload for a single url-change event. Server
+ *  writes this byte sequence to the response body. */
+export declare function formatUrlChangeSseFrame(newUrl: string): string;
+//# sourceMappingURL=phoenix.d.ts.map

package/dist/rainbow/phoenix.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"phoenix.d.ts","sourceRoot":"","sources":["../../src/rainbow/phoenix.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAIH,MAAM,WAAW,iBAAiB;IAChC,GAAG,EAAE,MAAM,CAAC;IACZ,EAAE,EAAE,OAAO,CAAC;IACZ,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;IAClB,sDAAsD;IACtD,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,cAAc;IAC7B,yEAAyE;IACzE,UAAU,EAAE,MAAM,CAAC;IACnB,4CAA4C;IAC5C,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,sDAAsD;IACtD,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B,sDAAsD;IACtD,OAAO,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,iBAAiB,CAAC,CAAC;IACtD,+DAA+D;IAC/D,SAAS,EAAE,MAAM,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IACxC,uBAAuB;IACvB,GAAG,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;CAC7B;AAED,MAAM,WAAW,aAAa;IAC5B,MAAM,IAAI,MAAM,CAAC;IACjB,iEAAiE;IACjE,WAAW,CAAC,EAAE,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,KAAK,IAAI,GAAG,MAAM,IAAI,CAAC;IACtE,sDAAsD;IACtD,UAAU,IAAI,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,OAAO,GAAG,SAAS,CAAC;QAAC,EAAE,EAAE,OAAO,CAAC;QAAC,GAAG,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC1G,wEAAwE;IACxE,IAAI,IAAI,IAAI,CAAC;CACd;AA8BD,wBAAgB,aAAa,CAAC,IAAI,EAAE,cAAc,GAAG,aAAa,CAsEjE;AAED;;;;;2CAK2C;AAC3C,wBAAgB,6BAA6B,CAAC,KAAK,EAAE;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,CAgBtH;AAED;sDACsD;AACtD,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAK9D"}

package/dist/rainbow/phoenix.js

@@ -0,0 +1,159 @@
+/**
+ * v1.92.0 -- RAINBOW: PHOENIX (tunnel watchdog + URL push).
+ *
+ * Quick tunnels (`cloudflared tunnel --url http://localhost:PORT`) die.
+ * They die when the process exits, when idle ~30 min, or randomly when
+ * the Cloudflare edge garbage-collects them. The user scans a QR five
+ * minutes later and gets HTTP 404.
+ *
+ * PHOENIX:
+ *   1. Periodically probes the tunnel URL with HEAD / GET.
+ *   2. If the probe fails N consecutive times -> respawn cloudflared.
+ *   3. Calls every onUrlChange listener with the new URL.
+ *   4. Exposes a /events SSE endpoint so the served PC + mobile pages
+ *      can subscribe and re-render their QR LIVE when the URL changes
+ *      -- without the user reopening the page.
+ *
+ * The page on the phone never has to be reloaded. The wizard never has
+ * to confess "the URL died."
+ */
+import { setTimeout as nodeSetTimeout, clearTimeout as nodeClearTimeout } from "node:timers";
+const HISTORY_MAX = 50;
+/** Default probe: HEAD request with 8s timeout. A 5xx still counts as
+ *  "tunnel alive" because the LAN server is reachable through it.
+ *  A 4xx from cloudflared edge (specifically 530/521/404) means the
+ *  tunnel itself is dead. */
+async function defaultProbe(url) {
+    const t0 = Date.now();
+    const controller = new AbortController();
+    const timer = nodeSetTimeout(() => controller.abort(), 8000);
+    try {
+        const r = await fetch(url, { method: "HEAD", signal: controller.signal });
+        nodeClearTimeout(timer);
+        const elapsedMs = Date.now() - t0;
+        const isDead = r.status === 404 || r.status === 530 || r.status === 521 || r.status === 502;
+        return {
+            url,
+            ok: !isDead,
+            status: r.status,
+            elapsedMs,
+            reason: isDead ? `tunnel edge returned ${r.status}` : undefined,
+        };
+    }
+    catch (e) {
+        nodeClearTimeout(timer);
+        return { url, ok: false, status: null, elapsedMs: Date.now() - t0, reason: e.message };
+    }
+}
+export function createPhoenix(opts) {
+    let url = opts.initialUrl;
+    const probeIntervalMs = opts.probeIntervalMs ?? 30_000;
+    const failuresBeforeRespawn = opts.failuresBeforeRespawn ?? 2;
+    const probe = opts.probeFn ?? defaultProbe;
+    const log = opts.log ?? (() => undefined);
+    const listeners = [];
+    const history = [];
+    let consecutiveFailures = 0;
+    let stopped = false;
+    let timer = null;
+    function record(entry) {
+        history.push(entry);
+        if (history.length > HISTORY_MAX)
+            history.shift();
+    }
+    async function tick() {
+        if (stopped)
+            return;
+        try {
+            const r = await probe(url);
+            record({ when: Date.now(), kind: "probe", ok: r.ok, url, note: r.reason });
+            log(`probe ${url} ok=${r.ok} status=${r.status} elapsed=${r.elapsedMs}ms`);
+            if (r.ok) {
+                consecutiveFailures = 0;
+            }
+            else {
+                consecutiveFailures++;
+                if (consecutiveFailures >= failuresBeforeRespawn) {
+                    consecutiveFailures = 0;
+                    log(`tunnel dead (${r.reason ?? "unknown"}) -- respawning`);
+                    const newUrl = await opts.respawnFn();
+                    if (newUrl && newUrl !== url) {
+                        const oldUrl = url;
+                        url = newUrl;
+                        record({ when: Date.now(), kind: "respawn", ok: true, url: newUrl, note: `replaced ${oldUrl}` });
+                        log(`tunnel respawned: ${oldUrl} -> ${newUrl}`);
+                        for (const cb of [...listeners]) {
+                            try {
+                                cb(newUrl, oldUrl);
+                            }
+                            catch { /* swallow */ }
+                        }
+                    }
+                    else {
+                        record({ when: Date.now(), kind: "respawn", ok: false, url, note: "respawnFn returned null" });
+                        log(`respawn failed -- staying on ${url}`);
+                    }
+                }
+            }
+        }
+        catch (e) {
+            record({ when: Date.now(), kind: "probe", ok: false, url, note: e.message });
+        }
+        if (!stopped)
+            timer = nodeSetTimeout(tick, probeIntervalMs);
+    }
+    // First probe happens after one interval, not immediately, so the
+    // initial tunnel has time to settle.
+    timer = nodeSetTimeout(tick, probeIntervalMs);
+    return {
+        getUrl: () => url,
+        onUrlChange: (cb) => {
+            listeners.push(cb);
+            return () => {
+                const i = listeners.indexOf(cb);
+                if (i >= 0)
+                    listeners.splice(i, 1);
+            };
+        },
+        getHistory: () => history.slice(),
+        stop: () => {
+            stopped = true;
+            if (timer) {
+                nodeClearTimeout(timer);
+                timer = null;
+            }
+        },
+    };
+}
+/** Inline JS for the served page so it can SUBSCRIBE to URL changes via
+ *  Server-Sent Events. The page polls /events; when the server emits a
+ *  url-change event, the page replaces its QR <img> src + URL text.
+ *
+ *  Server side: open SSE response, send `event: url-change\ndata: NEW_URL\n\n`
+ *  each time PHOENIX fires onUrlChange. */
+export function renderPhoenixSubscriberScript(input) {
+    const eventsUrl = JSON.stringify(input.eventsUrl);
+    const qrId = JSON.stringify(input.qrImgId);
+    const urlId = JSON.stringify(input.urlTextId);
+    return `(function(){
+  if (typeof EventSource === "undefined") return;
+  var es = new EventSource(${eventsUrl});
+  es.addEventListener("url-change", function(ev) {
+    var newUrl = ev.data;
+    var img = document.getElementById(${qrId});
+    if (img) img.src = "https://api.qrserver.com/v1/create-qr-code/?size=360x360&format=svg&margin=10&data=" + encodeURIComponent(newUrl);
+    var txt = document.getElementById(${urlId});
+    if (txt) txt.textContent = newUrl;
+  });
+  es.addEventListener("error", function() { /* auto-reconnects */ });
+})();`;
+}
+/** Format the SSE wire payload for a single url-change event. Server
+ *  writes this byte sequence to the response body. */
+export function formatUrlChangeSseFrame(newUrl) {
+    // Strip newlines from URL just in case (URL spec doesn't allow them
+    // but be defensive).
+    const safe = String(newUrl).replace(/\r?\n/g, "");
+    return `event: url-change\ndata: ${safe}\n\n`;
+}
+//# sourceMappingURL=phoenix.js.map

package/dist/rainbow/phoenix.js.map

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

package/dist/rainbow/same_shell.d.ts

@@ -0,0 +1,34 @@
+/**
+ * v1.92.0 -- RAINBOW: SAME-SHELL (same-machine 1-click clone).
+ *
+ * The forgotten case: when the user is on ONE machine running editor AI
+ * (Cursor / Claude Code) AND wants to continue with Web AI (ChatGPT.com,
+ * Gemini.com) in a browser ON THE SAME machine, the existing RAINBOW
+ * path forces them through QR → tunnel → phone scan → page → copy →
+ * back to PC → paste. Eight steps for a zero-network handoff.
+ *
+ * SAME-SHELL collapses this to two steps:
+ *
+ *   1. Editor AI:  mneme.rainbow.show_local()
+ *      → opens default browser at http://localhost:PORT
+ *      → page auto-copies soul to clipboard on load
+ *
+ *   2. User opens chatgpt.com/gemini.com/claude.ai (link on page),
+ *      Ctrl+V, done.
+ *
+ * Zero QR. Zero tunnel. Zero dpaste. Zero risk of 404 because no
+ * external network is involved at all. THIS IS THE FASTEST PATH AND
+ * THE LEAST FRAGILE -- but we never told the user it existed.
+ */
+export interface SameShellPageInput {
+    soulText: string;
+    /** Port the local HTTP server is on. Used in the URL displayed for context. */
+    port: number;
+    defaultLang?: "en" | "th";
+    /** If set, the page shows a return-pad textarea posting to `${returnEndpoint}`. */
+    returnEndpoint?: string;
+}
+/** Render the same-machine page. Single big COPY button + auto-clipboard
+ *  on load + four AI deep-links. */
+export declare function renderSameShellPage(input: SameShellPageInput): string;
+//# sourceMappingURL=same_shell.d.ts.map

package/dist/rainbow/same_shell.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"same_shell.d.ts","sourceRoot":"","sources":["../../src/rainbow/same_shell.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,MAAM,WAAW,kBAAkB;IACjC,QAAQ,EAAE,MAAM,CAAC;IACjB,+EAA+E;IAC/E,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,IAAI,GAAG,IAAI,CAAC;IAC1B,mFAAmF;IACnF,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAeD;oCACoC;AACpC,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,kBAAkB,GAAG,MAAM,CAmIrE"}

package/dist/rainbow/same_shell.js

@@ -0,0 +1,167 @@
+/**
+ * v1.92.0 -- RAINBOW: SAME-SHELL (same-machine 1-click clone).
+ *
+ * The forgotten case: when the user is on ONE machine running editor AI
+ * (Cursor / Claude Code) AND wants to continue with Web AI (ChatGPT.com,
+ * Gemini.com) in a browser ON THE SAME machine, the existing RAINBOW
+ * path forces them through QR → tunnel → phone scan → page → copy →
+ * back to PC → paste. Eight steps for a zero-network handoff.
+ *
+ * SAME-SHELL collapses this to two steps:
+ *
+ *   1. Editor AI:  mneme.rainbow.show_local()
+ *      → opens default browser at http://localhost:PORT
+ *      → page auto-copies soul to clipboard on load
+ *
+ *   2. User opens chatgpt.com/gemini.com/claude.ai (link on page),
+ *      Ctrl+V, done.
+ *
+ * Zero QR. Zero tunnel. Zero dpaste. Zero risk of 404 because no
+ * external network is involved at all. THIS IS THE FASTEST PATH AND
+ * THE LEAST FRAGILE -- but we never told the user it existed.
+ */
+function jsSafe(s) {
+    return JSON.stringify(s).replace(/<\/(script)/gi, "<\\/$1");
+}
+function escapeHtml(s) {
+    return s
+        .replace(/&/g, "&amp;")
+        .replace(/</g, "&lt;")
+        .replace(/>/g, "&gt;")
+        .replace(/"/g, "&quot;")
+        .replace(/'/g, "&#39;");
+}
+/** Render the same-machine page. Single big COPY button + auto-clipboard
+ *  on load + four AI deep-links. */
+export function renderSameShellPage(input) {
+    const lang = input.defaultLang ?? "en";
+    const port = Math.max(1, Math.floor(input.port));
+    const returnEndpoint = input.returnEndpoint ?? null;
+    return `<!doctype html><html lang="${lang}"><head>
+<meta charset="utf-8"><meta name="viewport" content="width=device-width,initial-scale=1">
+<title>Mneme — Clone to another AI on this PC</title>
+<style>
+*{box-sizing:border-box;margin:0;padding:0}
+body{font-family:-apple-system,"Segoe UI",sans-serif;background:linear-gradient(135deg,#16a085 0%,#2c3e50 100%);color:#fff;min-height:100vh;padding:32px 24px}
+.wrap{max-width:760px;margin:0 auto;display:flex;flex-direction:column;gap:22px}
+.lang-btn{position:fixed;top:14px;right:14px;background:rgba(0,0,0,0.4);border:0;color:#fff;padding:10px 18px;border-radius:8px;font-weight:700;cursor:pointer}
+h1{font-size:38px;text-align:center;font-weight:800}
+.tagline{font-size:19px;opacity:0.92;text-align:center;line-height:1.5}
+.copy-btn{background:#fff;color:#16a085;border:0;padding:28px;border-radius:18px;font-weight:800;font-size:24px;cursor:pointer;box-shadow:0 14px 30px rgba(0,0,0,0.4);width:100%}
+.copy-btn:active{transform:scale(0.98)}
+.copy-btn.done{background:#27ae60;color:#fff}
+.grid{display:grid;grid-template-columns:1fr 1fr;gap:14px}
+.grid a{display:flex;flex-direction:column;align-items:center;gap:6px;background:rgba(255,255,255,0.18);padding:22px 14px;border-radius:14px;text-decoration:none;color:#fff;font-weight:700;font-size:17px;border:2px solid rgba(255,255,255,0.1)}
+.grid a:hover{background:rgba(255,255,255,0.28);border-color:rgba(255,255,255,0.4)}
+.grid a span.hint{font-size:12px;opacity:0.7;font-weight:500}
+.matrix{background:rgba(0,0,0,0.3);padding:22px;border-radius:14px;font-size:15px;line-height:1.6}
+.matrix h3{font-size:19px;margin-bottom:12px}
+.matrix table{width:100%;border-collapse:collapse;font-size:14px}
+.matrix td{padding:8px 4px;border-bottom:1px solid rgba(255,255,255,0.15)}
+.matrix td:last-child{text-align:center;font-weight:700;width:42px}
+.return-pad{background:rgba(0,0,0,0.4);padding:22px;border-radius:14px;display:flex;flex-direction:column;gap:14px}
+.return-pad h3{font-size:20px}
+.return-pad textarea{width:100%;min-height:140px;padding:14px;border-radius:10px;border:0;font-family:monospace;font-size:13px;background:rgba(255,255,255,0.95);color:#222}
+.return-pad button{background:#9b59b6;color:#fff;border:0;padding:18px;border-radius:12px;font-weight:800;font-size:18px;cursor:pointer}
+.return-pad button:active{transform:scale(0.98)}
+.return-pad .status{font-size:14px;opacity:0.9;text-align:center}
+footer{font-size:13px;opacity:0.7;text-align:center;line-height:1.6}
+</style></head><body>
+<button class="lang-btn" id="lang">ไทย</button>
+<div class="wrap">
+<h1 data-en="🧬 Clone to another AI on this PC" data-th="🧬 Clone ไป AI ตัวอื่นบนเครื่องนี้"></h1>
+<div class="tagline" data-en="Brain already copied to clipboard. Click an AI below, paste (Ctrl+V), continue." data-th="ความจำก๊อปลง clipboard แล้ว. กด AI ข้างล่าง, paste (Ctrl+V), คุยต่อได้เลย"></div>
+<button class="copy-btn" id="c" data-en="📋 Copy brain again" data-th="📋 ก๊อปสมองอีกครั้ง"></button>
+<div class="grid">
+  <a href="https://chatgpt.com/" target="_blank" id="lk-cg">🟢 <span>ChatGPT</span><span class="hint" data-en="opens in new tab" data-th="เปิด tab ใหม่"></span></a>
+  <a href="https://gemini.google.com/app" target="_blank" id="lk-gm">🔵 <span>Gemini</span><span class="hint" data-en="opens in new tab" data-th="เปิด tab ใหม่"></span></a>
+  <a href="https://claude.ai/new" target="_blank" id="lk-cl">🟣 <span>Claude</span><span class="hint" data-en="opens in new tab" data-th="เปิด tab ใหม่"></span></a>
+  <a href="https://www.perplexity.ai/" target="_blank" id="lk-pp">⚪ <span>Perplexity</span><span class="hint" data-en="opens in new tab" data-th="เปิด tab ใหม่"></span></a>
+</div>
+<div class="matrix">
+  <h3 data-en="🎯 Paste-only — what works / what doesn't" data-th="🎯 Paste-only ใช้ทำอะไรได้/ไม่ได้"></h3>
+  <table>
+    <tr><td data-en="On a train, only have your phone" data-th="อยู่บนรถไฟ มีแค่มือถือ"></td><td>✅</td></tr>
+    <tr><td data-en="Switch models for a second opinion" data-th="อยากเปลี่ยน model ดู second opinion"></td><td>✅</td></tr>
+    <tr><td data-en="Share with a teammate (PM, designer)" data-th="ส่งให้เพื่อน/PM/designer คุยต่อ"></td><td>✅</td></tr>
+    <tr><td data-en="Backup the whole conversation" data-th="Backup บทสนทนา"></td><td>✅</td></tr>
+    <tr><td data-en="Brainstorm with the best model per task" data-th="Brainstorm กับ model ที่เก่งสุดต่อ task"></td><td>✅</td></tr>
+    <tr><td data-en="Call Mneme tools (apoptosis / scan / audit)" data-th="เรียก Mneme tools (apoptosis / scan / audit)"></td><td>❌</td></tr>
+    <tr><td data-en="Read .mneme/ files on your PC" data-th="อ่าน .mneme/ บน PC"></td><td>❌</td></tr>
+    <tr><td data-en="Upgrade Mneme / install" data-th="อัปเกรด Mneme / install"></td><td>❌</td></tr>
+    <tr><td data-en="Modify your code" data-th="แก้ code ของคุณ"></td><td>❌</td></tr>
+  </table>
+  <div style="margin-top:14px;padding:12px;background:rgba(255,255,255,0.1);border-radius:8px;font-size:13px;line-height:1.6">
+    <span data-en="✱ The Web AI can SUGGEST next actions back via HOMUNCULUS RETURN block. Paste that back below, your editor AI executes it. Web AI = brain. Editor AI = hands. You = courier (2 paste ops)." data-th="✱ Web AI สามารถ SUGGEST next actions กลับมาเป็น HOMUNCULUS RETURN block ได้. paste กลับช่องล่าง editor AI ของคุณจะ execute. Web AI = สมอง. Editor AI = มือ. คุณ = courier (paste 2 ครั้ง)"></span>
+  </div>
+</div>
+${returnEndpoint ? `<div class="return-pad">
+  <h3 data-en="🪃 BOOMERANG — paste the Web AI reply back here" data-th="🪃 BOOMERANG — paste คำตอบ Web AI กลับมาตรงนี้"></h3>
+  <div style="font-size:14px;opacity:0.92;line-height:1.5" data-en="Paste the Web AI's full reply (must include the HOMUNCULUS RETURN block). Your editor AI on this PC will pick it up via Mneme MCP and surface next_actions for execution." data-th="paste คำตอบ Web AI ทั้งหมด (ต้องมี HOMUNCULUS RETURN block). editor AI บนเครื่องนี้จะรับผ่าน Mneme MCP แล้วโชว์ next_actions ให้ execute"></div>
+  <textarea id="rp" placeholder="# HOMUNCULUS RETURN&#10;originator: claude-opus-4-7&#10;returning_from: gemini-2.5-pro&#10;..."></textarea>
+  <button id="rb" data-en="🪃 Send back to editor AI" data-th="🪃 ส่งกลับ editor AI"></button>
+  <div class="status" id="rs"></div>
+</div>` : ""}
+<footer>
+  <span data-en="localhost:${port} · same-machine handoff · no QR, no tunnel, no network needed" data-th="localhost:${port} · ส่งผ่านเครื่องเดียวกัน · ไม่ต้องใช้ QR / tunnel / network"></span>
+</footer>
+</div>
+<script>
+const SOUL = ${jsSafe(input.soulText)};
+let lang = ${JSON.stringify(lang)};
+function applyLang() {
+  document.querySelectorAll("[data-en]").forEach(el => { el.textContent = el.dataset[lang] || el.dataset.en; });
+  document.getElementById("lang").textContent = lang === "en" ? "ไทย" : "EN";
+  document.documentElement.lang = lang;
+}
+applyLang();
+document.getElementById("lang").onclick = () => { lang = lang === "en" ? "th" : "en"; applyLang(); };
+
+async function copySoul(showToast) {
+  try {
+    if (navigator.clipboard && window.isSecureContext) {
+      await navigator.clipboard.writeText(SOUL);
+    } else { throw new Error("no clipboard api"); }
+    const c = document.getElementById("c");
+    c.classList.add("done");
+    c.textContent = lang === "th" ? "✓ ก๊อปแล้ว — paste ได้เลย" : "✓ Copied — ready to paste";
+    if (showToast === false) return;
+    setTimeout(() => {
+      c.classList.remove("done");
+      c.textContent = lang === "th" ? "📋 ก๊อปสมองอีกครั้ง" : "📋 Copy brain again";
+    }, 3500);
+  } catch (e) {
+    const c = document.getElementById("c");
+    c.textContent = lang === "th" ? "❌ ก๊อปไม่ได้ — กดที่ textarea ข้างล่าง → Select All → Copy" : "❌ Copy failed — use the textarea below";
+  }
+}
+copySoul(false);
+document.getElementById("c").onclick = () => copySoul(true);
+${["cg", "gm", "cl", "pp"].map(k => `document.getElementById("lk-${k}").addEventListener("click", () => copySoul(false));`).join("\n")}
+${returnEndpoint ? `
+const RETURN_URL = ${jsSafe(returnEndpoint)};
+document.getElementById("rb").onclick = async () => {
+  const body = document.getElementById("rp").value;
+  if (!body.trim()) {
+    document.getElementById("rs").textContent = lang === "th" ? "⚠ ใส่ HOMUNCULUS RETURN block ก่อน" : "⚠ paste a HOMUNCULUS RETURN block first";
+    return;
+  }
+  document.getElementById("rs").textContent = lang === "th" ? "⏳ กำลังส่ง..." : "⏳ sending...";
+  try {
+    const r = await fetch(RETURN_URL, { method: "POST", headers: { "content-type": "text/plain;charset=utf-8" }, body });
+    const j = await r.json().catch(() => ({}));
+    if (r.ok && j.ok) {
+      document.getElementById("rs").textContent = lang === "th" ? ("✓ ส่งถึง editor AI แล้ว — id=" + j.id) : ("✓ delivered to editor AI — id=" + j.id);
+      document.getElementById("rp").value = "";
+    } else {
+      document.getElementById("rs").textContent = lang === "th" ? ("✗ ไม่สำเร็จ: " + (j.error || r.status)) : ("✗ failed: " + (j.error || r.status));
+    }
+  } catch (e) {
+    document.getElementById("rs").textContent = lang === "th" ? ("✗ network: " + e.message) : ("✗ network: " + e.message);
+  }
+};
+` : ""}
+</script>
+</body></html>`;
+}
+//# sourceMappingURL=same_shell.js.map

package/dist/rainbow/same_shell.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"same_shell.js","sourceRoot":"","sources":["../../src/rainbow/same_shell.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAWH,SAAS,MAAM,CAAC,CAAS;IACvB,OAAO,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,eAAe,EAAE,QAAQ,CAAC,CAAC;AAC9D,CAAC;AAED,SAAS,UAAU,CAAC,CAAS;IAC3B,OAAO,CAAC;SACL,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC;SACtB,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC;SACrB,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC;SACrB,OAAO,CAAC,IAAI,EAAE,QAAQ,CAAC;SACvB,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;AAC5B,CAAC;AAED;oCACoC;AACpC,MAAM,UAAU,mBAAmB,CAAC,KAAyB;IAC3D,MAAM,IAAI,GAAG,KAAK,CAAC,WAAW,IAAI,IAAI,CAAC;IACvC,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC;IACjD,MAAM,cAAc,GAAG,KAAK,CAAC,cAAc,IAAI,IAAI,CAAC;IAEpD,OAAO,8BAA8B,IAAI;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA0DzC,cAAc,CAAC,CAAC,CAAC;;;;;;OAMZ,CAAC,CAAC,CAAC,EAAE;;6BAEiB,IAAI,qFAAqF,IAAI;;;;eAI3G,MAAM,CAAC,KAAK,CAAC,QAAQ,CAAC;aACxB,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA6B/B,CAAC,IAAI,EAAC,IAAI,EAAC,IAAI,EAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,+BAA+B,CAAC,sDAAsD,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;EACjI,cAAc,CAAC,CAAC,CAAC;qBACE,MAAM,CAAC,cAAc,CAAC;;;;;;;;;;;;;;;;;;;;;CAqB1C,CAAC,CAAC,CAAC,EAAE;;eAES,CAAC;AAChB,CAAC"}

package/dist/rainbow/v1_92.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=v1_92.test.d.ts.map

package/dist/rainbow/v1_92.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"v1_92.test.d.ts","sourceRoot":"","sources":["../../src/rainbow/v1_92.test.ts"],"names":[],"mappings":""}

package/dist/rainbow/v1_92.test.js

@@ -0,0 +1,295 @@
+import { describe, it, expect } from "vitest";
+import { mkdtempSync, readFileSync } from "node:fs";
+import { tmpdir } from "node:os";
+import { join } from "node:path";
+import { renderSameShellPage } from "./same_shell.js";
+import { createPhoenix, renderPhoenixSubscriberScript, formatUrlChangeSseFrame, } from "./phoenix.js";
+import { openBoomerangInbox, handleReturnPost, formatPulseLine, } from "./boomerang.js";
+function freshInboxPath() {
+    const dir = mkdtempSync(join(tmpdir(), "mneme-boomerang-"));
+    return join(dir, "homunculus-return.jsonl");
+}
+const VALID_RETURN = `
+some preamble text from the Web AI
+
+# HOMUNCULUS RETURN
+originator: claude-opus-4-7
+returning_from: gemini-2.5-pro
+decisions: |
+  - Use Postgres for v1
+  - Skip Redis for now
+reasoning: |
+  - Postgres native JSONB handles the schema-less case
+next_actions: |
+  - bench typeorm vs prisma
+  - settle on one ORM by Friday
+`.trim();
+// ============================== SAME-SHELL ==================================
+describe("v1.92 RAINBOW · SAME-SHELL same-machine page", () => {
+    it("emits a complete HTML document", () => {
+        const html = renderSameShellPage({ soulText: "# SOUL\nbody", port: 7741 });
+        expect(html.startsWith("<!doctype html>")).toBe(true);
+        expect(html).toContain("</html>");
+        expect(html).toContain("Clone to another AI on this PC");
+    });
+    it("auto-copies soul to clipboard on load (no user click required)", () => {
+        const html = renderSameShellPage({ soulText: "x", port: 7741 });
+        // copySoul(false) called from top-level script -> auto-copy on load
+        expect(html).toContain("copySoul(false)");
+        expect(html).toContain("navigator.clipboard");
+    });
+    it("includes the full TH+EN capability matrix (paste-only truth)", () => {
+        const html = renderSameShellPage({ soulText: "x", port: 7741 });
+        // EN side
+        expect(html).toContain("On a train, only have your phone");
+        expect(html).toContain("Switch models for a second opinion");
+        expect(html).toContain("Backup the whole conversation");
+        expect(html).toContain("Call Mneme tools");
+        expect(html).toContain("Modify your code");
+        // TH side
+        expect(html).toContain("อยู่บนรถไฟ มีแค่มือถือ");
+        expect(html).toContain("Backup บทสนทนา");
+        expect(html).toContain("เรียก Mneme tools");
+        expect(html).toContain("แก้ code ของคุณ");
+    });
+    it("includes 4 AI deep-links that also re-copy clipboard on click", () => {
+        const html = renderSameShellPage({ soulText: "x", port: 7741 });
+        expect(html).toContain("chatgpt.com");
+        expect(html).toContain("gemini.google.com");
+        expect(html).toContain("claude.ai");
+        expect(html).toContain("perplexity.ai");
+        // Click handlers re-copy to defend against tab-switch clipboard wipe
+        expect(html).toContain('document.getElementById("lk-cg").addEventListener("click"');
+    });
+    it("XSS-safe: </script> in soul is escaped", () => {
+        const html = renderSameShellPage({ soulText: 'evil </script><img onerror=1>', port: 7741 });
+        expect(html).toContain("<\\/script>");
+        const start = html.indexOf("const SOUL = ");
+        const end = html.indexOf(";", start);
+        expect(html.slice(start, end)).not.toContain("</script>");
+    });
+    it("includes BOOMERANG return-pad when returnEndpoint is provided", () => {
+        const html = renderSameShellPage({ soulText: "x", port: 7741, returnEndpoint: "http://localhost:7741/return" });
+        expect(html).toContain("🪃 BOOMERANG");
+        expect(html).toContain("textarea");
+        expect(html).toContain('id="rp"');
+        expect(html).toContain('id="rb"');
+        expect(html).toContain("/return");
+        // Submit handler does POST with body
+        expect(html).toContain('method: "POST"');
+    });
+    it("omits BOOMERANG return-pad when returnEndpoint absent", () => {
+        const html = renderSameShellPage({ soulText: "x", port: 7741 });
+        expect(html).not.toContain("🪃 BOOMERANG");
+        expect(html).not.toContain('id="rp"');
+    });
+    it("footer states 'no QR / no tunnel / no network' truth", () => {
+        const html = renderSameShellPage({ soulText: "x", port: 7741 });
+        expect(html).toContain("no QR, no tunnel, no network needed");
+        expect(html).toContain("ไม่ต้องใช้ QR / tunnel / network");
+    });
+});
+// ============================== PHOENIX =====================================
+describe("v1.92 RAINBOW · PHOENIX tunnel watchdog", () => {
+    function probeFnSeq(seq) {
+        let i = 0;
+        return async (url) => {
+            const r = seq[Math.min(i, seq.length - 1)];
+            i++;
+            return { url, ok: r.ok, status: r.status, elapsedMs: 0, reason: r.reason };
+        };
+    }
+    it("getUrl returns initial URL", () => {
+        const h = createPhoenix({
+            initialUrl: "https://a.trycloudflare.com",
+            probeIntervalMs: 9_999_999,
+            probeFn: probeFnSeq([{ ok: true, status: 200 }]),
+            respawnFn: async () => null,
+        });
+        expect(h.getUrl()).toBe("https://a.trycloudflare.com");
+        h.stop();
+    });
+    it("respawns + fires onUrlChange after N consecutive failures", async () => {
+        let respawnCount = 0;
+        const events = [];
+        const h = createPhoenix({
+            initialUrl: "https://dead.trycloudflare.com",
+            probeIntervalMs: 5,
+            failuresBeforeRespawn: 2,
+            probeFn: probeFnSeq([
+                { ok: false, status: 404, reason: "tunnel edge returned 404" },
+                { ok: false, status: 404, reason: "tunnel edge returned 404" },
+                { ok: true, status: 200 },
+                { ok: true, status: 200 },
+            ]),
+            respawnFn: async () => {
+                respawnCount++;
+                return "https://alive.trycloudflare.com";
+            },
+        });
+        h.onUrlChange((n, o) => events.push([o, n]));
+        // Wait for two probe failures + respawn.
+        await new Promise((res) => setTimeout(res, 200));
+        h.stop();
+        expect(respawnCount).toBeGreaterThanOrEqual(1);
+        expect(h.getUrl()).toBe("https://alive.trycloudflare.com");
+        expect(events.length).toBeGreaterThanOrEqual(1);
+        expect(events[0][0]).toBe("https://dead.trycloudflare.com");
+        expect(events[0][1]).toBe("https://alive.trycloudflare.com");
+    });
+    it("does not respawn on single transient failure", async () => {
+        let respawnCount = 0;
+        const h = createPhoenix({
+            initialUrl: "https://x.trycloudflare.com",
+            probeIntervalMs: 5,
+            failuresBeforeRespawn: 3,
+            probeFn: probeFnSeq([
+                { ok: false, status: 404 },
+                { ok: true, status: 200 },
+                { ok: true, status: 200 },
+                { ok: true, status: 200 },
+            ]),
+            respawnFn: async () => { respawnCount++; return "x"; },
+        });
+        await new Promise((res) => setTimeout(res, 80));
+        h.stop();
+        expect(respawnCount).toBe(0);
+    });
+    it("history records every probe + respawn", async () => {
+        const h = createPhoenix({
+            initialUrl: "https://q.trycloudflare.com",
+            probeIntervalMs: 5,
+            failuresBeforeRespawn: 1,
+            probeFn: probeFnSeq([
+                { ok: false, status: 404, reason: "edge 404" },
+                { ok: true, status: 200 },
+            ]),
+            respawnFn: async () => "https://r.trycloudflare.com",
+        });
+        await new Promise((res) => setTimeout(res, 80));
+        h.stop();
+        const hist = h.getHistory();
+        expect(hist.length).toBeGreaterThanOrEqual(2);
+        expect(hist.some((e) => e.kind === "probe")).toBe(true);
+        expect(hist.some((e) => e.kind === "respawn")).toBe(true);
+    });
+    it("renderPhoenixSubscriberScript emits an EventSource subscription IIFE", () => {
+        const s = renderPhoenixSubscriberScript({ eventsUrl: "/events", qrImgId: "qr", urlTextId: "url" });
+        expect(s).toContain("EventSource");
+        expect(s).toContain('"/events"');
+        expect(s).toContain('"qr"');
+        expect(s).toContain('"url"');
+        expect(s).toContain("url-change");
+        expect(s).toContain("api.qrserver.com");
+    });
+    it("formatUrlChangeSseFrame returns valid SSE wire format", () => {
+        const f = formatUrlChangeSseFrame("https://new.trycloudflare.com");
+        expect(f).toBe("event: url-change\ndata: https://new.trycloudflare.com\n\n");
+    });
+    it("formatUrlChangeSseFrame strips newlines from input (defensive)", () => {
+        const f = formatUrlChangeSseFrame("https://x.com\ninjected\nstuff");
+        expect(f).not.toContain("\ninjected");
+        expect(f).toContain("https://x.cominjectedstuff");
+    });
+});
+// ============================== BOOMERANG ===================================
+describe("v1.92 RAINBOW · BOOMERANG return-pad inbox", () => {
+    it("ingests a valid HOMUNCULUS RETURN block + writes one JSONL line", () => {
+        const path = freshInboxPath();
+        const inbox = openBoomerangInbox(path);
+        const r = inbox.ingest({ raw: VALID_RETURN, source: "same-shell" });
+        expect(r.ok).toBe(true);
+        expect(r.id).toMatch(/^[0-9a-f]{12}$/);
+        expect(r.parsed?.decisions.length).toBe(2);
+        expect(r.parsed?.nextActions.length).toBe(2);
+        const lines = readFileSync(path, "utf8").trim().split("\n");
+        expect(lines.length).toBe(1);
+        const entry = JSON.parse(lines[0]);
+        expect(entry.id).toBe(r.id);
+        expect(entry.source).toBe("same-shell");
+        expect(entry.ingested).toBe(false);
+        expect(entry.parsed.originator).toBe("claude-opus-4-7");
+    });
+    it("rejects body without HOMUNCULUS RETURN block", () => {
+        const inbox = openBoomerangInbox(freshInboxPath());
+        const r = inbox.ingest({ raw: "just a normal AI reply, no return block here" });
+        expect(r.ok).toBe(false);
+        expect(r.error).toContain("HOMUNCULUS RETURN block");
+    });
+    it("rejects empty body", () => {
+        const inbox = openBoomerangInbox(freshInboxPath());
+        const r = inbox.ingest({ raw: "" });
+        expect(r.ok).toBe(false);
+        expect(r.error).toContain("empty");
+    });
+    it("rejects body over 256KB", () => {
+        const inbox = openBoomerangInbox(freshInboxPath());
+        const huge = "x".repeat(300 * 1024);
+        const r = inbox.ingest({ raw: huge });
+        expect(r.ok).toBe(false);
+        expect(r.error).toContain("too large");
+    });
+    it("dedup: same body twice -> same id, single line in file", () => {
+        const path = freshInboxPath();
+        const inbox = openBoomerangInbox(path);
+        const r1 = inbox.ingest({ raw: VALID_RETURN, source: "same-shell" });
+        const r2 = inbox.ingest({ raw: VALID_RETURN, source: "tunnel" });
+        expect(r1.id).toBe(r2.id);
+        const lines = readFileSync(path, "utf8").trim().split("\n");
+        expect(lines.length).toBe(1);
+    });
+    it("pending() returns un-ingested entries; markIngested moves them", () => {
+        const path = freshInboxPath();
+        const inbox = openBoomerangInbox(path);
+        const a = inbox.ingest({ raw: VALID_RETURN }).id;
+        expect(inbox.pending().length).toBe(1);
+        const moved = inbox.markIngested([a], "applied via mneme.abyss.homunculus.ingest");
+        expect(moved).toBe(1);
+        expect(inbox.pending().length).toBe(0);
+        const all = inbox.list();
+        expect(all[0].ingested).toBe(true);
+        expect(all[0].ingestNote).toContain("applied");
+        // Second mark is idempotent.
+        expect(inbox.markIngested([a])).toBe(0);
+    });
+    it("handleReturnPost returns 200 + {ok,id} on valid body", () => {
+        const inbox = openBoomerangInbox(freshInboxPath());
+        const r = handleReturnPost({ inbox, body: VALID_RETURN, source: "same-shell" });
+        expect(r.status).toBe(200);
+        expect(r.body.ok).toBe(true);
+        expect(r.body.id).toMatch(/^[0-9a-f]{12}$/);
+    });
+    it("handleReturnPost returns 400 + {ok:false,error} on garbage", () => {
+        const inbox = openBoomerangInbox(freshInboxPath());
+        const r = handleReturnPost({ inbox, body: "not a return block", source: "same-shell" });
+        expect(r.status).toBe(400);
+        expect(r.body.ok).toBe(false);
+        expect(r.body.error).toBeTruthy();
+    });
+    it("formatPulseLine produces compact one-line summary", () => {
+        const inbox = openBoomerangInbox(freshInboxPath());
+        const r = inbox.ingest({ raw: VALID_RETURN });
+        const entry = inbox.list()[0];
+        const line = formatPulseLine(entry);
+        expect(line).toContain("[BOOMERANG");
+        expect(line).toContain(r.id);
+        expect(line).toContain("gemini-2.5-pro");
+        expect(line).toContain("d:2"); // 2 decisions
+        expect(line).toContain("n:2"); // 2 next_actions
+    });
+    it("survives corrupt JSONL lines (forward-compat)", () => {
+        const path = freshInboxPath();
+        const inbox = openBoomerangInbox(path);
+        inbox.ingest({ raw: VALID_RETURN });
+        // Append a malformed line that future versions might write.
+        readFileSync(path, "utf8");
+        appendCorruptLine(path);
+        expect(() => inbox.list()).not.toThrow();
+        expect(inbox.list().length).toBe(1);
+    });
+});
+function appendCorruptLine(path) {
+    const fs = require("node:fs");
+    fs.appendFileSync(path, "{not json}\n", "utf8");
+}
+//# sourceMappingURL=v1_92.test.js.map

package/dist/rainbow/v1_92.test.js.map

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

package/package.json

@@ -1,6 +1,6 @@
-{
+{
   "name": "@mneme-ai/core",
-  "version": "1.91.0",
+  "version": "1.92.0",
   "description": "Core indexing, retrieval, and graph engine for Mneme",
   "type": "module",
   "main": "./dist/index.js",