@vinaes/succ 1.3.19

package/dist/mcp/helpers.js

@@ -0,0 +1,244 @@
+/**
+ * MCP Server helper utilities
+ *
+ * Shared helpers used across MCP tool and resource handlers:
+ * - setupGracefulShutdown: Process signal handlers
+ * - trackTokenSavings: Track RAG query token savings
+ * - trackMemoryAccess: Track memory access for retention decay
+ * - getBrainPath: Get brain vault directory path
+ * - parseRelativeDate: Parse relative date strings
+ * - createToolResponse / createErrorResponse: DRY response helpers
+ */
+import path from 'path';
+import fs from 'fs';
+import { z } from 'zod';
+import { closeDb, closeGlobalDb, closeStorageDispatcher, initStorageDispatcher, incrementMemoryAccessBatch, recordTokenStat, getStorageDispatcher, getMemoryStats, } from '../lib/storage/index.js';
+import { getProjectRoot, getSuccDir, invalidateConfigCache } from '../lib/config.js';
+import { logFault, logWarn } from '../lib/fault-logger.js';
+import { cleanupEmbeddings } from '../lib/embeddings.js';
+import { cleanupQualityScoring } from '../lib/quality.js';
+import { countTokens, countTokensArray } from '../lib/token-counter.js';
+import { estimateSavings, getCurrentModel } from '../lib/pricing.js';
+// Shared Zod param for project_path — add to every tool schema
+export const projectPathParam = z
+    .string()
+    .optional()
+    .describe('Project directory path. Pass cwd of your project to use project-local data instead of global.');
+// Track current project to avoid redundant reinit
+let _currentProject = null;
+/**
+ * Set the current project (called once after initStorageDispatcher at startup)
+ */
+export function setCurrentProject(projectPath) {
+    _currentProject = path.resolve(projectPath);
+}
+/**
+ * Apply project_path from tool call params.
+ * If provided and different from current project, sets SUCC_PROJECT_ROOT
+ * and reinitializes storage dispatcher to use the correct database.
+ */
+export async function applyProjectPath(projectPath) {
+    if (!projectPath)
+        return;
+    // Normalize: forward slashes to OS separators, trim whitespace
+    const normalized = projectPath.trim().replace(/\//g, path.sep);
+    const resolved = path.resolve(normalized);
+    if (resolved === _currentProject)
+        return;
+    // Validate: must have .succ/ dir
+    if (!fs.existsSync(path.join(resolved, '.succ')))
+        return;
+    process.env.SUCC_PROJECT_ROOT = resolved;
+    invalidateConfigCache();
+    // Reinit storage if we already had a different project OR this is first time
+    if (_currentProject !== null) {
+        try {
+            const d = await getStorageDispatcher();
+            await d.flushSessionCounters('mcp-project-switch');
+        }
+        catch (err) {
+            logWarn('mcp', 'Session counter flush failed', { error: String(err) });
+        }
+        closeDb();
+        closeGlobalDb();
+        await closeStorageDispatcher();
+    }
+    // Always init storage dispatcher to ensure config is applied
+    await initStorageDispatcher();
+    _currentProject = resolved;
+}
+// Graceful shutdown handler
+export function setupGracefulShutdown() {
+    const cleanup = async () => {
+        try {
+            const d = await getStorageDispatcher();
+            await d.flushSessionCounters('mcp-session');
+        }
+        catch (err) {
+            logWarn('mcp', 'Session counter flush failed', { error: String(err) });
+        }
+        await closeStorageDispatcher();
+        cleanupEmbeddings();
+        cleanupQualityScoring();
+        closeDb();
+        closeGlobalDb();
+        process.exit(0);
+    };
+    process.on('SIGTERM', cleanup);
+    process.on('SIGINT', cleanup);
+    // SIGHUP only exists on Unix
+    if (process.platform !== 'win32') {
+        process.on('SIGHUP', cleanup);
+    }
+}
+// Helper: Track token savings for RAG queries
+export async function trackTokenSavings(eventType, query, results) {
+    if (results.length === 0)
+        return;
+    try {
+        // Count tokens in returned chunks
+        const returnedTokens = countTokensArray(results.map((r) => r.content));
+        // Get unique file paths
+        const uniqueFiles = [...new Set(results.map((r) => r.file_path))];
+        // For documents/code: read full files and count tokens
+        // For memories (recall): full_source = total memory pool tokens
+        let fullSourceTokens = returnedTokens; // default fallback
+        if (eventType === 'recall') {
+            // Recall savings: searched N memories, returned only top results
+            // Estimate total memory pool size from memory stats
+            try {
+                const memStats = await getMemoryStats();
+                const totalMemories = memStats?.total_memories || 0;
+                if (totalMemories > 0 && results.length < totalMemories) {
+                    // Estimate: avg tokens per returned result × total memories
+                    const avgTokensPerResult = returnedTokens / results.length;
+                    fullSourceTokens = Math.round(avgTokensPerResult * totalMemories);
+                }
+            }
+            catch {
+                // Fallback: no savings for recall
+            }
+        }
+        else if (eventType === 'search' || eventType === 'search_code') {
+            const projectRoot = getProjectRoot();
+            const succDir = getSuccDir();
+            fullSourceTokens = 0;
+            for (const filePath of uniqueFiles) {
+                try {
+                    // Handle code: prefix
+                    const cleanPath = filePath.replace(/^code:/, '');
+                    // Try multiple locations: project root, brain dir
+                    const candidates = [
+                        path.join(projectRoot, cleanPath),
+                        path.join(succDir, 'brain', cleanPath),
+                        cleanPath, // absolute path
+                    ];
+                    for (const candidate of candidates) {
+                        if (fs.existsSync(candidate)) {
+                            const content = fs.readFileSync(candidate, 'utf-8');
+                            fullSourceTokens += countTokens(content);
+                            break;
+                        }
+                    }
+                }
+                catch {
+                    // File not readable, skip
+                }
+            }
+            // If we couldn't read any files, use returned as estimate
+            if (fullSourceTokens === 0) {
+                fullSourceTokens = returnedTokens;
+            }
+        }
+        const savingsTokens = Math.max(0, fullSourceTokens - returnedTokens);
+        const model = getCurrentModel();
+        const estimatedCost = estimateSavings(savingsTokens, model);
+        await recordTokenStat({
+            event_type: eventType,
+            query,
+            returned_tokens: returnedTokens,
+            full_source_tokens: fullSourceTokens,
+            savings_tokens: savingsTokens,
+            files_count: uniqueFiles.length,
+            chunks_count: results.length,
+            model,
+            estimated_cost: estimatedCost,
+        });
+    }
+    catch (err) {
+        logWarn('mcp', 'Token savings tracking failed', { error: String(err) });
+    }
+}
+/**
+ * Track memory access for retention decay.
+ * Memories that are frequently accessed will have higher effective scores.
+ *
+ * @param memoryIds - Array of memory IDs that were returned
+ * @param limit - The search limit (top N results)
+ * @param totalResults - Total number of results before limit
+ */
+export async function trackMemoryAccess(memoryIds, limit, _totalResults) {
+    if (memoryIds.length === 0)
+        return;
+    try {
+        const accesses = [];
+        for (let i = 0; i < memoryIds.length; i++) {
+            // Top results (within limit) get full weight (1.0 = exact match)
+            // Results beyond limit would get 0.5 (similarity hit) but we only track returned results
+            // Weight decreases slightly by position: top result = 1.0, 2nd = 0.95, etc.
+            const positionPenalty = Math.max(0, 0.05 * i);
+            const weight = i < limit ? Math.max(0.5, 1.0 - positionPenalty) : 0.5;
+            accesses.push({ memoryId: memoryIds[i], weight });
+        }
+        await incrementMemoryAccessBatch(accesses);
+    }
+    catch (err) {
+        logWarn('mcp', 'Memory access tracking failed', { error: String(err) });
+    }
+}
+// Get brain vault path
+export function getBrainPath() {
+    return path.join(getSuccDir(), 'brain');
+}
+/**
+ * Parse relative date strings like "30d", "1w", "3m"
+ */
+export function parseRelativeDate(input) {
+    const now = new Date();
+    const match = input.match(/^(\d+)([dwmy])$/i);
+    if (match) {
+        const amount = parseInt(match[1], 10);
+        const unit = match[2].toLowerCase();
+        switch (unit) {
+            case 'd':
+                return new Date(now.getTime() - amount * 24 * 60 * 60 * 1000);
+            case 'w':
+                return new Date(now.getTime() - amount * 7 * 24 * 60 * 60 * 1000);
+            case 'm':
+                return new Date(now.getTime() - amount * 30 * 24 * 60 * 60 * 1000);
+            case 'y':
+                return new Date(now.getTime() - amount * 365 * 24 * 60 * 60 * 1000);
+        }
+    }
+    const date = new Date(input);
+    if (!isNaN(date.getTime())) {
+        return date;
+    }
+    return null;
+}
+// DRY response helpers
+export function createToolResponse(text) {
+    return {
+        content: [{ type: 'text', text }],
+    };
+}
+export function createErrorResponse(text, component, error) {
+    if (component) {
+        logFault('error', component, text, { error });
+    }
+    return {
+        content: [{ type: 'text', text }],
+        isError: true,
+    };
+}
+//# sourceMappingURL=helpers.js.map

package/dist/mcp/helpers.js.map

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

package/dist/mcp/index.d.ts

@@ -0,0 +1,10 @@
+export type { SearchResult, ToolResponse } from './types.js';
+export { setupGracefulShutdown, trackTokenSavings, trackMemoryAccess, getBrainPath, parseRelativeDate, createToolResponse, createErrorResponse, } from './helpers.js';
+export { registerResources } from './resources.js';
+export { registerSearchTools } from './tools/search.js';
+export { registerMemoryTools } from './tools/memory.js';
+export { registerGraphTools } from './tools/graph.js';
+export { registerIndexingTools } from './tools/indexing.js';
+export { registerStatusTools } from './tools/status.js';
+export { registerConfigTools } from './tools/config.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/mcp/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/mcp/index.ts"],"names":[],"mappings":"AAKA,YAAY,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAG7D,OAAO,EACL,qBAAqB,EACrB,iBAAiB,EACjB,iBAAiB,EACjB,YAAY,EACZ,iBAAiB,EACjB,kBAAkB,EAClB,mBAAmB,GACpB,MAAM,cAAc,CAAC;AAGtB,OAAO,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAGnD,OAAO,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AACxD,OAAO,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AACxD,OAAO,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AACtD,OAAO,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAC5D,OAAO,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AACxD,OAAO,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/mcp/index.js

@@ -0,0 +1,15 @@
+// ============================================================================
+// MCP Server Module - Centralized Index
+// ============================================================================
+// Re-export helpers
+export { setupGracefulShutdown, trackTokenSavings, trackMemoryAccess, getBrainPath, parseRelativeDate, createToolResponse, createErrorResponse, } from './helpers.js';
+// Re-export resource registration
+export { registerResources } from './resources.js';
+// Re-export tool registrations
+export { registerSearchTools } from './tools/search.js';
+export { registerMemoryTools } from './tools/memory.js';
+export { registerGraphTools } from './tools/graph.js';
+export { registerIndexingTools } from './tools/indexing.js';
+export { registerStatusTools } from './tools/status.js';
+export { registerConfigTools } from './tools/config.js';
+//# sourceMappingURL=index.js.map

package/dist/mcp/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/mcp/index.ts"],"names":[],"mappings":"AAAA,+EAA+E;AAC/E,wCAAwC;AACxC,+EAA+E;AAK/E,oBAAoB;AACpB,OAAO,EACL,qBAAqB,EACrB,iBAAiB,EACjB,iBAAiB,EACjB,YAAY,EACZ,iBAAiB,EACjB,kBAAkB,EAClB,mBAAmB,GACpB,MAAM,cAAc,CAAC;AAEtB,kCAAkC;AAClC,OAAO,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAEnD,+BAA+B;AAC/B,OAAO,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AACxD,OAAO,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AACxD,OAAO,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AACtD,OAAO,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAC5D,OAAO,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AACxD,OAAO,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/mcp/resources.d.ts

@@ -0,0 +1,12 @@
+/**
+ * MCP Resource handlers
+ *
+ * Provides read-only access to brain vault and soul documents:
+ * - brain-list: List all files in brain vault
+ * - brain-file: Read a specific brain vault file
+ * - brain-index: Get project MOC / CLAUDE.md / Memories.md
+ * - soul: Get soul document (AI persona/personality)
+ */
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+export declare function registerResources(server: McpServer): void;
+//# sourceMappingURL=resources.d.ts.map

package/dist/mcp/resources.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resources.d.ts","sourceRoot":"","sources":["../../src/mcp/resources.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,SAAS,EAAoB,MAAM,yCAAyC,CAAC;AAMtF,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,SAAS,QA+JlD"}

package/dist/mcp/resources.js

@@ -0,0 +1,136 @@
+/**
+ * MCP Resource handlers
+ *
+ * Provides read-only access to brain vault and soul documents:
+ * - brain-list: List all files in brain vault
+ * - brain-file: Read a specific brain vault file
+ * - brain-index: Get project MOC / CLAUDE.md / Memories.md
+ * - soul: Get soul document (AI persona/personality)
+ */
+import { ResourceTemplate } from '@modelcontextprotocol/sdk/server/mcp.js';
+import path from 'path';
+import fs from 'fs';
+import { getProjectRoot, getSuccDir } from '../lib/config.js';
+import { getBrainPath } from './helpers.js';
+export function registerResources(server) {
+    // Resource: List brain vault files
+    server.resource('brain-list', 'brain://list', { description: 'List all files in the brain vault' }, async () => {
+        const brainPath = getBrainPath();
+        if (!fs.existsSync(brainPath)) {
+            return {
+                contents: [{ uri: 'brain://list', text: 'Brain vault not initialized. Run: succ init' }],
+            };
+        }
+        const files = [];
+        function walkDir(dir, prefix = '') {
+            const entries = fs.readdirSync(dir, { withFileTypes: true });
+            for (const entry of entries) {
+                if (entry.name.startsWith('.'))
+                    continue;
+                const fullPath = path.join(dir, entry.name);
+                const relativePath = prefix ? `${prefix}/${entry.name}` : entry.name;
+                if (entry.isDirectory()) {
+                    walkDir(fullPath, relativePath);
+                }
+                else if (entry.name.endsWith('.md')) {
+                    files.push(relativePath);
+                }
+            }
+        }
+        walkDir(brainPath);
+        const text = files.length > 0
+            ? `# Brain Vault Files\n\n${files.map((f) => `- ${f}`).join('\n')}`
+            : 'Brain vault is empty.';
+        return { contents: [{ uri: 'brain://list', mimeType: 'text/markdown', text }] };
+    });
+    // Resource: Read brain vault file (templated)
+    server.resource('brain-file', new ResourceTemplate('brain://file/{path}', { list: undefined }), { description: 'Read a file from the brain vault. Use brain://list to see available files.' }, async (uri, variables) => {
+        const brainPath = getBrainPath();
+        const filePath = variables.path;
+        const fullPath = path.join(brainPath, filePath);
+        // Security: use path.resolve for proper path traversal protection
+        const resolvedPath = path.resolve(fullPath);
+        const resolvedBrain = path.resolve(brainPath);
+        // Check path is within brain vault (handle both exact match and subdirectory)
+        if (resolvedPath !== resolvedBrain && !resolvedPath.startsWith(resolvedBrain + path.sep)) {
+            return { contents: [{ uri: uri.href, text: 'Error: Path traversal not allowed' }] };
+        }
+        if (!fs.existsSync(fullPath)) {
+            return { contents: [{ uri: uri.href, text: `File not found: ${filePath}` }] };
+        }
+        // Check for symlinks (optional security hardening)
+        const stats = fs.lstatSync(fullPath);
+        if (stats.isSymbolicLink()) {
+            return { contents: [{ uri: uri.href, text: 'Error: Symbolic links not allowed' }] };
+        }
+        const content = fs.readFileSync(fullPath, 'utf-8');
+        return { contents: [{ uri: uri.href, mimeType: 'text/markdown', text: content }] };
+    });
+    // Resource: Brain vault index (summary)
+    server.resource('brain-index', 'brain://index', { description: 'Get the brain vault index or CLAUDE.md' }, async () => {
+        const brainPath = getBrainPath();
+        if (!fs.existsSync(brainPath)) {
+            return { contents: [{ uri: 'brain://index', text: 'Brain vault not initialized.' }] };
+        }
+        // Try project MOC first, then CLAUDE.md, then Memories.md
+        const projectName = path.basename(getProjectRoot());
+        const projectMocPath = path.join(brainPath, 'project', `${projectName}.md`);
+        const claudePath = path.join(brainPath, 'CLAUDE.md');
+        const memoriesPath = path.join(brainPath, 'Memories.md');
+        if (fs.existsSync(projectMocPath)) {
+            const content = fs.readFileSync(projectMocPath, 'utf-8');
+            return { contents: [{ uri: 'brain://index', mimeType: 'text/markdown', text: content }] };
+        }
+        if (fs.existsSync(claudePath)) {
+            const content = fs.readFileSync(claudePath, 'utf-8');
+            return { contents: [{ uri: 'brain://index', mimeType: 'text/markdown', text: content }] };
+        }
+        if (fs.existsSync(memoriesPath)) {
+            const content = fs.readFileSync(memoriesPath, 'utf-8');
+            return { contents: [{ uri: 'brain://index', mimeType: 'text/markdown', text: content }] };
+        }
+        return {
+            contents: [
+                { uri: 'brain://index', text: 'No project MOC, CLAUDE.md, or Memories.md found.' },
+            ],
+        };
+    });
+    // Resource: Soul document (AI persona/personality)
+    server.resource('soul', 'soul://persona', {
+        description: 'Get the soul document - defines AI personality, values, and communication style. Read this to understand how to interact with the user.',
+    }, async () => {
+        const succDir = getSuccDir();
+        // Check multiple possible locations for soul document
+        const projectRoot = getProjectRoot();
+        const soulPaths = [
+            path.join(succDir, 'soul.md'),
+            path.join(succDir, 'SOUL.md'),
+            path.join(projectRoot, 'soul.md'),
+            path.join(projectRoot, 'SOUL.md'),
+            path.join(projectRoot, '.soul.md'),
+        ];
+        for (const soulPath of soulPaths) {
+            if (fs.existsSync(soulPath)) {
+                const content = fs.readFileSync(soulPath, 'utf-8');
+                return {
+                    contents: [
+                        {
+                            uri: 'soul://persona',
+                            mimeType: 'text/markdown',
+                            text: content,
+                        },
+                    ],
+                };
+            }
+        }
+        return {
+            contents: [
+                {
+                    uri: 'soul://persona',
+                    text: 'No soul document found. Create .succ/soul.md to define AI personality.\n\nRun `succ init` to generate a template.',
+                },
+            ],
+        };
+    });
+}
+//# sourceMappingURL=resources.js.map

package/dist/mcp/resources.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resources.js","sourceRoot":"","sources":["../../src/mcp/resources.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAa,gBAAgB,EAAE,MAAM,yCAAyC,CAAC;AACtF,OAAO,IAAI,MAAM,MAAM,CAAC;AACxB,OAAO,EAAE,MAAM,IAAI,CAAC;AACpB,OAAO,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9D,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAE5C,MAAM,UAAU,iBAAiB,CAAC,MAAiB;IACjD,mCAAmC;IACnC,MAAM,CAAC,QAAQ,CACb,YAAY,EACZ,cAAc,EACd,EAAE,WAAW,EAAE,mCAAmC,EAAE,EACpD,KAAK,IAAI,EAAE;QACT,MAAM,SAAS,GAAG,YAAY,EAAE,CAAC;QACjC,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;YAC9B,OAAO;gBACL,QAAQ,EAAE,CAAC,EAAE,GAAG,EAAE,cAAc,EAAE,IAAI,EAAE,6CAA6C,EAAE,CAAC;aACzF,CAAC;QACJ,CAAC;QAED,MAAM,KAAK,GAAa,EAAE,CAAC;QAC3B,SAAS,OAAO,CAAC,GAAW,EAAE,SAAiB,EAAE;YAC/C,MAAM,OAAO,GAAG,EAAE,CAAC,WAAW,CAAC,GAAG,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC;YAC7D,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;gBAC5B,IAAI,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC;oBAAE,SAAS;gBACzC,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;gBAC5C,MAAM,YAAY,GAAG,MAAM,CAAC,CAAC,CAAC,GAAG,MAAM,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC;gBACrE,IAAI,KAAK,CAAC,WAAW,EAAE,EAAE,CAAC;oBACxB,OAAO,CAAC,QAAQ,EAAE,YAAY,CAAC,CAAC;gBAClC,CAAC;qBAAM,IAAI,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;oBACtC,KAAK,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;gBAC3B,CAAC;YACH,CAAC;QACH,CAAC;QACD,OAAO,CAAC,SAAS,CAAC,CAAC;QAEnB,MAAM,IAAI,GACR,KAAK,CAAC,MAAM,GAAG,CAAC;YACd,CAAC,CAAC,0BAA0B,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;YACnE,CAAC,CAAC,uBAAuB,CAAC;QAE9B,OAAO,EAAE,QAAQ,EAAE,CAAC,EAAE,GAAG,EAAE,cAAc,EAAE,QAAQ,EAAE,eAAe,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC;IAClF,CAAC,CACF,CAAC;IAEF,8CAA8C;IAC9C,MAAM,CAAC,QAAQ,CACb,YAAY,EACZ,IAAI,gBAAgB,CAAC,qBAAqB,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC,EAChE,EAAE,WAAW,EAAE,4EAA4E,EAAE,EAC7F,KAAK,EAAE,GAAG,EAAE,SAAS,EAAE,EAAE;QACvB,MAAM,SAAS,GAAG,YAAY,EAAE,CAAC;QACjC,MAAM,QAAQ,GAAG,SAAS,CAAC,IAAc,CAAC;QAC1C,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;QAEhD,kEAAkE;QAClE,MAAM,YAAY,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;QAC5C,MAAM,aAAa,GAAG,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;QAE9C,8EAA8E;QAC9E,IAAI,YAAY,KAAK,aAAa,IAAI,CAAC,YAAY,CAAC,UAAU,CAAC,aAAa,GAAG,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;YACzF,OAAO,EAAE,QAAQ,EAAE,CAAC,EAAE,GAAG,EAAE,GAAG,CAAC,IAAI,EAAE,IAAI,EAAE,mCAAmC,EAAE,CAAC,EAAE,CAAC;QACtF,CAAC;QAED,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC7B,OAAO,EAAE,QAAQ,EAAE,CAAC,EAAE,GAAG,EAAE,GAAG,CAAC,IAAI,EAAE,IAAI,EAAE,mBAAmB,QAAQ,EAAE,EAAE,CAAC,EAAE,CAAC;QAChF,CAAC;QAED,mDAAmD;QACnD,MAAM,KAAK,GAAG,EAAE,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC;QACrC,IAAI,KAAK,CAAC,cAAc,EAAE,EAAE,CAAC;YAC3B,OAAO,EAAE,QAAQ,EAAE,CAAC,EAAE,GAAG,EAAE,GAAG,CAAC,IAAI,EAAE,IAAI,EAAE,mCAAmC,EAAE,CAAC,EAAE,CAAC;QACtF,CAAC;QAED,MAAM,OAAO,GAAG,EAAE,CAAC,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;QACnD,OAAO,EAAE,QAAQ,EAAE,CAAC,EAAE,GAAG,EAAE,GAAG,CAAC,IAAI,EAAE,QAAQ,EAAE,eAAe,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,EAAE,CAAC;IACrF,CAAC,CACF,CAAC;IAEF,wCAAwC;IACxC,MAAM,CAAC,QAAQ,CACb,aAAa,EACb,eAAe,EACf,EAAE,WAAW,EAAE,wCAAwC,EAAE,EACzD,KAAK,IAAI,EAAE;QACT,MAAM,SAAS,GAAG,YAAY,EAAE,CAAC;QACjC,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;YAC9B,OAAO,EAAE,QAAQ,EAAE,CAAC,EAAE,GAAG,EAAE,eAAe,EAAE,IAAI,EAAE,8BAA8B,EAAE,CAAC,EAAE,CAAC;QACxF,CAAC;QAED,0DAA0D;QAC1D,MAAM,WAAW,GAAG,IAAI,CAAC,QAAQ,CAAC,cAAc,EAAE,CAAC,CAAC;QACpD,MAAM,cAAc,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,SAAS,EAAE,GAAG,WAAW,KAAK,CAAC,CAAC;QAC5E,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,WAAW,CAAC,CAAC;QACrD,MAAM,YAAY,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,aAAa,CAAC,CAAC;QAEzD,IAAI,EAAE,CAAC,UAAU,CAAC,cAAc,CAAC,EAAE,CAAC;YAClC,MAAM,OAAO,GAAG,EAAE,CAAC,YAAY,CAAC,cAAc,EAAE,OAAO,CAAC,CAAC;YACzD,OAAO,EAAE,QAAQ,EAAE,CAAC,EAAE,GAAG,EAAE,eAAe,EAAE,QAAQ,EAAE,eAAe,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,EAAE,CAAC;QAC5F,CAAC;QAED,IAAI,EAAE,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;YAC9B,MAAM,OAAO,GAAG,EAAE,CAAC,YAAY,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;YACrD,OAAO,EAAE,QAAQ,EAAE,CAAC,EAAE,GAAG,EAAE,eAAe,EAAE,QAAQ,EAAE,eAAe,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,EAAE,CAAC;QAC5F,CAAC;QAED,IAAI,EAAE,CAAC,UAAU,CAAC,YAAY,CAAC,EAAE,CAAC;YAChC,MAAM,OAAO,GAAG,EAAE,CAAC,YAAY,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC;YACvD,OAAO,EAAE,QAAQ,EAAE,CAAC,EAAE,GAAG,EAAE,eAAe,EAAE,QAAQ,EAAE,eAAe,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,EAAE,CAAC;QAC5F,CAAC;QAED,OAAO;YACL,QAAQ,EAAE;gBACR,EAAE,GAAG,EAAE,eAAe,EAAE,IAAI,EAAE,kDAAkD,EAAE;aACnF;SACF,CAAC;IACJ,CAAC,CACF,CAAC;IAEF,mDAAmD;IACnD,MAAM,CAAC,QAAQ,CACb,MAAM,EACN,gBAAgB,EAChB;QACE,WAAW,EACT,yIAAyI;KAC5I,EACD,KAAK,IAAI,EAAE;QACT,MAAM,OAAO,GAAG,UAAU,EAAE,CAAC;QAE7B,sDAAsD;QACtD,MAAM,WAAW,GAAG,cAAc,EAAE,CAAC;QACrC,MAAM,SAAS,GAAG;YAChB,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,SAAS,CAAC;YAC7B,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,SAAS,CAAC;YAC7B,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,SAAS,CAAC;YACjC,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,SAAS,CAAC;YACjC,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,UAAU,CAAC;SACnC,CAAC;QAEF,KAAK,MAAM,QAAQ,IAAI,SAAS,EAAE,CAAC;YACjC,IAAI,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;gBAC5B,MAAM,OAAO,GAAG,EAAE,CAAC,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;gBACnD,OAAO;oBACL,QAAQ,EAAE;wBACR;4BACE,GAAG,EAAE,gBAAgB;4BACrB,QAAQ,EAAE,eAAe;4BACzB,IAAI,EAAE,OAAO;yBACd;qBACF;iBACF,CAAC;YACJ,CAAC;QACH,CAAC;QAED,OAAO;YACL,QAAQ,EAAE;gBACR;oBACE,GAAG,EAAE,gBAAgB;oBACrB,IAAI,EAAE,mHAAmH;iBAC1H;aACF;SACF,CAAC;IACJ,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/mcp/server.d.ts

@@ -0,0 +1,22 @@
+#!/usr/bin/env node
+/**
+ * succ MCP Server
+ *
+ * Exposes succ functionality as MCP tools that Claude can call directly:
+ * - succ_search: Semantic search in brain vault
+ * - succ_search_code: Search indexed source code
+ * - succ_remember: Save important information to memory
+ * - succ_recall: Recall past memories semantically
+ * - succ_forget: Delete memories
+ * - succ_index_file / succ_index_code_file / succ_analyze_file: Index files
+ * - succ_link / succ_explore: Knowledge graph
+ * - succ_status / succ_stats / succ_score: Status and metrics
+ * - succ_config / succ_config_set / succ_checkpoint: Configuration
+ * - succ_dead_end: Record failed approaches to prevent retrying
+ * - succ_prd_generate / succ_prd_list / succ_prd_status / succ_prd_run: PRD pipeline
+ * - succ_quick_search / succ_web_search / succ_deep_research: Web search via Perplexity Sonar (OpenRouter)
+ * - succ_web_search_history: Browse and filter past web search history
+ * - succ_debug: Language-independent structured debugging with hypothesis testing
+ */
+export {};
+//# sourceMappingURL=server.d.ts.map

package/dist/mcp/server.d.ts.map

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

package/dist/mcp/server.js

@@ -0,0 +1,131 @@
+#!/usr/bin/env node
+/**
+ * succ MCP Server
+ *
+ * Exposes succ functionality as MCP tools that Claude can call directly:
+ * - succ_search: Semantic search in brain vault
+ * - succ_search_code: Search indexed source code
+ * - succ_remember: Save important information to memory
+ * - succ_recall: Recall past memories semantically
+ * - succ_forget: Delete memories
+ * - succ_index_file / succ_index_code_file / succ_analyze_file: Index files
+ * - succ_link / succ_explore: Knowledge graph
+ * - succ_status / succ_stats / succ_score: Status and metrics
+ * - succ_config / succ_config_set / succ_checkpoint: Configuration
+ * - succ_dead_end: Record failed approaches to prevent retrying
+ * - succ_prd_generate / succ_prd_list / succ_prd_status / succ_prd_run: PRD pipeline
+ * - succ_quick_search / succ_web_search / succ_deep_research: Web search via Perplexity Sonar (OpenRouter)
+ * - succ_web_search_history: Browse and filter past web search history
+ * - succ_debug: Language-independent structured debugging with hypothesis testing
+ */
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { closeDb, closeGlobalDb, initStorageDispatcher, closeStorageDispatcher, } from '../lib/storage/index.js';
+import { cleanupEmbeddings } from '../lib/embeddings.js';
+import { cleanupQualityScoring } from '../lib/quality.js';
+import { getProjectRoot } from '../lib/config.js';
+import { logError, logInfo } from '../lib/fault-logger.js';
+import { setupGracefulShutdown, setCurrentProject } from './helpers.js';
+import { registerResources } from './resources.js';
+import { registerSearchTools } from './tools/search.js';
+import { registerMemoryTools } from './tools/memory.js';
+import { registerGraphTools } from './tools/graph.js';
+import { registerIndexingTools } from './tools/indexing.js';
+import { registerStatusTools } from './tools/status.js';
+import { registerConfigTools } from './tools/config.js';
+import { registerDeadEndTools } from './tools/dead-end.js';
+import { registerPrdTools } from './tools/prd.js';
+import { registerWebSearchTools } from './tools/web-search.js';
+import { registerDebugTools } from './tools/debug.js';
+import { registerWebFetchTools } from './tools/web-fetch.js';
+// Parse --project arg: succ-mcp --project /path/to/project
+const projectArgIdx = process.argv.indexOf('--project');
+if (projectArgIdx !== -1 && process.argv[projectArgIdx + 1]) {
+    process.env.SUCC_PROJECT_ROOT = process.argv[projectArgIdx + 1];
+}
+// Create MCP server
+const server = new McpServer({
+    name: 'succ',
+    version: '0.1.0',
+});
+// Register all resources and tools
+registerResources(server);
+registerSearchTools(server);
+registerMemoryTools(server);
+registerGraphTools(server);
+registerIndexingTools(server);
+registerStatusTools(server);
+registerConfigTools(server);
+registerDeadEndTools(server);
+registerPrdTools(server);
+registerWebSearchTools(server);
+registerDebugTools(server);
+registerWebFetchTools(server);
+// Handle unhandled promise rejections
+process.on('unhandledRejection', (error) => {
+    process.stderr.write(`[succ-mcp] UNHANDLED REJECTION: ${error instanceof Error ? error.message : String(error)}\n`);
+    logError('mcp', 'Unhandled promise rejection', error instanceof Error ? error : new Error(String(error)));
+    cleanupEmbeddings();
+    closeDb();
+    closeGlobalDb();
+    process.exit(1);
+});
+// Idle timeout: exit if no MCP requests for 60 minutes (zombie prevention)
+const IDLE_TIMEOUT_MS = 60 * 60 * 1000;
+let idleTimer = null;
+function resetIdleTimer() {
+    if (idleTimer)
+        clearTimeout(idleTimer);
+    idleTimer = setTimeout(() => {
+        logInfo('mcp', 'Shutting down (idle timeout)');
+        process.exit(0);
+    }, IDLE_TIMEOUT_MS);
+    // Don't keep process alive just for the timer
+    if (idleTimer.unref)
+        idleTimer.unref();
+}
+// stderr logger for MCP startup diagnostics (Claude Code reads stderr)
+function mcpLog(msg) {
+    process.stderr.write(`[succ-mcp] ${msg}\n`);
+}
+// Start server with stdio transport
+async function main() {
+    mcpLog('Starting...');
+    setupGracefulShutdown();
+    // Stdin close detection: when parent process dies, stdin closes
+    process.stdin.on('end', () => {
+        mcpLog('stdin closed, shutting down');
+        logInfo('mcp', 'Shutting down (stdin closed)');
+        process.exit(0);
+    });
+    process.stdin.on('error', (err) => {
+        mcpLog(`stdin error: ${err.message}`);
+        process.exit(0);
+    });
+    mcpLog('Initializing storage...');
+    await initStorageDispatcher();
+    mcpLog('Storage ready');
+    setCurrentProject(getProjectRoot());
+    mcpLog(`Project: ${getProjectRoot()}`);
+    const transport = new StdioServerTransport();
+    mcpLog('Connecting transport...');
+    await server.connect(transport);
+    mcpLog('Transport connected — server ready');
+    // Reset idle timer on any stdin data (MCP messages)
+    process.stdin.on('data', () => resetIdleTimer());
+    resetIdleTimer();
+    logInfo('mcp', `Server started (project: ${getProjectRoot()}, cwd: ${process.cwd()})`);
+}
+main().catch(async (error) => {
+    mcpLog(`FATAL: ${error instanceof Error ? error.message : String(error)}`);
+    if (error instanceof Error && error.stack)
+        mcpLog(error.stack);
+    logError('mcp', 'Failed to start MCP server', error instanceof Error ? error : new Error(String(error)));
+    await closeStorageDispatcher();
+    cleanupEmbeddings();
+    cleanupQualityScoring();
+    closeDb();
+    closeGlobalDb();
+    process.exit(1);
+});
+//# sourceMappingURL=server.js.map

package/dist/mcp/server.js.map

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

package/dist/mcp/tools/config.d.ts

@@ -0,0 +1,10 @@
+/**
+ * MCP Config tools
+ *
+ * - succ_config: Show current configuration
+ * - succ_config_set: Update configuration values
+ * - succ_checkpoint: Create and manage checkpoints
+ */
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+export declare function registerConfigTools(server: McpServer): void;
+//# sourceMappingURL=config.d.ts.map

package/dist/mcp/tools/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../../src/mcp/tools/config.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAQpE,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,SAAS,QAwPpD"}