@vinaes/succ 1.3.19

package/dist/mcp/tools/config.js

@@ -0,0 +1,236 @@
+/**
+ * MCP Config tools
+ *
+ * - succ_config: Show current configuration
+ * - succ_config_set: Update configuration values
+ * - succ_checkpoint: Create and manage checkpoints
+ */
+import { z } from 'zod';
+import path from 'path';
+import fs from 'fs';
+import { closeDb } from '../../lib/storage/index.js';
+import { getSuccDir } from '../../lib/config.js';
+import { projectPathParam, applyProjectPath } from '../helpers.js';
+export function registerConfigTools(server) {
+    // Tool: succ_config - Show current configuration
+    server.tool('succ_config', 'Get the current succ configuration with all settings and their effective values (with defaults applied). Shows embedding mode, analyze mode, quality scoring, graph settings, idle reflection, etc.', {
+        project_path: projectPathParam,
+    }, async ({ project_path }) => {
+        await applyProjectPath(project_path);
+        try {
+            const { getConfigDisplay, formatConfigDisplay } = await import('../../lib/config.js');
+            const display = getConfigDisplay(true); // mask secrets
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: formatConfigDisplay(display),
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: `Error getting config: ${error.message}`,
+                    },
+                ],
+                isError: true,
+            };
+        }
+    });
+    // Tool: succ_config_set - Update configuration values
+    server.tool('succ_config_set', 'Update succ configuration values. Saves to global (~/.succ/config.json) or project (.succ/config.json). Common keys: llm.type (claude/api), llm.model, llm.api_key, llm.api_url, llm.embeddings.mode (local/api), llm.embeddings.model, llm.analyze.mode (claude/api), llm.analyze.model, llm.quality.mode (local/api), quality_scoring_enabled, sensitive_filter_enabled, graph_auto_link, idle_reflection.enabled, idle_watcher.enabled, retrieval.quality_boost_enabled, retrieval.quality_boost_weight, retrieval.mmr_enabled, retrieval.mmr_lambda, retrieval.query_expansion_enabled, retrieval.query_expansion_mode, error_reporting.enabled, error_reporting.level, error_reporting.max_file_size_mb, error_reporting.webhook_url, error_reporting.sentry_dsn, error_reporting.sentry_environment, error_reporting.sentry_sample_rate', {
+        key: z
+            .string()
+            .describe('Config key to set (e.g., "llm.api_key", "llm.embeddings.mode", "idle_reflection.enabled")'),
+        value: z
+            .string()
+            .describe('Value to set (strings, numbers, booleans as strings: "true"/"false")'),
+        scope: z
+            .enum(['global', 'project'])
+            .optional()
+            .default('global')
+            .describe('Where to save: "global" (~/.succ/config.json) or "project" (.succ/config.json). Default: global'),
+        project_path: projectPathParam,
+    }, async ({ key, value, scope, project_path }) => {
+        await applyProjectPath(project_path);
+        try {
+            const os = await import('os');
+            // Determine config path based on scope
+            let configDir;
+            let configPath;
+            if (scope === 'project') {
+                const succDir = getSuccDir();
+                if (!fs.existsSync(succDir)) {
+                    return {
+                        content: [
+                            {
+                                type: 'text',
+                                text: 'Project not initialized. Run `succ init` first or use scope="global".',
+                            },
+                        ],
+                        isError: true,
+                    };
+                }
+                configDir = succDir;
+                configPath = path.join(succDir, 'config.json');
+            }
+            else {
+                configDir = path.join(os.homedir(), '.succ');
+                configPath = path.join(configDir, 'config.json');
+            }
+            // Load existing config
+            let config = {};
+            if (fs.existsSync(configPath)) {
+                config = JSON.parse(fs.readFileSync(configPath, 'utf-8'));
+            }
+            // Parse value (handle booleans and numbers)
+            let parsedValue = value;
+            if (value === 'true')
+                parsedValue = true;
+            else if (value === 'false')
+                parsedValue = false;
+            else if (!isNaN(Number(value)) && value.trim() !== '')
+                parsedValue = Number(value);
+            // Handle nested keys (e.g., "idle_reflection.enabled")
+            const keys = key.split('.');
+            if (keys.length === 1) {
+                config[key] = parsedValue;
+            }
+            else {
+                // Navigate/create nested object
+                let current = config;
+                for (let i = 0; i < keys.length - 1; i++) {
+                    if (!current[keys[i]] || typeof current[keys[i]] !== 'object') {
+                        current[keys[i]] = {};
+                    }
+                    current = current[keys[i]];
+                }
+                current[keys[keys.length - 1]] = parsedValue;
+            }
+            // Ensure config directory exists
+            if (!fs.existsSync(configDir)) {
+                fs.mkdirSync(configDir, { recursive: true });
+            }
+            // Save config
+            fs.writeFileSync(configPath, JSON.stringify(config, null, 2));
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: `Config updated (${scope}): ${key} = ${JSON.stringify(parsedValue)}\nSaved to: ${configPath}`,
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: `Error setting config: ${error.message}`,
+                    },
+                ],
+                isError: true,
+            };
+        }
+    });
+    // Tool: succ_checkpoint - Create and manage checkpoints (full backup/restore)
+    server.tool('succ_checkpoint', 'Create or list checkpoints (full backup of memories, documents, brain vault). Use "create" to make a backup, "list" to see available checkpoints. Note: Restore requires CLI (succ checkpoint restore <file>).', {
+        action: z
+            .enum(['create', 'list'])
+            .describe('Action: create (new checkpoint) or list (show available)'),
+        compress: z.boolean().optional().describe('Compress with gzip (default: false)'),
+        include_brain: z.boolean().optional().describe('Include brain vault files (default: true)'),
+        include_documents: z
+            .boolean()
+            .optional()
+            .describe('Include indexed documents (default: true)'),
+        project_path: projectPathParam,
+    }, async ({ action, compress, include_brain, include_documents, project_path }) => {
+        await applyProjectPath(project_path);
+        try {
+            const { createCheckpoint, listCheckpoints, formatSize } = await import('../../lib/checkpoint.js');
+            if (action === 'create') {
+                const { checkpoint: cp, outputPath } = await createCheckpoint({
+                    includeBrain: include_brain ?? true,
+                    includeDocuments: include_documents ?? true,
+                    includeConfig: true,
+                    compress: compress ?? false,
+                });
+                const stat = fs.statSync(outputPath);
+                return {
+                    content: [
+                        {
+                            type: 'text',
+                            text: `Checkpoint created successfully!
+
+File: ${outputPath}
+Project: ${cp.project_name}
+Size: ${formatSize(stat.size)}
+
+Contents:
+  Memories: ${cp.stats.memories_count}
+  Documents: ${cp.stats.documents_count}
+  Memory links: ${cp.stats.links_count}
+  Centrality scores: ${cp.stats.centrality_count || 0}
+  Brain files: ${cp.stats.brain_files_count}
+
+To restore: succ checkpoint restore "${outputPath}"`,
+                        },
+                    ],
+                };
+            }
+            else {
+                // list
+                const checkpoints = listCheckpoints();
+                if (checkpoints.length === 0) {
+                    return {
+                        content: [
+                            {
+                                type: 'text',
+                                text: 'No checkpoints found. Create one with: succ_checkpoint action="create"',
+                            },
+                        ],
+                    };
+                }
+                const lines = ['Available checkpoints:\n'];
+                for (const cp of checkpoints) {
+                    const compressed = cp.compressed ? ' (compressed)' : '';
+                    const date = cp.created_at ? new Date(cp.created_at).toLocaleString() : 'unknown';
+                    lines.push(`  ${cp.name}${compressed}`);
+                    lines.push(`    Created: ${date}`);
+                    lines.push(`    Size: ${formatSize(cp.size)}`);
+                    lines.push('');
+                }
+                lines.push(`Total: ${checkpoints.length} checkpoint(s)`);
+                return {
+                    content: [
+                        {
+                            type: 'text',
+                            text: lines.join('\n'),
+                        },
+                    ],
+                };
+            }
+        }
+        catch (error) {
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: `Error: ${error.message}`,
+                    },
+                ],
+                isError: true,
+            };
+        }
+        finally {
+            closeDb();
+        }
+    });
+}
+//# sourceMappingURL=config.js.map

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

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

package/dist/mcp/tools/dead-end.d.ts

@@ -0,0 +1,9 @@
+/**
+ * MCP Dead-End Tracking tool
+ *
+ * succ_dead_end: Record a failed approach to prevent retrying it.
+ * Stores "tried X, didn't work because Y" knowledge.
+ */
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+export declare function registerDeadEndTools(server: McpServer): void;
+//# sourceMappingURL=dead-end.d.ts.map

package/dist/mcp/tools/dead-end.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dead-end.d.ts","sourceRoot":"","sources":["../../../src/mcp/tools/dead-end.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AASpE,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,SAAS,QAsIrD"}

package/dist/mcp/tools/dead-end.js

@@ -0,0 +1,137 @@
+/**
+ * MCP Dead-End Tracking tool
+ *
+ * succ_dead_end: Record a failed approach to prevent retrying it.
+ * Stores "tried X, didn't work because Y" knowledge.
+ */
+import { z } from 'zod';
+import { saveMemory, searchMemories, closeDb } from '../../lib/storage/index.js';
+import { getConfig, isGlobalOnlyMode } from '../../lib/config.js';
+import { getEmbedding } from '../../lib/embeddings.js';
+import { scoreMemory, passesQualityThreshold, formatQualityScore } from '../../lib/quality.js';
+import { scanSensitive, formatMatches } from '../../lib/sensitive-filter.js';
+import { projectPathParam, applyProjectPath } from '../helpers.js';
+export function registerDeadEndTools(server) {
+    server.tool('succ_dead_end', 'Record a failed approach to prevent retrying it. Stores "tried X, didn\'t work because Y" knowledge. Dead-ends are automatically boosted in recall results so AI agents see them before retrying a failed approach.', {
+        approach: z.string().describe('What was tried (e.g., "Using Redis for session storage")'),
+        why_failed: z
+            .string()
+            .describe('Why it failed (e.g., "Memory usage too high for our VPS tier")'),
+        context: z
+            .string()
+            .optional()
+            .describe('Additional context (file paths, error messages, etc.)'),
+        tags: z.array(z.string()).optional().default([]).describe('Tags for categorization'),
+        project_path: projectPathParam,
+    }, async ({ approach, why_failed, context, tags, project_path }) => {
+        await applyProjectPath(project_path);
+        if (isGlobalOnlyMode()) {
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: 'Dead-end tracking requires a project with .succ/ initialized. Run `succ init` first.',
+                    },
+                ],
+                isError: true,
+            };
+        }
+        try {
+            const config = getConfig();
+            // Compose dead-end content
+            let content = `DEAD END: Tried "${approach}" — Failed because: ${why_failed}`;
+            if (context) {
+                content += `\nContext: ${context}`;
+            }
+            // Check for sensitive information
+            if (config.sensitive_filter_enabled !== false) {
+                const scanResult = scanSensitive(content);
+                if (scanResult.hasSensitive) {
+                    if (config.sensitive_auto_redact) {
+                        content = scanResult.redactedText;
+                    }
+                    else {
+                        return {
+                            content: [
+                                {
+                                    type: 'text',
+                                    text: `⚠ Sensitive information detected:\n${formatMatches(scanResult.matches)}\n\nDead-end not saved.`,
+                                },
+                            ],
+                        };
+                    }
+                }
+            }
+            // Get embedding for dedup check and saving
+            const embedding = await getEmbedding(content);
+            // Dedup: check if a similar dead-end already exists
+            const existing = await searchMemories(embedding, 1, 0.85);
+            if (existing.length > 0 && existing[0].content.startsWith('DEAD END:')) {
+                return {
+                    content: [
+                        {
+                            type: 'text',
+                            text: `⚠ Similar dead-end already recorded (id: ${existing[0].id}, ${(existing[0].similarity * 100).toFixed(0)}% similar):\n"${existing[0].content.substring(0, 120)}..."`,
+                        },
+                    ],
+                };
+            }
+            // Score quality
+            let qualityScore = null;
+            if (config.quality_scoring_enabled !== false) {
+                qualityScore = await scoreMemory(content);
+                if (!passesQualityThreshold(qualityScore)) {
+                    return {
+                        content: [
+                            {
+                                type: 'text',
+                                text: `⚠ Dead-end quality too low: ${formatQualityScore(qualityScore)}`,
+                            },
+                        ],
+                    };
+                }
+            }
+            // Ensure 'dead-end' tag is always present
+            const allTags = [...new Set([...tags, 'dead-end'])];
+            const result = await saveMemory(content, embedding, allTags, 'dead-end-tracking', {
+                type: 'dead_end',
+                qualityScore: qualityScore
+                    ? { score: qualityScore.score, factors: qualityScore.factors }
+                    : undefined,
+            });
+            if (result.isDuplicate) {
+                return {
+                    content: [
+                        {
+                            type: 'text',
+                            text: `⚠ Similar memory already exists (id: ${result.id}). Dead-end not saved as duplicate.`,
+                        },
+                    ],
+                };
+            }
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: `✓ Dead-end recorded (id: ${result.id}):\n  Approach: ${approach}\n  Why failed: ${why_failed}${context ? `\n  Context: ${context.substring(0, 100)}` : ''}\n\nThis will be surfaced when similar approaches are considered in future sessions.`,
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: `Error recording dead-end: ${error.message}`,
+                    },
+                ],
+                isError: true,
+            };
+        }
+        finally {
+            closeDb();
+        }
+    });
+}
+//# sourceMappingURL=dead-end.js.map

package/dist/mcp/tools/dead-end.js.map

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

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

@@ -0,0 +1,9 @@
+/**
+ * MCP Debug Session tools
+ *
+ * succ_debug: Language-independent structured debugging with hypothesis testing.
+ * Manages debug sessions in .succ/debugs/ with dead_end integration.
+ */
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+export declare function registerDebugTools(server: McpServer): void;
+//# sourceMappingURL=debug.d.ts.map

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

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