@mneme-ai/core 2.9.4 → 2.11.0

package/dist/nexus_lock/nexus_lock.test.js

@@ -0,0 +1,241 @@
+import { describe, it, expect } from "vitest";
+import { buildSoulPromptV2, verifySoulPromptV2, parseHomunculusReturn, freshnessLabel } from "./soul_prompt_v2.js";
+import { publishToStargate } from "./stargate.js";
+import { ObedienceLedger, trialFromReturn } from "./obedience_ledger.js";
+import { runSelfTests, renderSelfTestReport, buildUserTestProtocol } from "./selftest.js";
+describe("v2.10 NEXUS-LOCK · soul prompt v2", () => {
+    const baseInput = {
+        receivingVendor: "gemini",
+        originatingVendor: "claude-opus-4-7",
+        currentMnemeVersion: "2.10.0",
+        npmLatestVersion: "2.10.0",
+        recentCommits: [{ sha: "abc12345abcd", subject: "feat: NEXUS-LOCK v2" }],
+        secret: "test-secret-fixed",
+    };
+    it("contains VERSION-LOCKED block at the top, before any other content", () => {
+        const p = buildSoulPromptV2(baseInput);
+        const lockedIdx = p.text.indexOf("⚡ VERSION-LOCKED MNEME CONTEXT");
+        const contractIdx = p.text.indexOf("🔒 NEXUS-LOCK CONTRACT");
+        expect(lockedIdx).toBeGreaterThan(0);
+        expect(contractIdx).toBeGreaterThan(lockedIdx);
+    });
+    it("BURY THE LEDE: directive that LIVE STATE supersedes all other version mentions", () => {
+        const p = buildSoulPromptV2(baseInput);
+        expect(p.text).toContain("authoritative source of state");
+        expect(p.text).toContain("SUPERSEDED");
+    });
+    it("4-rule contract is present", () => {
+        const p = buildSoulPromptV2(baseInput);
+        expect(p.text).toContain("STATUS EMOJI FIRST");
+        expect(p.text).toContain("VERSION CLAIMS ARE GATED");
+        expect(p.text).toContain("HOMUNCULUS RETURN FOOTER");
+        expect(p.text).toContain("NO IMPROVISATION ON STATE");
+    });
+    it("HMAC signature is deterministic for same input + secret", () => {
+        const a = buildSoulPromptV2(baseInput);
+        const b = buildSoulPromptV2(baseInput);
+        expect(a.sig).toBe(b.sig);
+    });
+    it("HMAC signature changes when version changes (catches tampering)", () => {
+        const a = buildSoulPromptV2(baseInput);
+        const b = buildSoulPromptV2({ ...baseInput, currentMnemeVersion: "9.9.9" });
+        expect(a.sig).not.toBe(b.sig);
+    });
+    it("verifier accepts a clean prompt", () => {
+        const p = buildSoulPromptV2(baseInput);
+        const v = verifySoulPromptV2(p.text);
+        expect(v.ok).toBe(true);
+        expect(v.reasons).toEqual([]);
+    });
+    it("verifier rejects a prompt with no HMAC field", () => {
+        const p = buildSoulPromptV2(baseInput);
+        const tampered = p.text.replace(/HMAC-SHA256:\*\*\s*`[0-9a-f]+`/, "HMAC-SHA256:** `<gone>`");
+        const v = verifySoulPromptV2(tampered);
+        expect(v.ok).toBe(false);
+        expect(v.reasons).toContain("missing HMAC signature");
+    });
+    it("vendor name embedded in HOMUNCULUS template", () => {
+        const p = buildSoulPromptV2({ ...baseInput, receivingVendor: "chatgpt" });
+        expect(p.text).toContain("vendor: chatgpt");
+    });
+    it("Stargate URL embedded when supplied", () => {
+        const p = buildSoulPromptV2({ ...baseInput, stargateUrl: "https://dpaste.com/XYZ.txt" });
+        expect(p.text).toContain("https://dpaste.com/XYZ.txt");
+    });
+    it("Stargate URL absent when null", () => {
+        const p = buildSoulPromptV2({ ...baseInput, stargateUrl: null });
+        expect(p.text).not.toContain("Stargate (optional");
+    });
+    it("recentTurns rendered with timestamps", () => {
+        const p = buildSoulPromptV2({
+            ...baseInput,
+            recentTurns: [
+                { ts: "2026-05-15T08:00:00.000Z", role: "user", text: "hello" },
+                { ts: "2026-05-15T08:00:05.000Z", role: "assistant", text: "hi" },
+            ],
+        });
+        expect(p.text).toContain("[2026-05-15T08:00:00.000Z]");
+        expect(p.text).toContain("RECENT TURNS (historical");
+    });
+});
+describe("v2.10 NEXUS-LOCK · HomunculusReturn parser", () => {
+    it("parses a well-formed reply", () => {
+        const reply = `🟢 Version 2.10.0 per LIVE STATE.\n\n# HOMUNCULUS RETURN\nvendor: gemini\nseen_version: 2.10.0\nfreshness: fresh\nturn: 1\ncompliance: emoji-ok|version-quoted\n`;
+        const r = parseHomunculusReturn(reply);
+        expect(r).not.toBeNull();
+        expect(r.vendor).toBe("gemini");
+        expect(r.seenVersion).toBe("2.10.0");
+        expect(r.freshness).toBe("fresh");
+        expect(r.turn).toBe(1);
+        expect(r.emojiFirst).toBe(true);
+    });
+    it("returns null when footer is missing", () => {
+        expect(parseHomunculusReturn("just some plain text")).toBeNull();
+    });
+    it("detects missing emoji-first", () => {
+        const reply = `Plain prose with no emoji at start.\n\n# HOMUNCULUS RETURN\nvendor: gemini\nseen_version: 2.10.0\nfreshness: fresh\nturn: 1\ncompliance: ok\n`;
+        const r = parseHomunculusReturn(reply);
+        expect(r).not.toBeNull();
+        expect(r.emojiFirst).toBe(false);
+    });
+    it("normalizes unknown freshness to 'unknown'", () => {
+        const reply = `🟢 hello\n\n# HOMUNCULUS RETURN\nvendor: x\nseen_version: 1.0\nfreshness: weird\nturn: 1\ncompliance: ok\n`;
+        const r = parseHomunculusReturn(reply);
+        expect(r.freshness).toBe("unknown");
+    });
+    it("returns null when required fields missing", () => {
+        const reply = `🟢 hello\n\n# HOMUNCULUS RETURN\nvendor: gemini\nturn: 1\n`;
+        expect(parseHomunculusReturn(reply)).toBeNull();
+    });
+    it("handles fenced code-block format from real AI replies", () => {
+        const reply = `🟢 Mneme is at 2.10.0\n\n\`\`\`\n# HOMUNCULUS RETURN\nvendor: claude\nseen_version: 2.10.0\nfreshness: fresh\nturn: 2\ncompliance: ok\n\`\`\`\n`;
+        const r = parseHomunculusReturn(reply);
+        expect(r).not.toBeNull();
+        expect(r.vendor).toBe("claude");
+        expect(r.turn).toBe(2);
+    });
+});
+describe("v2.10 NEXUS-LOCK · freshness math", () => {
+    it("just-generated → fresh", () => {
+        expect(freshnessLabel(new Date().toISOString())).toBe("fresh");
+    });
+    it("7 hours old → aging", () => {
+        expect(freshnessLabel(new Date(Date.now() - 7 * 3_600_000).toISOString())).toBe("aging");
+    });
+    it("25 hours old → stale (default 24h threshold)", () => {
+        expect(freshnessLabel(new Date(Date.now() - 25 * 3_600_000).toISOString())).toBe("stale");
+    });
+    it("custom staleAfterHours respected", () => {
+        // 5h old: tighter threshold → stale; loose threshold → still fresh (5h < 6h aging boundary)
+        const fiveH = new Date(Date.now() - 5 * 3_600_000).toISOString();
+        expect(freshnessLabel(fiveH, Date.now(), 1)).toBe("stale");
+        expect(freshnessLabel(fiveH, Date.now(), 100)).toBe("fresh");
+        // 8h old + custom large stale: aging (past 6h aging boundary, not yet stale)
+        const eightH = new Date(Date.now() - 8 * 3_600_000).toISOString();
+        expect(freshnessLabel(eightH, Date.now(), 100)).toBe("aging");
+    });
+});
+describe("v2.10 NEXUS-LOCK · STARGATE publisher", () => {
+    it("returns null on fetch failure", async () => {
+        const r = await publishToStargate({
+            state: { mnemeVersion: "2.10.0", npmLatest: null, recentCommits: [], generatedAt: new Date().toISOString(), originator: "claude" },
+            fetchOverride: async () => { throw new Error("network down"); },
+        });
+        expect(r).toBeNull();
+    });
+    it("returns null on non-OK response", async () => {
+        const r = await publishToStargate({
+            state: { mnemeVersion: "2.10.0", npmLatest: null, recentCommits: [], generatedAt: new Date().toISOString(), originator: "claude" },
+            fetchOverride: async () => new Response("err", { status: 503 }),
+        });
+        expect(r).toBeNull();
+    });
+    it("returns paste URL on success and converts to .txt raw form", async () => {
+        const fakeFetch = async () => new Response("https://dpaste.com/ABC123", { status: 200 });
+        const r = await publishToStargate({
+            state: { mnemeVersion: "2.10.0", npmLatest: null, recentCommits: [], generatedAt: new Date().toISOString(), originator: "claude" },
+            fetchOverride: fakeFetch,
+        });
+        expect(r).not.toBeNull();
+        expect(r.url).toBe("https://dpaste.com/ABC123.txt");
+        expect(r.expiresAt).toBeGreaterThan(Date.now());
+    });
+    it("rejects malformed response body (not a URL)", async () => {
+        const fakeFetch = async () => new Response("not-a-url", { status: 200 });
+        const r = await publishToStargate({
+            state: { mnemeVersion: "2.10.0", npmLatest: null, recentCommits: [], generatedAt: new Date().toISOString(), originator: "claude" },
+            fetchOverride: fakeFetch,
+        });
+        expect(r).toBeNull();
+    });
+});
+describe("v2.10 NEXUS-LOCK · ObedienceLedger", () => {
+    it("records trials + computes Wilson LB", () => {
+        const led = new ObedienceLedger();
+        for (let i = 0; i < 5; i++) {
+            led.record({ vendor: "gemini", emojiOk: true, versionQuoted: true, refusedWhenStale: false, staleProbe: false, ts: i });
+        }
+        const sc = led.scorecard();
+        expect(sc.length).toBe(1);
+        expect(sc[0].vendor).toBe("gemini");
+        expect(sc[0].trials).toBe(5);
+        expect(sc[0].emojiOk).toBe(5);
+        expect(sc[0].versionQuoted).toBe(5);
+        expect(sc[0].wilson).toBeGreaterThan(0.5);
+    });
+    it("ranks vendors by Wilson LB into tiers", () => {
+        const led = new ObedienceLedger();
+        // claude: 10/10 perfect
+        for (let i = 0; i < 10; i++)
+            led.record({ vendor: "claude", emojiOk: true, versionQuoted: true, refusedWhenStale: false, staleProbe: false, ts: i });
+        // gpt: 5/10 mixed
+        for (let i = 0; i < 5; i++)
+            led.record({ vendor: "gpt", emojiOk: true, versionQuoted: true, refusedWhenStale: false, staleProbe: false, ts: i });
+        for (let i = 5; i < 10; i++)
+            led.record({ vendor: "gpt", emojiOk: false, versionQuoted: false, refusedWhenStale: false, staleProbe: false, ts: i });
+        const r = led.rank();
+        expect(r[0].vendor).toBe("claude");
+        expect(r[0].tier).toBe("A");
+        expect(r[1].vendor).toBe("gpt");
+        expect(["B", "C", "F"]).toContain(r[1].tier);
+    });
+    it("trialFromReturn marks refusal-on-stale as correct behavior", () => {
+        const ret = { vendor: "gemini", seenVersion: "?", freshness: "stale", turn: 1, compliance: "ok", emojiFirst: true };
+        const t = trialFromReturn(ret, "2.10.0", true);
+        expect(t.refusedWhenStale).toBe(true);
+    });
+    it("trialFromReturn flags wrong-version-quoted on fresh probe", () => {
+        const ret = { vendor: "gemini", seenVersion: "1.95", freshness: "fresh", turn: 1, compliance: "ok", emojiFirst: true };
+        const t = trialFromReturn(ret, "2.10.0", false);
+        expect(t.versionQuoted).toBe(false);
+    });
+    it("serialize / parse round-trips", () => {
+        const led = new ObedienceLedger();
+        led.record({ vendor: "x", emojiOk: true, versionQuoted: true, refusedWhenStale: false, staleProbe: false, ts: 1 });
+        const text = led.serialize();
+        const led2 = ObedienceLedger.parse(text);
+        expect(led2.scorecard()[0].vendor).toBe("x");
+    });
+});
+describe("v2.10 NEXUS-LOCK · self-test harness", () => {
+    it("runSelfTests returns all-pass on a healthy module", () => {
+        const results = runSelfTests();
+        const failures = results.filter((r) => !r.ok);
+        expect(failures.length).toBe(0);
+        expect(results.length).toBeGreaterThan(10);
+    });
+    it("renderSelfTestReport produces a readable Markdown summary", () => {
+        const results = runSelfTests();
+        const md = renderSelfTestReport(results);
+        expect(md).toContain("NEXUS-LOCK self-test report");
+        expect(md).toMatch(/\d+ \/ \d+ pass/);
+    });
+    it("buildUserTestProtocol produces TEST A/B/C/D blocks", () => {
+        const proto = buildUserTestProtocol();
+        expect(proto).toContain("TEST A — fresh soul");
+        expect(proto).toContain("TEST B — stale soul");
+        expect(proto).toContain("TEST C — fetch-capable AI");
+        expect(proto).toContain("TEST D — cross-vendor consistency");
+    });
+});
+//# sourceMappingURL=nexus_lock.test.js.map

package/dist/nexus_lock/nexus_lock.test.js.map

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

package/dist/nexus_lock/obedience_ledger.d.ts

@@ -0,0 +1,62 @@
+/**
+ * v2.10.0 -- VENDOR OBEDIENCE LEDGER.
+ *
+ * Each pasted-back AI reply (HOMUNCULUS RETURN parsed) updates a
+ * per-vendor scorecard. Over time we learn which AIs actually obey
+ * the NEXUS-LOCK contract:
+ *
+ *   - did the reply start with the status emoji?
+ *   - did it quote the version verbatim from LIVE STATE?
+ *   - did it refuse when stale (vs lie)?
+ *
+ * Wilson lower bound at 95% so a single lucky reply doesn't
+ * over-trust a vendor. Scorecard becomes the empirical answer to
+ * "which AI actually understands Mneme protocol?"
+ *
+ * Pure in-memory; persistence is the caller's responsibility (e.g.,
+ * the daemon writes .mneme/nexus-lock/obedience.jsonl).
+ */
+import type { HomunculusReturn } from "./soul_prompt_v2.js";
+export interface ObedienceRow {
+    vendor: string;
+    trials: number;
+    emojiOk: number;
+    versionQuoted: number;
+    refusedWhenStale: number;
+    /** Wilson LB of overall obedience (all 3 dimensions weighted equally). */
+    wilson: number;
+    /** Unweighted obedience rate. */
+    rate: number;
+}
+export interface LedgerTrial {
+    vendor: string;
+    emojiOk: boolean;
+    versionQuoted: boolean;
+    refusedWhenStale: boolean;
+    /** True if the trial was on a stale soul prompt (so refusal is the
+     *  correct behaviour). */
+    staleProbe: boolean;
+    ts: number;
+}
+export declare class ObedienceLedger {
+    private readonly trials;
+    constructor(initial?: LedgerTrial[]);
+    /** Record a trial inferred from a HomunculusReturn + a known
+     *  freshness label of the soul prompt that was sent. */
+    record(t: LedgerTrial): void;
+    /** Per-vendor scorecard. */
+    scorecard(): ObedienceRow[];
+    /** Rank vendors by Wilson LB; useful for "which vendor should I clone to?" */
+    rank(): Array<{
+        vendor: string;
+        wilson: number;
+        tier: "A" | "B" | "C" | "F";
+    }>;
+    serialize(): string;
+    static parse(text: string): ObedienceLedger;
+}
+/** Convert a HomunculusReturn + the soul prompt's expected version
+ *  into a ledger trial. The caller knows whether the soul was stale
+ *  at the moment of posting. */
+export declare function trialFromReturn(ret: HomunculusReturn, expectedVersion: string, staleProbe: boolean, now?: number): LedgerTrial;
+//# sourceMappingURL=obedience_ledger.d.ts.map

package/dist/nexus_lock/obedience_ledger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"obedience_ledger.d.ts","sourceRoot":"","sources":["../../src/nexus_lock/obedience_ledger.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAE5D,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,aAAa,EAAE,MAAM,CAAC;IACtB,gBAAgB,EAAE,MAAM,CAAC;IACzB,0EAA0E;IAC1E,MAAM,EAAE,MAAM,CAAC;IACf,iCAAiC;IACjC,IAAI,EAAE,MAAM,CAAC;CACd;AAWD,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,OAAO,CAAC;IACjB,aAAa,EAAE,OAAO,CAAC;IACvB,gBAAgB,EAAE,OAAO,CAAC;IAC1B;8BAC0B;IAC1B,UAAU,EAAE,OAAO,CAAC;IACpB,EAAE,EAAE,MAAM,CAAC;CACZ;AAED,qBAAa,eAAe;IAC1B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAqB;gBAEhC,OAAO,GAAE,WAAW,EAAO;IAIvC;4DACwD;IACxD,MAAM,CAAC,CAAC,EAAE,WAAW,GAAG,IAAI;IAI5B,4BAA4B;IAC5B,SAAS,IAAI,YAAY,EAAE;IAkC3B,8EAA8E;IAC9E,IAAI,IAAI,KAAK,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,CAAA;KAAE,CAAC;IAQ9E,SAAS,IAAI,MAAM;IAInB,MAAM,CAAC,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,eAAe;CAS5C;AAED;;gCAEgC;AAChC,wBAAgB,eAAe,CAC7B,GAAG,EAAE,gBAAgB,EACrB,eAAe,EAAE,MAAM,EACvB,UAAU,EAAE,OAAO,EACnB,GAAG,GAAE,MAAmB,GACvB,WAAW,CAYb"}

package/dist/nexus_lock/obedience_ledger.js

@@ -0,0 +1,114 @@
+/**
+ * v2.10.0 -- VENDOR OBEDIENCE LEDGER.
+ *
+ * Each pasted-back AI reply (HOMUNCULUS RETURN parsed) updates a
+ * per-vendor scorecard. Over time we learn which AIs actually obey
+ * the NEXUS-LOCK contract:
+ *
+ *   - did the reply start with the status emoji?
+ *   - did it quote the version verbatim from LIVE STATE?
+ *   - did it refuse when stale (vs lie)?
+ *
+ * Wilson lower bound at 95% so a single lucky reply doesn't
+ * over-trust a vendor. Scorecard becomes the empirical answer to
+ * "which AI actually understands Mneme protocol?"
+ *
+ * Pure in-memory; persistence is the caller's responsibility (e.g.,
+ * the daemon writes .mneme/nexus-lock/obedience.jsonl).
+ */
+function wilsonLower(succ, total, z = 1.96) {
+    if (total === 0)
+        return 0;
+    const p = succ / total;
+    const denom = 1 + (z * z) / total;
+    const center = p + (z * z) / (2 * total);
+    const margin = z * Math.sqrt((p * (1 - p) + (z * z) / (4 * total)) / total);
+    return Math.max(0, Math.min(1, (center - margin) / denom));
+}
+export class ObedienceLedger {
+    trials = [];
+    constructor(initial = []) {
+        this.trials = initial.slice();
+    }
+    /** Record a trial inferred from a HomunculusReturn + a known
+     *  freshness label of the soul prompt that was sent. */
+    record(t) {
+        this.trials.push(t);
+    }
+    /** Per-vendor scorecard. */
+    scorecard() {
+        const byVendor = new Map();
+        for (const t of this.trials) {
+            const e = byVendor.get(t.vendor) ?? { vendor: t.vendor, trials: 0, emoji: 0, quoted: 0, refused: 0, stale: 0 };
+            e.trials++;
+            if (t.emojiOk)
+                e.emoji++;
+            if (t.versionQuoted)
+                e.quoted++;
+            if (t.staleProbe) {
+                e.stale++;
+                if (t.refusedWhenStale)
+                    e.refused++;
+            }
+            byVendor.set(t.vendor, e);
+        }
+        const rows = [];
+        for (const e of byVendor.values()) {
+            // Composite obedience: emoji + quoted + (refusedWhenStale|noStaleProbed)
+            // Counted out of 3 dimensions per trial.
+            const obeyed = e.emoji + e.quoted + (e.stale > 0 ? e.refused : e.trials);
+            const possible = e.trials * 3;
+            const rate = possible > 0 ? obeyed / possible : 0;
+            const wilson = wilsonLower(obeyed, possible);
+            rows.push({
+                vendor: e.vendor,
+                trials: e.trials,
+                emojiOk: e.emoji,
+                versionQuoted: e.quoted,
+                refusedWhenStale: e.refused,
+                wilson,
+                rate,
+            });
+        }
+        return rows.sort((a, b) => b.wilson - a.wilson);
+    }
+    /** Rank vendors by Wilson LB; useful for "which vendor should I clone to?" */
+    rank() {
+        return this.scorecard().map((r) => ({
+            vendor: r.vendor,
+            wilson: r.wilson,
+            tier: r.wilson >= 0.85 ? "A" : r.wilson >= 0.65 ? "B" : r.wilson >= 0.45 ? "C" : "F",
+        }));
+    }
+    serialize() {
+        return JSON.stringify(this.trials);
+    }
+    static parse(text) {
+        try {
+            const arr = JSON.parse(text);
+            if (!Array.isArray(arr))
+                return new ObedienceLedger();
+            return new ObedienceLedger(arr);
+        }
+        catch {
+            return new ObedienceLedger();
+        }
+    }
+}
+/** Convert a HomunculusReturn + the soul prompt's expected version
+ *  into a ledger trial. The caller knows whether the soul was stale
+ *  at the moment of posting. */
+export function trialFromReturn(ret, expectedVersion, staleProbe, now = Date.now()) {
+    const versionQuoted = ret.seenVersion === expectedVersion;
+    // Refusal is correct if stale + AI declared "stale"/"refused".
+    const refusedWhenStale = staleProbe && (ret.freshness === "stale" || ret.freshness === "refused");
+    return {
+        vendor: ret.vendor,
+        emojiOk: ret.emojiFirst,
+        versionQuoted,
+        refusedWhenStale,
+        staleProbe,
+        ts: now,
+    };
+}
+//# sourceMappingURL=obedience_ledger.js.map

package/dist/nexus_lock/obedience_ledger.js.map

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

package/dist/nexus_lock/selftest.d.ts

@@ -0,0 +1,35 @@
+/**
+ * v2.10.0 -- NEXUS-LOCK self-test harness.
+ *
+ *   "Verify deterministically that every prompt we generate has all
+ *    5 required mechanisms; A/B-compare against the v1 baseline."
+ *
+ * What we CAN test from inside the codebase (deterministic, 100%):
+ *   - Soul prompt v2 structure: every required block present?
+ *   - HMAC signature intact?
+ *   - HOMUNCULUS RETURN parser round-trips?
+ *   - Stargate URL embedding?
+ *   - Stale-detection math correct?
+ *
+ * What we CANNOT test from inside (requires real AI calls):
+ *   - "Does Gemini Free actually obey the contract?"
+ *   - "Does ChatGPT browse fetch the Stargate URL?"
+ *
+ * For those we EMIT a test protocol the user runs on their phone.
+ * Results land in the ObedienceLedger and become the empirical answer.
+ */
+export interface SelfTestResult {
+    test: string;
+    ok: boolean;
+    detail?: string;
+}
+/** Run the deterministic structure tests. Returns a list of pass/fail
+ *  rows the caller can render. */
+export declare function runSelfTests(): SelfTestResult[];
+/** A renderable Markdown report of the test run. */
+export declare function renderSelfTestReport(results: SelfTestResult[]): string;
+/** Human-readable test PROTOCOL the USER runs on real AI tools.
+ *  The results plug back into the ObedienceLedger via the parsed
+ *  HOMUNCULUS RETURN footer. */
+export declare function buildUserTestProtocol(): string;
+//# sourceMappingURL=selftest.d.ts.map

package/dist/nexus_lock/selftest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"selftest.d.ts","sourceRoot":"","sources":["../../src/nexus_lock/selftest.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAIH,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,OAAO,CAAC;IACZ,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;kCACkC;AAClC,wBAAgB,YAAY,IAAI,cAAc,EAAE,CAkI/C;AAED,oDAAoD;AACpD,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,cAAc,EAAE,GAAG,MAAM,CAYtE;AAED;;gCAEgC;AAChC,wBAAgB,qBAAqB,IAAI,MAAM,CA0C9C"}