@vinaes/succ 1.3.31 → 1.5.37

package/dist/lib/review/context-pack.js

@@ -0,0 +1,300 @@
+/**
+ * MR Context Pack Generator — builds review context from a git diff.
+ *
+ * Pipeline:
+ * 1. git diff → parse-diff → changed files + hunks
+ * 2. succ_search_code → related symbols for each changed function
+ * 3. succ_recall → past decisions/pitfalls for touched modules
+ * 4. git log → recent changes to same files
+ * 5. callLLM → structured review context pack
+ */
+import { execFileSync, execFile as execFileCb } from 'child_process';
+import { promisify } from 'util';
+import { parseDiffText, extractChangedSymbols, summarizeDiff } from '../diff-parser.js';
+import { getEmbedding } from '../embeddings.js';
+import { logWarn } from '../fault-logger.js';
+import { callLLM } from '../llm.js';
+import { getProjectRoot } from '../config.js';
+const execFileAsync = promisify(execFileCb);
+// ============================================================================
+// Main Pipeline
+// ============================================================================
+/**
+ * Generate a review context pack for a git diff reference.
+ *
+ * @param diffRef - Git diff reference (e.g., "HEAD~1", "main..feature", a commit SHA)
+ * @param options - Configuration options
+ */
+export async function generateReviewContext(diffRef = 'HEAD~1', options = {}) {
+    const { maxRelatedSymbols = 10, maxMemories = 10, generateLLMSummary = true } = options;
+    const projectRoot = getProjectRoot();
+    // Step 1: Get and parse diff
+    const diffResult = getDiff(diffRef, projectRoot);
+    if (diffResult.error) {
+        return emptyContextPack(`git diff failed: ${diffResult.error}`);
+    }
+    const parsed = parseDiffText(diffResult.text);
+    if (parsed.totalFiles === 0) {
+        return emptyContextPack('No changes found for the given diff reference.');
+    }
+    const changedSymbols = extractChangedSymbols(parsed);
+    // Step 2-4: Run searches in parallel
+    const [relatedSymbols, relevantMemories, recentHistory] = await Promise.all([
+        findRelatedSymbols(changedSymbols, parsed, maxRelatedSymbols),
+        findRelevantMemories(parsed, changedSymbols, maxMemories),
+        getRecentHistory(parsed, projectRoot),
+    ]);
+    // Step 5: Generate LLM summary
+    let summary = summarizeDiff(parsed);
+    let reviewFocus = [];
+    let blastRadius = 'Unknown';
+    if (generateLLMSummary) {
+        try {
+            const llmResult = await generateLLMReview(parsed, changedSymbols, relatedSymbols, relevantMemories, recentHistory);
+            summary = llmResult.summary;
+            reviewFocus = llmResult.reviewFocus;
+            blastRadius = llmResult.blastRadius;
+        }
+        catch (error) {
+            logWarn('review', 'LLM summary generation failed, using diff summary', {
+                error: error instanceof Error ? error.message : String(error),
+            });
+            reviewFocus = ['LLM summary unavailable — manual review recommended'];
+        }
+    }
+    return {
+        summary,
+        diffStats: {
+            files: parsed.totalFiles,
+            additions: parsed.totalAdditions,
+            deletions: parsed.totalDeletions,
+        },
+        changedFiles: parsed.files.map((f) => ({
+            path: f.to !== '/dev/null' ? f.to : f.from,
+            additions: f.additions,
+            deletions: f.deletions,
+            isNew: f.isNew,
+            isDeleted: f.isDeleted,
+        })),
+        changedSymbols,
+        relatedSymbols,
+        relevantMemories,
+        recentHistory,
+        reviewFocus,
+        blastRadius,
+    };
+}
+// ============================================================================
+// Pipeline Steps
+// ============================================================================
+function getDiff(diffRef, projectRoot) {
+    try {
+        // Validate diffRef: allow --cached/--staged, or refs that don't start with -
+        if (/^--(?:cached|staged)$/.test(diffRef)) {
+            // Allowed flags
+        }
+        else if (diffRef.startsWith('-')) {
+            throw new Error(`Invalid diff reference: ${diffRef}`);
+        }
+        else if (!/^[\w.~^/\-@{}]+$/.test(diffRef)) {
+            throw new Error(`Invalid diff reference: ${diffRef}`);
+        }
+        const text = execFileSync('git', ['diff', diffRef], {
+            cwd: projectRoot,
+            encoding: 'utf-8',
+            maxBuffer: 10 * 1024 * 1024, // 10MB
+            timeout: 30000,
+        });
+        return { text };
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        logWarn('review', 'git diff failed', { error: message, diffRef });
+        return { text: '', error: message };
+    }
+}
+async function findRelatedSymbols(changedSymbols, parsed, maxResults) {
+    const results = [];
+    try {
+        // Import dynamically to avoid circular deps
+        const { hybridSearchCode } = await import('../storage/index.js');
+        // Search for each changed symbol
+        const symbolQueries = changedSymbols.slice(0, 5); // Limit queries
+        for (const sym of symbolQueries) {
+            try {
+                const query = `${sym.symbol} ${sym.file}`;
+                const embedding = await getEmbedding(query);
+                const searchResults = await hybridSearchCode(query, embedding, 5, 0.3);
+                for (const r of searchResults) {
+                    // Skip files that are already in the diff
+                    const inDiff = parsed.files.some((f) => f.to === r.file_path || f.from === r.file_path);
+                    if (!inDiff && r.symbol_name) {
+                        results.push({
+                            file: r.file_path,
+                            symbol: r.symbol_name,
+                            similarity: r.similarity,
+                        });
+                    }
+                }
+            }
+            catch (error) {
+                logWarn('review', `Symbol search failed for ${sym.symbol}`, {
+                    error: error instanceof Error ? error.message : String(error),
+                });
+            }
+        }
+    }
+    catch (error) {
+        logWarn('review', 'Related symbol search unavailable', {
+            error: error instanceof Error ? error.message : String(error),
+        });
+    }
+    // Deduplicate and limit
+    const seen = new Set();
+    return results
+        .filter((r) => {
+        const key = `${r.file}:${r.symbol}`;
+        if (seen.has(key))
+            return false;
+        seen.add(key);
+        return true;
+    })
+        .sort((a, b) => b.similarity - a.similarity)
+        .slice(0, maxResults);
+}
+async function findRelevantMemories(parsed, changedSymbols, maxResults) {
+    const results = [];
+    try {
+        const { hybridSearchMemories } = await import('../storage/index.js');
+        // Build a query from changed files and symbols
+        const fileNames = parsed.files
+            .map((f) => (f.to !== '/dev/null' ? f.to : f.from))
+            .slice(0, 5)
+            .map((f) => f.split('/').pop())
+            .join(', ');
+        const symbolNames = changedSymbols
+            .slice(0, 5)
+            .map((s) => s.symbol)
+            .join(', ');
+        const query = `Changes to ${fileNames}. Functions: ${symbolNames}`;
+        const embedding = await getEmbedding(query);
+        const memResults = await hybridSearchMemories(query, embedding, maxResults, 0.2);
+        for (const m of memResults) {
+            results.push({
+                id: m.id ?? 0,
+                content: m.content ?? '',
+                tags: m.tags ?? [],
+                similarity: m.similarity ?? 0,
+            });
+        }
+    }
+    catch (error) {
+        logWarn('review', 'Memory search unavailable', {
+            error: error instanceof Error ? error.message : String(error),
+        });
+    }
+    return results;
+}
+async function getRecentHistory(parsed, projectRoot) {
+    const files = parsed.files
+        .map((f) => (f.to !== '/dev/null' ? f.to : f.from))
+        .filter((f) => f !== '/dev/null')
+        .slice(0, 10);
+    const settled = await Promise.allSettled(files.map(async (filePath) => {
+        const { stdout } = await execFileAsync('git', ['log', '--oneline', '-5', '--', filePath], {
+            cwd: projectRoot,
+            encoding: 'utf-8',
+            timeout: 10000,
+        });
+        const log = stdout.trim();
+        if (!log)
+            return null;
+        return { file: filePath, commits: log.split('\n').filter(Boolean) };
+    }));
+    const results = [];
+    for (let i = 0; i < settled.length; i++) {
+        const outcome = settled[i];
+        if (outcome.status === 'fulfilled' && outcome.value) {
+            results.push(outcome.value);
+        }
+        else if (outcome.status === 'rejected') {
+            logWarn('review', `Failed to get git history for ${files[i]}`, {
+                error: outcome.reason instanceof Error ? outcome.reason.message : String(outcome.reason),
+            });
+        }
+    }
+    return results;
+}
+async function generateLLMReview(parsed, changedSymbols, relatedSymbols, memories, history) {
+    const diffSummary = summarizeDiff(parsed);
+    const symbolsSection = changedSymbols.length > 0
+        ? `Changed functions/symbols:\n${changedSymbols.map((s) => `- ${s.file}: ${s.symbol}`).join('\n')}`
+        : 'No function-level changes detected.';
+    const relatedSection = relatedSymbols.length > 0
+        ? `Related code (not in diff but architecturally connected):\n${relatedSymbols
+            .slice(0, 5)
+            .map((s) => `- ${s.file}: ${s.symbol} (${(s.similarity * 100).toFixed(0)}% similar)`)
+            .join('\n')}`
+        : '';
+    const memorySection = memories.length > 0
+        ? `Relevant past decisions/learnings:\n${memories
+            .slice(0, 5)
+            .map((m) => `- [#${m.id}] ${m.content.substring(0, 150)}`)
+            .join('\n')}`
+        : '';
+    const historySection = history.length > 0
+        ? `Recent git history for changed files:\n${history
+            .slice(0, 5)
+            .map((h) => `- ${h.file}: ${h.commits[0]}`)
+            .join('\n')}`
+        : '';
+    const prompt = `You are a senior code reviewer. Analyze this change and produce a structured review context pack.
+
+${diffSummary}
+
+${symbolsSection}
+
+${relatedSection}
+
+${memorySection}
+
+${historySection}
+
+Respond in this exact format:
+SUMMARY: [1-2 sentence summary of what changed and why]
+FOCUS:
+- [review focus area 1]
+- [review focus area 2]
+- [review focus area 3]
+BLAST_RADIUS: [low/medium/high — how much of the codebase is affected]`;
+    const response = await callLLM(prompt, { maxTokens: 500 });
+    // Parse structured response
+    const summaryMatch = response.match(/SUMMARY:\s*(.+?)(?=\nFOCUS:|$)/s);
+    const focusMatch = response.match(/FOCUS:\s*([\s\S]+?)(?=\nBLAST_RADIUS:|$)/);
+    const blastMatch = response.match(/BLAST_RADIUS:\s*(.+)/);
+    const reviewFocus = focusMatch
+        ? focusMatch[1]
+            .split('\n')
+            .map((l) => l.replace(/^-\s*/, '').trim())
+            .filter(Boolean)
+        : [];
+    return {
+        summary: summaryMatch ? summaryMatch[1].trim() : summarizeDiff(parsed),
+        reviewFocus,
+        blastRadius: blastMatch ? blastMatch[1].trim() : 'unknown',
+    };
+}
+function emptyContextPack(summary) {
+    return {
+        summary,
+        diffStats: { files: 0, additions: 0, deletions: 0 },
+        changedFiles: [],
+        changedSymbols: [],
+        relatedSymbols: [],
+        relevantMemories: [],
+        recentHistory: [],
+        reviewFocus: [],
+        blastRadius: 'none',
+    };
+}
+//# sourceMappingURL=context-pack.js.map

package/dist/lib/review/context-pack.js.map

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

package/dist/lib/search/hierarchical-summaries.d.ts

@@ -0,0 +1,65 @@
+/**
+ * Hierarchical Summaries — RAPTOR-style multi-level abstraction.
+ *
+ * Generates zoom-level summaries: file → directory → module → repo.
+ * Different query granularity needs different zoom levels:
+ *   "What does hashPassword do?" → file-level
+ *   "What does the auth module do?" → directory-level
+ *   "Describe this project" → repo-level
+ *
+ * Summaries are stored as memory nodes with level metadata,
+ * enabling search at the appropriate zoom based on query specificity.
+ */
+export type SummaryLevel = 'file' | 'directory' | 'module' | 'repo';
+export interface HierarchicalSummary {
+    /** Relative path from project root (file or directory) */
+    path: string;
+    /** Zoom level */
+    level: SummaryLevel;
+    /** LLM-generated summary text */
+    summary: string;
+    /** Key exported symbols (for file level) */
+    symbols?: string[];
+    /** Number of files covered */
+    fileCount: number;
+    /** Total lines of code covered */
+    lineCount: number;
+    /** Child paths (for directory/module/repo levels) */
+    children?: string[];
+}
+export interface HierarchicalSummaryResult {
+    summaries: HierarchicalSummary[];
+    totalFiles: number;
+    totalDirectories: number;
+    levels: Record<SummaryLevel, number>;
+}
+/**
+ * Generate hierarchical summaries for a codebase.
+ *
+ * Builds summaries bottom-up: files → directories → module groups → repo.
+ *
+ * @param rootPath - Project root (default: getProjectRoot())
+ * @param options - Generation options
+ */
+export declare function generateHierarchicalSummaries(rootPath?: string, options?: {
+    /** Only summarize files matching these extensions */
+    extensions?: Set<string>;
+    /** Directories to exclude */
+    excludes?: Set<string>;
+    /** Max files to summarize (default: 200) */
+    maxFiles?: number;
+    /** Max concurrent LLM calls (default: 3) */
+    concurrency?: number;
+    /** Generate repo-level summary (default: true) */
+    includeRepo?: boolean;
+}): Promise<HierarchicalSummaryResult>;
+/**
+ * Get the appropriate summary level for a query based on specificity.
+ *
+ * Heuristic: specific symbol/file queries → file level first,
+ * then explicit scope keywords, then broad repo phrases.
+ * Symbol checks must precede generic repo phrases so that
+ * "what does myFunction do" resolves to file, not repo.
+ */
+export declare function inferSummaryLevel(query: string): SummaryLevel;
+//# sourceMappingURL=hierarchical-summaries.d.ts.map

package/dist/lib/search/hierarchical-summaries.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hierarchical-summaries.d.ts","sourceRoot":"","sources":["../../../src/lib/search/hierarchical-summaries.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAaH,MAAM,MAAM,YAAY,GAAG,MAAM,GAAG,WAAW,GAAG,QAAQ,GAAG,MAAM,CAAC;AAEpE,MAAM,WAAW,mBAAmB;IAClC,0DAA0D;IAC1D,IAAI,EAAE,MAAM,CAAC;IACb,iBAAiB;IACjB,KAAK,EAAE,YAAY,CAAC;IACpB,iCAAiC;IACjC,OAAO,EAAE,MAAM,CAAC;IAChB,4CAA4C;IAC5C,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,8BAA8B;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,kCAAkC;IAClC,SAAS,EAAE,MAAM,CAAC;IAClB,qDAAqD;IACrD,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;CACrB;AAED,MAAM,WAAW,yBAAyB;IACxC,SAAS,EAAE,mBAAmB,EAAE,CAAC;IACjC,UAAU,EAAE,MAAM,CAAC;IACnB,gBAAgB,EAAE,MAAM,CAAC;IACzB,MAAM,EAAE,MAAM,CAAC,YAAY,EAAE,MAAM,CAAC,CAAC;CACtC;AAsJD;;;;;;;GAOG;AACH,wBAAsB,6BAA6B,CACjD,QAAQ,CAAC,EAAE,MAAM,EACjB,OAAO,CAAC,EAAE;IACR,qDAAqD;IACrD,UAAU,CAAC,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IACzB,6BAA6B;IAC7B,QAAQ,CAAC,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IACvB,4CAA4C;IAC5C,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,4CAA4C;IAC5C,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,kDAAkD;IAClD,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB,GACA,OAAO,CAAC,yBAAyB,CAAC,CA+MpC;AAED;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,YAAY,CAmC7D"}