@mneme-ai/core 2.11.0 → 2.13.0

package/dist/cosmic/cosmic.test.js

@@ -1,5 +1,5 @@
 import { describe, it, expect } from "vitest";
-import { mintSession, publishToCosmic, revokeCosmic, readCosmic, formatCosmicPulseLine } from "./index.js";
+import { mintSession, publishToCosmic, revokeCosmic, readCosmic, formatCosmicPulseLine, heartbeatCosmic, pushHomunculusReturn, readInbox, getCosmicPresence, } from "./index.js";
 import { createHash } from "node:crypto";
 // In-memory mock that emulates the COSMIC server enough for client tests.
 function makeMockServer() {
@@ -7,20 +7,61 @@ function makeMockServer() {
     return (async (input, init) => {
         const url = typeof input === "string" ? input : input instanceof URL ? input.toString() : input.url;
         const u = new URL(url);
-        const m = u.pathname.match(/^\/api\/v1\/sessions\/([A-Za-z0-9_-]+)(\.json|\/revoke)?$/);
+        const method = init?.method ?? "GET";
+        // v2.12 routes
+        let m = u.pathname.match(/^\/api\/v1\/sessions\/([A-Za-z0-9_-]+)\/heartbeat$/);
+        if (m) {
+            const sess = sessions.get(m[1]);
+            if (!sess)
+                return new Response(JSON.stringify({ error: "no session" }), { status: 404 });
+            sess.lastHb = Date.now();
+            return new Response(JSON.stringify({ ok: true, ts: sess.lastHb, zombie: false }), { status: 200 });
+        }
+        m = u.pathname.match(/^\/api\/v1\/sessions\/([A-Za-z0-9_-]+)\/inbox$/);
+        if (m) {
+            const sess = sessions.get(m[1]);
+            if (!sess)
+                return new Response(JSON.stringify({ error: "no session" }), { status: 404 });
+            if (method === "POST") {
+                sess.inbox.push({ receivedAt: new Date().toISOString(), vendor: "test", body: String(init?.body ?? "") });
+                return new Response(JSON.stringify({ ok: true, count: sess.inbox.length }), { status: 201 });
+            }
+            if (method === "GET") {
+                const items = sess.inbox.slice();
+                const drained = init?.headers?.["x-drain"] === "1";
+                if (drained)
+                    sess.inbox.length = 0;
+                return new Response(JSON.stringify({ items, count: items.length, drained }), { status: 200 });
+            }
+        }
+        m = u.pathname.match(/^\/api\/v1\/sessions\/([A-Za-z0-9_-]+)\/presence$/);
+        if (m) {
+            const sess = sessions.get(m[1]);
+            if (!sess)
+                return new Response(JSON.stringify({ error: "no session" }), { status: 404 });
+            return new Response(JSON.stringify({
+                token: m[1], watchers: sess.watchers, publishCount: sess.count,
+                lastPublishTs: sess.lastTs, lastHeartbeatTs: sess.lastHb || null, zombie: false,
+            }), { status: 200 });
+        }
+        // v2.11 routes
+        m = u.pathname.match(/^\/api\/v1\/sessions\/([A-Za-z0-9_-]+)(\.json|\/revoke)?$/);
         if (!m)
             return new Response(JSON.stringify({ error: "no route" }), { status: 404 });
         const token = m[1];
         const suffix = m[2];
-        if (init?.method === "POST" && suffix === "/revoke") {
+        if (method === "POST" && suffix === "/revoke") {
             sessions.delete(token);
             return new Response(JSON.stringify({ ok: true }), { status: 200 });
         }
-        if (init?.method === "POST" && !suffix) {
+        if (method === "POST" && !suffix) {
             const body = JSON.parse(init.body);
             const exists = sessions.get(token);
             if (!exists) {
-                sessions.set(token, { state: body.state, adminSecretHash: body.adminSecretHash, count: 1, lastTs: Date.now() });
+                sessions.set(token, {
+                    state: body.state, adminSecretHash: body.adminSecretHash,
+                    count: 1, lastTs: Date.now(), lastHb: 0, inbox: [], watchers: [],
+                });
                 return new Response(JSON.stringify({ ok: true, count: 1, prevSig: null, newSig: "sig1" }), { status: 201 });
             }
             exists.state = body.state;
@@ -28,11 +69,14 @@ function makeMockServer() {
             exists.lastTs = Date.now();
             return new Response(JSON.stringify({ ok: true, count: exists.count, prevSig: "sig" + (exists.count - 1), newSig: "sig" + exists.count }), { status: 200 });
         }
-        if (init?.method === undefined && suffix === ".json") {
+        if (method === "GET" && suffix === ".json") {
             const sess = sessions.get(token);
             if (!sess)
                 return new Response(JSON.stringify({ error: "not found" }), { status: 404 });
-            return new Response(JSON.stringify({ token, state: sess.state, lastPublishTs: sess.lastTs, publishCount: sess.count, stale: false }), { status: 200 });
+            return new Response(JSON.stringify({
+                token, state: sess.state, lastPublishTs: sess.lastTs, publishCount: sess.count,
+                stale: false, zombie: false, watchers: sess.watchers.length,
+            }), { status: 200 });
         }
         return new Response(JSON.stringify({ error: "no route" }), { status: 404 });
     });
@@ -120,4 +164,99 @@ describe("v2.11 COSMIC LINK · client", () => {
         expect(line).toContain("sig=abcdef12");
     });
 });
+describe("v2.12 COSMIC LINK · NOBEL helpers", () => {
+    it("heartbeatCosmic refreshes liveness with HMAC", async () => {
+        const fetch = makeMockServer();
+        const s = mintSession({ serverUrl: "https://cosmic.example.com" });
+        await publishToCosmic({ session: s, state: { v: "2.12.0" }, fetchOverride: fetch });
+        const r = await heartbeatCosmic(s, fetch);
+        expect(r.ok).toBe(true);
+        expect(r.zombie).toBe(false);
+        expect(typeof r.ts).toBe("number");
+    });
+    it("heartbeatCosmic on unknown token returns 404", async () => {
+        const fetch = makeMockServer();
+        const s = mintSession({ serverUrl: "https://cosmic.example.com" });
+        const r = await heartbeatCosmic(s, fetch);
+        expect(r.ok).toBe(false);
+        expect(r.error).toContain("no session");
+    });
+    it("heartbeatCosmic includes Authorization Bearer header", async () => {
+        let captured;
+        const sniff = (async (_input, init) => {
+            captured = init?.headers?.["authorization"];
+            return new Response(JSON.stringify({ ok: true, ts: 1, zombie: false }), { status: 200 });
+        });
+        const s = mintSession({ serverUrl: "https://x.com" });
+        await heartbeatCosmic(s, sniff);
+        expect(captured).toMatch(/^Bearer [0-9a-f]{64}$/);
+    });
+    it("pushHomunculusReturn POSTs to /inbox endpoint (open, no auth)", async () => {
+        const fetch = makeMockServer();
+        const s = mintSession({ serverUrl: "https://cosmic.example.com" });
+        await publishToCosmic({ session: s, state: {}, fetchOverride: fetch });
+        const r = await pushHomunculusReturn(s.jsonUrl, "# HOMUNCULUS RETURN\necho: ack", fetch);
+        expect(r.ok).toBe(true);
+        expect(r.count).toBe(1);
+    });
+    it("pushHomunculusReturn derives /inbox from .json URL", async () => {
+        let calledUrl;
+        const sniff = (async (input) => {
+            calledUrl = typeof input === "string" ? input : input instanceof URL ? input.toString() : input.url;
+            return new Response(JSON.stringify({ ok: true, count: 1 }), { status: 201 });
+        });
+        await pushHomunculusReturn("https://x.com/api/v1/sessions/abc.json", "body", sniff);
+        expect(calledUrl).toBe("https://x.com/api/v1/sessions/abc/inbox");
+    });
+    it("readInbox drains when drain=true (HMAC-auth)", async () => {
+        const fetch = makeMockServer();
+        const s = mintSession({ serverUrl: "https://cosmic.example.com" });
+        await publishToCosmic({ session: s, state: {}, fetchOverride: fetch });
+        await pushHomunculusReturn(s.jsonUrl, "first", fetch);
+        await pushHomunculusReturn(s.jsonUrl, "second", fetch);
+        const r1 = await readInbox(s, { fetchOverride: fetch });
+        expect(r1.ok).toBe(true);
+        expect(r1.count).toBe(2);
+        expect(r1.drained).toBe(false);
+        const r2 = await readInbox(s, { drain: true, fetchOverride: fetch });
+        expect(r2.drained).toBe(true);
+        const r3 = await readInbox(s, { fetchOverride: fetch });
+        expect(r3.count).toBe(0);
+    });
+    it("readInbox returns ok=false on network error", async () => {
+        const fail = async () => { throw new Error("ENOTFOUND"); };
+        const s = mintSession({ serverUrl: "https://cosmic.example.com" });
+        const r = await readInbox(s, { fetchOverride: fail });
+        expect(r.ok).toBe(false);
+        expect(r.error).toContain("ENOTFOUND");
+    });
+    it("getCosmicPresence returns watcher list + zombie flag", async () => {
+        const fetch = makeMockServer();
+        const s = mintSession({ serverUrl: "https://cosmic.example.com" });
+        await publishToCosmic({ session: s, state: {}, fetchOverride: fetch });
+        const r = await getCosmicPresence(s.jsonUrl, fetch);
+        expect(r.ok).toBe(true);
+        expect(Array.isArray(r.watchers)).toBe(true);
+        expect(r.zombie).toBe(false);
+        expect(r.publishCount).toBe(1);
+    });
+    it("getCosmicPresence derives /presence URL from /.json URL", async () => {
+        let calledUrl;
+        const sniff = (async (input) => {
+            calledUrl = typeof input === "string" ? input : input instanceof URL ? input.toString() : input.url;
+            return new Response(JSON.stringify({ watchers: [] }), { status: 200 });
+        });
+        await getCosmicPresence("https://x.com/api/v1/sessions/abc.json", sniff);
+        expect(calledUrl).toBe("https://x.com/api/v1/sessions/abc/presence");
+    });
+    it("readCosmic exposes new v2.12 fields (zombie, watchers count)", async () => {
+        const fetch = makeMockServer();
+        const s = mintSession({ serverUrl: "https://cosmic.example.com" });
+        await publishToCosmic({ session: s, state: { v: "2.12.0" }, fetchOverride: fetch });
+        const raw = await fetch(s.jsonUrl);
+        const j = await raw.json();
+        expect(j.zombie).toBe(false);
+        expect(typeof j.watchers).toBe("number");
+    });
+});
 //# sourceMappingURL=cosmic.test.js.map

package/dist/cosmic/cosmic.test.js.map

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

package/dist/cosmic/diff.d.ts

@@ -0,0 +1,41 @@
+/**
+ * v2.13.0 — Minimal JSON Patch (RFC 6902 subset) for cosmic incremental
+ * publishes.
+ *
+ * Why not pull a dep? Cosmic state is small (typically < 4KB), the patch
+ * shape is bounded (publishes are version + commit + timestamp updates),
+ * and the cosmic server is single-file zero-deps. A 100-line implementation
+ * we control beats a 50KB transitive tree we don't.
+ *
+ * Supported ops: add / replace / remove. Move/copy/test omitted as they
+ * don't appear in any cosmic state-update pattern.
+ *
+ * Path encoding follows RFC 6901 (JSON Pointer): "/a/b" → state.a.b.
+ * "/" is the root. ~0 escapes ~, ~1 escapes /.
+ */
+export interface JsonPatchOp {
+    op: "add" | "replace" | "remove";
+    path: string;
+    value?: unknown;
+}
+type JsonValue = unknown;
+/**
+ * Diff two JSON values; returns a list of patch ops that, applied to `before`,
+ * produce `after`. Optimised for cosmic state shape (objects of scalars +
+ * small arrays). Arrays are handled by full-replace when they differ — a
+ * cosmic publish never makes large array edits, so structural array diffing
+ * isn't worth the byte cost.
+ */
+export declare function makePatch(before: JsonValue, after: JsonValue, prefix?: string): JsonPatchOp[];
+/** Apply a patch list to a deep copy of `state` and return the new value. */
+export declare function applyPatch(state: JsonValue, ops: JsonPatchOp[]): JsonValue;
+/**
+ * Decide whether a patch is "worth shipping" vs sending the full state.
+ * For cosmic, shipping the patch is only smarter than the full state when
+ * the patch is materially smaller. We require at least 30% reduction OR
+ * a 200-byte savings — below that, the round-trip risk (server applies
+ * patch wrong, drift) outweighs the byte win.
+ */
+export declare function patchIsWorthIt(beforeBytes: number, patchBytes: number): boolean;
+export {};
+//# sourceMappingURL=diff.d.ts.map

package/dist/cosmic/diff.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"diff.d.ts","sourceRoot":"","sources":["../../src/cosmic/diff.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,KAAK,GAAG,SAAS,GAAG,QAAQ,CAAC;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,KAAK,SAAS,GAAG,OAAO,CAAC;AAoBzB;;;;;;GAMG;AACH,wBAAgB,SAAS,CAAC,MAAM,EAAE,SAAS,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,SAAK,GAAG,WAAW,EAAE,CA8BzF;AAoBD,6EAA6E;AAC7E,wBAAgB,UAAU,CAAC,KAAK,EAAE,SAAS,EAAE,GAAG,EAAE,WAAW,EAAE,GAAG,SAAS,CAM1E;AA4BD;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,WAAW,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAK/E"}

package/dist/cosmic/diff.js

@@ -0,0 +1,154 @@
+/**
+ * v2.13.0 — Minimal JSON Patch (RFC 6902 subset) for cosmic incremental
+ * publishes.
+ *
+ * Why not pull a dep? Cosmic state is small (typically < 4KB), the patch
+ * shape is bounded (publishes are version + commit + timestamp updates),
+ * and the cosmic server is single-file zero-deps. A 100-line implementation
+ * we control beats a 50KB transitive tree we don't.
+ *
+ * Supported ops: add / replace / remove. Move/copy/test omitted as they
+ * don't appear in any cosmic state-update pattern.
+ *
+ * Path encoding follows RFC 6901 (JSON Pointer): "/a/b" → state.a.b.
+ * "/" is the root. ~0 escapes ~, ~1 escapes /.
+ */
+function isObject(v) {
+    return typeof v === "object" && v !== null && !Array.isArray(v);
+}
+function escapePart(s) {
+    return s.replace(/~/g, "~0").replace(/\//g, "~1");
+}
+function unescapePart(s) {
+    return s.replace(/~1/g, "/").replace(/~0/g, "~");
+}
+function pointerToParts(ptr) {
+    if (ptr === "" || ptr === "/")
+        return [];
+    return ptr.split("/").slice(1).map(unescapePart);
+}
+/**
+ * Diff two JSON values; returns a list of patch ops that, applied to `before`,
+ * produce `after`. Optimised for cosmic state shape (objects of scalars +
+ * small arrays). Arrays are handled by full-replace when they differ — a
+ * cosmic publish never makes large array edits, so structural array diffing
+ * isn't worth the byte cost.
+ */
+export function makePatch(before, after, prefix = "") {
+    // Same reference / primitive equal — no-op.
+    if (before === after)
+        return [];
+    if (typeof before !== typeof after || Array.isArray(before) !== Array.isArray(after) || (before === null) !== (after === null)) {
+        return [{ op: "replace", path: prefix || "/", value: after }];
+    }
+    if (Array.isArray(before) && Array.isArray(after)) {
+        // Compare structurally; if arrays match shallowly, no op. Otherwise replace.
+        if (before.length === after.length && before.every((v, i) => deepEqual(v, after[i])))
+            return [];
+        return [{ op: "replace", path: prefix || "/", value: after }];
+    }
+    if (isObject(before) && isObject(after)) {
+        const ops = [];
+        // Removals first — keys present in before but not after.
+        for (const k of Object.keys(before)) {
+            if (!(k in after))
+                ops.push({ op: "remove", path: `${prefix}/${escapePart(k)}` });
+        }
+        // Additions / replacements.
+        for (const k of Object.keys(after)) {
+            const path = `${prefix}/${escapePart(k)}`;
+            if (!(k in before))
+                ops.push({ op: "add", path, value: after[k] });
+            else if (!deepEqual(before[k], after[k])) {
+                // Recurse so we get fine-grained patches inside nested objects.
+                ops.push(...makePatch(before[k], after[k], path));
+            }
+        }
+        return ops;
+    }
+    // Both are scalars and differ.
+    return [{ op: "replace", path: prefix || "/", value: after }];
+}
+function deepEqual(a, b) {
+    if (a === b)
+        return true;
+    if (a === null || b === null)
+        return a === b;
+    if (typeof a !== typeof b)
+        return false;
+    if (Array.isArray(a) && Array.isArray(b)) {
+        if (a.length !== b.length)
+            return false;
+        for (let i = 0; i < a.length; i++)
+            if (!deepEqual(a[i], b[i]))
+                return false;
+        return true;
+    }
+    if (isObject(a) && isObject(b)) {
+        const ak = Object.keys(a), bk = Object.keys(b);
+        if (ak.length !== bk.length)
+            return false;
+        for (const k of ak)
+            if (!deepEqual(a[k], b[k]))
+                return false;
+        return true;
+    }
+    return false;
+}
+/** Apply a patch list to a deep copy of `state` and return the new value. */
+export function applyPatch(state, ops) {
+    let cur = JSON.parse(JSON.stringify(state ?? null));
+    for (const op of ops) {
+        cur = applyOne(cur, op);
+    }
+    return cur;
+}
+function applyOne(state, op) {
+    const parts = pointerToParts(op.path);
+    if (parts.length === 0) {
+        // Operating on root.
+        if (op.op === "remove")
+            return null;
+        return op.value ?? null;
+    }
+    const last = parts[parts.length - 1];
+    let cur = state;
+    for (let i = 0; i < parts.length - 1; i++) {
+        const k = parts[i];
+        if (!isObject(cur) && !Array.isArray(cur))
+            throw new Error(`patch path traverses non-object at ${parts.slice(0, i + 1).join("/")}`);
+        cur = cur[k];
+        if (cur === undefined)
+            throw new Error(`patch path missing at ${parts.slice(0, i + 1).join("/")}`);
+    }
+    if (!isObject(cur) && !Array.isArray(cur))
+        throw new Error(`patch parent not container for ${op.path}`);
+    if (op.op === "remove") {
+        if (Array.isArray(cur))
+            cur.splice(parseInt(last, 10), 1);
+        else
+            delete cur[last];
+    }
+    else {
+        if (Array.isArray(cur))
+            cur[parseInt(last, 10)] = op.value;
+        else
+            cur[last] = op.value;
+    }
+    return state;
+}
+/**
+ * Decide whether a patch is "worth shipping" vs sending the full state.
+ * For cosmic, shipping the patch is only smarter than the full state when
+ * the patch is materially smaller. We require at least 30% reduction OR
+ * a 200-byte savings — below that, the round-trip risk (server applies
+ * patch wrong, drift) outweighs the byte win.
+ */
+export function patchIsWorthIt(beforeBytes, patchBytes) {
+    const saving = beforeBytes - patchBytes;
+    if (saving <= 0)
+        return false;
+    const ratio = saving / beforeBytes;
+    return ratio >= 0.3 || saving >= 200;
+}
+//# sourceMappingURL=diff.js.map

package/dist/cosmic/diff.js.map

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

package/dist/cosmic/echo_commit.d.ts

@@ -0,0 +1,79 @@
+/**
+ * v2.13.0 — ECHO-FROM-COMMITS
+ *
+ *   "When every server in your choir is unreachable AND your laptop is
+ *    closed AND the dpaste rescue paste was deleted — git itself still
+ *    remembers. The last cosmic state lives as an HMAC-signed git note
+ *    on HEAD. Clone the repo, run `git notes show`, recover the state
+ *    with zero network."
+ *
+ * Wild because: every other handoff system assumes "the network is up".
+ * ECHO-FROM-COMMITS treats the user's git history as the deepest possible
+ * fallback. State travels with the code that produced it. A teammate
+ * pulling the repo six months later can verify what the AI thought was
+ * true at commit X.
+ *
+ * Wise because: it composes with git's existing storage, refspecs, and
+ * push semantics. Nothing custom; just a structured payload in the
+ * `refs/notes/cosmic` namespace.
+ *
+ * Performance: writes ~1KB per commit. git's own gc handles cleanup.
+ * Reads are O(1) via `git notes show`.
+ */
+export interface EchoEnvelope {
+    v: 1;
+    /** ISO timestamp of when the echo was written. */
+    ts: string;
+    /** Cosmic state at the time of the echo. */
+    state: Record<string, unknown>;
+    /** Optional cosmic publicUrl — useful for the reader to know the live URL. */
+    cosmicUrl?: string;
+    /** Per-seat hashes if echoed alongside a CELESTIAL CHOIR session. */
+    choirHashes?: Array<{
+        serverUrl: string;
+        stateHash: string;
+    }>;
+    /** HMAC over canonical(envelope-without-sig). */
+    sig: string;
+}
+export interface WriteEchoInput {
+    repoDir: string;
+    commitSha?: string;
+    state: Record<string, unknown>;
+    cosmicUrl?: string;
+    choirHashes?: Array<{
+        serverUrl: string;
+        stateHash: string;
+    }>;
+    /** HMAC secret — must be the same secret the reader uses to verify. */
+    secret: string;
+}
+export interface WriteEchoResult {
+    ok: boolean;
+    commitSha?: string;
+    envelope?: EchoEnvelope;
+    error?: string;
+}
+/** Write an HMAC-signed echo envelope as a git note on the target commit. */
+export declare function writeEchoToCommit(input: WriteEchoInput): WriteEchoResult;
+export interface ReadEchoResult {
+    ok: boolean;
+    commitSha?: string;
+    envelope?: EchoEnvelope;
+    /** True iff the HMAC verified against the supplied secret. */
+    verified: boolean;
+    reason?: string;
+}
+/** Read + verify an echo envelope from the target commit. */
+export declare function readEchoFromCommit(repoDir: string, commitSha: string | undefined, secret: string): ReadEchoResult;
+/** Push the echoes ref to a remote so collaborators get them on fetch. */
+export declare function pushEchoesToRemote(repoDir: string, remote?: string): {
+    ok: boolean;
+    error?: string;
+};
+/** Pull the echoes ref from a remote. */
+export declare function fetchEchoesFromRemote(repoDir: string, remote?: string): {
+    ok: boolean;
+    error?: string;
+};
+//# sourceMappingURL=echo_commit.d.ts.map

package/dist/cosmic/echo_commit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"echo_commit.d.ts","sourceRoot":"","sources":["../../src/cosmic/echo_commit.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAOH,MAAM,WAAW,YAAY;IAC3B,CAAC,EAAE,CAAC,CAAC;IACL,kDAAkD;IAClD,EAAE,EAAE,MAAM,CAAC;IACX,4CAA4C;IAC5C,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/B,8EAA8E;IAC9E,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,qEAAqE;IACrE,WAAW,CAAC,EAAE,KAAK,CAAC;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC9D,iDAAiD;IACjD,GAAG,EAAE,MAAM,CAAC;CACb;AAmBD,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,KAAK,CAAC;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC9D,uEAAuE;IACvE,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,OAAO,CAAC;IACZ,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,YAAY,CAAC;IACxB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,6EAA6E;AAC7E,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,cAAc,GAAG,eAAe,CAyBxE;AAED,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,OAAO,CAAC;IACZ,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,YAAY,CAAC;IACxB,8DAA8D;IAC9D,QAAQ,EAAE,OAAO,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,6DAA6D;AAC7D,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,SAAS,EAAE,MAAM,EAAE,MAAM,GAAG,cAAc,CAoBjH;AAED,0EAA0E;AAC1E,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,SAAW,GAAG;IAAE,EAAE,EAAE,OAAO,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,CAGtG;AAED,yCAAyC;AACzC,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,SAAW,GAAG;IAAE,EAAE,EAAE,OAAO,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,CAGzG"}

package/dist/cosmic/echo_commit.js

@@ -0,0 +1,108 @@
+/**
+ * v2.13.0 — ECHO-FROM-COMMITS
+ *
+ *   "When every server in your choir is unreachable AND your laptop is
+ *    closed AND the dpaste rescue paste was deleted — git itself still
+ *    remembers. The last cosmic state lives as an HMAC-signed git note
+ *    on HEAD. Clone the repo, run `git notes show`, recover the state
+ *    with zero network."
+ *
+ * Wild because: every other handoff system assumes "the network is up".
+ * ECHO-FROM-COMMITS treats the user's git history as the deepest possible
+ * fallback. State travels with the code that produced it. A teammate
+ * pulling the repo six months later can verify what the AI thought was
+ * true at commit X.
+ *
+ * Wise because: it composes with git's existing storage, refspecs, and
+ * push semantics. Nothing custom; just a structured payload in the
+ * `refs/notes/cosmic` namespace.
+ *
+ * Performance: writes ~1KB per commit. git's own gc handles cleanup.
+ * Reads are O(1) via `git notes show`.
+ */
+import { spawnSync } from "node:child_process";
+import { createHmac, timingSafeEqual } from "node:crypto";
+const NOTES_REF = "refs/notes/cosmic";
+function gitArgs(repoDir, args) {
+    const r = spawnSync("git", args, { cwd: repoDir, encoding: "utf8" });
+    return { ok: r.status === 0, stdout: r.stdout?.trim() ?? "", stderr: r.stderr?.trim() ?? "" };
+}
+/** Stable JSON serialisation so the HMAC matches across implementations. */
+function canonicalise(v) {
+    if (v === null || typeof v !== "object")
+        return JSON.stringify(v);
+    if (Array.isArray(v))
+        return "[" + v.map(canonicalise).join(",") + "]";
+    const keys = Object.keys(v).sort();
+    return "{" + keys.map((k) => JSON.stringify(k) + ":" + canonicalise(v[k])).join(",") + "}";
+}
+function signEnvelope(env, secret) {
+    return createHmac("sha256", secret).update(canonicalise(env)).digest("hex");
+}
+/** Write an HMAC-signed echo envelope as a git note on the target commit. */
+export function writeEchoToCommit(input) {
+    // Resolve target commit.
+    const ref = input.commitSha ?? "HEAD";
+    const rev = gitArgs(input.repoDir, ["rev-parse", ref]);
+    if (!rev.ok)
+        return { ok: false, error: `git rev-parse failed: ${rev.stderr}` };
+    const sha = rev.stdout;
+    const envWithoutSig = {
+        v: 1,
+        ts: new Date().toISOString(),
+        state: input.state,
+        ...(input.cosmicUrl ? { cosmicUrl: input.cosmicUrl } : {}),
+        ...(input.choirHashes ? { choirHashes: input.choirHashes } : {}),
+    };
+    const sig = signEnvelope(envWithoutSig, input.secret);
+    const envelope = { ...envWithoutSig, sig };
+    const payload = JSON.stringify(envelope);
+    // git notes add -f --ref refs/notes/cosmic -m <payload> <sha>
+    // -f overwrites any prior echo on the same commit (last-write-wins).
+    const add = gitArgs(input.repoDir, [
+        "notes", "--ref", NOTES_REF, "add", "-f", "-m", payload, sha,
+    ]);
+    if (!add.ok)
+        return { ok: false, error: `git notes add failed: ${add.stderr}` };
+    return { ok: true, commitSha: sha, envelope };
+}
+/** Read + verify an echo envelope from the target commit. */
+export function readEchoFromCommit(repoDir, commitSha, secret) {
+    const ref = commitSha ?? "HEAD";
+    const rev = gitArgs(repoDir, ["rev-parse", ref]);
+    if (!rev.ok)
+        return { ok: false, verified: false, reason: `git rev-parse failed: ${rev.stderr}` };
+    const sha = rev.stdout;
+    const show = gitArgs(repoDir, ["notes", "--ref", NOTES_REF, "show", sha]);
+    if (!show.ok)
+        return { ok: false, commitSha: sha, verified: false, reason: `no echo at ${sha.slice(0, 8)}` };
+    let envelope;
+    try {
+        envelope = JSON.parse(show.stdout);
+    }
+    catch {
+        return { ok: false, commitSha: sha, verified: false, reason: "envelope is not valid JSON" };
+    }
+    // Verify HMAC.
+    const { sig, ...rest } = envelope;
+    const expected = signEnvelope(rest, secret);
+    let verified = false;
+    try {
+        verified = timingSafeEqual(Buffer.from(expected, "hex"), Buffer.from(sig, "hex"));
+    }
+    catch {
+        verified = false;
+    }
+    return { ok: true, commitSha: sha, envelope, verified, reason: verified ? undefined : "HMAC mismatch — wrong secret or tampered" };
+}
+/** Push the echoes ref to a remote so collaborators get them on fetch. */
+export function pushEchoesToRemote(repoDir, remote = "origin") {
+    const r = gitArgs(repoDir, ["push", remote, `${NOTES_REF}:${NOTES_REF}`]);
+    return { ok: r.ok, error: r.ok ? undefined : r.stderr };
+}
+/** Pull the echoes ref from a remote. */
+export function fetchEchoesFromRemote(repoDir, remote = "origin") {
+    const r = gitArgs(repoDir, ["fetch", remote, `${NOTES_REF}:${NOTES_REF}`]);
+    return { ok: r.ok, error: r.ok ? undefined : r.stderr };
+}
+//# sourceMappingURL=echo_commit.js.map