@mneme-ai/mcp 1.1.1 → 1.2.0

package/dist/tools/forensics.js

@@ -0,0 +1,189 @@
+/**
+ * Forensics — applied forensic science for code: Bayesian author attribution,
+ * stack-aware vuln hunt, insider-threat anomaly, ENFSI verbal scale.
+ */
+import { runCliJson } from "./_runtime.js";
+export const forensicsTools = [
+    {
+        name: "mneme.forensics.vulns",
+        category: "forensics",
+        description: "Scan git history for security holes (51 patterns across SQL injection, XSS, hardcoded secrets, XXE, SSRF, " +
+            "auth bypass, CSRF, etc.). Each finding is Bayesian-filtered: posterior = stack-prior × AST-evidence, so non-applicable " +
+            "rules are dropped before they leave the scanner. " +
+            "Use this WHEN user asks: 'find security issues', 'vuln scan', 'CWE check', 'what security holes are hiding?'.",
+        triggers: [
+            "find security issues",
+            "vulnerability scan",
+            "หา bug ความปลอดภัย",
+            "scan for SQL injection",
+        ],
+        inputSchema: {
+            type: "object",
+            properties: {
+                top: { type: "number", description: "Top N findings (default 50)" },
+                minPosterior: { type: "number", description: "Minimum posterior threshold (default 0.3)" },
+            },
+        },
+        handler: async (rt, args) => {
+            const cliArgs = [];
+            if (args["top"])
+                cliArgs.push("--top", String(args["top"]));
+            if (args["minPosterior"])
+                cliArgs.push("--min-posterior", String(args["minPosterior"]));
+            const data = await runCliJson(rt.meta.rootPath, "forensics vulns", cliArgs);
+            const findings = data?.findings?.length ?? 0;
+            const wisdom = findings === 0
+                ? "No vulnerabilities surfaced above the posterior threshold. Clean."
+                : `${findings} candidate vulnerabilit${findings === 1 ? "y" : "ies"} surfaced. Each is a CANDIDATE for human review — verify before action.`;
+            return {
+                data,
+                wisdom,
+                followUp: findings > 0 ? ["mneme.forensics.show", "mneme.forensics.suppress"] : [],
+                confidence: { level: "medium", notes: "Findings are heuristic — Bayesian-filtered but always verify before treating as confirmed." },
+            };
+        },
+    },
+    {
+        name: "mneme.forensics.anomaly",
+        category: "forensics",
+        description: "Insider-threat / credential-compromise detector: flag commits whose timing, file footprint, or style deviates " +
+            "from the author's baseline. Use this WHEN user asks: 'any suspicious commits?', 'insider threat scan', " +
+            "'is this account compromised?', 'unusual commits'.",
+        triggers: [
+            "any suspicious commits?",
+            "insider threat scan",
+            "compromised account check",
+        ],
+        inputSchema: { type: "object", properties: {} },
+        handler: async (rt) => {
+            const data = await runCliJson(rt.meta.rootPath, "forensics anomaly");
+            const flagged = data?.anomalies?.length ?? 0;
+            const wisdom = flagged === 0
+                ? "No anomalies detected — all commits match author baselines."
+                : `${flagged} suspicious commit${flagged === 1 ? "" : "s"} flagged. Each deviates from the author's normal pattern (timing, files, or style).`;
+            return {
+                data,
+                wisdom,
+                followUp: flagged > 0 ? ["mneme.forensics.match", "mneme.forensics.attribute"] : [],
+                confidence: { level: "medium", notes: "Anomaly ≠ proof of malice. Treat as 'investigate', not 'accuse'." },
+            };
+        },
+    },
+    {
+        name: "mneme.forensics.match",
+        category: "forensics",
+        description: "Likelihood-ratio test: 'Did Alice REALLY write this commit?'. Returns ENFSI verbal-scale verdict + LR. " +
+            "Use this WHEN user asks: 'is this commit really by X?', 'verify authorship', 'did Alice write a3f9b21?'.",
+        triggers: [
+            "did Alice write this commit?",
+            "verify commit authorship",
+            "ตรวจสอบ author จริงๆ",
+        ],
+        inputSchema: {
+            type: "object",
+            properties: {
+                commit: { type: "string", description: "Commit hash or HEAD-relative ref" },
+                author: { type: "string", description: "Suspected author email" },
+            },
+            required: ["commit", "author"],
+        },
+        handler: async (rt, args) => {
+            const data = await runCliJson(rt.meta.rootPath, "forensics match", [String(args["commit"]), String(args["author"])]);
+            const verdict = data?.verdict ?? "?";
+            const wisdom = `ENFSI verdict: ${verdict}. Likelihood ratio shown in data.lr. Higher LR = stronger evidence FOR the claimed author.`;
+            return {
+                data,
+                wisdom,
+                followUp: ["mneme.forensics.attribute"],
+                confidence: { level: "medium", notes: "Stylometric matching, not cryptographic proof." },
+            };
+        },
+    },
+    {
+        name: "mneme.forensics.attribute",
+        category: "forensics",
+        description: "Rank ALL candidate authors for a commit by stylometric likelihood. " +
+            "Use this WHEN user asks: 'who most likely wrote this?', 'attribute this commit', 'authorship ranking'.",
+        triggers: [
+            "who most likely wrote this commit?",
+            "attribute this commit",
+        ],
+        inputSchema: {
+            type: "object",
+            properties: {
+                commit: { type: "string", description: "Commit hash or HEAD-relative ref (default HEAD)" },
+            },
+        },
+        handler: async (rt, args) => {
+            const cliArgs = args["commit"] ? [String(args["commit"])] : [];
+            const data = await runCliJson(rt.meta.rootPath, "forensics attribute", cliArgs);
+            const top = data?.ranking?.[0];
+            const wisdom = top
+                ? `Most likely author: ${top.author} (likelihood ratio ${top.lr.toFixed(2)}). Full ranking in data.ranking.`
+                : "No candidates ranked.";
+            return {
+                data,
+                wisdom,
+                followUp: top ? ["mneme.forensics.match"] : [],
+                confidence: { level: "medium" },
+            };
+        },
+    },
+    {
+        name: "mneme.forensics.show",
+        category: "forensics",
+        description: "Open a single forensics finding by ID — full context, the line of code, recommended fix. " +
+            "Use this WHEN user wants to dig into a specific finding from `mneme.forensics.vulns`.",
+        triggers: [
+            "show finding 988c6155",
+            "details of this vuln",
+        ],
+        inputSchema: {
+            type: "object",
+            properties: {
+                id: { type: "string", description: "Finding ID from vulns scan" },
+            },
+            required: ["id"],
+        },
+        handler: async (rt, args) => {
+            const data = await runCliJson(rt.meta.rootPath, "show", [String(args["id"])]);
+            return {
+                data,
+                wisdom: "Finding context loaded. The data includes file/line, code excerpt, CWE, and any recommended fix.",
+                followUp: ["mneme.forensics.suppress"],
+                confidence: { level: "high" },
+            };
+        },
+    },
+    {
+        name: "mneme.forensics.suppress",
+        category: "forensics",
+        description: "Mark a finding as a false positive — won't appear in future scans. Saved to .mneme/suppressions.json. " +
+            "Use this WHEN user has reviewed a finding and confirmed it's not a real issue.",
+        triggers: [
+            "suppress this finding",
+            "mark as false positive",
+        ],
+        inputSchema: {
+            type: "object",
+            properties: {
+                id: { type: "string", description: "Finding ID" },
+                reason: { type: "string", description: "Why this is a false positive" },
+            },
+            required: ["id"],
+        },
+        handler: async (rt, args) => {
+            const cliArgs = [String(args["id"])];
+            if (args["reason"])
+                cliArgs.push("--reason", String(args["reason"]));
+            const data = await runCliJson(rt.meta.rootPath, "suppress", cliArgs);
+            return {
+                data,
+                wisdom: `Finding suppressed. Future scans will skip it.`,
+                followUp: [],
+                confidence: { level: "high" },
+            };
+        },
+    },
+];
+//# sourceMappingURL=forensics.js.map

package/dist/tools/forensics.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"forensics.js","sourceRoot":"","sources":["../../src/tools/forensics.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAG3C,MAAM,CAAC,MAAM,cAAc,GAAgB;IACzC;QACE,IAAI,EAAE,uBAAuB;QAC7B,QAAQ,EAAE,WAAW;QACrB,WAAW,EACT,4GAA4G;YAC5G,yHAAyH;YACzH,mDAAmD;YACnD,+GAA+G;QACjH,QAAQ,EAAE;YACR,sBAAsB;YACtB,oBAAoB;YACpB,oBAAoB;YACpB,wBAAwB;SACzB;QACD,WAAW,EAAE;YACX,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,GAAG,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,6BAA6B,EAAE;gBACnE,YAAY,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,2CAA2C,EAAE;aAC3F;SACF;QACD,OAAO,EAAE,KAAK,EAAE,EAAE,EAAE,IAAI,EAAE,EAAE;YAC1B,MAAM,OAAO,GAAa,EAAE,CAAC;YAC7B,IAAI,IAAI,CAAC,KAAK,CAAC;gBAAE,OAAO,CAAC,IAAI,CAAC,OAAO,EAAE,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;YAC5D,IAAI,IAAI,CAAC,cAAc,CAAC;gBAAE,OAAO,CAAC,IAAI,CAAC,iBAAiB,EAAE,MAAM,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC;YACxF,MAAM,IAAI,GAAG,MAAM,UAAU,CAAC,EAAE,CAAC,IAAI,CAAC,QAAQ,EAAE,iBAAiB,EAAE,OAAO,CAAC,CAAC;YAC5E,MAAM,QAAQ,GAAI,IAAiC,EAAE,QAAQ,EAAE,MAAM,IAAI,CAAC,CAAC;YAC3E,MAAM,MAAM,GACV,QAAQ,KAAK,CAAC;gBACZ,CAAC,CAAC,mEAAmE;gBACrE,CAAC,CAAC,GAAG,QAAQ,0BAA0B,QAAQ,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,KAAK,yEAAyE,CAAC;YACjJ,OAAO;gBACL,IAAI;gBACJ,MAAM;gBACN,QAAQ,EAAE,QAAQ,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,sBAAsB,EAAE,0BAA0B,CAAC,CAAC,CAAC,CAAC,EAAE;gBAClF,UAAU,EAAE,EAAE,KAAK,EAAE,QAAQ,EAAE,KAAK,EAAE,4FAA4F,EAAE;aACrI,CAAC;QACJ,CAAC;KACF;IACD;QACE,IAAI,EAAE,yBAAyB;QAC/B,QAAQ,EAAE,WAAW;QACrB,WAAW,EACT,gHAAgH;YAChH,yGAAyG;YACzG,oDAAoD;QACtD,QAAQ,EAAE;YACR,yBAAyB;YACzB,qBAAqB;YACrB,2BAA2B;SAC5B;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,mBAAmB,CAAC,CAAC;YACrE,MAAM,OAAO,GAAI,IAAkC,EAAE,SAAS,EAAE,MAAM,IAAI,CAAC,CAAC;YAC5E,MAAM,MAAM,GACV,OAAO,KAAK,CAAC;gBACX,CAAC,CAAC,6DAA6D;gBAC/D,CAAC,CAAC,GAAG,OAAO,qBAAqB,OAAO,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,qFAAqF,CAAC;YACnJ,OAAO;gBACL,IAAI;gBACJ,MAAM;gBACN,QAAQ,EAAE,OAAO,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,uBAAuB,EAAE,2BAA2B,CAAC,CAAC,CAAC,CAAC,EAAE;gBACnF,UAAU,EAAE,EAAE,KAAK,EAAE,QAAQ,EAAE,KAAK,EAAE,kEAAkE,EAAE;aAC3G,CAAC;QACJ,CAAC;KACF;IACD;QACE,IAAI,EAAE,uBAAuB;QAC7B,QAAQ,EAAE,WAAW;QACrB,WAAW,EACT,yGAAyG;YACzG,0GAA0G;QAC5G,QAAQ,EAAE;YACR,8BAA8B;YAC9B,0BAA0B;YAC1B,sBAAsB;SACvB;QACD,WAAW,EAAE;YACX,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,kCAAkC,EAAE;gBAC3E,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,wBAAwB,EAAE;aAClE;YACD,QAAQ,EAAE,CAAC,QAAQ,EAAE,QAAQ,CAAC;SAC/B;QACD,OAAO,EAAE,KAAK,EAAE,EAAE,EAAE,IAAI,EAAE,EAAE;YAC1B,MAAM,IAAI,GAAG,MAAM,UAAU,CAAC,EAAE,CAAC,IAAI,CAAC,QAAQ,EAAE,iBAAiB,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC;YACrH,MAAM,OAAO,GAAI,IAA6B,EAAE,OAAO,IAAI,GAAG,CAAC;YAC/D,MAAM,MAAM,GAAG,kBAAkB,OAAO,4FAA4F,CAAC;YACrI,OAAO;gBACL,IAAI;gBACJ,MAAM;gBACN,QAAQ,EAAE,CAAC,2BAA2B,CAAC;gBACvC,UAAU,EAAE,EAAE,KAAK,EAAE,QAAQ,EAAE,KAAK,EAAE,gDAAgD,EAAE;aACzF,CAAC;QACJ,CAAC;KACF;IACD;QACE,IAAI,EAAE,2BAA2B;QACjC,QAAQ,EAAE,WAAW;QACrB,WAAW,EACT,qEAAqE;YACrE,wGAAwG;QAC1G,QAAQ,EAAE;YACR,oCAAoC;YACpC,uBAAuB;SACxB;QACD,WAAW,EAAE;YACX,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,iDAAiD,EAAE;aAC3F;SACF;QACD,OAAO,EAAE,KAAK,EAAE,EAAE,EAAE,IAAI,EAAE,EAAE;YAC1B,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;YAC/D,MAAM,IAAI,GAAG,MAAM,UAAU,CAAC,EAAE,CAAC,IAAI,CAAC,QAAQ,EAAE,qBAAqB,EAAE,OAAO,CAAC,CAAC;YAChF,MAAM,GAAG,GAAI,IAA4D,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,CAAC;YACxF,MAAM,MAAM,GAAG,GAAG;gBAChB,CAAC,CAAC,uBAAuB,GAAG,CAAC,MAAM,sBAAsB,GAAG,CAAC,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC,kCAAkC;gBAC5G,CAAC,CAAC,uBAAuB,CAAC;YAC5B,OAAO;gBACL,IAAI;gBACJ,MAAM;gBACN,QAAQ,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC,uBAAuB,CAAC,CAAC,CAAC,CAAC,EAAE;gBAC9C,UAAU,EAAE,EAAE,KAAK,EAAE,QAAQ,EAAE;aAChC,CAAC;QACJ,CAAC;KACF;IACD;QACE,IAAI,EAAE,sBAAsB;QAC5B,QAAQ,EAAE,WAAW;QACrB,WAAW,EACT,2FAA2F;YAC3F,uFAAuF;QACzF,QAAQ,EAAE;YACR,uBAAuB;YACvB,sBAAsB;SACvB;QACD,WAAW,EAAE;YACX,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,EAAE,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,4BAA4B,EAAE;aAClE;YACD,QAAQ,EAAE,CAAC,IAAI,CAAC;SACjB;QACD,OAAO,EAAE,KAAK,EAAE,EAAE,EAAE,IAAI,EAAE,EAAE;YAC1B,MAAM,IAAI,GAAG,MAAM,UAAU,CAAC,EAAE,CAAC,IAAI,CAAC,QAAQ,EAAE,MAAM,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;YAC9E,OAAO;gBACL,IAAI;gBACJ,MAAM,EAAE,kGAAkG;gBAC1G,QAAQ,EAAE,CAAC,0BAA0B,CAAC;gBACtC,UAAU,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE;aAC9B,CAAC;QACJ,CAAC;KACF;IACD;QACE,IAAI,EAAE,0BAA0B;QAChC,QAAQ,EAAE,WAAW;QACrB,WAAW,EACT,wGAAwG;YACxG,gFAAgF;QAClF,QAAQ,EAAE;YACR,uBAAuB;YACvB,wBAAwB;SACzB;QACD,WAAW,EAAE;YACX,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,EAAE,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,YAAY,EAAE;gBACjD,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,8BAA8B,EAAE;aACxE;YACD,QAAQ,EAAE,CAAC,IAAI,CAAC;SACjB;QACD,OAAO,EAAE,KAAK,EAAE,EAAE,EAAE,IAAI,EAAE,EAAE;YAC1B,MAAM,OAAO,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YACrC,IAAI,IAAI,CAAC,QAAQ,CAAC;gBAAE,OAAO,CAAC,IAAI,CAAC,UAAU,EAAE,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;YACrE,MAAM,IAAI,GAAG,MAAM,UAAU,CAAC,EAAE,CAAC,IAAI,CAAC,QAAQ,EAAE,UAAU,EAAE,OAAO,CAAC,CAAC;YACrE,OAAO;gBACL,IAAI;gBACJ,MAAM,EAAE,gDAAgD;gBACxD,QAAQ,EAAE,EAAE;gBACZ,UAAU,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE;aAC9B,CAAC;QACJ,CAAC;KACF;CACF,CAAC"}

package/dist/tools/insights.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Insights — applied storytelling, regret-mining, and prediction over git history.
+ * 24 tools that surface narrative, friction, and risk patterns the user can act on.
+ */
+import type { MnemeTool } from "./_types.js";
+export declare const insightsTools: MnemeTool[];
+//# sourceMappingURL=insights.d.ts.map

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

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

package/dist/tools/insights.js

@@ -0,0 +1,40 @@
+/**
+ * Insights — applied storytelling, regret-mining, and prediction over git history.
+ * 24 tools that surface narrative, friction, and risk patterns the user can act on.
+ */
+import { passthroughHandler } from "./_runtime.js";
+const passthrough = (name, description, triggers, cli, argMap = () => [], inputSchema = { type: "object", properties: {} }, followUp = [], wisdom = () => "Result returned — summarize key fields for the user.") => ({
+    name,
+    category: "insights",
+    description,
+    triggers,
+    inputSchema,
+    handler: passthroughHandler(cli, argMap, { wisdom, followUp, confidence: "medium" }),
+});
+export const insightsTools = [
+    passthrough("mneme.insights.ghost", "Half-finished features and stale TODOs haunting the repo — files born and forgotten. Use WHEN user asks: 'what is haunting my repo?', 'ghost code', 'half-finished features'.", ["ghost code", "half-finished features", "stale TODOs"], "ghost", (a) => (a["topN"] ? ["--top", String(a["topN"])] : []), { type: "object", properties: { topN: { type: "number" } } }, ["mneme.insights.runaway", "mneme.insights.fossil"], (d) => `Found ${d?.ghosts?.length ?? 0} ghost files. Each is born + forgotten — review for deletion.`),
+    passthrough("mneme.insights.regret", "Commits that were shipped and immediately fixed/reverted — instant-regret detector. Use WHEN user asks: 'what did we ship and regret?', 'recent reverts/hotfixes'.", ["shipped and regretted", "recent reverts"], "regret", (a) => (a["windowDays"] ? ["--window-days", String(a["windowDays"])] : []), { type: "object", properties: { windowDays: { type: "number" } } }, ["mneme.insights.premortem", "mneme.audit.conscience"], (d) => `${d?.regrets?.length ?? 0} regrets found. Use to identify recurring failure patterns.`),
+    passthrough("mneme.insights.paradox", "Architectural flip-flops — A→B→A decisions over time. Use WHEN user asks: 'have we changed our minds repeatedly?', 'architectural paradoxes'.", ["architectural flip-flops", "decisions reversed"], "paradox", () => [], { type: "object", properties: {} }, ["mneme.insights.decisions"]),
+    passthrough("mneme.insights.oracle", "Predict next-window co-edits + author collisions on the same file. Use WHEN user asks: 'who will edit X next?', 'predict collisions'.", ["predict next edits", "author collisions"], "oracle", () => [], { type: "object", properties: {} }),
+    passthrough("mneme.insights.premortem", "Predict regret risk for a proposed change, grounded in similar past attempts. Use WHEN user asks: 'will this be regretted?', 'risk of doing X', 'pre-mortem'.", ["pre-mortem of this change", "predict regret"], "premortem", (a) => (a["intent"] ? [String(a["intent"])] : []), { type: "object", properties: { intent: { type: "string", description: "Proposed change in plain English" } }, required: ["intent"] }, ["mneme.audit.conscience", "mneme.memory.blast"], (d) => `Pre-mortem verdict in data.risk. Top historical analogues in data.precedents.`),
+    passthrough("mneme.insights.time_machine", "Tell a file's life as eras: birth → rewrite → firefight → plateau → evolution. Use WHEN user asks: 'tell me the story of this file', 'evolution of src/auth.ts'.", ["story of this file", "file evolution"], "time-machine", (a) => [String(a["file"])], { type: "object", properties: { file: { type: "string" } }, required: ["file"] }, ["mneme.insights.story", "mneme.people.lineage"]),
+    passthrough("mneme.insights.story", "Narrate the evolution of a topic across acts (with optional LLM polish). Use WHEN user asks: 'how did X evolve?', 'history of payments'.", ["how did X evolve", "story of feature"], "story", (a) => [String(a["topic"])], { type: "object", properties: { topic: { type: "string" } }, required: ["topic"] }, ["mneme.insights.chronicle"]),
+    passthrough("mneme.insights.decisions", "Auto-extract architectural decisions (ADRs) from commit history. Use WHEN user asks: 'list our ADRs', 'architectural decisions'.", ["ADR list", "architectural decisions"], "decisions", () => [], { type: "object", properties: {} }, ["mneme.insights.story", "mneme.insights.paradox"]),
+    passthrough("mneme.insights.mirror", "Onboarding dossier on a topic: 5 PRs, 3 people, 2 incidents. Use WHEN user asks: 'onboard me on payments', 'mirror for new hire on X'.", ["onboarding on payments", "mirror dossier"], "mirror", (a) => [String(a["topic"])], { type: "object", properties: { topic: { type: "string" } }, required: ["topic"] }, ["mneme.people.who_knows", "mneme.insights.story"]),
+    passthrough("mneme.insights.rumor", "Tribal phrases mentioned in commits/PRs but never documented. Use WHEN user asks: 'what slang does our team use?', 'undocumented terms'.", ["tribal slang", "undocumented terms"], "rumor", () => [], { type: "object", properties: {} }),
+    passthrough("mneme.insights.fossil", "Files deleted from HEAD but still alive in git history. Use WHEN user asks: 'show deleted files', 'ghost code from history'.", ["deleted files in history", "fossils"], "fossil", () => [], { type: "object", properties: {} }, ["mneme.insights.ghost"]),
+    passthrough("mneme.insights.runaway", "Files growing silently across many commits — leak indicator. Use WHEN user asks: 'files growing silently', 'scope creep'.", ["files growing silently", "scope creep"], "runaway", () => [], { type: "object", properties: {} }, ["mneme.insights.ghost"]),
+    passthrough("mneme.insights.drift", "Topical drift — features → refactors → firefights → polish over time. Use WHEN user asks: 'what's our work pattern?', 'topical drift'.", ["topical drift", "work pattern over time"], "drift", () => [], { type: "object", properties: {} }),
+    passthrough("mneme.insights.chronicle", "Auto-generate a chaptered narrative documentary of the whole repo. Use WHEN user asks: 'documentary of our repo', 'chronicle'.", ["documentary of repo", "chronicle"], "chronicle", () => [], { type: "object", properties: {} }, ["mneme.insights.story"]),
+    passthrough("mneme.insights.constellation", "Graph view: files as stars, authors as orbitals, commits as edges. Use WHEN user asks: 'visualize our repo', 'star map'.", ["constellation view", "visual repo map"], "constellation", () => [], { type: "object", properties: {} }),
+    passthrough("mneme.insights.cluster", "Find topic islands — semantic clustering of commit messages. Use WHEN user asks: 'group commits by topic', 'topic clusters'.", ["topic clusters", "group commits"], "cluster", () => [], { type: "object", properties: {} }),
+    passthrough("mneme.insights.network", "Author network — who collaborates with whom (co-edit + co-time + co-topic). Use WHEN user asks: 'collaboration graph', 'who works with whom'.", ["collaboration graph", "author network"], "network", () => [], { type: "object", properties: {} }, ["mneme.people.telepathy", "mneme.people.nemesis"]),
+    passthrough("mneme.insights.manage", "Engineering management dashboard — health, succession, skill matrix, trajectory. Use WHEN user asks: 'manager dashboard', 'team health for VP'.", ["manager dashboard", "team health summary"], "manage", () => [], { type: "object", properties: {} }, ["mneme.people.nervous_system"]),
+    passthrough("mneme.insights.export_bundle", "One bundle: DNA + drift + chronicle + oracle + constellation + clusters + network + manage + ghost. Use WHEN user asks: 'export everything', 'full repo bundle'.", ["export full bundle", "everything in one file"], "export-bundle", () => [], { type: "object", properties: {} }),
+    passthrough("mneme.insights.dream", "Speculative ideas grounded in the codebase's own patterns. Use WHEN user asks: 'what should we build next?', 'speculative ideas'.", ["speculative ideas", "what should we build next"], "dream", () => [], { type: "object", properties: {} }),
+    passthrough("mneme.insights.echo", "Find past incidents resembling the current one. Use WHEN user asks: 'has this happened before?', 'similar past incidents'.", ["has this happened before", "similar past incidents"], "echo", (a) => (a["query"] ? ["--query", String(a["query"])] : []), { type: "object", properties: { query: { type: "string" } } }),
+    passthrough("mneme.insights.stack_trace", "Paste a stack trace, get historical context per frame. Use WHEN user asks: 'explain this stack trace', 'historical context for error'.", ["explain stack trace", "historical context per frame"], "stack-trace", () => [], { type: "object", properties: { from: { type: "string", description: "Path to error log" } } }),
+    passthrough("mneme.insights.commit_coach", "Pre-commit AI partner — message, reviewers, scope, past warnings. Use WHEN user asks: 'review my staged commit', 'commit coach'.", ["pre-commit review", "commit coach"], "commit-coach", () => [], { type: "object", properties: {} }),
+    passthrough("mneme.insights.crystal_ball", "Predict CI / follow-up failure probability before pushing. Use WHEN user asks: 'will CI fail?', 'crystal ball'.", ["will CI fail?", "predict push outcome"], "crystal-ball", () => [], { type: "object", properties: {} }, ["mneme.audit.certify"]),
+];
+//# sourceMappingURL=insights.js.map

package/dist/tools/insights.js.map

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

package/dist/tools/lab.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Lab — the Periodic Table + Second Brain + Wisdom Mutant engine.
+ * Compose, library, run, calibrate, adapt, feedback.
+ */
+import type { MnemeTool } from "./_types.js";
+export declare const labTools: MnemeTool[];
+//# sourceMappingURL=lab.d.ts.map

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

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

package/dist/tools/lab.js

@@ -0,0 +1,93 @@
+/**
+ * Lab — the Periodic Table + Second Brain + Wisdom Mutant engine.
+ * Compose, library, run, calibrate, adapt, feedback.
+ */
+import { passthroughHandler } from "./_runtime.js";
+const lab = (name, description, triggers, cli, argMap = () => [], inputSchema = { type: "object", properties: {} }, followUp = [], wisdom = () => "Result returned — summarize key fields for the user.") => ({
+    name,
+    category: "lab",
+    description,
+    triggers,
+    inputSchema,
+    handler: passthroughHandler(cli, argMap, { wisdom, followUp, confidence: "medium" }),
+});
+export const labTools = [
+    lab("mneme.lab.periodic_table", "Browse Mneme's compositional layers — elements (primitives), atoms (parameterized), molecules (commands), compounds. Use WHEN user asks: 'what primitives does Mneme have?', 'show the periodic table', 'compose new tools'.", ["show periodic table", "what primitives are available"], "periodic-table", (a) => {
+        const out = [];
+        if (a["id"])
+            out.push(String(a["id"]));
+        if (a["kind"])
+            out.push("--kind", String(a["kind"]));
+        if (a["tag"])
+            out.push("--tag", String(a["tag"]));
+        return out;
+    }, {
+        type: "object",
+        properties: {
+            id: { type: "string", description: "Optional primitive id to focus" },
+            kind: { type: "string", description: "element | atom | molecule | compound" },
+            tag: { type: "string" },
+        },
+    }),
+    lab("mneme.lab.compose", "Translate natural-language intent into a runnable molecule plan from the periodic table. Use WHEN user asks: 'compose a workflow for X', 'plan steps to do Y'.", ["compose a workflow", "plan steps for goal"], "compose", (a) => {
+        const out = [String(a["intent"] ?? "")];
+        if (a["execute"])
+            out.push("--execute");
+        return out;
+    }, {
+        type: "object",
+        properties: {
+            intent: { type: "string", description: "Natural-language goal" },
+            execute: { type: "boolean", description: "Run the plan after composing" },
+        },
+        required: ["intent"],
+    }, ["mneme.lab.run", "mneme.lab.library"]),
+    lab("mneme.lab.run", "Run a saved molecule plan by alias or id. Use WHEN user asks: 'run X recipe', 'execute saved plan'.", ["run saved recipe", "execute molecule plan"], "run", (a) => {
+        const out = [String(a["needle"] ?? "")];
+        if (a["execute"])
+            out.push("--execute");
+        return out;
+    }, {
+        type: "object",
+        properties: {
+            needle: { type: "string", description: "Alias or id of the recipe" },
+            execute: { type: "boolean", description: "Actually run (default dry-run)" },
+        },
+        required: ["needle"],
+    }),
+    lab("mneme.lab.library", "List/manage saved molecule recipes. Use WHEN user asks: 'show saved recipes', 'promote a recipe', 'forget recipe'.", ["show saved recipes", "library of plans"], "library", (a) => {
+        const out = [];
+        if (a["promote"])
+            out.push("--promote", String(a["promote"]));
+        if (a["alias"])
+            out.push("--alias", String(a["alias"]));
+        if (a["eligible"])
+            out.push("--eligible");
+        if (a["archived"])
+            out.push("--archived");
+        if (a["forget"])
+            out.push("--forget", String(a["forget"]));
+        return out;
+    }, {
+        type: "object",
+        properties: {
+            promote: { type: "string" },
+            alias: { type: "string" },
+            eligible: { type: "boolean" },
+            archived: { type: "boolean" },
+            forget: { type: "string" },
+        },
+    }),
+    lab("mneme.lab.adapt", "Mneme inspects this repo and recommends 1-3 next commands. Use WHEN user asks: 'what should I run next?', 'recommend commands for me'.", ["what should I run next", "recommend commands"], "adapt"),
+    lab("mneme.lab.feedback", "Tell Mneme an answer was helpful (up) or wrong (down) — feeds the Wisdom Mutant calibrator. Use WHEN user gives feedback on a previous answer.", ["this answer was good/bad", "feedback on previous result"], "feedback", (a) => [String(a["id"] ?? ""), String(a["vote"] ?? "")], {
+        type: "object",
+        properties: {
+            id: { type: "string", description: "Answer id from a previous call" },
+            vote: { type: "string", description: "up | down" },
+        },
+        required: ["id", "vote"],
+    }),
+    lab("mneme.lab.calibrate", "Re-tune search knobs against accumulated feedback. Use WHEN user asks: 'recalibrate Mneme', 're-tune search'.", ["recalibrate Mneme", "retune"], "calibrate"),
+    lab("mneme.lab.htc_stats", "Coverage + compression ratio of HTC (hierarchical compressed memory) — how much of the repo is summarised. Use WHEN user asks: 'HTC coverage', 'compression stats'.", ["HTC coverage", "compression stats"], "htc-stats"),
+];
+//# sourceMappingURL=lab.js.map

package/dist/tools/lab.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lab.js","sourceRoot":"","sources":["../../src/tools/lab.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AAGnD,MAAM,GAAG,GAAG,CACV,IAAY,EACZ,WAAmB,EACnB,QAAkB,EAClB,GAAW,EACX,SAAmD,GAAG,EAAE,CAAC,EAAE,EAC3D,cAAwC,EAAE,IAAI,EAAE,QAAQ,EAAE,UAAU,EAAE,EAAE,EAAE,EAC1E,WAAqB,EAAE,EACvB,SAAiC,GAAG,EAAE,CAAC,sDAAsD,EAClF,EAAE,CAAC,CAAC;IACf,IAAI;IACJ,QAAQ,EAAE,KAAK;IACf,WAAW;IACX,QAAQ;IACR,WAAW;IACX,OAAO,EAAE,kBAAkB,CAAC,GAAG,EAAE,MAAM,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,UAAU,EAAE,QAAQ,EAAE,CAAC;CACrF,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,QAAQ,GAAgB;IACnC,GAAG,CACD,0BAA0B,EAC1B,8NAA8N,EAC9N,CAAC,qBAAqB,EAAE,+BAA+B,CAAC,EACxD,gBAAgB,EAChB,CAAC,CAAC,EAAE,EAAE;QACJ,MAAM,GAAG,GAAa,EAAE,CAAC;QACzB,IAAI,CAAC,CAAC,IAAI,CAAC;YAAE,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACvC,IAAI,CAAC,CAAC,MAAM,CAAC;YAAE,GAAG,CAAC,IAAI,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;QACrD,IAAI,CAAC,CAAC,KAAK,CAAC;YAAE,GAAG,CAAC,IAAI,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;QAClD,OAAO,GAAG,CAAC;IACb,CAAC,EACD;QACE,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,EAAE,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,gCAAgC,EAAE;YACrE,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,sCAAsC,EAAE;YAC7E,GAAG,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;SACxB;KACF,CACF;IACD,GAAG,CACD,mBAAmB,EACnB,gKAAgK,EAChK,CAAC,oBAAoB,EAAE,qBAAqB,CAAC,EAC7C,SAAS,EACT,CAAC,CAAC,EAAE,EAAE;QACJ,MAAM,GAAG,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;QACxC,IAAI,CAAC,CAAC,SAAS,CAAC;YAAE,GAAG,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;QACxC,OAAO,GAAG,CAAC;IACb,CAAC,EACD;QACE,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,uBAAuB,EAAE;YAChE,OAAO,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,WAAW,EAAE,8BAA8B,EAAE;SAC1E;QACD,QAAQ,EAAE,CAAC,QAAQ,CAAC;KACrB,EACD,CAAC,eAAe,EAAE,mBAAmB,CAAC,CACvC;IACD,GAAG,CACD,eAAe,EACf,qGAAqG,EACrG,CAAC,kBAAkB,EAAE,uBAAuB,CAAC,EAC7C,KAAK,EACL,CAAC,CAAC,EAAE,EAAE;QACJ,MAAM,GAAG,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;QACxC,IAAI,CAAC,CAAC,SAAS,CAAC;YAAE,GAAG,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;QACxC,OAAO,GAAG,CAAC;IACb,CAAC,EACD;QACE,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,2BAA2B,EAAE;YACpE,OAAO,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,WAAW,EAAE,gCAAgC,EAAE;SAC5E;QACD,QAAQ,EAAE,CAAC,QAAQ,CAAC;KACrB,CACF;IACD,GAAG,CACD,mBAAmB,EACnB,oHAAoH,EACpH,CAAC,oBAAoB,EAAE,kBAAkB,CAAC,EAC1C,SAAS,EACT,CAAC,CAAC,EAAE,EAAE;QACJ,MAAM,GAAG,GAAa,EAAE,CAAC;QACzB,IAAI,CAAC,CAAC,SAAS,CAAC;YAAE,GAAG,CAAC,IAAI,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC;QAC9D,IAAI,CAAC,CAAC,OAAO,CAAC;YAAE,GAAG,CAAC,IAAI,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;QACxD,IAAI,CAAC,CAAC,UAAU,CAAC;YAAE,GAAG,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;QAC1C,IAAI,CAAC,CAAC,UAAU,CAAC;YAAE,GAAG,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;QAC1C,IAAI,CAAC,CAAC,QAAQ,CAAC;YAAE,GAAG,CAAC,IAAI,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;QAC3D,OAAO,GAAG,CAAC;IACb,CAAC,EACD;QACE,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,OAAO,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;YAC3B,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;YACzB,QAAQ,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE;YAC7B,QAAQ,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE;YAC7B,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;SAC3B;KACF,CACF;IACD,GAAG,CACD,iBAAiB,EACjB,wIAAwI,EACxI,CAAC,wBAAwB,EAAE,oBAAoB,CAAC,EAChD,OAAO,CACR;IACD,GAAG,CACD,oBAAoB,EACpB,gJAAgJ,EAChJ,CAAC,0BAA0B,EAAE,6BAA6B,CAAC,EAC3D,UAAU,EACV,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC,EACvD;QACE,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,EAAE,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,gCAAgC,EAAE;YACrE,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,WAAW,EAAE;SACnD;QACD,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,CAAC;KACzB,CACF;IACD,GAAG,CACD,qBAAqB,EACrB,+GAA+G,EAC/G,CAAC,mBAAmB,EAAE,QAAQ,CAAC,EAC/B,WAAW,CACZ;IACD,GAAG,CACD,qBAAqB,EACrB,qKAAqK,EACrK,CAAC,cAAc,EAAE,mBAAmB,CAAC,EACrC,WAAW,CACZ;CACF,CAAC"}

package/dist/tools/memory.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Memory tools — Q&A, semantic search, citations, blast-radius.
+ *
+ * These are the "ask the codebase a question" verbs. The AI student should
+ * pick from this category whenever the user wants to know WHY code exists,
+ * what changed, or what a commit might affect.
+ */
+import type { MnemeTool } from "./_types.js";
+export declare const memoryTools: MnemeTool[];
+//# sourceMappingURL=memory.d.ts.map

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

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