specweave 0.32.0 → 0.32.2

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

@@ -0,0 +1,247 @@
+/**
+ * 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();
+}
+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) {
+            adrs.push({
+                id: `DETECTED-${String(adrNum).padStart(4, '0')}`,
+                title: `Use ${pattern}`,
+                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"}

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

@@ -0,0 +1,198 @@
+/**
+ * File Sampler
+ *
+ * Intelligently selects representative files from a repo for LLM analysis.
+ * Prioritizes high-value files while respecting size limits.
+ */
+import * as fs from 'fs';
+import * as path from 'path';
+import { glob } from 'glob';
+const DEFAULT_CONFIG = {
+    maxFiles: 20,
+    maxLinesPerFile: 500,
+    maxTotalChars: 100000, // ~100KB total
+};
+/**
+ * Priority file patterns - checked in order
+ */
+const PRIORITY_PATTERNS = [
+    // Tier 1: Always include if exists
+    { pattern: 'README.md', type: 'readme', priority: 1 },
+    { pattern: 'readme.md', type: 'readme', priority: 1 },
+    { pattern: 'package.json', type: 'config', priority: 1 },
+    { pattern: 'tsconfig.json', type: 'config', priority: 1 },
+    { pattern: 'pyproject.toml', type: 'config', priority: 1 },
+    { pattern: 'go.mod', type: 'config', priority: 1 },
+    { pattern: 'Cargo.toml', type: 'config', priority: 1 },
+    { pattern: 'pom.xml', type: 'config', priority: 1 },
+    // Tier 2: Entry points
+    { pattern: 'src/index.ts', type: 'entry', priority: 2 },
+    { pattern: 'src/main.ts', type: 'entry', priority: 2 },
+    { pattern: 'src/app.ts', type: 'entry', priority: 2 },
+    { pattern: 'src/server.ts', type: 'entry', priority: 2 },
+    { pattern: 'index.ts', type: 'entry', priority: 2 },
+    { pattern: 'main.ts', type: 'entry', priority: 2 },
+    { pattern: 'app.ts', type: 'entry', priority: 2 },
+    { pattern: 'main.py', type: 'entry', priority: 2 },
+    { pattern: 'app.py', type: 'entry', priority: 2 },
+    { pattern: 'main.go', type: 'entry', priority: 2 },
+    { pattern: 'cmd/main.go', type: 'entry', priority: 2 },
+    // Tier 3: API surfaces (glob patterns)
+    { pattern: 'src/routes/**/*.ts', type: 'api', priority: 3 },
+    { pattern: 'src/api/**/*.ts', type: 'api', priority: 3 },
+    { pattern: 'src/controllers/**/*.ts', type: 'api', priority: 3 },
+    { pattern: 'src/handlers/**/*.ts', type: 'api', priority: 3 },
+    { pattern: 'routes/**/*.ts', type: 'api', priority: 3 },
+    { pattern: 'api/**/*.ts', type: 'api', priority: 3 },
+    // Tier 4: Domain models
+    { pattern: 'src/models/**/*.ts', type: 'model', priority: 4 },
+    { pattern: 'src/types/**/*.ts', type: 'model', priority: 4 },
+    { pattern: 'src/entities/**/*.ts', type: 'model', priority: 4 },
+    { pattern: 'src/schemas/**/*.ts', type: 'model', priority: 4 },
+    { pattern: 'src/domain/**/*.ts', type: 'model', priority: 4 },
+    { pattern: 'models/**/*.ts', type: 'model', priority: 4 },
+    { pattern: 'types/**/*.ts', type: 'model', priority: 4 },
+];
+/**
+ * Sample files from a repo for LLM analysis
+ */
+export async function sampleRepoFiles(repoPath, config = DEFAULT_CONFIG) {
+    const samples = [];
+    const includedPaths = new Set();
+    let totalChars = 0;
+    // Phase 1: Include priority files
+    for (const { pattern, type, priority } of PRIORITY_PATTERNS) {
+        if (samples.length >= config.maxFiles)
+            break;
+        if (totalChars >= config.maxTotalChars)
+            break;
+        try {
+            const matches = await glob(pattern, {
+                cwd: repoPath,
+                nodir: true,
+                ignore: ['**/node_modules/**', '**/dist/**', '**/build/**', '**/.git/**'],
+            });
+            for (const match of matches.slice(0, priority === 1 ? 5 : 2)) {
+                if (includedPaths.has(match))
+                    continue;
+                if (samples.length >= config.maxFiles)
+                    break;
+                const sample = await readFileSample(repoPath, match, type, config.maxLinesPerFile);
+                if (sample && totalChars + sample.content.length <= config.maxTotalChars) {
+                    samples.push(sample);
+                    includedPaths.add(match);
+                    totalChars += sample.content.length;
+                }
+            }
+        }
+        catch {
+            // Pattern didn't match, continue
+        }
+    }
+    // Phase 2: Fill remaining slots with other interesting files
+    if (samples.length < config.maxFiles && totalChars < config.maxTotalChars) {
+        try {
+            const allFiles = await glob('**/*.{ts,js,tsx,jsx,py,go,java,rs}', {
+                cwd: repoPath,
+                nodir: true,
+                ignore: [
+                    '**/node_modules/**',
+                    '**/dist/**',
+                    '**/build/**',
+                    '**/.git/**',
+                    '**/*.test.*',
+                    '**/*.spec.*',
+                    '**/__tests__/**',
+                ],
+            });
+            // Sort by likely importance (shorter paths, src/ prefix)
+            const sortedFiles = allFiles
+                .filter(f => !includedPaths.has(f))
+                .sort((a, b) => {
+                const aScore = getFileImportanceScore(a);
+                const bScore = getFileImportanceScore(b);
+                return bScore - aScore;
+            });
+            for (const file of sortedFiles) {
+                if (samples.length >= config.maxFiles)
+                    break;
+                if (totalChars >= config.maxTotalChars)
+                    break;
+                const sample = await readFileSample(repoPath, file, 'other', config.maxLinesPerFile);
+                if (sample && totalChars + sample.content.length <= config.maxTotalChars) {
+                    samples.push(sample);
+                    includedPaths.add(file);
+                    totalChars += sample.content.length;
+                }
+            }
+        }
+        catch {
+            // Glob failed, continue with what we have
+        }
+    }
+    return samples;
+}
+/**
+ * Read a file and create a sample
+ */
+async function readFileSample(repoPath, relativePath, type, maxLines) {
+    const fullPath = path.join(repoPath, relativePath);
+    try {
+        const stats = fs.statSync(fullPath);
+        if (stats.size > 500000)
+            return null; // Skip files > 500KB
+        let content = fs.readFileSync(fullPath, 'utf-8');
+        let truncated = false;
+        const lines = content.split('\n');
+        if (lines.length > maxLines) {
+            content = lines.slice(0, maxLines).join('\n');
+            content += `\n\n// ... truncated (${lines.length - maxLines} more lines)`;
+            truncated = true;
+        }
+        return {
+            path: relativePath,
+            content,
+            type,
+            truncated,
+        };
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Score file importance for sorting
+ */
+function getFileImportanceScore(filePath) {
+    let score = 0;
+    // Prefer shorter paths (closer to root)
+    score += Math.max(0, 10 - filePath.split('/').length);
+    // Prefer src/ files
+    if (filePath.startsWith('src/'))
+        score += 5;
+    // Prefer index files
+    if (filePath.includes('index.'))
+        score += 3;
+    // Prefer files with meaningful names
+    const name = path.basename(filePath, path.extname(filePath));
+    if (['app', 'main', 'server', 'client', 'api', 'service', 'controller'].includes(name)) {
+        score += 4;
+    }
+    // Deprioritize utility files
+    if (['utils', 'helpers', 'constants', 'config'].includes(name)) {
+        score -= 2;
+    }
+    return score;
+}
+/**
+ * Format samples for LLM prompt
+ */
+export function formatSamplesForPrompt(samples) {
+    const sections = [];
+    for (const sample of samples) {
+        const header = `=== ${sample.path} (${sample.type}) ===`;
+        sections.push(`${header}\n${sample.content}`);
+    }
+    return sections.join('\n\n');
+}
+//# sourceMappingURL=file-sampler.js.map