@sovant/claude-code-mcp 0.3.0

package/dist/commands/shared.d.ts

@@ -0,0 +1,56 @@
+/**
+ * Shared utilities for command handlers
+ *
+ * Manages thread initialization and caching across commands.
+ */
+import { type RepoInfo } from "../repo.js";
+/**
+ * Build standard tags for all memories
+ *
+ * Returns tags: source:claude-code, repo:<org/name>, and optionally branch:<branch>
+ */
+export declare function buildMemoryTags(repoInfo?: RepoInfo): string[];
+/**
+ * Initialize the thread for this repo
+ *
+ * 1. Try to load from .sovant/thread.json
+ * 2. If not found, create a new Sovant thread
+ * 3. Save the config if possible
+ * 4. Run session-start recall
+ */
+export declare function initializeThread(): Promise<{
+    threadId: string;
+    summary: string;
+    isNew: boolean;
+}>;
+/**
+ * Get the thread ID for the current repo
+ * Initializes if not already done
+ */
+export declare function getThreadId(): Promise<string>;
+/**
+ * Check if session has been initialized
+ */
+export declare function isSessionInitialized(): boolean;
+/**
+ * Get session summary (for explicit /status command if needed)
+ */
+export declare function getSessionSummary(): Promise<string>;
+/**
+ * Get thread info for the current repo
+ *
+ * Fetches live data from the API (thread title, memory count, created_at).
+ * Falls back to local-only data if the API call fails.
+ * Output includes a (live) or (local fallback) indicator.
+ */
+export declare function getThreadInfo(): Promise<{
+    repo: string;
+    thread_id: string;
+    thread_title: string;
+    memory_count?: number;
+    created_at?: string;
+    config_path: string;
+    branch?: string;
+    data_source: "live" | "local fallback";
+}>;
+//# sourceMappingURL=shared.d.ts.map

package/dist/commands/shared.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shared.d.ts","sourceRoot":"","sources":["../../src/commands/shared.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAe,KAAK,QAAQ,EAAE,MAAM,YAAY,CAAC;AAUxD;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,QAAQ,CAAC,EAAE,QAAQ,GAAG,MAAM,EAAE,CAe7D;AAQD;;;;;;;GAOG;AACH,wBAAsB,gBAAgB,IAAI,OAAO,CAAC;IAChD,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,OAAO,CAAC;CAChB,CAAC,CAiED;AAED;;;GAGG;AACH,wBAAsB,WAAW,IAAI,OAAO,CAAC,MAAM,CAAC,CAOnD;AAED;;GAEG;AACH,wBAAgB,oBAAoB,IAAI,OAAO,CAE9C;AA0BD;;GAEG;AACH,wBAAsB,iBAAiB,IAAI,OAAO,CAAC,MAAM,CAAC,CAGzD;AAED;;;;;;GAMG;AACH,wBAAsB,aAAa,IAAI,OAAO,CAAC;IAC7C,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,GAAG,gBAAgB,CAAC;CACxC,CAAC,CAkCD"}

package/dist/commands/shared.js

@@ -0,0 +1,182 @@
+/**
+ * Shared utilities for command handlers
+ *
+ * Manages thread initialization and caching across commands.
+ */
+import { getSovantClient, formatSovantError } from "../sovant.js";
+import { getRepoInfo } from "../repo.js";
+import { loadThreadConfig, saveThreadConfig, canWriteConfig, getConfigPath, } from "../localStore.js";
+import { formatSessionSummary } from "../format.js";
+/**
+ * Build standard tags for all memories
+ *
+ * Returns tags: source:claude-code, repo:<org/name>, and optionally branch:<branch>
+ */
+export function buildMemoryTags(repoInfo) {
+    const info = repoInfo || getRepoInfo();
+    const tags = ["source:claude-code"];
+    // Always add repo tag
+    if (info.repo) {
+        tags.push(`repo:${info.repo}`);
+    }
+    // Add branch tag if available
+    if (info.branch) {
+        tags.push(`branch:${info.branch}`);
+    }
+    return tags;
+}
+/** Cached thread ID for the current session */
+let cachedThreadId = null;
+/** Whether we've run session initialization */
+let sessionInitialized = false;
+/**
+ * Initialize the thread for this repo
+ *
+ * 1. Try to load from .sovant/thread.json
+ * 2. If not found, create a new Sovant thread
+ * 3. Save the config if possible
+ * 4. Run session-start recall
+ */
+export async function initializeThread() {
+    const repoInfo = getRepoInfo();
+    const client = getSovantClient();
+    // Try to load existing config
+    let config = loadThreadConfig();
+    if (config && config.repo === repoInfo.repo) {
+        // Existing thread for this repo
+        cachedThreadId = config.thread_id;
+        // Update last_seen
+        config.last_seen = new Date().toISOString();
+        saveThreadConfig(config);
+        // Run session-start recall
+        const summary = await runSessionRecall(config.thread_id);
+        sessionInitialized = true;
+        return {
+            threadId: config.thread_id,
+            summary,
+            isNew: false,
+        };
+    }
+    // Create new thread
+    try {
+        const createdAt = new Date().toISOString();
+        const result = await client.threads.create({
+            title: repoInfo.repo,
+            description: `Project memory for ${repoInfo.repo}`,
+            metadata: {
+                source: "claude-code",
+                repo: repoInfo.repo,
+                branch: repoInfo.branch,
+                created_at: createdAt,
+            },
+        });
+        const threadId = result.id;
+        cachedThreadId = threadId;
+        // Save config
+        const newConfig = {
+            thread_id: threadId,
+            repo: repoInfo.repo,
+            created_at: new Date().toISOString(),
+            last_seen: new Date().toISOString(),
+        };
+        const saved = saveThreadConfig(newConfig);
+        if (!saved && canWriteConfig()) {
+            console.warn("[sovant] Could not persist thread config to disk");
+        }
+        sessionInitialized = true;
+        return {
+            threadId,
+            summary: `Created new project thread for ${repoInfo.repo}. Start saving memories with /remember.`,
+            isNew: true,
+        };
+    }
+    catch (error) {
+        throw new Error(`Failed to create thread: ${formatSovantError(error)}`);
+    }
+}
+/**
+ * Get the thread ID for the current repo
+ * Initializes if not already done
+ */
+export async function getThreadId() {
+    if (cachedThreadId) {
+        return cachedThreadId;
+    }
+    const { threadId } = await initializeThread();
+    return threadId;
+}
+/**
+ * Check if session has been initialized
+ */
+export function isSessionInitialized() {
+    return sessionInitialized;
+}
+/**
+ * Run session-start recall and format summary
+ */
+async function runSessionRecall(threadId) {
+    try {
+        const client = getSovantClient();
+        // Recall important project context
+        const result = await client.memory.recall({
+            query: "Summarize the most important decisions, constraints, preferences, and open TODOs for this project.",
+            thread_id: threadId,
+            limit: 8,
+        });
+        const results = result?.results || [];
+        return formatSessionSummary(results);
+    }
+    catch (error) {
+        console.error("[sovant] Session recall failed:", error);
+        return "Could not load project context. Memories are still accessible via /recall.";
+    }
+}
+/**
+ * Get session summary (for explicit /status command if needed)
+ */
+export async function getSessionSummary() {
+    const threadId = await getThreadId();
+    return runSessionRecall(threadId);
+}
+/**
+ * Get thread info for the current repo
+ *
+ * Fetches live data from the API (thread title, memory count, created_at).
+ * Falls back to local-only data if the API call fails.
+ * Output includes a (live) or (local fallback) indicator.
+ */
+export async function getThreadInfo() {
+    const repoInfo = getRepoInfo();
+    const threadId = await getThreadId();
+    const configPath = getConfigPath();
+    // Try to fetch live thread data from the API
+    try {
+        const client = getSovantClient();
+        const result = await client.threads.get(threadId, {
+            include_memories: false,
+        });
+        const thread = result.thread;
+        return {
+            repo: repoInfo.repo,
+            thread_id: threadId,
+            thread_title: thread.title || repoInfo.repo,
+            memory_count: thread.memory_ids?.length,
+            created_at: thread.created_at,
+            config_path: configPath,
+            branch: repoInfo.branch,
+            data_source: "live",
+        };
+    }
+    catch {
+        // API unavailable — return local-only data
+        return {
+            repo: repoInfo.repo,
+            thread_id: threadId,
+            thread_title: repoInfo.repo,
+            config_path: configPath,
+            branch: repoInfo.branch,
+            data_source: "local fallback",
+        };
+    }
+}
+//# sourceMappingURL=shared.js.map

package/dist/commands/shared.js.map

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

package/dist/format.d.ts

@@ -0,0 +1,54 @@
+/**
+ * Output formatting utilities for Claude Code MCP plugin
+ *
+ * Formats Sovant API responses into human-readable text
+ * optimized for display in Claude Code.
+ */
+export interface MemoryItem {
+    id: string;
+    content: string;
+    type: string;
+    tags?: string[];
+    created_at?: string;
+    relevance?: number;
+    importance_score?: number;
+}
+/**
+ * Truncate text to a maximum length, adding ellipsis if needed
+ */
+export declare function truncate(text: string, maxLength?: number): string;
+/**
+ * Shorten a UUID for display (first 8 chars)
+ */
+export declare function shortId(id: string): string;
+/**
+ * Format a date for display
+ */
+export declare function formatDate(dateStr: string | undefined): string;
+/**
+ * Format a single memory for list display
+ */
+export declare function formatMemoryListItem(memory: MemoryItem): string;
+/**
+ * Format a single memory for recall display (with relevance)
+ */
+export declare function formatRecallItem(memory: MemoryItem, index: number): string;
+/**
+ * Format a list of memories for display
+ */
+export declare function formatMemoryList(memories: MemoryItem[], total?: number): string;
+/**
+ * Format recall results for display
+ */
+export declare function formatRecallResults(results: MemoryItem[], query: string): string;
+/**
+ * Format search results with explicit scope header
+ *
+ * When showRepo is true (global scope), prints the repo tag for each result.
+ */
+export declare function formatSearchResults(results: MemoryItem[], query: string, scopeHeader: string, showRepo: boolean): string;
+/**
+ * Format session start summary grouped by type
+ */
+export declare function formatSessionSummary(memories: MemoryItem[]): string;
+//# sourceMappingURL=format.d.ts.map

package/dist/format.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"format.d.ts","sourceRoot":"","sources":["../src/format.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED;;GAEG;AACH,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,GAAE,MAAY,GAAG,MAAM,CAGtE;AAED;;GAEG;AACH,wBAAgB,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAE1C;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,CAc9D;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,UAAU,GAAG,MAAM,CAO/D;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAS1E;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAC9B,QAAQ,EAAE,UAAU,EAAE,EACtB,KAAK,CAAC,EAAE,MAAM,GACb,MAAM,CAYR;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,UAAU,EAAE,EACrB,KAAK,EAAE,MAAM,GACZ,MAAM,CAOR;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,UAAU,EAAE,EACrB,KAAK,EAAE,MAAM,EACb,WAAW,EAAE,MAAM,EACnB,QAAQ,EAAE,OAAO,GAChB,MAAM,CAoBR;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,UAAU,EAAE,GAAG,MAAM,CA+DnE"}

package/dist/format.js

@@ -0,0 +1,158 @@
+/**
+ * Output formatting utilities for Claude Code MCP plugin
+ *
+ * Formats Sovant API responses into human-readable text
+ * optimized for display in Claude Code.
+ */
+/**
+ * Truncate text to a maximum length, adding ellipsis if needed
+ */
+export function truncate(text, maxLength = 120) {
+    if (text.length <= maxLength)
+        return text;
+    return text.slice(0, maxLength - 3) + "...";
+}
+/**
+ * Shorten a UUID for display (first 8 chars)
+ */
+export function shortId(id) {
+    return id.slice(0, 8);
+}
+/**
+ * Format a date for display
+ */
+export function formatDate(dateStr) {
+    if (!dateStr)
+        return "unknown";
+    try {
+        const date = new Date(dateStr);
+        return date.toLocaleDateString("en-US", {
+            month: "short",
+            day: "numeric",
+            hour: "2-digit",
+            minute: "2-digit",
+        });
+    }
+    catch {
+        return dateStr;
+    }
+}
+/**
+ * Format a single memory for list display
+ */
+export function formatMemoryListItem(memory) {
+    const id = shortId(memory.id);
+    const type = memory.type || "unknown";
+    const date = formatDate(memory.created_at);
+    const content = truncate(memory.content.replace(/\n/g, " "));
+    return `[${id}] ${type} (${date})\n  ${content}`;
+}
+/**
+ * Format a single memory for recall display (with relevance)
+ */
+export function formatRecallItem(memory, index) {
+    const id = shortId(memory.id);
+    const type = memory.type || "unknown";
+    const content = truncate(memory.content.replace(/\n/g, " "));
+    const relevance = memory.relevance
+        ? ` (${Math.round(memory.relevance * 100)}%)`
+        : "";
+    return `${index + 1}. [${id}] ${type}${relevance}\n   ${content}`;
+}
+/**
+ * Format a list of memories for display
+ */
+export function formatMemoryList(memories, total) {
+    if (memories.length === 0) {
+        return "No memories found.";
+    }
+    const lines = memories.map((m) => formatMemoryListItem(m));
+    const header = total !== undefined
+        ? `Showing ${memories.length} of ${total} memories:\n`
+        : `Found ${memories.length} memories:\n`;
+    return header + lines.join("\n\n");
+}
+/**
+ * Format recall results for display
+ */
+export function formatRecallResults(results, query) {
+    if (results.length === 0) {
+        return `No relevant memories found for: "${query}"`;
+    }
+    const lines = results.map((m, i) => formatRecallItem(m, i));
+    return `Found ${results.length} relevant memories:\n\n` + lines.join("\n\n");
+}
+/**
+ * Format search results with explicit scope header
+ *
+ * When showRepo is true (global scope), prints the repo tag for each result.
+ */
+export function formatSearchResults(results, query, scopeHeader, showRepo) {
+    if (results.length === 0) {
+        return `${scopeHeader}\n\nNo results found for: "${query}"`;
+    }
+    const lines = results.map((m, i) => {
+        const base = formatRecallItem(m, i);
+        if (showRepo) {
+            const repoTag = (m.tags || []).find((t) => t.startsWith("repo:"));
+            if (repoTag) {
+                return `${base}\n   Repo: ${repoTag.replace("repo:", "")}`;
+            }
+        }
+        return base;
+    });
+    return (`${scopeHeader}\n\nFound ${results.length} results:\n\n` +
+        lines.join("\n\n"));
+}
+/**
+ * Format session start summary grouped by type
+ */
+export function formatSessionSummary(memories) {
+    if (memories.length === 0) {
+        return "No project context loaded. Start saving memories with /remember.";
+    }
+    // Group by type/tag
+    const groups = {
+        decisions: [],
+        preferences: [],
+        tasks: [],
+        other: [],
+    };
+    for (const memory of memories) {
+        const tags = memory.tags || [];
+        const type = memory.type || "journal";
+        if (tags.includes("decision") || type === "insight") {
+            groups.decisions.push(memory);
+        }
+        else if (type === "preference" || tags.includes("preference")) {
+            groups.preferences.push(memory);
+        }
+        else if (type === "task" || tags.includes("todo")) {
+            groups.tasks.push(memory);
+        }
+        else {
+            groups.other.push(memory);
+        }
+    }
+    const sections = [];
+    if (groups.decisions.length > 0) {
+        sections.push("**Decisions:**\n" +
+            groups.decisions.map((m) => `- ${truncate(m.content, 100)}`).join("\n"));
+    }
+    if (groups.preferences.length > 0) {
+        sections.push("**Preferences:**\n" +
+            groups.preferences
+                .map((m) => `- ${truncate(m.content, 100)}`)
+                .join("\n"));
+    }
+    if (groups.tasks.length > 0) {
+        sections.push("**Tasks/TODOs:**\n" +
+            groups.tasks.map((m) => `- ${truncate(m.content, 100)}`).join("\n"));
+    }
+    if (groups.other.length > 0) {
+        sections.push("**Other notes:**\n" +
+            groups.other.map((m) => `- ${truncate(m.content, 100)}`).join("\n"));
+    }
+    return (`Loaded ${memories.length} project memories:\n\n` + sections.join("\n\n"));
+}
+//# sourceMappingURL=format.js.map

package/dist/format.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,14 @@
+#!/usr/bin/env node
+/**
+ * Sovant MCP Server for Claude Code
+ *
+ * Provides persistent project memory through Sovant's governed memory layer.
+ * Creates/loads a thread per git repository and exposes tools for:
+ * - Saving memories (/remember, /remember-pref, /remember-decision)
+ * - Recalling memories (/recall)
+ * - Managing memories (/memory list, /memory delete)
+ *
+ * On session start, runs a recall to load project context.
+ */
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA;;;;;;;;;;GAUG"}