@vinaes/succ 1.3.19

package/dist/mcp/tools/debug.js

@@ -0,0 +1,387 @@
+/**
+ * MCP Debug Session tools
+ *
+ * succ_debug: Language-independent structured debugging with hypothesis testing.
+ * Manages debug sessions in .succ/debugs/ with dead_end integration.
+ */
+import { z } from 'zod';
+import { isGlobalOnlyMode } from '../../lib/config.js';
+import { projectPathParam, applyProjectPath } from '../helpers.js';
+import { generateSessionId, ensureDebugsDir, saveSession, loadSession, listSessions, findActiveSession, appendSessionLog, loadSessionLog, } from '../../lib/debug/state.js';
+import { detectLanguage, generateLogStatement } from '../../lib/debug/types.js';
+function requireProject() {
+    if (isGlobalOnlyMode()) {
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: 'Debug sessions require a project with .succ/ initialized. Run `succ init` first.',
+                },
+            ],
+            isError: true,
+        };
+    }
+    return null;
+}
+export function registerDebugTools(server) {
+    // =========================================================================
+    // succ_debug — main debug session management tool
+    // =========================================================================
+    server.tool('succ_debug', 'Language-independent structured debugging. Create sessions, add hypotheses, track instrumented files, record results. Integrates with succ_dead_end for failed hypotheses.', {
+        action: z
+            .enum([
+            'create', // Start a new debug session
+            'hypothesis', // Add a hypothesis to the active session
+            'instrument', // Record instrumented files/lines
+            'result', // Record hypothesis result (confirmed/refuted)
+            'resolve', // Mark session as resolved with root cause + fix
+            'abandon', // Abandon session
+            'status', // Show active session status
+            'list', // List all sessions
+            'log', // Append to session log
+            'show_log', // Show session log
+            'detect_lang', // Detect language from file path
+            'gen_log', // Generate log statement for a language
+        ])
+            .describe('Action to perform'),
+        // Session creation params
+        bug_description: z.string().optional().describe('Bug description (for create)'),
+        error_output: z.string().optional().describe('Error output or stack trace (for create)'),
+        reproduction_command: z
+            .string()
+            .optional()
+            .describe('Command to reproduce the bug (for create)'),
+        language: z.string().optional().describe('Override language detection (for create)'),
+        // Hypothesis params
+        description: z.string().optional().describe('Hypothesis description (for hypothesis)'),
+        confidence: z
+            .enum(['high', 'medium', 'low'])
+            .optional()
+            .describe('Confidence level (for hypothesis)'),
+        evidence: z.string().optional().describe('Evidence supporting hypothesis (for hypothesis)'),
+        test: z.string().optional().describe('How to test this hypothesis (for hypothesis)'),
+        // Instrument params
+        file_path: z
+            .string()
+            .optional()
+            .describe('Instrumented file path (for instrument, detect_lang)'),
+        lines: z
+            .array(z.number())
+            .optional()
+            .describe('Line numbers of added instrumentation (for instrument)'),
+        // Result params
+        hypothesis_id: z.number().optional().describe('Hypothesis ID (1-based) (for result)'),
+        confirmed: z.boolean().optional().describe('Whether hypothesis was confirmed (for result)'),
+        logs: z.string().optional().describe('Log output from reproduction (for result)'),
+        // Resolve params
+        root_cause: z.string().optional().describe('Root cause description (for resolve)'),
+        fix_description: z.string().optional().describe('Fix description (for resolve)'),
+        files_modified: z
+            .array(z.string())
+            .optional()
+            .describe('Files modified to fix (for resolve)'),
+        // Session selector
+        session_id: z.string().optional().describe('Session ID (defaults to active session)'),
+        // List params
+        include_resolved: z
+            .boolean()
+            .optional()
+            .default(false)
+            .describe('Include resolved sessions in list'),
+        // Log params
+        entry: z.string().optional().describe('Log entry text (for log)'),
+        // gen_log params
+        tag: z.string().optional().describe('Log tag (for gen_log)'),
+        value: z.string().optional().describe('Value to log (for gen_log)'),
+        project_path: projectPathParam,
+    }, async (params) => {
+        await applyProjectPath(params.project_path);
+        const err = requireProject();
+        if (err)
+            return err;
+        try {
+            const { action } = params;
+            switch (action) {
+                case 'create': {
+                    if (!params.bug_description) {
+                        return {
+                            content: [
+                                { type: 'text', text: 'bug_description is required for create' },
+                            ],
+                            isError: true,
+                        };
+                    }
+                    ensureDebugsDir();
+                    const id = generateSessionId();
+                    const lang = params.language ?? 'unknown';
+                    const session = {
+                        id,
+                        status: 'active',
+                        bug_description: params.bug_description,
+                        error_output: params.error_output,
+                        reproduction_command: params.reproduction_command,
+                        language: lang,
+                        hypotheses: [],
+                        instrumented_files: [],
+                        iteration: 0,
+                        max_iterations: 5,
+                        files_modified: [],
+                        created_at: new Date().toISOString(),
+                        updated_at: new Date().toISOString(),
+                    };
+                    saveSession(session);
+                    appendSessionLog(id, `Session created: ${params.bug_description.substring(0, 100)}`);
+                    return {
+                        content: [
+                            {
+                                type: 'text',
+                                text: `Debug session created: ${id}\nBug: ${params.bug_description}\nLanguage: ${lang}\nReproduction: ${params.reproduction_command ?? '(not set)'}`,
+                            },
+                        ],
+                    };
+                }
+                case 'hypothesis': {
+                    const session = getSession(params.session_id);
+                    if (!session)
+                        return noSession();
+                    if (!params.description) {
+                        return {
+                            content: [
+                                { type: 'text', text: 'description is required for hypothesis' },
+                            ],
+                            isError: true,
+                        };
+                    }
+                    const h = {
+                        id: session.hypotheses.length + 1,
+                        description: params.description,
+                        confidence: params.confidence ?? 'medium',
+                        evidence: params.evidence ?? '',
+                        test: params.test ?? '',
+                        result: 'pending',
+                    };
+                    session.hypotheses.push(h);
+                    saveSession(session);
+                    appendSessionLog(session.id, `Hypothesis #${h.id} (${h.confidence}): ${h.description}`);
+                    return {
+                        content: [
+                            {
+                                type: 'text',
+                                text: `Hypothesis #${h.id} added (${h.confidence}):\n  ${h.description}\n  Evidence: ${h.evidence}\n  Test: ${h.test}`,
+                            },
+                        ],
+                    };
+                }
+                case 'instrument': {
+                    const session = getSession(params.session_id);
+                    if (!session)
+                        return noSession();
+                    if (!params.file_path) {
+                        return {
+                            content: [{ type: 'text', text: 'file_path is required for instrument' }],
+                            isError: true,
+                        };
+                    }
+                    const existing = session.instrumented_files.find((f) => f.path === params.file_path);
+                    if (existing) {
+                        existing.lines = [...new Set([...existing.lines, ...(params.lines ?? [])])];
+                    }
+                    else {
+                        session.instrumented_files.push({
+                            path: params.file_path,
+                            lines: params.lines ?? [],
+                        });
+                    }
+                    saveSession(session);
+                    appendSessionLog(session.id, `Instrumented: ${params.file_path} lines=${(params.lines ?? []).join(',')}`);
+                    return {
+                        content: [
+                            {
+                                type: 'text',
+                                text: `Instrumented ${params.file_path} at lines [${(params.lines ?? []).join(', ')}]\nTotal instrumented files: ${session.instrumented_files.length}`,
+                            },
+                        ],
+                    };
+                }
+                case 'result': {
+                    const session = getSession(params.session_id);
+                    if (!session)
+                        return noSession();
+                    if (params.hypothesis_id == null) {
+                        return {
+                            content: [{ type: 'text', text: 'hypothesis_id is required for result' }],
+                            isError: true,
+                        };
+                    }
+                    const h = session.hypotheses.find((x) => x.id === params.hypothesis_id);
+                    if (!h) {
+                        return {
+                            content: [
+                                { type: 'text', text: `Hypothesis #${params.hypothesis_id} not found` },
+                            ],
+                            isError: true,
+                        };
+                    }
+                    h.result = params.confirmed ? 'confirmed' : 'refuted';
+                    h.logs = params.logs;
+                    session.iteration++;
+                    saveSession(session);
+                    const status = params.confirmed ? 'CONFIRMED' : 'REFUTED';
+                    appendSessionLog(session.id, `Hypothesis #${h.id} ${status}: ${h.description}`);
+                    let text = `Hypothesis #${h.id} ${status}: ${h.description}`;
+                    if (!params.confirmed) {
+                        text += `\n\nConsider recording as dead_end:\n  succ_dead_end(approach="${h.description}", why_failed="<reason>", tags=["debug"])`;
+                    }
+                    return { content: [{ type: 'text', text }] };
+                }
+                case 'resolve': {
+                    const session = getSession(params.session_id);
+                    if (!session)
+                        return noSession();
+                    session.status = 'resolved';
+                    session.root_cause = params.root_cause;
+                    session.fix_description = params.fix_description;
+                    session.files_modified = params.files_modified ?? [];
+                    session.resolved_at = new Date().toISOString();
+                    saveSession(session);
+                    appendSessionLog(session.id, `RESOLVED: ${params.root_cause ?? 'unknown'}`);
+                    const confirmed = session.hypotheses.filter((h) => h.result === 'confirmed').length;
+                    const refuted = session.hypotheses.filter((h) => h.result === 'refuted').length;
+                    return {
+                        content: [
+                            {
+                                type: 'text',
+                                text: `Debug session ${session.id} resolved.\nRoot cause: ${params.root_cause ?? 'not specified'}\nFix: ${params.fix_description ?? 'not specified'}\nFiles: ${(params.files_modified ?? []).join(', ') || 'none'}\nHypotheses: ${confirmed} confirmed, ${refuted} refuted, ${session.hypotheses.length} total\nIterations: ${session.iteration}`,
+                            },
+                        ],
+                    };
+                }
+                case 'abandon': {
+                    const session = getSession(params.session_id);
+                    if (!session)
+                        return noSession();
+                    session.status = 'abandoned';
+                    saveSession(session);
+                    appendSessionLog(session.id, 'Session abandoned');
+                    return {
+                        content: [{ type: 'text', text: `Session ${session.id} abandoned.` }],
+                    };
+                }
+                case 'status': {
+                    const session = params.session_id
+                        ? loadSession(params.session_id)
+                        : (() => {
+                            const active = findActiveSession();
+                            return active ? loadSession(active.id) : null;
+                        })();
+                    if (!session)
+                        return noSession();
+                    const lines = [
+                        `Session: ${session.id} (${session.status})`,
+                        `Bug: ${session.bug_description}`,
+                        `Language: ${session.language}`,
+                        `Iteration: ${session.iteration}/${session.max_iterations}`,
+                        `Hypotheses: ${session.hypotheses.length}`,
+                    ];
+                    for (const h of session.hypotheses) {
+                        lines.push(`  #${h.id} [${h.result.toUpperCase()}] (${h.confidence}) ${h.description}`);
+                    }
+                    if (session.instrumented_files.length > 0) {
+                        lines.push(`Instrumented files: ${session.instrumented_files.length}`);
+                        for (const f of session.instrumented_files) {
+                            lines.push(`  ${f.path} lines=[${f.lines.join(',')}]`);
+                        }
+                    }
+                    if (session.root_cause)
+                        lines.push(`Root cause: ${session.root_cause}`);
+                    if (session.fix_description)
+                        lines.push(`Fix: ${session.fix_description}`);
+                    return { content: [{ type: 'text', text: lines.join('\n') }] };
+                }
+                case 'list': {
+                    const sessions = listSessions(params.include_resolved);
+                    if (sessions.length === 0) {
+                        return {
+                            content: [
+                                {
+                                    type: 'text',
+                                    text: params.include_resolved
+                                        ? 'No debug sessions found.'
+                                        : 'No active debug sessions. Use action="list" include_resolved=true to see all.',
+                                },
+                            ],
+                        };
+                    }
+                    const lines = sessions.map((s) => `${s.id} [${s.status}] ${s.language} iter=${s.iteration} hypotheses=${s.hypothesis_count} — ${s.bug_description}`);
+                    return { content: [{ type: 'text', text: lines.join('\n') }] };
+                }
+                case 'log': {
+                    const session = getSession(params.session_id);
+                    if (!session)
+                        return noSession();
+                    if (!params.entry) {
+                        return {
+                            content: [{ type: 'text', text: 'entry is required for log' }],
+                            isError: true,
+                        };
+                    }
+                    appendSessionLog(session.id, params.entry);
+                    return {
+                        content: [{ type: 'text', text: `Log appended to session ${session.id}` }],
+                    };
+                }
+                case 'show_log': {
+                    const session = getSession(params.session_id);
+                    if (!session)
+                        return noSession();
+                    const log = loadSessionLog(session.id);
+                    return { content: [{ type: 'text', text: log || '(empty log)' }] };
+                }
+                case 'detect_lang': {
+                    if (!params.file_path) {
+                        return {
+                            content: [{ type: 'text', text: 'file_path is required for detect_lang' }],
+                            isError: true,
+                        };
+                    }
+                    const lang = detectLanguage(params.file_path);
+                    return { content: [{ type: 'text', text: `${params.file_path} → ${lang}` }] };
+                }
+                case 'gen_log': {
+                    const lang = params.language ?? 'unknown';
+                    const stmt = generateLogStatement(lang, params.tag ?? 'debug', params.value ?? 'value');
+                    return { content: [{ type: 'text', text: stmt }] };
+                }
+                default:
+                    return {
+                        content: [{ type: 'text', text: `Unknown action: ${action}` }],
+                        isError: true,
+                    };
+            }
+        }
+        catch (error) {
+            return {
+                content: [{ type: 'text', text: `Debug tool error: ${error.message}` }],
+                isError: true,
+            };
+        }
+    });
+}
+// ============================================================================
+// Helpers
+// ============================================================================
+function getSession(sessionId) {
+    if (sessionId)
+        return loadSession(sessionId);
+    const active = findActiveSession();
+    return active ? loadSession(active.id) : null;
+}
+function noSession() {
+    return {
+        content: [
+            { type: 'text', text: 'No active debug session. Use action="create" to start one.' },
+        ],
+        isError: true,
+    };
+}
+//# sourceMappingURL=debug.js.map

package/dist/mcp/tools/debug.js.map

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

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

@@ -0,0 +1,9 @@
+/**
+ * MCP Knowledge Graph tools
+ *
+ * - succ_link: Create/manage memory links (knowledge graph)
+ * - succ_explore: Explore connected memories
+ */
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+export declare function registerGraphTools(server: McpServer): void;
+//# sourceMappingURL=graph.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"graph.d.ts","sourceRoot":"","sources":["../../../src/mcp/tools/graph.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAepE,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,SAAS,QA+WnD"}