agents-reverse-engineer 0.1.1

package/dist/generation/budget/counter.js

@@ -0,0 +1,45 @@
+import { encode, isWithinTokenLimit as checkLimit } from 'gpt-tokenizer';
+/**
+ * Count tokens in content using BPE tokenization.
+ * Uses cl100k_base encoding (compatible with Claude/GPT-4).
+ *
+ * @param content - Text to count tokens in
+ * @returns Token count
+ */
+export function countTokens(content) {
+    return encode(content).length;
+}
+/**
+ * Check if content fits within token limit without fully encoding.
+ * More efficient than counting when you only need a boolean check.
+ *
+ * @param content - Text to check
+ * @param limit - Maximum allowed tokens
+ * @returns true if content is within limit
+ */
+export function isWithinLimit(content, limit) {
+    // checkLimit returns token count if within limit, false if exceeded
+    return checkLimit(content, limit) !== false;
+}
+/**
+ * Estimate prompt overhead for a given file type.
+ * Includes template tokens + system prompt portion.
+ *
+ * @param fileType - Type of file being summarized
+ * @returns Estimated overhead in tokens
+ */
+export function estimatePromptOverhead(fileType) {
+    // Base overhead for all prompts (system instructions, formatting)
+    const BASE_OVERHEAD = 500;
+    // Additional overhead by file type (templates vary in size)
+    const TYPE_OVERHEAD = {
+        component: 200,
+        service: 150,
+        api: 180,
+        model: 120,
+        schema: 100,
+        generic: 100,
+    };
+    return BASE_OVERHEAD + (TYPE_OVERHEAD[fileType] ?? 100);
+}
+//# sourceMappingURL=counter.js.map

package/dist/generation/budget/counter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"counter.js","sourceRoot":"","sources":["../../../src/generation/budget/counter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,kBAAkB,IAAI,UAAU,EAAE,MAAM,eAAe,CAAC;AAEzE;;;;;;GAMG;AACH,MAAM,UAAU,WAAW,CAAC,OAAe;IACzC,OAAO,MAAM,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC;AAChC,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,aAAa,CAAC,OAAe,EAAE,KAAa;IAC1D,oEAAoE;IACpE,OAAO,UAAU,CAAC,OAAO,EAAE,KAAK,CAAC,KAAK,KAAK,CAAC;AAC9C,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,sBAAsB,CAAC,QAAgB;IACrD,kEAAkE;IAClE,MAAM,aAAa,GAAG,GAAG,CAAC;IAE1B,4DAA4D;IAC5D,MAAM,aAAa,GAA2B;QAC5C,SAAS,EAAE,GAAG;QACd,OAAO,EAAE,GAAG;QACZ,GAAG,EAAE,GAAG;QACR,KAAK,EAAE,GAAG;QACV,MAAM,EAAE,GAAG;QACX,OAAO,EAAE,GAAG;KACb,CAAC;IAEF,OAAO,aAAa,GAAG,CAAC,aAAa,CAAC,QAAQ,CAAC,IAAI,GAAG,CAAC,CAAC;AAC1D,CAAC"}

package/dist/generation/budget/index.d.ts

@@ -0,0 +1,4 @@
+export { countTokens, isWithinLimit, estimatePromptOverhead } from './counter.js';
+export { BudgetTracker, type BudgetReport, type FileEstimate } from './tracker.js';
+export { chunkFile, needsChunking, getTotalChunkTokens, type Chunk, type ChunkOptions } from './chunker.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/generation/budget/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/generation/budget/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,sBAAsB,EAAE,MAAM,cAAc,CAAC;AAClF,OAAO,EAAE,aAAa,EAAE,KAAK,YAAY,EAAE,KAAK,YAAY,EAAE,MAAM,cAAc,CAAC;AACnF,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,mBAAmB,EAAE,KAAK,KAAK,EAAE,KAAK,YAAY,EAAE,MAAM,cAAc,CAAC"}

package/dist/generation/budget/index.js

@@ -0,0 +1,4 @@
+export { countTokens, isWithinLimit, estimatePromptOverhead } from './counter.js';
+export { BudgetTracker } from './tracker.js';
+export { chunkFile, needsChunking, getTotalChunkTokens } from './chunker.js';
+//# sourceMappingURL=index.js.map

package/dist/generation/budget/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/generation/budget/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,sBAAsB,EAAE,MAAM,cAAc,CAAC;AAClF,OAAO,EAAE,aAAa,EAAwC,MAAM,cAAc,CAAC;AACnF,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,mBAAmB,EAAiC,MAAM,cAAc,CAAC"}

package/dist/generation/budget/tracker.d.ts

@@ -0,0 +1,63 @@
+export interface BudgetReport {
+    totalBudget: number;
+    used: number;
+    remaining: number;
+    percentUsed: number;
+    filesProcessed: number;
+    filesRemaining: number;
+    averagePerFile: number;
+    exhausted: boolean;
+    completedFiles: string[];
+    skippedFiles: string[];
+}
+export interface FileEstimate {
+    filePath: string;
+    tokens: number;
+    canProcess: boolean;
+}
+/**
+ * Tracks token budget across the entire project.
+ * Enforces budget limits and reports progress.
+ */
+export declare class BudgetTracker {
+    private totalBudget;
+    private used;
+    private filesProcessed;
+    private totalFiles;
+    private completedFiles;
+    private skippedFiles;
+    constructor(totalBudget: number, totalFiles: number);
+    /**
+     * Check if there's enough budget to process a file.
+     */
+    canProcess(estimatedTokens: number): boolean;
+    /**
+     * Get remaining budget.
+     */
+    get remaining(): number;
+    /**
+     * Estimate tokens for a file and check if it can be processed.
+     */
+    estimate(filePath: string, content: string, promptOverhead: number): FileEstimate;
+    /**
+     * Record that a file was processed, consuming budget.
+     */
+    recordProcessed(filePath: string, tokensUsed: number): void;
+    /**
+     * Record that a file was skipped due to budget constraints.
+     */
+    recordSkipped(filePath: string): void;
+    /**
+     * Check if budget is exhausted (should stop processing).
+     */
+    isExhausted(): boolean;
+    /**
+     * Get a report of budget status.
+     */
+    getReport(): BudgetReport;
+    /**
+     * Create a summary message for CLI output.
+     */
+    getSummaryMessage(): string;
+}
+//# sourceMappingURL=tracker.d.ts.map

package/dist/generation/budget/tracker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tracker.d.ts","sourceRoot":"","sources":["../../../src/generation/budget/tracker.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,YAAY;IAC3B,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,EAAE,MAAM,CAAC;IACvB,cAAc,EAAE,MAAM,CAAC;IACvB,cAAc,EAAE,MAAM,CAAC;IACvB,SAAS,EAAE,OAAO,CAAC;IACnB,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,YAAY,EAAE,MAAM,EAAE,CAAC;CACxB;AAED,MAAM,WAAW,YAAY;IAC3B,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,OAAO,CAAC;CACrB;AAED;;;GAGG;AACH,qBAAa,aAAa;IACxB,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,IAAI,CAAa;IACzB,OAAO,CAAC,cAAc,CAAa;IACnC,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,cAAc,CAAgB;IACtC,OAAO,CAAC,YAAY,CAAgB;gBAExB,WAAW,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM;IAKnD;;OAEG;IACH,UAAU,CAAC,eAAe,EAAE,MAAM,GAAG,OAAO;IAI5C;;OAEG;IACH,IAAI,SAAS,IAAI,MAAM,CAEtB;IAED;;OAEG;IACH,QAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,GAAG,YAAY;IAWjF;;OAEG;IACH,eAAe,CAAC,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,IAAI;IAM3D;;OAEG;IACH,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;IAIrC;;OAEG;IACH,WAAW,IAAI,OAAO;IAItB;;OAEG;IACH,SAAS,IAAI,YAAY;IAezB;;OAEG;IACH,iBAAiB,IAAI,MAAM;CAiB5B"}

package/dist/generation/budget/tracker.js

@@ -0,0 +1,96 @@
+import { countTokens } from './counter.js';
+/**
+ * Tracks token budget across the entire project.
+ * Enforces budget limits and reports progress.
+ */
+export class BudgetTracker {
+    totalBudget;
+    used = 0;
+    filesProcessed = 0;
+    totalFiles;
+    completedFiles = [];
+    skippedFiles = [];
+    constructor(totalBudget, totalFiles) {
+        this.totalBudget = totalBudget;
+        this.totalFiles = totalFiles;
+    }
+    /**
+     * Check if there's enough budget to process a file.
+     */
+    canProcess(estimatedTokens) {
+        return this.remaining >= estimatedTokens;
+    }
+    /**
+     * Get remaining budget.
+     */
+    get remaining() {
+        return this.totalBudget - this.used;
+    }
+    /**
+     * Estimate tokens for a file and check if it can be processed.
+     */
+    estimate(filePath, content, promptOverhead) {
+        const contentTokens = countTokens(content);
+        const totalTokens = contentTokens + promptOverhead;
+        return {
+            filePath,
+            tokens: totalTokens,
+            canProcess: this.canProcess(totalTokens),
+        };
+    }
+    /**
+     * Record that a file was processed, consuming budget.
+     */
+    recordProcessed(filePath, tokensUsed) {
+        this.used += tokensUsed;
+        this.filesProcessed++;
+        this.completedFiles.push(filePath);
+    }
+    /**
+     * Record that a file was skipped due to budget constraints.
+     */
+    recordSkipped(filePath) {
+        this.skippedFiles.push(filePath);
+    }
+    /**
+     * Check if budget is exhausted (should stop processing).
+     */
+    isExhausted() {
+        return this.remaining <= 0;
+    }
+    /**
+     * Get a report of budget status.
+     */
+    getReport() {
+        return {
+            totalBudget: this.totalBudget,
+            used: this.used,
+            remaining: this.remaining,
+            percentUsed: this.totalBudget > 0 ? (this.used / this.totalBudget) * 100 : 0,
+            filesProcessed: this.filesProcessed,
+            filesRemaining: this.totalFiles - this.filesProcessed,
+            averagePerFile: this.filesProcessed > 0 ? this.used / this.filesProcessed : 0,
+            exhausted: this.isExhausted(),
+            completedFiles: [...this.completedFiles],
+            skippedFiles: [...this.skippedFiles],
+        };
+    }
+    /**
+     * Create a summary message for CLI output.
+     */
+    getSummaryMessage() {
+        const report = this.getReport();
+        const lines = [
+            `Token budget: ${report.used.toLocaleString()} / ${report.totalBudget.toLocaleString()} (${report.percentUsed.toFixed(1)}%)`,
+            `Files processed: ${report.filesProcessed} / ${this.totalFiles}`,
+        ];
+        if (report.skippedFiles.length > 0) {
+            lines.push(`Files skipped (budget): ${report.skippedFiles.length}`);
+        }
+        if (report.exhausted) {
+            lines.push('Budget exhausted - some files were not processed');
+        }
+        return lines.join('\n');
+    }
+}
+//# sourceMappingURL=tracker.js.map

package/dist/generation/budget/tracker.js.map

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

package/dist/generation/complexity.d.ts

@@ -0,0 +1,43 @@
+/**
+ * Metrics about codebase complexity.
+ */
+export interface ComplexityMetrics {
+    /** Total number of source files */
+    fileCount: number;
+    /** Maximum directory depth */
+    directoryDepth: number;
+    /** Detected architectural patterns */
+    architecturalPatterns: string[];
+    /** List of source file paths */
+    files: string[];
+    /** Unique directory paths */
+    directories: Set<string>;
+}
+/**
+ * Analyze codebase complexity from discovered files.
+ *
+ * @param files - List of source file paths
+ * @param projectRoot - Project root directory
+ * @returns Complexity metrics
+ */
+export declare function analyzeComplexity(files: string[], projectRoot: string): ComplexityMetrics;
+/**
+ * Determine if ARCHITECTURE.md should be generated.
+ *
+ * Triggers (any one fires):
+ * - 20+ source files
+ * - 3+ directory levels
+ * - Multiple architectural patterns detected
+ */
+export declare function shouldGenerateArchitecture(metrics: ComplexityMetrics): boolean;
+/**
+ * Determine if STACK.md should be generated.
+ *
+ * Always generate if package.json exists (has dependencies to document).
+ */
+export declare function shouldGenerateStack(hasPackageJson: boolean): boolean;
+/**
+ * Generate a summary of why supplementary docs should/shouldn't be generated.
+ */
+export declare function getComplexitySummary(metrics: ComplexityMetrics): string;
+//# sourceMappingURL=complexity.d.ts.map

package/dist/generation/complexity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"complexity.d.ts","sourceRoot":"","sources":["../../src/generation/complexity.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,mCAAmC;IACnC,SAAS,EAAE,MAAM,CAAC;IAClB,8BAA8B;IAC9B,cAAc,EAAE,MAAM,CAAC;IACvB,sCAAsC;IACtC,qBAAqB,EAAE,MAAM,EAAE,CAAC;IAChC,gCAAgC;IAChC,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,6BAA6B;IAC7B,WAAW,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;CAC1B;AA+GD;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,MAAM,EAAE,EACf,WAAW,EAAE,MAAM,GAClB,iBAAiB,CAQnB;AAED;;;;;;;GAOG;AACH,wBAAgB,0BAA0B,CAAC,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAW9E;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,cAAc,EAAE,OAAO,GAAG,OAAO,CAEpE;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,iBAAiB,GAAG,MAAM,CAcvE"}

package/dist/generation/complexity.js

@@ -0,0 +1,156 @@
+import * as path from 'node:path';
+/**
+ * Architectural pattern definitions with detection heuristics.
+ */
+const PATTERN_DETECTORS = [
+    {
+        name: 'layered-architecture',
+        indicators: ['controllers/', 'services/', 'repositories/', 'dao/'],
+        minMatches: 2,
+    },
+    {
+        name: 'clean-architecture',
+        indicators: ['domain/', 'application/', 'infrastructure/', 'usecases/'],
+        minMatches: 2,
+    },
+    {
+        name: 'nextjs-convention',
+        indicators: ['/api/', '/pages/', '/app/', 'middleware.'],
+        minMatches: 2,
+    },
+    {
+        name: 'presentational-container',
+        indicators: ['components/', 'containers/', 'views/'],
+        minMatches: 2,
+    },
+    {
+        name: 'redux-pattern',
+        indicators: ['redux/', 'store/', 'slices/', 'reducers/', 'actions/'],
+        minMatches: 2,
+    },
+    {
+        name: 'react-patterns',
+        indicators: ['hooks/', 'context/', 'providers/'],
+        minMatches: 2,
+    },
+    {
+        name: 'microservices',
+        indicators: ['services/', 'gateway/', 'shared/', 'common/', 'packages/'],
+        minMatches: 3,
+    },
+    {
+        name: 'feature-based',
+        indicators: ['features/', 'modules/', 'domains/'],
+        minMatches: 1,
+    },
+    {
+        name: 'mvc-pattern',
+        indicators: ['models/', 'views/', 'controllers/'],
+        minMatches: 3,
+    },
+];
+/**
+ * Detect architectural patterns from file paths.
+ */
+function detectArchitecturalPatterns(files) {
+    const patterns = [];
+    const normalizedFiles = files.map(f => f.toLowerCase().replace(/\\/g, '/'));
+    for (const detector of PATTERN_DETECTORS) {
+        const matches = detector.indicators.filter(indicator => normalizedFiles.some(f => f.includes(indicator)));
+        if (matches.length >= detector.minMatches) {
+            patterns.push(detector.name);
+        }
+    }
+    return patterns;
+}
+/**
+ * Calculate maximum directory depth from file paths.
+ */
+function calculateDirectoryDepth(files, projectRoot) {
+    let maxDepth = 0;
+    for (const file of files) {
+        const relativePath = path.relative(projectRoot, file);
+        const depth = relativePath.split(path.sep).length - 1; // -1 for the file itself
+        maxDepth = Math.max(maxDepth, depth);
+    }
+    return maxDepth;
+}
+/**
+ * Extract unique directories from file paths.
+ */
+function extractDirectories(files) {
+    const directories = new Set();
+    for (const file of files) {
+        let dir = path.dirname(file);
+        while (dir && dir !== '.') {
+            directories.add(dir);
+            const parent = path.dirname(dir);
+            if (parent === dir)
+                break; // Reached root
+            dir = parent;
+        }
+    }
+    return directories;
+}
+/**
+ * Analyze codebase complexity from discovered files.
+ *
+ * @param files - List of source file paths
+ * @param projectRoot - Project root directory
+ * @returns Complexity metrics
+ */
+export function analyzeComplexity(files, projectRoot) {
+    return {
+        fileCount: files.length,
+        directoryDepth: calculateDirectoryDepth(files, projectRoot),
+        architecturalPatterns: detectArchitecturalPatterns(files),
+        files,
+        directories: extractDirectories(files),
+    };
+}
+/**
+ * Determine if ARCHITECTURE.md should be generated.
+ *
+ * Triggers (any one fires):
+ * - 20+ source files
+ * - 3+ directory levels
+ * - Multiple architectural patterns detected
+ */
+export function shouldGenerateArchitecture(metrics) {
+    // Threshold: 20+ source files
+    if (metrics.fileCount >= 20)
+        return true;
+    // Threshold: 3+ directory levels
+    if (metrics.directoryDepth >= 3)
+        return true;
+    // Threshold: 2+ architectural patterns
+    if (metrics.architecturalPatterns.length >= 2)
+        return true;
+    return false;
+}
+/**
+ * Determine if STACK.md should be generated.
+ *
+ * Always generate if package.json exists (has dependencies to document).
+ */
+export function shouldGenerateStack(hasPackageJson) {
+    return hasPackageJson;
+}
+/**
+ * Generate a summary of why supplementary docs should/shouldn't be generated.
+ */
+export function getComplexitySummary(metrics) {
+    const lines = [
+        `Files: ${metrics.fileCount}`,
+        `Directory depth: ${metrics.directoryDepth}`,
+        `Patterns detected: ${metrics.architecturalPatterns.length > 0 ? metrics.architecturalPatterns.join(', ') : 'none'}`,
+    ];
+    if (shouldGenerateArchitecture(metrics)) {
+        lines.push('ARCHITECTURE.md: will be generated');
+    }
+    else {
+        lines.push('ARCHITECTURE.md: not needed (below thresholds)');
+    }
+    return lines.join('\n');
+}
+//# sourceMappingURL=complexity.js.map

package/dist/generation/complexity.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"complexity.js","sourceRoot":"","sources":["../../src/generation/complexity.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAkBlC;;GAEG;AACH,MAAM,iBAAiB,GAIlB;IACH;QACE,IAAI,EAAE,sBAAsB;QAC5B,UAAU,EAAE,CAAC,cAAc,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,CAAC;QAClE,UAAU,EAAE,CAAC;KACd;IACD;QACE,IAAI,EAAE,oBAAoB;QAC1B,UAAU,EAAE,CAAC,SAAS,EAAE,cAAc,EAAE,iBAAiB,EAAE,WAAW,CAAC;QACvE,UAAU,EAAE,CAAC;KACd;IACD;QACE,IAAI,EAAE,mBAAmB;QACzB,UAAU,EAAE,CAAC,OAAO,EAAE,SAAS,EAAE,OAAO,EAAE,aAAa,CAAC;QACxD,UAAU,EAAE,CAAC;KACd;IACD;QACE,IAAI,EAAE,0BAA0B;QAChC,UAAU,EAAE,CAAC,aAAa,EAAE,aAAa,EAAE,QAAQ,CAAC;QACpD,UAAU,EAAE,CAAC;KACd;IACD;QACE,IAAI,EAAE,eAAe;QACrB,UAAU,EAAE,CAAC,QAAQ,EAAE,QAAQ,EAAE,SAAS,EAAE,WAAW,EAAE,UAAU,CAAC;QACpE,UAAU,EAAE,CAAC;KACd;IACD;QACE,IAAI,EAAE,gBAAgB;QACtB,UAAU,EAAE,CAAC,QAAQ,EAAE,UAAU,EAAE,YAAY,CAAC;QAChD,UAAU,EAAE,CAAC;KACd;IACD;QACE,IAAI,EAAE,eAAe;QACrB,UAAU,EAAE,CAAC,WAAW,EAAE,UAAU,EAAE,SAAS,EAAE,SAAS,EAAE,WAAW,CAAC;QACxE,UAAU,EAAE,CAAC;KACd;IACD;QACE,IAAI,EAAE,eAAe;QACrB,UAAU,EAAE,CAAC,WAAW,EAAE,UAAU,EAAE,UAAU,CAAC;QACjD,UAAU,EAAE,CAAC;KACd;IACD;QACE,IAAI,EAAE,aAAa;QACnB,UAAU,EAAE,CAAC,SAAS,EAAE,QAAQ,EAAE,cAAc,CAAC;QACjD,UAAU,EAAE,CAAC;KACd;CACF,CAAC;AAEF;;GAEG;AACH,SAAS,2BAA2B,CAAC,KAAe;IAClD,MAAM,QAAQ,GAAa,EAAE,CAAC;IAC9B,MAAM,eAAe,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC,CAAC;IAE5E,KAAK,MAAM,QAAQ,IAAI,iBAAiB,EAAE,CAAC;QACzC,MAAM,OAAO,GAAG,QAAQ,CAAC,UAAU,CAAC,MAAM,CAAC,SAAS,CAAC,EAAE,CACrD,eAAe,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC,CACjD,CAAC;QAEF,IAAI,OAAO,CAAC,MAAM,IAAI,QAAQ,CAAC,UAAU,EAAE,CAAC;YAC1C,QAAQ,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;QAC/B,CAAC;IACH,CAAC;IAED,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED;;GAEG;AACH,SAAS,uBAAuB,CAAC,KAAe,EAAE,WAAmB;IACnE,IAAI,QAAQ,GAAG,CAAC,CAAC;IAEjB,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,YAAY,GAAG,IAAI,CAAC,QAAQ,CAAC,WAAW,EAAE,IAAI,CAAC,CAAC;QACtD,MAAM,KAAK,GAAG,YAAY,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,yBAAyB;QAChF,QAAQ,GAAG,IAAI,CAAC,GAAG,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;IACvC,CAAC;IAED,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED;;GAEG;AACH,SAAS,kBAAkB,CAAC,KAAe;IACzC,MAAM,WAAW,GAAG,IAAI,GAAG,EAAU,CAAC;IAEtC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,IAAI,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QAC7B,OAAO,GAAG,IAAI,GAAG,KAAK,GAAG,EAAE,CAAC;YAC1B,WAAW,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;YACrB,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;YACjC,IAAI,MAAM,KAAK,GAAG;gBAAE,MAAM,CAAC,eAAe;YAC1C,GAAG,GAAG,MAAM,CAAC;QACf,CAAC;IACH,CAAC;IAED,OAAO,WAAW,CAAC;AACrB,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,iBAAiB,CAC/B,KAAe,EACf,WAAmB;IAEnB,OAAO;QACL,SAAS,EAAE,KAAK,CAAC,MAAM;QACvB,cAAc,EAAE,uBAAuB,CAAC,KAAK,EAAE,WAAW,CAAC;QAC3D,qBAAqB,EAAE,2BAA2B,CAAC,KAAK,CAAC;QACzD,KAAK;QACL,WAAW,EAAE,kBAAkB,CAAC,KAAK,CAAC;KACvC,CAAC;AACJ,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,0BAA0B,CAAC,OAA0B;IACnE,8BAA8B;IAC9B,IAAI,OAAO,CAAC,SAAS,IAAI,EAAE;QAAE,OAAO,IAAI,CAAC;IAEzC,iCAAiC;IACjC,IAAI,OAAO,CAAC,cAAc,IAAI,CAAC;QAAE,OAAO,IAAI,CAAC;IAE7C,uCAAuC;IACvC,IAAI,OAAO,CAAC,qBAAqB,CAAC,MAAM,IAAI,CAAC;QAAE,OAAO,IAAI,CAAC;IAE3D,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,mBAAmB,CAAC,cAAuB;IACzD,OAAO,cAAc,CAAC;AACxB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,oBAAoB,CAAC,OAA0B;IAC7D,MAAM,KAAK,GAAG;QACZ,UAAU,OAAO,CAAC,SAAS,EAAE;QAC7B,oBAAoB,OAAO,CAAC,cAAc,EAAE;QAC5C,sBAAsB,OAAO,CAAC,qBAAqB,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,qBAAqB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,MAAM,EAAE;KACrH,CAAC;IAEF,IAAI,0BAA0B,CAAC,OAAO,CAAC,EAAE,CAAC;QACxC,KAAK,CAAC,IAAI,CAAC,oCAAoC,CAAC,CAAC;IACnD,CAAC;SAAM,CAAC;QACN,KAAK,CAAC,IAAI,CAAC,gDAAgD,CAAC,CAAC;IAC/D,CAAC;IAED,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC"}

package/dist/generation/detection/detector.d.ts

@@ -0,0 +1,23 @@
+/**
+ * File type detector
+ *
+ * Detects file type using a three-tier strategy:
+ * 1. File name patterns (tests, configs) - most specific
+ * 2. Parent directory name - fast path for standard structures
+ * 3. Content analysis - fallback for edge cases
+ */
+import type { FileType } from '../types.js';
+/**
+ * Detect file type using directory-first strategy with content fallback.
+ *
+ * Detection order:
+ * 1. File name patterns (tests, configs) - most specific
+ * 2. Parent directory name - fast path for standard structures
+ * 3. Content analysis - fallback for edge cases
+ *
+ * @param filePath - Path to the file (relative or absolute)
+ * @param content - File content for fallback detection
+ * @returns Detected FileType
+ */
+export declare function detectFileType(filePath: string, content: string): FileType;
+//# sourceMappingURL=detector.d.ts.map

package/dist/generation/detection/detector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"detector.d.ts","sourceRoot":"","sources":["../../../src/generation/detection/detector.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAsB5C;;;;;;;;;;;GAWG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,QAAQ,CA0B1E"}

package/dist/generation/detection/detector.js

@@ -0,0 +1,62 @@
+/**
+ * File type detector
+ *
+ * Detects file type using a three-tier strategy:
+ * 1. File name patterns (tests, configs) - most specific
+ * 2. Parent directory name - fast path for standard structures
+ * 3. Content analysis - fallback for edge cases
+ */
+import path from 'node:path';
+import { DIRECTORY_PATTERNS, detectFromContent } from './patterns.js';
+/**
+ * File name patterns that override directory detection
+ * These are checked first because they're the most specific indicators
+ */
+const TEST_FILE_PATTERNS = [
+    /\.test\.[jt]sx?$/,
+    /\.spec\.[jt]sx?$/,
+    /_test\.[jt]sx?$/,
+];
+const CONFIG_FILE_PATTERNS = [
+    /\.config\.[jt]s$/,
+    /\.config\.m?[jt]s$/,
+    /rc\.[jt]s$/,
+    /rc\.m?[jt]s$/,
+    /\.json$/,
+    /\.ya?ml$/,
+];
+/**
+ * Detect file type using directory-first strategy with content fallback.
+ *
+ * Detection order:
+ * 1. File name patterns (tests, configs) - most specific
+ * 2. Parent directory name - fast path for standard structures
+ * 3. Content analysis - fallback for edge cases
+ *
+ * @param filePath - Path to the file (relative or absolute)
+ * @param content - File content for fallback detection
+ * @returns Detected FileType
+ */
+export function detectFileType(filePath, content) {
+    const fileName = path.basename(filePath);
+    // 1. File name patterns take precedence
+    if (TEST_FILE_PATTERNS.some((pattern) => pattern.test(fileName))) {
+        return 'test';
+    }
+    if (CONFIG_FILE_PATTERNS.some((pattern) => pattern.test(fileName))) {
+        return 'config';
+    }
+    // 2. Directory-based detection
+    const dirPath = path.dirname(filePath);
+    const pathParts = dirPath.split(path.sep);
+    // Check each directory level (inner to outer)
+    for (let i = pathParts.length - 1; i >= 0; i--) {
+        const dirName = pathParts[i].toLowerCase();
+        if (dirName && DIRECTORY_PATTERNS[dirName]) {
+            return DIRECTORY_PATTERNS[dirName];
+        }
+    }
+    // 3. Content-based fallback
+    return detectFromContent(content);
+}
+//# sourceMappingURL=detector.js.map

package/dist/generation/detection/detector.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"detector.js","sourceRoot":"","sources":["../../../src/generation/detection/detector.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B,OAAO,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAEtE;;;GAGG;AACH,MAAM,kBAAkB,GAAG;IACzB,kBAAkB;IAClB,kBAAkB;IAClB,iBAAiB;CAClB,CAAC;AAEF,MAAM,oBAAoB,GAAG;IAC3B,kBAAkB;IAClB,oBAAoB;IACpB,YAAY;IACZ,cAAc;IACd,SAAS;IACT,UAAU;CACX,CAAC;AAEF;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,cAAc,CAAC,QAAgB,EAAE,OAAe;IAC9D,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;IAEzC,wCAAwC;IACxC,IAAI,kBAAkB,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,EAAE,CAAC;QACjE,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,IAAI,oBAAoB,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,EAAE,CAAC;QACnE,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED,+BAA+B;IAC/B,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;IACvC,MAAM,SAAS,GAAG,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAE1C,8CAA8C;IAC9C,KAAK,IAAI,CAAC,GAAG,SAAS,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;QAC/C,MAAM,OAAO,GAAG,SAAS,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC;QAC3C,IAAI,OAAO,IAAI,kBAAkB,CAAC,OAAO,CAAC,EAAE,CAAC;YAC3C,OAAO,kBAAkB,CAAC,OAAO,CAAC,CAAC;QACrC,CAAC;IACH,CAAC;IAED,4BAA4B;IAC5B,OAAO,iBAAiB,CAAC,OAAO,CAAC,CAAC;AACpC,CAAC"}

package/dist/generation/detection/patterns.d.ts

@@ -0,0 +1,21 @@
+/**
+ * File type detection patterns
+ *
+ * Directory-based patterns for fast detection, with content-based
+ * fallback for files in non-standard locations.
+ */
+import type { FileType } from '../types.js';
+/**
+ * Directory name -> FileType mapping (case-insensitive)
+ * Used for fast path detection when files are in standard directories
+ */
+export declare const DIRECTORY_PATTERNS: Record<string, FileType>;
+/**
+ * Content-based detection patterns
+ * Used when directory doesn't match any known pattern
+ *
+ * @param content - File content to analyze
+ * @returns Detected file type or 'generic' if no pattern matches
+ */
+export declare function detectFromContent(content: string): FileType;
+//# sourceMappingURL=patterns.d.ts.map

package/dist/generation/detection/patterns.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"patterns.d.ts","sourceRoot":"","sources":["../../../src/generation/detection/patterns.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAE5C;;;GAGG;AACH,eAAO,MAAM,kBAAkB,EAAE,MAAM,CAAC,MAAM,EAAE,QAAQ,CAqDvD,CAAC;AAEF;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,QAAQ,CA2E3D"}