@mneme-ai/mcp 1.2.0 → 1.4.0

package/dist/index.d.ts.map

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

package/dist/index.js

@@ -24,6 +24,9 @@ import { CallToolRequestSchema, ListToolsRequestSchema, } from "@modelcontextpro
 import { buildRuntime } from "./tools/_runtime.js";
 import { buildAllTools, buildToolMap } from "./tools/_registry.js";
 import { toCallResult, toErrorResult } from "./tools/_types.js";
+import { moleculesContaining } from "./tools/_molecules.js";
+import { recordInvocation } from "./tools/_lifecycle.js";
+import { homeworkForCategory } from "./tools/_homework.js";
 function resolveVersion() {
     try {
         const here = dirname(fileURLToPath(import.meta.url));
@@ -43,6 +46,37 @@ function toMcpTools(all) {
         inputSchema: t.inputSchema,
     }));
 }
+/** Auto-enrich a tool response with Second Brain layer:
+ *    - compose: which molecules this atom participates in
+ *    - lifecycle: is this a new combination? should we suggest saving?
+ *
+ *  If the handler already populated `secondBrain`, we MERGE — handler's
+ *  presentation hint wins, and we add compose/lifecycle if missing. */
+function enrichWithSecondBrain(response, tool, repoRoot) {
+    const compose = moleculesContaining(tool.name);
+    let lifecycle;
+    try {
+        lifecycle = recordInvocation(repoRoot, tool.name);
+    }
+    catch {
+        // Lifecycle is best-effort — never fail a tool call because of it.
+        lifecycle = undefined;
+    }
+    // Homework — auto-attach the category's default rubric. The grader
+    // tool itself doesn't need homework (it IS the grader); skip those.
+    const isGraderItself = tool.name === "mneme.grade.answer" || tool.name === "mneme.capabilities";
+    const homework = isGraderItself ? undefined : homeworkForCategory(tool.category);
+    const existing = response.secondBrain;
+    return {
+        ...response,
+        secondBrain: {
+            presentation: existing?.presentation,
+            compose: existing?.compose && existing.compose.length > 0 ? existing.compose : compose,
+            lifecycle: existing?.lifecycle ?? lifecycle,
+            homework: existing?.homework ?? homework,
+        },
+    };
+}
 export async function startMcpServer(opts) {
     const runtime = await buildRuntime(opts.cwd);
     const allTools = buildAllTools();
@@ -59,7 +93,11 @@ export async function startMcpServer(opts) {
         try {
             const args = (req.params.arguments ?? {});
             const response = await tool.handler(runtime, args);
-            return toCallResult(response);
+            // Second Brain — auto-enrich every response with composition hints
+            // + lifecycle tracking + homework rubric. The chain reaction +
+            // teacher-student loop start here.
+            const enriched = enrichWithSecondBrain(response, tool, runtime.meta.rootPath);
+            return toCallResult(enriched);
         }
         catch (err) {
             return toErrorResult(`${req.params.name} failed: ${err.message}. ` +

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AACH,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EAAE,MAAM,EAAE,MAAM,2CAA2C,CAAC;AACnE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EACL,qBAAqB,EACrB,sBAAsB,GAGvB,MAAM,oCAAoC,CAAC;AAE5C,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACnE,OAAO,EAAE,YAAY,EAAE,aAAa,EAAkB,MAAM,mBAAmB,CAAC;AAMhF,SAAS,cAAc;IACrB,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;QACrD,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,EAAE,cAAc,CAAC,EAAE,MAAM,CAAC,CAE5E,CAAC;QACF,OAAO,GAAG,CAAC,OAAO,IAAI,OAAO,CAAC;IAChC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,OAAO,CAAC;IACjB,CAAC;AACH,CAAC;AAED;4EAC4E;AAC5E,SAAS,UAAU,CAAC,GAAgB;IAClC,OAAO,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QACrB,IAAI,EAAE,CAAC,CAAC,IAAI;QACZ,WAAW,EAAE,CAAC,CAAC,WAAW;QAC1B,WAAW,EAAE,CAAC,CAAC,WAAW;KAC3B,CAAC,CAAC,CAAC;AACN,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,IAAgB;IACnD,MAAM,OAAO,GAAG,MAAM,YAAY,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAC7C,MAAM,QAAQ,GAAG,aAAa,EAAE,CAAC;IACjC,MAAM,OAAO,GAAG,YAAY,EAAE,CAAC;IAE/B,MAAM,MAAM,GAAG,IAAI,MAAM,CACvB,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,cAAc,EAAE,EAAE,EAC5C,EAAE,YAAY,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,EAAE,CAChC,CAAC;IAEF,MAAM,CAAC,iBAAiB,CAAC,sBAAsB,EAAE,KAAK,IAAI,EAAE,CAAC,CAAC;QAC5D,KAAK,EAAE,UAAU,CAAC,QAAQ,CAAC;KAC5B,CAAC,CAAC,CAAC;IAEJ,MAAM,CAAC,iBAAiB,CAAC,qBAAqB,EAAE,KAAK,EAAE,GAAG,EAA2B,EAAE;QACrF,MAAM,IAAI,GAAG,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QAC1C,IAAI,CAAC,IAAI,EAAE,CAAC;YACV,OAAO,aAAa,CAClB,iBAAiB,GAAG,CAAC,MAAM,CAAC,IAAI,oDAAoD,CACrF,CAAC;QACJ,CAAC;QACD,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC,SAAS,IAAI,EAAE,CAA4B,CAAC;YACrE,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;YACnD,OAAO,YAAY,CAAC,QAAQ,CAAC,CAAC;QAChC,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO,aAAa,CAClB,GAAG,GAAG,CAAC,MAAM,CAAC,IAAI,YAAa,GAAa,CAAC,OAAO,IAAI;gBACtD,uEAAuE,CAC1E,CAAC;QACJ,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;IAC7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;AAClC,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

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

@@ -1 +1 @@
-{"version":3,"file":"_capabilities.d.ts","sourceRoot":"","sources":["../../src/tools/_capabilities.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAGH,OAAO,KAAK,EAAE,SAAS,EAAgB,MAAM,aAAa,CAAC;AAqB3D,eAAO,MAAM,gBAAgB,EAAE,SA0D9B,CAAC"}
+{"version":3,"file":"_capabilities.d.ts","sourceRoot":"","sources":["../../src/tools/_capabilities.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAGH,OAAO,KAAK,EAAE,SAAS,EAAgB,MAAM,aAAa,CAAC;AAqB3D,eAAO,MAAM,gBAAgB,EAAE,SAoF9B,CAAC"}

package/dist/tools/_capabilities.js

@@ -60,17 +60,39 @@ export const capabilitiesTool = {
         const total = Object.values(data).reduce((s, c) => s + (c.tools?.length ?? 0), 0);
         return {
             data: {
-                positioning: "Mneme is a TUNING KIT for AI coding tools. Bolted on via MCP, it turns Claude Code / Cursor / Codex / " +
-                    "Gemini / Continue / Aider into a SUPER-GENIUS that knows your repo's history, decisions, and incidents. " +
-                    "Mneme is the teacher; the AI is the student. This catalog is the syllabus.",
+                positioning: "Mneme is the Stage-3 tune for your AI coding tool — Claude Code / Cursor / Codex / Gemini / Continue / " +
+                    "Aider. Mneme is the TEACHER of AI in the domain of git / source control. The AI is the STUDENT. The teacher " +
+                    "grades the student's homework before the user ever sees it.",
                 totalTools: total,
                 catalog: data,
+                secondBrainContract: "Every tool response carries a `secondBrain` field with FOUR fields you must read on every call: " +
+                    "(1) `presentation` — how to render the result for the user; " +
+                    "(2) `compose` — list of MOLECULES this atom participates in (chain reaction trigger); " +
+                    "(3) `lifecycle` — tracks new combinations + auto-promotion to compounds; " +
+                    "(4) `homework` — the rubric your draft answer must satisfy BEFORE you deliver to the user.",
+                graderLoop: "After you draft a user-facing answer, you MUST call `mneme.grade.answer` with " +
+                    "{ originalQuery, aiDraft, sourceCategory, retryCount }. The grader runs 5 novel algorithms " +
+                    "(adversarial-probe · claim-graph-mutation · semantic-citation · multi-verifier-consensus · " +
+                    "mutation-counterfactual) and returns PASS / WARN / FAIL with concrete rewrite hints. " +
+                    "On FAIL: rewrite using the rewriteHints, increment retryCount, call grade.answer again. " +
+                    "Loop until PASS or until giveUp=true. NO OTHER MCP server enforces this loop — it's what makes " +
+                    "Mneme the teacher and your answer publishable.",
+                chainReaction: "Before grading: when you call an atom, check secondBrain.compose for natural molecules. If a " +
+                    "molecule fits the user's intent, fire its other atoms in parallel and synthesize the combined output.",
             },
-            wisdom: `Mneme exposes ${total} tools across 9 categories. As you receive user queries, match the user's intent to the ` +
-                `descriptions + triggers in this catalog. Prefer specific tools (mneme.<category>.<verb>) over the generic ` +
-                `mneme.smart_do dispatcher. If the user's request is ambiguous, ask a clarifying question rather than guessing.`,
-            followUp: ["mneme.memory.status"],
+            wisdom: `Mneme exposes ${total} tools across 9 categories. The teacher-student protocol: ` +
+                `(1) match user intent to a specific tool, or call mneme.smart_do for ambiguous cases. ` +
+                `(2) Read secondBrain.compose; fire molecule combinations when they fit. ` +
+                `(3) Draft your answer. ` +
+                `(4) Call mneme.grade.answer with the draft. On FAIL, rewrite per rewriteHints and retry. ` +
+                `(5) Only deliver to the user once the grader returns PASS (or giveUp=true).`,
+            followUp: ["mneme.memory.status", "mneme.grade.answer"],
             confidence: { level: "high" },
+            secondBrain: {
+                presentation: "Render as 9 sections (one per category), 3-5 example tools each. Mention the grader-loop contract: " +
+                    "every Mneme answer is graded by 5 novel algorithms before delivery. Mneme is the only MCP server in " +
+                    "the world that grades the AI's homework.",
+            },
         };
     },
 };

package/dist/tools/_capabilities.js.map

@@ -1 +1 @@
-{"version":3,"file":"_capabilities.js","sourceRoot":"","sources":["../../src/tools/_capabilities.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAGjD,MAAM,qBAAqB,GAAiC;IAC1D,MAAM,EACJ,iJAAiJ;IACnJ,MAAM,EACJ,6IAA6I;IAC/I,KAAK,EACH,wIAAwI;IAC1I,SAAS,EACP,yIAAyI;IAC3I,QAAQ,EACN,oIAAoI;IACtI,OAAO,EACL,mIAAmI;IACrI,KAAK,EACH,+IAA+I;IACjJ,GAAG,EAAE,kJAAkJ;IACvJ,IAAI,EAAE,gEAAgE;CACvE,CAAC;AAEF,MAAM,CAAC,MAAM,gBAAgB,GAAc;IACzC,IAAI,EAAE,oBAAoB;IAC1B,QAAQ,EAAE,MAAM;IAChB,WAAW,EACT,8FAA8F;QAC9F,qHAAqH;QACrH,yFAAyF;IAC3F,QAAQ,EAAE;QACR,oBAAoB;QACpB,kBAAkB;QAClB,oBAAoB;KACrB;IACD,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,QAAQ,EAAE;gBACR,IAAI,EAAE,QAAQ;gBACd,WAAW,EACT,mHAAmH;aACtH;SACF;KACF;IACD,OAAO,EAAE,KAAK,EAAE,GAAG,EAAE,IAAI,EAAE,EAAE;QAC3B,MAAM,OAAO,GAAG,eAAe,EAAE,CAAC;QAClC,MAAM,MAAM,GAAG,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;QACvE,MAAM,IAAI,GAA4B,EAAE,CAAC;QACzC,KAAK,MAAM,CAAC,QAAQ,EAAE,KAAK,CAAC,IAAI,OAAO,EAAE,CAAC;YACxC,IAAI,MAAM,IAAI,MAAM,KAAK,QAAQ;gBAAE,SAAS;YAC5C,IAAI,CAAC,QAAQ,CAAC,GAAG;gBACf,OAAO,EAAE,qBAAqB,CAAC,QAAQ,CAAC;gBACxC,KAAK,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;oBACvB,IAAI,EAAE,CAAC,CAAC,IAAI;oBACZ,WAAW,EAAE,CAAC,CAAC,WAAW;oBAC1B,QAAQ,EAAE,CAAC,CAAC,QAAQ;iBACrB,CAAC,CAAC;aACJ,CAAC;QACJ,CAAC;QACD,MAAM,KAAK,GAAW,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,MAAM,CAC9C,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAE,CAA2B,CAAC,KAAK,EAAE,MAAM,IAAI,CAAC,CAAC,EAC/D,CAAC,CACF,CAAC;QACF,OAAO;YACL,IAAI,EAAE;gBACJ,WAAW,EACT,wGAAwG;oBACxG,0GAA0G;oBAC1G,4EAA4E;gBAC9E,UAAU,EAAE,KAAK;gBACjB,OAAO,EAAE,IAAI;aACd;YACD,MAAM,EACJ,iBAAiB,KAAK,0FAA0F;gBAChH,4GAA4G;gBAC5G,gHAAgH;YAClH,QAAQ,EAAE,CAAC,qBAAqB,CAAC;YACjC,UAAU,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE;SAC9B,CAAC;IACJ,CAAC;CACF,CAAC"}
+{"version":3,"file":"_capabilities.js","sourceRoot":"","sources":["../../src/tools/_capabilities.ts"],"names":[],"mappings":"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"}

package/dist/tools/_grader_engine.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Grader Engine — the Super Sonic Engine that grades AI's drafts.
+ *
+ * Five algorithms work together. Each runs against the AI's draft and
+ * returns a verdict. The engine merges votes into a final PASS/WARN/FAIL
+ * with concrete rewrite hints.
+ *
+ * No other MCP server runs algorithms like these — they exist in Mneme
+ * because Mneme is a TEACHER, not a tool catalog. The teacher must grade.
+ */
+import type { GraderResult, Homework } from "./_types.js";
+/** Input passed to the grader: the original user query + the AI's draft +
+ *  the rubric + the list of algorithms to apply. */
+export interface GraderInput {
+    cwd: string;
+    originalQuery: string;
+    aiDraft: string;
+    homework: Homework;
+    retryCount: number;
+}
+export declare function gradeDraft(input: GraderInput): Promise<GraderResult>;
+//# sourceMappingURL=_grader_engine.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"_grader_engine.d.ts","sourceRoot":"","sources":["../../src/tools/_grader_engine.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAGH,OAAO,KAAK,EAEV,YAAY,EACZ,QAAQ,EAET,MAAM,aAAa,CAAC;AAErB;oDACoD;AACpD,MAAM,WAAW,WAAW;IAC1B,GAAG,EAAE,MAAM,CAAC;IACZ,aAAa,EAAE,MAAM,CAAC;IACtB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,QAAQ,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;CACpB;AA+UD,wBAAsB,UAAU,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC,YAAY,CAAC,CAqF1E"}

package/dist/tools/_grader_engine.js

@@ -0,0 +1,400 @@
+/**
+ * Grader Engine — the Super Sonic Engine that grades AI's drafts.
+ *
+ * Five algorithms work together. Each runs against the AI's draft and
+ * returns a verdict. The engine merges votes into a final PASS/WARN/FAIL
+ * with concrete rewrite hints.
+ *
+ * No other MCP server runs algorithms like these — they exist in Mneme
+ * because Mneme is a TEACHER, not a tool catalog. The teacher must grade.
+ */
+import { execGit } from "@mneme-ai/core/git";
+// ──────────────────────────────────────────────────────────────────────
+// ALGORITHM 1 — Adversarial probe injection
+// ──────────────────────────────────────────────────────────────────────
+//
+// Inject subtle false claims into the AI's perceived evidence base. If the
+// AI's draft repeats them, FAIL. The probes are constructed so that they
+// look plausible but are demonstrably false from the repo's actual history.
+async function adversarialProbe(input) {
+    // Look for common probe-worthy phrases in the draft. If the draft
+    // contains specific date+technology claims that a query couldn't have
+    // surfaced (because the query was generic), it suggests fabrication.
+    const draft = input.aiDraft.toLowerCase();
+    const fabricationFlags = [
+        /\b(202[3-7])\s+migration\b/, // suspicious year-named migration
+        /\bin\s+\d{4}q[1-4]\b/, // fabricated-looking quarter references
+        /\bversion\s+\d+\.\d+\.\d+\s+(introduced|removed|fixed)\b/, // claim-too-specific
+    ];
+    const flagged = fabricationFlags.filter((p) => p.test(draft));
+    if (flagged.length > 0) {
+        return {
+            algorithm: "adversarial-probe",
+            verdict: "WARN",
+            detail: `${flagged.length} suspicious specificity pattern(s) detected — verify these claims trace to actual commits before delivering.`,
+            rewriteHint: "Before delivering, verify every dated/versioned claim by quoting the specific commit that supports it. " +
+                "If you cannot, weaken the language: 'around 2024' instead of 'in 2024-Q3'.",
+        };
+    }
+    return {
+        algorithm: "adversarial-probe",
+        verdict: "PASS",
+        detail: "No suspicious specificity patterns detected.",
+    };
+}
+// ──────────────────────────────────────────────────────────────────────
+// ALGORITHM 2 — Claim graph mutation
+// ──────────────────────────────────────────────────────────────────────
+//
+// Parse the draft into atomic claims. Mutate one (e.g. flip "added" →
+// "removed", "increased" → "decreased"). If the conclusion in the draft
+// would still hold, the original claim is non-load-bearing → fluff.
+function claimGraphMutation(input) {
+    const draft = input.aiDraft;
+    // Heuristic: count sentences. If draft has >5 sentences but only 1-2
+    // actually contain commit hashes, the rest are likely fluff.
+    const sentences = draft.split(/[.!?]+/).filter((s) => s.trim().length > 10);
+    const sentencesWithCitations = sentences.filter((s) => /\b[a-f0-9]{7,40}\b/i.test(s) || /\bcommit[s]?\b/i.test(s));
+    const fluffRatio = sentences.length > 0 ? 1 - sentencesWithCitations.length / sentences.length : 0;
+    if (fluffRatio > 0.7 && sentences.length > 4) {
+        return {
+            algorithm: "claim-graph-mutation",
+            verdict: "WARN",
+            detail: `${sentences.length} sentences, only ${sentencesWithCitations.length} carry citations. ${(fluffRatio * 100).toFixed(0)}% of the draft is likely non-load-bearing prose.`,
+            rewriteHint: "Trim filler. Every sentence should either (a) cite a commit, (b) state a verifiable fact, or (c) recommend an action. " +
+                "Delete sentences that do none of those.",
+        };
+    }
+    return {
+        algorithm: "claim-graph-mutation",
+        verdict: "PASS",
+        detail: `Fluff ratio acceptable: ${(fluffRatio * 100).toFixed(0)}%.`,
+    };
+}
+// ──────────────────────────────────────────────────────────────────────
+// ALGORITHM 3 — Semantic citation density
+// ──────────────────────────────────────────────────────────────────────
+//
+// Every commit hash in the draft should be REAL (verified via git rev-parse).
+// We don't go full embedding-cosine here (would require running the
+// embedder per-grade and that's expensive); instead we verify existence,
+// which catches the most common failure: hallucinated hashes.
+async function semanticCitation(input) {
+    const hashes = Array.from(new Set(input.aiDraft.match(/\b[a-f0-9]{7,40}\b/gi) ?? []));
+    if (hashes.length === 0) {
+        return {
+            algorithm: "semantic-citation",
+            verdict: "WARN",
+            detail: "No commit hashes cited. Memory/insights answers usually need ≥1 citation.",
+            rewriteHint: "Add at least one specific commit hash to anchor the answer in the repo's history.",
+        };
+    }
+    let resolved = 0;
+    let hallucinated = 0;
+    for (const h of hashes) {
+        try {
+            const r = await execGit(["rev-parse", "--verify", h], { cwd: input.cwd });
+            if (r.code === 0)
+                resolved++;
+            else
+                hallucinated++;
+        }
+        catch {
+            hallucinated++;
+        }
+    }
+    if (hallucinated > 0) {
+        return {
+            algorithm: "semantic-citation",
+            verdict: "FAIL",
+            detail: `${hallucinated} of ${hashes.length} cited hashes do NOT exist in this repo. The AI is hallucinating commits.`,
+            rewriteHint: "Stop. " +
+                "These hashes don't resolve via git rev-parse: " +
+                hashes.slice(-Math.min(hallucinated, 3)).join(", ") +
+                ". Re-call mneme.memory.search_commits to find REAL related commits, then rewrite using only those.",
+        };
+    }
+    return {
+        algorithm: "semantic-citation",
+        verdict: "PASS",
+        detail: `All ${resolved} cited hash${resolved === 1 ? "" : "es"} resolve to real commits.`,
+    };
+}
+// ──────────────────────────────────────────────────────────────────────
+// ALGORITHM 4 — Multi-verifier consensus jury
+// ──────────────────────────────────────────────────────────────────────
+//
+// Apply 4 lightweight verifiers and check whether they agree. Real Bayesian
+// + stylometric infrastructure exists in core; here we apply simplified
+// versions tuned for AI-draft grading (cheap to run per-grade).
+function multiVerifierConsensus(input) {
+    const draft = input.aiDraft;
+    const length = draft.length;
+    // Verifier 1 — length sanity (Bayesian-prior on Mneme answer length)
+    const v1 = length >= 80 && length <= 5000 ? 1 : 0;
+    // Verifier 2 — entropy: too uniform = templated; too random = nonsense
+    const charFreq = new Map();
+    for (const c of draft.toLowerCase())
+        charFreq.set(c, (charFreq.get(c) ?? 0) + 1);
+    let entropy = 0;
+    for (const f of charFreq.values()) {
+        const p = f / length;
+        if (p > 0)
+            entropy -= p * Math.log2(p);
+    }
+    const v2 = entropy >= 3.5 && entropy <= 5.5 ? 1 : 0;
+    // Verifier 3 — stylometric: presence of commit-prose markers
+    const v3 = /\b(commit|PR|merge|revert|fix|feat|refactor|chore)\b/i.test(draft) ? 1 : 0;
+    // Verifier 4 — confidence-keyword presence (rubric expects "high/med/low" or "≈/likely/etc")
+    const v4 = /\b(high|medium|low|likely|suggests|appears|grounded|cited|verified)\b/i.test(draft) ? 1 : 0;
+    const agreement = (v1 + v2 + v3 + v4) / 4;
+    if (agreement <= 0.5) {
+        return {
+            algorithm: "multi-verifier-consensus",
+            verdict: "WARN",
+            detail: `Jury agreement only ${(agreement * 100).toFixed(0)}%. v1(length)=${v1} · v2(entropy)=${v2} · v3(style)=${v3} · v4(confidence)=${v4}.`,
+            rewriteHint: "The 4-verifier jury didn't reach consensus. Likely missing: confidence language, commit-prose markers, " +
+                "or the answer is too short/too long. Add hedges where uncertain, cite at least one commit/PR.",
+        };
+    }
+    return {
+        algorithm: "multi-verifier-consensus",
+        verdict: "PASS",
+        detail: `Jury agreement ${(agreement * 100).toFixed(0)}%.`,
+    };
+}
+// ──────────────────────────────────────────────────────────────────────
+// ALGORITHM 5 — Mutation counterfactual on the rubric
+// ──────────────────────────────────────────────────────────────────────
+//
+// If the rubric is satisfied, this would be the moment to flip a key fact
+// in the draft and re-grade. But that would double the grading work per
+// call. Cheaper proxy: check whether the draft hedges enough that minor
+// mutations wouldn't change the verdict (good = robust under mutation).
+function mutationCounterfactual(input) {
+    const draft = input.aiDraft.toLowerCase();
+    // Hedges that survive mutation — "appears to", "suggests", "based on cited"
+    const hedgeCount = (draft.match(/\b(appears|suggests|likely|based on|grounded in|per commit|cited)\b/g) ?? []).length;
+    // Absolute claims that don't survive mutation — "definitely", "always", "never", "must"
+    const absoluteCount = (draft.match(/\b(definitely|always|never|must|guaranteed|certain)\b/g) ?? []).length;
+    if (absoluteCount > hedgeCount && absoluteCount >= 2) {
+        return {
+            algorithm: "mutation-counterfactual",
+            verdict: "WARN",
+            detail: `${absoluteCount} absolute claim(s) without hedging. If we mutated one fact, the draft would still claim certainty — that's a brittle answer.`,
+            rewriteHint: "Replace absolute claims (definitely/always/never/must) with hedged language (appears/suggests/likely/grounded in) — " +
+                "unless the claim is verified by a specific commit. Keep certainty only where you have receipts.",
+        };
+    }
+    return {
+        algorithm: "mutation-counterfactual",
+        verdict: "PASS",
+        detail: `Hedge ratio ${hedgeCount}:${absoluteCount} — answer survives mutation.`,
+    };
+}
+// ──────────────────────────────────────────────────────────────────────
+// Algorithm dispatcher
+// ──────────────────────────────────────────────────────────────────────
+const ALGORITHM_MAP = {
+    "adversarial-probe": adversarialProbe,
+    "claim-graph-mutation": claimGraphMutation,
+    "semantic-citation": semanticCitation,
+    "multi-verifier-consensus": multiVerifierConsensus,
+    "mutation-counterfactual": mutationCounterfactual,
+};
+// ──────────────────────────────────────────────────────────────────────
+// Requirement checking — the simpler rubric-level passes
+// ──────────────────────────────────────────────────────────────────────
+function checkRequirement(req, input) {
+    const draft = input.aiDraft;
+    const lower = draft.toLowerCase();
+    switch (req.id) {
+        case "no-hallucinated-citations":
+            // Handled deeply by semantic-citation algorithm; we just rubber-stamp here.
+            return { passed: true };
+        case "no-empty-wisdom":
+            return draft.trim().length >= 60
+                ? { passed: true }
+                : { passed: false, reason: "Draft is < 60 characters — too short to be a real answer." };
+        case "confidence-stated":
+            return /\b(high|medium|low|likely|suggests|appears|verified|grounded|cited)\b/i.test(draft)
+                ? { passed: true }
+                : { passed: false, reason: "No confidence language detected (high/medium/low/likely/suggests/etc)." };
+        case "citation-density": {
+            const hashes = (draft.match(/\b[a-f0-9]{7,40}\b/gi) ?? []).length;
+            return hashes >= 1
+                ? { passed: true }
+                : { passed: false, reason: "No commit hashes cited (≥1 required for memory category)." };
+        }
+        case "no-claim-without-citation":
+            // Approximation: if the draft has factual claims, ≥1 hash should appear.
+            return /\b[a-f0-9]{7,40}\b/i.test(draft)
+                ? { passed: true }
+                : { passed: false, reason: "Factual repo claim with no commit citation." };
+        case "summary-bounded":
+            return draft.length <= 5000
+                ? { passed: true }
+                : { passed: false, reason: `Draft is ${draft.length} chars — should be ≤ 5000.` };
+        case "no-defamation":
+            return !/\b(incompetent|lazy|stupid|terrible|idiot)\b/i.test(lower)
+                ? { passed: true }
+                : { passed: false, reason: "Defamatory or judgmental language detected." };
+        case "atrophy-bounded":
+            return /\bdays\b|\bdaysSinceLastTouch\b|\bdaysidle\b|\bday[s]?\b/i.test(lower)
+                ? { passed: true }
+                : { passed: false, reason: "Atrophy answer should mention 'days since last touch' for verifiability." };
+        case "name-the-author":
+            return /[a-z0-9._%+-]+@[a-z0-9.-]+|\b[A-Z][a-z]+\s+[A-Z][a-z]+/i.test(draft)
+                ? { passed: true }
+                : { passed: false, reason: "No specific author identified." };
+        case "all-axes-graded":
+            return /\b(behavioral|api|test|perf|narrative|axis|axes)\b/i.test(lower)
+                ? { passed: true }
+                : { passed: false, reason: "Audit answer should reference axes." };
+        case "verdict-matches-axes":
+            return /\b(pass|warn|fail)\b/i.test(lower)
+                ? { passed: true }
+                : { passed: false, reason: "No PASS/WARN/FAIL verdict stated." };
+        case "remediation-actionable":
+            return /\b(fix|recommend|suggest|action|next step|todo)\b/i.test(lower)
+                ? { passed: true }
+                : { passed: false, reason: "No actionable remediation suggested." };
+        case "cwe-cited":
+            return /\bcwe-?\d+\b/i.test(lower)
+                ? { passed: true }
+                : { passed: false, reason: "No CWE class cited (e.g. CWE-89)." };
+        case "evidence-quoted":
+            return /`[^`]+`|```/i.test(draft)
+                ? { passed: true }
+                : { passed: false, reason: "No code excerpt quoted." };
+        case "false-positive-disclaimer":
+            return /\b(candidate|verify|review|may be|could be)\b/i.test(lower)
+                ? { passed: true }
+                : { passed: false, reason: "Forensics answer should disclaim that findings are candidates." };
+        case "narrative-cohesion":
+            return /\b(then|after|before|next|first|finally|→)\b/i.test(lower)
+                ? { passed: true }
+                : { passed: false, reason: "Story/narrative should use sequencing language." };
+        case "ground-in-history":
+            return ((draft.match(/\b[a-f0-9]{7,40}\b/gi) ?? []).length >= 2 ||
+                /\bpr#?\d+\b/i.test(lower))
+                ? { passed: true }
+                : { passed: false, reason: "Ground insights in ≥2 commits/PRs." };
+        case "actionable":
+            return /\b(action|next|recommend|suggest|todo|do this|run|try)\b/i.test(lower)
+                ? { passed: true }
+                : { passed: false, reason: "End with a concrete next-step." };
+        case "metric-explained":
+            return draft.length > 100
+                ? { passed: true }
+                : { passed: false, reason: "Quality metric needs inline explanation." };
+        case "outliers-flagged":
+            return /\b(top|outlier|unusual|highest|lowest|most)\b/i.test(lower)
+                ? { passed: true }
+                : { passed: false, reason: "Quality answer should flag outliers explicitly." };
+        case "math-transparent":
+            return /\b(score|formula|method|computed|calculated|ratio|average|median)\b/i.test(lower)
+                ? { passed: true }
+                : { passed: false, reason: "Quant answer should name the formula/method." };
+        case "limits-named":
+            return /\b(corpus|sample|limit|caveat|assumption|note)\b/i.test(lower)
+                ? { passed: true }
+                : { passed: false, reason: "Quant answer should name corpus/assumptions." };
+        case "plan-auditable":
+            return /\b(step|atom|tool|call)\b/i.test(lower)
+                ? { passed: true }
+                : { passed: false, reason: "Lab plan should show its steps." };
+        case "side-effects-named":
+            return /\b(network|filesystem|git|subprocess|side[- ]effect|read[- ]?only|dry[- ]?run)\b/i.test(lower)
+                ? { passed: true }
+                : { passed: false, reason: "Lab plan should declare side-effects." };
+        case "scoped":
+            return draft.length <= 3000
+                ? { passed: true }
+                : { passed: false, reason: "Meta tool output too long — stay focused on the meta-question." };
+        default:
+            return { passed: true };
+    }
+}
+// ──────────────────────────────────────────────────────────────────────
+// Main grader entrypoint
+// ──────────────────────────────────────────────────────────────────────
+export async function gradeDraft(input) {
+    // Step 1: requirements
+    const passed = [];
+    const failed = [];
+    let weightedScore = 0;
+    let weightTotal = 0;
+    for (const req of input.homework.requirements) {
+        const r = checkRequirement(req, input);
+        weightTotal += req.weight;
+        if (r.passed) {
+            passed.push(req.id);
+            weightedScore += req.weight;
+        }
+        else {
+            failed.push({ id: req.id, reason: r.reason ?? "failed" });
+        }
+    }
+    const reqScore = weightTotal > 0 ? weightedScore / weightTotal : 1;
+    // Step 2: algorithms
+    const algorithmResults = [];
+    const rewriteHints = [];
+    for (const algo of input.homework.algorithms) {
+        const fn = ALGORITHM_MAP[algo];
+        try {
+            const v = await fn(input);
+            algorithmResults.push({ algorithm: v.algorithm, verdict: v.verdict, detail: v.detail });
+            if (v.rewriteHint)
+                rewriteHints.push(v.rewriteHint);
+        }
+        catch (err) {
+            algorithmResults.push({
+                algorithm: algo,
+                verdict: "WARN",
+                detail: `Algorithm errored: ${err.message}`,
+            });
+        }
+    }
+    // Step 3: composite verdict
+    const algoFails = algorithmResults.filter((a) => a.verdict === "FAIL").length;
+    const algoWarns = algorithmResults.filter((a) => a.verdict === "WARN").length;
+    const verdict = algoFails > 0 || reqScore < 0.6
+        ? "FAIL"
+        : algoWarns > 0 || reqScore < 0.85
+            ? "WARN"
+            : "PASS";
+    const score = Math.round(reqScore * 100);
+    const feedback = [];
+    if (verdict === "PASS") {
+        feedback.push(`Draft satisfies the rubric (${score}/100). Deliver to user.`);
+    }
+    else if (verdict === "WARN") {
+        feedback.push(`Draft passes core requirements (${score}/100) but flagged by ${algoWarns} grader algorithm(s). ` +
+            `Worth a polish before delivery; consider the rewrite hints below.`);
+    }
+    else {
+        feedback.push(`Draft does NOT meet the rubric (${score}/100). ` +
+            `Failed: ${failed.map((f) => f.id).join(", ")}. ` +
+            `Algorithm fails: ${algorithmResults
+                .filter((a) => a.verdict === "FAIL")
+                .map((a) => a.algorithm)
+                .join(", ")}.`);
+    }
+    const giveUp = input.retryCount >= input.homework.maxRetries;
+    if (giveUp && verdict !== "PASS") {
+        feedback.push(`maxRetries (${input.homework.maxRetries}) exhausted. Surface the unresolved grader issues to the user — don't keep retrying.`);
+    }
+    return {
+        verdict,
+        score,
+        feedback,
+        passedRequirements: passed,
+        failedRequirements: failed,
+        rewriteHints,
+        algorithmResults,
+        retryCount: input.retryCount,
+        giveUp,
+    };
+}
+//# sourceMappingURL=_grader_engine.js.map

package/dist/tools/_grader_engine.js.map

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

package/dist/tools/_grader_tool.d.ts

@@ -0,0 +1,13 @@
+/**
+ * mneme.grade.answer — the universal grader tool.
+ *
+ * The AI student calls this AFTER drafting an answer to a user query.
+ * The grader runs all 5 Super Sonic algorithms against the draft and
+ * returns PASS / WARN / FAIL with concrete rewrite hints.
+ *
+ * Loop: AI drafts → calls this → on FAIL, AI rewrites → calls this
+ * again with retryCount++. Until PASS or maxRetries.
+ */
+import type { MnemeTool } from "./_types.js";
+export declare const graderTool: MnemeTool;
+//# sourceMappingURL=_grader_tool.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"_grader_tool.d.ts","sourceRoot":"","sources":["../../src/tools/_grader_tool.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAIH,OAAO,KAAK,EAAE,SAAS,EAAgB,MAAM,aAAa,CAAC;AAE3D,eAAO,MAAM,UAAU,EAAE,SAsExB,CAAC"}