@vinaes/succ 1.3.19

package/dist/commands/analyze-recursive.d.ts

@@ -0,0 +1,20 @@
+/** Threshold for switching to recursive analysis (chars) */
+export declare const RECURSIVE_ANALYSIS_THRESHOLD = 10000;
+/** Max chars per batch for chunk analysis */
+export declare const CHUNK_BATCH_SIZE = 8000;
+/** Max concurrent chunk analysis calls */
+export declare const CHUNK_ANALYSIS_CONCURRENCY = 3;
+export interface AnalyzeFileOptions {
+    mode?: 'claude' | 'api';
+}
+export interface AnalyzeFileResult {
+    success: boolean;
+    outputPath?: string;
+    error?: string;
+}
+/**
+ * Recursive analysis for large files: chunk → analyze → synthesize
+ */
+export declare function analyzeFileRecursive(fileContent: string, absolutePath: string, relativePath: string, fileName: string, ext: string, projectName: string, projectContext: string, wikilinksSection: string, mode: 'claude' | 'api'): Promise<string>;
+export declare function analyzeFile(filePath: string, options?: AnalyzeFileOptions): Promise<AnalyzeFileResult>;
+//# sourceMappingURL=analyze-recursive.d.ts.map

package/dist/commands/analyze-recursive.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"analyze-recursive.d.ts","sourceRoot":"","sources":["../../src/commands/analyze-recursive.ts"],"names":[],"mappings":"AAQA,4DAA4D;AAC5D,eAAO,MAAM,4BAA4B,QAAS,CAAC;AACnD,6CAA6C;AAC7C,eAAO,MAAM,gBAAgB,OAAQ,CAAC;AACtC,0CAA0C;AAC1C,eAAO,MAAM,0BAA0B,IAAI,CAAC;AAE5C,MAAM,WAAW,kBAAkB;IACjC,IAAI,CAAC,EAAE,QAAQ,GAAG,KAAK,CAAC;CACzB;AAED,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,OAAO,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AA+DD;;GAEG;AACH,wBAAsB,oBAAoB,CACxC,WAAW,EAAE,MAAM,EACnB,YAAY,EAAE,MAAM,EACpB,YAAY,EAAE,MAAM,EACpB,QAAQ,EAAE,MAAM,EAChB,GAAG,EAAE,MAAM,EACX,WAAW,EAAE,MAAM,EACnB,cAAc,EAAE,MAAM,EACtB,gBAAgB,EAAE,MAAM,EACxB,IAAI,EAAE,QAAQ,GAAG,KAAK,GACrB,OAAO,CAAC,MAAM,CAAC,CA4IjB;AAED,wBAAsB,WAAW,CAC/B,QAAQ,EAAE,MAAM,EAChB,OAAO,GAAE,kBAAuB,GAC/B,OAAO,CAAC,iBAAiB,CAAC,CAuJ5B"}

package/dist/commands/analyze-recursive.js

@@ -0,0 +1,326 @@
+import fs from 'fs';
+import path from 'path';
+import { getLLMTaskConfig, getProjectRoot, getSuccDir } from '../lib/config.js';
+import { NetworkError, ValidationError } from '../lib/errors.js';
+import { formatSymbolMap, batchChunks } from './analyze-helpers.js';
+import { cleanMarkdownOutput } from './analyze-utils.js';
+import { gatherMinimalContext, getExistingBrainDocs } from './analyze-profile.js';
+/** Threshold for switching to recursive analysis (chars) */
+export const RECURSIVE_ANALYSIS_THRESHOLD = 10_000;
+/** Max chars per batch for chunk analysis */
+export const CHUNK_BATCH_SIZE = 8_000;
+/** Max concurrent chunk analysis calls */
+export const CHUNK_ANALYSIS_CONCURRENCY = 3;
+/**
+ * Call the analyze LLM backend with a prompt (reuses analyzeFile's routing logic)
+ */
+async function callAnalyzeLLM(prompt, mode) {
+    if (mode === 'api') {
+        const cfg = getLLMTaskConfig('analyze');
+        const apiUrl = cfg.api_url;
+        const headers = {
+            'Content-Type': 'application/json',
+        };
+        if (cfg.api_key) {
+            headers['Authorization'] = `Bearer ${cfg.api_key}`;
+        }
+        if (apiUrl.includes('openrouter.ai')) {
+            headers['HTTP-Referer'] = 'https://succ.ai';
+            headers['X-Title'] = 'succ';
+        }
+        const completionUrl = apiUrl.endsWith('/v1')
+            ? `${apiUrl}/chat/completions`
+            : apiUrl.endsWith('/v1/')
+                ? `${apiUrl}chat/completions`
+                : apiUrl.endsWith('/')
+                    ? `${apiUrl}v1/chat/completions`
+                    : `${apiUrl}/v1/chat/completions`;
+        const response = await fetch(completionUrl, {
+            method: 'POST',
+            headers,
+            body: JSON.stringify({
+                model: cfg.model,
+                messages: [
+                    {
+                        role: 'system',
+                        content: 'You are an expert software documentation writer. Generate clear, concise documentation.',
+                    },
+                    { role: 'user', content: prompt },
+                ],
+                temperature: cfg.temperature ?? 0.3,
+                max_tokens: cfg.max_tokens ?? 4096,
+                stream: false,
+            }),
+        });
+        if (!response.ok) {
+            const error = await response.text();
+            throw new NetworkError(`API error: ${response.status} - ${error}`, response.status);
+        }
+        const data = (await response.json());
+        return data.choices?.[0]?.message?.content || null;
+    }
+    else {
+        const { spawnClaudeCLI } = await import('../lib/llm.js');
+        return (await spawnClaudeCLI(prompt, { tools: '', model: 'haiku', timeout: 120000 })) || null;
+    }
+}
+/**
+ * Recursive analysis for large files: chunk → analyze → synthesize
+ */
+export async function analyzeFileRecursive(fileContent, absolutePath, relativePath, fileName, ext, projectName, projectContext, wikilinksSection, mode) {
+    // Step 0: Extract symbol map via tree-sitter (fast, no LLM)
+    let symbolMap = '(tree-sitter unavailable)';
+    try {
+        const { extractSymbolsFromFile } = await import('../lib/tree-sitter/public.js');
+        const { symbols } = await extractSymbolsFromFile(absolutePath);
+        symbolMap = formatSymbolMap(symbols);
+    }
+    catch {
+        // tree-sitter unavailable — continue without symbol map
+    }
+    // Step 1: AST-aware chunking (tree-sitter with regex fallback)
+    const { chunkCodeAsync } = await import('../lib/chunker.js');
+    const chunks = await chunkCodeAsync(fileContent, absolutePath);
+    if (chunks.length === 0) {
+        throw new ValidationError('No chunks produced from file');
+    }
+    // Step 2: Batch chunks to fit LLM context
+    const batches = batchChunks(chunks, CHUNK_BATCH_SIZE);
+    const totalLines = fileContent.split('\n').length;
+    // Step 3: Analyze each batch (sequential with concurrency limit)
+    const chunkAnalyses = [];
+    const pending = [];
+    let activeCount = 0;
+    for (let i = 0; i < batches.length; i++) {
+        const batch = batches[i];
+        const batchContent = batch.map((c) => c.content).join('\n\n');
+        const startLine = batch[0].startLine;
+        const endLine = batch[batch.length - 1].endLine;
+        const chunkPrompt = `You are analyzing section ${i + 1}/${batches.length} of ${fileName} (${totalLines} lines total).
+
+File symbol map (all definitions in this file):
+${symbolMap}
+
+Project context: ${projectContext}
+
+Analyze this code section (lines ${startLine}-${endLine}) and extract:
+1. What each function/class/interface does (purpose, key logic)
+2. External dependencies imported
+3. Internal dependencies (calls to other project modules)
+4. Key patterns or algorithms
+5. Notable complexity or edge cases
+
+Code section:
+\`\`\`${ext.slice(1) || 'text'}
+${batchContent}
+\`\`\`
+
+Respond with a concise analysis. No frontmatter, no markdown headers, just facts.`;
+        // Simple concurrency: wait if at limit
+        while (activeCount >= CHUNK_ANALYSIS_CONCURRENCY) {
+            await Promise.race(pending);
+        }
+        const idx = i;
+        activeCount++;
+        const p = callAnalyzeLLM(chunkPrompt, mode)
+            .then((result) => {
+            chunkAnalyses[idx] = result || '(no analysis returned)';
+        })
+            .catch((err) => {
+            chunkAnalyses[idx] = `(analysis failed: ${err.message})`;
+        })
+            .finally(() => {
+            activeCount--;
+            pending.splice(pending.indexOf(p), 1);
+        });
+        pending.push(p);
+    }
+    // Wait for remaining
+    await Promise.all(pending);
+    // Step 4: Synthesize into unified document
+    const analysisJoined = chunkAnalyses
+        .map((a, i) => `### Section ${i + 1}/${batches.length}\n${a}`)
+        .join('\n\n');
+    const synthesisPrompt = `Create a unified documentation file for ${fileName} (${totalLines} lines).
+
+## Project Context
+${projectContext}
+${wikilinksSection}
+
+## File Symbol Map
+${symbolMap}
+
+## Section Analyses
+${analysisJoined}
+
+---
+
+Synthesize these section analyses into a single documentation file:
+
+1. YAML frontmatter (MUST be first):
+---
+description: "Brief description of this file's purpose"
+project: ${projectName}
+type: file-analysis
+relevance: medium
+file: ${relativePath}
+---
+
+2. Document structure:
+# ${fileName}
+
+**Parent:** [[Files]]
+**Path:** \`${relativePath}\`
+
+## Purpose
+What this file does and why it exists.
+
+## Key Components
+Main functions, classes, exports with brief descriptions.
+
+## Dependencies
+What it imports/requires. Use [[wikilinks]] ONLY for documents in "Existing Documentation".
+
+## Usage
+How this file is used in the project.
+
+CRITICAL FORMATTING RULES:
+- Your response MUST start with exactly \`---\` on the first line
+- NO text before the frontmatter
+- **Parent:** must be [[Files]]
+- ONLY use [[wikilinks]] for documents that exist in the "Existing Documentation" list
+- If a related file doesn't have documentation yet, mention it as plain text`;
+    const synthesized = await callAnalyzeLLM(synthesisPrompt, mode);
+    if (!synthesized) {
+        throw new NetworkError('Synthesis LLM call returned no content');
+    }
+    return synthesized;
+}
+export async function analyzeFile(filePath, options = {}) {
+    const projectRoot = getProjectRoot();
+    const succDir = getSuccDir();
+    const brainDir = path.join(succDir, 'brain');
+    // Determine mode
+    const analyzeCfg = getLLMTaskConfig('analyze');
+    const mode = options.mode || analyzeCfg.mode;
+    // Check file exists
+    const absolutePath = path.isAbsolute(filePath) ? filePath : path.join(projectRoot, filePath);
+    if (!fs.existsSync(absolutePath)) {
+        return { success: false, error: `File not found: ${absolutePath}` };
+    }
+    // Read file content
+    const fileContent = fs.readFileSync(absolutePath, 'utf-8');
+    const fileName = path.basename(filePath);
+    const relativePath = path.relative(projectRoot, absolutePath);
+    const ext = path.extname(filePath).toLowerCase();
+    // Determine output path in brain vault
+    const projectName = path.basename(projectRoot);
+    const outputDir = path.join(brainDir, 'project', 'files');
+    const outputPath = path.join(outputDir, `${fileName}.md`);
+    // Ensure output directory exists
+    fs.mkdirSync(outputDir, { recursive: true });
+    // Ensure Files.md MOC exists
+    const filesMocPath = path.join(brainDir, 'project', 'files', 'Files.md');
+    if (!fs.existsSync(filesMocPath)) {
+        const filesMocContent = `---
+description: "Source code file documentation"
+project: ${projectName}
+type: index
+relevance: high
+---
+
+# Files
+
+**Parent:** [[${projectName}]]
+
+Map of documented source files. Each file analysis includes purpose, key components, dependencies, and usage.
+
+## Documented Files
+
+_Files are automatically added here when analyzed._
+`;
+        fs.writeFileSync(filesMocPath, filesMocContent);
+    }
+    // Gather minimal project context
+    const projectContext = gatherMinimalContext(projectRoot);
+    // Get existing brain docs for wikilink suggestions
+    const existingDocs = getExistingBrainDocs(brainDir);
+    const wikilinksSection = existingDocs.length > 0
+        ? `\n## Existing Documentation (use these for [[wikilinks]]):\n${existingDocs.slice(0, 50).join(', ')}\n`
+        : '';
+    try {
+        let content = null;
+        if (fileContent.length > RECURSIVE_ANALYSIS_THRESHOLD) {
+            // Large file: recursive chunk-analyze-synthesize
+            content = await analyzeFileRecursive(fileContent, absolutePath, relativePath, fileName, ext, projectName, projectContext, wikilinksSection, mode);
+        }
+        else {
+            // Small file: single-pass analysis (original behavior)
+            const prompt = `Analyze this source file and create documentation.
+
+## Project Context
+${projectContext}
+${wikilinksSection}
+## File to Analyze
+File: ${relativePath}
+Extension: ${ext}
+
+Content:
+\`\`\`${ext.slice(1) || 'text'}
+${fileContent}
+\`\`\`
+
+---
+
+Create a documentation file following these rules:
+
+1. YAML frontmatter (MUST be first):
+---
+description: "Brief description of this file's purpose"
+project: ${projectName}
+type: file-analysis
+relevance: medium
+file: ${relativePath}
+---
+
+2. Document structure:
+# ${fileName}
+
+**Parent:** [[Files]]
+**Path:** \`${relativePath}\`
+
+## Purpose
+What this file does and why it exists.
+
+## Key Components
+Main functions, classes, exports with brief descriptions.
+
+## Dependencies
+What it imports/requires. Use [[wikilinks]] ONLY for documents listed in "Existing Documentation" section above.
+
+## Usage
+How this file is used in the project. Reference related files with [[wikilinks]] ONLY if they exist in the documentation list.
+
+CRITICAL FORMATTING RULES:
+- Your response MUST start with exactly \`---\` on the first line
+- NO text before the frontmatter (no "Let me...", "Here is...", "Based on...")
+- The first 3 characters of your output must be the three dashes
+- **Parent:** must be [[Files]] (not [[lib]] or folder names)
+- ONLY use [[wikilinks]] for documents that exist in the "Existing Documentation" list
+- If a related file doesn't have documentation yet, just mention it as plain text (no brackets)`;
+            content = await callAnalyzeLLM(prompt, mode);
+        }
+        if (!content) {
+            return { success: false, error: 'No content returned from LLM' };
+        }
+        // Clean output (remove preamble, code fences)
+        const cleanedContent = cleanMarkdownOutput(content);
+        // Write output
+        fs.writeFileSync(outputPath, cleanedContent);
+        return { success: true, outputPath };
+    }
+    catch (error) {
+        return { success: false, error: error.message };
+    }
+}
+//# sourceMappingURL=analyze-recursive.js.map

package/dist/commands/analyze-recursive.js.map

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

package/dist/commands/analyze-utils.d.ts

@@ -0,0 +1,83 @@
+import type { Agent } from './analyze-agents.js';
+import type { ProfileItem } from './analyze-profile.js';
+export interface AgentTiming {
+    name: string;
+    durationMs: number;
+    success: boolean;
+}
+export interface MultiPassOptions {
+    type: 'systems' | 'features';
+    projectName: string;
+    items: ProfileItem[];
+    callLLM: (prompt: string, context: string) => Promise<string>;
+    concurrency: number;
+    broadContext: string;
+    projectRoot: string;
+    onProgress: (completed: number, total: number, current: string) => void;
+}
+export interface MultiPassResult {
+    succeeded: Array<{
+        name: string;
+        content: string;
+    }>;
+    failed: Array<{
+        name: string;
+        error: string;
+    }>;
+}
+/**
+ * Sanitize a profile item name into a safe filename.
+ * Replaces /\:*?"<>| with dashes, collapses runs, trims.
+ */
+export declare function sanitizeFilename(name: string): string;
+/**
+ * Programmatic MOC (Map of Content) for Systems Overview or Features Overview.
+ * No LLM call — deterministic, zero-cost.
+ */
+export declare function buildMocContent(type: 'systems' | 'features', projectName: string, items: Array<{
+    name: string;
+    description: string;
+    keyFile: string;
+}>): string;
+/**
+ * Build a focused LLM prompt for ONE system or feature.
+ * Each item gets its own API call with full token budget.
+ */
+export declare function buildItemPrompt(type: 'systems' | 'features', projectName: string, item: ProfileItem): string;
+/**
+ * Targeted context for one system/feature: broad header + keyFile + siblings.
+ */
+export declare function gatherItemContext(projectRoot: string, item: ProfileItem, broadHeader: string): string;
+/**
+ * Run multi-pass: individual API calls per system/feature with concurrency control.
+ */
+export declare function runMultiPassItems(opts: MultiPassOptions): Promise<MultiPassResult>;
+/**
+ * Clean markdown output by removing code fences and preamble text that LLMs sometimes add
+ */
+export declare function cleanMarkdownOutput(content: string): string;
+/**
+ * Parse multi-file output from agents that create multiple files
+ * Format: ===FILE: filename.md===\ncontent\n===FILE: next.md===
+ */
+export declare function parseMultiFileOutput(content: string, baseDir: string): Array<{
+    path: string;
+    content: string;
+}>;
+/**
+ * Clean old sub-files from a directory before writing new multi-file output.
+ * Prevents duplicates when different models produce different filenames.
+ * Keeps the overview file (agent's main outputPath) and non-analyze files.
+ */
+export declare function cleanAgentSubfiles(outputDir: string, overviewPath: string): void;
+/**
+ * Write agent output, handling multi-file outputs
+ * Note: File writes are atomic (fs.writeFileSync), but we use lock
+ * to prevent daemon from writing while CLI might be reading
+ */
+export declare function writeAgentOutput(agent: Agent, content: string): Promise<void>;
+export declare function formatDuration(ms: number): string;
+export declare function printTimingSummary(timings: AgentTiming[], totalMs: number): void;
+export declare function ensureBrainStructure(brainDir: string, projectRoot: string): Promise<void>;
+export declare function generateIndexFiles(brainDir: string, projectName: string): Promise<void>;
+//# sourceMappingURL=analyze-utils.d.ts.map

package/dist/commands/analyze-utils.d.ts.map

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