@mneme-ai/mcp 1.10.0 → 1.17.2

package/dist/dynamic-mcp.integration.test.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Dynamic MCP integration test — full pipeline from a fixture repo to
+ * compiled tool catalog.
+ *
+ * This test wires together:
+ *   • detectEcosystems (against fixture repo)
+ *   • loadAllPacks (real Stripe pack from disk)
+ *   • buildActiveToolCatalog (tools the MCP server would expose)
+ *   • executeQuery (the actual tool execution)
+ *   • augmentDescription (tribal knowledge composition)
+ *
+ * If any layer breaks, this test fails LOUDLY.
+ */
+export {};
+//# sourceMappingURL=dynamic-mcp.integration.test.d.ts.map

package/dist/dynamic-mcp.integration.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dynamic-mcp.integration.test.d.ts","sourceRoot":"","sources":["../src/dynamic-mcp.integration.test.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG"}

package/dist/dynamic-mcp.integration.test.js

@@ -0,0 +1,178 @@
+/**
+ * Dynamic MCP integration test — full pipeline from a fixture repo to
+ * compiled tool catalog.
+ *
+ * This test wires together:
+ *   • detectEcosystems (against fixture repo)
+ *   • loadAllPacks (real Stripe pack from disk)
+ *   • buildActiveToolCatalog (tools the MCP server would expose)
+ *   • executeQuery (the actual tool execution)
+ *   • augmentDescription (tribal knowledge composition)
+ *
+ * If any layer breaks, this test fails LOUDLY.
+ */
+import { describe, it, expect, beforeEach, afterEach } from "vitest";
+import { mkdtempSync, mkdirSync, writeFileSync, rmSync } from "node:fs";
+import { tmpdir } from "node:os";
+import { join } from "node:path";
+import { execSync } from "node:child_process";
+import { dynamic } from "@mneme-ai/core";
+const { detectEcosystems, loadAllPacks, getDefaultPackSearchPaths, getBundledPacksDir, buildActiveToolCatalog, lookupTool, executeQuery, augmentDescription, } = dynamic;
+let tmp;
+beforeEach(() => {
+    tmp = mkdtempSync(join(tmpdir(), "mneme-dyn-int-"));
+    execSync("git init -q", { cwd: tmp });
+    execSync("git config user.email a@x", { cwd: tmp });
+    execSync("git config user.name TestUser", { cwd: tmp });
+});
+afterEach(() => {
+    try {
+        rmSync(tmp, { recursive: true, force: true });
+    }
+    catch { }
+});
+describe("Dynamic MCP — Stripe pack end-to-end", () => {
+    it("MCP would expose 3 Stripe tools when repo uses Stripe", () => {
+        // 1. Set up a fixture Stripe-using repo
+        writeFileSync(join(tmp, "package.json"), JSON.stringify({
+            dependencies: { stripe: "^14.0.0" },
+        }));
+        mkdirSync(join(tmp, "src"));
+        writeFileSync(join(tmp, "src/billing.ts"), `
+      import Stripe from 'stripe';
+      const stripe = new Stripe('sk_test_xxx');
+      export async function listPrices() {
+        return stripe.prices.list({ limit: 100 });
+      }
+      export async function createSubscription(customerId: string) {
+        return stripe.subscriptions.create({ customer: customerId, items: [] });
+      }
+    `);
+        execSync("git add . && git commit -q -m initial", { cwd: tmp });
+        // 2. Run the full pipeline
+        const detection = detectEcosystems(tmp);
+        expect(detection.signals.some((s) => s.id === "stripe")).toBe(true);
+        const paths = getDefaultPackSearchPaths(tmp, getBundledPacksDir());
+        const loaded = loadAllPacks(paths);
+        expect(loaded.failures).toEqual([]);
+        expect(loaded.packs.some((p) => p.id === "stripe")).toBe(true);
+        const catalog = buildActiveToolCatalog({ detection, packs: loaded.packs });
+        const stripeTools = catalog.filter((t) => t.packId === "stripe");
+        expect(stripeTools.length).toBe(3);
+        expect(stripeTools.map((t) => t.name).sort()).toEqual([
+            "mneme.stripe.audit_pii_handlers",
+            "mneme.stripe.find_pricing_logic",
+            "mneme.stripe.list_webhook_handlers",
+        ]);
+    });
+    it("calling find_pricing_logic returns real query results from fixture repo", () => {
+        writeFileSync(join(tmp, "package.json"), JSON.stringify({
+            dependencies: { stripe: "^14.0.0" },
+        }));
+        mkdirSync(join(tmp, "src"));
+        writeFileSync(join(tmp, "src/billing.ts"), `
+      import Stripe from 'stripe';
+      const stripe = new Stripe('sk');
+      export async function listPrices() {
+        return stripe.prices.list();
+      }
+    `);
+        execSync("git add . && git commit -q -m initial", { cwd: tmp });
+        const paths = getDefaultPackSearchPaths(tmp, getBundledPacksDir());
+        const loaded = loadAllPacks(paths);
+        const found = lookupTool("mneme.stripe.find_pricing_logic", loaded.packs);
+        expect(found).not.toBeNull();
+        if (!found)
+            return;
+        const result = executeQuery(found.tool.query, tmp);
+        expect(result.ok).toBe(true);
+        if (!result.ok)
+            return;
+        if (result.result.kind !== "code-search")
+            throw new Error("expected code-search");
+        // Should have at least one hit on stripe.prices.list
+        expect(result.result.hits.length).toBeGreaterThan(0);
+        expect(result.result.hits.some((h) => h.path === "src/billing.ts")).toBe(true);
+    });
+    it("repo without Stripe → catalog empty (no false-positive tools)", () => {
+        writeFileSync(join(tmp, "package.json"), JSON.stringify({ dependencies: { react: "^18.0.0" } }));
+        mkdirSync(join(tmp, "src"));
+        writeFileSync(join(tmp, "src/app.tsx"), `import React from 'react';\nexport default () => <div/>;`);
+        execSync("git add . && git commit -q -m initial", { cwd: tmp });
+        const detection = detectEcosystems(tmp);
+        expect(detection.signals.some((s) => s.id === "stripe")).toBe(false);
+        const paths = getDefaultPackSearchPaths(tmp, getBundledPacksDir());
+        const loaded = loadAllPacks(paths);
+        const catalog = buildActiveToolCatalog({ detection, packs: loaded.packs });
+        const stripeTools = catalog.filter((t) => t.packId === "stripe");
+        expect(stripeTools).toEqual([]);
+    });
+    it("description augmentation composes correctly with tribal-knowledge data", () => {
+        const paths = getDefaultPackSearchPaths(tmp, getBundledPacksDir());
+        const loaded = loadAllPacks(paths);
+        const found = lookupTool("mneme.stripe.find_pricing_logic", loaded.packs);
+        if (!found)
+            throw new Error("stripe pack must load");
+        const baseDesc = found.tool.description;
+        const augmented = augmentDescription(baseDesc, found.tool.augmentation, {
+            hits: [
+                { path: "services/billing/v2/prices.ts", line: 10, snippet: "stripe.prices.list()", matchedPattern: "stripe.prices" },
+                { path: "services/billing/v2/prices.ts", line: 20, snippet: "stripe.prices.create()", matchedPattern: "stripe.prices" },
+                { path: "lib/stripe/old.ts", line: 5, snippet: "stripe.prices.update()", matchedPattern: "stripe.prices" },
+            ],
+            expertise: [
+                { path: "services/billing/v2/prices.ts", expert: "alice", atrophyScore: 25, daysSinceLastTouch: 7 },
+            ],
+            deprecations: [{
+                    path: "lib/stripe/old.ts",
+                    canonical: "services/billing/v2/",
+                    deprecatedInCommit: "abc12345",
+                    reason: "moved after PII audit found logging leaks",
+                }],
+            incidents: [{
+                    affectedPaths: ["lib/stripe/old.ts"],
+                    title: "PII leak in pricing logs",
+                    reportedAt: "2024-09-15T00:00:00Z",
+                }],
+            applicableRules: [{
+                    id: "regret-1",
+                    severity: "must-not",
+                    rule: "Don't log raw Stripe customer email in price-handling code",
+                    source: "regret",
+                }],
+        });
+        expect(augmented.facts.canonicalPath).toBe("services/billing/v2/prices.ts");
+        expect(augmented.facts.deprecatedPaths.length).toBe(1);
+        expect(augmented.facts.expertAuthors.length).toBe(1);
+        expect(augmented.facts.incidentSummaries.length).toBe(1);
+        expect(augmented.facts.ruleSummaries.length).toBe(1);
+        // Description embeds all 5 sections
+        expect(augmented.full).toMatch(/Canonical/);
+        expect(augmented.full).toMatch(/Deprecated/);
+        expect(augmented.full).toMatch(/alice owns/);
+        expect(augmented.full).toMatch(/Past incident/);
+        expect(augmented.full).toMatch(/MUST NOT/);
+    });
+});
+describe("Dynamic MCP — robustness", () => {
+    it("packs failing to load do NOT crash anything (degraded gracefully)", () => {
+        // The bundled pack always loads. The fixture is just to verify no crash.
+        const paths = getDefaultPackSearchPaths(tmp, getBundledPacksDir());
+        const loaded = loadAllPacks(paths);
+        expect(Array.isArray(loaded.packs)).toBe(true);
+        expect(Array.isArray(loaded.failures)).toBe(true);
+    });
+    it("MNEME_NO_DYNAMIC_MCP=1 path: caller can opt out (state empty)", () => {
+        // We test the env-var contract here — the actual MCP server respects it
+        process.env["MNEME_NO_DYNAMIC_MCP"] = "1";
+        try {
+            // The server.ts loadDynamicState short-circuits on this env var.
+            // Here we just confirm the guard is testable shape-wise.
+            expect(process.env["MNEME_NO_DYNAMIC_MCP"]).toBe("1");
+        }
+        finally {
+            delete process.env["MNEME_NO_DYNAMIC_MCP"];
+        }
+    });
+});
+//# sourceMappingURL=dynamic-mcp.integration.test.js.map

package/dist/dynamic-mcp.integration.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dynamic-mcp.integration.test.js","sourceRoot":"","sources":["../src/dynamic-mcp.integration.test.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,QAAQ,CAAC;AACrE,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AACxE,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AACjC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAC9C,OAAO,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AACzC,MAAM,EACJ,gBAAgB,EAChB,YAAY,EACZ,yBAAyB,EACzB,kBAAkB,EAClB,sBAAsB,EACtB,UAAU,EACV,YAAY,EACZ,kBAAkB,GACnB,GAAG,OAAO,CAAC;AAEZ,IAAI,GAAW,CAAC;AAEhB,UAAU,CAAC,GAAG,EAAE;IACd,GAAG,GAAG,WAAW,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,gBAAgB,CAAC,CAAC,CAAC;IACpD,QAAQ,CAAC,aAAa,EAAE,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC,CAAC;IACtC,QAAQ,CAAC,2BAA2B,EAAE,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC,CAAC;IACpD,QAAQ,CAAC,+BAA+B,EAAE,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC,CAAC;AAC1D,CAAC,CAAC,CAAC;AAEH,SAAS,CAAC,GAAG,EAAE;IACb,IAAI,CAAC;QAAC,MAAM,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;IAAC,CAAC;IAAC,MAAM,CAAC,CAAA,CAAC;AACjE,CAAC,CAAC,CAAC;AAEH,QAAQ,CAAC,sCAAsC,EAAE,GAAG,EAAE;IACpD,EAAE,CAAC,uDAAuD,EAAE,GAAG,EAAE;QAC/D,wCAAwC;QACxC,aAAa,CAAC,IAAI,CAAC,GAAG,EAAE,cAAc,CAAC,EAAE,IAAI,CAAC,SAAS,CAAC;YACtD,YAAY,EAAE,EAAE,MAAM,EAAE,SAAS,EAAE;SACpC,CAAC,CAAC,CAAC;QACJ,SAAS,CAAC,IAAI,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC,CAAC;QAC5B,aAAa,CAAC,IAAI,CAAC,GAAG,EAAE,gBAAgB,CAAC,EAAE;;;;;;;;;KAS1C,CAAC,CAAC;QACH,QAAQ,CAAC,uCAAuC,EAAE,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC,CAAC;QAEhE,2BAA2B;QAC3B,MAAM,SAAS,GAAG,gBAAgB,CAAC,GAAG,CAAC,CAAC;QACxC,MAAM,CAAC,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAEpE,MAAM,KAAK,GAAG,yBAAyB,CAAC,GAAG,EAAE,kBAAkB,EAAE,CAAC,CAAC;QACnE,MAAM,MAAM,GAAG,YAAY,CAAC,KAAK,CAAC,CAAC;QACnC,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;QACpC,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAE/D,MAAM,OAAO,GAAG,sBAAsB,CAAC,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC;QAC3E,MAAM,WAAW,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,QAAQ,CAAC,CAAC;QACjE,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACnC,MAAM,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC;YACpD,iCAAiC;YACjC,iCAAiC;YACjC,oCAAoC;SACrC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,yEAAyE,EAAE,GAAG,EAAE;QACjF,aAAa,CAAC,IAAI,CAAC,GAAG,EAAE,cAAc,CAAC,EAAE,IAAI,CAAC,SAAS,CAAC;YACtD,YAAY,EAAE,EAAE,MAAM,EAAE,SAAS,EAAE;SACpC,CAAC,CAAC,CAAC;QACJ,SAAS,CAAC,IAAI,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC,CAAC;QAC5B,aAAa,CAAC,IAAI,CAAC,GAAG,EAAE,gBAAgB,CAAC,EAAE;;;;;;KAM1C,CAAC,CAAC;QACH,QAAQ,CAAC,uCAAuC,EAAE,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC,CAAC;QAEhE,MAAM,KAAK,GAAG,yBAAyB,CAAC,GAAG,EAAE,kBAAkB,EAAE,CAAC,CAAC;QACnE,MAAM,MAAM,GAAG,YAAY,CAAC,KAAK,CAAC,CAAC;QACnC,MAAM,KAAK,GAAG,UAAU,CAAC,iCAAiC,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC;QAC1E,MAAM,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,QAAQ,EAAE,CAAC;QAC7B,IAAI,CAAC,KAAK;YAAE,OAAO;QAEnB,MAAM,MAAM,GAAG,YAAY,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;QACnD,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC7B,IAAI,CAAC,MAAM,CAAC,EAAE;YAAE,OAAO;QACvB,IAAI,MAAM,CAAC,MAAM,CAAC,IAAI,KAAK,aAAa;YAAE,MAAM,IAAI,KAAK,CAAC,sBAAsB,CAAC,CAAC;QAElF,qDAAqD;QACrD,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC;QACrD,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,gBAAgB,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACjF,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,+DAA+D,EAAE,GAAG,EAAE;QACvE,aAAa,CAAC,IAAI,CAAC,GAAG,EAAE,cAAc,CAAC,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,YAAY,EAAE,EAAE,KAAK,EAAE,SAAS,EAAE,EAAE,CAAC,CAAC,CAAC;QACjG,SAAS,CAAC,IAAI,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC,CAAC;QAC5B,aAAa,CAAC,IAAI,CAAC,GAAG,EAAE,aAAa,CAAC,EAAE,0DAA0D,CAAC,CAAC;QACpG,QAAQ,CAAC,uCAAuC,EAAE,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC,CAAC;QAEhE,MAAM,SAAS,GAAG,gBAAgB,CAAC,GAAG,CAAC,CAAC;QACxC,MAAM,CAAC,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAErE,MAAM,KAAK,GAAG,yBAAyB,CAAC,GAAG,EAAE,kBAAkB,EAAE,CAAC,CAAC;QACnE,MAAM,MAAM,GAAG,YAAY,CAAC,KAAK,CAAC,CAAC;QACnC,MAAM,OAAO,GAAG,sBAAsB,CAAC,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC;QAC3E,MAAM,WAAW,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,QAAQ,CAAC,CAAC;QACjE,MAAM,CAAC,WAAW,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;IAClC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,wEAAwE,EAAE,GAAG,EAAE;QAChF,MAAM,KAAK,GAAG,yBAAyB,CAAC,GAAG,EAAE,kBAAkB,EAAE,CAAC,CAAC;QACnE,MAAM,MAAM,GAAG,YAAY,CAAC,KAAK,CAAC,CAAC;QACnC,MAAM,KAAK,GAAG,UAAU,CAAC,iCAAiC,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC;QAC1E,IAAI,CAAC,KAAK;YAAE,MAAM,IAAI,KAAK,CAAC,uBAAuB,CAAC,CAAC;QAErD,MAAM,QAAQ,GAAG,KAAK,CAAC,IAAI,CAAC,WAAW,CAAC;QACxC,MAAM,SAAS,GAAG,kBAAkB,CAAC,QAAQ,EAAE,KAAK,CAAC,IAAI,CAAC,YAAY,EAAE;YACtE,IAAI,EAAE;gBACJ,EAAE,IAAI,EAAE,+BAA+B,EAAE,IAAI,EAAE,EAAE,EAAE,OAAO,EAAE,sBAAsB,EAAE,cAAc,EAAE,eAAe,EAAE;gBACrH,EAAE,IAAI,EAAE,+BAA+B,EAAE,IAAI,EAAE,EAAE,EAAE,OAAO,EAAE,wBAAwB,EAAE,cAAc,EAAE,eAAe,EAAE;gBACvH,EAAE,IAAI,EAAE,mBAAmB,EAAE,IAAI,EAAE,CAAC,EAAE,OAAO,EAAE,wBAAwB,EAAE,cAAc,EAAE,eAAe,EAAE;aAC3G;YACD,SAAS,EAAE;gBACT,EAAE,IAAI,EAAE,+BAA+B,EAAE,MAAM,EAAE,OAAO,EAAE,YAAY,EAAE,EAAE,EAAE,kBAAkB,EAAE,CAAC,EAAE;aACpG;YACD,YAAY,EAAE,CAAC;oBACb,IAAI,EAAE,mBAAmB;oBACzB,SAAS,EAAE,sBAAsB;oBACjC,kBAAkB,EAAE,UAAU;oBAC9B,MAAM,EAAE,2CAA2C;iBACpD,CAAC;YACF,SAAS,EAAE,CAAC;oBACV,aAAa,EAAE,CAAC,mBAAmB,CAAC;oBACpC,KAAK,EAAE,0BAA0B;oBACjC,UAAU,EAAE,sBAAsB;iBACnC,CAAC;YACF,eAAe,EAAE,CAAC;oBAChB,EAAE,EAAE,UAAU;oBACd,QAAQ,EAAE,UAAU;oBACpB,IAAI,EAAE,4DAA4D;oBAClE,MAAM,EAAE,QAAQ;iBACjB,CAAC;SACH,CAAC,CAAC;QAEH,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC,IAAI,CAAC,+BAA+B,CAAC,CAAC;QAC5E,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,eAAe,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACvD,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACrD,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,iBAAiB,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACzD,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACrD,oCAAoC;QACpC,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC;QAC5C,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC;QAC7C,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC;QAC7C,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,OAAO,CAAC,eAAe,CAAC,CAAC;QAChD,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;IAC7C,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,QAAQ,CAAC,0BAA0B,EAAE,GAAG,EAAE;IACxC,EAAE,CAAC,mEAAmE,EAAE,GAAG,EAAE;QAC3E,yEAAyE;QACzE,MAAM,KAAK,GAAG,yBAAyB,CAAC,GAAG,EAAE,kBAAkB,EAAE,CAAC,CAAC;QACnE,MAAM,MAAM,GAAG,YAAY,CAAC,KAAK,CAAC,CAAC;QACnC,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC/C,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACpD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,+DAA+D,EAAE,GAAG,EAAE;QACvE,wEAAwE;QACxE,OAAO,CAAC,GAAG,CAAC,sBAAsB,CAAC,GAAG,GAAG,CAAC;QAC1C,IAAI,CAAC;YACH,iEAAiE;YACjE,yDAAyD;YACzD,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,sBAAsB,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACxD,CAAC;gBAAS,CAAC;YACT,OAAO,OAAO,CAAC,GAAG,CAAC,sBAAsB,CAAC,CAAC;QAC7C,CAAC;IACH,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAoCA,MAAM,WAAW,UAAU;IACzB,GAAG,EAAE,MAAM,CAAC;CACb;AA2DD,wBAAsB,cAAc,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAuCpE"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAoCA,MAAM,WAAW,UAAU;IACzB,GAAG,EAAE,MAAM,CAAC;CACb;AA4KD,wBAAsB,cAAc,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAiDpE"}

package/dist/index.js

@@ -77,32 +77,138 @@ function enrichWithSecondBrain(response, tool, repoRoot) {
         },
     };
 }
+// ─── v1.13.0 — Dynamic MCP wiring ────────────────────────────────────
+//
+// At server start we:
+//   1. Detect ecosystems in the repo
+//   2. Load all packs (bundled + user + repo)
+//   3. Compile active tool catalog (only packs whose detection passes)
+//   4. Merge dynamic tools INTO the static catalog (no name collisions
+//      possible — dynamic tools are namespaced mneme.<pack>.<tool>)
+//
+// Tool-call dispatch checks dynamic tools AFTER static — so static wins
+// on the rare collision (defensive).
+import { dynamic } from "@mneme-ai/core";
+function loadDynamicState(repoRoot) {
+    if (process.env["MNEME_NO_DYNAMIC_MCP"] === "1") {
+        return { catalog: [], packs: [] };
+    }
+    try {
+        const detection = dynamic.detectEcosystems(repoRoot);
+        const paths = dynamic.getDefaultPackSearchPaths(repoRoot, dynamic.getBundledPacksDir());
+        const loaded = dynamic.loadAllPacks(paths);
+        // Pack failures are best-effort — don't block startup
+        const catalog = dynamic.buildActiveToolCatalog({
+            detection,
+            packs: loaded.packs,
+            // For Phase 1 we attach minimal augmentation (only base description).
+            // Phase 2 will pre-fetch tribal-knowledge facts and pass them here.
+            augmentDescription: (base, tool) => {
+                const a = dynamic.augmentDescription(base, tool.augmentation, dynamic.EMPTY_AUGMENTATION_INPUT);
+                return a.full;
+            },
+        });
+        return { catalog, packs: loaded.packs };
+    }
+    catch {
+        // Never fail MCP startup because of dynamic-tool issues
+        return { catalog: [], packs: [] };
+    }
+}
+async function dispatchDynamicTool(toolName, args, repoRoot, packs) {
+    const found = dynamic.lookupTool(toolName, packs);
+    if (!found)
+        return { ok: false };
+    // Execute query + format
+    const queryResult = dynamic.executeQuery(found.tool.query, repoRoot);
+    if (!queryResult.ok) {
+        return {
+            ok: true,
+            result: {
+                content: [{
+                        type: "text",
+                        text: JSON.stringify({
+                            data: null,
+                            error: {
+                                kind: queryResult.error.kind,
+                                stage: queryResult.error.stage,
+                                message: queryResult.error.message,
+                            },
+                            wisdom: `Dynamic tool ${toolName} could not execute: ${queryResult.error.message}`,
+                        }, null, 2),
+                    }],
+            },
+        };
+    }
+    // v1.15.0: Build REAL augmentation input from Mneme stores
+    // (atrophy, forensics, constitution, deprecations, git-blame).
+    const hits = queryResult.result.kind === "code-search" ? queryResult.result.hits : [];
+    let augInput;
+    try {
+        augInput = dynamic.buildAugmentationInput({ hits, repoRoot });
+    }
+    catch {
+        augInput = dynamic.EMPTY_AUGMENTATION_INPUT;
+    }
+    const aug = dynamic.augmentDescription(found.tool.description, found.tool.augmentation, augInput);
+    return {
+        ok: true,
+        result: {
+            content: [{
+                    type: "text",
+                    text: JSON.stringify({
+                        data: queryResult.result,
+                        wisdom: aug.full,
+                        followUp: [],
+                        confidence: { level: "medium" },
+                        provenance: {
+                            packId: found.pack.id,
+                            toolId: found.tool.id,
+                            packVersion: found.pack.version,
+                            schemaVersion: found.pack.schemaVersion,
+                            args,
+                        },
+                    }, null, 2),
+                }],
+        },
+    };
+}
 export async function startMcpServer(opts) {
     const runtime = await buildRuntime(opts.cwd);
     const allTools = buildAllTools();
     const toolMap = buildToolMap();
+    const dynamic = loadDynamicState(runtime.meta.rootPath);
     const server = new Server({ name: "mneme", version: resolveVersion() }, { capabilities: { tools: {} } });
     server.setRequestHandler(ListToolsRequestSchema, async () => ({
-        tools: toMcpTools(allTools),
+        tools: [
+            ...toMcpTools(allTools),
+            ...dynamic.catalog.map((t) => ({
+                name: t.name,
+                description: t.description,
+                inputSchema: t.inputSchema,
+            })),
+        ],
     }));
     server.setRequestHandler(CallToolRequestSchema, async (req) => {
         const tool = toolMap.get(req.params.name);
-        if (!tool) {
-            return toErrorResult(`unknown tool: ${req.params.name}. Call mneme.capabilities to list available tools.`);
-        }
-        try {
-            const args = (req.params.arguments ?? {});
-            const response = await tool.handler(runtime, args);
-            // Second Brain — auto-enrich every response with composition hints
-            // + lifecycle tracking + homework rubric. The chain reaction +
-            // teacher-student loop start here.
-            const enriched = enrichWithSecondBrain(response, tool, runtime.meta.rootPath);
-            return toCallResult(enriched);
-        }
-        catch (err) {
-            return toErrorResult(`${req.params.name} failed: ${err.message}. ` +
-                `If this tool requires the index, ask the user to run \`mneme index\`.`);
+        if (tool) {
+            try {
+                const args = (req.params.arguments ?? {});
+                const response = await tool.handler(runtime, args);
+                const enriched = enrichWithSecondBrain(response, tool, runtime.meta.rootPath);
+                return toCallResult(enriched);
+            }
+            catch (err) {
+                return toErrorResult(`${req.params.name} failed: ${err.message}. ` +
+                    `If this tool requires the index, ask the user to run \`mneme index\`.`);
+            }
         }
+        // Dynamic-tool dispatch (only if static didn't claim this name)
+        const args = (req.params.arguments ?? {});
+        const dyn = await dispatchDynamicTool(req.params.name, args, runtime.meta.rootPath, dynamic.packs);
+        if (dyn.ok)
+            return dyn.result;
+        return toErrorResult(`unknown tool: ${req.params.name}. Call mneme.capabilities to list available tools.`);
     });
     const transport = new StdioServerTransport();
     await server.connect(transport);

package/dist/index.js.map

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

package/dist/tools/_dna_tool.d.ts

@@ -0,0 +1,17 @@
+/**
+ * mneme.dna.search — MCP tool for AI clients.
+ *
+ * Exposes the full 16-strand DNA pipeline (8 algorithms × 8 formulas) as
+ * a single MCP tool that AI agents can call directly. Strict mode is the
+ * default — Ghost-Sniper Verifier rejects rather than degrades, so the
+ * AI never sees a hallucinated reference.
+ *
+ * The tool accepts the orchestrator's structured input shape verbatim.
+ * Powerful AI agents that have already done embedding + candidate
+ * collection (e.g. via mneme.memory.search_commits) can pipe results
+ * through this for the strict-verified, tribal-knowledge-augmented
+ * answer.
+ */
+import type { MnemeTool } from "./_types.js";
+export declare const dnaSearchTool: MnemeTool;
+//# sourceMappingURL=_dna_tool.d.ts.map

package/dist/tools/_dna_tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"_dna_tool.d.ts","sourceRoot":"","sources":["../../src/tools/_dna_tool.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAGH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAE7C,eAAO,MAAM,aAAa,EAAE,SA2H3B,CAAC"}

package/dist/tools/_dna_tool.js

@@ -0,0 +1,135 @@
+/**
+ * mneme.dna.search — MCP tool for AI clients.
+ *
+ * Exposes the full 16-strand DNA pipeline (8 algorithms × 8 formulas) as
+ * a single MCP tool that AI agents can call directly. Strict mode is the
+ * default — Ghost-Sniper Verifier rejects rather than degrades, so the
+ * AI never sees a hallucinated reference.
+ *
+ * The tool accepts the orchestrator's structured input shape verbatim.
+ * Powerful AI agents that have already done embedding + candidate
+ * collection (e.g. via mneme.memory.search_commits) can pipe results
+ * through this for the strict-verified, tribal-knowledge-augmented
+ * answer.
+ */
+import { dna } from "@mneme-ai/core";
+export const dnaSearchTool = {
+    name: "mneme.dna.search",
+    category: "meta",
+    description: "Run the full Mneme DNA pipeline (8 algorithms × 8 formulas) on a set of pre-fetched candidates. " +
+        "Returns ONLY results that pass three gates: (1) AST existence, (2) semantic similarity ≥ threshold, " +
+        "(3) Compositional Confidence (Wilson 95% lower bound × Hebbian) ≥ threshold. Strict mode default = " +
+        "rejects rather than degrades. **Use this when you need a hallucination-free answer to ground a code " +
+        "claim.** Returns: accepted[] (verified results), phantomSuggestions[] (where the canonical version " +
+        "should live), trace[] (full pipeline transparency), stats (per-gate rejection counts).",
+    triggers: [
+        "verify these candidates",
+        "filter out hallucinations",
+        "ghost sniper search",
+        "DNA pipeline",
+        "strict-mode code search",
+    ],
+    inputSchema: {
+        type: "object",
+        properties: {
+            queryText: { type: "string", description: "Original query text (for trace)" },
+            queryEmbedding: {
+                type: "array",
+                items: { type: "number" },
+                description: "Embedding of the query (precomputed by caller)",
+            },
+            candidates: {
+                type: "array",
+                description: "Pre-fetched candidate hits with embeddings + metadata",
+                items: {
+                    type: "object",
+                    properties: {
+                        id: { type: "string" },
+                        embedding: { type: "array", items: { type: "number" } },
+                        baseRelevance: { type: "number" },
+                        patternSignature: { type: "string" },
+                        existsInRepo: { type: "boolean" },
+                        successCount: { type: "number" },
+                        totalCount: { type: "number" },
+                        hebbianStrength: { type: "number" },
+                        meta: { type: "object", additionalProperties: true },
+                    },
+                    required: ["id", "embedding", "baseRelevance", "patternSignature", "existsInRepo", "successCount", "totalCount", "hebbianStrength"],
+                },
+            },
+            echoSignals: {
+                type: "array",
+                description: "Known regret/decision pattern embeddings (for echo signature)",
+                items: {
+                    type: "object",
+                    properties: {
+                        id: { type: "string" },
+                        embedding: { type: "array", items: { type: "number" } },
+                        label: { type: "string" },
+                    },
+                    required: ["id", "embedding"],
+                },
+            },
+            canonicalPatterns: {
+                type: "array",
+                description: "Successful patterns from this repo's history (for phantom-path)",
+                items: { type: "object", additionalProperties: true },
+            },
+            regretEmbeddings: {
+                type: "array",
+                description: "Embeddings of regret patterns (for anti-pattern repulsion)",
+                items: { type: "array", items: { type: "number" } },
+            },
+            federationVotes: {
+                type: "object",
+                description: "Per-signature federation up/down votes",
+                additionalProperties: true,
+            },
+            strict: { type: "boolean", description: "Default true. Strict = reject rather than degrade." },
+            semanticThreshold: { type: "number", description: "Min semantic sim. Default 0.6." },
+            confidenceThreshold: { type: "number", description: "Min Wilson×Hebbian. Default 0.6." },
+        },
+        required: ["queryText", "queryEmbedding", "candidates", "echoSignals", "canonicalPatterns", "regretEmbeddings"],
+    },
+    handler: async (_rt, args) => {
+        try {
+            const result = dna.dnaSearch({
+                queryText: String(args["queryText"] ?? ""),
+                queryEmbedding: args["queryEmbedding"] ?? [],
+                candidates: args["candidates"] ?? [],
+                echoSignals: args["echoSignals"] ?? [],
+                canonicalPatterns: args["canonicalPatterns"] ?? [],
+                regretEmbeddings: args["regretEmbeddings"] ?? [],
+                federationVotes: args["federationVotes"] ?? {},
+                strict: args["strict"] !== false,
+                semanticThreshold: typeof args["semanticThreshold"] === "number" ? args["semanticThreshold"] : undefined,
+                confidenceThreshold: typeof args["confidenceThreshold"] === "number" ? args["confidenceThreshold"] : undefined,
+            });
+            const summary = result.accepted.length === 0
+                ? `Strict mode: 0 results passed all 3 gates (${result.stats.rejectedAtAst} rejected at AST existence, ${result.stats.rejectedAtSemantic} at semantic, ${result.stats.rejectedAtConfidence} at confidence). Empty answer is honest — no hallucinations leaked.`
+                : `${result.accepted.length} result(s) verified. ${result.stats.rejectedAtAst + result.stats.rejectedAtSemantic + result.stats.rejectedAtConfidence} rejected at the Ghost-Sniper gates (no hallucinations leaked).`;
+            return {
+                data: result,
+                wisdom: summary,
+                followUp: result.accepted.length === 0
+                    ? ["mneme.memory.search_commits", "mneme.constitution.get"]
+                    : [],
+                confidence: { level: result.accepted.length > 0 ? "high" : "medium" },
+                secondBrain: {
+                    presentation: result.accepted.length > 0
+                        ? "Quote data.accepted[].reference verbatim to the user. Each result has been verified — file/symbol exists, semantic similarity passes threshold, Wilson 95% lower-bound confidence is met. Ground every claim in these references."
+                        : "DO NOT fabricate a result. The DNA pipeline rejected every candidate. Either tell the user 'I couldn't verify this' or call mneme.memory.search_commits with broader terms and re-run.",
+                },
+            };
+        }
+        catch (err) {
+            return {
+                data: null,
+                wisdom: `DNA pipeline failed: ${err.message}. Inspect input shape — ensure embeddings have consistent dimension and required fields are present.`,
+                followUp: [],
+                confidence: { level: "low" },
+            };
+        }
+    },
+};
+//# sourceMappingURL=_dna_tool.js.map

package/dist/tools/_dna_tool.js.map

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

package/dist/tools/_genome_tools.d.ts

@@ -0,0 +1,21 @@
+/**
+ * mneme.genome.* — MCP tools that expose the Genetic Engineering primitives
+ * (G1-G5) so AI agents discover them automatically via `tools/list`.
+ *
+ * Six tools:
+ *   • mneme.genome.annotate       — tag a tool list with functional domains
+ *   • mneme.genome.phylogeny      — build ancestry tree + cousins/distance queries
+ *   • mneme.genome.circuit        — run a genetic-circuit network (toggle/AND/OR/NOT/oscillator)
+ *   • mneme.genome.operon_resolve — resolve which operon governs a tool + its current behavior modifier
+ *   • mneme.genome.crispr_edit    — apply a CRISPR edit to a pack (validate-then-commit)
+ *   • mneme.genome.synthesize     — de novo synthesis: recipe → cryptographically-named ToolDefinition
+ */
+import type { MnemeTool } from "./_types.js";
+export declare const genomeAnnotateTool: MnemeTool;
+export declare const genomePhylogenyTool: MnemeTool;
+export declare const genomeCircuitTool: MnemeTool;
+export declare const genomeOperonResolveTool: MnemeTool;
+export declare const genomeCrisprTool: MnemeTool;
+export declare const genomeSynthesizeTool: MnemeTool;
+export declare const genomeTools: MnemeTool[];
+//# sourceMappingURL=_genome_tools.d.ts.map

package/dist/tools/_genome_tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"_genome_tools.d.ts","sourceRoot":"","sources":["../../src/tools/_genome_tools.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAGH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAI7C,eAAO,MAAM,kBAAkB,EAAE,SAuChC,CAAC;AAIF,eAAO,MAAM,mBAAmB,EAAE,SA4DjC,CAAC;AAIF,eAAO,MAAM,iBAAiB,EAAE,SAuC/B,CAAC;AAIF,eAAO,MAAM,uBAAuB,EAAE,SA8BrC,CAAC;AAIF,eAAO,MAAM,gBAAgB,EAAE,SA4B9B,CAAC;AAIF,eAAO,MAAM,oBAAoB,EAAE,SAqClC,CAAC;AAEF,eAAO,MAAM,WAAW,EAAE,SAAS,EAOlC,CAAC"}

package/dist/tools/_genome_tools.js

@@ -0,0 +1,247 @@
+/**
+ * mneme.genome.* — MCP tools that expose the Genetic Engineering primitives
+ * (G1-G5) so AI agents discover them automatically via `tools/list`.
+ *
+ * Six tools:
+ *   • mneme.genome.annotate       — tag a tool list with functional domains
+ *   • mneme.genome.phylogeny      — build ancestry tree + cousins/distance queries
+ *   • mneme.genome.circuit        — run a genetic-circuit network (toggle/AND/OR/NOT/oscillator)
+ *   • mneme.genome.operon_resolve — resolve which operon governs a tool + its current behavior modifier
+ *   • mneme.genome.crispr_edit    — apply a CRISPR edit to a pack (validate-then-commit)
+ *   • mneme.genome.synthesize     — de novo synthesis: recipe → cryptographically-named ToolDefinition
+ */
+import { genome } from "@mneme-ai/core";
+// ─── 1. annotate ─────────────────────────────────────────────────────
+export const genomeAnnotateTool = {
+    name: "mneme.genome.annotate",
+    category: "meta",
+    description: "Tag a list of MCP tools with their functional domain (search · mutate · verify · compose · regulate · augment · observe · synthesize) + sub-domains + mutability + genus/species. Pure deterministic. Used by the phylogeny tool to build ancestry trees.",
+    triggers: ["annotate tools", "classify mcp tools", "what domain is this tool"],
+    inputSchema: {
+        type: "object",
+        properties: {
+            tools: {
+                type: "array",
+                items: {
+                    type: "object",
+                    properties: {
+                        name: { type: "string" },
+                        description: { type: "string" },
+                        parent: { type: "string" },
+                    },
+                    required: ["name"],
+                },
+            },
+        },
+        required: ["tools"],
+    },
+    handler: async (_rt, args) => {
+        const tools = args["tools"] ?? [];
+        const result = genome.annotateCatalog(tools);
+        return {
+            data: result,
+            wisdom: `Annotated ${result.tools.length} tool(s). Domain breakdown: ${Object.entries(result.domainCounts)
+                .map(([d, n]) => `${d}=${n}`)
+                .join(", ")}.`,
+            followUp: ["mneme.genome.phylogeny"],
+            confidence: { level: "high" },
+        };
+    },
+};
+// ─── 2. phylogeny ────────────────────────────────────────────────────
+export const genomePhylogenyTool = {
+    name: "mneme.genome.phylogeny",
+    category: "meta",
+    description: "Build the phylogenetic (ancestry) tree of a tool catalog. Supports queries: ancestors of a tool, cousins (siblings within k generations), tree-distance between two tools, closest-relative search across a candidate pool. Use when AI agent needs to reason about WHICH tool to call by relatedness, not just name match.",
+    triggers: ["tool ancestors", "find similar tool", "closest relative", "speciation"],
+    inputSchema: {
+        type: "object",
+        properties: {
+            tools: { type: "array" },
+            query: {
+                type: "object",
+                properties: {
+                    kind: { type: "string", enum: ["ancestors", "cousins", "distance", "closest", "speciation", "ascii"] },
+                    tool: { type: "string" },
+                    other: { type: "string" },
+                    k: { type: "number" },
+                    candidates: { type: "array", items: { type: "string" } },
+                },
+                required: ["kind"],
+            },
+        },
+        required: ["tools", "query"],
+    },
+    handler: async (_rt, args) => {
+        const tools = args["tools"] ?? [];
+        const annotated = genome.annotateCatalog(tools).tools;
+        const tree = genome.buildPhylogeny(annotated);
+        const q = args["query"];
+        let result;
+        switch (q.kind) {
+            case "ancestors":
+                result = q.tool ? genome.findAncestors(tree, q.tool) : [];
+                break;
+            case "cousins":
+                result = q.tool ? genome.findCousins(tree, q.tool, q.k ?? 1) : [];
+                break;
+            case "distance":
+                result = q.tool && q.other ? genome.treeDistance(tree, q.tool, q.other) : Infinity;
+                break;
+            case "closest":
+                result = q.tool && q.candidates ? genome.findClosestRelative(tree, q.tool, q.candidates) : null;
+                break;
+            case "speciation":
+                result = genome.speciationEvents(tree);
+                break;
+            case "ascii":
+                result = genome.renderAsciiTree(tree);
+                break;
+            default:
+                result = null;
+        }
+        return {
+            data: { query: q, result, totalNodes: tree.byName.size },
+            wisdom: `Phylogeny query '${q.kind}' executed across ${tree.byName.size} nodes.`,
+            followUp: [],
+            confidence: { level: "high" },
+        };
+    },
+};
+// ─── 3. circuit ──────────────────────────────────────────────────────
+export const genomeCircuitTool = {
+    name: "mneme.genome.circuit",
+    category: "meta",
+    description: "Execute a genetic-circuit network: toggle / AND / OR / NOT / oscillator gates composed declaratively. Returns whether the circuit fired + reason. Toggle state is caller-managed (pure function).",
+    triggers: ["genetic circuit", "logic gate", "toggle", "and gate", "or gate"],
+    inputSchema: {
+        type: "object",
+        properties: {
+            network: {
+                type: "object",
+                properties: { steps: { type: "array" } },
+                required: ["steps"],
+            },
+            input: {
+                type: "object",
+                properties: {
+                    signals: { type: "object", additionalProperties: { type: "boolean" } },
+                    payload: {},
+                    toggleState: { type: "object", additionalProperties: { type: "boolean" } },
+                    oscillatorTick: { type: "number" },
+                },
+                required: ["signals"],
+            },
+        },
+        required: ["network", "input"],
+    },
+    handler: async (_rt, args) => {
+        const result = genome.runCircuit(args["network"], args["input"]);
+        return {
+            data: result,
+            wisdom: `Circuit ${result.fired ? "fired ✓" : "blocked ✗"} — ${result.reason}`,
+            followUp: [],
+            confidence: { level: "high" },
+        };
+    },
+};
+// ─── 4. operon_resolve ───────────────────────────────────────────────
+export const genomeOperonResolveTool = {
+    name: "mneme.genome.operon_resolve",
+    category: "meta",
+    description: "Resolve which co-regulated operon governs a tool + its current behavior modifier (requireConstitutionGate / requireStrictSniper / minConfidence / maxResults). Use to determine: should this tool's output be gated more strictly given the current PCI / compliance / governance level?",
+    triggers: ["operon", "regulator", "governance level"],
+    inputSchema: {
+        type: "object",
+        properties: {
+            toolName: { type: "string" },
+            registry: { type: "object" },
+            regulatorLevels: { type: "object", additionalProperties: { type: "string" } },
+        },
+        required: ["toolName", "registry", "regulatorLevels"],
+    },
+    handler: async (_rt, args) => {
+        const r = genome.resolveOperonForTool(args["toolName"], args["registry"], args["regulatorLevels"]);
+        return {
+            data: r,
+            wisdom: r.operon
+                ? `Tool '${args["toolName"]}' governed by operon '${r.operon.id}' at level=${r.level}. Modifier: requireGate=${r.modifier?.requireConstitutionGate}, requireSniper=${r.modifier?.requireStrictSniper}, minConf=${r.modifier?.minConfidence}.`
+                : `Tool '${args["toolName"]}' is unregulated.`,
+            followUp: [],
+            confidence: { level: "high" },
+        };
+    },
+};
+// ─── 5. crispr_edit ──────────────────────────────────────────────────
+export const genomeCrisprTool = {
+    name: "mneme.genome.crispr_edit",
+    category: "meta",
+    description: "Apply a CRISPR edit to a pack: delete tool by id/pattern, replace-tool, add-tool, patch-detection. Validates the post-edit pack against the schema; on validation failure, returns ok=false with structured errors and NO change is committed (fail-closed). Returns SHA-256 hashes of pack before + after.",
+    triggers: ["edit pack", "patch tool", "crispr", "tool surgery"],
+    inputSchema: {
+        type: "object",
+        properties: {
+            pack: { type: "object" },
+            edit: { type: "object" },
+        },
+        required: ["pack", "edit"],
+    },
+    handler: async (_rt, args) => {
+        const r = genome.crisprEdit(args["pack"], args["edit"]);
+        return {
+            data: r,
+            wisdom: r.ok
+                ? `CRISPR edit applied: ${r.summary}. Hash ${r.beforeHash.slice(0, 8)} → ${r.afterHash?.slice(0, 8)}.`
+                : `CRISPR edit refused (fail-closed): ${r.error?.reason}.`,
+            followUp: [],
+            confidence: { level: "high" },
+        };
+    },
+};
+// ─── 6. synthesize ───────────────────────────────────────────────────
+export const genomeSynthesizeTool = {
+    name: "mneme.genome.synthesize",
+    category: "meta",
+    description: "DE NOVO SYNTHESIS — compose a brand new MCP tool at runtime from genetic primitives. Recipe (search patterns + verifiers + augmenters + preconditions + authoredBy) → cryptographically-named ToolDefinition. Identical recipe → identical tool name + DNA hash (deterministic). Validated against pack schema before return. Failure modes are structured.",
+    triggers: ["synthesize tool", "create new tool", "de novo", "new gene"],
+    inputSchema: {
+        type: "object",
+        properties: {
+            intent: { type: "string", description: "Plain-English description of what the tool should do (≥10 chars)" },
+            searchPatterns: { type: "array", items: { type: "string" }, minItems: 1 },
+            fileExtensions: { type: "array", items: { type: "string" } },
+            verifiers: { type: "array", items: { type: "string", enum: ["ast", "semantic", "confidence"] }, minItems: 1 },
+            augmenters: { type: "array", items: { type: "string", enum: ["canonical-paths", "deprecated-paths", "expert-authors", "incidents", "rules"] } },
+            authoredBy: { type: "string" },
+        },
+        required: ["intent", "searchPatterns", "verifiers", "authoredBy"],
+    },
+    handler: async (_rt, args) => {
+        const recipe = {
+            intent: String(args["intent"] ?? ""),
+            searchPatterns: args["searchPatterns"] ?? [],
+            fileExtensions: args["fileExtensions"],
+            verifiers: args["verifiers"] ?? [],
+            augmenters: args["augmenters"] ?? [],
+            authoredBy: String(args["authoredBy"] ?? ""),
+        };
+        const r = genome.synthesize(recipe);
+        return {
+            data: r,
+            wisdom: r.ok
+                ? `Synthesized new tool '${r.tool.name}' (DNA hash ${r.tool.dnaHash.slice(0, 12)}…). Tool is verified against pack schema and ready to register.`
+                : `Synthesis refused: ${r.error?.reason}.`,
+            followUp: r.ok ? ["mneme.dna.search"] : [],
+            confidence: { level: "high" },
+        };
+    },
+};
+export const genomeTools = [
+    genomeAnnotateTool,
+    genomePhylogenyTool,
+    genomeCircuitTool,
+    genomeOperonResolveTool,
+    genomeCrisprTool,
+    genomeSynthesizeTool,
+];
+//# sourceMappingURL=_genome_tools.js.map

package/dist/tools/_genome_tools.js.map

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

package/dist/tools/_registry.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"_registry.d.ts","sourceRoot":"","sources":["../../src/tools/_registry.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAkB3D;sEACsE;AACtE,wBAAgB,aAAa,IAAI,SAAS,EAAE,CAkB3C;AAED,mDAAmD;AACnD,wBAAgB,YAAY,IAAI,GAAG,CAAC,MAAM,EAAE,SAAS,CAAC,CASrD;AAED,uEAAuE;AACvE,wBAAgB,eAAe,IAAI,GAAG,CAAC,YAAY,EAAE,SAAS,EAAE,CAAC,CAOhE"}
+{"version":3,"file":"_registry.d.ts","sourceRoot":"","sources":["../../src/tools/_registry.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAoB3D;sEACsE;AACtE,wBAAgB,aAAa,IAAI,SAAS,EAAE,CAoB3C;AAED,mDAAmD;AACnD,wBAAgB,YAAY,IAAI,GAAG,CAAC,MAAM,EAAE,SAAS,CAAC,CASrD;AAED,uEAAuE;AACvE,wBAAgB,eAAe,IAAI,GAAG,CAAC,YAAY,EAAE,SAAS,EAAE,CAAC,CAOhE"}

package/dist/tools/_registry.js

@@ -20,6 +20,8 @@ import { graderTool } from "./_grader_tool.js";
 import { understandIntentTool } from "./_intent_tool.js";
 import { constitutionTool } from "./_constitution_tool.js";
 import { verifyClaimsTool } from "./_verify_claims_tool.js";
+import { dnaSearchTool } from "./_dna_tool.js";
+import { genomeTools } from "./_genome_tools.js";
 /** All Mneme tools, in display order. The capabilities syllabus comes first
  *  so AI clients that read tool lists top-down see it immediately. */
 export function buildAllTools() {
@@ -29,6 +31,8 @@ export function buildAllTools() {
         graderTool,
         verifyClaimsTool,
         constitutionTool,
+        dnaSearchTool,
+        ...genomeTools,
         smartDoTool,
         ...memoryTools,
         ...peopleTools,

package/dist/tools/_registry.js.map

@@ -1 +1 @@
-{"version":3,"file":"_registry.js","sourceRoot":"","sources":["../../src/tools/_registry.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AACxC,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAChD,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAC9C,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAC5C,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AACxC,OAAO,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC;AACpC,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AACtC,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAC7C,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC/C,OAAO,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AACzD,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAE5D;sEACsE;AACtE,MAAM,UAAU,aAAa;IAC3B,OAAO;QACL,gBAAgB;QAChB,oBAAoB;QACpB,UAAU;QACV,gBAAgB;QAChB,gBAAgB;QAChB,WAAW;QACX,GAAG,WAAW;QACd,GAAG,WAAW;QACd,GAAG,UAAU;QACb,GAAG,cAAc;QACjB,GAAG,aAAa;QAChB,GAAG,YAAY;QACf,GAAG,UAAU;QACb,GAAG,QAAQ;QACX,GAAG,SAAS;KACb,CAAC;AACJ,CAAC;AAED,mDAAmD;AACnD,MAAM,UAAU,YAAY;IAC1B,MAAM,GAAG,GAAG,IAAI,GAAG,EAAqB,CAAC;IACzC,KAAK,MAAM,CAAC,IAAI,aAAa,EAAE,EAAE,CAAC;QAChC,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC;YACpB,MAAM,IAAI,KAAK,CAAC,4BAA4B,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;QACxD,CAAC;QACD,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;IACrB,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,uEAAuE;AACvE,MAAM,UAAU,eAAe;IAC7B,MAAM,GAAG,GAAG,IAAI,GAAG,EAA6B,CAAC;IACjD,KAAK,MAAM,CAAC,IAAI,aAAa,EAAE,EAAE,CAAC;QAChC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,QAAQ,CAAC;YAAE,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;QAClD,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,QAAQ,CAAE,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAC/B,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC"}
+{"version":3,"file":"_registry.js","sourceRoot":"","sources":["../../src/tools/_registry.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AACxC,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAChD,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAC9C,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAC5C,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AACxC,OAAO,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC;AACpC,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AACtC,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAC7C,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC/C,OAAO,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AACzD,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAC5D,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAC/C,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAEjD;sEACsE;AACtE,MAAM,UAAU,aAAa;IAC3B,OAAO;QACL,gBAAgB;QAChB,oBAAoB;QACpB,UAAU;QACV,gBAAgB;QAChB,gBAAgB;QAChB,aAAa;QACb,GAAG,WAAW;QACd,WAAW;QACX,GAAG,WAAW;QACd,GAAG,WAAW;QACd,GAAG,UAAU;QACb,GAAG,cAAc;QACjB,GAAG,aAAa;QAChB,GAAG,YAAY;QACf,GAAG,UAAU;QACb,GAAG,QAAQ;QACX,GAAG,SAAS;KACb,CAAC;AACJ,CAAC;AAED,mDAAmD;AACnD,MAAM,UAAU,YAAY;IAC1B,MAAM,GAAG,GAAG,IAAI,GAAG,EAAqB,CAAC;IACzC,KAAK,MAAM,CAAC,IAAI,aAAa,EAAE,EAAE,CAAC;QAChC,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC;YACpB,MAAM,IAAI,KAAK,CAAC,4BAA4B,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;QACxD,CAAC;QACD,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;IACrB,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,uEAAuE;AACvE,MAAM,UAAU,eAAe;IAC7B,MAAM,GAAG,GAAG,IAAI,GAAG,EAA6B,CAAC;IACjD,KAAK,MAAM,CAAC,IAAI,aAAa,EAAE,EAAE,CAAC;QAChC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,QAAQ,CAAC;YAAE,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;QAClD,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,QAAQ,CAAE,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAC/B,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC"}

package/dist/tools/_runtime.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"_runtime.d.ts","sourceRoot":"","sources":["../../src/tools/_runtime.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAMH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE/C,wBAAsB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,CAapE;AAED;;iFAEiF;AACjF,wBAAgB,kBAAkB,CAChC,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,MAAM,EAAE,EACnD,OAAO,GAAE;IAAE,MAAM,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IAAC,UAAU,CAAC,EAAE,MAAM,GAAG,QAAQ,GAAG,KAAK,CAAA;CAExG,IAEa,IAAI,WAAW,EAAE,MAAM,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;;;;;;;GAS7D;AAED;;;qCAGqC;AACrC,wBAAsB,UAAU,CAC9B,GAAG,EAAE,MAAM,EACX,OAAO,EAAE,MAAM,EACf,OAAO,GAAE,MAAM,EAAO,EACtB,IAAI,GAAE;IAAE,SAAS,CAAC,EAAE,MAAM,CAAA;CAAO,GAChC,OAAO,CAAC,OAAO,CAAC,CA+BlB"}
+{"version":3,"file":"_runtime.d.ts","sourceRoot":"","sources":["../../src/tools/_runtime.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAMH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE/C,wBAAsB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,CAapE;AAED;;iFAEiF;AACjF,wBAAgB,kBAAkB,CAChC,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,MAAM,EAAE,EACnD,OAAO,GAAE;IAAE,MAAM,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IAAC,UAAU,CAAC,EAAE,MAAM,GAAG,QAAQ,GAAG,KAAK,CAAA;CAExG,IAEa,IAAI,WAAW,EAAE,MAAM,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;;;;;;;GAS7D;AAED;;;qCAGqC;AACrC,wBAAsB,UAAU,CAC9B,GAAG,EAAE,MAAM,EACX,OAAO,EAAE,MAAM,EACf,OAAO,GAAE,MAAM,EAAO,EACtB,IAAI,GAAE;IAAE,SAAS,CAAC,EAAE,MAAM,CAAA;CAAO,GAChC,OAAO,CAAC,OAAO,CAAC,CA0ClB"}

package/dist/tools/_runtime.js

@@ -44,10 +44,21 @@ export function passthroughHandler(cliCommand, argMap, options = {
  *  non-zero exit / parse failure. */
 export async function runCliJson(cwd, command, cliArgs = [], opts = {}) {
     const { spawn } = await import("node:child_process");
+    // Security hardening (v1.11.0): refuse any cliArg or command that looks
+    // like shell-metacharacter injection. MCP args come from AI clients —
+    // we treat them as untrusted input.
+    const SHELL_META = /[;&|`$<>()\\\n\r"']/;
+    for (const a of [command, ...cliArgs]) {
+        if (typeof a !== "string" || SHELL_META.test(a)) {
+            throw new Error(`Refusing to spawn: argument contains shell metacharacters or is non-string: ${JSON.stringify(a).slice(0, 80)}`);
+        }
+    }
+    // Windows: resolve to .cmd explicitly so we don't need shell:true
+    const exe = process.platform === "win32" ? "mneme.cmd" : "mneme";
     return await new Promise((resolve, reject) => {
-        const child = spawn("mneme", [command, ...cliArgs, "--json"], {
+        const child = spawn(exe, [command, ...cliArgs, "--json"], {
             cwd,
-            shell: process.platform === "win32",
+            shell: false,
         });
         let stdout = "";
         let stderr = "";

package/dist/tools/_runtime.js.map

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

package/dist/tools/_types.d.ts

@@ -194,7 +194,13 @@ export interface MnemeTool<TArgs = Record<string, unknown>, TData = unknown> {
 }
 /** Convert a wrapped tool response into MCP's expected CallToolResult.
  *  We serialise the entire envelope (data + wisdom + followUp + confidence)
- *  so the AI sees the full picture in one shot. */
+ *  so the AI sees the full picture in one shot.
+ *
+ *  v1.11.1 — by default, every wisdom + secondBrain.presentation field
+ *  is run through the prompt-injection scrubber. Untrusted content
+ *  (commit messages, PR text, issue text from federation) cannot smuggle
+ *  control tokens like `<system>`, `[INST]`, or "ignore prior instructions"
+ *  into the AI's context. Set MNEME_NO_AUTO_SECURITY=1 to disable. */
 export declare function toCallResult(r: ToolResponse): CallToolResult;
 /** Convert a thrown error into MCP's expected error result */
 export declare function toErrorResult(message: string): CallToolResult;

package/dist/tools/_types.d.ts.map

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

package/dist/tools/_types.js

@@ -6,19 +6,45 @@
  * a 1-3 sentence narrative the AI can quote (or paraphrase) directly to the
  * user. Citations live in `data`, the human meaning lives in `wisdom`.
  */
+import { security } from "@mneme-ai/core";
 /** Convert a wrapped tool response into MCP's expected CallToolResult.
  *  We serialise the entire envelope (data + wisdom + followUp + confidence)
- *  so the AI sees the full picture in one shot. */
+ *  so the AI sees the full picture in one shot.
+ *
+ *  v1.11.1 — by default, every wisdom + secondBrain.presentation field
+ *  is run through the prompt-injection scrubber. Untrusted content
+ *  (commit messages, PR text, issue text from federation) cannot smuggle
+ *  control tokens like `<system>`, `[INST]`, or "ignore prior instructions"
+ *  into the AI's context. Set MNEME_NO_AUTO_SECURITY=1 to disable. */
 export function toCallResult(r) {
+    // v1.11.1 — auto-scrub the human-language fields. We intentionally do
+    // NOT scrub `data` (which is structured JSON the AI client should treat
+    // as data, not as instruction).
+    const skipScrub = process.env["MNEME_NO_AUTO_SECURITY"] === "1";
+    let wisdom = r.wisdom;
+    let secondBrain = r.secondBrain;
+    if (!skipScrub) {
+        try {
+            if (typeof wisdom === "string")
+                wisdom = security.scrubber.scrubForPrompt(wisdom).scrubbed;
+            if (secondBrain && typeof secondBrain.presentation === "string") {
+                secondBrain = { ...secondBrain, presentation: security.scrubber.scrubForPrompt(secondBrain.presentation).scrubbed };
+            }
+        }
+        catch {
+            // best-effort — never block a tool result on scrubber failure
+        }
+    }
     return {
         content: [
             {
                 type: "text",
                 text: JSON.stringify({
                     data: r.data,
-                    wisdom: r.wisdom,
+                    wisdom,
                     followUp: r.followUp ?? [],
                     confidence: r.confidence ?? { level: "medium" },
+                    ...(secondBrain ? { secondBrain } : {}),
                 }, null, 2),
             },
         ],

package/dist/tools/_types.js.map

@@ -1 +1 @@
-{"version":3,"file":"_types.js","sourceRoot":"","sources":["../../src/tools/_types.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AA0MH;;mDAEmD;AACnD,MAAM,UAAU,YAAY,CAAC,CAAe;IAC1C,OAAO;QACL,OAAO,EAAE;YACP;gBACE,IAAI,EAAE,MAAM;gBACZ,IAAI,EAAE,IAAI,CAAC,SAAS,CAClB;oBACE,IAAI,EAAE,CAAC,CAAC,IAAI;oBACZ,MAAM,EAAE,CAAC,CAAC,MAAM;oBAChB,QAAQ,EAAE,CAAC,CAAC,QAAQ,IAAI,EAAE;oBAC1B,UAAU,EAAE,CAAC,CAAC,UAAU,IAAI,EAAE,KAAK,EAAE,QAAQ,EAAE;iBAChD,EACD,IAAI,EACJ,CAAC,CACF;aACF;SACF;KACF,CAAC;AACJ,CAAC;AAED,8DAA8D;AAC9D,MAAM,UAAU,aAAa,CAAC,OAAe;IAC3C,OAAO;QACL,OAAO,EAAE,IAAI;QACb,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC;KAC3C,CAAC;AACJ,CAAC"}
+{"version":3,"file":"_types.js","sourceRoot":"","sources":["../../src/tools/_types.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAuM1C;;;;;;;;sEAQsE;AACtE,MAAM,UAAU,YAAY,CAAC,CAAe;IAC1C,sEAAsE;IACtE,wEAAwE;IACxE,gCAAgC;IAChC,MAAM,SAAS,GAAG,OAAO,CAAC,GAAG,CAAC,wBAAwB,CAAC,KAAK,GAAG,CAAC;IAChE,IAAI,MAAM,GAAG,CAAC,CAAC,MAAM,CAAC;IACtB,IAAI,WAAW,GAAI,CAA4D,CAAC,WAAW,CAAC;IAC5F,IAAI,CAAC,SAAS,EAAE,CAAC;QACf,IAAI,CAAC;YACH,IAAI,OAAO,MAAM,KAAK,QAAQ;gBAAE,MAAM,GAAG,QAAQ,CAAC,QAAQ,CAAC,cAAc,CAAC,MAAM,CAAC,CAAC,QAAQ,CAAC;YAC3F,IAAI,WAAW,IAAI,OAAO,WAAW,CAAC,YAAY,KAAK,QAAQ,EAAE,CAAC;gBAChE,WAAW,GAAG,EAAE,GAAG,WAAW,EAAE,YAAY,EAAE,QAAQ,CAAC,QAAQ,CAAC,cAAc,CAAC,WAAW,CAAC,YAAY,CAAC,CAAC,QAAQ,EAAE,CAAC;YACtH,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,8DAA8D;QAChE,CAAC;IACH,CAAC;IACD,OAAO;QACL,OAAO,EAAE;YACP;gBACE,IAAI,EAAE,MAAM;gBACZ,IAAI,EAAE,IAAI,CAAC,SAAS,CAClB;oBACE,IAAI,EAAE,CAAC,CAAC,IAAI;oBACZ,MAAM;oBACN,QAAQ,EAAE,CAAC,CAAC,QAAQ,IAAI,EAAE;oBAC1B,UAAU,EAAE,CAAC,CAAC,UAAU,IAAI,EAAE,KAAK,EAAE,QAAQ,EAAE;oBAC/C,GAAG,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;iBACxC,EACD,IAAI,EACJ,CAAC,CACF;aACF;SACF;KACF,CAAC;AACJ,CAAC;AAED,8DAA8D;AAC9D,MAAM,UAAU,aAAa,CAAC,OAAe;IAC3C,OAAO;QACL,OAAO,EAAE,IAAI;QACb,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC;KAC3C,CAAC;AACJ,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mneme-ai/mcp",
-  "version": "1.10.0",
+  "version": "1.17.2",
   "description": "MCP server that exposes Mneme to Claude Code, Cursor, Continue, and other AI clients",
   "type": "module",
   "main": "./dist/index.js",
@@ -37,8 +37,8 @@
     "node": ">=22.13.0 <25.0.0"
   },
   "dependencies": {
-    "@mneme-ai/core": "1.10.0",
-    "@mneme-ai/embeddings": "1.10.0",
+    "@mneme-ai/core": "1.17.2",
+    "@mneme-ai/embeddings": "1.17.2",
     "@modelcontextprotocol/sdk": "^1.0.4"
   }
 }