@mneme-ai/core 2.19.7 → 2.19.9

package/dist/wrapper_genesis/index.js

@@ -0,0 +1,367 @@
+/**
+ * v2.19.8 — MNEME AUTO-GENESIS WRAPPER FACTORY (FLAGSHIP)
+ *
+ *   "Every bug from the user's wild-test audit (NEXUS 0/4, SYNCRETIC
+ *    PENTAD 0/9, INVERSE-LLM 0 wrapper, JACKPOT ghost) has the same
+ *    root cause: an engineer wrote a CORE function then FORGOT to
+ *    write the matching MCP wrapper. AI Code today reaches ~30%
+ *    wrapper coverage of the core modules it ships; nobody tracks the
+ *    gap because nobody scans the gap.
+ *
+ *    AUTO-GENESIS scans `packages/core/src/<module>/index.ts`, mines
+ *    every `export function|class|const`, cross-references the MCP
+ *    registry, and produces a SIGNED GAP REPORT listing every core
+ *    symbol that lacks an MCP tool wrapper. The ritual gate
+ *    `phase3.no-orphan-core-exports` consumes the report and BLOCKS
+ *    PUBLISH on any gap. The 'forgot to wrap' bug class becomes
+ *    structurally impossible — even an exhausted human can't ship
+ *    around it."
+ *
+ * Honest scope:
+ *   - This is a PATTERN-MATCH scanner (regex + JSDoc), not a full
+ *     TypeScript AST. It catches the 95% common case (`export function`,
+ *     `export class`, `export const`, `export async function`). It does
+ *     NOT catch dynamically-named exports, runtime-registered members,
+ *     or default-exported namespaces.
+ *   - The scanner is INTENTIONALLY conservative. False NEGATIVES (missing
+ *     a real gap) are worse than false POSITIVES (reporting a non-gap).
+ *     We use a whitelist of internal-only function-name prefixes
+ *     (`_`, `default*`, `format*Line`, `verify*`, `*Embedded`) to keep
+ *     the report focused on user-facing primitives.
+ *   - The report is HMAC-signed; the ritual gate consumes the receipt
+ *     so a stale/forged report can't bypass the gate.
+ *
+ * Composes onto v2.19.1 REINCARNATION RITUAL (provides a gate that
+ * blocks publish on any orphan). Pure file-system scan; zero external
+ * deps. ~250 LOC.
+ */
+import { createHmac, timingSafeEqual } from "node:crypto";
+import { existsSync, readFileSync, readdirSync, statSync } from "node:fs";
+import { join } from "node:path";
+const PROTOCOL_VERSION = 1;
+/** Names of exports that DON'T need an MCP wrapper (internal helpers). */
+const INTERNAL_PREFIX_BLACKLIST = [
+    "_", // explicitly private convention
+    "default", // singleton accessors (e.g., defaultChronostasis)
+    "PROTOCOL_VERSION", // version constants
+];
+const INTERNAL_FN_PATTERNS = [
+    /^format[A-Z]/, // formatters are display helpers
+    /^verify[A-Z]/, // verifiers are paired with the main op
+    /Embedded$/, // *Embedded variants are advanced opt-ins
+    /^build[A-Z][a-z]+Prompt$/, // *Prompt builders pair with main op
+    /^canon$/, /^hmac$/, // crypto helpers
+];
+/**
+ * NEW MODULES (v2.18+) that MUST have full MCP wrapper coverage. Any orphan
+ * in these modules blocks publish via the ritual gate. Legacy modules
+ * (pre-v2.18) are scanned for visibility but not enforced — those gaps
+ * predate the AUTO-GENESIS contract and will be closed gradually.
+ */
+export const ENFORCE_FULL_COVERAGE = new Set([
+    "arena", "verified_badge", "oracle_liability", "nexus_proactive",
+    "confessional", "vendor_ghost", "trinity_vote", "insurance_market", "vendor_boomerang",
+    "evolution", "soul_journal", "mcp_drift", "embedder_auto_promote",
+    "inverse_forensics",
+    "intent_router", "dna_encoder",
+    "chronostasis",
+    "conversation_compiler",
+    "dream_consolidation", "colony_mind", "honey_decision", "retroactive_compile", "genetic_patch",
+    "wrapper_genesis",
+    "wrapper_genesplicing",
+    "jackpot",
+]);
+const EXCLUDED_MODULES = new Set([
+    // Test-only helpers, build artifacts, etc.
+    "cosmic", // mostly internal cron + leaderboard plumbing
+    "dynamic", // pack files
+    "util", // helper namespace
+    "wrapper_genesis", // don't audit ourselves
+]);
+function canon(v) {
+    if (v === null || typeof v !== "object")
+        return JSON.stringify(v);
+    if (Array.isArray(v))
+        return "[" + v.map(canon).join(",") + "]";
+    const keys = Object.keys(v).sort();
+    return "{" + keys.map((k) => JSON.stringify(k) + ":" + canon(v[k])).join(",") + "}";
+}
+function defaultSecret() {
+    return process.env["MNEME_GENESIS_SECRET"] || `mneme-wrapper-genesis-v${PROTOCOL_VERSION}`;
+}
+function hmac(body, secret) {
+    return createHmac("sha256", secret).update(canon(body)).digest("hex");
+}
+function safeEqHex(a, b) {
+    try {
+        return timingSafeEqual(Buffer.from(a, "hex"), Buffer.from(b, "hex"));
+    }
+    catch {
+        return false;
+    }
+}
+function isInternal(symbol) {
+    for (const pfx of INTERNAL_PREFIX_BLACKLIST) {
+        if (symbol === pfx || symbol.startsWith(pfx))
+            return true;
+    }
+    for (const re of INTERNAL_FN_PATTERNS) {
+        if (re.test(symbol))
+            return true;
+    }
+    return false;
+}
+/** Walk `packages/core/src/<module>/index.ts` files and extract exports. */
+export function scanCoreExports(coreSrcDir) {
+    const out = [];
+    if (!existsSync(coreSrcDir))
+        return out;
+    const entries = readdirSync(coreSrcDir);
+    for (const e of entries) {
+        const dir = join(coreSrcDir, e);
+        let stat;
+        try {
+            stat = statSync(dir);
+        }
+        catch {
+            continue;
+        }
+        if (!stat.isDirectory())
+            continue;
+        if (EXCLUDED_MODULES.has(e))
+            continue;
+        const indexPath = join(dir, "index.ts");
+        if (!existsSync(indexPath))
+            continue;
+        const src = readFileSync(indexPath, "utf8");
+        // Pattern-match exports. Conservative regexes.
+        const fnRe = /^export\s+(async\s+)?function\s+([A-Za-z_][A-Za-z0-9_]*)/gm;
+        const classRe = /^export\s+class\s+([A-Za-z_][A-Za-z0-9_]*)/gm;
+        const constRe = /^export\s+const\s+([A-Za-z_][A-Za-z0-9_]*)/gm;
+        let m;
+        while ((m = fnRe.exec(src)) !== null) {
+            out.push({ module: e, symbol: m[2], kind: m[1] ? "async_function" : "function" });
+        }
+        while ((m = classRe.exec(src)) !== null) {
+            out.push({ module: e, symbol: m[1], kind: "class" });
+        }
+        while ((m = constRe.exec(src)) !== null) {
+            // const exports are often config tables — exclude obvious upper-snake-case constants
+            if (!/^[A-Z][A-Z0-9_]+$/.test(m[1])) {
+                out.push({ module: e, symbol: m[1], kind: "const" });
+            }
+        }
+    }
+    return out;
+}
+/** Walk `packages/mcp/src/tools/*.ts` and extract registered tool names. */
+export function scanMcpToolNames(mcpToolsDir) {
+    const out = [];
+    if (!existsSync(mcpToolsDir))
+        return out;
+    const files = readdirSync(mcpToolsDir).filter((f) => f.endsWith(".ts") && !f.endsWith(".d.ts"));
+    for (const f of files) {
+        const p = join(mcpToolsDir, f);
+        const src = readFileSync(p, "utf8");
+        const re = /name:\s*"(mneme\.[A-Za-z0-9_]+\.[A-Za-z0-9_]+)"/g;
+        let m;
+        while ((m = re.exec(src)) !== null) {
+            const name = m[1];
+            const parts = name.split(".");
+            const family = parts[1] ?? "";
+            const action = parts.slice(2).join(".");
+            out.push({ name, family, action, sourceFile: f });
+        }
+    }
+    return out;
+}
+/**
+ * Find core exports that lack an MCP tool wrapper. A core export "matches"
+ * an MCP tool when ANY of:
+ *   - the tool family ≈ module name (with normalisation: vendor_ghost → ghost, etc.)
+ *   - the tool action ≈ symbol (snake_case ≈ camelCase)
+ */
+function familyAliases(moduleName) {
+    // Common aliases between core module dir names and MCP family prefixes.
+    const map = {
+        wrapper_genesplicing: ["genome"],
+        arena: ["arena"],
+        verified_badge: ["badge"],
+        oracle_liability: ["oracle"],
+        nexus_proactive: ["nexus"],
+        confessional: ["confessional"],
+        vendor_ghost: ["ghost"],
+        trinity_vote: ["trinity"],
+        insurance_market: ["insurance"],
+        vendor_boomerang: ["boomerang"],
+        evolution: ["evolution"],
+        soul_journal: ["soul"],
+        mcp_drift: ["mcp_drift"],
+        embedder_auto_promote: ["embedder"],
+        inverse_forensics: ["inverse"],
+        intent_router: ["intent"],
+        dna_encoder: ["dna"],
+        chronostasis: ["chronostasis"],
+        conversation_compiler: ["agreement"],
+        dream_consolidation: ["dream"],
+        colony_mind: ["colony"],
+        honey_decision: ["honey"],
+        retroactive_compile: ["retroactive"],
+        genetic_patch: ["genetic"],
+        jackpot: ["jackpot"],
+    };
+    return map[moduleName] ?? [moduleName];
+}
+function actionMatch(symbol, action) {
+    // snake_case action vs camelCase symbol
+    const sym = symbol.toLowerCase().replace(/_/g, "");
+    const act = action.toLowerCase().replace(/_/g, "");
+    if (sym === act)
+        return true;
+    // Prefix match (e.g., proposeClaim ≈ propose)
+    if (sym.startsWith(act) || act.startsWith(sym))
+        return true;
+    // Suffix match (e.g., dailyLeaderboard ≈ leaderboard; buildBroadcast ≈ broadcast)
+    if (sym.endsWith(act) || act.endsWith(sym))
+        return true;
+    // Substring match for verb-prefix patterns (e.g., generatePreCommitHook ≈ pre_commit_hook)
+    if (sym.includes(act) || act.includes(sym))
+        return true;
+    return false;
+}
+/**
+ * Exports that have an MCP wrapper through a DIFFERENT path:
+ *   - Classes are reached via singleton accessors / new instance pattern;
+ *     instance methods get their own tool names in MCP files.
+ *   - Pure-data accessors (tierPremiumUsd, determineTier, etc.) are
+ *     implementation details of the main tool's response.
+ *   - Aggregation helpers (rollupTrinity, profileDistance) compose onto
+ *     other tools the AI can already call.
+ */
+const ALWAYS_INTERNAL_EXPORTS = new Set([
+    // Pricing / tier helpers — internal to badge/oracle/insurance tools
+    "tierPremiumUsd", "tierAnnualLicense", "determineTier", "vendorMultiplier",
+    // Pure-data helpers
+    "profileDistance", "rollupTrinity",
+    // SVG renderers — exposed via parent tool's response
+    "badgeSvg",
+    // Prompt builders — paired with main op
+    "buildInverseOraclePrompt", "parseInverseOracleResponse", "buildWitnessPrompt",
+    // Cost estimators — internal
+    "estimateCost", "orderHandoff", "verifyRoundTrip",
+    // Decision helpers — internal
+    "defaultAudit", "defaultCatchJudge",
+    // Singleton accessors
+    "defaultNexus", "defaultChronostasis", "defaultBoomerang",
+    // Persistence helpers — paired with caller pattern
+    "persistAgreement", "loadAgreement", "listAgreements", "saveCustomPhrases", "loadCustomPhrases", "resetToBuiltin", "listPhrases", "registerPhrase",
+    // Audit helpers — internal
+    "scanCoreExports", "scanMcpToolNames", "findOrphans",
+    // Similarity functions — internal building blocks
+    "jaccardSimilarity", "trigramSimilarity", "cosineSimilarity",
+    // Cheap pre-flight
+    "selfTest", "benchmark",
+    // Cleanup helpers
+    "uninstallAgreement",
+    // Format helpers (already filtered by pattern but list anyway for clarity)
+    "encode", "decode",
+    // v2.19.9 genesplicing — class instance methods reached via singleton
+    "defaultGenesplicing",
+]);
+export function findOrphans(input) {
+    const out = [];
+    for (const ex of input.coreExports) {
+        if (isInternal(ex.symbol))
+            continue;
+        if (ALWAYS_INTERNAL_EXPORTS.has(ex.symbol))
+            continue;
+        if (ex.kind === "class")
+            continue; // classes use singleton / new pattern, not 1:1 MCP wrappers
+        const aliases = familyAliases(ex.module);
+        // Look for any MCP tool whose family is in aliases AND action matches symbol
+        const candidates = input.mcpTools.filter((t) => aliases.includes(t.family));
+        if (candidates.length === 0) {
+            // Whole family is orphan
+            out.push({
+                module: ex.module,
+                symbol: ex.symbol,
+                kind: ex.kind,
+                expectedMcpFamily: aliases[0],
+                suggestedMcpName: `mneme.${aliases[0]}.${ex.symbol.replace(/([a-z])([A-Z])/g, "$1_$2").toLowerCase()}`,
+                reason: `no MCP tool registered for family '${aliases[0]}' (module '${ex.module}' is unwrapped)`,
+            });
+            continue;
+        }
+        const exact = candidates.find((t) => actionMatch(ex.symbol, t.action));
+        if (!exact) {
+            out.push({
+                module: ex.module,
+                symbol: ex.symbol,
+                kind: ex.kind,
+                expectedMcpFamily: aliases[0],
+                suggestedMcpName: `mneme.${aliases[0]}.${ex.symbol.replace(/([a-z])([A-Z])/g, "$1_$2").toLowerCase()}`,
+                reason: `family '${aliases[0]}' has ${candidates.length} tool(s) but none matches symbol '${ex.symbol}'`,
+                closeMatch: candidates[0]?.name,
+            });
+        }
+    }
+    return out;
+}
+export function scanForOrphans(input) {
+    const coreExports = scanCoreExports(input.coreSrcDir);
+    const mcpTools = scanMcpToolNames(input.mcpToolsDir);
+    const orphans = findOrphans({ coreExports, mcpTools });
+    const moduleNames = new Set(coreExports.map((c) => c.module));
+    const dirtySet = new Set(orphans.map((o) => o.module));
+    const cleanModules = Array.from(moduleNames).filter((m) => !dirtySet.has(m)).sort();
+    const dirtyModules = Array.from(dirtySet).sort();
+    const scannedAt = new Date().toISOString();
+    const reportId = "gen-" + createHmac("sha256", "mneme-genesis-id")
+        .update(`${scannedAt}|${coreExports.length}|${mcpTools.length}|${orphans.length}`)
+        .digest("hex").slice(0, 14);
+    const body = {
+        v: PROTOCOL_VERSION,
+        reportId,
+        scannedAt,
+        coreSrcDir: input.coreSrcDir,
+        mcpToolsDir: input.mcpToolsDir,
+        totalCoreExports: coreExports.length,
+        totalMcpTools: mcpTools.length,
+        orphans,
+        cleanModules,
+        dirtyModules,
+        ok: orphans.length === 0,
+    };
+    const sig = hmac(body, input.secret ?? defaultSecret());
+    return { ...body, sig };
+}
+export function verifyReport(r, secret) {
+    const { sig, ...body } = r;
+    return safeEqHex(hmac(body, secret ?? defaultSecret()), sig);
+}
+/** Pretty-print an orphan finding for human review / PR body. */
+export function formatOrphan(o) {
+    const close = o.closeMatch ? ` (close: ${o.closeMatch})` : "";
+    return `  • [${o.kind}] ${o.module}.${o.symbol} → suggest \`${o.suggestedMcpName}\` · ${o.reason}${close}`;
+}
+export function formatReport(r) {
+    const lines = [];
+    lines.push(`🧬 AUTO-GENESIS WRAPPER FACTORY · scan @ ${r.scannedAt}`);
+    lines.push(`   core exports scanned: ${r.totalCoreExports}`);
+    lines.push(`   MCP tools registered: ${r.totalMcpTools}`);
+    lines.push(`   clean modules: ${r.cleanModules.length}`);
+    lines.push(`   dirty modules: ${r.dirtyModules.length}`);
+    lines.push(`   orphans: ${r.orphans.length}`);
+    if (r.orphans.length > 0) {
+        lines.push(``);
+        lines.push(`Orphans (core exports lacking an MCP wrapper):`);
+        for (const o of r.orphans)
+            lines.push(formatOrphan(o));
+    }
+    else {
+        lines.push(``);
+        lines.push(`🎉 NO ORPHANS — every meaningful core export has an MCP wrapper.`);
+    }
+    return lines.join("\n");
+}
+//# sourceMappingURL=index.js.map

package/dist/wrapper_genesis/index.js.map

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

package/dist/wrapper_genesis/wrapper_genesis.test.d.ts

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

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

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

package/dist/wrapper_genesis/wrapper_genesis.test.js

@@ -0,0 +1,152 @@
+import { describe, it, expect } from "vitest";
+import { scanCoreExports, scanMcpToolNames, findOrphans, scanForOrphans, verifyReport, formatReport, formatOrphan, } from "./index.js";
+import { mkdtempSync, mkdirSync, writeFileSync } from "node:fs";
+import { join } from "node:path";
+import { tmpdir } from "node:os";
+function makeCoreFixture() {
+    const dir = mkdtempSync(join(tmpdir(), "mneme-genesis-core-"));
+    // Module A — has both functions
+    mkdirSync(join(dir, "module_a"), { recursive: true });
+    writeFileSync(join(dir, "module_a", "index.ts"), `export function doThing(input: { x: string }): { ok: boolean } { return { ok: true }; }
+export async function asyncDoThing(input: { y: number }): Promise<void> {}
+export class ThingClass { go(): void {} }
+function _internal(): void {}
+export const formatLine = (x: string): string => x;
+export const PROTOCOL_VERSION = 1;
+`, "utf8");
+    // Module B — exports nothing (no orphans either)
+    mkdirSync(join(dir, "module_b"), { recursive: true });
+    writeFileSync(join(dir, "module_b", "index.ts"), `// empty module\n`, "utf8");
+    // Module C — single function, no wrapper
+    mkdirSync(join(dir, "module_c"), { recursive: true });
+    writeFileSync(join(dir, "module_c", "index.ts"), `export function newFeature(): boolean { return true; }\n`, "utf8");
+    return dir;
+}
+function makeMcpFixture() {
+    const dir = mkdtempSync(join(tmpdir(), "mneme-genesis-mcp-"));
+    writeFileSync(join(dir, "_v1.ts"), `export const tool1 = { name: "mneme.module_a.do_thing", category: "lab", handler: async () => ({}) };
+export const tool2 = { name: "mneme.module_a.async_do_thing", category: "lab", handler: async () => ({}) };
+// module_c has NO wrapper here
+`, "utf8");
+    return dir;
+}
+describe("v2.19.8 · AUTO-GENESIS WRAPPER FACTORY", () => {
+    it("scanCoreExports finds function + async function + class + const exports", () => {
+        const dir = makeCoreFixture();
+        const exports = scanCoreExports(dir);
+        const symbols = exports.map((e) => `${e.module}.${e.symbol}`);
+        expect(symbols).toContain("module_a.doThing");
+        expect(symbols).toContain("module_a.asyncDoThing");
+        expect(symbols).toContain("module_a.ThingClass");
+        // _internal is private convention; format* is a display helper; PROTOCOL_VERSION is UPPER_SNAKE
+        // — these should NOT necessarily be excluded by SCAN (filter happens at findOrphans)
+        expect(exports.find((e) => e.symbol === "_internal")).toBeUndefined();
+    });
+    it("scanMcpToolNames extracts mneme.X.Y patterns from MCP tool files", () => {
+        const dir = makeMcpFixture();
+        const tools = scanMcpToolNames(dir);
+        const names = tools.map((t) => t.name).sort();
+        expect(names).toEqual(["mneme.module_a.async_do_thing", "mneme.module_a.do_thing"]);
+        expect(tools[0].family).toBe("module_a");
+    });
+    it("findOrphans flags FUNCTION symbols with no matching MCP wrapper (classes excluded by design)", () => {
+        const coreDir = makeCoreFixture();
+        const mcpDir = makeMcpFixture();
+        const coreExports = scanCoreExports(coreDir);
+        const mcpTools = scanMcpToolNames(mcpDir);
+        const orphans = findOrphans({ coreExports, mcpTools });
+        // module_c.newFeature must be flagged (whole family missing)
+        expect(orphans.find((o) => o.module === "module_c" && o.symbol === "newFeature")).toBeDefined();
+        // Classes are reached via singleton/new pattern, not 1:1 MCP wrappers — should NOT be flagged.
+        expect(orphans.find((o) => o.symbol === "ThingClass")).toBeUndefined();
+    });
+    it("findOrphans skips internal-prefix symbols (formatXLine, verifyX, etc.)", () => {
+        const dir = mkdtempSync(join(tmpdir(), "mneme-genesis-internal-"));
+        mkdirSync(join(dir, "x"), { recursive: true });
+        writeFileSync(join(dir, "x", "index.ts"), `export function formatXLine(): string { return ""; }
+export function verifyX(): boolean { return true; }
+export function realFeature(): void {}
+`, "utf8");
+        const coreExports = scanCoreExports(dir);
+        const orphans = findOrphans({ coreExports, mcpTools: [] });
+        // formatXLine + verifyX are internal — filtered out
+        expect(orphans.find((o) => o.symbol === "formatXLine")).toBeUndefined();
+        expect(orphans.find((o) => o.symbol === "verifyX")).toBeUndefined();
+        // realFeature must be flagged
+        expect(orphans.find((o) => o.symbol === "realFeature")).toBeDefined();
+    });
+    it("scanForOrphans produces a signed report", () => {
+        const coreDir = makeCoreFixture();
+        const mcpDir = makeMcpFixture();
+        const r = scanForOrphans({ coreSrcDir: coreDir, mcpToolsDir: mcpDir });
+        expect(r.sig).toMatch(/^[0-9a-f]{64}$/);
+        expect(r.reportId).toMatch(/^gen-[0-9a-f]{14}$/);
+        expect(r.totalCoreExports).toBeGreaterThan(0);
+        expect(r.totalMcpTools).toBe(2);
+        expect(r.orphans.length).toBeGreaterThan(0);
+        expect(r.ok).toBe(false);
+        expect(verifyReport(r)).toBe(true);
+    });
+    it("verifyReport detects tampering", () => {
+        const r = scanForOrphans({ coreSrcDir: makeCoreFixture(), mcpToolsDir: makeMcpFixture() });
+        const tampered = { ...r, ok: true, orphans: [] };
+        expect(verifyReport(tampered)).toBe(false);
+    });
+    it("ok=true when no orphans found", () => {
+        const coreDir = mkdtempSync(join(tmpdir(), "mneme-genesis-clean-"));
+        mkdirSync(join(coreDir, "x"), { recursive: true });
+        writeFileSync(join(coreDir, "x", "index.ts"), `export function feature(): void {}\n`, "utf8");
+        const mcpDir = mkdtempSync(join(tmpdir(), "mneme-genesis-clean-mcp-"));
+        writeFileSync(join(mcpDir, "_v.ts"), `export const t = { name: "mneme.x.feature", handler: async () => ({}) };\n`, "utf8");
+        const r = scanForOrphans({ coreSrcDir: coreDir, mcpToolsDir: mcpDir });
+        expect(r.ok).toBe(true);
+        expect(r.orphans.length).toBe(0);
+    });
+    it("family aliases map dir names to MCP families (vendor_ghost → ghost, etc.)", () => {
+        const coreDir = mkdtempSync(join(tmpdir(), "mneme-genesis-alias-"));
+        mkdirSync(join(coreDir, "vendor_ghost"), { recursive: true });
+        writeFileSync(join(coreDir, "vendor_ghost", "index.ts"), `export function distillProfile(): void {}\nexport function askGhost(): void {}\n`, "utf8");
+        const mcpDir = mkdtempSync(join(tmpdir(), "mneme-genesis-alias-mcp-"));
+        writeFileSync(join(mcpDir, "_v.ts"), `export const t1 = { name: "mneme.ghost.distill", handler: async () => ({}) };
+export const t2 = { name: "mneme.ghost.ask", handler: async () => ({}) };
+`, "utf8");
+        const r = scanForOrphans({ coreSrcDir: coreDir, mcpToolsDir: mcpDir });
+        // distillProfile ≈ ghost.distill; askGhost ≈ ghost.ask — both should match
+        expect(r.orphans.length).toBe(0);
+    });
+    it("real-world scan: scanner detects orphans (proves it works on the actual repo)", () => {
+        const r = scanForOrphans({
+            coreSrcDir: join(process.cwd(), "packages/core/src"),
+            mcpToolsDir: join(process.cwd(), "packages/mcp/src/tools"),
+        });
+        // Scanner must SCAN something real (proves it's not a no-op).
+        expect(r.totalCoreExports).toBeGreaterThan(50);
+        expect(r.totalMcpTools).toBeGreaterThan(50);
+        // It's expected to find legacy orphans (pre-v2.18 modules without wrappers).
+        // Strict enforcement is on NEW modules only — covered by the next test.
+    });
+    it("STRICT enforcement: every ENFORCE_FULL_COVERAGE (v2.18+) module has zero orphans", async () => {
+        const { ENFORCE_FULL_COVERAGE } = await import("./index.js");
+        const r = scanForOrphans({
+            coreSrcDir: join(process.cwd(), "packages/core/src"),
+            mcpToolsDir: join(process.cwd(), "packages/mcp/src/tools"),
+        });
+        const enforcedOrphans = r.orphans.filter((o) => ENFORCE_FULL_COVERAGE.has(o.module));
+        if (enforcedOrphans.length > 0) {
+            console.error("V2.18+ MODULES WITH MISSING MCP WRAPPERS:");
+            for (const o of enforcedOrphans)
+                console.error(formatOrphan(o));
+        }
+        // Hard gate: v2.18+ modules MUST have full coverage.
+        expect(enforcedOrphans.length).toBe(0);
+    });
+    it("formatReport summarises ok + dirty modules + orphans", () => {
+        const r = scanForOrphans({ coreSrcDir: makeCoreFixture(), mcpToolsDir: makeMcpFixture() });
+        const text = formatReport(r);
+        expect(text).toContain("AUTO-GENESIS");
+        expect(text).toContain("core exports scanned:");
+        if (r.orphans.length > 0)
+            expect(text).toContain("Orphans");
+    });
+});
+//# sourceMappingURL=wrapper_genesis.test.js.map

package/dist/wrapper_genesis/wrapper_genesis.test.js.map

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