@defai.digital/ax-cli 3.2.0 → 3.4.0

package/dist/analyzers/architecture/pattern-detectors/mvc-detector.js

@@ -0,0 +1,43 @@
+/**
+ * MVC Pattern Detector
+ *
+ * Detects Model-View-Controller architectural pattern.
+ * Looks for models/, views/, and controllers/ directories.
+ */
+import { BasePatternDetector } from './base-detector.js';
+export class MVCDetector extends BasePatternDetector {
+    detect(structure) {
+        const hasModels = this.scanner.hasDirectory(structure, 'models');
+        const hasViews = this.scanner.hasDirectory(structure, 'views');
+        const hasControllers = this.scanner.hasDirectory(structure, 'controllers');
+        // Need at least 2 out of 3 components to suggest MVC
+        const matchCount = [hasModels, hasViews, hasControllers].filter(Boolean)
+            .length;
+        if (matchCount < 2) {
+            return null;
+        }
+        const locations = [];
+        let confidence = 0;
+        if (hasModels) {
+            const modelDirs = structure.directories.filter((d) => d.relativePath.toLowerCase().includes('models'));
+            locations.push(...modelDirs.map((d) => d.relativePath));
+            confidence += 0.33;
+        }
+        if (hasViews) {
+            const viewDirs = structure.directories.filter((d) => d.relativePath.toLowerCase().includes('views'));
+            locations.push(...viewDirs.map((d) => d.relativePath));
+            confidence += 0.33;
+        }
+        if (hasControllers) {
+            const controllerDirs = structure.directories.filter((d) => d.relativePath.toLowerCase().includes('controllers'));
+            locations.push(...controllerDirs.map((d) => d.relativePath));
+            confidence += 0.34;
+        }
+        return this.createPattern('MVC (Model-View-Controller)', 'architectural', confidence, locations, 'Separates application into Models (data), Views (presentation), and Controllers (logic)', {
+            hasModels,
+            hasViews,
+            hasControllers,
+        });
+    }
+}
+//# sourceMappingURL=mvc-detector.js.map

package/dist/analyzers/architecture/pattern-detectors/mvc-detector.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mvc-detector.js","sourceRoot":"","sources":["../../../../src/analyzers/architecture/pattern-detectors/mvc-detector.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAEzD,MAAM,OAAO,WAAY,SAAQ,mBAAmB;IAClD,MAAM,CAAC,SAA2B;QAChC,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,YAAY,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;QACjE,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,YAAY,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;QAC/D,MAAM,cAAc,GAAG,IAAI,CAAC,OAAO,CAAC,YAAY,CAAC,SAAS,EAAE,aAAa,CAAC,CAAC;QAE3E,qDAAqD;QACrD,MAAM,UAAU,GAAG,CAAC,SAAS,EAAE,QAAQ,EAAE,cAAc,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC;aACrE,MAAM,CAAC;QAEV,IAAI,UAAU,GAAG,CAAC,EAAE,CAAC;YACnB,OAAO,IAAI,CAAC;QACd,CAAC;QAED,MAAM,SAAS,GAAa,EAAE,CAAC;QAC/B,IAAI,UAAU,GAAG,CAAC,CAAC;QAEnB,IAAI,SAAS,EAAE,CAAC;YACd,MAAM,SAAS,GAAG,SAAS,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CACnD,CAAC,CAAC,YAAY,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAChD,CAAC;YACF,SAAS,CAAC,IAAI,CAAC,GAAG,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC;YACxD,UAAU,IAAI,IAAI,CAAC;QACrB,CAAC;QAED,IAAI,QAAQ,EAAE,CAAC;YACb,MAAM,QAAQ,GAAG,SAAS,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAClD,CAAC,CAAC,YAAY,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,OAAO,CAAC,CAC/C,CAAC;YACF,SAAS,CAAC,IAAI,CAAC,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC;YACvD,UAAU,IAAI,IAAI,CAAC;QACrB,CAAC;QAED,IAAI,cAAc,EAAE,CAAC;YACnB,MAAM,cAAc,GAAG,SAAS,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CACxD,CAAC,CAAC,YAAY,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,aAAa,CAAC,CACrD,CAAC;YACF,SAAS,CAAC,IAAI,CAAC,GAAG,cAAc,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC;YAC7D,UAAU,IAAI,IAAI,CAAC;QACrB,CAAC;QAED,OAAO,IAAI,CAAC,aAAa,CACvB,6BAA6B,EAC7B,eAAe,EACf,UAAU,EACV,SAAS,EACT,yFAAyF,EACzF;YACE,SAAS;YACT,QAAQ;YACR,cAAc;SACf,CACF,CAAC;IACJ,CAAC;CACF"}

package/dist/analyzers/architecture/pattern-detectors/repository-detector.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Repository Pattern Detector
+ *
+ * Detects Repository pattern for data access abstraction.
+ * Looks for files/directories with "repository" in the name.
+ */
+import type { DetectedPattern, ProjectStructure } from '../../../types/analysis.js';
+import { BasePatternDetector } from './base-detector.js';
+export declare class RepositoryDetector extends BasePatternDetector {
+    detect(structure: ProjectStructure): DetectedPattern | null;
+}

package/dist/analyzers/architecture/pattern-detectors/repository-detector.js

@@ -0,0 +1,49 @@
+/**
+ * Repository Pattern Detector
+ *
+ * Detects Repository pattern for data access abstraction.
+ * Looks for files/directories with "repository" in the name.
+ */
+import { BasePatternDetector } from './base-detector.js';
+export class RepositoryDetector extends BasePatternDetector {
+    detect(structure) {
+        // Look for repository directories
+        const hasRepositoryDir = this.scanner.hasDirectory(structure, 'repositories') ||
+            this.scanner.hasDirectory(structure, 'repository');
+        // Look for files with "repository" in the name
+        const repositoryFiles = this.scanner.getFilesByPattern(structure, /repository\.(ts|js|tsx|jsx)$/i);
+        if (!hasRepositoryDir && repositoryFiles.length === 0) {
+            return null;
+        }
+        const locations = [];
+        let confidence = 0.6; // Base confidence
+        // Add directory locations
+        if (hasRepositoryDir) {
+            const repoDirs = structure.directories.filter((d) => d.relativePath.toLowerCase().includes('repositories') ||
+                d.relativePath.toLowerCase().includes('repository'));
+            locations.push(...repoDirs.map((d) => d.relativePath));
+            confidence += 0.2;
+        }
+        // Add file locations
+        if (repositoryFiles.length > 0) {
+            locations.push(...repositoryFiles.map((f) => f.relativePath));
+            // Check for interfaces/abstractions (higher confidence)
+            const hasInterfaces = repositoryFiles.some((f) => f.relativePath.toLowerCase().includes('interface') ||
+                f.relativePath.toLowerCase().includes('abstract') ||
+                f.relativePath.toLowerCase().includes('i-repository'));
+            if (hasInterfaces) {
+                confidence += 0.2;
+            }
+            else {
+                confidence += 0.1;
+            }
+        }
+        return this.createPattern('Repository Pattern', 'structural', Math.min(confidence, 1.0), locations, 'Encapsulates data access logic and provides a collection-like interface for domain entities', {
+            repositoryCount: repositoryFiles.length,
+            hasRepositoryDirectory: hasRepositoryDir,
+            hasInterfaces: repositoryFiles.some((f) => f.relativePath.toLowerCase().includes('interface') ||
+                f.relativePath.toLowerCase().includes('abstract')),
+        });
+    }
+}
+//# sourceMappingURL=repository-detector.js.map

package/dist/analyzers/architecture/pattern-detectors/repository-detector.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"repository-detector.js","sourceRoot":"","sources":["../../../../src/analyzers/architecture/pattern-detectors/repository-detector.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAEzD,MAAM,OAAO,kBAAmB,SAAQ,mBAAmB;IACzD,MAAM,CAAC,SAA2B;QAChC,kCAAkC;QAClC,MAAM,gBAAgB,GAAG,IAAI,CAAC,OAAO,CAAC,YAAY,CAAC,SAAS,EAAE,cAAc,CAAC;YACnD,IAAI,CAAC,OAAO,CAAC,YAAY,CAAC,SAAS,EAAE,YAAY,CAAC,CAAC;QAE7E,+CAA+C;QAC/C,MAAM,eAAe,GAAG,IAAI,CAAC,OAAO,CAAC,iBAAiB,CACpD,SAAS,EACT,+BAA+B,CAChC,CAAC;QAEF,IAAI,CAAC,gBAAgB,IAAI,eAAe,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACtD,OAAO,IAAI,CAAC;QACd,CAAC;QAED,MAAM,SAAS,GAAa,EAAE,CAAC;QAC/B,IAAI,UAAU,GAAG,GAAG,CAAC,CAAC,kBAAkB;QAExC,0BAA0B;QAC1B,IAAI,gBAAgB,EAAE,CAAC;YACrB,MAAM,QAAQ,GAAG,SAAS,CAAC,WAAW,CAAC,MAAM,CAC3C,CAAC,CAAC,EAAE,EAAE,CACJ,CAAC,CAAC,YAAY,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,cAAc,CAAC;gBACrD,CAAC,CAAC,YAAY,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,YAAY,CAAC,CACtD,CAAC;YACF,SAAS,CAAC,IAAI,CAAC,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC;YACvD,UAAU,IAAI,GAAG,CAAC;QACpB,CAAC;QAED,qBAAqB;QACrB,IAAI,eAAe,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC/B,SAAS,CAAC,IAAI,CAAC,GAAG,eAAe,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC;YAE9D,wDAAwD;YACxD,MAAM,aAAa,GAAG,eAAe,CAAC,IAAI,CACxC,CAAC,CAAC,EAAE,EAAE,CACJ,CAAC,CAAC,YAAY,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,WAAW,CAAC;gBAClD,CAAC,CAAC,YAAY,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,UAAU,CAAC;gBACjD,CAAC,CAAC,YAAY,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,cAAc,CAAC,CACxD,CAAC;YAEF,IAAI,aAAa,EAAE,CAAC;gBAClB,UAAU,IAAI,GAAG,CAAC;YACpB,CAAC;iBAAM,CAAC;gBACN,UAAU,IAAI,GAAG,CAAC;YACpB,CAAC;QACH,CAAC;QAED,OAAO,IAAI,CAAC,aAAa,CACvB,oBAAoB,EACpB,YAAY,EACZ,IAAI,CAAC,GAAG,CAAC,UAAU,EAAE,GAAG,CAAC,EACzB,SAAS,EACT,6FAA6F,EAC7F;YACE,eAAe,EAAE,eAAe,CAAC,MAAM;YACvC,sBAAsB,EAAE,gBAAgB;YACxC,aAAa,EAAE,eAAe,CAAC,IAAI,CACjC,CAAC,CAAC,EAAE,EAAE,CACJ,CAAC,CAAC,YAAY,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,WAAW,CAAC;gBAClD,CAAC,CAAC,YAAY,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,UAAU,CAAC,CACpD;SACF,CACF,CAAC;IACJ,CAAC;CACF"}

package/dist/analyzers/architecture/project-structure-scanner.d.ts

@@ -0,0 +1,54 @@
+/**
+ * Project Structure Scanner
+ *
+ * Scans project directory structure and gathers file/directory information.
+ * Implements ignore patterns for common non-source directories.
+ */
+import type { FileInfo, ProjectStructure } from '../../types/analysis.js';
+export declare class ProjectStructureScanner {
+    private readonly ignorePatterns;
+    /**
+     * Scan project structure
+     */
+    scan(projectPath: string): Promise<ProjectStructure>;
+    /**
+     * Validate project path exists and is a directory
+     */
+    private validatePath;
+    /**
+     * Gather file information with concurrency control
+     */
+    private gatherFileInfo;
+    /**
+     * Get information for a single file
+     */
+    private getFileInfo;
+    /**
+     * Gather directory information with concurrency control
+     */
+    private gatherDirectoryInfo;
+    /**
+     * Get information for a single directory
+     */
+    private getDirectoryInfo;
+    /**
+     * Group files by extension
+     */
+    private groupFilesByExtension;
+    /**
+     * Check if structure has a directory matching name (case-insensitive)
+     */
+    hasDirectory(structure: ProjectStructure, dirName: string): boolean;
+    /**
+     * Check if structure has a file matching name (case-insensitive)
+     */
+    hasFile(structure: ProjectStructure, fileName: string): boolean;
+    /**
+     * Get files matching a regex pattern
+     */
+    getFilesByPattern(structure: ProjectStructure, pattern: RegExp): FileInfo[];
+    /**
+     * Get files by extension
+     */
+    getFilesByExtension(structure: ProjectStructure, extension: string): FileInfo[];
+}

package/dist/analyzers/architecture/project-structure-scanner.js

@@ -0,0 +1,200 @@
+/**
+ * Project Structure Scanner
+ *
+ * Scans project directory structure and gathers file/directory information.
+ * Implements ignore patterns for common non-source directories.
+ */
+import { promises as fs } from 'fs';
+import path from 'path';
+import { glob } from 'glob';
+import { ProjectStructureError } from '../errors.js';
+export class ProjectStructureScanner {
+    ignorePatterns = [
+        '**/node_modules/**',
+        '**/.git/**',
+        '**/dist/**',
+        '**/build/**',
+        '**/.next/**',
+        '**/coverage/**',
+        '**/.cache/**',
+        '**/.vscode/**',
+        '**/.idea/**',
+        '**/.DS_Store',
+        '**/package-lock.json',
+        '**/yarn.lock',
+        '**/pnpm-lock.yaml',
+    ];
+    /**
+     * Scan project structure
+     */
+    async scan(projectPath) {
+        // Validate path
+        await this.validatePath(projectPath);
+        // Find all files
+        const filePaths = await glob('**/*', {
+            cwd: projectPath,
+            ignore: this.ignorePatterns,
+            nodir: true,
+            absolute: false,
+            dot: false, // Don't include hidden files
+        });
+        // Gather file info in parallel (with concurrency limit)
+        const files = await this.gatherFileInfo(projectPath, filePaths);
+        // Find all directories
+        const dirPaths = await glob('**/', {
+            cwd: projectPath,
+            ignore: this.ignorePatterns,
+            absolute: false,
+            dot: false,
+        });
+        const directories = await this.gatherDirectoryInfo(projectPath, dirPaths);
+        // Group files by extension
+        const filesByExtension = this.groupFilesByExtension(files);
+        const totalLines = files.reduce((sum, f) => sum + f.lines, 0);
+        return Object.freeze({
+            rootPath: projectPath,
+            files: Object.freeze(files),
+            directories: Object.freeze(directories),
+            filesByExtension,
+            totalLines,
+            totalFiles: files.length,
+        });
+    }
+    /**
+     * Validate project path exists and is a directory
+     */
+    async validatePath(projectPath) {
+        // Check for path traversal attempts
+        if (projectPath.includes('..')) {
+            throw new ProjectStructureError('Path traversal detected', {
+                path: projectPath,
+            });
+        }
+        try {
+            const stats = await fs.stat(projectPath);
+            if (!stats.isDirectory()) {
+                throw new ProjectStructureError('Path is not a directory', {
+                    path: projectPath,
+                });
+            }
+        }
+        catch (error) {
+            if (error.code === 'ENOENT') {
+                throw new ProjectStructureError('Path does not exist', {
+                    path: projectPath,
+                });
+            }
+            throw new ProjectStructureError(`Failed to access path: ${error.message}`, { path: projectPath });
+        }
+    }
+    /**
+     * Gather file information with concurrency control
+     */
+    async gatherFileInfo(rootPath, relativePaths) {
+        const CONCURRENCY = 10; // Process 10 files at a time
+        const results = [];
+        for (let i = 0; i < relativePaths.length; i += CONCURRENCY) {
+            const batch = relativePaths.slice(i, i + CONCURRENCY);
+            const batchResults = await Promise.all(batch.map((relativePath) => this.getFileInfo(rootPath, relativePath).catch((error) => {
+                console.warn(`Failed to read file ${relativePath}:`, error.message);
+                return null;
+            })));
+            results.push(...batchResults.filter((r) => r !== null));
+        }
+        return results;
+    }
+    /**
+     * Get information for a single file
+     */
+    async getFileInfo(rootPath, relativePath) {
+        const fullPath = path.join(rootPath, relativePath);
+        const stats = await fs.stat(fullPath);
+        // Count lines
+        let lines = 0;
+        try {
+            const content = await fs.readFile(fullPath, 'utf-8');
+            lines = content.split('\n').length;
+        }
+        catch {
+            // If file can't be read as text, lines remain 0
+            lines = 0;
+        }
+        return Object.freeze({
+            path: fullPath,
+            relativePath,
+            lines,
+            size: stats.size,
+            extension: path.extname(relativePath),
+        });
+    }
+    /**
+     * Gather directory information with concurrency control
+     */
+    async gatherDirectoryInfo(rootPath, relativePaths) {
+        const CONCURRENCY = 10;
+        const results = [];
+        for (let i = 0; i < relativePaths.length; i += CONCURRENCY) {
+            const batch = relativePaths.slice(i, i + CONCURRENCY);
+            const batchResults = await Promise.all(batch.map((relativePath) => this.getDirectoryInfo(rootPath, relativePath).catch((error) => {
+                console.warn(`Failed to read directory ${relativePath}:`, error.message);
+                return null;
+            })));
+            results.push(...batchResults.filter((r) => r !== null));
+        }
+        return results;
+    }
+    /**
+     * Get information for a single directory
+     */
+    async getDirectoryInfo(rootPath, relativePath) {
+        const fullPath = path.join(rootPath, relativePath);
+        const entries = await fs.readdir(fullPath, { withFileTypes: true });
+        const fileCount = entries.filter((e) => e.isFile()).length;
+        const subdirCount = entries.filter((e) => e.isDirectory()).length;
+        return Object.freeze({
+            path: fullPath,
+            relativePath,
+            fileCount,
+            subdirCount,
+        });
+    }
+    /**
+     * Group files by extension
+     */
+    groupFilesByExtension(files) {
+        const groups = new Map();
+        for (const file of files) {
+            const ext = file.extension || '.no-extension';
+            const existing = groups.get(ext) || [];
+            groups.set(ext, [...existing, file]);
+        }
+        // Freeze all arrays
+        return new Map(Array.from(groups.entries()).map(([k, v]) => [k, Object.freeze(v)]));
+    }
+    /**
+     * Check if structure has a directory matching name (case-insensitive)
+     */
+    hasDirectory(structure, dirName) {
+        return structure.directories.some((d) => d.relativePath.toLowerCase().includes(dirName.toLowerCase()));
+    }
+    /**
+     * Check if structure has a file matching name (case-insensitive)
+     */
+    hasFile(structure, fileName) {
+        return structure.files.some((f) => f.relativePath.toLowerCase().includes(fileName.toLowerCase()));
+    }
+    /**
+     * Get files matching a regex pattern
+     */
+    getFilesByPattern(structure, pattern) {
+        return structure.files.filter((f) => pattern.test(f.relativePath));
+    }
+    /**
+     * Get files by extension
+     */
+    getFilesByExtension(structure, extension) {
+        const ext = extension.startsWith('.') ? extension : `.${extension}`;
+        return Array.from(structure.filesByExtension.get(ext) || []);
+    }
+}
+//# sourceMappingURL=project-structure-scanner.js.map

package/dist/analyzers/architecture/project-structure-scanner.js.map

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

package/dist/analyzers/best-practices/base-rule.d.ts

@@ -0,0 +1,45 @@
+/**
+ * Base Validation Rule
+ *
+ * Abstract base class for all validation rules
+ * Provides common functionality and helpers
+ */
+import type { ValidationRule, ViolationFix } from './types.js';
+import type { Violation, Severity } from '../../types/analysis.js';
+import type { RuleCategory } from './types.js';
+/**
+ * Abstract base class for validation rules
+ * Provides common functionality for all rules
+ */
+export declare abstract class BaseValidationRule implements ValidationRule {
+    abstract readonly id: string;
+    abstract readonly name: string;
+    abstract readonly description: string;
+    abstract readonly severity: Severity;
+    abstract readonly category: RuleCategory;
+    abstract readonly autoFixable: boolean;
+    /**
+     * Check file for violations
+     * Must be implemented by subclasses
+     */
+    abstract check(filePath: string, content: string): Promise<Violation[]>;
+    /**
+     * Generate fix for violation (optional)
+     */
+    fix?(violation: Violation, content: string): Promise<ViolationFix | null>;
+    /**
+     * Helper: Create a violation object
+     */
+    protected createViolation(file: string, line: number, column: number, message: string, suggestion?: string, metadata?: Record<string, unknown>): Violation;
+    /**
+     * Helper: Find line and column from character index
+     */
+    protected getPosition(content: string, index: number): {
+        line: number;
+        column: number;
+    };
+    /**
+     * Helper: Count matches in content
+     */
+    protected countMatches(content: string, pattern: RegExp): number;
+}

package/dist/analyzers/best-practices/base-rule.js

@@ -0,0 +1,45 @@
+/**
+ * Base Validation Rule
+ *
+ * Abstract base class for all validation rules
+ * Provides common functionality and helpers
+ */
+/**
+ * Abstract base class for validation rules
+ * Provides common functionality for all rules
+ */
+export class BaseValidationRule {
+    /**
+     * Helper: Create a violation object
+     */
+    createViolation(file, line, column, message, suggestion, metadata) {
+        return Object.freeze({
+            ruleId: this.id,
+            severity: this.severity,
+            file,
+            line,
+            column,
+            message,
+            suggestion,
+            metadata: metadata ? Object.freeze(metadata) : undefined,
+        });
+    }
+    /**
+     * Helper: Find line and column from character index
+     */
+    getPosition(content, index) {
+        const lines = content.substring(0, index).split('\n');
+        return {
+            line: lines.length,
+            column: lines[lines.length - 1].length + 1,
+        };
+    }
+    /**
+     * Helper: Count matches in content
+     */
+    countMatches(content, pattern) {
+        const matches = content.match(pattern);
+        return matches ? matches.length : 0;
+    }
+}
+//# sourceMappingURL=base-rule.js.map

package/dist/analyzers/best-practices/base-rule.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"base-rule.js","sourceRoot":"","sources":["../../../src/analyzers/best-practices/base-rule.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAMH;;;GAGG;AACH,MAAM,OAAgB,kBAAkB;IAmBtC;;OAEG;IACO,eAAe,CACvB,IAAY,EACZ,IAAY,EACZ,MAAc,EACd,OAAe,EACf,UAAmB,EACnB,QAAkC;QAElC,OAAO,MAAM,CAAC,MAAM,CAAC;YACnB,MAAM,EAAE,IAAI,CAAC,EAAE;YACf,QAAQ,EAAE,IAAI,CAAC,QAAQ;YACvB,IAAI;YACJ,IAAI;YACJ,MAAM;YACN,OAAO;YACP,UAAU;YACV,QAAQ,EAAE,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,SAAS;SACzD,CAAC,CAAC;IACL,CAAC;IAED;;OAEG;IACO,WAAW,CACnB,OAAe,EACf,KAAa;QAEb,MAAM,KAAK,GAAG,OAAO,CAAC,SAAS,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QACtD,OAAO;YACL,IAAI,EAAE,KAAK,CAAC,MAAM;YAClB,MAAM,EAAE,KAAK,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC;SAC3C,CAAC;IACJ,CAAC;IAED;;OAEG;IACO,YAAY,CAAC,OAAe,EAAE,OAAe;QACrD,MAAM,OAAO,GAAG,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QACvC,OAAO,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;IACtC,CAAC;CACF"}

package/dist/analyzers/best-practices/best-practice-validator.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Best Practice Validator
+ *
+ * Main orchestrator for validation operations
+ */
+import type { ValidationResult, BatchValidationResult, ValidationOptions } from '../../types/analysis.js';
+import type { Logger } from '../../utils/analysis-logger.js';
+export declare class BestPracticeValidator {
+    private readonly logger;
+    constructor(logger?: Logger);
+    /**
+     * Validate a single file
+     */
+    validateFile(filePath: string, options?: ValidationOptions): Promise<ValidationResult>;
+    /**
+     * Validate multiple files in batch
+     */
+    validateBatch(filePaths: string[], options?: ValidationOptions): Promise<BatchValidationResult>;
+    /**
+     * Detect language from file extension
+     */
+    private detectLanguage;
+    /**
+     * Calculate quality score (0-100)
+     */
+    private calculateScore;
+    /**
+     * Generate summary text
+     */
+    private generateSummary;
+    /**
+     * Generate batch summary
+     */
+    private generateBatchSummary;
+}