specweave 0.32.0 → 0.32.3

package/dist/src/core/living-docs/intelligent-analyzer/architecture-generator.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Architecture Generator
+ *
+ * Generates C4 diagrams and detects architectural decisions
+ * from the organization structure and repo analyses.
+ */
+import type { RepoAnalysis, DetectedADR, LLMProvider, ProgressCallback } from './types.js';
+import type { OrganizationSynthesisResult } from './organization-synthesizer.js';
+export interface ArchitectureResult {
+    c4Context: string;
+    c4Container: string;
+    dataFlow: string;
+    detectedAdrs: DetectedADR[];
+    confidence: 'high' | 'medium' | 'low';
+}
+export declare function generateArchitecture(repoAnalyses: Map<string, RepoAnalysis>, orgResult: OrganizationSynthesisResult, projectPath: string, llmProvider: LLMProvider | null, onProgress: ProgressCallback, log: (msg: string) => void): Promise<ArchitectureResult>;
+export declare function saveArchitecture(projectPath: string, result: ArchitectureResult): Promise<string[]>;
+//# sourceMappingURL=architecture-generator.d.ts.map

package/dist/src/core/living-docs/intelligent-analyzer/architecture-generator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"architecture-generator.d.ts","sourceRoot":"","sources":["../../../../../src/core/living-docs/intelligent-analyzer/architecture-generator.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH,OAAO,KAAK,EACV,YAAY,EAEZ,WAAW,EAEX,WAAW,EACX,gBAAgB,EACjB,MAAM,YAAY,CAAC;AACpB,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,+BAA+B,CAAC;AAEjF,MAAM,WAAW,kBAAkB;IACjC,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,WAAW,EAAE,CAAC;IAC5B,UAAU,EAAE,MAAM,GAAG,QAAQ,GAAG,KAAK,CAAC;CACvC;AAED,wBAAsB,oBAAoB,CACxC,YAAY,EAAE,GAAG,CAAC,MAAM,EAAE,YAAY,CAAC,EACvC,SAAS,EAAE,2BAA2B,EACtC,WAAW,EAAE,MAAM,EACnB,WAAW,EAAE,WAAW,GAAG,IAAI,EAC/B,UAAU,EAAE,gBAAgB,EAC5B,GAAG,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,GACzB,OAAO,CAAC,kBAAkB,CAAC,CA+B7B;AAuPD,wBAAsB,gBAAgB,CACpC,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,kBAAkB,GACzB,OAAO,CAAC,MAAM,EAAE,CAAC,CA0EnB"}

package/dist/src/core/living-docs/intelligent-analyzer/architecture-generator.js

@@ -0,0 +1,299 @@
+/**
+ * Architecture Generator
+ *
+ * Generates C4 diagrams and detects architectural decisions
+ * from the organization structure and repo analyses.
+ */
+import * as fs from 'fs';
+import * as path from 'path';
+import { extractJson, buildJsonPrompt } from '../../../utils/llm-json-extractor.js';
+export async function generateArchitecture(repoAnalyses, orgResult, projectPath, llmProvider, onProgress, log) {
+    log('PHASE D: Architecture Generation');
+    onProgress('architecture', 0, 100, 'Generating C4 diagrams');
+    const context = buildArchitectureContext(repoAnalyses, orgResult);
+    if (!llmProvider) {
+        log('  No LLM provider, using basic diagram generation');
+        return createBasicArchitecture(repoAnalyses, orgResult);
+    }
+    onProgress('architecture', 20, 100, 'LLM C4 diagram generation');
+    try {
+        const c4Result = await generateC4Diagrams(context, llmProvider, log);
+        onProgress('architecture', 50, 100, 'Detecting architectural patterns');
+        const adrs = await detectArchitecturalDecisions(repoAnalyses, llmProvider, log);
+        onProgress('architecture', 80, 100, 'Finalizing architecture docs');
+        return {
+            c4Context: c4Result.context,
+            c4Container: c4Result.container,
+            dataFlow: c4Result.dataFlow,
+            detectedAdrs: adrs,
+            confidence: 'medium',
+        };
+    }
+    catch (err) {
+        log(`  Architecture generation error: ${err.message}`);
+        return createBasicArchitecture(repoAnalyses, orgResult);
+    }
+}
+function buildArchitectureContext(analyses, org) {
+    const lines = ['# System Overview', ''];
+    if (org.teams.length > 0) {
+        lines.push('## Teams');
+        for (const team of org.teams) {
+            lines.push(`- **${team.name}**: ${team.repos.join(', ')}`);
+        }
+        lines.push('');
+    }
+    if (org.microservices.length > 0) {
+        lines.push('## Microservices');
+        for (const svc of org.microservices) {
+            lines.push(`- **${svc.name}**: ${svc.description}`);
+        }
+        lines.push('');
+    }
+    lines.push('## Key APIs');
+    for (const [name, analysis] of analyses) {
+        if (analysis.mainApis.length > 0) {
+            const apis = analysis.mainApis.slice(0, 3).map(a => a.name).join(', ');
+            lines.push(`- **${name}**: ${apis}`);
+        }
+    }
+    lines.push('');
+    lines.push('## Detected Patterns');
+    const allPatterns = new Map();
+    for (const [name, analysis] of analyses) {
+        for (const p of analysis.patternsUsed) {
+            if (!allPatterns.has(p.pattern))
+                allPatterns.set(p.pattern, []);
+            allPatterns.get(p.pattern).push(name);
+        }
+    }
+    for (const [pattern, repos] of allPatterns) {
+        lines.push(`- **${pattern}**: ${repos.join(', ')}`);
+    }
+    return lines.join('\n');
+}
+async function generateC4Diagrams(context, llmProvider, log) {
+    const schema = {
+        contextDiagram: 'Mermaid C4Context diagram code',
+        containerDiagram: 'Mermaid C4Container diagram code',
+        dataFlowDiagram: 'Mermaid flowchart for data flow',
+    };
+    const prompt = buildJsonPrompt(`${context}\n\nGenerate Mermaid diagrams. Use C4Context for high-level, C4Container for services, flowchart TD for data flow.`, schema, 'Generate architecture diagrams in Mermaid format.');
+    try {
+        const result = await llmProvider.analyze(prompt);
+        if (!result?.content) {
+            return createBasicDiagrams();
+        }
+        const extraction = extractJson(result.content, { requiredFields: [] });
+        if (extraction.success && extraction.data) {
+            log('  C4 diagrams generated successfully');
+            return {
+                context: extraction.data.contextDiagram || createBasicContextDiagram(),
+                container: extraction.data.containerDiagram || createBasicContainerDiagram(),
+                dataFlow: extraction.data.dataFlowDiagram || createBasicDataFlow(),
+            };
+        }
+    }
+    catch {
+        log('  C4 diagram generation failed, using basic');
+    }
+    return createBasicDiagrams();
+}
+/**
+ * Derives a human-readable ADR title from pattern and evidence using LLM
+ * Returns a concise 5-8 word title explaining WHAT was decided
+ */
+async function deriveADRTitle(pattern, evidence, llmProvider) {
+    const prompt = `Given this architectural pattern and evidence, generate a concise decision title (5-8 words).
+
+Pattern: ${pattern}
+Evidence: ${evidence.slice(0, 5).join(', ')}
+
+Good examples:
+- "Adopt Feature-Based Folder Structure"
+- "Use Event-Driven Architecture for Async Processing"
+- "Implement CQRS for Write Operations"
+- "Standardize REST API Design Patterns"
+- "Apply Domain-Driven Design Principles"
+
+Return ONLY the title (5-8 words), no explanation or quotes.`;
+    try {
+        const result = await llmProvider.analyze(prompt);
+        if (result?.content) {
+            // Clean up the response: remove quotes, special chars, limit length
+            const cleaned = result.content
+                .trim()
+                .replace(/^["']|["']$/g, '') // Remove surrounding quotes
+                .replace(/[^\w\s-]/g, '') // Remove special chars except hyphen
+                .substring(0, 60); // Max 60 chars
+            if (cleaned.length >= 10) {
+                return cleaned;
+            }
+        }
+    }
+    catch {
+        // Fallback silently
+    }
+    // Fallback: Use pattern name with "Adopt" prefix
+    return `Adopt ${pattern}`;
+}
+/**
+ * Converts a title to kebab-case for use in ADR filenames
+ */
+function toKebabCase(title) {
+    return title
+        .toLowerCase()
+        .replace(/[^\w\s-]/g, '')
+        .replace(/\s+/g, '-')
+        .replace(/-+/g, '-')
+        .substring(0, 50);
+}
+async function detectArchitecturalDecisions(analyses, llmProvider, log) {
+    const patternMap = new Map();
+    for (const [name, analysis] of analyses) {
+        for (const p of analysis.patternsUsed) {
+            if (!patternMap.has(p.pattern)) {
+                patternMap.set(p.pattern, { repos: [], evidence: [] });
+            }
+            const entry = patternMap.get(p.pattern);
+            entry.repos.push(name);
+            entry.evidence.push(...p.evidence);
+        }
+    }
+    const adrs = [];
+    let adrNum = 1;
+    for (const [pattern, data] of patternMap) {
+        if (data.repos.length >= 2) {
+            // Derive semantic title using LLM
+            const semanticTitle = await deriveADRTitle(pattern, data.evidence, llmProvider);
+            const kebabTitle = toKebabCase(semanticTitle);
+            adrs.push({
+                id: `${String(adrNum).padStart(4, '0')}-${kebabTitle}`,
+                title: semanticTitle,
+                pattern,
+                status: 'Detected',
+                context: `Found ${pattern} pattern in ${data.repos.length} repositories.`,
+                decision: `The team has adopted ${pattern} as a standard approach.`,
+                consequences: [
+                    `Consistent ${pattern} implementation across services`,
+                    'Team familiarity with the pattern',
+                ],
+                evidence: [{
+                        repo: data.repos.join(', '),
+                        files: [],
+                        description: data.evidence.slice(0, 3).join('; '),
+                    }],
+                confidence: data.repos.length >= 3 ? 'high' : 'medium',
+            });
+            adrNum++;
+        }
+    }
+    log(`  Detected ${adrs.length} architectural decisions`);
+    return adrs;
+}
+function createBasicArchitecture(analyses, org) {
+    return {
+        c4Context: createBasicContextDiagram(),
+        c4Container: createBasicContainerDiagram(),
+        dataFlow: createBasicDataFlow(),
+        detectedAdrs: [],
+        confidence: 'low',
+    };
+}
+function createBasicDiagrams() {
+    return {
+        context: createBasicContextDiagram(),
+        container: createBasicContainerDiagram(),
+        dataFlow: createBasicDataFlow(),
+    };
+}
+function createBasicContextDiagram() {
+    return `C4Context
+  title System Context Diagram
+  Person(user, "User", "System user")
+  System(system, "System", "The system under analysis")
+  Rel(user, system, "Uses")`;
+}
+function createBasicContainerDiagram() {
+    return `C4Container
+  title Container Diagram
+  Container(api, "API", "REST/GraphQL", "Main API surface")
+  Container(db, "Database", "Storage", "Data persistence")
+  Rel(api, db, "Reads/Writes")`;
+}
+function createBasicDataFlow() {
+    return `flowchart TD
+  A[Client] --> B[API Gateway]
+  B --> C[Services]
+  C --> D[Database]`;
+}
+export async function saveArchitecture(projectPath, result) {
+    const savedFiles = [];
+    const archPath = path.join(projectPath, '.specweave/docs/internal/architecture');
+    const diagramsPath = path.join(archPath, 'diagrams');
+    const adrPath = path.join(archPath, 'adr');
+    fs.mkdirSync(diagramsPath, { recursive: true });
+    fs.mkdirSync(adrPath, { recursive: true });
+    const contextFile = path.join(diagramsPath, 'c4-context.md');
+    fs.writeFileSync(contextFile, [
+        '# C4 Context Diagram',
+        '',
+        '*Auto-generated by Intelligent Analyzer*',
+        '',
+        '```mermaid',
+        result.c4Context,
+        '```',
+    ].join('\n'));
+    savedFiles.push(contextFile);
+    const containerFile = path.join(diagramsPath, 'c4-container.md');
+    fs.writeFileSync(containerFile, [
+        '# C4 Container Diagram',
+        '',
+        '*Auto-generated by Intelligent Analyzer*',
+        '',
+        '```mermaid',
+        result.c4Container,
+        '```',
+    ].join('\n'));
+    savedFiles.push(containerFile);
+    const dataFlowFile = path.join(diagramsPath, 'data-flow.md');
+    fs.writeFileSync(dataFlowFile, [
+        '# Data Flow Diagram',
+        '',
+        '*Auto-generated by Intelligent Analyzer*',
+        '',
+        '```mermaid',
+        result.dataFlow,
+        '```',
+    ].join('\n'));
+    savedFiles.push(dataFlowFile);
+    for (const adr of result.detectedAdrs) {
+        const adrFile = path.join(adrPath, `${adr.id}.md`);
+        const content = [
+            `# ${adr.id}: ${adr.title}`,
+            '',
+            `**Status**: ${adr.status}`,
+            `**Confidence**: ${adr.confidence}`,
+            '',
+            '## Context',
+            '',
+            adr.context,
+            '',
+            '## Decision',
+            '',
+            adr.decision,
+            '',
+            '## Consequences',
+            '',
+            ...adr.consequences.map(c => `- ${c}`),
+            '',
+            '## Evidence',
+            '',
+            ...adr.evidence.map(e => `- **${e.repo}**: ${e.description}`),
+        ].join('\n');
+        fs.writeFileSync(adrFile, content);
+        savedFiles.push(adrFile);
+    }
+    return savedFiles;
+}
+//# sourceMappingURL=architecture-generator.js.map

package/dist/src/core/living-docs/intelligent-analyzer/architecture-generator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"architecture-generator.js","sourceRoot":"","sources":["../../../../../src/core/living-docs/intelligent-analyzer/architecture-generator.ts"],"names":[],"mappings":"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"}

package/dist/src/core/living-docs/intelligent-analyzer/deep-repo-analyzer.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Deep Repo Analyzer
+ *
+ * Uses LLM to deeply understand each repository's purpose,
+ * key concepts, APIs, and patterns.
+ */
+import type { RepoAnalysis, LLMProvider, ProgressCallback } from './types.js';
+export declare function analyzeRepo(repoPath: string, repoName: string, llmProvider: LLMProvider | null, log: (msg: string) => void): Promise<RepoAnalysis>;
+export declare function analyzeAllRepos(repos: Array<{
+    name: string;
+    path: string;
+}>, llmProvider: LLMProvider | null, onProgress: ProgressCallback, log: (msg: string) => void, checkpoint?: {
+    reposCompleted: string[];
+}): Promise<Map<string, RepoAnalysis>>;
+//# sourceMappingURL=deep-repo-analyzer.d.ts.map

package/dist/src/core/living-docs/intelligent-analyzer/deep-repo-analyzer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"deep-repo-analyzer.d.ts","sourceRoot":"","sources":["../../../../../src/core/living-docs/intelligent-analyzer/deep-repo-analyzer.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,KAAK,EACV,YAAY,EAGZ,WAAW,EACX,gBAAgB,EAEjB,MAAM,YAAY,CAAC;AAEpB,wBAAsB,WAAW,CAC/B,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,EAChB,WAAW,EAAE,WAAW,GAAG,IAAI,EAC/B,GAAG,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,GACzB,OAAO,CAAC,YAAY,CAAC,CA2BvB;AAmFD,wBAAsB,eAAe,CAAC,KAAK,EAAE,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC,EAAE,WAAW,EAAE,WAAW,GAAG,IAAI,EAAE,UAAU,EAAE,gBAAgB,EAAE,GAAG,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,EAAE,UAAU,CAAC,EAAE;IAAE,cAAc,EAAE,MAAM,EAAE,CAAA;CAAE,GAAG,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC,CAY5P"}

package/dist/src/core/living-docs/intelligent-analyzer/deep-repo-analyzer.js

@@ -0,0 +1,138 @@
+/**
+ * Deep Repo Analyzer
+ *
+ * Uses LLM to deeply understand each repository's purpose,
+ * key concepts, APIs, and patterns.
+ */
+import { sampleRepoFiles, formatSamplesForPrompt } from './file-sampler.js';
+import { extractJson, buildJsonPrompt } from '../../../utils/llm-json-extractor.js';
+export async function analyzeRepo(repoPath, repoName, llmProvider, log) {
+    log(`  Sampling files from ${repoName}...`);
+    const samples = await sampleRepoFiles(repoPath);
+    log(`  Sampled ${samples.length} files`);
+    if (!llmProvider) {
+        return createBasicAnalysis(repoPath, repoName, samples);
+    }
+    const prompt = buildRepoAnalysisPrompt(repoName, samples);
+    log(`  Sending to LLM for deep analysis...`);
+    try {
+        const result = await llmProvider.analyze(prompt);
+        if (!result || !result.content) {
+            return createBasicAnalysis(repoPath, repoName, samples);
+        }
+        const extraction = extractJson(result.content, { requiredFields: ['purpose'] });
+        if (extraction.success && extraction.data) {
+            log(`  LLM analysis successful`);
+            return convertLLMResponse(repoPath, repoName, extraction.data, samples.length);
+        }
+        return createBasicAnalysis(repoPath, repoName, samples);
+    }
+    catch (err) {
+        log(`  LLM error: ${err.message}`);
+        return createBasicAnalysis(repoPath, repoName, samples);
+    }
+}
+function buildRepoAnalysisPrompt(repoName, samples) {
+    const filesContent = formatSamplesForPrompt(samples);
+    const schema = {
+        purpose: 'string (2-3 sentences)',
+        keyConcepts: '["concept1", ...]',
+        mainApis: '[{name, type, description, location}, ...]',
+        patternsUsed: '[{pattern, category, evidence}, ...]',
+        internalDependencies: '["repo1", ...]',
+        externalDependencies: '["service1", ...]',
+        observations: '["observation1", ...]',
+    };
+    const context = `Repository: ${repoName}\n\nKey files:\n${filesContent}\n\nBe SPECIFIC. Don't say "handles data" - say "processes DICOM medical images".`;
+    return buildJsonPrompt(context, schema, 'Analyze this repository.');
+}
+function convertLLMResponse(repoPath, repoName, response, filesAnalyzed) {
+    return {
+        name: repoName, path: repoPath, purpose: response.purpose || 'Purpose not determined',
+        keyConcepts: response.keyConcepts || [],
+        mainApis: (response.mainApis || []).map(api => ({ name: api.name, type: api.type || 'function', description: api.description, location: api.location || '' })),
+        patternsUsed: (response.patternsUsed || []).map(p => ({ pattern: p.pattern, category: p.category || 'other', evidence: p.evidence || [], confidence: 'medium' })),
+        internalDependencies: response.internalDependencies || [], externalDependencies: response.externalDependencies || [],
+        filesAnalyzed, confidence: filesAnalyzed > 10 ? 'high' : filesAnalyzed > 5 ? 'medium' : 'low',
+        analyzedAt: new Date().toISOString(), observations: response.observations || [],
+    };
+}
+function createBasicAnalysis(repoPath, repoName, samples) {
+    const purpose = extractPurposeFromReadme(samples) || `Repository with ${samples.length} files`;
+    return { name: repoName, path: repoPath, purpose, keyConcepts: [], mainApis: extractBasicApis(samples),
+        patternsUsed: detectBasicPatterns(samples), internalDependencies: [], externalDependencies: extractDependencies(samples),
+        filesAnalyzed: samples.length, confidence: 'low', analyzedAt: new Date().toISOString(), observations: [] };
+}
+function extractPurposeFromReadme(samples) {
+    const readme = samples.find(s => s.type === 'readme');
+    if (!readme)
+        return null;
+    const lines = readme.content.split('\n');
+    let foundTitle = false, purposeLines = [];
+    for (const line of lines) {
+        if (line.startsWith('#') && !foundTitle) {
+            foundTitle = true;
+            continue;
+        }
+        if (foundTitle && line.trim()) {
+            if (line.startsWith('#'))
+                break;
+            purposeLines.push(line.trim());
+            if (purposeLines.length >= 3)
+                break;
+        }
+    }
+    return purposeLines.length > 0 ? purposeLines.join(' ') : null;
+}
+function detectBasicPatterns(samples) {
+    const patterns = [];
+    const content = samples.map(s => s.content).join('\n');
+    if (content.includes('express') || content.includes('fastify'))
+        patterns.push({ pattern: 'REST API', category: 'api', evidence: ['Framework detected'], confidence: 'high' });
+    if (content.includes('graphql'))
+        patterns.push({ pattern: 'GraphQL', category: 'api', evidence: ['GraphQL imports'], confidence: 'high' });
+    if (content.includes('prisma') || content.includes('typeorm'))
+        patterns.push({ pattern: 'ORM', category: 'data', evidence: ['ORM detected'], confidence: 'high' });
+    if (content.includes('jwt'))
+        patterns.push({ pattern: 'JWT Auth', category: 'auth', evidence: ['JWT library'], confidence: 'high' });
+    return patterns;
+}
+function extractBasicApis(samples) {
+    const apis = [];
+    for (const s of samples.filter(s => s.type === 'api' || s.type === 'entry')) {
+        const matches = s.content.matchAll(/export\s+(async\s+)?(?:function|const|class)\s+(\w+)/g);
+        for (const m of matches)
+            apis.push({ name: m[2], type: m[0].includes('class') ? 'class' : 'function', description: 'From ' + s.path, location: s.path });
+    }
+    return apis.slice(0, 10);
+}
+function extractDependencies(samples) {
+    const pkg = samples.find(s => s.path === 'package.json');
+    if (!pkg)
+        return [];
+    try {
+        const p = JSON.parse(pkg.content);
+        return Object.keys(p.dependencies || {}).filter(d => /aws|azure|redis|mongo|postgres|kafka/.test(d)).slice(0, 5);
+    }
+    catch {
+        return [];
+    }
+}
+export async function analyzeAllRepos(repos, llmProvider, onProgress, log, checkpoint) {
+    const results = new Map();
+    const completed = new Set(checkpoint?.reposCompleted || []);
+    for (let i = 0; i < repos.length; i++) {
+        const repo = repos[i];
+        if (completed.has(repo.name)) {
+            log(`  Skipping ${repo.name} (done)`);
+            continue;
+        }
+        onProgress('deep-analysis', i + 1, repos.length, `Analyzing ${repo.name}`);
+        log(`Analyzing ${i + 1}/${repos.length}: ${repo.name}`);
+        results.set(repo.name, await analyzeRepo(repo.path, repo.name, llmProvider, log));
+        if (llmProvider && i < repos.length - 1)
+            await new Promise(r => setTimeout(r, 1000));
+    }
+    return results;
+}
+//# sourceMappingURL=deep-repo-analyzer.js.map

package/dist/src/core/living-docs/intelligent-analyzer/deep-repo-analyzer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"deep-repo-analyzer.js","sourceRoot":"","sources":["../../../../../src/core/living-docs/intelligent-analyzer/deep-repo-analyzer.ts"],"names":[],"mappings":"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"}

package/dist/src/core/living-docs/intelligent-analyzer/file-sampler.d.ts

@@ -0,0 +1,24 @@
+/**
+ * File Sampler
+ *
+ * Intelligently selects representative files from a repo for LLM analysis.
+ * Prioritizes high-value files while respecting size limits.
+ */
+import type { FileSample } from './types.js';
+/**
+ * Configuration for file sampling
+ */
+export interface SamplingConfig {
+    maxFiles: number;
+    maxLinesPerFile: number;
+    maxTotalChars: number;
+}
+/**
+ * Sample files from a repo for LLM analysis
+ */
+export declare function sampleRepoFiles(repoPath: string, config?: SamplingConfig): Promise<FileSample[]>;
+/**
+ * Format samples for LLM prompt
+ */
+export declare function formatSamplesForPrompt(samples: FileSample[]): string;
+//# sourceMappingURL=file-sampler.d.ts.map

package/dist/src/core/living-docs/intelligent-analyzer/file-sampler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-sampler.d.ts","sourceRoot":"","sources":["../../../../../src/core/living-docs/intelligent-analyzer/file-sampler.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAE7C;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,MAAM,CAAC;IACjB,eAAe,EAAE,MAAM,CAAC;IACxB,aAAa,EAAE,MAAM,CAAC;CACvB;AAqDD;;GAEG;AACH,wBAAsB,eAAe,CACnC,QAAQ,EAAE,MAAM,EAChB,MAAM,GAAE,cAA+B,GACtC,OAAO,CAAC,UAAU,EAAE,CAAC,CA4EvB;AAmED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,UAAU,EAAE,GAAG,MAAM,CASpE"}