@vinaes/succ 1.4.0 → 1.5.37

package/dist/mcp/tools/memory/remember.js

@@ -0,0 +1,256 @@
+import { z } from 'zod';
+import path from 'path';
+import { saveMemory, saveGlobalMemory, closeDb, closeGlobalDb, } from '../../../lib/storage/index.js';
+import { getConfig, getProjectRoot, 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 { parseDuration } from '../../../lib/temporal.js';
+import { logWarn } from '../../../lib/fault-logger.js';
+import { projectPathParam, applyProjectPath } from '../../helpers.js';
+import { rememberWithLLMExtraction } from './memory-helpers.js';
+export function registerRememberTool(server) {
+    server.registerTool('succ_remember', {
+        description: 'Save important information to long-term memory. By default, uses LLM to extract structured facts from content. Use extract=false to save content as-is. In projects without .succ/, automatically saves to global memory. Use valid_until for temporary info.\n\nExamples:\n- Save a decision: succ_remember(content="Chose JWT over sessions", type="decision", tags=["architecture"])\n- With file context: succ_remember(content="handleAuth uses bcrypt", files=["src/auth.ts"])\n- Temp workaround: succ_remember(content="Rate limiter disabled for load test", valid_until="7d")',
+        inputSchema: {
+            content: z.string().describe('The information to remember'),
+            tags: z
+                .array(z.string())
+                .optional()
+                .default([])
+                .describe('Tags for categorization (e.g., ["decision", "architecture"]). ' +
+                'Special: "hook-rule" makes this a dynamic pre-tool rule. ' +
+                'Add "tool:{Name}" to filter by tool (Bash/Edit/Skill/etc), ' +
+                '"match:{regex}" to filter by input. ' +
+                'Set the type parameter to "error" to deny, "pattern" to ask confirmation.'),
+            source: z
+                .string()
+                .optional()
+                .describe('Source context (e.g., "user request", "bug fix", file path)'),
+            type: z
+                .enum(['observation', 'decision', 'learning', 'error', 'pattern', 'dead_end'])
+                .optional()
+                .default('observation')
+                .describe('Memory type: observation (facts), decision (choices), learning (insights), error (failures), pattern (recurring themes), dead_end (failed approaches)'),
+            global: z
+                .boolean()
+                .optional()
+                .default(false)
+                .describe('Save to global memory (shared across all projects). Auto-enabled if project has no .succ/'),
+            valid_from: z
+                .string()
+                .optional()
+                .describe('When this fact becomes valid. Use ISO date (2025-03-01) or duration from now (7d, 2w, 1m). For scheduled changes.'),
+            valid_until: z
+                .string()
+                .optional()
+                .describe('When this fact expires. Use ISO date (2025-12-31) or duration from now (7d, 30d). For sprint goals, temp workarounds.'),
+            files: z
+                .array(z.string())
+                .optional()
+                .describe('File paths this memory relates to. Adds file:{basename} tags for auto-recall on edit.'),
+            extract: z
+                .boolean()
+                .optional()
+                .describe('Extract structured facts using LLM (default: from config, typically true). Set to false to save content as-is.'),
+            project_path: projectPathParam,
+        },
+        annotations: {
+            readOnlyHint: false,
+            destructiveHint: false,
+            idempotentHint: false,
+            openWorldHint: true,
+        },
+    }, async ({ content, tags, source, type, global: useGlobal, valid_from, valid_until, files, extract, project_path, }) => {
+        await applyProjectPath(project_path);
+        // Force global mode if project not initialized
+        const globalOnlyMode = isGlobalOnlyMode();
+        if (globalOnlyMode && !useGlobal) {
+            useGlobal = true;
+        }
+        // Add file:{basename} tags for file-linked memories
+        if (files && files.length > 0) {
+            const fileTags = files.map((f) => `file:${path.basename(f)}`);
+            tags = [...new Set([...tags, ...fileTags])];
+        }
+        try {
+            const config = getConfig();
+            // Determine if LLM extraction should be used
+            const configDefault = config.remember_extract_default !== false; // default true
+            const useExtract = extract ?? configDefault;
+            // If extraction is enabled, use LLM to extract structured facts
+            if (useExtract) {
+                return await rememberWithLLMExtraction({
+                    content,
+                    tags,
+                    source,
+                    type,
+                    useGlobal,
+                    valid_from,
+                    valid_until,
+                    config,
+                });
+            }
+            // Check for sensitive information (non-interactive mode for MCP)
+            if (config.sensitive_filter_enabled !== false) {
+                const scanResult = scanSensitive(content);
+                if (scanResult.hasSensitive) {
+                    if (config.sensitive_auto_redact) {
+                        // Auto-redact and continue
+                        content = scanResult.redactedText;
+                    }
+                    else {
+                        // Block - can't prompt user in MCP mode
+                        return {
+                            content: [
+                                {
+                                    type: 'text',
+                                    text: `⚠ Sensitive information detected:\n${formatMatches(scanResult.matches)}\n\nMemory not saved. Set "sensitive_auto_redact": true in config to auto-redact, or use CLI with --redact-sensitive flag.`,
+                                },
+                            ],
+                        };
+                    }
+                }
+            }
+            // Parse temporal validity periods
+            let validFromDate;
+            let validUntilDate;
+            if (valid_from) {
+                try {
+                    validFromDate = parseDuration(valid_from);
+                }
+                catch (e) {
+                    const errorMsg = e instanceof Error ? e.message : String(e);
+                    return {
+                        content: [
+                            {
+                                type: 'text',
+                                text: `Invalid valid_from: ${errorMsg}. Use ISO date (2025-03-01) or duration (7d, 2w, 1m).`,
+                            },
+                        ],
+                        isError: true,
+                    };
+                }
+            }
+            if (valid_until) {
+                try {
+                    validUntilDate = parseDuration(valid_until);
+                }
+                catch (e) {
+                    const errorMsg = e instanceof Error ? e.message : String(e);
+                    return {
+                        content: [
+                            {
+                                type: 'text',
+                                text: `Invalid valid_until: ${errorMsg}. Use ISO date (2025-12-31) or duration (7d, 30d).`,
+                            },
+                        ],
+                        isError: true,
+                    };
+                }
+            }
+            const embedding = await getEmbedding(content);
+            let qualityScore = null;
+            if (config.quality_scoring_enabled !== false) {
+                qualityScore = await scoreMemory(content);
+                // Check if it passes the threshold
+                if (!passesQualityThreshold(qualityScore)) {
+                    return {
+                        content: [
+                            {
+                                type: 'text',
+                                text: `⚠ Memory quality too low: ${formatQualityScore(qualityScore)}\nThreshold: ${((config.quality_scoring_threshold ?? 0) * 100).toFixed(0)}%\nContent: "${content.substring(0, 100)}..."`,
+                            },
+                        ],
+                    };
+                }
+            }
+            // Format validity period for display
+            const validityStr = validFromDate || validUntilDate
+                ? ` (valid: ${validFromDate ? validFromDate.toLocaleDateString() : '∞'} → ${validUntilDate ? validUntilDate.toLocaleDateString() : '∞'})`
+                : '';
+            if (useGlobal) {
+                const projectName = path.basename(getProjectRoot());
+                const result = await saveGlobalMemory(content, embedding, tags, source, projectName, {
+                    type,
+                });
+                const tagStr = tags.length > 0 ? ` [${tags.join(', ')}]` : '';
+                const qualityStr = qualityScore ? ` ${formatQualityScore(qualityScore)}` : '';
+                if (result.isDuplicate) {
+                    return {
+                        content: [
+                            {
+                                type: 'text',
+                                text: `⚠ Similar global memory exists (id: ${result.id}, ${((result.similarity || 0) * 100).toFixed(0)}% similar). Skipped duplicate.`,
+                            },
+                        ],
+                    };
+                }
+                return {
+                    content: [
+                        {
+                            type: 'text',
+                            text: `✓ Remembered globally (id: ${result.id})${tagStr}${qualityStr}${validityStr} (project: ${projectName}):\n"${content.substring(0, 100)}${content.length > 100 ? '...' : ''}"`,
+                        },
+                    ],
+                };
+            }
+            const result = await saveMemory(content, embedding, tags, source, {
+                type,
+                qualityScore: qualityScore
+                    ? { score: qualityScore.score, factors: qualityScore.factors }
+                    : undefined,
+                validFrom: validFromDate,
+                validUntil: validUntilDate,
+            });
+            const tagStr = tags.length > 0 ? ` [${tags.join(', ')}]` : '';
+            const typeStr = type !== 'observation' ? ` (${type})` : '';
+            const qualityStr = qualityScore ? ` ${formatQualityScore(qualityScore)}` : '';
+            if (result.isDuplicate) {
+                return {
+                    content: [
+                        {
+                            type: 'text',
+                            text: `⚠ Similar memory exists (id: ${result.id}, ${((result.similarity || 0) * 100).toFixed(0)}% similar). Skipped duplicate.`,
+                        },
+                    ],
+                };
+            }
+            // Log to progress file (fire-and-forget)
+            try {
+                const { appendRawEntry } = await import('../../../lib/progress-log.js');
+                await appendRawEntry(`manual | +1 fact (${type}) | topics: ${tags.join(', ') || 'untagged'}`);
+            }
+            catch (error) {
+                logWarn('mcp-memory', 'Unable to append raw progress entry after remember save', {
+                    error: error instanceof Error ? error.message : String(error),
+                });
+            }
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: `✓ Remembered${typeStr} (id: ${result.id})${tagStr}${qualityStr}${validityStr}:\n"${content.substring(0, 100)}${content.length > 100 ? '...' : ''}"`,
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            const errorMsg = error instanceof Error ? error.message : String(error);
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: `Error saving memory: ${errorMsg}`,
+                    },
+                ],
+                isError: true,
+            };
+        }
+        finally {
+            closeDb();
+            closeGlobalDb();
+        }
+    });
+}
+//# sourceMappingURL=remember.js.map

package/dist/mcp/tools/memory/remember.js.map

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

package/dist/mcp/tools/memory/temporal-query.d.ts

@@ -0,0 +1,8 @@
+export declare function extractTemporalSubqueries(query: string): string[];
+/**
+ * Async version with LLM fallback for languages not covered by regex.
+ * Fast path: regex (sync, 0ms). Slow path: LLM decomposition (any language).
+ * Only invokes LLM when query contains non-Latin/Cyrillic characters (likely unsupported language).
+ */
+export declare function extractTemporalSubqueriesAsync(query: string): Promise<string[]>;
+//# sourceMappingURL=temporal-query.d.ts.map

package/dist/mcp/tools/memory/temporal-query.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"temporal-query.d.ts","sourceRoot":"","sources":["../../../../src/mcp/tools/memory/temporal-query.ts"],"names":[],"mappings":"AAGA,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,CAiCjE;AAED;;;;GAIG;AACH,wBAAsB,8BAA8B,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAsCrF"}

package/dist/mcp/tools/memory/temporal-query.js

@@ -0,0 +1,68 @@
+import { TEMPORAL_SUBQUERY_SYSTEM } from '../../../prompts/index.js';
+import { logWarn } from '../../../lib/fault-logger.js';
+export function extractTemporalSubqueries(query) {
+    // EN: "between X and Y" / RU: "между X и Y"
+    const betweenMatch = query.match(/(?:between|между)\s+(.+?)\s+(?:and|и)\s+(.+?)(?:\?|$)/i);
+    if (betweenMatch) {
+        return [betweenMatch[1].trim(), betweenMatch[2].trim()];
+    }
+    // EN: "from X to Y" / RU: "от X до Y" / "с X до Y" / "с X по Y"
+    const fromToMatch = query.match(/(?:from|от|с)\s+(.+?)\s+(?:to|до|по)\s+(.+?)(?:\?|$)/i);
+    if (fromToMatch) {
+        return [fromToMatch[1].trim(), fromToMatch[2].trim()];
+    }
+    // EN: "after X ... before Y" / "since X ... until Y"
+    // RU: "после X ... до Y" / "с тех пор как X ... до Y"
+    const afterBeforeMatch = query.match(/(?:after|since|после|с тех пор как)\s+(.+?)\s+(?:and|but|и|но)?\s*(?:before|until|до|перед)\s+(.+?)(?:\?|$)/i);
+    if (afterBeforeMatch) {
+        return [afterBeforeMatch[1].trim(), afterBeforeMatch[2].trim()];
+    }
+    // EN: "first time X ... last time Y"
+    // RU: "первый раз X ... последний раз Y" / "впервые X ... в последний раз Y"
+    const firstLastMatch = query.match(/(?:first\s+(?:time\s+)?|впервые\s+|в первый раз\s+)(.+?)\s+(?:and|,|и)\s*(?:last\s+(?:time\s+)?|в последний раз\s+|последний раз\s+)(.+?)(?:\?|$)/i);
+    if (firstLastMatch) {
+        return [firstLastMatch[1].trim(), firstLastMatch[2].trim()];
+    }
+    // No decomposition pattern matched — return original
+    return [query];
+}
+/**
+ * Async version with LLM fallback for languages not covered by regex.
+ * Fast path: regex (sync, 0ms). Slow path: LLM decomposition (any language).
+ * Only invokes LLM when query contains non-Latin/Cyrillic characters (likely unsupported language).
+ */
+export async function extractTemporalSubqueriesAsync(query) {
+    // Fast path: regex handles EN + RU
+    const regexResult = extractTemporalSubqueries(query);
+    if (regexResult.length > 1)
+        return regexResult;
+    // Only invoke LLM if the query contains characters outside Latin/Cyrillic scripts
+    // This avoids unnecessary LLM calls for EN/RU queries that simply have no temporal range
+    const hasNonLatinCyrillic = /[^\u0020-\u024F\u0400-\u04FF\s\d\p{P}]/u.test(query);
+    if (!hasNonLatinCyrillic)
+        return [query];
+    // Slow path: LLM decomposition for other languages (CJK, Arabic, etc.)
+    try {
+        const { callLLMChat } = await import('../../../lib/llm.js');
+        const result = await callLLMChat([
+            {
+                role: 'system',
+                content: TEMPORAL_SUBQUERY_SYSTEM,
+            },
+            { role: 'user', content: query },
+        ], { maxTokens: 200 });
+        const parsed = JSON.parse(result.trim());
+        if (Array.isArray(parsed) &&
+            parsed.length > 0 &&
+            parsed.every((s) => typeof s === 'string')) {
+            return parsed;
+        }
+    }
+    catch (error) {
+        logWarn('mcp-memory', 'Temporal query LLM decomposition failed', {
+            error: error instanceof Error ? error.message : String(error),
+        });
+    }
+    return [query];
+}
+//# sourceMappingURL=temporal-query.js.map

package/dist/mcp/tools/memory/temporal-query.js.map

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

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

@@ -1,14 +1,3 @@
-/**
- * MCP Memory tools
- *
- * - succ_remember: Save important information to memory
- * - succ_recall: Recall past memories (hybrid BM25 + semantic search)
- * - succ_forget: Delete memories
- *
- * Also includes helper functions:
- * - rememberWithLLMExtraction: Extract structured facts from content
- * - saveSingleMemory: Save single memory (fallback)
- */
 import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
 export declare function registerMemoryTools(server: McpServer): void;
 //# sourceMappingURL=memory.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"memory.d.ts","sourceRoot":"","sources":["../../../src/mcp/tools/memory.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AA2ZpE,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,SAAS,QAm/BpD"}
+{"version":3,"file":"memory.d.ts","sourceRoot":"","sources":["../../../src/mcp/tools/memory.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAKpE,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAI3D"}