@mneme-ai/core 1.75.0 → 1.77.0

package/dist/abyss/abyss.test.d.ts

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

package/dist/abyss/abyss.test.d.ts.map

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

package/dist/abyss/abyss.test.js

@@ -0,0 +1,191 @@
+import { describe, it, expect, beforeEach } from "vitest";
+import { mkdtempSync, mkdirSync, writeFileSync, existsSync, utimesSync, readFileSync } from "node:fs";
+import { tmpdir } from "node:os";
+import { join } from "node:path";
+import { pruneCapsules, scheduledPrune } from "./scythe.js";
+import { archiveSoul, listSouls, replaySoul, markUsed } from "./revenant.js";
+import { renderHomunculusRequest, parseHomunculusReturn, summarizeHomunculusReturn } from "./homunculus.js";
+function tmpRepo() {
+    return mkdtempSync(join(tmpdir(), "mneme-abyss-"));
+}
+function writeCapsule(repoRoot, name, ageMs, payload = {}) {
+    const dir = join(repoRoot, ".mneme/capsules");
+    mkdirSync(dir, { recursive: true });
+    const p = join(dir, name);
+    writeFileSync(p, JSON.stringify(payload, null, 2), "utf8");
+    const past = (Date.now() - ageMs) / 1000;
+    utimesSync(p, past, past);
+    return p;
+}
+// ─── SCYTHE ──────────────────────────────────────────────────────────
+describe("v1.76 ABYSS · Scythe (capsule TTL + auto-prune)", () => {
+    let repo;
+    beforeEach(() => {
+        repo = tmpRepo();
+    });
+    it("returns empty report when capsule dir doesn't exist", () => {
+        const r = pruneCapsules(repo);
+        expect(r.scannedCount).toBe(0);
+        expect(r.prunedCount).toBe(0);
+    });
+    it("prunes capsules older than TTL", () => {
+        writeCapsule(repo, "old.capsule", 40 * 24 * 60 * 60 * 1000); // 40 days
+        writeCapsule(repo, "young.capsule", 1 * 24 * 60 * 60 * 1000); // 1 day
+        const r = pruneCapsules(repo);
+        expect(r.scannedCount).toBe(2);
+        expect(r.prunedCount).toBe(1);
+        expect(r.pruned[0].file).toBe("old.capsule");
+        expect(r.pruned[0].reason).toBe("ttl-exceeded");
+    });
+    it("respects maxCount cap (newest first wins)", () => {
+        for (let i = 0; i < 10; i++)
+            writeCapsule(repo, `c${i}.capsule`, i * 60_000); // each 1 min older
+        const r = pruneCapsules(repo, { maxCount: 5, ttlMs: 365 * 24 * 60 * 60 * 1000 });
+        expect(r.scannedCount).toBe(10);
+        expect(r.prunedCount).toBe(5);
+        for (const p of r.pruned) {
+            expect(p.reason === "count-cap-exceeded" || p.reason === "both").toBe(true);
+        }
+    });
+    it("immune entries (`keep: true`) survive pruning", () => {
+        writeCapsule(repo, "old-but-kept.capsule", 40 * 24 * 60 * 60 * 1000, { keep: true });
+        writeCapsule(repo, "old.capsule", 40 * 24 * 60 * 60 * 1000);
+        const r = pruneCapsules(repo);
+        expect(r.prunedCount).toBe(1);
+        expect(r.pruned[0].file).toBe("old.capsule");
+        expect(r.keptCount).toBe(1);
+        // Kept file still on disk.
+        expect(existsSync(join(repo, ".mneme/capsules/old-but-kept.capsule"))).toBe(true);
+    });
+    it("dryRun reports without deleting", () => {
+        const p = writeCapsule(repo, "ancient.capsule", 100 * 24 * 60 * 60 * 1000);
+        const r = pruneCapsules(repo, { dryRun: true });
+        expect(r.dryRun).toBe(true);
+        expect(r.prunedCount).toBe(1);
+        expect(existsSync(p)).toBe(true);
+    });
+    it("writes audit log to .mneme/abyss/scythe.jsonl", () => {
+        writeCapsule(repo, "old.capsule", 40 * 24 * 60 * 60 * 1000);
+        pruneCapsules(repo);
+        const auditPath = join(repo, ".mneme/abyss/scythe.jsonl");
+        expect(existsSync(auditPath)).toBe(true);
+        const log = readFileSync(auditPath, "utf8");
+        expect(log).toContain("old.capsule");
+        expect(log).toContain("pruned");
+    });
+    it("scheduledPrune is a shortcut for default opts", () => {
+        writeCapsule(repo, "old.capsule", 40 * 24 * 60 * 60 * 1000);
+        const r = scheduledPrune(repo);
+        expect(r.prunedCount).toBe(1);
+    });
+    it("bytes reclaimed is non-zero when files are deleted", () => {
+        writeCapsule(repo, "old.capsule", 40 * 24 * 60 * 60 * 1000, { padding: "x".repeat(500) });
+        const r = pruneCapsules(repo);
+        expect(r.bytesReclaimed).toBeGreaterThan(100);
+    });
+});
+// ─── REVENANT ────────────────────────────────────────────────────────
+describe("v1.76 ABYSS · Revenant (soul archive)", () => {
+    let repo;
+    beforeEach(() => {
+        repo = tmpRepo();
+    });
+    it("archives a soul and assigns a stable id", () => {
+        const entry = archiveSoul(repo, { text: "# 🧬 MNEME SOUL PROMPT\nbody", vendor: "claude", fingerprint: "abc" });
+        expect(entry.id).toMatch(/^[a-f0-9]{16}$/);
+        expect(entry.used).toBe(false);
+        const replayed = replaySoul(repo, entry.id);
+        expect(replayed).not.toBeNull();
+        expect(replayed.text).toContain("MNEME SOUL PROMPT");
+    });
+    it("listSouls returns newest first", async () => {
+        archiveSoul(repo, { text: "soul1", vendor: "claude", fingerprint: "x" });
+        await new Promise((r) => setTimeout(r, 5));
+        archiveSoul(repo, { text: "soul2", vendor: "claude", fingerprint: "x" });
+        const list = listSouls(repo);
+        expect(list.length).toBe(2);
+        expect(list[0].createdAt >= list[1].createdAt).toBe(true);
+    });
+    it("filter by vendor works", () => {
+        archiveSoul(repo, { text: "a", vendor: "claude", fingerprint: "x" });
+        archiveSoul(repo, { text: "b", vendor: "gemini", fingerprint: "x" });
+        expect(listSouls(repo, { vendor: "claude" }).length).toBe(1);
+        expect(listSouls(repo, { vendor: "gemini" }).length).toBe(1);
+    });
+    it("markUsed flips the flag + records timestamp", () => {
+        const e = archiveSoul(repo, { text: "soul", vendor: "claude", fingerprint: "x" });
+        const ok = markUsed(repo, e.id, "chatgpt");
+        expect(ok).toBe(true);
+        const replayed = replaySoul(repo, e.id);
+        expect(replayed.used).toBe(true);
+        expect(replayed.destinationVendor).toBe("chatgpt");
+        expect(replayed.usedAt).toBeDefined();
+    });
+    it("markUsed on missing id returns false", () => {
+        expect(markUsed(repo, "nope-0000000000")).toBe(false);
+    });
+    it("usedOnly / unusedOnly filters", () => {
+        const a = archiveSoul(repo, { text: "a", vendor: "claude", fingerprint: "x" });
+        archiveSoul(repo, { text: "b", vendor: "claude", fingerprint: "x" });
+        markUsed(repo, a.id);
+        expect(listSouls(repo, { usedOnly: true }).length).toBe(1);
+        expect(listSouls(repo, { unusedOnly: true }).length).toBe(1);
+    });
+});
+// ─── HOMUNCULUS ──────────────────────────────────────────────────────
+describe("v1.76 ABYSS · Homunculus (receiver write-back)", () => {
+    it("renderHomunculusRequest produces a contract block", () => {
+        const md = renderHomunculusRequest({ originatorVendor: "claude-opus-4-7" });
+        expect(md).toContain("Homunculus request");
+        expect(md).toContain("HOMUNCULUS RETURN");
+        expect(md).toContain("originator: claude-opus-4-7");
+    });
+    it("parseHomunculusReturn round-trips a structured return", () => {
+        const text = [
+            "Some preamble",
+            "",
+            "# HOMUNCULUS RETURN",
+            "originator: claude-opus-4-7",
+            "returning_from: gpt-5",
+            "decisions: |",
+            "  - prefer Gist over clipboard",
+            "  - revisit telepathy v2 next session",
+            "reasoning: |",
+            "  - npm latest is the single source of truth",
+            "next_actions: |",
+            "  - ship abyss",
+            "",
+        ].join("\n");
+        const parsed = parseHomunculusReturn(text);
+        expect(parsed).not.toBeNull();
+        expect(parsed.originator).toBe("claude-opus-4-7");
+        expect(parsed.returningFrom).toBe("gpt-5");
+        expect(parsed.decisions.length).toBe(2);
+        expect(parsed.reasoning.length).toBe(1);
+        expect(parsed.nextActions.length).toBe(1);
+        expect(parsed.vaccines.length).toBe(0);
+    });
+    it("parseHomunculusReturn returns null when block is missing", () => {
+        expect(parseHomunculusReturn("just some chat output")).toBeNull();
+    });
+    it("parseHomunculusReturn returns null when required fields are missing", () => {
+        const text = "# HOMUNCULUS RETURN\norigin: missing";
+        expect(parseHomunculusReturn(text)).toBeNull();
+    });
+    it("summarizeHomunculusReturn is a one-line digest", () => {
+        const r = {
+            originator: "claude-opus-4-7",
+            returningFrom: "gpt-5",
+            decisions: ["a", "b"],
+            reasoning: ["r"],
+            vaccines: [],
+            nextActions: ["n"],
+        };
+        const s = summarizeHomunculusReturn(r);
+        expect(s).toContain("Homunculus return");
+        expect(s).toContain("Decisions: 2");
+        expect(s).toContain("Reasoning highlights: 1");
+        expect(s).not.toContain("vaccines");
+    });
+});
+//# sourceMappingURL=abyss.test.js.map

package/dist/abyss/abyss.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"abyss.test.js","sourceRoot":"","sources":["../../src/abyss/abyss.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAC;AAC1D,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,aAAa,EAAE,UAAU,EAAyB,UAAU,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAC7H,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AACjC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,OAAO,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC5D,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAC7E,OAAO,EAAE,uBAAuB,EAAE,qBAAqB,EAAE,yBAAyB,EAAE,MAAM,iBAAiB,CAAC;AAE5G,SAAS,OAAO;IACd,OAAO,WAAW,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,cAAc,CAAC,CAAC,CAAC;AACrD,CAAC;AAED,SAAS,YAAY,CAAC,QAAgB,EAAE,IAAY,EAAE,KAAa,EAAE,UAAkB,EAAE;IACvF,MAAM,GAAG,GAAG,IAAI,CAAC,QAAQ,EAAE,iBAAiB,CAAC,CAAC;IAC9C,SAAS,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACpC,MAAM,CAAC,GAAG,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;IAC1B,aAAa,CAAC,CAAC,EAAE,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC;IAC3D,MAAM,IAAI,GAAG,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK,CAAC,GAAG,IAAI,CAAC;IACzC,UAAU,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;IAC1B,OAAO,CAAC,CAAC;AACX,CAAC;AAED,wEAAwE;AAExE,QAAQ,CAAC,iDAAiD,EAAE,GAAG,EAAE;IAC/D,IAAI,IAAY,CAAC;IACjB,UAAU,CAAC,GAAG,EAAE;QACd,IAAI,GAAG,OAAO,EAAE,CAAC;IACnB,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,qDAAqD,EAAE,GAAG,EAAE;QAC7D,MAAM,CAAC,GAAG,aAAa,CAAC,IAAI,CAAC,CAAC;QAC9B,MAAM,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAC/B,MAAM,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAChC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,gCAAgC,EAAE,GAAG,EAAE;QACxC,YAAY,CAAC,IAAI,EAAE,aAAa,EAAE,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC,CAAC,CAAC,UAAU;QACvE,YAAY,CAAC,IAAI,EAAE,eAAe,EAAE,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC,CAAC,CAAC,QAAQ;QACtE,MAAM,CAAC,GAAG,aAAa,CAAC,IAAI,CAAC,CAAC;QAC9B,MAAM,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAC/B,MAAM,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAC9B,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAE,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;QAC9C,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAE,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;IACnD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,2CAA2C,EAAE,GAAG,EAAE;QACnD,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,EAAE;YAAE,YAAY,CAAC,IAAI,EAAE,IAAI,CAAC,UAAU,EAAE,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC,mBAAmB;QACjG,MAAM,CAAC,GAAG,aAAa,CAAC,IAAI,EAAE,EAAE,QAAQ,EAAE,CAAC,EAAE,KAAK,EAAE,GAAG,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,EAAE,CAAC,CAAC;QACjF,MAAM,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAChC,MAAM,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAC9B,KAAK,MAAM,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,CAAC;YACzB,MAAM,CAAC,CAAC,CAAC,MAAM,KAAK,oBAAoB,IAAI,CAAC,CAAC,MAAM,KAAK,MAAM,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC9E,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,+CAA+C,EAAE,GAAG,EAAE;QACvD,YAAY,CAAC,IAAI,EAAE,sBAAsB,EAAE,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;QACrF,YAAY,CAAC,IAAI,EAAE,aAAa,EAAE,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC,CAAC;QAC5D,MAAM,CAAC,GAAG,aAAa,CAAC,IAAI,CAAC,CAAC;QAC9B,MAAM,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAC9B,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAE,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;QAC9C,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAC5B,2BAA2B;QAC3B,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,EAAE,sCAAsC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACpF,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,iCAAiC,EAAE,GAAG,EAAE;QACzC,MAAM,CAAC,GAAG,YAAY,CAAC,IAAI,EAAE,iBAAiB,EAAE,GAAG,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC,CAAC;QAC3E,MAAM,CAAC,GAAG,aAAa,CAAC,IAAI,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;QAChD,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC5B,MAAM,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAC9B,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACnC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,+CAA+C,EAAE,GAAG,EAAE;QACvD,YAAY,CAAC,IAAI,EAAE,aAAa,EAAE,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC,CAAC;QAC5D,aAAa,CAAC,IAAI,CAAC,CAAC;QACpB,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,EAAE,2BAA2B,CAAC,CAAC;QAC1D,MAAM,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACzC,MAAM,GAAG,GAAG,YAAY,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;QAC5C,MAAM,CAAC,GAAG,CAAC,CAAC,SAAS,CAAC,aAAa,CAAC,CAAC;QACrC,MAAM,CAAC,GAAG,CAAC,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC;IAClC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,+CAA+C,EAAE,GAAG,EAAE;QACvD,YAAY,CAAC,IAAI,EAAE,aAAa,EAAE,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC,CAAC;QAC5D,MAAM,CAAC,GAAG,cAAc,CAAC,IAAI,CAAC,CAAC;QAC/B,MAAM,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAChC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,oDAAoD,EAAE,GAAG,EAAE;QAC5D,YAAY,CAAC,IAAI,EAAE,aAAa,EAAE,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,EAAE,EAAE,OAAO,EAAE,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAC1F,MAAM,CAAC,GAAG,aAAa,CAAC,IAAI,CAAC,CAAC;QAC9B,MAAM,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,eAAe,CAAC,GAAG,CAAC,CAAC;IAChD,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,wEAAwE;AAExE,QAAQ,CAAC,uCAAuC,EAAE,GAAG,EAAE;IACrD,IAAI,IAAY,CAAC;IACjB,UAAU,CAAC,GAAG,EAAE;QACd,IAAI,GAAG,OAAO,EAAE,CAAC;IACnB,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,yCAAyC,EAAE,GAAG,EAAE;QACjD,MAAM,KAAK,GAAG,WAAW,CAAC,IAAI,EAAE,EAAE,IAAI,EAAE,8BAA8B,EAAE,MAAM,EAAE,QAAQ,EAAE,WAAW,EAAE,KAAK,EAAE,CAAC,CAAC;QAChH,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,OAAO,CAAC,gBAAgB,CAAC,CAAC;QAC3C,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAC/B,MAAM,QAAQ,GAAG,UAAU,CAAC,IAAI,EAAE,KAAK,CAAC,EAAE,CAAC,CAAC;QAC5C,MAAM,CAAC,QAAQ,CAAC,CAAC,GAAG,CAAC,QAAQ,EAAE,CAAC;QAChC,MAAM,CAAC,QAAS,CAAC,IAAI,CAAC,CAAC,SAAS,CAAC,mBAAmB,CAAC,CAAC;IACxD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,gCAAgC,EAAE,KAAK,IAAI,EAAE;QAC9C,WAAW,CAAC,IAAI,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,WAAW,EAAE,GAAG,EAAE,CAAC,CAAC;QACzE,MAAM,IAAI,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,UAAU,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;QAC3C,WAAW,CAAC,IAAI,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,WAAW,EAAE,GAAG,EAAE,CAAC,CAAC;QACzE,MAAM,IAAI,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC;QAC7B,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAC5B,MAAM,CAAC,IAAI,CAAC,CAAC,CAAE,CAAC,SAAS,IAAI,IAAI,CAAC,CAAC,CAAE,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC9D,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,wBAAwB,EAAE,GAAG,EAAE;QAChC,WAAW,CAAC,IAAI,EAAE,EAAE,IAAI,EAAE,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,WAAW,EAAE,GAAG,EAAE,CAAC,CAAC;QACrE,WAAW,CAAC,IAAI,EAAE,EAAE,IAAI,EAAE,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,WAAW,EAAE,GAAG,EAAE,CAAC,CAAC;QACrE,MAAM,CAAC,SAAS,CAAC,IAAI,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAC7D,MAAM,CAAC,SAAS,CAAC,IAAI,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAC/D,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,6CAA6C,EAAE,GAAG,EAAE;QACrD,MAAM,CAAC,GAAG,WAAW,CAAC,IAAI,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,WAAW,EAAE,GAAG,EAAE,CAAC,CAAC;QAClF,MAAM,EAAE,GAAG,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC,EAAE,EAAE,SAAS,CAAC,CAAC;QAC3C,MAAM,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACtB,MAAM,QAAQ,GAAG,UAAU,CAAC,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC;QACxC,MAAM,CAAC,QAAS,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAClC,MAAM,CAAC,QAAS,CAAC,iBAAiB,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QACpD,MAAM,CAAC,QAAS,CAAC,MAAM,CAAC,CAAC,WAAW,EAAE,CAAC;IACzC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,sCAAsC,EAAE,GAAG,EAAE;QAC9C,MAAM,CAAC,QAAQ,CAAC,IAAI,EAAE,iBAAiB,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACxD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,+BAA+B,EAAE,GAAG,EAAE;QACvC,MAAM,CAAC,GAAG,WAAW,CAAC,IAAI,EAAE,EAAE,IAAI,EAAE,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,WAAW,EAAE,GAAG,EAAE,CAAC,CAAC;QAC/E,WAAW,CAAC,IAAI,EAAE,EAAE,IAAI,EAAE,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,WAAW,EAAE,GAAG,EAAE,CAAC,CAAC;QACrE,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC;QACrB,MAAM,CAAC,SAAS,CAAC,IAAI,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAC3D,MAAM,CAAC,SAAS,CAAC,IAAI,EAAE,EAAE,UAAU,EAAE,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAC/D,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,wEAAwE;AAExE,QAAQ,CAAC,gDAAgD,EAAE,GAAG,EAAE;IAC9D,EAAE,CAAC,mDAAmD,EAAE,GAAG,EAAE;QAC3D,MAAM,EAAE,GAAG,uBAAuB,CAAC,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,CAAC,CAAC;QAC5E,MAAM,CAAC,EAAE,CAAC,CAAC,SAAS,CAAC,oBAAoB,CAAC,CAAC;QAC3C,MAAM,CAAC,EAAE,CAAC,CAAC,SAAS,CAAC,mBAAmB,CAAC,CAAC;QAC1C,MAAM,CAAC,EAAE,CAAC,CAAC,SAAS,CAAC,6BAA6B,CAAC,CAAC;IACtD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,uDAAuD,EAAE,GAAG,EAAE;QAC/D,MAAM,IAAI,GAAG;YACX,eAAe;YACf,EAAE;YACF,qBAAqB;YACrB,6BAA6B;YAC7B,uBAAuB;YACvB,cAAc;YACd,gCAAgC;YAChC,uCAAuC;YACvC,cAAc;YACd,8CAA8C;YAC9C,iBAAiB;YACjB,gBAAgB;YAChB,EAAE;SACH,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACb,MAAM,MAAM,GAAG,qBAAqB,CAAC,IAAI,CAAC,CAAC;QAC3C,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,QAAQ,EAAE,CAAC;QAC9B,MAAM,CAAC,MAAO,CAAC,UAAU,CAAC,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC;QACnD,MAAM,CAAC,MAAO,CAAC,aAAa,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAC5C,MAAM,CAAC,MAAO,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACzC,MAAM,CAAC,MAAO,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACzC,MAAM,CAAC,MAAO,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAC3C,MAAM,CAAC,MAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAC1C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,0DAA0D,EAAE,GAAG,EAAE;QAClE,MAAM,CAAC,qBAAqB,CAAC,uBAAuB,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC;IACpE,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,qEAAqE,EAAE,GAAG,EAAE;QAC7E,MAAM,IAAI,GAAG,sCAAsC,CAAC;QACpD,MAAM,CAAC,qBAAqB,CAAC,IAAI,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC;IACjD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,gDAAgD,EAAE,GAAG,EAAE;QACxD,MAAM,CAAC,GAAG;YACR,UAAU,EAAE,iBAAiB;YAC7B,aAAa,EAAE,OAAO;YACtB,SAAS,EAAE,CAAC,GAAG,EAAE,GAAG,CAAC;YACrB,SAAS,EAAE,CAAC,GAAG,CAAC;YAChB,QAAQ,EAAE,EAAE;YACZ,WAAW,EAAE,CAAC,GAAG,CAAC;SACnB,CAAC;QACF,MAAM,CAAC,GAAG,yBAAyB,CAAC,CAAC,CAAC,CAAC;QACvC,MAAM,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,mBAAmB,CAAC,CAAC;QACzC,MAAM,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,cAAc,CAAC,CAAC;QACpC,MAAM,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,yBAAyB,CAAC,CAAC;QAC/C,MAAM,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,SAAS,CAAC,UAAU,CAAC,CAAC;IACtC,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/abyss/homunculus.d.ts

@@ -0,0 +1,45 @@
+/**
+ * v1.76.0 -- ABYSS MINION 3: HOMUNCULUS (receiver write-back).
+ *
+ * Bidirectional brain sync without a backchannel.
+ *
+ * When a soul prompt is sent to a foreign AI (ChatGPT, Gemini),
+ * append a "callback prompt" that asks the receiver to RETURN its
+ * OWN soul prompt at the end of the session. The user pastes that
+ * return prompt back into Mneme, which ingests it via
+ * `parseHomunculusReturn` and merges it into the local genome.
+ *
+ * Loop closure:
+ *   1. Mneme generates soul prompt + appends `## Homunculus request`.
+ *   2. User pastes into ChatGPT.
+ *   3. ChatGPT continues the work + (at session end) emits a return
+ *      soul prompt in the agreed format.
+ *   4. User pastes the return into Mneme.
+ *   5. Mneme parses, merges decisions + reasoning trace + new vaccines
+ *      into the local genome via GENESPLICE recombine.
+ *
+ * No API key. No webhook. No server. Just user-as-courier with a
+ * structured contract.
+ */
+export interface HomunculusRequestOptions {
+    /** What the originator wants to learn back. Default: decisions + reasoning. */
+    ask?: ("decisions" | "reasoning" | "vaccines" | "next-actions")[];
+    /** Originating vendor (so the return prompt knows who to address). */
+    originatorVendor?: string;
+}
+/** Render the callback instruction block that gets appended to a soul prompt. */
+export declare function renderHomunculusRequest(opts?: HomunculusRequestOptions): string;
+export interface HomunculusReturn {
+    originator: string;
+    returningFrom: string;
+    decisions: string[];
+    reasoning: string[];
+    vaccines: string[];
+    nextActions: string[];
+}
+/** Parse a HOMUNCULUS RETURN block from pasted text. Returns null if the
+ *  required fields are missing. */
+export declare function parseHomunculusReturn(text: string): HomunculusReturn | null;
+/** Summarize a parsed return for the originator AI to relay to the user. */
+export declare function summarizeHomunculusReturn(r: HomunculusReturn): string;
+//# sourceMappingURL=homunculus.d.ts.map

package/dist/abyss/homunculus.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"homunculus.d.ts","sourceRoot":"","sources":["../../src/abyss/homunculus.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,MAAM,WAAW,wBAAwB;IACvC,+EAA+E;IAC/E,GAAG,CAAC,EAAE,CAAC,WAAW,GAAG,WAAW,GAAG,UAAU,GAAG,cAAc,CAAC,EAAE,CAAC;IAClE,sEAAsE;IACtE,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,iFAAiF;AACjF,wBAAgB,uBAAuB,CAAC,IAAI,GAAE,wBAA6B,GAAG,MAAM,CAoBnF;AAED,MAAM,WAAW,gBAAgB;IAC/B,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,MAAM,CAAC;IACtB,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,WAAW,EAAE,MAAM,EAAE,CAAC;CACvB;AAED;mCACmC;AACnC,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,GAAG,gBAAgB,GAAG,IAAI,CAmC3E;AAED,4EAA4E;AAC5E,wBAAgB,yBAAyB,CAAC,CAAC,EAAE,gBAAgB,GAAG,MAAM,CAQrE"}

package/dist/abyss/homunculus.js

@@ -0,0 +1,108 @@
+/**
+ * v1.76.0 -- ABYSS MINION 3: HOMUNCULUS (receiver write-back).
+ *
+ * Bidirectional brain sync without a backchannel.
+ *
+ * When a soul prompt is sent to a foreign AI (ChatGPT, Gemini),
+ * append a "callback prompt" that asks the receiver to RETURN its
+ * OWN soul prompt at the end of the session. The user pastes that
+ * return prompt back into Mneme, which ingests it via
+ * `parseHomunculusReturn` and merges it into the local genome.
+ *
+ * Loop closure:
+ *   1. Mneme generates soul prompt + appends `## Homunculus request`.
+ *   2. User pastes into ChatGPT.
+ *   3. ChatGPT continues the work + (at session end) emits a return
+ *      soul prompt in the agreed format.
+ *   4. User pastes the return into Mneme.
+ *   5. Mneme parses, merges decisions + reasoning trace + new vaccines
+ *      into the local genome via GENESPLICE recombine.
+ *
+ * No API key. No webhook. No server. Just user-as-courier with a
+ * structured contract.
+ */
+/** Render the callback instruction block that gets appended to a soul prompt. */
+export function renderHomunculusRequest(opts = {}) {
+    const ask = opts.ask ?? ["decisions", "reasoning", "next-actions"];
+    const originator = opts.originatorVendor ?? "claude-opus-4-7";
+    const lines = [];
+    lines.push(`## Homunculus request (write-back contract)`);
+    lines.push(``);
+    lines.push(`At the end of this session OR when the user types "homunculus return", emit a block in this EXACT format so the originating ${originator} session can ingest it back into the local Mneme:`);
+    lines.push(``);
+    lines.push("```");
+    lines.push(`# HOMUNCULUS RETURN`);
+    lines.push(`originator: ${originator}`);
+    lines.push(`returning_from: <your-model-id>`);
+    if (ask.includes("decisions"))
+        lines.push(`decisions: |\n  - <decision 1>\n  - <decision 2>`);
+    if (ask.includes("reasoning"))
+        lines.push(`reasoning: |\n  - <key reasoning highlight>`);
+    if (ask.includes("vaccines"))
+        lines.push(`vaccines: |\n  - <hallucination strain caught + how>`);
+    if (ask.includes("next-actions"))
+        lines.push(`next_actions: |\n  - <what should happen next>`);
+    lines.push("```");
+    lines.push(``);
+    lines.push(`The user will paste this back into their local Mneme. Be terse -- one bullet per line, no prose paragraphs.`);
+    return lines.join("\n");
+}
+/** Parse a HOMUNCULUS RETURN block from pasted text. Returns null if the
+ *  required fields are missing. */
+export function parseHomunculusReturn(text) {
+    if (!text.includes("HOMUNCULUS RETURN"))
+        return null;
+    const get = (key) => {
+        const m = text.match(new RegExp(`^${key}:\\s*(.+)$`, "m"));
+        return m ? m[1].trim() : null;
+    };
+    // Line-based block parser: find `^key: |` then collect indented lines.
+    const lines = text.split(/\r?\n/);
+    const block = (key) => {
+        const headerRe = new RegExp(`^${key}:\\s*\\|\\s*$`);
+        const out = [];
+        for (let i = 0; i < lines.length; i++) {
+            if (!headerRe.test(lines[i]))
+                continue;
+            for (let j = i + 1; j < lines.length; j++) {
+                const ln = lines[j];
+                if (ln === "")
+                    continue; // blank lines allowed inside the block
+                if (!/^\s/.test(ln))
+                    break; // unindented line ends the block
+                const item = ln.replace(/^\s*-\s*/, "").trim();
+                if (item)
+                    out.push(item);
+            }
+            break;
+        }
+        return out;
+    };
+    const originator = get("originator");
+    const returningFrom = get("returning_from");
+    if (!originator || !returningFrom)
+        return null;
+    return {
+        originator,
+        returningFrom,
+        decisions: block("decisions"),
+        reasoning: block("reasoning"),
+        vaccines: block("vaccines"),
+        nextActions: block("next_actions"),
+    };
+}
+/** Summarize a parsed return for the originator AI to relay to the user. */
+export function summarizeHomunculusReturn(r) {
+    const lines = [];
+    lines.push(`Homunculus return from \`${r.returningFrom}\` → \`${r.originator}\``);
+    if (r.decisions.length > 0)
+        lines.push(`Decisions: ${r.decisions.length}`);
+    if (r.reasoning.length > 0)
+        lines.push(`Reasoning highlights: ${r.reasoning.length}`);
+    if (r.vaccines.length > 0)
+        lines.push(`New vaccines: ${r.vaccines.length}`);
+    if (r.nextActions.length > 0)
+        lines.push(`Next actions: ${r.nextActions.length}`);
+    return lines.join(" · ");
+}
+//# sourceMappingURL=homunculus.js.map

package/dist/abyss/homunculus.js.map

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

package/dist/abyss/index.d.ts

@@ -0,0 +1,14 @@
+/**
+ * v1.76.0 -- ABYSS PROTOCOL: final-boss minions.
+ *
+ * - SCYTHE: capsule TTL + auto-prune. Stops `.mneme/capsules/` from
+ *   growing forever; nightly daemon job clears them.
+ * - REVENANT: soul prompt archive. Every soul prompt is replayable
+ *   by id; mark-as-used closes the cross-vendor loop.
+ * - HOMUNCULUS: receiver-write-back contract. Foreign AI returns its
+ *   own soul prompt at session end → ingested into local genome.
+ */
+export * from "./scythe.js";
+export * from "./revenant.js";
+export * from "./homunculus.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/abyss/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,cAAc,aAAa,CAAC;AAC5B,cAAc,eAAe,CAAC;AAC9B,cAAc,iBAAiB,CAAC"}

package/dist/abyss/index.js

@@ -0,0 +1,14 @@
+/**
+ * v1.76.0 -- ABYSS PROTOCOL: final-boss minions.
+ *
+ * - SCYTHE: capsule TTL + auto-prune. Stops `.mneme/capsules/` from
+ *   growing forever; nightly daemon job clears them.
+ * - REVENANT: soul prompt archive. Every soul prompt is replayable
+ *   by id; mark-as-used closes the cross-vendor loop.
+ * - HOMUNCULUS: receiver-write-back contract. Foreign AI returns its
+ *   own soul prompt at session end → ingested into local genome.
+ */
+export * from "./scythe.js";
+export * from "./revenant.js";
+export * from "./homunculus.js";
+//# sourceMappingURL=index.js.map

package/dist/abyss/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/abyss/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,cAAc,aAAa,CAAC;AAC5B,cAAc,eAAe,CAAC;AAC9B,cAAc,iBAAiB,CAAC"}

package/dist/abyss/revenant.d.ts

@@ -0,0 +1,48 @@
+/**
+ * v1.76.0 -- ABYSS MINION 2: REVENANT (soul prompt archive + replay).
+ *
+ * Every soul prompt that leaves Mneme should be REPLAYABLE later.
+ * REVENANT is git-reflog for cross-vendor handovers:
+ *   - Save the soul prompt + metadata when generated.
+ *   - List archived souls with vendor / fingerprint / created / used.
+ *   - Replay any past soul by id.
+ *   - Mark a soul as "used successfully" when the receiving AI ACKs.
+ *
+ * Storage: `.mneme/abyss/souls/<id>.json` (newline-delimited safe).
+ * Index: in-memory rebuild from directory listing -- no separate
+ * index file to corrupt.
+ */
+export interface ArchivedSoul {
+    id: string;
+    createdAt: string;
+    vendor: string;
+    fingerprint: string;
+    destinationVendor?: string;
+    /** Was the soul transferred successfully? Set by markUsed. */
+    used: boolean;
+    /** ISO timestamp when marked used. */
+    usedAt?: string;
+    /** The raw soul prompt text. */
+    text: string;
+    /** Char length convenience. */
+    length: number;
+}
+export interface ArchiveInput {
+    text: string;
+    vendor: string;
+    fingerprint: string;
+    destinationVendor?: string;
+}
+/** Save a soul prompt to the local archive. Returns the assigned id. */
+export declare function archiveSoul(repoRoot: string, input: ArchiveInput): ArchivedSoul;
+/** List all archived souls (newest first). Optionally filter by vendor. */
+export declare function listSouls(repoRoot: string, opts?: {
+    vendor?: string;
+    usedOnly?: boolean;
+    unusedOnly?: boolean;
+}): ArchivedSoul[];
+/** Retrieve a single archived soul by id. */
+export declare function replaySoul(repoRoot: string, id: string): ArchivedSoul | null;
+/** Mark a soul as successfully transferred (receiving AI ACKed). */
+export declare function markUsed(repoRoot: string, id: string, destinationVendor?: string): boolean;
+//# sourceMappingURL=revenant.d.ts.map

package/dist/abyss/revenant.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"revenant.d.ts","sourceRoot":"","sources":["../../src/abyss/revenant.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAQH,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,8DAA8D;IAC9D,IAAI,EAAE,OAAO,CAAC;IACd,sCAAsC;IACtC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,gCAAgC;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,+BAA+B;IAC/B,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B;AAYD,wEAAwE;AACxE,wBAAgB,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,YAAY,GAAG,YAAY,CAe/E;AAED,2EAA2E;AAC3E,wBAAgB,SAAS,CACvB,QAAQ,EAAE,MAAM,EAChB,IAAI,GAAE;IAAE,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;IAAC,UAAU,CAAC,EAAE,OAAO,CAAA;CAAO,GACvE,YAAY,EAAE,CAkBhB;AAED,6CAA6C;AAC7C,wBAAgB,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,YAAY,GAAG,IAAI,CAS5E;AAED,oEAAoE;AACpE,wBAAgB,QAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,iBAAiB,CAAC,EAAE,MAAM,GAAG,OAAO,CAc1F"}

package/dist/abyss/revenant.js

@@ -0,0 +1,102 @@
+/**
+ * v1.76.0 -- ABYSS MINION 2: REVENANT (soul prompt archive + replay).
+ *
+ * Every soul prompt that leaves Mneme should be REPLAYABLE later.
+ * REVENANT is git-reflog for cross-vendor handovers:
+ *   - Save the soul prompt + metadata when generated.
+ *   - List archived souls with vendor / fingerprint / created / used.
+ *   - Replay any past soul by id.
+ *   - Mark a soul as "used successfully" when the receiving AI ACKs.
+ *
+ * Storage: `.mneme/abyss/souls/<id>.json` (newline-delimited safe).
+ * Index: in-memory rebuild from directory listing -- no separate
+ * index file to corrupt.
+ */
+import { existsSync, mkdirSync, readdirSync, readFileSync, writeFileSync } from "node:fs";
+import { join } from "node:path";
+import { createHash } from "node:crypto";
+const SOULS_DIR = ".mneme/abyss/souls";
+function ensureSoulsDir(repoRoot) {
+    const dir = join(repoRoot, SOULS_DIR);
+    if (!existsSync(dir))
+        mkdirSync(dir, { recursive: true });
+    return dir;
+}
+function shortId(text) {
+    return createHash("sha256").update(text).digest("hex").slice(0, 16);
+}
+/** Save a soul prompt to the local archive. Returns the assigned id. */
+export function archiveSoul(repoRoot, input) {
+    const dir = ensureSoulsDir(repoRoot);
+    const id = shortId(input.text + new Date().toISOString());
+    const entry = {
+        id,
+        createdAt: new Date().toISOString(),
+        vendor: input.vendor,
+        fingerprint: input.fingerprint,
+        destinationVendor: input.destinationVendor,
+        used: false,
+        text: input.text,
+        length: input.text.length,
+    };
+    writeFileSync(join(dir, `${id}.json`), JSON.stringify(entry, null, 2), "utf8");
+    return entry;
+}
+/** List all archived souls (newest first). Optionally filter by vendor. */
+export function listSouls(repoRoot, opts = {}) {
+    const dir = join(repoRoot, SOULS_DIR);
+    if (!existsSync(dir))
+        return [];
+    const files = readdirSync(dir).filter((f) => f.endsWith(".json"));
+    const out = [];
+    for (const f of files) {
+        try {
+            const j = JSON.parse(readFileSync(join(dir, f), "utf8"));
+            if (opts.vendor && j.vendor !== opts.vendor)
+                continue;
+            if (opts.usedOnly && !j.used)
+                continue;
+            if (opts.unusedOnly && j.used)
+                continue;
+            out.push(j);
+        }
+        catch {
+            // skip corrupt entries
+        }
+    }
+    out.sort((a, b) => (a.createdAt < b.createdAt ? 1 : -1));
+    return out;
+}
+/** Retrieve a single archived soul by id. */
+export function replaySoul(repoRoot, id) {
+    const dir = join(repoRoot, SOULS_DIR);
+    const p = join(dir, `${id}.json`);
+    if (!existsSync(p))
+        return null;
+    try {
+        return JSON.parse(readFileSync(p, "utf8"));
+    }
+    catch {
+        return null;
+    }
+}
+/** Mark a soul as successfully transferred (receiving AI ACKed). */
+export function markUsed(repoRoot, id, destinationVendor) {
+    const dir = join(repoRoot, SOULS_DIR);
+    const p = join(dir, `${id}.json`);
+    if (!existsSync(p))
+        return false;
+    try {
+        const j = JSON.parse(readFileSync(p, "utf8"));
+        j.used = true;
+        j.usedAt = new Date().toISOString();
+        if (destinationVendor)
+            j.destinationVendor = destinationVendor;
+        writeFileSync(p, JSON.stringify(j, null, 2), "utf8");
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+//# sourceMappingURL=revenant.js.map

package/dist/abyss/revenant.js.map

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

package/dist/abyss/scythe.d.ts

@@ -0,0 +1,53 @@
+/**
+ * v1.76.0 -- ABYSS MINION 1: SCYTHE (capsule TTL + auto-prune).
+ *
+ * The bug user spotted: `.mneme/capsules/` accumulates a capsule
+ * EVERY session, forever. Disk fills, search slows, snapshots bloat.
+ *
+ * SCYTHE keeps the capsule directory bounded by two simultaneous
+ * policies:
+ *   1. Time-to-live (TTL): default 30 days. Older capsules deleted.
+ *   2. Hard count cap: default 200. Beyond that, the oldest are
+ *      culled regardless of age.
+ *
+ * Both policies apply -- a capsule survives only if BOTH its age is
+ * under the TTL AND its rank (newest=0) is under the cap. Capsules
+ * marked `keep: true` (set by the user / by REVENANT when archived)
+ * are immune.
+ *
+ * Audit log: every prune writes a structured entry to
+ * `.mneme/abyss/scythe.jsonl` so we can later prove what disappeared
+ * and why. The daemon can call this nightly via `scheduledPrune()`.
+ */
+export interface ScytheOptions {
+    /** Time-to-live in milliseconds. Default 30 days. */
+    ttlMs?: number;
+    /** Maximum capsules to keep (newest first). Default 200. */
+    maxCount?: number;
+    /** Directory holding `.capsule` files. Default `<repoRoot>/.mneme/capsules`. */
+    capsuleDir?: string;
+    /** When true, list what WOULD be pruned without deleting. */
+    dryRun?: boolean;
+}
+export interface ScythePrunedEntry {
+    file: string;
+    ageDays: number;
+    reason: "ttl-exceeded" | "count-cap-exceeded" | "both";
+    sizeBytes: number;
+}
+export interface ScytheReport {
+    scannedCount: number;
+    prunedCount: number;
+    keptCount: number;
+    bytesReclaimed: number;
+    pruned: ScythePrunedEntry[];
+    ttlMs: number;
+    maxCount: number;
+    dryRun: boolean;
+    ranAt: string;
+}
+/** Prune capsules in `<repoRoot>/.mneme/capsules` according to TTL + cap. */
+export declare function pruneCapsules(repoRoot: string, opts?: ScytheOptions): ScytheReport;
+/** Daemon-friendly nightly entry point. Same as pruneCapsules with defaults. */
+export declare function scheduledPrune(repoRoot: string): ScytheReport;
+//# sourceMappingURL=scythe.d.ts.map

package/dist/abyss/scythe.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scythe.d.ts","sourceRoot":"","sources":["../../src/abyss/scythe.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAKH,MAAM,WAAW,aAAa;IAC5B,qDAAqD;IACrD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,4DAA4D;IAC5D,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,gFAAgF;IAChF,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,6DAA6D;IAC7D,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,cAAc,GAAG,oBAAoB,GAAG,MAAM,CAAC;IACvD,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,YAAY;IAC3B,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE,MAAM,CAAC;IACvB,MAAM,EAAE,iBAAiB,EAAE,CAAC;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,OAAO,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;CACf;AAsBD,6EAA6E;AAC7E,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,GAAE,aAAkB,GAAG,YAAY,CAuFtF;AAED,gFAAgF;AAChF,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,YAAY,CAE7D"}