@luckydraw/cumulus 0.5.1

package/dist/lib/config.js

@@ -0,0 +1,241 @@
+/**
+ * Configuration loading and always-include file management.
+ *
+ * Handles global and per-thread configuration, including reading
+ * files that should always be included in the context window.
+ */
+import * as fs from 'fs';
+import * as os from 'os';
+import * as path from 'path';
+import { estimateTokens } from './context-budget.js';
+const CUMULUS_DIR = path.join(os.homedir(), '.cumulus');
+const THREADS_DIR = path.join(CUMULUS_DIR, 'threads');
+/**
+ * Load the global configuration from ~/.cumulus/config.json
+ */
+export async function loadGlobalConfig() {
+    const configPath = path.join(CUMULUS_DIR, 'config.json');
+    return loadConfigFile(configPath);
+}
+/**
+ * Load thread-specific configuration from ~/.cumulus/threads/{thread}.config.json
+ */
+export async function loadThreadConfig(threadName) {
+    const configPath = path.join(THREADS_DIR, `${threadName}.config.json`);
+    return loadConfigFile(configPath);
+}
+/**
+ * Load a configuration file, returning empty config if not found or invalid.
+ */
+async function loadConfigFile(configPath) {
+    try {
+        if (!fs.existsSync(configPath)) {
+            return {};
+        }
+        const content = fs.readFileSync(configPath, 'utf-8');
+        const config = JSON.parse(content);
+        // Validate structure
+        if (typeof config !== 'object' || config === null) {
+            console.warn(`[Config] Invalid config format in ${configPath}, using empty config`);
+            return {};
+        }
+        // Validate alwaysInclude if present
+        if (config.alwaysInclude !== undefined) {
+            if (!Array.isArray(config.alwaysInclude)) {
+                console.warn(`[Config] alwaysInclude must be an array in ${configPath}`);
+                return {};
+            }
+            for (const item of config.alwaysInclude) {
+                if (typeof item !== 'string') {
+                    console.warn(`[Config] alwaysInclude items must be strings in ${configPath}`);
+                    return {};
+                }
+            }
+        }
+        // Validate projectDir if present
+        if (config.projectDir !== undefined) {
+            if (typeof config.projectDir !== 'string') {
+                console.warn(`[Config] projectDir must be a string in ${configPath}`);
+                delete config.projectDir;
+            }
+        }
+        return config;
+    }
+    catch (err) {
+        if (err instanceof SyntaxError) {
+            console.warn(`[Config] Failed to parse ${configPath}: ${err.message}`);
+        }
+        return {};
+    }
+}
+/**
+ * Merge global and thread configs. Thread config adds to global (doesn't override).
+ */
+export function mergeConfigs(global, thread) {
+    const merged = {};
+    // Merge alwaysInclude arrays (deduplicated, thread additions come after global)
+    const globalIncludes = global.alwaysInclude ?? [];
+    const threadIncludes = thread.alwaysInclude ?? [];
+    if (globalIncludes.length > 0 || threadIncludes.length > 0) {
+        const seen = new Set();
+        merged.alwaysInclude = [];
+        for (const item of [...globalIncludes, ...threadIncludes]) {
+            if (!seen.has(item)) {
+                seen.add(item);
+                merged.alwaysInclude.push(item);
+            }
+        }
+    }
+    // projectDir: thread overrides global (simple override, not array merge)
+    const projectDir = thread.projectDir ?? global.projectDir;
+    if (projectDir) {
+        merged.projectDir = projectDir;
+    }
+    return merged;
+}
+/**
+ * Resolve a file path that may use ~ or be relative.
+ * @param filePath - The path from config (may use ~, be relative, or absolute)
+ * @param cwd - Current working directory for relative paths
+ */
+export function resolveFilePath(filePath, cwd) {
+    // Handle ~ for home directory
+    if (filePath.startsWith('~/')) {
+        return path.join(os.homedir(), filePath.slice(2));
+    }
+    if (filePath === '~') {
+        return os.homedir();
+    }
+    // Handle absolute paths
+    if (path.isAbsolute(filePath)) {
+        return filePath;
+    }
+    // Relative path - resolve from cwd
+    return path.resolve(cwd, filePath);
+}
+/**
+ * Read and format all always-include files from config.
+ * @param config - Merged configuration
+ * @param cwd - Current working directory for relative paths
+ */
+export async function readAlwaysIncludeFiles(config, cwd) {
+    const files = [];
+    let totalTokens = 0;
+    const paths = config.alwaysInclude ?? [];
+    for (const filePath of paths) {
+        const resolvedPath = resolveFilePath(filePath, cwd);
+        const fileInfo = {
+            path: filePath,
+            resolvedPath,
+            content: '',
+            tokens: 0,
+            truncated: false,
+        };
+        try {
+            if (!fs.existsSync(resolvedPath)) {
+                fileInfo.error = 'File not found';
+                console.warn(`[Config] Always-include file not found: ${resolvedPath}`);
+            }
+            else {
+                const stat = fs.statSync(resolvedPath);
+                if (stat.isDirectory()) {
+                    fileInfo.error = 'Path is a directory';
+                    console.warn(`[Config] Always-include path is a directory: ${resolvedPath}`);
+                }
+                else {
+                    const content = fs.readFileSync(resolvedPath, 'utf-8');
+                    fileInfo.content = content;
+                    fileInfo.tokens = estimateTokens(content);
+                    totalTokens += fileInfo.tokens;
+                }
+            }
+        }
+        catch (err) {
+            const errorMsg = err instanceof Error ? err.message : 'Unknown error';
+            fileInfo.error = errorMsg;
+            console.warn(`[Config] Failed to read always-include file ${resolvedPath}: ${errorMsg}`);
+        }
+        files.push(fileInfo);
+    }
+    // Format the context string
+    const formattedContext = formatAlwaysIncludeContext(files);
+    return {
+        files,
+        totalTokens,
+        formattedContext,
+    };
+}
+/**
+ * Format always-include files into a context string for the system prompt.
+ */
+function formatAlwaysIncludeContext(files) {
+    const validFiles = files.filter(f => !f.error && f.content);
+    if (validFiles.length === 0) {
+        return '';
+    }
+    const lines = ['\nALWAYS-INCLUDED FILES (project context):', '---'];
+    for (const file of validFiles) {
+        lines.push(`[${file.path}]`);
+        lines.push(file.content);
+        lines.push('');
+    }
+    lines.push('---\n');
+    return lines.join('\n');
+}
+/**
+ * Save configuration to a file.
+ */
+export async function saveConfig(config, threadName) {
+    const configPath = threadName
+        ? path.join(THREADS_DIR, `${threadName}.config.json`)
+        : path.join(CUMULUS_DIR, 'config.json');
+    // Ensure directory exists
+    const dir = path.dirname(configPath);
+    if (!fs.existsSync(dir)) {
+        fs.mkdirSync(dir, { recursive: true });
+    }
+    fs.writeFileSync(configPath, JSON.stringify(config, null, 2) + '\n');
+}
+/**
+ * Add a file to the always-include list.
+ * @param filePath - Path to add
+ * @param threadName - Thread name for thread-specific config, undefined for global
+ */
+export async function addAlwaysIncludeFile(filePath, threadName) {
+    const config = threadName ? await loadThreadConfig(threadName) : await loadGlobalConfig();
+    const alwaysInclude = config.alwaysInclude ?? [];
+    if (!alwaysInclude.includes(filePath)) {
+        alwaysInclude.push(filePath);
+        config.alwaysInclude = alwaysInclude;
+        await saveConfig(config, threadName);
+    }
+}
+/**
+ * Remove a file from the always-include list.
+ * @param filePath - Path to remove
+ * @param threadName - Thread name for thread-specific config, undefined for global
+ */
+export async function removeAlwaysIncludeFile(filePath, threadName) {
+    const config = threadName ? await loadThreadConfig(threadName) : await loadGlobalConfig();
+    const alwaysInclude = config.alwaysInclude ?? [];
+    const index = alwaysInclude.indexOf(filePath);
+    if (index !== -1) {
+        alwaysInclude.splice(index, 1);
+        config.alwaysInclude = alwaysInclude.length > 0 ? alwaysInclude : undefined;
+        await saveConfig(config, threadName);
+    }
+}
+/**
+ * List all always-include files from config (without reading them).
+ */
+export async function listAlwaysIncludeFiles(threadName) {
+    const globalConfig = await loadGlobalConfig();
+    const threadConfig = threadName ? await loadThreadConfig(threadName) : {};
+    const mergedConfig = mergeConfigs(globalConfig, threadConfig);
+    return {
+        global: globalConfig.alwaysInclude ?? [],
+        thread: threadConfig.alwaysInclude ?? [],
+        merged: mergedConfig.alwaysInclude ?? [],
+    };
+}
+//# sourceMappingURL=config.js.map

package/dist/lib/config.js.map

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

package/dist/lib/content-detector.d.ts

@@ -0,0 +1,46 @@
+import { ContentType } from './content-store.js';
+/**
+ * Detailed content analysis result.
+ */
+export interface ContentAnalysis {
+    /** Detected content type */
+    contentType: ContentType;
+    /** Confidence score (0-1) */
+    confidence: number;
+    /** Detected language/format if applicable */
+    language?: string;
+    /** Key features detected */
+    features: string[];
+}
+/**
+ * Options for summary generation.
+ */
+export interface SummaryOptions {
+    /** Maximum summary length in characters */
+    maxLength?: number;
+    /** Whether to use LLM for summarization */
+    useLLM?: boolean;
+    /** Model to use for LLM summarization */
+    model?: 'haiku' | 'sonnet';
+}
+/**
+ * Analyze content to determine its type and characteristics.
+ */
+export declare function analyzeContent(content: string): ContentAnalysis;
+/**
+ * Generate a heuristic summary without LLM.
+ */
+export declare function generateHeuristicSummary(content: string, contentType: ContentType, maxLength?: number): string;
+/**
+ * Generate summary using LLM (via claude CLI).
+ */
+export declare function generateLLMSummary(content: string, contentType: ContentType, options?: SummaryOptions): Promise<string>;
+/**
+ * Generate summary for content, optionally using LLM.
+ */
+export declare function generateSummary(content: string, contentType: ContentType, options?: SummaryOptions): Promise<string>;
+/**
+ * Detect content type from content string.
+ */
+export declare function detectContentType(content: string): ContentType;
+//# sourceMappingURL=content-detector.d.ts.map

package/dist/lib/content-detector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"content-detector.d.ts","sourceRoot":"","sources":["../../src/lib/content-detector.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAEjD;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,4BAA4B;IAC5B,WAAW,EAAE,WAAW,CAAC;IACzB,6BAA6B;IAC7B,UAAU,EAAE,MAAM,CAAC;IACnB,6CAA6C;IAC7C,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,4BAA4B;IAC5B,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,2CAA2C;IAC3C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,2CAA2C;IAC3C,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,yCAAyC;IACzC,KAAK,CAAC,EAAE,OAAO,GAAG,QAAQ,CAAC;CAC5B;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,eAAe,CAgJ/D;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CACtC,OAAO,EAAE,MAAM,EACf,WAAW,EAAE,WAAW,EACxB,SAAS,GAAE,MAAY,GACtB,MAAM,CA8JR;AAED;;GAEG;AACH,wBAAsB,kBAAkB,CACtC,OAAO,EAAE,MAAM,EACf,WAAW,EAAE,WAAW,EACxB,OAAO,GAAE,cAAmB,GAC3B,OAAO,CAAC,MAAM,CAAC,CAyDjB;AAED;;GAEG;AACH,wBAAsB,eAAe,CACnC,OAAO,EAAE,MAAM,EACf,WAAW,EAAE,WAAW,EACxB,OAAO,GAAE,cAAmB,GAC3B,OAAO,CAAC,MAAM,CAAC,CAKjB;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,WAAW,CAE9D"}

package/dist/lib/content-detector.js

@@ -0,0 +1,359 @@
+import { spawn } from 'child_process';
+/**
+ * Analyze content to determine its type and characteristics.
+ */
+export function analyzeContent(content) {
+    const lines = content.split('\n');
+    const sample = content.slice(0, 5000);
+    const features = [];
+    let language;
+    // Score different content types
+    const scores = {
+        code: 0,
+        logs: 0,
+        json: 0,
+        prose: 0,
+        mixed: 0,
+    };
+    // JSON detection
+    if (sample.trim().startsWith('{') || sample.trim().startsWith('[')) {
+        try {
+            JSON.parse(content);
+            scores.json = 10;
+            features.push('valid_json');
+        }
+        catch {
+            scores.json = 2; // Looks like JSON but invalid
+        }
+    }
+    // Code detection patterns
+    const codePatterns = [
+        // JavaScript/TypeScript
+        { pattern: /^import\s+.*from\s+['"]/, weight: 3, lang: 'javascript' },
+        {
+            pattern: /^export\s+(default\s+)?(?:function|class|const|let|interface|type)/,
+            weight: 3,
+            lang: 'javascript',
+        },
+        { pattern: /^(?:const|let|var)\s+\w+\s*[=:]/, weight: 2, lang: 'javascript' },
+        { pattern: /=>\s*[{(]/, weight: 2, lang: 'javascript' },
+        // Python
+        { pattern: /^def\s+\w+\s*\(/, weight: 3, lang: 'python' },
+        { pattern: /^class\s+\w+.*:$/, weight: 3, lang: 'python' },
+        { pattern: /^import\s+\w+$/, weight: 2, lang: 'python' },
+        { pattern: /^from\s+\w+\s+import/, weight: 3, lang: 'python' },
+        // Rust
+        { pattern: /^fn\s+\w+/, weight: 3, lang: 'rust' },
+        { pattern: /^impl\s+/, weight: 3, lang: 'rust' },
+        { pattern: /^use\s+\w+::/, weight: 2, lang: 'rust' },
+        // Go
+        { pattern: /^func\s+(\(\w+\s+\*?\w+\)\s+)?\w+/, weight: 3, lang: 'go' },
+        { pattern: /^package\s+\w+/, weight: 3, lang: 'go' },
+        // General
+        { pattern: /^\s*(?:if|for|while|switch)\s*\(/, weight: 1 },
+        { pattern: /^\s*(?:public|private|protected)\s+/, weight: 2, lang: 'java' },
+        { pattern: /^\s*#include\s*</, weight: 3, lang: 'c' },
+        { pattern: /^\s*@\w+/, weight: 1 }, // Decorators/annotations
+    ];
+    const langCounts = {};
+    for (const { pattern, weight, lang } of codePatterns) {
+        const matches = sample.match(new RegExp(pattern.source, 'gm'));
+        if (matches) {
+            scores.code += weight * Math.min(matches.length, 5);
+            if (lang) {
+                langCounts[lang] = (langCounts[lang] ?? 0) + weight * matches.length;
+            }
+        }
+    }
+    // Detect most likely language
+    if (Object.keys(langCounts).length > 0) {
+        language = Object.entries(langCounts).sort((a, b) => b[1] - a[1])[0]?.[0];
+        features.push(`language_${language}`);
+    }
+    // Log detection patterns
+    const logPatterns = [
+        { pattern: /^\d{4}-\d{2}-\d{2}[T\s]\d{2}:\d{2}:\d{2}/, weight: 3, feature: 'timestamps' },
+        { pattern: /^\[\d{4}-\d{2}-\d{2}/, weight: 3, feature: 'bracketed_timestamps' },
+        { pattern: /^\[(?:DEBUG|INFO|WARN|ERROR|FATAL)\]/, weight: 3, feature: 'log_levels' },
+        { pattern: /^(?:DEBUG|INFO|WARN|ERROR|FATAL)[:\s]/, weight: 2, feature: 'log_levels' },
+        { pattern: /^\d+:\d+:\d+\.\d+/, weight: 2, feature: 'timestamps' },
+        {
+            pattern: /^[A-Za-z]{3}\s+\d{1,2}\s+\d{2}:\d{2}:\d{2}/,
+            weight: 2,
+            feature: 'syslog_timestamps',
+        },
+        { pattern: /^\s*at\s+[\w.$]+\s*\(/, weight: 2, feature: 'stack_traces' },
+        { pattern: /^Traceback \(most recent call last\):/, weight: 3, feature: 'python_traceback' },
+    ];
+    for (const { pattern, weight, feature } of logPatterns) {
+        const matches = sample.match(new RegExp(pattern.source, 'gm'));
+        if (matches) {
+            scores.logs += weight * Math.min(matches.length, 10);
+            if (feature && !features.includes(feature)) {
+                features.push(feature);
+            }
+        }
+    }
+    // Prose detection
+    const avgLineLength = content.length / Math.max(lines.length, 1);
+    const nonEmptyLines = lines.filter(l => l.trim()).length;
+    const avgWordsPerLine = content.split(/\s+/).length / Math.max(nonEmptyLines, 1);
+    // Prose characteristics: long lines, sentence structure, paragraphs
+    if (avgLineLength > 60)
+        scores.prose += 2;
+    if (avgWordsPerLine > 10)
+        scores.prose += 2;
+    if (/[.!?]\s+[A-Z]/.test(sample))
+        scores.prose += 3; // Sentence boundaries
+    if (/\n\n/.test(content))
+        scores.prose += 1; // Paragraphs
+    if (!/[{}()[\];]/.test(sample.slice(0, 500)))
+        scores.prose += 2; // No code punctuation
+    // Determine winner
+    const maxScore = Math.max(scores.code, scores.logs, scores.json, scores.prose);
+    let contentType;
+    let confidence;
+    if (maxScore === 0) {
+        contentType = 'mixed';
+        confidence = 0.3;
+    }
+    else if (scores.json === maxScore && scores.json >= 5) {
+        contentType = 'json';
+        confidence = Math.min(0.95, 0.5 + scores.json * 0.05);
+        features.push('structured_data');
+    }
+    else if (scores.code === maxScore && scores.code >= 4) {
+        contentType = 'code';
+        confidence = Math.min(0.9, 0.4 + scores.code * 0.03);
+    }
+    else if (scores.logs === maxScore && scores.logs >= 4) {
+        contentType = 'logs';
+        confidence = Math.min(0.9, 0.4 + scores.logs * 0.03);
+    }
+    else if (scores.prose === maxScore && scores.prose >= 4) {
+        contentType = 'prose';
+        confidence = Math.min(0.85, 0.4 + scores.prose * 0.05);
+    }
+    else {
+        // Mixed or unclear
+        contentType = 'mixed';
+        confidence = 0.5;
+    }
+    return {
+        contentType,
+        confidence,
+        language,
+        features,
+    };
+}
+/**
+ * Generate a heuristic summary without LLM.
+ */
+export function generateHeuristicSummary(content, contentType, maxLength = 300) {
+    const lines = content.split('\n').filter(l => l.trim());
+    const lineCount = lines.length;
+    const charCount = content.length;
+    let summary = `${lineCount} lines, ${Math.round(charCount / 1024)}KB. `;
+    switch (contentType) {
+        case 'code': {
+            const items = [];
+            // Extract import sources (module paths)
+            const importSourceMatches = content.match(/(?:from\s+['"]([^'"]+)['"]|require\(\s*['"]([^'"]+)['"]|use\s+([\w:]+))/gm);
+            if (importSourceMatches && importSourceMatches.length > 0) {
+                const sources = importSourceMatches
+                    .map(m => {
+                    const fromMatch = m.match(/from\s+['"]([^'"]+)['"]/);
+                    if (fromMatch)
+                        return fromMatch[1];
+                    const reqMatch = m.match(/require\(\s*['"]([^'"]+)['"]/);
+                    if (reqMatch)
+                        return reqMatch[1];
+                    const useMatch = m.match(/use\s+([\w:]+)/);
+                    if (useMatch)
+                        return useMatch[1];
+                    return null;
+                })
+                    .filter(Boolean)
+                    .slice(0, 5);
+                if (sources.length > 0) {
+                    items.push(`imports: ${sources.join(', ')}`);
+                }
+            }
+            else {
+                // Fallback: count import lines
+                const importLines = content.match(/^(?:import|from|require|use)\s+.+$/gm);
+                if (importLines && importLines.length > 0) {
+                    items.push(`${importLines.length} imports`);
+                }
+            }
+            // Extract exports/public API
+            const exportMatches = content.match(/^export\s+(?:default\s+)?(?:function|class|const|interface|type)\s+(\w+)/gm);
+            if (exportMatches) {
+                const names = exportMatches
+                    .map(m => m.match(/(\w+)$/)?.[1])
+                    .filter(Boolean)
+                    .slice(0, 5);
+                if (names.length > 0) {
+                    items.push(`exports: ${names.join(', ')}`);
+                }
+            }
+            // Extract function signatures with parameters
+            const funcSigMatches = content.match(/(?:(?:export\s+)?(?:async\s+)?function\s+\w+\s*\([^)]*\)|(?:async\s+)?def\s+\w+\s*\([^)]*\)|(?:pub\s+)?(?:async\s+)?fn\s+\w+\s*\([^)]*\)|func\s+(?:\([^)]*\)\s*)?\w+\s*\([^)]*\))/gm);
+            if (funcSigMatches) {
+                const sigs = funcSigMatches.map(m => m.replace(/\s+/g, ' ').trim()).slice(0, 5);
+                if (sigs.length > 0 && !items.some(i => i.includes('exports'))) {
+                    items.push(`functions: ${sigs.join(', ')}`);
+                }
+            }
+            // Extract class hierarchies (extends/implements)
+            const classHierarchyMatches = content.match(/(?:class|struct)\s+\w+(?:\s+(?:extends|implements)\s+[\w,\s]+)?/gm);
+            if (classHierarchyMatches) {
+                const classes = classHierarchyMatches.map(m => m.replace(/\s+/g, ' ').trim()).slice(0, 3);
+                if (classes.length > 0) {
+                    items.push(`classes: ${classes.join(', ')}`);
+                }
+            }
+            // Extract type/interface names
+            const typeMatches = content.match(/(?:interface|type|enum)\s+(\w+)/g);
+            if (typeMatches) {
+                const names = typeMatches
+                    .map(m => m.split(/\s+/)[1])
+                    .filter(Boolean)
+                    .slice(0, 5);
+                if (names.length > 0) {
+                    items.push(`types: ${names.join(', ')}`);
+                }
+            }
+            // Extract UPPER_CASE constants
+            const constMatches = content.match(/(?:const|let|var)\s+([A-Z][A-Z0-9_]{2,})\s*=/gm);
+            if (constMatches) {
+                const names = constMatches
+                    .map(m => m.match(/([A-Z][A-Z0-9_]{2,})/)?.[1])
+                    .filter(Boolean)
+                    .slice(0, 5);
+                if (names.length > 0) {
+                    items.push(`constants: ${names.join(', ')}`);
+                }
+            }
+            summary += items.length > 0 ? items.join('; ') : 'Code file';
+            break;
+        }
+        case 'logs': {
+            const items = [];
+            // Count log levels
+            const errorCount = (content.match(/\b(?:ERROR|FATAL|Exception|Error:)/gi) || []).length;
+            const warnCount = (content.match(/\bWARN(?:ING)?/gi) || []).length;
+            const infoCount = (content.match(/\bINFO/gi) || []).length;
+            if (errorCount > 0)
+                items.push(`${errorCount} errors`);
+            if (warnCount > 0)
+                items.push(`${warnCount} warnings`);
+            if (infoCount > 0)
+                items.push(`${infoCount} info`);
+            // Try to extract time range
+            const timestamps = content.match(/\d{4}-\d{2}-\d{2}[T\s]\d{2}:\d{2}:\d{2}/g);
+            if (timestamps && timestamps.length >= 2) {
+                items.push(`from ${timestamps[0]} to ${timestamps[timestamps.length - 1]}`);
+            }
+            summary += items.length > 0 ? items.join(', ') : 'Log output';
+            break;
+        }
+        case 'json': {
+            try {
+                const parsed = JSON.parse(content);
+                if (Array.isArray(parsed)) {
+                    summary += `Array with ${parsed.length} items`;
+                    if (parsed.length > 0 && typeof parsed[0] === 'object') {
+                        const keys = Object.keys(parsed[0]).slice(0, 5);
+                        summary += `. Item keys: ${keys.join(', ')}`;
+                    }
+                }
+                else if (typeof parsed === 'object' && parsed !== null) {
+                    const keys = Object.keys(parsed);
+                    summary += `Object with ${keys.length} keys: ${keys.slice(0, 7).join(', ')}`;
+                    if (keys.length > 7)
+                        summary += '...';
+                }
+            }
+            catch {
+                summary += 'JSON data';
+            }
+            break;
+        }
+        case 'prose': {
+            // Take first paragraph or sentences
+            const firstPara = content.split(/\n\n/)[0] ?? '';
+            const preview = firstPara.slice(0, maxLength - summary.length - 10);
+            summary += preview + (firstPara.length > preview.length ? '...' : '');
+            break;
+        }
+        default:
+            summary += 'Mixed content';
+    }
+    return summary.slice(0, maxLength);
+}
+/**
+ * Generate summary using LLM (via claude CLI).
+ */
+export async function generateLLMSummary(content, contentType, options = {}) {
+    const maxLength = options.maxLength ?? 300;
+    const model = options.model ?? 'haiku';
+    // Truncate content if too long
+    const truncatedContent = content.slice(0, 15000);
+    const prompt = `Summarize this ${contentType} content in ${maxLength} characters or less. Focus on:
+- What it is/does
+- Key elements (functions, errors, data structure)
+- Important details
+
+Content:
+${truncatedContent}
+
+Summary (be concise):`;
+    return new Promise(resolve => {
+        const args = ['--print', '--model', model, prompt];
+        const cleanEnv = Object.fromEntries(Object.entries(process.env).filter(([key]) => !key.startsWith('CLAUDE') && key !== 'CLAUDECODE'));
+        const claude = spawn('claude', args, {
+            stdio: ['ignore', 'pipe', 'pipe'],
+            env: cleanEnv,
+        });
+        let stdout = '';
+        const timeout = setTimeout(() => {
+            claude.kill();
+            // Fall back to heuristic summary on timeout
+            resolve(generateHeuristicSummary(content, contentType, maxLength));
+        }, 30000);
+        claude.stdout.on('data', (data) => {
+            stdout += data.toString();
+        });
+        claude.on('close', code => {
+            clearTimeout(timeout);
+            if (code === 0 && stdout.trim()) {
+                resolve(stdout.trim().slice(0, maxLength));
+            }
+            else {
+                // Fall back to heuristic summary
+                resolve(generateHeuristicSummary(content, contentType, maxLength));
+            }
+        });
+        claude.on('error', () => {
+            clearTimeout(timeout);
+            resolve(generateHeuristicSummary(content, contentType, maxLength));
+        });
+    });
+}
+/**
+ * Generate summary for content, optionally using LLM.
+ */
+export async function generateSummary(content, contentType, options = {}) {
+    if (options.useLLM) {
+        return generateLLMSummary(content, contentType, options);
+    }
+    return generateHeuristicSummary(content, contentType, options.maxLength);
+}
+/**
+ * Detect content type from content string.
+ */
+export function detectContentType(content) {
+    return analyzeContent(content).contentType;
+}
+//# sourceMappingURL=content-detector.js.map