gitmem-mcp 0.2.0

package/dist/schemas/thread.js

@@ -0,0 +1,39 @@
+/**
+ * Zod schemas for thread lifecycle tools (OD-thread-lifecycle)
+ */
+import { z } from "zod";
+import { ProjectSchema } from "./common.js";
+/**
+ * Thread status enum
+ */
+export const ThreadStatusSchema = z.enum(["open", "resolved"]);
+/**
+ * Thread object schema (structured thread with lifecycle)
+ */
+export const ThreadObjectSchema = z.object({
+    id: z.string(),
+    text: z.string(),
+    status: ThreadStatusSchema,
+    created_at: z.string(),
+    resolved_at: z.string().optional(),
+    source_session: z.string().optional(),
+    resolved_by_session: z.string().optional(),
+    resolution_note: z.string().optional(),
+});
+/**
+ * list_threads parameters
+ */
+export const ListThreadsParamsSchema = z.object({
+    status: ThreadStatusSchema.optional(),
+    include_resolved: z.boolean().optional(),
+    project: ProjectSchema.optional(),
+});
+/**
+ * resolve_thread parameters
+ */
+export const ResolveThreadParamsSchema = z.object({
+    thread_id: z.string().optional(),
+    text_match: z.string().optional(),
+    resolution_note: z.string().optional(),
+});
+//# sourceMappingURL=thread.js.map

package/dist/schemas/thread.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"thread.js","sourceRoot":"","sources":["../../src/schemas/thread.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAE5C;;GAEG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC,CAAC;AAE/D;;GAEG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,CAAC,MAAM,CAAC;IACzC,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE;IACd,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;IAChB,MAAM,EAAE,kBAAkB;IAC1B,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE;IACtB,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAClC,cAAc,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACrC,mBAAmB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC1C,eAAe,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CACvC,CAAC,CAAC;AAEH;;GAEG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC9C,MAAM,EAAE,kBAAkB,CAAC,QAAQ,EAAE;IACrC,gBAAgB,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;IACxC,OAAO,EAAE,aAAa,CAAC,QAAQ,EAAE;CAClC,CAAC,CAAC;AAEH;;GAEG;AACH,MAAM,CAAC,MAAM,yBAAyB,GAAG,CAAC,CAAC,MAAM,CAAC;IAChD,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAChC,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACjC,eAAe,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CACvC,CAAC,CAAC"}

package/dist/server.d.ts

@@ -0,0 +1,22 @@
+/**
+ * GitMem MCP Server
+ *
+ * Registers all tools and handles MCP protocol communication.
+ * Tool definitions are in ./tools/definitions.ts
+ */
+import { Server } from "@modelcontextprotocol/sdk/server/index.js";
+/**
+ * Create and configure the MCP server
+ */
+export declare function createServer(): Server;
+/**
+ * Run the server with stdio transport
+ *
+ * OD-473: Initializes local vector search in background for fast startup.
+ * OD-489: Uses direct Supabase queries to get embeddings for local cache.
+ *
+ * Server starts immediately; cache loads in background.
+ * First few queries may use Supabase fallback until cache is ready.
+ */
+export declare function runServer(): Promise<void>;
+//# sourceMappingURL=server.d.ts.map

package/dist/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,2CAA2C,CAAC;AAqEnE;;GAEG;AACH,wBAAgB,YAAY,IAAI,MAAM,CAyQrC;AAED;;;;;;;;GAQG;AACH,wBAAsB,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC,CA0B/C"}

package/dist/server.js

@@ -0,0 +1,313 @@
+/**
+ * GitMem MCP Server
+ *
+ * Registers all tools and handles MCP protocol communication.
+ * Tool definitions are in ./tools/definitions.ts
+ */
+import { Server } from "@modelcontextprotocol/sdk/server/index.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { CallToolRequestSchema, ListToolsRequestSchema, } from "@modelcontextprotocol/sdk/types.js";
+import { sessionStart, sessionRefresh } from "./tools/session-start.js";
+import { sessionClose } from "./tools/session-close.js";
+import { createLearning } from "./tools/create-learning.js";
+import { createDecision } from "./tools/create-decision.js";
+import { recordScarUsage } from "./tools/record-scar-usage.js";
+import { recordScarUsageBatch } from "./tools/record-scar-usage-batch.js";
+import { recall } from "./tools/recall.js";
+import { confirmScars } from "./tools/confirm-scars.js";
+import { saveTranscript } from "./tools/save-transcript.js";
+import { getTranscript } from "./tools/get-transcript.js";
+import { search } from "./tools/search.js";
+import { log } from "./tools/log.js";
+import { analyze } from "./tools/analyze.js";
+import { graphTraverse } from "./tools/graph-traverse.js";
+import { prepareContext } from "./tools/prepare-context.js";
+import { absorbObservations } from "./tools/absorb-observations.js";
+import { listThreads } from "./tools/list-threads.js";
+import { resolveThread } from "./tools/resolve-thread.js";
+import { createThread } from "./tools/create-thread.js";
+import { promoteSuggestion } from "./tools/promote-suggestion.js";
+import { dismissSuggestion } from "./tools/dismiss-suggestion.js";
+import { cleanupThreads } from "./tools/cleanup-threads.js";
+import { getCacheStatus, checkCacheHealth, flushCache, startBackgroundInit, } from "./services/startup.js";
+import { getTier, hasSupabase, hasCacheManagement, hasBatchOperations, hasTranscripts, } from "./services/tier.js";
+import { getRegisteredTools } from "./tools/definitions.js";
+/**
+ * Create and configure the MCP server
+ */
+export function createServer() {
+    const server = new Server({
+        name: "gitmem-mcp",
+        version: "0.1.0",
+    }, {
+        capabilities: {
+            tools: {},
+        },
+    });
+    // Register list tools handler (tier-gated)
+    const registeredTools = getRegisteredTools();
+    const registeredToolNames = new Set(registeredTools.map(t => t.name));
+    server.setRequestHandler(ListToolsRequestSchema, async () => ({
+        tools: registeredTools,
+    }));
+    // Register call tool handler
+    server.setRequestHandler(CallToolRequestSchema, async (request) => {
+        const { name, arguments: args } = request.params;
+        const toolArgs = (args || {});
+        // Guard: reject calls to tools not available in current tier
+        if (!registeredToolNames.has(name)) {
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: JSON.stringify({ error: `Unknown tool: ${name}. Available tools depend on your GitMem tier (current: ${getTier()}).` }),
+                    },
+                ],
+                isError: true,
+            };
+        }
+        try {
+            let result;
+            switch (name) {
+                case "recall":
+                case "gitmem-r":
+                    result = await recall(toolArgs);
+                    break;
+                case "confirm_scars":
+                case "gitmem-cs":
+                case "gm-confirm":
+                    result = await confirmScars(toolArgs);
+                    break;
+                case "session_start":
+                case "gitmem-ss":
+                case "gm-open":
+                    result = await sessionStart(toolArgs);
+                    break;
+                case "session_refresh":
+                case "gitmem-sr":
+                case "gm-refresh":
+                    result = await sessionRefresh(toolArgs);
+                    break;
+                case "session_close":
+                case "gitmem-sc":
+                case "gm-close":
+                    result = await sessionClose(toolArgs);
+                    break;
+                case "create_learning":
+                case "gitmem-cl":
+                case "gm-scar":
+                    result = await createLearning(toolArgs);
+                    break;
+                case "create_decision":
+                case "gitmem-cd":
+                    result = await createDecision(toolArgs);
+                    break;
+                case "record_scar_usage":
+                case "gitmem-rs":
+                    result = await recordScarUsage(toolArgs);
+                    break;
+                case "record_scar_usage_batch":
+                case "gitmem-rsb":
+                    result = await recordScarUsageBatch(toolArgs);
+                    break;
+                case "save_transcript":
+                case "gitmem-st":
+                    result = await saveTranscript(toolArgs);
+                    break;
+                case "get_transcript":
+                case "gitmem-gt":
+                    result = await getTranscript(toolArgs);
+                    break;
+                case "search":
+                case "gitmem-search":
+                case "gm-search":
+                    result = await search(toolArgs);
+                    break;
+                case "log":
+                case "gitmem-log":
+                case "gm-log":
+                    result = await log(toolArgs);
+                    break;
+                case "analyze":
+                case "gitmem-analyze":
+                case "gm-analyze":
+                    result = await analyze(toolArgs);
+                    break;
+                case "prepare_context":
+                case "gitmem-pc":
+                case "gm-pc":
+                    result = await prepareContext(toolArgs);
+                    break;
+                case "absorb_observations":
+                case "gitmem-ao":
+                case "gm-absorb":
+                    result = await absorbObservations(toolArgs);
+                    break;
+                case "list_threads":
+                case "gitmem-lt":
+                case "gm-threads":
+                    result = await listThreads(toolArgs);
+                    break;
+                case "resolve_thread":
+                case "gitmem-rt":
+                case "gm-resolve":
+                    result = await resolveThread(toolArgs);
+                    break;
+                case "create_thread":
+                case "gitmem-ct":
+                case "gm-thread-new":
+                    result = await createThread(toolArgs);
+                    break;
+                case "promote_suggestion":
+                case "gitmem-ps":
+                case "gm-promote":
+                    result = await promoteSuggestion(toolArgs);
+                    break;
+                case "dismiss_suggestion":
+                case "gitmem-ds":
+                case "gm-dismiss":
+                    result = await dismissSuggestion(toolArgs);
+                    break;
+                case "cleanup_threads":
+                case "gitmem-cleanup":
+                case "gm-cleanup":
+                    result = await cleanupThreads(toolArgs);
+                    break;
+                case "gitmem-help": {
+                    const tier = getTier();
+                    const commands = [
+                        { alias: "gitmem-r", full: "recall", description: "Check scars before taking action" },
+                        { alias: "gitmem-cs", full: "confirm_scars", description: "Confirm recalled scars (APPLYING/N_A/REFUTED)" },
+                        { alias: "gitmem-ss", full: "session_start", description: "Initialize session with context" },
+                        { alias: "gitmem-sc", full: "session_close", description: "Close session with compliance validation" },
+                        { alias: "gitmem-cl", full: "create_learning", description: "Create scar/win/pattern entry" },
+                        { alias: "gitmem-cd", full: "create_decision", description: "Log architectural/operational decision" },
+                        { alias: "gitmem-rs", full: "record_scar_usage", description: "Track scar application" },
+                        { alias: "gitmem-search", full: "search", description: "Search institutional memory (exploration)" },
+                        { alias: "gitmem-log", full: "log", description: "List recent learnings chronologically" },
+                        { alias: "gitmem-analyze", full: "analyze", description: "Session analytics and insights" },
+                        { alias: "gitmem-pc", full: "prepare_context", description: "Generate memory payload for sub-agents" },
+                        { alias: "gitmem-ao", full: "absorb_observations", description: "Capture sub-agent/teammate observations" },
+                        { alias: "gitmem-lt", full: "list_threads", description: "List open threads across sessions" },
+                        { alias: "gitmem-rt", full: "resolve_thread", description: "Mark a thread as resolved" },
+                        { alias: "gitmem-ps", full: "promote_suggestion", description: "Promote a suggested thread to open thread" },
+                        { alias: "gitmem-ds", full: "dismiss_suggestion", description: "Dismiss a suggested thread" },
+                        { alias: "gitmem-cleanup", full: "cleanup_threads", description: "Triage threads by lifecycle health" },
+                    ];
+                    if (hasBatchOperations()) {
+                        commands.push({ alias: "gitmem-rsb", full: "record_scar_usage_batch", description: "Track multiple scars (batch)" });
+                    }
+                    if (hasTranscripts()) {
+                        commands.push({ alias: "gitmem-st", full: "save_transcript", description: "Save session transcript to storage" }, { alias: "gitmem-gt", full: "get_transcript", description: "Retrieve session transcript" });
+                    }
+                    if (hasCacheManagement()) {
+                        commands.push({ alias: "gitmem-cache-status", full: "cache_status", description: "Show cache status" }, { alias: "gitmem-cache-health", full: "cache_health", description: "Compare local vs remote" }, { alias: "gitmem-cache-flush", full: "cache_flush", description: "Force reload from Supabase" });
+                    }
+                    // Output colored header directly to terminal (stderr)
+                    console.error(`
+\x1b[31m╔═══════════════════════════════════════════════════════════╗\x1b[0m
+\x1b[31m║\x1b[0m                                                           \x1b[31m║\x1b[0m
+\x1b[31m║    ██████  ██ ████████ ███    ███ ███████ ███    ███      ║\x1b[0m
+\x1b[38;5;208m║   ██       ██    ██    ████  ████ ██      ████  ████      ║\x1b[0m
+\x1b[38;5;208m║   ██   ███ ██    ██    ██ ████ ██ █████   ██ ████ ██      ║\x1b[0m
+\x1b[33m║   ██    ██ ██    ██    ██  ██  ██ ██      ██  ██  ██      ║\x1b[0m
+\x1b[33m║    ██████  ██    ██    ██      ██ ███████ ██      ██      ║\x1b[0m
+\x1b[33m║\x1b[0m                                                           \x1b[33m║\x1b[0m
+\x1b[38;5;208m║\x1b[0m         \x1b[1;37mInstitutional Memory & Learning System\x1b[0m            \x1b[38;5;208m║\x1b[0m
+\x1b[31m║\x1b[0m              \x1b[3;90mNever repeat the same mistake\x1b[0m                \x1b[31m║\x1b[0m
+\x1b[31m║\x1b[0m                                                           \x1b[31m║\x1b[0m
+\x1b[31m╚═══════════════════════════════════════════════════════════╝\x1b[0m
+`);
+                    // Return plain JSON result (no header - it's already printed above)
+                    result = {
+                        version: "0.1.0",
+                        tier,
+                        tools_registered: registeredTools.length,
+                        storage: hasSupabase() ? "supabase" : "local (.gitmem/)",
+                        commands,
+                    };
+                    break;
+                }
+                // Knowledge graph traversal (Phase 3)
+                case "graph_traverse":
+                case "gitmem-graph":
+                case "gm-graph":
+                    result = await graphTraverse(toolArgs);
+                    break;
+                // Cache management tools (OD-473)
+                case "gitmem-cache-status":
+                case "gm-cache-s":
+                    result = getCacheStatus(toolArgs.project || "orchestra_dev");
+                    break;
+                case "gitmem-cache-health":
+                case "gm-cache-h":
+                    result = await checkCacheHealth(toolArgs.project || "orchestra_dev");
+                    break;
+                case "gitmem-cache-flush":
+                case "gm-cache-f":
+                    result = await flushCache(toolArgs.project || "orchestra_dev");
+                    break;
+                default:
+                    throw new Error(`Unknown tool: ${name}`);
+            }
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: (result && typeof result === "object" && "display" in result && typeof result.display === "string")
+                            ? result.display
+                            : (result && typeof result === "object" && "text" in result && typeof result.text === "string")
+                                ? result.text
+                                : JSON.stringify(result, null, 2),
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: JSON.stringify({ error: message }),
+                    },
+                ],
+                isError: true,
+            };
+        }
+    });
+    return server;
+}
+/**
+ * Run the server with stdio transport
+ *
+ * OD-473: Initializes local vector search in background for fast startup.
+ * OD-489: Uses direct Supabase queries to get embeddings for local cache.
+ *
+ * Server starts immediately; cache loads in background.
+ * First few queries may use Supabase fallback until cache is ready.
+ */
+export async function runServer() {
+    const tier = getTier();
+    // Start server immediately (don't block on cache loading)
+    const server = createServer();
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    const toolCount = getRegisteredTools().length;
+    const storage = hasSupabase() ? "supabase" : "local";
+    console.error(`[gitmem] Tier: ${tier} | Storage: ${storage} | Tools: ${toolCount}`);
+    if (hasSupabase()) {
+        // Pro/Dev: Initialize local vector search in background (non-blocking)
+        // This loads scars with embeddings directly from Supabase REST API
+        console.error("[gitmem] Starting background cache initialization...");
+        startBackgroundInit("orchestra_dev");
+        // Also init weekend_warrior if needed (non-blocking)
+        startBackgroundInit("weekend_warrior");
+        console.error("[gitmem] Server ready | Cache loading in background");
+    }
+    else {
+        // Free tier: no Supabase cache to load
+        console.error("[gitmem] Server ready | Using local storage (.gitmem/)");
+    }
+}
+//# sourceMappingURL=server.js.map

package/dist/server.js.map

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

package/dist/services/active-sessions.d.ts

@@ -0,0 +1,66 @@
+/**
+ * Active Sessions Registry (GIT-19)
+ *
+ * CRUD operations for .gitmem/active-sessions.json — the multi-session
+ * registry that tracks all running MCP server sessions.
+ *
+ * Key design decisions:
+ * - Atomic writes (write-temp-rename) because multiple processes may
+ *   register/unregister concurrently.
+ * - Sync I/O to match codebase convention (fs.writeFileSync etc).
+ * - Graceful degradation: corrupted registry = start fresh.
+ */
+import type { ActiveSessionEntry } from "../types/index.js";
+/**
+ * Register a new session in the active-sessions registry.
+ * Idempotent: re-registering the same session_id replaces the entry.
+ */
+export declare function registerSession(entry: ActiveSessionEntry): void;
+/**
+ * Unregister a session from the active-sessions registry.
+ * Returns true if the session was found and removed.
+ */
+export declare function unregisterSession(sessionId: string): boolean;
+/**
+ * List all active sessions from the registry.
+ */
+export declare function listActiveSessions(): ActiveSessionEntry[];
+/**
+ * Find a session by hostname and PID.
+ * Used by session_start to detect if this process already has a registered session.
+ */
+export declare function findSessionByHostPid(hostname: string, pid: number): ActiveSessionEntry | null;
+/**
+ * Find a session by session_id.
+ */
+export declare function findSessionById(sessionId: string): ActiveSessionEntry | null;
+/**
+ * Prune stale sessions from the registry (GIT-22 enhanced).
+ *
+ * A session is stale if:
+ * 1. Its started_at is older than 24 hours, OR
+ * 2. Its PID no longer exists on this hostname (process died without cleanup), OR
+ * 3. Its per-session directory/session.json is missing (orphaned registry entry)
+ *
+ * Also cleans up per-session directories for pruned sessions,
+ * and removes orphaned session directories with no registry entry.
+ * Returns the number of sessions pruned.
+ */
+export declare function pruneStale(): number;
+/**
+ * GIT-23: Migrate from old active-session.json (singular) to new multi-session format.
+ *
+ * Runs once per process. If old file exists and new registry does not:
+ * 1. Read old file
+ * 2. Create per-session directory with session.json
+ * 3. Create active-sessions.json registry with single entry
+ * 4. Rename old file to active-session.json.migrated (backup)
+ *
+ * Idempotent: skips if new registry already exists or old file is absent.
+ */
+export declare function migrateFromLegacy(): boolean;
+/**
+ * Reset migration flag (for testing only).
+ */
+export declare function resetMigrationFlag(): void;
+//# sourceMappingURL=active-sessions.d.ts.map

package/dist/services/active-sessions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"active-sessions.d.ts","sourceRoot":"","sources":["../../src/services/active-sessions.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAOH,OAAO,KAAK,EAAE,kBAAkB,EAA0B,MAAM,mBAAmB,CAAC;AAyEpF;;;GAGG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,kBAAkB,GAAG,IAAI,CAQ/D;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAc5D;AAED;;GAEG;AACH,wBAAgB,kBAAkB,IAAI,kBAAkB,EAAE,CAEzD;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,kBAAkB,GAAG,IAAI,CAG7F;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,kBAAkB,GAAG,IAAI,CAG5E;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,UAAU,IAAI,MAAM,CA2DnC;AAyDD;;;;;;;;;;GAUG;AACH,wBAAgB,iBAAiB,IAAI,OAAO,CAsD3C;AAED;;GAEG;AACH,wBAAgB,kBAAkB,IAAI,IAAI,CAEzC"}