@mneme-ai/mcp 1.1.0 → 1.2.0

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

package/dist/tools/_smart_do.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"_smart_do.js","sourceRoot":"","sources":["../../src/tools/_smart_do.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAG3C,MAAM,CAAC,MAAM,WAAW,GAAc;IACpC,IAAI,EAAE,gBAAgB;IACtB,QAAQ,EAAE,MAAM;IAChB,WAAW,EACT,mHAAmH;QACnH,iHAAiH;QACjH,gHAAgH;QAChH,mFAAmF;IACrF,QAAQ,EAAE;QACR,yCAAyC;QACzC,sCAAsC;KACvC;IACD,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,qDAAqD,EAAE;SAC/F;QACD,QAAQ,EAAE,CAAC,QAAQ,CAAC;KACrB;IACD,OAAO,EAAE,KAAK,EAAE,EAAE,EAAE,IAAI,EAAE,EAAE;QAC1B,MAAM,MAAM,GAAG,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC;QAC5C,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,OAAO;gBACL,IAAI,EAAE,EAAE;gBACR,MAAM,EAAE,uCAAuC;gBAC/C,UAAU,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE;aAC7B,CAAC;QACJ,CAAC;QACD,MAAM,IAAI,GAAG,MAAM,UAAU,CAAC,EAAE,CAAC,IAAI,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC;QAChE,OAAO;YACL,IAAI;YACJ,MAAM,EACJ,+GAA+G;YACjH,QAAQ,EAAE,EAAE;YACZ,UAAU,EAAE,EAAE,KAAK,EAAE,QAAQ,EAAE;SAChC,CAAC;IACJ,CAAC;CACF,CAAC"}

package/dist/tools/_types.d.ts

@@ -0,0 +1,70 @@
+/**
+ * MCP tool type system — the contract every Mneme tool implements.
+ *
+ * Design principle: every response carries WISDOM, not just data. AI clients
+ * shouldn't need to interpret raw JSON — Mneme pre-digests each finding into
+ * 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 type { Tool, CallToolResult } from "@modelcontextprotocol/sdk/types.js";
+import type { git, store, EmbeddingProvider } from "@mneme-ai/core";
+/** Categories for the syllabus tool — AI student reads this index first
+ *  and learns what kind of question goes to which group of tools. */
+export type ToolCategory = "memory" | "people" | "audit" | "forensics" | "insights" | "quality" | "quant" | "lab" | "meta";
+/** Wrapped response — every tool returns this shape so AI gets data + wisdom
+ *  + cross-references in one consistent envelope. */
+export interface ToolResponse<TData = unknown> {
+    /** Structured data the AI parses + uses */
+    data: TData;
+    /** 1-3 sentences in plain English explaining what the data means.
+     *  AI quotes or paraphrases this when answering the user. */
+    wisdom: string;
+    /** Tool names the AI might call next for deeper context.
+     *  Example: after `mneme.people.atrophy` → suggest `mneme.people.passport` */
+    followUp?: string[];
+    /** Confidence + caveats — when to trust this, when to flag heuristic limits */
+    confidence?: {
+        level: "high" | "medium" | "low";
+        notes?: string;
+    };
+}
+/** Runtime context passed to every handler — single source of truth.
+ *  Built once per MCP server lifetime, reused across all calls. */
+export interface ToolRuntime {
+    cwd: string;
+    meta: Awaited<ReturnType<typeof git.getRepoMeta>>;
+    store: store.MnemeStore;
+    embedder: EmbeddingProvider;
+}
+/** A Mneme tool definition — one per CLI command we expose via MCP.
+ *
+ *  description: write it like a good lesson title — *include WHEN to use + examples*.
+ *  AI tool selection is mostly description-matching; vague descriptions = wrong picks.
+ *
+ *  triggers: example user phrases that should fire this tool. The AI doesn't
+ *  see triggers directly, but we use them in the syllabus + as anchor for
+ *  description quality reviews. */
+export interface MnemeTool<TArgs = Record<string, unknown>, TData = unknown> {
+    /** MCP tool name — must match `^mneme\.[a-z_]+\.[a-z_]+$` for grouping */
+    name: string;
+    /** Category for the capabilities syllabus */
+    category: ToolCategory;
+    /** Rich description: 2-4 sentences. Include WHEN to use + 2-3 example user
+     *  phrases this should match. The AI picks tools by matching user intent
+     *  to descriptions, so be specific. */
+    description: string;
+    /** Example user queries that should trigger this tool. Used for
+     *  syllabus generation + description-quality review. */
+    triggers: string[];
+    /** JSON Schema for input parameters */
+    inputSchema: Tool["inputSchema"];
+    /** Async handler — receives runtime + parsed args */
+    handler: (runtime: ToolRuntime, args: TArgs) => Promise<ToolResponse<TData>>;
+}
+/** 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. */
+export declare function toCallResult(r: ToolResponse): CallToolResult;
+/** Convert a thrown error into MCP's expected error result */
+export declare function toErrorResult(message: string): CallToolResult;
+//# sourceMappingURL=_types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"_types.d.ts","sourceRoot":"","sources":["../../src/tools/_types.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,IAAI,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AAC/E,OAAO,KAAK,EAAE,GAAG,EAAE,KAAK,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAEpE;qEACqE;AACrE,MAAM,MAAM,YAAY,GACpB,QAAQ,GACR,QAAQ,GACR,OAAO,GACP,WAAW,GACX,UAAU,GACV,SAAS,GACT,OAAO,GACP,KAAK,GACL,MAAM,CAAC;AAEX;qDACqD;AACrD,MAAM,WAAW,YAAY,CAAC,KAAK,GAAG,OAAO;IAC3C,2CAA2C;IAC3C,IAAI,EAAE,KAAK,CAAC;IACZ;iEAC6D;IAC7D,MAAM,EAAE,MAAM,CAAC;IACf;kFAC8E;IAC9E,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,+EAA+E;IAC/E,UAAU,CAAC,EAAE;QACX,KAAK,EAAE,MAAM,GAAG,QAAQ,GAAG,KAAK,CAAC;QACjC,KAAK,CAAC,EAAE,MAAM,CAAC;KAChB,CAAC;CACH;AAED;mEACmE;AACnE,MAAM,WAAW,WAAW;IAC1B,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,OAAO,CAAC,UAAU,CAAC,OAAO,GAAG,CAAC,WAAW,CAAC,CAAC,CAAC;IAClD,KAAK,EAAE,KAAK,CAAC,UAAU,CAAC;IACxB,QAAQ,EAAE,iBAAiB,CAAC;CAC7B;AAED;;;;;;;mCAOmC;AACnC,MAAM,WAAW,SAAS,CAAC,KAAK,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,KAAK,GAAG,OAAO;IACzE,0EAA0E;IAC1E,IAAI,EAAE,MAAM,CAAC;IACb,6CAA6C;IAC7C,QAAQ,EAAE,YAAY,CAAC;IACvB;;2CAEuC;IACvC,WAAW,EAAE,MAAM,CAAC;IACpB;4DACwD;IACxD,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,uCAAuC;IACvC,WAAW,EAAE,IAAI,CAAC,aAAa,CAAC,CAAC;IACjC,qDAAqD;IACrD,OAAO,EAAE,CAAC,OAAO,EAAE,WAAW,EAAE,IAAI,EAAE,KAAK,KAAK,OAAO,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC,CAAC;CAC9E;AAED;;mDAEmD;AACnD,wBAAgB,YAAY,CAAC,CAAC,EAAE,YAAY,GAAG,cAAc,CAkB5D;AAED,8DAA8D;AAC9D,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,cAAc,CAK7D"}

package/dist/tools/_types.js

@@ -0,0 +1,34 @@
+/**
+ * MCP tool type system — the contract every Mneme tool implements.
+ *
+ * Design principle: every response carries WISDOM, not just data. AI clients
+ * shouldn't need to interpret raw JSON — Mneme pre-digests each finding into
+ * 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`.
+ */
+/** 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. */
+export function toCallResult(r) {
+    return {
+        content: [
+            {
+                type: "text",
+                text: JSON.stringify({
+                    data: r.data,
+                    wisdom: r.wisdom,
+                    followUp: r.followUp ?? [],
+                    confidence: r.confidence ?? { level: "medium" },
+                }, null, 2),
+            },
+        ],
+    };
+}
+/** Convert a thrown error into MCP's expected error result */
+export function toErrorResult(message) {
+    return {
+        isError: true,
+        content: [{ type: "text", text: message }],
+    };
+}
+//# sourceMappingURL=_types.js.map

package/dist/tools/_types.js.map

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

package/dist/tools/audit.d.ts

@@ -0,0 +1,9 @@
+/**
+ * AI Session Audit — the trust certificate for every AI-driven commit.
+ *
+ * Vendor-neutral. Works against any AI tool whose commits land in `git log`.
+ * Each tool here is a different "mode" of the audit pipeline.
+ */
+import type { MnemeTool } from "./_types.js";
+export declare const auditTools: MnemeTool[];
+//# sourceMappingURL=audit.d.ts.map

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

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

package/dist/tools/audit.js

@@ -0,0 +1,233 @@
+/**
+ * AI Session Audit — the trust certificate for every AI-driven commit.
+ *
+ * Vendor-neutral. Works against any AI tool whose commits land in `git log`.
+ * Each tool here is a different "mode" of the audit pipeline.
+ */
+import { runCliJson } from "./_runtime.js";
+export const auditTools = [
+    {
+        name: "mneme.audit.baseline",
+        category: "audit",
+        description: "Snapshot the repo's behavior, types, perf, and sample-command outputs BEFORE letting an AI work on it. " +
+            "Stores the snapshot in .mneme/audit-baseline.json for later certify-time comparison. " +
+            "Use this WHEN: user is about to start an AI-driven coding session and wants a 'before' snapshot to grade against.",
+        triggers: [
+            "snapshot before AI works",
+            "audit baseline",
+            "เก็บ baseline ก่อน AI ทำงาน",
+        ],
+        inputSchema: { type: "object", properties: {} },
+        handler: async (rt) => {
+            const data = await runCliJson(rt.meta.rootPath, "audit", ["--baseline"]);
+            return {
+                data,
+                wisdom: "Baseline captured. Ask user to let their AI work, then run mneme.audit.certify when done to compare.",
+                followUp: ["mneme.audit.trace", "mneme.audit.certify"],
+                confidence: { level: "high" },
+            };
+        },
+    },
+    {
+        name: "mneme.audit.trace",
+        category: "audit",
+        description: "After AI worked: capture the diff + detect WHICH AI tool produced the commit (Claude Code · Cursor · Codex · Devin · ...). " +
+            "Use this WHEN user asks: 'what did the AI just change?', 'which AI tool wrote this commit?', 'show me the AI session trace'.",
+        triggers: [
+            "what did the AI change?",
+            "which AI tool wrote this?",
+            "audit trace",
+        ],
+        inputSchema: { type: "object", properties: {} },
+        handler: async (rt) => {
+            const data = await runCliJson(rt.meta.rootPath, "audit", ["--trace"]);
+            return {
+                data,
+                wisdom: "Trace captured. Use mneme.audit.verify next to check whether the AI's commit message matches the actual diff.",
+                followUp: ["mneme.audit.verify", "mneme.audit.certify"],
+                confidence: { level: "high" },
+            };
+        },
+    },
+    {
+        name: "mneme.audit.verify",
+        category: "audit",
+        description: "Leviathan-style narrative-vs-reality check: does the AI's commit message ACTUALLY match the diff? " +
+            "Catches AI gaslighting (e.g. 'no change to db.ts' but the diff has 3 lines in db.ts). " +
+            "Use this WHEN user asks: 'is the AI lying about its changes?', 'verify the commit narrative', 'AI gaslight check'.",
+        triggers: [
+            "is the AI lying?",
+            "verify commit narrative",
+            "AI gaslight check",
+        ],
+        inputSchema: { type: "object", properties: {} },
+        handler: async (rt) => {
+            const data = await runCliJson(rt.meta.rootPath, "audit", ["--verify"]);
+            return {
+                data,
+                wisdom: "Verification complete. If contradictions are found, escalate to mneme.audit.certify for the full trust certificate.",
+                followUp: ["mneme.audit.certify"],
+                confidence: { level: "high" },
+            };
+        },
+    },
+    {
+        name: "mneme.audit.certify",
+        category: "audit",
+        description: "The flagship: 5-axis trust certificate for an AI commit (behavioral parity · API contract · test pass rate · perf · narrative match). " +
+            "Plus forensic axes (TIME / FILES / STYLE / SIZE). Returns PASS / WARN / FAIL with structured findings. " +
+            "Use this WHEN user asks: 'is this commit safe?', 'grade the AI's homework', 'CI gate the AI commit', " +
+            "'final trust certificate', 'should I merge this?'.",
+        triggers: [
+            "grade the AI commit",
+            "is this commit safe to merge?",
+            "trust certificate",
+            "audit certify",
+        ],
+        inputSchema: {
+            type: "object",
+            properties: {
+                explain: { type: "boolean", description: "Add plain-English narrative summary" },
+                strict: { type: "boolean", description: "Treat skipped axes as fail (compliance mode)" },
+            },
+        },
+        handler: async (rt, args) => {
+            const cliArgs = ["--certify"];
+            if (args["explain"])
+                cliArgs.push("--explain");
+            if (args["strict"])
+                cliArgs.push("--strict");
+            const data = await runCliJson(rt.meta.rootPath, "audit", cliArgs);
+            const verdict = data?.verdict ?? "unknown";
+            const wisdom = verdict === "PASS"
+                ? "AI commit PASSED all 5 axes — safe to merge."
+                : verdict === "WARN"
+                    ? "AI commit has WARNINGS — review the flagged axes before merging."
+                    : verdict === "FAIL"
+                        ? "AI commit FAILED — do NOT merge until issues are resolved. See findings array for details."
+                        : "Audit completed; check the data field for the verdict.";
+            return {
+                data,
+                wisdom,
+                followUp: verdict !== "PASS" ? ["mneme.audit.report", "mneme.forensics.vulns"] : [],
+                confidence: { level: "high" },
+            };
+        },
+    },
+    {
+        name: "mneme.audit.report",
+        category: "audit",
+        description: "Generate a Markdown audit-trail report (SOX / SOC2 / EU AI Act 2026 compliant) of the most recent AI session. " +
+            "Use this WHEN user asks: 'export audit report', 'compliance trail', 'markdown for the auditor'.",
+        triggers: [
+            "compliance audit report",
+            "markdown audit trail",
+            "export for SOC2",
+        ],
+        inputSchema: {
+            type: "object",
+            properties: {
+                outPath: { type: "string", description: "Where to write the markdown" },
+            },
+        },
+        handler: async (rt, args) => {
+            const cliArgs = ["--report"];
+            if (args["outPath"])
+                cliArgs.push("--out", String(args["outPath"]));
+            const data = await runCliJson(rt.meta.rootPath, "audit", cliArgs);
+            return {
+                data,
+                wisdom: `Markdown report generated. Compliance-ready for SOX / SOC2 / EU AI Act 2026.`,
+                followUp: [],
+                confidence: { level: "high" },
+            };
+        },
+    },
+    {
+        name: "mneme.audit.deps",
+        category: "audit",
+        description: "Cross-check this repo's dependencies against OSV.dev — known CVEs and GHSA advisories per package. " +
+            "Use this WHEN user asks: 'are our deps safe?', 'CVE scan', 'OSV check', 'security audit of dependencies', " +
+            "'do we have vulnerable packages?'.",
+        triggers: [
+            "scan dependencies for CVEs",
+            "OSV check",
+            "are our deps safe?",
+        ],
+        inputSchema: { type: "object", properties: {} },
+        handler: async (rt) => {
+            const data = await runCliJson(rt.meta.rootPath, "deps", ["audit"]);
+            const advisories = data?.advisories?.length ?? 0;
+            const wisdom = advisories === 0
+                ? "No known CVEs or GHSAs in current dependency tree."
+                : `${advisories} advisor${advisories === 1 ? "y" : "ies"} found across the dependency tree. Check the data.advisories array for severity + fixed-in versions.`;
+            return {
+                data,
+                wisdom,
+                followUp: advisories > 0 ? ["mneme.forensics.vulns"] : [],
+                confidence: { level: "high" },
+            };
+        },
+    },
+    {
+        name: "mneme.audit.conscience",
+        category: "audit",
+        description: "Risk-score a PR against the repo's own history of regrets, hotfixes, and reverts. " +
+            "Use this WHEN user asks: 'is this PR risky based on history?', 'conscience review of these files', " +
+            "'historical risk score for the changes'.",
+        triggers: [
+            "PR risk based on history",
+            "conscience review",
+            "ตรวจ PR ตามประวัติ",
+        ],
+        inputSchema: {
+            type: "object",
+            properties: {
+                files: { type: "array", items: { type: "string" }, description: "File paths to review" },
+                dualJury: { type: "boolean", description: "Run with dual-jury (more conservative)" },
+            },
+        },
+        handler: async (rt, args) => {
+            const files = args["files"] ?? [];
+            const cliArgs = files.length ? files : [];
+            if (args["dualJury"])
+                cliArgs.push("--dual-jury");
+            const data = await runCliJson(rt.meta.rootPath, "conscience", cliArgs);
+            const risk = data?.risk ?? "unknown";
+            const wisdom = `Conscience risk verdict: ${risk}. Based on similar past changes in this repo.`;
+            return {
+                data,
+                wisdom,
+                followUp: risk === "HIGH" ? ["mneme.insights.premortem", "mneme.audit.certify"] : [],
+                confidence: { level: "medium" },
+            };
+        },
+    },
+    {
+        name: "mneme.audit.ledger",
+        category: "audit",
+        description: "Tamper-evident audit log of all AI-driven commits with HMAC + Ed25519 signatures. SOX / SOC2 ready. " +
+            "Use this WHEN user asks: 'show audit log', 'tamper-evident trail', 'all AI sessions in this repo'.",
+        triggers: [
+            "audit log of AI sessions",
+            "tamper-evident trail",
+        ],
+        inputSchema: {
+            type: "object",
+            properties: {
+                since: { type: "string", description: "ISO date — only entries since" },
+            },
+        },
+        handler: async (rt, args) => {
+            const cliArgs = args["since"] ? ["--since", String(args["since"])] : [];
+            const data = await runCliJson(rt.meta.rootPath, "ledger", cliArgs);
+            return {
+                data,
+                wisdom: "Audit ledger entries returned. Each entry is HMAC-chained + Ed25519-signed for tamper-evidence.",
+                followUp: ["mneme.audit.report"],
+                confidence: { level: "high" },
+            };
+        },
+    },
+];
+//# sourceMappingURL=audit.js.map

package/dist/tools/audit.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"audit.js","sourceRoot":"","sources":["../../src/tools/audit.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAG3C,MAAM,CAAC,MAAM,UAAU,GAAgB;IACrC;QACE,IAAI,EAAE,sBAAsB;QAC5B,QAAQ,EAAE,OAAO;QACjB,WAAW,EACT,yGAAyG;YACzG,uFAAuF;YACvF,mHAAmH;QACrH,QAAQ,EAAE;YACR,0BAA0B;YAC1B,gBAAgB;YAChB,6BAA6B;SAC9B;QACD,WAAW,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,UAAU,EAAE,EAAE,EAAE;QAC/C,OAAO,EAAE,KAAK,EAAE,EAAE,EAAE,EAAE;YACpB,MAAM,IAAI,GAAG,MAAM,UAAU,CAAC,EAAE,CAAC,IAAI,CAAC,QAAQ,EAAE,OAAO,EAAE,CAAC,YAAY,CAAC,CAAC,CAAC;YACzE,OAAO;gBACL,IAAI;gBACJ,MAAM,EAAE,sGAAsG;gBAC9G,QAAQ,EAAE,CAAC,mBAAmB,EAAE,qBAAqB,CAAC;gBACtD,UAAU,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE;aAC9B,CAAC;QACJ,CAAC;KACF;IACD;QACE,IAAI,EAAE,mBAAmB;QACzB,QAAQ,EAAE,OAAO;QACjB,WAAW,EACT,6HAA6H;YAC7H,8HAA8H;QAChI,QAAQ,EAAE;YACR,yBAAyB;YACzB,2BAA2B;YAC3B,aAAa;SACd;QACD,WAAW,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,UAAU,EAAE,EAAE,EAAE;QAC/C,OAAO,EAAE,KAAK,EAAE,EAAE,EAAE,EAAE;YACpB,MAAM,IAAI,GAAG,MAAM,UAAU,CAAC,EAAE,CAAC,IAAI,CAAC,QAAQ,EAAE,OAAO,EAAE,CAAC,SAAS,CAAC,CAAC,CAAC;YACtE,OAAO;gBACL,IAAI;gBACJ,MAAM,EAAE,+GAA+G;gBACvH,QAAQ,EAAE,CAAC,oBAAoB,EAAE,qBAAqB,CAAC;gBACvD,UAAU,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE;aAC9B,CAAC;QACJ,CAAC;KACF;IACD;QACE,IAAI,EAAE,oBAAoB;QAC1B,QAAQ,EAAE,OAAO;QACjB,WAAW,EACT,oGAAoG;YACpG,wFAAwF;YACxF,oHAAoH;QACtH,QAAQ,EAAE;YACR,kBAAkB;YAClB,yBAAyB;YACzB,mBAAmB;SACpB;QACD,WAAW,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,UAAU,EAAE,EAAE,EAAE;QAC/C,OAAO,EAAE,KAAK,EAAE,EAAE,EAAE,EAAE;YACpB,MAAM,IAAI,GAAG,MAAM,UAAU,CAAC,EAAE,CAAC,IAAI,CAAC,QAAQ,EAAE,OAAO,EAAE,CAAC,UAAU,CAAC,CAAC,CAAC;YACvE,OAAO;gBACL,IAAI;gBACJ,MAAM,EAAE,qHAAqH;gBAC7H,QAAQ,EAAE,CAAC,qBAAqB,CAAC;gBACjC,UAAU,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE;aAC9B,CAAC;QACJ,CAAC;KACF;IACD;QACE,IAAI,EAAE,qBAAqB;QAC3B,QAAQ,EAAE,OAAO;QACjB,WAAW,EACT,wIAAwI;YACxI,yGAAyG;YACzG,uGAAuG;YACvG,oDAAoD;QACtD,QAAQ,EAAE;YACR,qBAAqB;YACrB,+BAA+B;YAC/B,mBAAmB;YACnB,eAAe;SAChB;QACD,WAAW,EAAE;YACX,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,OAAO,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,WAAW,EAAE,qCAAqC,EAAE;gBAChF,MAAM,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,WAAW,EAAE,8CAA8C,EAAE;aACzF;SACF;QACD,OAAO,EAAE,KAAK,EAAE,EAAE,EAAE,IAAI,EAAE,EAAE;YAC1B,MAAM,OAAO,GAAG,CAAC,WAAW,CAAC,CAAC;YAC9B,IAAI,IAAI,CAAC,SAAS,CAAC;gBAAE,OAAO,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;YAC/C,IAAI,IAAI,CAAC,QAAQ,CAAC;gBAAE,OAAO,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;YAC7C,MAAM,IAAI,GAAG,MAAM,UAAU,CAAC,EAAE,CAAC,IAAI,CAAC,QAAQ,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;YAClE,MAAM,OAAO,GAAI,IAA6B,EAAE,OAAO,IAAI,SAAS,CAAC;YACrE,MAAM,MAAM,GACV,OAAO,KAAK,MAAM;gBAChB,CAAC,CAAC,8CAA8C;gBAChD,CAAC,CAAC,OAAO,KAAK,MAAM;oBACpB,CAAC,CAAC,kEAAkE;oBACpE,CAAC,CAAC,OAAO,KAAK,MAAM;wBACpB,CAAC,CAAC,4FAA4F;wBAC9F,CAAC,CAAC,wDAAwD,CAAC;YAC/D,OAAO;gBACL,IAAI;gBACJ,MAAM;gBACN,QAAQ,EAAE,OAAO,KAAK,MAAM,CAAC,CAAC,CAAC,CAAC,oBAAoB,EAAE,uBAAuB,CAAC,CAAC,CAAC,CAAC,EAAE;gBACnF,UAAU,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE;aAC9B,CAAC;QACJ,CAAC;KACF;IACD;QACE,IAAI,EAAE,oBAAoB;QAC1B,QAAQ,EAAE,OAAO;QACjB,WAAW,EACT,gHAAgH;YAChH,iGAAiG;QACnG,QAAQ,EAAE;YACR,yBAAyB;YACzB,sBAAsB;YACtB,iBAAiB;SAClB;QACD,WAAW,EAAE;YACX,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,OAAO,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,6BAA6B,EAAE;aACxE;SACF;QACD,OAAO,EAAE,KAAK,EAAE,EAAE,EAAE,IAAI,EAAE,EAAE;YAC1B,MAAM,OAAO,GAAG,CAAC,UAAU,CAAC,CAAC;YAC7B,IAAI,IAAI,CAAC,SAAS,CAAC;gBAAE,OAAO,CAAC,IAAI,CAAC,OAAO,EAAE,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC;YACpE,MAAM,IAAI,GAAG,MAAM,UAAU,CAAC,EAAE,CAAC,IAAI,CAAC,QAAQ,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;YAClE,OAAO;gBACL,IAAI;gBACJ,MAAM,EAAE,8EAA8E;gBACtF,QAAQ,EAAE,EAAE;gBACZ,UAAU,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE;aAC9B,CAAC;QACJ,CAAC;KACF;IACD;QACE,IAAI,EAAE,kBAAkB;QACxB,QAAQ,EAAE,OAAO;QACjB,WAAW,EACT,qGAAqG;YACrG,4GAA4G;YAC5G,oCAAoC;QACtC,QAAQ,EAAE;YACR,4BAA4B;YAC5B,WAAW;YACX,oBAAoB;SACrB;QACD,WAAW,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,UAAU,EAAE,EAAE,EAAE;QAC/C,OAAO,EAAE,KAAK,EAAE,EAAE,EAAE,EAAE;YACpB,MAAM,IAAI,GAAG,MAAM,UAAU,CAAC,EAAE,CAAC,IAAI,CAAC,QAAQ,EAAE,MAAM,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC;YACnE,MAAM,UAAU,GAAI,IAAmC,EAAE,UAAU,EAAE,MAAM,IAAI,CAAC,CAAC;YACjF,MAAM,MAAM,GACV,UAAU,KAAK,CAAC;gBACd,CAAC,CAAC,oDAAoD;gBACtD,CAAC,CAAC,GAAG,UAAU,WAAW,UAAU,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,KAAK,sGAAsG,CAAC;YACnK,OAAO;gBACL,IAAI;gBACJ,MAAM;gBACN,QAAQ,EAAE,UAAU,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,uBAAuB,CAAC,CAAC,CAAC,CAAC,EAAE;gBACzD,UAAU,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE;aAC9B,CAAC;QACJ,CAAC;KACF;IACD;QACE,IAAI,EAAE,wBAAwB;QAC9B,QAAQ,EAAE,OAAO;QACjB,WAAW,EACT,oFAAoF;YACpF,qGAAqG;YACrG,0CAA0C;QAC5C,QAAQ,EAAE;YACR,0BAA0B;YAC1B,mBAAmB;YACnB,oBAAoB;SACrB;QACD,WAAW,EAAE;YACX,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,KAAK,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,WAAW,EAAE,sBAAsB,EAAE;gBACxF,QAAQ,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,WAAW,EAAE,wCAAwC,EAAE;aACrF;SACF;QACD,OAAO,EAAE,KAAK,EAAE,EAAE,EAAE,IAAI,EAAE,EAAE;YAC1B,MAAM,KAAK,GAAI,IAAI,CAAC,OAAO,CAAc,IAAI,EAAE,CAAC;YAChD,MAAM,OAAO,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;YAC1C,IAAI,IAAI,CAAC,UAAU,CAAC;gBAAE,OAAO,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;YAClD,MAAM,IAAI,GAAG,MAAM,UAAU,CAAC,EAAE,CAAC,IAAI,CAAC,QAAQ,EAAE,YAAY,EAAE,OAAO,CAAC,CAAC;YACvE,MAAM,IAAI,GAAI,IAA0B,EAAE,IAAI,IAAI,SAAS,CAAC;YAC5D,MAAM,MAAM,GAAG,4BAA4B,IAAI,+CAA+C,CAAC;YAC/F,OAAO;gBACL,IAAI;gBACJ,MAAM;gBACN,QAAQ,EAAE,IAAI,KAAK,MAAM,CAAC,CAAC,CAAC,CAAC,0BAA0B,EAAE,qBAAqB,CAAC,CAAC,CAAC,CAAC,EAAE;gBACpF,UAAU,EAAE,EAAE,KAAK,EAAE,QAAQ,EAAE;aAChC,CAAC;QACJ,CAAC;KACF;IACD;QACE,IAAI,EAAE,oBAAoB;QAC1B,QAAQ,EAAE,OAAO;QACjB,WAAW,EACT,sGAAsG;YACtG,oGAAoG;QACtG,QAAQ,EAAE;YACR,0BAA0B;YAC1B,sBAAsB;SACvB;QACD,WAAW,EAAE;YACX,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,+BAA+B,EAAE;aACxE;SACF;QACD,OAAO,EAAE,KAAK,EAAE,EAAE,EAAE,IAAI,EAAE,EAAE;YAC1B,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,EAAE,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;YACxE,MAAM,IAAI,GAAG,MAAM,UAAU,CAAC,EAAE,CAAC,IAAI,CAAC,QAAQ,EAAE,QAAQ,EAAE,OAAO,CAAC,CAAC;YACnE,OAAO;gBACL,IAAI;gBACJ,MAAM,EAAE,iGAAiG;gBACzG,QAAQ,EAAE,CAAC,oBAAoB,CAAC;gBAChC,UAAU,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE;aAC9B,CAAC;QACJ,CAAC;KACF;CACF,CAAC"}

package/dist/tools/forensics.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Forensics — applied forensic science for code: Bayesian author attribution,
+ * stack-aware vuln hunt, insider-threat anomaly, ENFSI verbal scale.
+ */
+import type { MnemeTool } from "./_types.js";
+export declare const forensicsTools: MnemeTool[];
+//# sourceMappingURL=forensics.d.ts.map

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

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