@mneme-ai/mcp 1.1.1 → 1.3.0

package/dist/tools/_lifecycle.d.ts

@@ -0,0 +1,51 @@
+/**
+ * Lifecycle tracking — record AI tool invocations + auto-promote frequent
+ * compositions into the periodic library.
+ *
+ * The chain reaction: every tool call lands here. We hash the (set of atoms
+ * called within a session window) into a "molecule signature" and count
+ * occurrences. When a signature reaches the promotion threshold (≥3 across
+ * sessions), we suggest promoting it to a named compound — the user (or AI)
+ * picks an alias, and from then on the compound shows up as a single
+ * callable in `mneme.lab.library`.
+ *
+ * Storage: .mneme/mcp-lifecycle.json (NOT the same as library.json — the
+ * library is for compose-CLI plans; this file tracks live AI invocations).
+ *
+ * Race-condition safety: read-modify-write with a temp file rename. Single
+ * MCP server per repo at a time; if two run, the second-writer wins, no
+ * corruption since the file is small (<100KB even after years of use).
+ */
+interface MoleculeSignature {
+    /** Sorted atom names joined with "+" for stable key */
+    key: string;
+    /** Atom names (preserves first-seen order for display) */
+    atoms: string[];
+    /** Total times this signature has been observed */
+    invocations: number;
+    /** ISO date of first observation */
+    firstSeen: string;
+    /** ISO date of last observation */
+    lastSeen: string;
+    /** Has the user been prompted to save this as a compound? */
+    promotionPrompted: boolean;
+    /** Saved alias (set when user/AI promotes) */
+    promotedAs?: string;
+}
+/** Record that the AI just invoked toolName. If multiple atoms have been
+ *  called in the same session window, also record them as a molecule
+ *  signature (the chain reaction trigger). */
+export declare function recordInvocation(repoRoot: string, toolName: string): {
+    isNewCombination: boolean;
+    invocationCount: number;
+    suggestSaveAs?: string;
+};
+/** List molecule signatures observed so far — used by mneme.brain.library.
+ *  Sorted by frequency descending, then by recency. */
+export declare function listSignatures(repoRoot: string): MoleculeSignature[];
+/** Promote a molecule signature into a named compound. Marks it as promoted
+ *  in the lifecycle store; the actual compound is written to library.json by
+ *  the existing periodic.promote() machinery. */
+export declare function markPromoted(repoRoot: string, key: string, alias: string): boolean;
+export {};
+//# sourceMappingURL=_lifecycle.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"_lifecycle.d.ts","sourceRoot":"","sources":["../../src/tools/_lifecycle.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAKH,UAAU,iBAAiB;IACzB,uDAAuD;IACvD,GAAG,EAAE,MAAM,CAAC;IACZ,0DAA0D;IAC1D,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,mDAAmD;IACnD,WAAW,EAAE,MAAM,CAAC;IACpB,oCAAoC;IACpC,SAAS,EAAE,MAAM,CAAC;IAClB,mCAAmC;IACnC,QAAQ,EAAE,MAAM,CAAC;IACjB,6DAA6D;IAC7D,iBAAiB,EAAE,OAAO,CAAC;IAC3B,8CAA8C;IAC9C,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AA0CD;;8CAE8C;AAC9C,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG;IACpE,gBAAgB,EAAE,OAAO,CAAC;IAC1B,eAAe,EAAE,MAAM,CAAC;IACxB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB,CAiDA;AAED;uDACuD;AACvD,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,iBAAiB,EAAE,CAMpE;AAED;;iDAEiD;AACjD,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAOlF"}

package/dist/tools/_lifecycle.js

@@ -0,0 +1,124 @@
+/**
+ * Lifecycle tracking — record AI tool invocations + auto-promote frequent
+ * compositions into the periodic library.
+ *
+ * The chain reaction: every tool call lands here. We hash the (set of atoms
+ * called within a session window) into a "molecule signature" and count
+ * occurrences. When a signature reaches the promotion threshold (≥3 across
+ * sessions), we suggest promoting it to a named compound — the user (or AI)
+ * picks an alias, and from then on the compound shows up as a single
+ * callable in `mneme.lab.library`.
+ *
+ * Storage: .mneme/mcp-lifecycle.json (NOT the same as library.json — the
+ * library is for compose-CLI plans; this file tracks live AI invocations).
+ *
+ * Race-condition safety: read-modify-write with a temp file rename. Single
+ * MCP server per repo at a time; if two run, the second-writer wins, no
+ * corruption since the file is small (<100KB even after years of use).
+ */
+import { existsSync, mkdirSync, readFileSync, writeFileSync, renameSync } from "node:fs";
+import { join, dirname } from "node:path";
+const PROMOTION_THRESHOLD = 3;
+const SESSION_WINDOW_MS = 5 * 60_000; // 5 minutes
+/** In-memory window tracker — accumulates atoms called within the same
+ *  AI session before flushing to the persistent store. */
+let currentSession = {
+    atoms: new Set(),
+    lastTouch: 0,
+};
+function lifecyclePath(repoRoot) {
+    return join(repoRoot, ".mneme", "mcp-lifecycle.json");
+}
+function readStore(repoRoot) {
+    const p = lifecyclePath(repoRoot);
+    if (!existsSync(p))
+        return { version: 1, signatures: {} };
+    try {
+        const raw = readFileSync(p, "utf8");
+        const parsed = JSON.parse(raw);
+        if (parsed.version !== 1)
+            return { version: 1, signatures: {} };
+        return parsed;
+    }
+    catch {
+        return { version: 1, signatures: {} };
+    }
+}
+function writeStore(repoRoot, store) {
+    const p = lifecyclePath(repoRoot);
+    if (!existsSync(dirname(p)))
+        mkdirSync(dirname(p), { recursive: true });
+    const tmp = p + ".tmp";
+    writeFileSync(tmp, JSON.stringify(store, null, 2) + "\n", "utf8");
+    renameSync(tmp, p);
+}
+/** Record that the AI just invoked toolName. If multiple atoms have been
+ *  called in the same session window, also record them as a molecule
+ *  signature (the chain reaction trigger). */
+export function recordInvocation(repoRoot, toolName) {
+    const now = Date.now();
+    // Reset session window if too much time has passed
+    if (now - currentSession.lastTouch > SESSION_WINDOW_MS) {
+        currentSession = { atoms: new Set(), lastTouch: now };
+    }
+    currentSession.atoms.add(toolName);
+    currentSession.lastTouch = now;
+    // Only record signatures when ≥2 atoms in window — single-atom calls
+    // are just normal tool use, not a molecule.
+    if (currentSession.atoms.size < 2) {
+        return { isNewCombination: false, invocationCount: 1 };
+    }
+    const atoms = Array.from(currentSession.atoms).sort();
+    const key = atoms.join("+");
+    const store = readStore(repoRoot);
+    const existing = store.signatures[key];
+    const today = new Date().toISOString();
+    if (!existing) {
+        store.signatures[key] = {
+            key,
+            atoms,
+            invocations: 1,
+            firstSeen: today,
+            lastSeen: today,
+            promotionPrompted: false,
+        };
+        writeStore(repoRoot, store);
+        return { isNewCombination: true, invocationCount: 1 };
+    }
+    existing.invocations++;
+    existing.lastSeen = today;
+    let suggestSaveAs;
+    if (existing.invocations >= PROMOTION_THRESHOLD && !existing.promotionPrompted && !existing.promotedAs) {
+        existing.promotionPrompted = true;
+        suggestSaveAs = `compound_${atoms[0]?.split(".").slice(-1)[0] ?? "x"}_${atoms.length}atoms`;
+    }
+    writeStore(repoRoot, store);
+    return {
+        isNewCombination: false,
+        invocationCount: existing.invocations,
+        suggestSaveAs,
+    };
+}
+/** List molecule signatures observed so far — used by mneme.brain.library.
+ *  Sorted by frequency descending, then by recency. */
+export function listSignatures(repoRoot) {
+    const store = readStore(repoRoot);
+    return Object.values(store.signatures).sort((a, b) => {
+        if (b.invocations !== a.invocations)
+            return b.invocations - a.invocations;
+        return b.lastSeen.localeCompare(a.lastSeen);
+    });
+}
+/** Promote a molecule signature into a named compound. Marks it as promoted
+ *  in the lifecycle store; the actual compound is written to library.json by
+ *  the existing periodic.promote() machinery. */
+export function markPromoted(repoRoot, key, alias) {
+    const store = readStore(repoRoot);
+    const sig = store.signatures[key];
+    if (!sig)
+        return false;
+    sig.promotedAs = alias;
+    writeStore(repoRoot, store);
+    return true;
+}
+//# sourceMappingURL=_lifecycle.js.map

package/dist/tools/_lifecycle.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"_lifecycle.js","sourceRoot":"","sources":["../../src/tools/_lifecycle.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,YAAY,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACzF,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAwB1C,MAAM,mBAAmB,GAAG,CAAC,CAAC;AAC9B,MAAM,iBAAiB,GAAG,CAAC,GAAG,MAAM,CAAC,CAAC,YAAY;AAElD;0DAC0D;AAC1D,IAAI,cAAc,GAA8C;IAC9D,KAAK,EAAE,IAAI,GAAG,EAAE;IAChB,SAAS,EAAE,CAAC;CACb,CAAC;AAEF,SAAS,aAAa,CAAC,QAAgB;IACrC,OAAO,IAAI,CAAC,QAAQ,EAAE,QAAQ,EAAE,oBAAoB,CAAC,CAAC;AACxD,CAAC;AAED,SAAS,SAAS,CAAC,QAAgB;IACjC,MAAM,CAAC,GAAG,aAAa,CAAC,QAAQ,CAAC,CAAC;IAClC,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC;QAAE,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,UAAU,EAAE,EAAE,EAAE,CAAC;IAC1D,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,YAAY,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC;QACpC,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAmB,CAAC;QACjD,IAAI,MAAM,CAAC,OAAO,KAAK,CAAC;YAAE,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,UAAU,EAAE,EAAE,EAAE,CAAC;QAChE,OAAO,MAAM,CAAC;IAChB,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,UAAU,EAAE,EAAE,EAAE,CAAC;IACxC,CAAC;AACH,CAAC;AAED,SAAS,UAAU,CAAC,QAAgB,EAAE,KAAqB;IACzD,MAAM,CAAC,GAAG,aAAa,CAAC,QAAQ,CAAC,CAAC;IAClC,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;QAAE,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACxE,MAAM,GAAG,GAAG,CAAC,GAAG,MAAM,CAAC;IACvB,aAAa,CAAC,GAAG,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,EAAE,MAAM,CAAC,CAAC;IAClE,UAAU,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;AACrB,CAAC;AAED;;8CAE8C;AAC9C,MAAM,UAAU,gBAAgB,CAAC,QAAgB,EAAE,QAAgB;IAKjE,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IACvB,mDAAmD;IACnD,IAAI,GAAG,GAAG,cAAc,CAAC,SAAS,GAAG,iBAAiB,EAAE,CAAC;QACvD,cAAc,GAAG,EAAE,KAAK,EAAE,IAAI,GAAG,EAAE,EAAE,SAAS,EAAE,GAAG,EAAE,CAAC;IACxD,CAAC;IACD,cAAc,CAAC,KAAK,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;IACnC,cAAc,CAAC,SAAS,GAAG,GAAG,CAAC;IAE/B,qEAAqE;IACrE,4CAA4C;IAC5C,IAAI,cAAc,CAAC,KAAK,CAAC,IAAI,GAAG,CAAC,EAAE,CAAC;QAClC,OAAO,EAAE,gBAAgB,EAAE,KAAK,EAAE,eAAe,EAAE,CAAC,EAAE,CAAC;IACzD,CAAC;IAED,MAAM,KAAK,GAAG,KAAK,CAAC,IAAI,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE,CAAC;IACtD,MAAM,GAAG,GAAG,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAC5B,MAAM,KAAK,GAAG,SAAS,CAAC,QAAQ,CAAC,CAAC;IAClC,MAAM,QAAQ,GAAG,KAAK,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC;IACvC,MAAM,KAAK,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IAEvC,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,KAAK,CAAC,UAAU,CAAC,GAAG,CAAC,GAAG;YACtB,GAAG;YACH,KAAK;YACL,WAAW,EAAE,CAAC;YACd,SAAS,EAAE,KAAK;YAChB,QAAQ,EAAE,KAAK;YACf,iBAAiB,EAAE,KAAK;SACzB,CAAC;QACF,UAAU,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;QAC5B,OAAO,EAAE,gBAAgB,EAAE,IAAI,EAAE,eAAe,EAAE,CAAC,EAAE,CAAC;IACxD,CAAC;IAED,QAAQ,CAAC,WAAW,EAAE,CAAC;IACvB,QAAQ,CAAC,QAAQ,GAAG,KAAK,CAAC;IAE1B,IAAI,aAAiC,CAAC;IACtC,IAAI,QAAQ,CAAC,WAAW,IAAI,mBAAmB,IAAI,CAAC,QAAQ,CAAC,iBAAiB,IAAI,CAAC,QAAQ,CAAC,UAAU,EAAE,CAAC;QACvG,QAAQ,CAAC,iBAAiB,GAAG,IAAI,CAAC;QAClC,aAAa,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,GAAG,IAAI,KAAK,CAAC,MAAM,OAAO,CAAC;IAC9F,CAAC;IAED,UAAU,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;IAC5B,OAAO;QACL,gBAAgB,EAAE,KAAK;QACvB,eAAe,EAAE,QAAQ,CAAC,WAAW;QACrC,aAAa;KACd,CAAC;AACJ,CAAC;AAED;uDACuD;AACvD,MAAM,UAAU,cAAc,CAAC,QAAgB;IAC7C,MAAM,KAAK,GAAG,SAAS,CAAC,QAAQ,CAAC,CAAC;IAClC,OAAO,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE;QACnD,IAAI,CAAC,CAAC,WAAW,KAAK,CAAC,CAAC,WAAW;YAAE,OAAO,CAAC,CAAC,WAAW,GAAG,CAAC,CAAC,WAAW,CAAC;QAC1E,OAAO,CAAC,CAAC,QAAQ,CAAC,aAAa,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC;IAC9C,CAAC,CAAC,CAAC;AACL,CAAC;AAED;;iDAEiD;AACjD,MAAM,UAAU,YAAY,CAAC,QAAgB,EAAE,GAAW,EAAE,KAAa;IACvE,MAAM,KAAK,GAAG,SAAS,CAAC,QAAQ,CAAC,CAAC;IAClC,MAAM,GAAG,GAAG,KAAK,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC;IAClC,IAAI,CAAC,GAAG;QAAE,OAAO,KAAK,CAAC;IACvB,GAAG,CAAC,UAAU,GAAG,KAAK,CAAC;IACvB,UAAU,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;IAC5B,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/tools/_molecules.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Molecule recipes — pre-defined atom combinations that form named molecules.
+ *
+ * Architectural role:
+ *   - Atoms = individual MCP tools (mneme.people.atrophy, mneme.audit.certify, …)
+ *   - Molecules = named combinations of atoms that solve a higher-order question
+ *   - Compounds = molecules promoted into the library via repeated use
+ *
+ * Each tool's `secondBrain.compose` field surfaces the molecules that include
+ * its atom — so the AI sees "if you just ran X, the natural next is to compose
+ * X+Y+Z = molecule M". This triggers the chain-reaction of wisdom.
+ *
+ * The 20 molecules below cover the most-asked higher-order questions in
+ * software-engineering management, security review, and AI-session audit.
+ */
+import type { ComposeSuggestion } from "./_types.js";
+/** All known molecules. Each lists the atoms that compose it + when to fire. */
+export declare const MOLECULES: ComposeSuggestion[];
+/** Find all molecules whose atoms include the given tool name.
+ *  Used by tools to populate their `secondBrain.compose` field. */
+export declare function moleculesContaining(atomName: string): ComposeSuggestion[];
+//# sourceMappingURL=_molecules.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"_molecules.d.ts","sourceRoot":"","sources":["../../src/tools/_molecules.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAErD,gFAAgF;AAChF,eAAO,MAAM,SAAS,EAAE,iBAAiB,EAkIxC,CAAC;AAEF;mEACmE;AACnE,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,GAAG,iBAAiB,EAAE,CAEzE"}

package/dist/tools/_molecules.js

@@ -0,0 +1,142 @@
+/**
+ * Molecule recipes — pre-defined atom combinations that form named molecules.
+ *
+ * Architectural role:
+ *   - Atoms = individual MCP tools (mneme.people.atrophy, mneme.audit.certify, …)
+ *   - Molecules = named combinations of atoms that solve a higher-order question
+ *   - Compounds = molecules promoted into the library via repeated use
+ *
+ * Each tool's `secondBrain.compose` field surfaces the molecules that include
+ * its atom — so the AI sees "if you just ran X, the natural next is to compose
+ * X+Y+Z = molecule M". This triggers the chain-reaction of wisdom.
+ *
+ * The 20 molecules below cover the most-asked higher-order questions in
+ * software-engineering management, security review, and AI-session audit.
+ */
+/** All known molecules. Each lists the atoms that compose it + when to fire. */
+export const MOLECULES = [
+    // ─────── PEOPLE / KNOWLEDGE / TEAM HEALTH ───────
+    {
+        molecule: "succession_plan",
+        atoms: ["mneme.people.atrophy", "mneme.people.bus_factor", "mneme.people.telepathy"],
+        when: "User asks about org-risk, handover, what happens if X leaves, knowledge transfer, " +
+            "single points of failure, or backup engineers.",
+        example: "Atrophy says Alice's auth knowledge is 28/100 (fading). Bus-factor confirms she owns " +
+            "78% of auth files. Telepathy suggests Bob writes auth-shaped code without co-authoring " +
+            "Alice — recommended pair-onboarding target.",
+    },
+    {
+        molecule: "knowledge_health_check",
+        atoms: ["mneme.people.atrophy", "mneme.people.passport", "mneme.quality.repo_mri"],
+        when: "Quarterly review, before a reorg, or when user asks 'how healthy is the team?'.",
+        example: "Combine atrophy heatmap + per-engineer passport + 20-axis MRI into one dashboard.",
+    },
+    {
+        molecule: "onboarding_dossier",
+        atoms: ["mneme.insights.mirror", "mneme.people.who_knows", "mneme.insights.story", "mneme.people.passport"],
+        when: "New hire arrives, or someone asks 'how do I get up to speed on X?'.",
+    },
+    {
+        molecule: "team_friction_diagnosis",
+        atoms: ["mneme.people.nemesis", "mneme.insights.regret", "mneme.people.lineage"],
+        when: "User asks 'where is friction?', 'who's stepping on whom?', 'rewrite churn'.",
+    },
+    // ─────── AI COMMIT SAFETY / AUDIT ───────
+    {
+        molecule: "ai_commit_check",
+        atoms: ["mneme.audit.trace", "mneme.audit.verify", "mneme.audit.certify"],
+        when: "Before merging an AI-generated commit, before a CI gate, or at PR review time.",
+        example: "Trace identifies the AI tool (Claude Code / Cursor / Codex). Verify catches narrative-vs-diff " +
+            "drift. Certify gives 5-axis pass/warn/fail.",
+    },
+    {
+        molecule: "compliance_evidence_pack",
+        atoms: ["mneme.audit.report", "mneme.audit.ledger", "mneme.audit.deps", "mneme.forensics.vulns"],
+        when: "EU AI Act 2026 evidence request, SOX/SOC2 quarterly, or external audit prep.",
+    },
+    // ─────── REFACTOR / SHIP SAFETY ───────
+    {
+        molecule: "refactor_safety_check",
+        atoms: ["mneme.insights.premortem", "mneme.memory.blast", "mneme.people.atrophy"],
+        when: "User proposes a refactor, asks 'is this safe?', 'has this been tried?', or wants to estimate " +
+            "blast radius before merge.",
+        example: "Premortem says 78% regret-risk based on 7 of 9 similar attempts. Blast names 3 incident-prone " +
+            "files in the diff. Atrophy warns the file owner is 28/100 fresh — knowledge gap.",
+    },
+    {
+        molecule: "regret_pattern_review",
+        atoms: ["mneme.insights.regret", "mneme.insights.paradox", "mneme.insights.crystal_ball"],
+        when: "Quarterly retro, post-mortem, or before deciding whether to attempt a contested refactor.",
+    },
+    {
+        molecule: "deploy_gate",
+        atoms: ["mneme.audit.certify", "mneme.forensics.vulns", "mneme.audit.deps", "mneme.insights.crystal_ball"],
+        when: "CI gate before production deploy, release candidate review.",
+    },
+    // ─────── SECURITY / FORENSICS ───────
+    {
+        molecule: "security_review",
+        atoms: ["mneme.forensics.vulns", "mneme.audit.deps", "mneme.forensics.anomaly"],
+        when: "Security review of a feature, before pen-test, or after a suspected incident.",
+    },
+    {
+        molecule: "incident_attribution",
+        atoms: ["mneme.forensics.match", "mneme.forensics.attribute", "mneme.forensics.anomaly"],
+        when: "After a suspicious commit lands, during incident response, or insider-threat review.",
+    },
+    {
+        molecule: "vulnerability_triage",
+        atoms: ["mneme.forensics.vulns", "mneme.forensics.show", "mneme.audit.conscience"],
+        when: "Reviewing a fresh batch of vuln findings — score, inspect, suppress false positives.",
+    },
+    // ─────── STORY / NARRATIVE / DECISIONS ───────
+    {
+        molecule: "decision_archaeology",
+        atoms: ["mneme.memory.ask", "mneme.insights.decisions", "mneme.insights.story"],
+        when: "User asks 'why does X exist?', 'what was the rationale for Y?', or wants ADR-style narrative.",
+        example: "Cited Q&A → ADR list → multi-act narrative arc.",
+    },
+    {
+        molecule: "file_archaeology",
+        atoms: ["mneme.memory.why", "mneme.insights.time_machine", "mneme.quality.palimpsest", "mneme.people.lineage"],
+        when: "User wants the full life story of a file or a single line of code.",
+    },
+    {
+        molecule: "expert_finder",
+        atoms: ["mneme.people.who_knows", "mneme.people.passport", "mneme.people.atrophy"],
+        when: "User asks 'who can help me with X?', 'who should review this PR?'.",
+    },
+    // ─────── QUALITY / DEBT ───────
+    {
+        molecule: "tech_debt_audit",
+        atoms: ["mneme.quality.karma", "mneme.people.promise", "mneme.insights.ghost", "mneme.insights.fossil"],
+        when: "Quarterly tech-debt review, sprint planning for cleanup, or before a major refactor.",
+    },
+    {
+        molecule: "code_quality_dashboard",
+        atoms: ["mneme.quality.repo_mri", "mneme.quality.heartbeat", "mneme.insights.runaway", "mneme.insights.drift"],
+        when: "Engineering manager dashboard, monthly health check, or VP-of-eng update.",
+    },
+    // ─────── PREDICTION / FORESIGHT ───────
+    {
+        molecule: "release_readiness",
+        atoms: ["mneme.audit.certify", "mneme.insights.crystal_ball", "mneme.memory.blast", "mneme.forensics.vulns"],
+        when: "Final go/no-go before shipping a release.",
+    },
+    {
+        molecule: "next_quarter_risk_map",
+        atoms: ["mneme.people.atrophy", "mneme.insights.oracle", "mneme.quant.black_swan", "mneme.quality.heartbeat"],
+        when: "Strategic planning — what's likely to break, who's at risk of forgetting, where are the tail risks?",
+    },
+    {
+        molecule: "moneyball_review",
+        atoms: ["mneme.quant.moneyball", "mneme.people.influence", "mneme.people.passport"],
+        when: "Compensation review, promotion committee, identifying undervalued contributors.",
+    },
+];
+/** Find all molecules whose atoms include the given tool name.
+ *  Used by tools to populate their `secondBrain.compose` field. */
+export function moleculesContaining(atomName) {
+    return MOLECULES.filter((m) => m.atoms.includes(atomName));
+}
+//# sourceMappingURL=_molecules.js.map

package/dist/tools/_molecules.js.map

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

package/dist/tools/_registry.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Tool registry — collects all category modules into one ordered list +
+ * a fast lookup map. Each category file exports a `tools: MnemeTool[]`
+ * array; the registry concatenates them and surfaces them to the MCP
+ * server as one flat catalog (with namespaced names like
+ * `mneme.people.atrophy` for AI client navigation).
+ */
+import type { MnemeTool, ToolCategory } from "./_types.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 declare function buildAllTools(): MnemeTool[];
+/** Build a fast lookup table keyed by tool name */
+export declare function buildToolMap(): Map<string, MnemeTool>;
+/** Group tools by category — used by the capabilities syllabus tool */
+export declare function groupByCategory(): Map<ToolCategory, MnemeTool[]>;
+//# sourceMappingURL=_registry.d.ts.map

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

@@ -0,0 +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;AAc3D;sEACsE;AACtE,wBAAgB,aAAa,IAAI,SAAS,EAAE,CAc3C;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

@@ -0,0 +1,57 @@
+/**
+ * Tool registry — collects all category modules into one ordered list +
+ * a fast lookup map. Each category file exports a `tools: MnemeTool[]`
+ * array; the registry concatenates them and surfaces them to the MCP
+ * server as one flat catalog (with namespaced names like
+ * `mneme.people.atrophy` for AI client navigation).
+ */
+import { memoryTools } from "./memory.js";
+import { peopleTools } from "./people.js";
+import { auditTools } from "./audit.js";
+import { forensicsTools } from "./forensics.js";
+import { insightsTools } from "./insights.js";
+import { qualityTools } from "./quality.js";
+import { quantTools } from "./quant.js";
+import { labTools } from "./lab.js";
+import { metaTools } from "./meta.js";
+import { capabilitiesTool } from "./_capabilities.js";
+import { smartDoTool } from "./_smart_do.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() {
+    return [
+        capabilitiesTool,
+        smartDoTool,
+        ...memoryTools,
+        ...peopleTools,
+        ...auditTools,
+        ...forensicsTools,
+        ...insightsTools,
+        ...qualityTools,
+        ...quantTools,
+        ...labTools,
+        ...metaTools,
+    ];
+}
+/** Build a fast lookup table keyed by tool name */
+export function buildToolMap() {
+    const out = new Map();
+    for (const t of buildAllTools()) {
+        if (out.has(t.name)) {
+            throw new Error(`MCP tool name collision: ${t.name}`);
+        }
+        out.set(t.name, t);
+    }
+    return out;
+}
+/** Group tools by category — used by the capabilities syllabus tool */
+export function groupByCategory() {
+    const out = new Map();
+    for (const t of buildAllTools()) {
+        if (!out.has(t.category))
+            out.set(t.category, []);
+        out.get(t.category).push(t);
+    }
+    return out;
+}
+//# sourceMappingURL=_registry.js.map

package/dist/tools/_registry.js.map

@@ -0,0 +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;AAE7C;sEACsE;AACtE,MAAM,UAAU,aAAa;IAC3B,OAAO;QACL,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"}

package/dist/tools/_runtime.d.ts

@@ -0,0 +1,32 @@
+/**
+ * MCP runtime — built once at server start, reused for every tool call.
+ *
+ * The previous monolithic index.ts opened the store + embedder inline.
+ * Extracting it lets every tool file import {ToolRuntime} cleanly without
+ * each one re-instantiating the database connection.
+ */
+import type { ToolRuntime } from "./_types.js";
+export declare function buildRuntime(cwd: string): Promise<ToolRuntime>;
+/** Build a passthrough handler that spawns the CLI command, parses --json, and
+ *  wraps the result in a generic wisdom envelope. Use this for tools whose
+ *  logic lives entirely in the CLI; the wisdom field is generic but accurate. */
+export declare function passthroughHandler(cliCommand: string, argMap: (args: Record<string, unknown>) => string[], options?: {
+    wisdom: (data: unknown) => string;
+    followUp?: string[];
+    confidence?: "high" | "medium" | "low";
+}): (rt: ToolRuntime, args: Record<string, unknown>) => Promise<{
+    data: unknown;
+    wisdom: string;
+    followUp: string[];
+    confidence: {
+        level: "high" | "medium" | "low";
+    };
+}>;
+/** Spawn `mneme <command> [...args]` as a child process and parse its --json
+ *  output. Used by category files for tools whose logic lives in the CLI
+ *  layer rather than the core API. Returns parsed JSON or throws on
+ *  non-zero exit / parse failure. */
+export declare function runCliJson(cwd: string, command: string, cliArgs?: string[], opts?: {
+    timeoutMs?: number;
+}): Promise<unknown>;
+//# sourceMappingURL=_runtime.d.ts.map

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

@@ -0,0 +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"}

package/dist/tools/_runtime.js

@@ -0,0 +1,78 @@
+/**
+ * MCP runtime — built once at server start, reused for every tool call.
+ *
+ * The previous monolithic index.ts opened the store + embedder inline.
+ * Extracting it lets every tool file import {ToolRuntime} cleanly without
+ * each one re-instantiating the database connection.
+ */
+import { existsSync, mkdirSync } from "node:fs";
+import { join } from "node:path";
+import { git, store } from "@mneme-ai/core";
+import { resolveEmbedder } from "@mneme-ai/embeddings";
+export async function buildRuntime(cwd) {
+    if (!(await git.isGitRepo(cwd))) {
+        throw new Error(`Mneme MCP: not in a git repo (${cwd}).`);
+    }
+    const meta = await git.getRepoMeta(cwd);
+    const dbDir = join(meta.rootPath, ".mneme");
+    if (!existsSync(dbDir))
+        mkdirSync(dbDir, { recursive: true });
+    const dbPath = join(dbDir, "mneme.db");
+    const s = new store.MnemeStore(dbPath);
+    const embedder = await resolveEmbedder({ provider: "auto" });
+    return { cwd, meta, store: s, embedder };
+}
+/** Build a passthrough handler that spawns the CLI command, parses --json, and
+ *  wraps the result in a generic wisdom envelope. Use this for tools whose
+ *  logic lives entirely in the CLI; the wisdom field is generic but accurate. */
+export function passthroughHandler(cliCommand, argMap, options = {
+    wisdom: () => "Result returned. AI should summarize key fields for the user.",
+}) {
+    return async (rt, args) => {
+        const data = await runCliJson(rt.meta.rootPath, cliCommand, argMap(args));
+        return {
+            data,
+            wisdom: options.wisdom(data),
+            followUp: options.followUp ?? [],
+            confidence: { level: options.confidence ?? "medium" },
+        };
+    };
+}
+/** Spawn `mneme <command> [...args]` as a child process and parse its --json
+ *  output. Used by category files for tools whose logic lives in the CLI
+ *  layer rather than the core API. Returns parsed JSON or throws on
+ *  non-zero exit / parse failure. */
+export async function runCliJson(cwd, command, cliArgs = [], opts = {}) {
+    const { spawn } = await import("node:child_process");
+    return await new Promise((resolve, reject) => {
+        const child = spawn("mneme", [command, ...cliArgs, "--json"], {
+            cwd,
+            shell: process.platform === "win32",
+        });
+        let stdout = "";
+        let stderr = "";
+        child.stdout?.on("data", (b) => (stdout += String(b)));
+        child.stderr?.on("data", (b) => (stderr += String(b)));
+        const timer = setTimeout(() => {
+            child.kill();
+            reject(new Error(`mneme ${command} timed out after ${opts.timeoutMs ?? 60000}ms`));
+        }, opts.timeoutMs ?? 60_000);
+        child.on("close", (code) => {
+            clearTimeout(timer);
+            if (code !== 0) {
+                return reject(new Error(`mneme ${command} exited ${code}: ${stderr.slice(0, 500)}`));
+            }
+            try {
+                resolve(JSON.parse(stdout));
+            }
+            catch (err) {
+                reject(new Error(`mneme ${command} returned non-JSON: ${err.message}`));
+            }
+        });
+        child.on("error", (err) => {
+            clearTimeout(timer);
+            reject(err);
+        });
+    });
+}
+//# sourceMappingURL=_runtime.js.map

package/dist/tools/_runtime.js.map

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

package/dist/tools/_smart_do.d.ts

@@ -0,0 +1,14 @@
+/**
+ * mneme.smart_do — the FALLBACK DISPATCHER.
+ *
+ * Wraps the existing `mneme do "<intent>"` smart-dispatcher. When the AI
+ * student can't match the user's request to a specific tool in the catalog,
+ * it can fall back here: hand the natural-language intent to Mneme, and
+ * Mneme's smart-dispatcher routes it to the appropriate command.
+ *
+ * Net effect: even niche or unmodelled use cases reach the right command,
+ * so the user never feels "AI couldn't help me with that."
+ */
+import type { MnemeTool } from "./_types.js";
+export declare const smartDoTool: MnemeTool;
+//# sourceMappingURL=_smart_do.d.ts.map

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

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

package/dist/tools/_smart_do.js

@@ -0,0 +1,49 @@
+/**
+ * mneme.smart_do — the FALLBACK DISPATCHER.
+ *
+ * Wraps the existing `mneme do "<intent>"` smart-dispatcher. When the AI
+ * student can't match the user's request to a specific tool in the catalog,
+ * it can fall back here: hand the natural-language intent to Mneme, and
+ * Mneme's smart-dispatcher routes it to the appropriate command.
+ *
+ * Net effect: even niche or unmodelled use cases reach the right command,
+ * so the user never feels "AI couldn't help me with that."
+ */
+import { runCliJson } from "./_runtime.js";
+export const smartDoTool = {
+    name: "mneme.smart_do",
+    category: "meta",
+    description: "Fallback dispatcher — give it a NATURAL-LANGUAGE intent, it routes to the appropriate Mneme command and runs it. " +
+        "Use this WHEN no specific tool from `mneme.capabilities` matches the user's request, or when the user's intent " +
+        "spans multiple commands. Equivalent to running `mneme do '<intent>'` from the CLI. Prefer specific tools when " +
+        "possible — this dispatcher is slower because it runs an additional planning step.",
+    triggers: [
+        "do something I haven't named explicitly",
+        "I want X but I don't know which tool",
+    ],
+    inputSchema: {
+        type: "object",
+        properties: {
+            intent: { type: "string", description: "Natural-language description of what the user wants" },
+        },
+        required: ["intent"],
+    },
+    handler: async (rt, args) => {
+        const intent = String(args["intent"] ?? "");
+        if (!intent) {
+            return {
+                data: {},
+                wisdom: "smart_do requires an `intent` string.",
+                confidence: { level: "low" },
+            };
+        }
+        const data = await runCliJson(rt.meta.rootPath, "do", [intent]);
+        return {
+            data,
+            wisdom: "smart_do routed the intent to Mneme's smart-dispatcher. The data shows which command was chosen + its result.",
+            followUp: [],
+            confidence: { level: "medium" },
+        };
+    },
+};
+//# sourceMappingURL=_smart_do.js.map