@mneme-ai/mcp 1.19.4 → 1.20.0

package/dist/tools/_nucleus.js

@@ -0,0 +1,151 @@
+/**
+ * NUCLEUS MCP tools (v1.20.0 scaffold) — Infinity Wisdom Brain.
+ *
+ *   • mneme.nucleus.tick   — apply one tick; returns growth delta + new lesson
+ *   • mneme.nucleus.dna    — snapshot the current DNA state (for the agent to read)
+ *   • mneme.nucleus.mutate — apply N mutation cycles (v1.21 will evolve karma + recipes)
+ *
+ * The user's vision: every conversation feeds the nucleus, the nucleus
+ * never sleeps, every next conversation inherits a fitter version. The
+ * AI agent that uses Mneme regularly accumulates compounding wisdom that
+ * NO non-Mneme AI can match. v1.20 ships the scaffold; v1.21 will add
+ * the persistent daemon + auto-tick on every MCP dispatch.
+ */
+import { nucleus } from "@mneme-ai/core";
+export const nucleusTickTool = {
+    name: "mneme.nucleus.tick",
+    category: "meta",
+    description: "Apply one tick to the Infinity Wisdom Brain (the Nucleus). Aggregates " +
+        "current DNA from all chromosomes + streaks, computes growth deltas " +
+        "since last tick, synthesizes an optional new lesson, and persists. " +
+        "Returns the updated tick counter, DNA hash, wisdom score, and any " +
+        "lesson generated. Use WHEN you want to feed Mneme's nucleus a fresh " +
+        "observation cycle (e.g., after every meaningful interaction with the " +
+        "user, or at session start to inherit the latest evolved DNA).",
+    whenToUse: "After an interaction worth recording, OR at session start to pick up the latest evolved DNA + read recent lessons.",
+    triggers: ["nucleus tick", "feed mneme", "evolve dna"],
+    inputSchema: { type: "object", properties: {} },
+    outputSchema: {
+        type: "object",
+        properties: {
+            state: { type: "object" },
+            delta: { type: "object" },
+        },
+    },
+    examples: [
+        {
+            userQuery: "Tick the nucleus and tell me what evolved",
+            expectedOutput: "Returns { state: { tick, dnaHash, wisdomScore, lessons }, delta: { growthSinceLastTick, wisdomScoreDelta, newLesson } }. wisdomScore is monotonically non-decreasing.",
+        },
+    ],
+    pitfalls: [
+        "Wisdom score is a heuristic — it reflects accumulated activity + verified outcomes, not absolute correctness.",
+        "Calling tick repeatedly with no new chromosomes / streak changes won't grow the score (sub-linear formula).",
+        "v1.20 ships the scaffold; auto-tick on every MCP dispatch lands in v1.21.",
+    ],
+    composeWith: ["mneme.nucleus.dna", "mneme.nucleus.mutate", "mneme.lineage.fertilize"],
+    handler: async (rt) => {
+        const result = nucleus.tick(rt.meta.rootPath);
+        const lessonText = result.delta.newLesson ? ` 💡 NEW LESSON: ${result.delta.newLesson.text}` : "";
+        return {
+            data: result,
+            wisdom: `${nucleus.dnaBanner(result.state)} · ${result.delta.wisdomScoreDelta >= 0 ? "+" : ""}${result.delta.wisdomScoreDelta} wisdom this tick.${lessonText}`,
+            confidence: { level: "high" },
+            followUp: result.delta.newLesson ? ["mneme.nucleus.dna"] : [],
+        };
+    },
+};
+export const nucleusDnaTool = {
+    name: "mneme.nucleus.dna",
+    category: "meta",
+    description: "Read the current DNA snapshot of the Nucleus — tick number, DNA hash, " +
+        "wisdom score, growth metrics, and the last 50 synthesized lessons. " +
+        "Use WHEN you want to know what Mneme has learned about THIS repo + " +
+        "lineage so far, or to surface accumulated wisdom to the user.",
+    whenToUse: "You want to see the nucleus's accumulated wisdom + recent lessons.",
+    triggers: ["read dna", "nucleus state", "mneme wisdom"],
+    inputSchema: {
+        type: "object",
+        properties: {
+            lessonLimit: { type: "number", description: "Max lessons to return (default 10, max 50)." },
+        },
+    },
+    outputSchema: {
+        type: "object",
+        properties: {
+            tick: { type: "number" },
+            bornAt: { type: "string" },
+            dnaHash: { type: "string" },
+            wisdomScore: { type: "number" },
+            growth: { type: "object" },
+            lessons: { type: "array" },
+        },
+    },
+    examples: [
+        {
+            userQuery: "What has Mneme learned about my repo?",
+            expectedOutput: "Returns the nucleus state — tick count, DNA hash, wisdom score (monotonically grows), and recent lessons.",
+        },
+    ],
+    pitfalls: ["Returns the LAST tick's state — call mneme.nucleus.tick first if you want fresh aggregation."],
+    composeWith: ["mneme.nucleus.tick", "mneme.lineage.pedigree"],
+    handler: async (rt, args) => {
+        const limit = Math.min(50, typeof args["lessonLimit"] === "number" ? args["lessonLimit"] : 10);
+        const n = nucleus.readNucleus(rt.meta.rootPath);
+        const data = {
+            tick: n.tick,
+            bornAt: n.bornAt,
+            lastTick: n.lastTick,
+            dnaHash: n.dnaHash,
+            wisdomScore: n.wisdomScore,
+            growth: n.growth,
+            mutations: n.mutations,
+            consolidations: n.consolidations,
+            lessons: n.lessons.slice(-limit).reverse(),
+        };
+        return {
+            data,
+            wisdom: nucleus.dnaBanner(n),
+            confidence: { level: "high" },
+        };
+    },
+};
+export const nucleusMutateTool = {
+    name: "mneme.nucleus.mutate",
+    category: "meta",
+    description: "Apply N mutation cycles to the Nucleus. v1.20 scaffold: increments " +
+        "mutation counter for tracking. v1.21 will mutate molecule recipes + " +
+        "karma deltas with structured noise to drive evolution under selection " +
+        "pressure (verified outcomes promoted, hallucinations suppressed). Use " +
+        "WHEN you want to nudge the nucleus toward exploration vs exploitation.",
+    whenToUse: "You want to track mutation cycles applied to the nucleus (v1.20 scaffold).",
+    triggers: ["mutate nucleus", "evolve dna"],
+    inputSchema: {
+        type: "object",
+        properties: {
+            cycles: { type: "number", description: "Number of mutation cycles. Default 1, max 100." },
+        },
+    },
+    outputSchema: {
+        type: "object",
+        properties: {
+            mutations: { type: "number" },
+            tick: { type: "number" },
+            dnaHash: { type: "string" },
+        },
+    },
+    examples: [{ userQuery: "Mutate the nucleus once" }],
+    pitfalls: ["v1.20 scaffold: counts mutations but doesn't yet evolve molecule recipes (v1.21)."],
+    composeWith: ["mneme.nucleus.tick", "mneme.nucleus.dna"],
+    handler: async (rt, args) => {
+        const cycles = Math.max(1, Math.min(100, typeof args["cycles"] === "number" ? args["cycles"] : 1));
+        const n = nucleus.mutate(rt.meta.rootPath, cycles);
+        return {
+            data: { mutations: n.mutations, tick: n.tick, dnaHash: n.dnaHash },
+            wisdom: `Applied ${cycles} mutation cycle${cycles === 1 ? "" : "s"} — nucleus now at ${n.mutations} total mutations · DNA ${n.dnaHash}.`,
+            confidence: { level: "high" },
+        };
+    },
+};
+export const nucleusTools = [nucleusTickTool, nucleusDnaTool, nucleusMutateTool];
+//# sourceMappingURL=_nucleus.js.map

package/dist/tools/_nucleus.js.map

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

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

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

package/dist/tools/_registry.js

@@ -31,7 +31,9 @@ import { genomeMarketplaceTools } from "./_genome_marketplace.js";
 import { aletheiaTools, honeypotTools } from "./_aletheia.js";
 import { meshTools } from "./_mesh.js";
 import { lineageTools } from "./_lineage.js";
-import { systemUpgradeTool } from "./_upgrade.js";
+import { systemUpgradeTool, systemHealthTool } from "./_upgrade.js";
+import { botSpawnTool } from "./_squadron.js";
+import { nucleusTools } from "./_nucleus.js";
 /** All Mneme tools, in display order. The capabilities syllabus comes first
  *  so AI clients that read tool lists top-down see it immediately. */
 export function buildAllTools() {
@@ -54,6 +56,9 @@ export function buildAllTools() {
         ...meshTools,
         ...lineageTools,
         systemUpgradeTool,
+        systemHealthTool,
+        botSpawnTool,
+        ...nucleusTools,
         smartDoTool,
         ...memoryTools,
         ...peopleTools,

package/dist/tools/_registry.js.map

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

package/dist/tools/_squadron.d.ts

@@ -0,0 +1,71 @@
+/**
+ * Bot Squadron (v1.20.0) — atom + element + molecule formation that
+ * fights ONE problem from 6 angles in parallel and merges into a
+ * consensus verdict.
+ *
+ * The pitch: a single AI agent calling `mneme.bot.spawn({ claim })` gets
+ * a coordinated response from six specialized sub-agents (each is a
+ * pre-baked recipe of Mneme tools). Output is a single consensus
+ * payload with confidence scoring + per-bot trace.
+ *
+ *   🔬 DiagnosticianBot   — root-cause hunter (palimpsest + atrophy + memory.why)
+ *   🧪 ReplicatorBot      — find similar past bugs (dna.search + insights.echo)
+ *   📜 HistorianBot       — when did this start (story + time-machine)
+ *   🛡 AletheiaBot        — security scan (lint + immune.scan)
+ *   🔮 PreMortemBot       — predict side effects (premortem + audit.conscience)
+ *   🏛 CourtBot           — adversarial cross-examine (adversary.cross_examine)
+ *
+ * The output also surfaces *which bots agreed* + *which dissented*, so
+ * the human / AI can see how robust the recommendation is.
+ *
+ * No external service. No LLM call. Each bot is a small async function
+ * that calls 1-3 existing Mneme tools + summarizes. Total runtime budget
+ * < 2 seconds for the full formation (parallel).
+ */
+import type { MnemeTool, ToolRuntime } from "./_types.js";
+export type BotName = "diagnostician" | "replicator" | "historian" | "aletheia" | "premortem" | "court";
+export interface BotFinding {
+    bot: BotName;
+    glyph: string;
+    /** Verdict from this bot: "supports", "contradicts", "neutral", "needs_data". */
+    verdict: "supports" | "contradicts" | "neutral" | "needs_data";
+    /** Confidence 0-1. */
+    confidence: number;
+    /** One-sentence headline the consensus aggregator quotes. */
+    headline: string;
+    /** Concrete evidence — commit hashes / file paths / past-incident ids. */
+    evidence: string[];
+    /** Tools this bot fired (for transparency). */
+    toolsFired: string[];
+    /** Time taken (ms). */
+    durationMs: number;
+}
+export interface SquadronVerdict {
+    claim: string;
+    /** Final verdict. */
+    consensus: "verdict_for" | "verdict_against" | "split" | "insufficient_data";
+    /** 0-1 — fraction of bots whose verdict matched the consensus. */
+    confidence: number;
+    /** Human-readable summary the AI agent quotes verbatim to the user. */
+    summary: string;
+    /** Specific recommended action(s). */
+    recommendation: string;
+    /** Per-bot findings. */
+    findings: BotFinding[];
+    /** Bots that agreed with the consensus. */
+    agreeing: BotName[];
+    /** Bots that dissented. */
+    dissenting: BotName[];
+    /** Total wall-clock time. */
+    totalMs: number;
+}
+interface SpawnContext {
+    rt: ToolRuntime;
+    claim: string;
+    filePath?: string;
+    authorEmail?: string;
+}
+export declare function runSquadron(ctx: SpawnContext, bots?: BotName[]): Promise<SquadronVerdict>;
+export declare const botSpawnTool: MnemeTool;
+export {};
+//# sourceMappingURL=_squadron.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"_squadron.d.ts","sourceRoot":"","sources":["../../src/tools/_squadron.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAIH,OAAO,KAAK,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAI1D,MAAM,MAAM,OAAO,GAAG,eAAe,GAAG,YAAY,GAAG,WAAW,GAAG,UAAU,GAAG,WAAW,GAAG,OAAO,CAAC;AAExG,MAAM,WAAW,UAAU;IACzB,GAAG,EAAE,OAAO,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,iFAAiF;IACjF,OAAO,EAAE,UAAU,GAAG,aAAa,GAAG,SAAS,GAAG,YAAY,CAAC;IAC/D,sBAAsB;IACtB,UAAU,EAAE,MAAM,CAAC;IACnB,6DAA6D;IAC7D,QAAQ,EAAE,MAAM,CAAC;IACjB,0EAA0E;IAC1E,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,+CAA+C;IAC/C,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,uBAAuB;IACvB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,qBAAqB;IACrB,SAAS,EAAE,aAAa,GAAG,iBAAiB,GAAG,OAAO,GAAG,mBAAmB,CAAC;IAC7E,kEAAkE;IAClE,UAAU,EAAE,MAAM,CAAC;IACnB,uEAAuE;IACvE,OAAO,EAAE,MAAM,CAAC;IAChB,sCAAsC;IACtC,cAAc,EAAE,MAAM,CAAC;IACvB,wBAAwB;IACxB,QAAQ,EAAE,UAAU,EAAE,CAAC;IACvB,2CAA2C;IAC3C,QAAQ,EAAE,OAAO,EAAE,CAAC;IACpB,2BAA2B;IAC3B,UAAU,EAAE,OAAO,EAAE,CAAC;IACtB,6BAA6B;IAC7B,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,UAAU,YAAY;IACpB,EAAE,EAAE,WAAW,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IAEd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAmOD,wBAAsB,WAAW,CAAC,GAAG,EAAE,YAAY,EAAE,IAAI,CAAC,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC,eAAe,CAAC,CAiD/F;AAiED,eAAO,MAAM,YAAY,EAAE,SAuF1B,CAAC"}