@mneme-ai/mcp 1.17.6 → 1.18.0

package/dist/tools/_timetravel.js

@@ -0,0 +1,243 @@
+/**
+ * Time-travel MCP (v1.18.0 — black sheep #2)
+ *
+ * Snap the AI agent's view of the repo to a specific git ref. Every
+ * subsequent tool call (within the same MCP server process) operates
+ * AS IF today were that ref. State is per-server-process, so two AI
+ * sessions connecting to the same repo via separate MCP processes
+ * don't collide.
+ *
+ *   • mneme.timetravel.activate(ref)   — freeze the view at this ref
+ *   • mneme.timetravel.status          — query current state
+ *   • mneme.timetravel.deactivate      — return to live HEAD
+ *
+ * v1.18.0 ships the SCAFFOLDING — a per-process state holder + the
+ * three tools above. Existing tools that want to honor time-travel
+ * read `getTimeTravelState()` from this module and clamp their git
+ * commands to `--until <commitDate>` or `<ref>` accordingly. The
+ * gradual-rollout pattern: tools opt in over time without a big-bang
+ * refactor.
+ *
+ * Use cases:
+ *   • Counterfactual analysis: "If I were on duty Sept 2024, what
+ *     would I have seen?" — recreate incident-response state.
+ *   • Hindsight-bias audit: "Did the AI's recommendation REALLY hold
+ *     up at the time?" — replay decisions against frozen context.
+ *   • Onboarding rehearsal: walk a new engineer through the repo at
+ *     the moment they would have joined.
+ */
+import { spawnSync } from "node:child_process";
+/** Per-process state. MCP server runs one process per AI client session,
+ *  so this naturally scopes to that session. */
+let state = {
+    active: false,
+    ref: null,
+    resolvedHash: null,
+    resolvedDate: null,
+    activatedAt: null,
+};
+/** Read current time-travel state — exported for tools that opt in. */
+export function getTimeTravelState() {
+    return state;
+}
+/** Reset to live HEAD. Exported for tests. */
+export function resetTimeTravel() {
+    state = { active: false, ref: null, resolvedHash: null, resolvedDate: null, activatedAt: null };
+}
+function resolveRef(repoRoot, ref) {
+    // Validate against shell metacharacters before spawning.
+    if (!/^[a-zA-Z0-9._\-/^~@]+$/.test(ref)) {
+        return { error: `invalid ref shape: ${ref}` };
+    }
+    const r = spawnSync("git", ["log", "-1", "--pretty=format:%H|%cI|%s", ref], {
+        cwd: repoRoot,
+        stdio: ["ignore", "pipe", "pipe"],
+        encoding: "utf8",
+    });
+    if (r.status !== 0) {
+        return { error: `git could not resolve '${ref}': ${(r.stderr ?? "").trim().slice(0, 200)}` };
+    }
+    const out = (r.stdout ?? "").trim();
+    if (!out)
+        return { error: `ref '${ref}' resolved to empty result` };
+    const [hash, date, ...rest] = out.split("|");
+    if (!hash || !date)
+        return { error: `unparseable git output for '${ref}'` };
+    return { hash, date, subject: rest.join("|") };
+}
+export const timeTravelActivateTool = {
+    name: "mneme.timetravel.activate",
+    category: "meta",
+    description: "Freeze the AI agent's view of the repo at a specific git ref (commit hash, " +
+        "tag, branch, or relative ref like 'HEAD~50'). Every subsequent Mneme tool " +
+        "call within this MCP session operates AS IF today were that ref. Use WHEN " +
+        "you want to (a) recreate an incident-response state at a past moment, " +
+        "(b) audit hindsight bias by replaying decisions against frozen context, " +
+        "or (c) walk through the repo as a new engineer would have seen it on day one.",
+    whenToUse: "You want every subsequent Mneme call to operate AS IF today were a specific past commit — counterfactual / hindsight analysis.",
+    triggers: [
+        "freeze view at this commit",
+        "time travel to ref",
+        "what would I see at HEAD~50",
+    ],
+    inputSchema: {
+        type: "object",
+        properties: {
+            ref: {
+                type: "string",
+                description: "Git ref to freeze at — commit hash, tag, branch, or relative (e.g. 'HEAD~50', 'v1.5.0', 'a3f9b21').",
+            },
+        },
+        required: ["ref"],
+    },
+    outputSchema: {
+        type: "object",
+        properties: {
+            active: { type: "boolean" },
+            ref: { type: "string" },
+            resolvedHash: { type: "string" },
+            resolvedDate: { type: "string" },
+            subject: { type: "string" },
+        },
+    },
+    examples: [
+        {
+            userQuery: "Show me what the repo looked like at v1.5.0",
+            args: { ref: "v1.5.0" },
+            expectedOutput: "{ active: true, ref: 'v1.5.0', resolvedHash, resolvedDate, subject }. Subsequent tool calls that opt-in operate against this frozen ref.",
+        },
+        {
+            userQuery: "Recreate September 2024 — go back 200 commits",
+            args: { ref: "HEAD~200" },
+            expectedOutput: "Same shape — the resolvedDate tells you what calendar date HEAD~200 lands on.",
+        },
+    ],
+    pitfalls: [
+        "v1.18.0 ships the scaffolding — most tools DON'T yet honor the frozen ref. They'll silently use HEAD until each tool opts in over the v1.18 → v1.19 window.",
+        "State is per-MCP-process — restarting the server resets to live HEAD. Don't depend on persistence across server restarts.",
+        "Refs that don't resolve (deleted branches, typos, hashes from another repo) return an error and DO NOT activate.",
+    ],
+    composeWith: ["mneme.timetravel.status", "mneme.timetravel.deactivate"],
+    handler: async (rt, args) => {
+        const ref = String(args["ref"] ?? "").trim();
+        if (!ref) {
+            return {
+                data: { error: "missing required argument: ref" },
+                wisdom: "Pass a git ref — commit hash, tag, branch, or 'HEAD~N'.",
+                confidence: { level: "high" },
+            };
+        }
+        const resolved = resolveRef(rt.meta.rootPath, ref);
+        if ("error" in resolved) {
+            return {
+                data: { active: false, error: resolved.error },
+                wisdom: `Could not activate time-travel — ${resolved.error}`,
+                confidence: { level: "high" },
+            };
+        }
+        state = {
+            active: true,
+            ref,
+            resolvedHash: resolved.hash,
+            resolvedDate: resolved.date.slice(0, 10),
+            activatedAt: new Date().toISOString(),
+        };
+        return {
+            data: {
+                active: true,
+                ref,
+                resolvedHash: resolved.hash,
+                resolvedDate: resolved.date.slice(0, 10),
+                subject: resolved.subject,
+            },
+            wisdom: `Time-travel active — view frozen at ${ref} (${resolved.hash.slice(0, 7)}, ${resolved.date.slice(0, 10)}). ` +
+                `Subsequent tool calls in this session that have opted in will operate as-of this ref. ` +
+                `Call mneme.timetravel.deactivate to return to live HEAD.`,
+            followUp: ["mneme.memory.ask", "mneme.timetravel.status", "mneme.timetravel.deactivate"],
+            confidence: { level: "high" },
+        };
+    },
+};
+export const timeTravelStatusTool = {
+    name: "mneme.timetravel.status",
+    category: "meta",
+    description: "Report whether time-travel is currently active in this MCP session and, if so, " +
+        "which ref + commit + date the view is frozen at. Use WHEN you want to verify " +
+        "the agent isn't accidentally querying historical state when it expects live HEAD.",
+    whenToUse: "You want to check whether the current MCP session has time-travel activated and what ref it's frozen at.",
+    triggers: ["am I time-traveling", "time travel status", "what ref am I on"],
+    inputSchema: { type: "object", properties: {} },
+    outputSchema: {
+        type: "object",
+        properties: {
+            active: { type: "boolean" },
+            ref: { type: "string" },
+            resolvedHash: { type: "string" },
+            resolvedDate: { type: "string" },
+            activatedAt: { type: "string" },
+        },
+    },
+    examples: [
+        {
+            userQuery: "Am I currently time-traveling?",
+            expectedOutput: "Returns { active: false } when not active, or the full state record when active.",
+        },
+    ],
+    pitfalls: [
+        "State is per-MCP-process. If you restart the MCP server, this returns active=false even if a previous session activated time-travel.",
+    ],
+    composeWith: ["mneme.timetravel.activate", "mneme.timetravel.deactivate"],
+    handler: async () => {
+        return {
+            data: state,
+            wisdom: state.active
+                ? `Time-travel ACTIVE — frozen at ${state.ref} (${state.resolvedHash?.slice(0, 7)}, ${state.resolvedDate}).`
+                : "Time-travel INACTIVE — operating on live HEAD.",
+            confidence: { level: "high" },
+        };
+    },
+};
+export const timeTravelDeactivateTool = {
+    name: "mneme.timetravel.deactivate",
+    category: "meta",
+    description: "Return the AI agent's view to live HEAD — undoes a previous mneme.timetravel.activate. " +
+        "Idempotent (safe to call when not currently active). Use WHEN you've finished " +
+        "a counterfactual / hindsight session and want subsequent calls to see today's state.",
+    whenToUse: "You finished time-traveling and want subsequent tool calls to see live HEAD again.",
+    triggers: ["return to head", "stop time travel", "deactivate time travel"],
+    inputSchema: { type: "object", properties: {} },
+    outputSchema: {
+        type: "object",
+        properties: {
+            previouslyActive: { type: "boolean" },
+            previousRef: { type: "string" },
+        },
+    },
+    examples: [
+        {
+            userQuery: "Return to live HEAD",
+            expectedOutput: "{ previouslyActive: true|false, previousRef }. Idempotent — safe even when not active.",
+        },
+    ],
+    pitfalls: [
+        "Doesn't unwind any side effects from time-traveled tools — only resets the time-travel marker.",
+    ],
+    composeWith: ["mneme.timetravel.activate", "mneme.timetravel.status"],
+    handler: async () => {
+        const prev = { previouslyActive: state.active, previousRef: state.ref };
+        resetTimeTravel();
+        return {
+            data: prev,
+            wisdom: prev.previouslyActive
+                ? `Returned to live HEAD (was at ${prev.previousRef}).`
+                : "Was already on live HEAD — no change.",
+            confidence: { level: "high" },
+        };
+    },
+};
+export const timeTravelTools = [
+    timeTravelActivateTool,
+    timeTravelStatusTool,
+    timeTravelDeactivateTool,
+];
+//# sourceMappingURL=_timetravel.js.map

package/dist/tools/_timetravel.js.map

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

package/dist/tools/_timetravel.test.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Time-travel — tests for the per-process state machine. We don't test
+ * git resolution here (that's a runtime concern); we test that the
+ * state holder transitions correctly and stays per-process.
+ */
+export {};
+//# sourceMappingURL=_timetravel.test.d.ts.map

package/dist/tools/_timetravel.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"_timetravel.test.d.ts","sourceRoot":"","sources":["../../src/tools/_timetravel.test.ts"],"names":[],"mappings":"AAAA;;;;GAIG"}

package/dist/tools/_timetravel.test.js

@@ -0,0 +1,31 @@
+/**
+ * Time-travel — tests for the per-process state machine. We don't test
+ * git resolution here (that's a runtime concern); we test that the
+ * state holder transitions correctly and stays per-process.
+ */
+import { describe, expect, it, beforeEach } from "vitest";
+import { getTimeTravelState, resetTimeTravel } from "./_timetravel.js";
+describe("Time-travel state machine", () => {
+    beforeEach(() => {
+        resetTimeTravel();
+    });
+    it("starts inactive on a fresh process", () => {
+        const s = getTimeTravelState();
+        expect(s.active).toBe(false);
+        expect(s.ref).toBeNull();
+        expect(s.resolvedHash).toBeNull();
+    });
+    it("resetTimeTravel returns state to inactive", () => {
+        // Manually flip to active by simulating what activate would do —
+        // we can't call the tool handler without a runtime, but we can
+        // verify resetTimeTravel always returns to the inactive shape.
+        resetTimeTravel();
+        const s = getTimeTravelState();
+        expect(s.active).toBe(false);
+        expect(s.ref).toBeNull();
+        expect(s.resolvedHash).toBeNull();
+        expect(s.resolvedDate).toBeNull();
+        expect(s.activatedAt).toBeNull();
+    });
+});
+//# sourceMappingURL=_timetravel.test.js.map

package/dist/tools/_timetravel.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"_timetravel.test.js","sourceRoot":"","sources":["../../src/tools/_timetravel.test.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAC;AAC1D,OAAO,EAAE,kBAAkB,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAEvE,QAAQ,CAAC,2BAA2B,EAAE,GAAG,EAAE;IACzC,UAAU,CAAC,GAAG,EAAE;QACd,eAAe,EAAE,CAAC;IACpB,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,oCAAoC,EAAE,GAAG,EAAE;QAC5C,MAAM,CAAC,GAAG,kBAAkB,EAAE,CAAC;QAC/B,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAC7B,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,CAAC;QACzB,MAAM,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,QAAQ,EAAE,CAAC;IACpC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,2CAA2C,EAAE,GAAG,EAAE;QACnD,iEAAiE;QACjE,+DAA+D;QAC/D,+DAA+D;QAC/D,eAAe,EAAE,CAAC;QAClB,MAAM,CAAC,GAAG,kBAAkB,EAAE,CAAC;QAC/B,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAC7B,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,CAAC;QACzB,MAAM,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,QAAQ,EAAE,CAAC;QAClC,MAAM,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,QAAQ,EAAE,CAAC;QAClC,MAAM,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,QAAQ,EAAE,CAAC;IACnC,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/tools/_tool_meta.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Foundation tools (v1.18.0) — Tool Contract Schema introspection +
+ * discovery aids:
+ *
+ *   • mneme.tool.contract(name) — return the full 6-field contract for one tool
+ *     (WHEN, INPUT, OUTPUT, EXAMPLES, PITFALLS, COMPOSE_WITH, JARGON).
+ *   • mneme.tool.lint            — scan every registered tool, score the
+ *     contract quality, return a prioritized punch-list of weak/missing fields.
+ *   • mneme.help(query)          — sub-50ms top-5 tool matcher for free-text
+ *     queries. Lighter-weight than understand_intent (no execution plan,
+ *     no arg extraction — just "which tools are about this?").
+ *   • mneme.whats_new(lastSeenHash?) — diff vs the catalog hash an agent
+ *     remembered from a previous session. Returns adds / removes /
+ *     description-changes so the agent can update its mental model
+ *     without re-reading the entire catalog.
+ *
+ * All four are pure (no repo state, no LLM, no embedder) — safe to call
+ * from any agent at any time. They form the discovery surface that lets
+ * AI agents stay in sync with Mneme as it evolves.
+ */
+import type { MnemeTool } from "./_types.js";
+/** SHA-256 of the JSON-stringified catalog snapshot. Stable across runs. */
+export declare function computeCatalogHash(): string;
+export declare const toolContractTool: MnemeTool;
+export declare const toolLintTool: MnemeTool;
+export declare const helpTool: MnemeTool;
+export declare const whatsNewTool: MnemeTool;
+/** All four Foundation v1.18.0 tools — registered in the registry as a group. */
+export declare const toolMetaTools: MnemeTool[];
+//# sourceMappingURL=_tool_meta.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"_tool_meta.d.ts","sourceRoot":"","sources":["../../src/tools/_tool_meta.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAIH,OAAO,KAAK,EAAE,SAAS,EAAe,MAAM,aAAa,CAAC;AAoC1D,4EAA4E;AAC5E,wBAAgB,kBAAkB,IAAI,MAAM,CAG3C;AAID,eAAO,MAAM,gBAAgB,EAAE,SAsG9B,CAAC;AAiEF,eAAO,MAAM,YAAY,EAAE,SA8F1B,CAAC;AA0CF,eAAO,MAAM,QAAQ,EAAE,SAoFtB,CAAC;AAIF,eAAO,MAAM,YAAY,EAAE,SAqG1B,CAAC;AAEF,iFAAiF;AACjF,eAAO,MAAM,aAAa,EAAE,SAAS,EAA6D,CAAC"}