code-auditor-mcp 1.0.0

package/dist/utils/fileDiscovery.d.ts

@@ -0,0 +1,58 @@
+/**
+ * File Discovery Utilities
+ * Provides functionality for discovering and filtering files for analysis
+ *
+ * Supports TypeScript, JavaScript, and JSX/TSX files with configurable
+ * include/exclude patterns
+ */
+export declare const DEFAULT_EXCLUDED_DIRS: string[];
+export declare const TYPESCRIPT_EXTENSIONS: string[];
+export declare const JAVASCRIPT_EXTENSIONS: string[];
+export declare const ALL_EXTENSIONS: string[];
+export interface FileDiscoveryOptions {
+    extensions?: string[];
+    excludeDirs?: string[];
+    includePaths?: string[];
+    excludePaths?: string[];
+    followSymlinks?: boolean;
+}
+/**
+ * Find all files matching the given options
+ */
+export declare function findFiles(rootDir?: string, options?: FileDiscoveryOptions): Promise<string[]>;
+/**
+ * Find TypeScript/TSX files
+ */
+export declare function findTypeScriptFiles(rootDir?: string, options?: Omit<FileDiscoveryOptions, 'extensions'>): Promise<string[]>;
+/**
+ * Find JavaScript/JSX files
+ */
+export declare function findJavaScriptFiles(rootDir?: string, options?: Omit<FileDiscoveryOptions, 'extensions'>): Promise<string[]>;
+/**
+ * Find files by pattern (e.g., "*.test.ts", "*.spec.tsx")
+ */
+export declare function findFilesByPattern(rootDir: string, pattern: string | RegExp, options?: FileDiscoveryOptions): Promise<string[]>;
+/**
+ * Filter files by include/exclude patterns
+ */
+export declare function filterFiles(files: string[], options?: {
+    includePaths?: string[];
+    excludePaths?: string[];
+}): string[];
+/**
+ * Get file statistics
+ */
+export declare function getFileStats(filePath: string): Promise<{
+    size: number;
+    modified: Date;
+    lines?: number;
+}>;
+/**
+ * Check if a file exists and is readable
+ */
+export declare function isReadableFile(filePath: string): Promise<boolean>;
+/**
+ * Alias for findFiles to match expected import
+ */
+export declare const discoverFiles: typeof findFiles;
+//# sourceMappingURL=fileDiscovery.d.ts.map

package/dist/utils/fileDiscovery.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fileDiscovery.d.ts","sourceRoot":"","sources":["../../src/utils/fileDiscovery.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAMH,eAAO,MAAM,qBAAqB,UAcjC,CAAC;AAGF,eAAO,MAAM,qBAAqB,UAAkB,CAAC;AACrD,eAAO,MAAM,qBAAqB,UAAkB,CAAC;AACrD,eAAO,MAAM,cAAc,UAAuD,CAAC;AAEnF,MAAM,WAAW,oBAAoB;IACnC,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B;AAuDD;;GAEG;AACH,wBAAsB,SAAS,CAC7B,OAAO,GAAE,MAAsB,EAC/B,OAAO,GAAE,oBAAyB,GACjC,OAAO,CAAC,MAAM,EAAE,CAAC,CAiBnB;AAED;;GAEG;AACH,wBAAsB,mBAAmB,CACvC,OAAO,GAAE,MAAsB,EAC/B,OAAO,GAAE,IAAI,CAAC,oBAAoB,EAAE,YAAY,CAAM,GACrD,OAAO,CAAC,MAAM,EAAE,CAAC,CAKnB;AAED;;GAEG;AACH,wBAAsB,mBAAmB,CACvC,OAAO,GAAE,MAAsB,EAC/B,OAAO,GAAE,IAAI,CAAC,oBAAoB,EAAE,YAAY,CAAM,GACrD,OAAO,CAAC,MAAM,EAAE,CAAC,CAKnB;AAED;;GAEG;AACH,wBAAsB,kBAAkB,CACtC,OAAO,EAAE,MAAsB,EAC/B,OAAO,EAAE,MAAM,GAAG,MAAM,EACxB,OAAO,GAAE,oBAAyB,GACjC,OAAO,CAAC,MAAM,EAAE,CAAC,CAsBnB;AAED;;GAEG;AACH,wBAAgB,WAAW,CACzB,KAAK,EAAE,MAAM,EAAE,EACf,OAAO,GAAE;IACP,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;CACpB,GACL,MAAM,EAAE,CA0BV;AAaD;;GAEG;AACH,wBAAsB,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC;IAC5D,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,IAAI,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,CAAC,CAiBD;AAED;;GAEG;AACH,wBAAsB,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAQvE;AAED;;GAEG;AACH,eAAO,MAAM,aAAa,kBAAY,CAAC"}

package/dist/utils/fileDiscovery.js

@@ -0,0 +1,203 @@
+/**
+ * File Discovery Utilities
+ * Provides functionality for discovering and filtering files for analysis
+ *
+ * Supports TypeScript, JavaScript, and JSX/TSX files with configurable
+ * include/exclude patterns
+ */
+import { promises as fs } from 'fs';
+import path from 'path';
+// Default directories to exclude from analysis
+export const DEFAULT_EXCLUDED_DIRS = [
+    'node_modules',
+    '.next',
+    'dist',
+    'build',
+    '.git',
+    'coverage',
+    '.turbo',
+    'out',
+    '.cache',
+    'tmp',
+    'temp',
+    '.vscode',
+    '.idea'
+];
+// Supported file extensions
+export const TYPESCRIPT_EXTENSIONS = ['.ts', '.tsx'];
+export const JAVASCRIPT_EXTENSIONS = ['.js', '.jsx'];
+export const ALL_EXTENSIONS = [...TYPESCRIPT_EXTENSIONS, ...JAVASCRIPT_EXTENSIONS];
+/**
+ * Check if a path should be excluded based on directory names
+ */
+function shouldExcludeDir(filePath, excludeDirs) {
+    const parts = filePath.split(path.sep);
+    return parts.some(part => excludeDirs.includes(part));
+}
+/**
+ * Recursively find files matching criteria
+ */
+async function findFilesRecursive(dir, options) {
+    const results = [];
+    try {
+        const entries = await fs.readdir(dir, { withFileTypes: true });
+        for (const entry of entries) {
+            const fullPath = path.join(dir, entry.name);
+            if (shouldExcludeDir(fullPath, options.excludeDirs)) {
+                continue;
+            }
+            if (entry.isDirectory()) {
+                const subResults = await findFilesRecursive(fullPath, options);
+                results.push(...subResults);
+            }
+            else if (entry.isFile()) {
+                const ext = path.extname(entry.name);
+                if (options.extensions.includes(ext)) {
+                    if (!options.pattern || options.pattern.test(entry.name)) {
+                        results.push(fullPath);
+                    }
+                }
+            }
+        }
+    }
+    catch (error) {
+        // Silently skip directories we can't read
+        if (error.code !== 'EACCES') {
+            console.error(`Error reading directory ${dir}:`, error);
+        }
+    }
+    return results;
+}
+/**
+ * Find all files matching the given options
+ */
+export async function findFiles(rootDir = process.cwd(), options = {}) {
+    const extensions = options.extensions || ALL_EXTENSIONS;
+    const excludeDirs = options.excludeDirs || DEFAULT_EXCLUDED_DIRS;
+    const files = await findFilesRecursive(rootDir, {
+        extensions,
+        excludeDirs
+    });
+    // Apply additional filtering
+    let filtered = filterFiles(files, {
+        includePaths: options.includePaths,
+        excludePaths: options.excludePaths
+    });
+    // Sort for consistent output
+    return filtered.sort();
+}
+/**
+ * Find TypeScript/TSX files
+ */
+export async function findTypeScriptFiles(rootDir = process.cwd(), options = {}) {
+    return findFiles(rootDir, {
+        ...options,
+        extensions: TYPESCRIPT_EXTENSIONS
+    });
+}
+/**
+ * Find JavaScript/JSX files
+ */
+export async function findJavaScriptFiles(rootDir = process.cwd(), options = {}) {
+    return findFiles(rootDir, {
+        ...options,
+        extensions: JAVASCRIPT_EXTENSIONS
+    });
+}
+/**
+ * Find files by pattern (e.g., "*.test.ts", "*.spec.tsx")
+ */
+export async function findFilesByPattern(rootDir = process.cwd(), pattern, options = {}) {
+    const extensions = options.extensions || ALL_EXTENSIONS;
+    const excludeDirs = options.excludeDirs || DEFAULT_EXCLUDED_DIRS;
+    // Convert string pattern to RegExp if needed
+    const regex = typeof pattern === 'string'
+        ? new RegExp(pattern.replace(/\*/g, '.*'))
+        : pattern;
+    const files = await findFilesRecursive(rootDir, {
+        extensions,
+        excludeDirs,
+        pattern: regex
+    });
+    // Apply additional filtering
+    let filtered = filterFiles(files, {
+        includePaths: options.includePaths,
+        excludePaths: options.excludePaths
+    });
+    return filtered.sort();
+}
+/**
+ * Filter files by include/exclude patterns
+ */
+export function filterFiles(files, options = {}) {
+    let filtered = [...files];
+    // Apply include patterns
+    if (options.includePaths && options.includePaths.length > 0) {
+        filtered = filtered.filter(file => {
+            return options.includePaths.some(pattern => {
+                // Convert glob patterns to regex
+                const regex = globToRegex(pattern);
+                return regex.test(file);
+            });
+        });
+    }
+    // Apply exclude patterns
+    if (options.excludePaths && options.excludePaths.length > 0) {
+        filtered = filtered.filter(file => {
+            return !options.excludePaths.some(pattern => {
+                // Convert glob patterns to regex
+                const regex = globToRegex(pattern);
+                return regex.test(file);
+            });
+        });
+    }
+    return filtered;
+}
+/**
+ * Convert simple glob pattern to regex
+ */
+function globToRegex(pattern) {
+    // Escape special regex characters except * and ?
+    let regex = pattern.replace(/[.+^${}()|[\]\\]/g, '\\$&');
+    // Convert glob wildcards to regex
+    regex = regex.replace(/\*/g, '.*').replace(/\?/g, '.');
+    return new RegExp(`^${regex}$`);
+}
+/**
+ * Get file statistics
+ */
+export async function getFileStats(filePath) {
+    const stats = await fs.stat(filePath);
+    // Count lines for text files
+    let lines;
+    try {
+        const content = await fs.readFile(filePath, 'utf-8');
+        lines = content.split('\n').length;
+    }
+    catch {
+        // Ignore errors reading file content
+    }
+    return {
+        size: stats.size,
+        modified: stats.mtime,
+        lines
+    };
+}
+/**
+ * Check if a file exists and is readable
+ */
+export async function isReadableFile(filePath) {
+    try {
+        await fs.access(filePath, fs.constants.R_OK);
+        const stats = await fs.stat(filePath);
+        return stats.isFile();
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Alias for findFiles to match expected import
+ */
+export const discoverFiles = findFiles;
+//# sourceMappingURL=fileDiscovery.js.map

package/dist/utils/fileDiscovery.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fileDiscovery.js","sourceRoot":"","sources":["../../src/utils/fileDiscovery.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,QAAQ,IAAI,EAAE,EAAE,MAAM,IAAI,CAAC;AACpC,OAAO,IAAI,MAAM,MAAM,CAAC;AAExB,+CAA+C;AAC/C,MAAM,CAAC,MAAM,qBAAqB,GAAG;IACnC,cAAc;IACd,OAAO;IACP,MAAM;IACN,OAAO;IACP,MAAM;IACN,UAAU;IACV,QAAQ;IACR,KAAK;IACL,QAAQ;IACR,KAAK;IACL,MAAM;IACN,SAAS;IACT,OAAO;CACR,CAAC;AAEF,4BAA4B;AAC5B,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;AACrD,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;AACrD,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,GAAG,qBAAqB,EAAE,GAAG,qBAAqB,CAAC,CAAC;AAUnF;;GAEG;AACH,SAAS,gBAAgB,CAAC,QAAgB,EAAE,WAAqB;IAC/D,MAAM,KAAK,GAAG,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACvC,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,WAAW,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC;AACxD,CAAC;AAED;;GAEG;AACH,KAAK,UAAU,kBAAkB,CAC/B,GAAW,EACX,OAIC;IAED,MAAM,OAAO,GAAa,EAAE,CAAC;IAE7B,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,MAAM,EAAE,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC;QAE/D,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;YAC5B,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;YAE5C,IAAI,gBAAgB,CAAC,QAAQ,EAAE,OAAO,CAAC,WAAW,CAAC,EAAE,CAAC;gBACpD,SAAS;YACX,CAAC;YAED,IAAI,KAAK,CAAC,WAAW,EAAE,EAAE,CAAC;gBACxB,MAAM,UAAU,GAAG,MAAM,kBAAkB,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;gBAC/D,OAAO,CAAC,IAAI,CAAC,GAAG,UAAU,CAAC,CAAC;YAC9B,CAAC;iBAAM,IAAI,KAAK,CAAC,MAAM,EAAE,EAAE,CAAC;gBAC1B,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;gBACrC,IAAI,OAAO,CAAC,UAAU,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;oBACrC,IAAI,CAAC,OAAO,CAAC,OAAO,IAAI,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;wBACzD,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;oBACzB,CAAC;gBACH,CAAC;YACH,CAAC;QACH,CAAC;IACH,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,0CAA0C;QAC1C,IAAK,KAA+B,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;YACvD,OAAO,CAAC,KAAK,CAAC,2BAA2B,GAAG,GAAG,EAAE,KAAK,CAAC,CAAC;QAC1D,CAAC;IACH,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,SAAS,CAC7B,UAAkB,OAAO,CAAC,GAAG,EAAE,EAC/B,UAAgC,EAAE;IAElC,MAAM,UAAU,GAAG,OAAO,CAAC,UAAU,IAAI,cAAc,CAAC;IACxD,MAAM,WAAW,GAAG,OAAO,CAAC,WAAW,IAAI,qBAAqB,CAAC;IAEjE,MAAM,KAAK,GAAG,MAAM,kBAAkB,CAAC,OAAO,EAAE;QAC9C,UAAU;QACV,WAAW;KACZ,CAAC,CAAC;IAEH,6BAA6B;IAC7B,IAAI,QAAQ,GAAG,WAAW,CAAC,KAAK,EAAE;QAChC,YAAY,EAAE,OAAO,CAAC,YAAY;QAClC,YAAY,EAAE,OAAO,CAAC,YAAY;KACnC,CAAC,CAAC;IAEH,6BAA6B;IAC7B,OAAO,QAAQ,CAAC,IAAI,EAAE,CAAC;AACzB,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,mBAAmB,CACvC,UAAkB,OAAO,CAAC,GAAG,EAAE,EAC/B,UAAoD,EAAE;IAEtD,OAAO,SAAS,CAAC,OAAO,EAAE;QACxB,GAAG,OAAO;QACV,UAAU,EAAE,qBAAqB;KAClC,CAAC,CAAC;AACL,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,mBAAmB,CACvC,UAAkB,OAAO,CAAC,GAAG,EAAE,EAC/B,UAAoD,EAAE;IAEtD,OAAO,SAAS,CAAC,OAAO,EAAE;QACxB,GAAG,OAAO;QACV,UAAU,EAAE,qBAAqB;KAClC,CAAC,CAAC;AACL,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,UAAkB,OAAO,CAAC,GAAG,EAAE,EAC/B,OAAwB,EACxB,UAAgC,EAAE;IAElC,MAAM,UAAU,GAAG,OAAO,CAAC,UAAU,IAAI,cAAc,CAAC;IACxD,MAAM,WAAW,GAAG,OAAO,CAAC,WAAW,IAAI,qBAAqB,CAAC;IAEjE,6CAA6C;IAC7C,MAAM,KAAK,GAAG,OAAO,OAAO,KAAK,QAAQ;QACvC,CAAC,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;QAC1C,CAAC,CAAC,OAAO,CAAC;IAEZ,MAAM,KAAK,GAAG,MAAM,kBAAkB,CAAC,OAAO,EAAE;QAC9C,UAAU;QACV,WAAW;QACX,OAAO,EAAE,KAAK;KACf,CAAC,CAAC;IAEH,6BAA6B;IAC7B,IAAI,QAAQ,GAAG,WAAW,CAAC,KAAK,EAAE;QAChC,YAAY,EAAE,OAAO,CAAC,YAAY;QAClC,YAAY,EAAE,OAAO,CAAC,YAAY;KACnC,CAAC,CAAC;IAEH,OAAO,QAAQ,CAAC,IAAI,EAAE,CAAC;AACzB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,WAAW,CACzB,KAAe,EACf,UAGI,EAAE;IAEN,IAAI,QAAQ,GAAG,CAAC,GAAG,KAAK,CAAC,CAAC;IAE1B,yBAAyB;IACzB,IAAI,OAAO,CAAC,YAAY,IAAI,OAAO,CAAC,YAAY,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC5D,QAAQ,GAAG,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE;YAChC,OAAO,OAAO,CAAC,YAAa,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE;gBAC1C,iCAAiC;gBACjC,MAAM,KAAK,GAAG,WAAW,CAAC,OAAO,CAAC,CAAC;gBACnC,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAC1B,CAAC,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;IACL,CAAC;IAED,yBAAyB;IACzB,IAAI,OAAO,CAAC,YAAY,IAAI,OAAO,CAAC,YAAY,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC5D,QAAQ,GAAG,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE;YAChC,OAAO,CAAC,OAAO,CAAC,YAAa,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE;gBAC3C,iCAAiC;gBACjC,MAAM,KAAK,GAAG,WAAW,CAAC,OAAO,CAAC,CAAC;gBACnC,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAC1B,CAAC,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;IACL,CAAC;IAED,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED;;GAEG;AACH,SAAS,WAAW,CAAC,OAAe;IAClC,iDAAiD;IACjD,IAAI,KAAK,GAAG,OAAO,CAAC,OAAO,CAAC,mBAAmB,EAAE,MAAM,CAAC,CAAC;IACzD,kCAAkC;IAClC,KAAK,GAAG,KAAK,CAAC,OAAO,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;IACvD,OAAO,IAAI,MAAM,CAAC,IAAI,KAAK,GAAG,CAAC,CAAC;AAClC,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,QAAgB;IAKjD,MAAM,KAAK,GAAG,MAAM,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IAEtC,6BAA6B;IAC7B,IAAI,KAAyB,CAAC;IAC9B,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;QACrD,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC;IACrC,CAAC;IAAC,MAAM,CAAC;QACP,qCAAqC;IACvC,CAAC;IAED,OAAO;QACL,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,QAAQ,EAAE,KAAK,CAAC,KAAK;QACrB,KAAK;KACN,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,QAAgB;IACnD,IAAI,CAAC;QACH,MAAM,EAAE,CAAC,MAAM,CAAC,QAAQ,EAAE,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;QAC7C,MAAM,KAAK,GAAG,MAAM,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QACtC,OAAO,KAAK,CAAC,MAAM,EAAE,CAAC;IACxB,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,SAAS,CAAC"}

package/examples/.auditrc.example.json

@@ -0,0 +1,61 @@
+{
+  "projectRoot": ".",
+  "reportTitle": "Code Quality Audit Report",
+  
+  "includePaths": [
+    "src/**/*.{ts,tsx,js,jsx}",
+    "app/**/*.{ts,tsx,js,jsx}",
+    "lib/**/*.{ts,tsx,js,jsx}",
+    "components/**/*.{ts,tsx,js,jsx}"
+  ],
+  
+  "excludePaths": [
+    "**/node_modules/**",
+    "**/.next/**",
+    "**/dist/**",
+    "**/build/**",
+    "**/coverage/**",
+    "**/*.test.{ts,tsx,js,jsx}",
+    "**/*.spec.{ts,tsx,js,jsx}",
+    "**/__tests__/**"
+  ],
+  
+  "enabledAnalyzers": [
+    "solid",
+    "dry",
+    "security",
+    "component",
+    "data-access"
+  ],
+  
+  "analyzerConfig": {
+    "solid": {
+      "maxMethodsPerClass": 10,
+      "maxLinesPerMethod": 50,
+      "maxParametersPerMethod": 4,
+      "maxComplexity": 10
+    },
+    "dry": {
+      "minLineThreshold": 5,
+      "similarityThreshold": 0.85
+    },
+    "security": {
+      "authPatterns": ["withAuth", "requireAuth", "isAuthenticated"],
+      "rateLimitPatterns": ["rateLimit", "withRateLimit"]
+    }
+  },
+  
+  "outputFormats": ["html", "json"],
+  "outputDirectory": "./audit-reports",
+  
+  "minSeverity": "suggestion",
+  "failOnCritical": false,
+  "verbose": false,
+  "showProgress": true,
+  
+  "thresholds": {
+    "maxCritical": 0,
+    "maxWarnings": 50,
+    "minHealthScore": 80
+  }
+}

package/examples/.auditrc.json

@@ -0,0 +1,201 @@
+{
+  "// Configuration for TypeScript/JavaScript Code Auditor": "",
+  "// This example shows common configuration options": "",
+  "// Remove comment lines before using this file": "",
+  
+  "// Project Settings": "",
+  "projectRoot": ".",
+  "reportTitle": "My Project Code Quality Audit",
+  
+  "// File Discovery": "",
+  "// Specify which files to include in the audit": "",
+  "includePaths": [
+    "src/**/*.{ts,tsx,js,jsx}",
+    "app/**/*.{ts,tsx,js,jsx}",
+    "lib/**/*.{ts,tsx,js,jsx}",
+    "components/**/*.{ts,tsx,js,jsx}"
+  ],
+  
+  "// Files and directories to exclude": "",
+  "excludePaths": [
+    "**/node_modules/**",
+    "**/.next/**",
+    "**/dist/**",
+    "**/build/**",
+    "**/coverage/**",
+    "**/*.test.{ts,tsx,js,jsx}",
+    "**/*.spec.{ts,tsx,js,jsx}",
+    "**/__tests__/**",
+    "**/vendor/**",
+    "**/*.min.js"
+  ],
+  
+  "// Analyzers": "",
+  "// Enable or disable specific analyzers": "",
+  "// Available: solid, dry, security, component, data-access": "",
+  "enabledAnalyzers": [
+    "solid",
+    "dry",
+    "security",
+    "component",
+    "data-access"
+  ],
+  
+  "// Analyzer-specific configuration": "",
+  "analyzerConfig": {
+    "solid": {
+      "// Maximum allowed methods per class": "",
+      "maxMethodsPerClass": 10,
+      "// Maximum lines per method": "",
+      "maxLinesPerMethod": 50,
+      "// Maximum parameters per method": "",
+      "maxParametersPerMethod": 4,
+      "// Maximum cyclomatic complexity": "",
+      "maxComplexity": 10,
+      "// Which SOLID principles to check": "",
+      "checkPatterns": {
+        "singleResponsibility": true,
+        "openClosed": true,
+        "liskovSubstitution": true,
+        "interfaceSegregation": true,
+        "dependencyInversion": true
+      }
+    },
+    
+    "dry": {
+      "// Minimum lines to consider as duplication": "",
+      "minLineThreshold": 5,
+      "// Similarity threshold (0-1)": "",
+      "similarityThreshold": 0.85,
+      "// Check for duplicate imports": "",
+      "checkImports": true,
+      "// Check for duplicate string literals": "",
+      "checkStrings": true
+    },
+    
+    "security": {
+      "// Authentication wrapper patterns to look for": "",
+      "authPatterns": [
+        "withAuth",
+        "requireAuth",
+        "isAuthenticated",
+        "useAuth"
+      ],
+      "// Admin authentication patterns": "",
+      "adminPatterns": [
+        "withAdminAuth",
+        "requireAdmin",
+        "isAdmin"
+      ],
+      "// Rate limiting patterns": "",
+      "rateLimitPatterns": [
+        "rateLimit",
+        "withRateLimit",
+        "throttle"
+      ]
+    },
+    
+    "component": {
+      "// Check for error boundaries": "",
+      "checkErrorBoundaries": true,
+      "// Check for prop type validation": "",
+      "checkPropTypes": true,
+      "// Maximum component complexity": "",
+      "maxComplexity": 15,
+      "// Maximum nesting depth": "",
+      "maxNesting": 4
+    },
+    
+    "data-access": {
+      "// Security patterns to look for": "",
+      "securityPatterns": {
+        "parameterized": ["?", "$1", ":param"],
+        "sanitized": ["sanitize", "escape", "clean"]
+      },
+      "// Performance thresholds": "",
+      "performanceThresholds": {
+        "maxJoins": 5,
+        "warnOnSelectStar": true
+      }
+    }
+  },
+  
+  "// Output Configuration": "",
+  "// Available formats: html, json, csv": "",
+  "outputFormats": ["html", "json"],
+  "outputDirectory": "./audit-reports",
+  
+  "// Report Theme (for HTML reports)": "",
+  "reportTheme": {
+    "primaryColor": "#007bff",
+    "criticalColor": "#dc3545",
+    "warningColor": "#ffc107",
+    "suggestionColor": "#17a2b8"
+  },
+  
+  "// Behavior": "",
+  "// Minimum severity level to report: critical, warning, suggestion": "",
+  "minSeverity": "suggestion",
+  "// Exit with error code if critical issues found": "",
+  "failOnCritical": false,
+  "// Show detailed progress during analysis": "",
+  "verbose": false,
+  "// Show progress indicators": "",
+  "showProgress": true,
+  
+  "// Performance": "",
+  "// Run analyzers in parallel": "",
+  "parallel": true,
+  "// Maximum concurrent operations": "",
+  "maxConcurrency": 4,
+  
+  "// Quality Thresholds": "",
+  "// Set to undefined to disable threshold": "",
+  "thresholds": {
+    "// Maximum allowed critical issues": "",
+    "maxCritical": 0,
+    "// Maximum allowed warnings": "",
+    "maxWarnings": 50,
+    "// Minimum required health score (0-100)": "",
+    "minHealthScore": 80,
+    "// Maximum allowed complexity per file": "",
+    "maxComplexity": 10,
+    "// Maximum allowed code duplication instances": "",
+    "maxDuplication": 5
+  },
+  
+  "// Custom Patterns": "",
+  "// Additional patterns for file discovery": "",
+  "customPatterns": {
+    "// Component file patterns": "",
+    "components": [
+      "**/*Component.{ts,tsx,js,jsx}",
+      "**/*Page.{ts,tsx,js,jsx}",
+      "**/*View.{ts,tsx,js,jsx}"
+    ],
+    "// API endpoint patterns": "",
+    "endpoints": [
+      "**/api/**/*.{ts,js}",
+      "**/routes/**/*.{ts,js}",
+      "**/controllers/**/*.{ts,js}"
+    ],
+    "// Test file patterns": "",
+    "tests": [
+      "**/*.test.{ts,tsx,js,jsx}",
+      "**/*.spec.{ts,tsx,js,jsx}",
+      "**/__tests__/**"
+    ]
+  },
+  
+  "// CI/CD Integration": "",
+  "integrations": {
+    "ci": {
+      "// CI provider: github, gitlab, jenkins, circleci": "",
+      "provider": "github",
+      "// Fail the build if thresholds are exceeded": "",
+      "failOnThreshold": true,
+      "// Comment on pull requests with audit results": "",
+      "commentOnPR": true
+    }
+  }
+}

package/examples/nextjs.auditrc.json

@@ -0,0 +1,65 @@
+{
+  "projectRoot": ".",
+  "reportTitle": "Next.js Project Audit",
+  
+  "includePaths": [
+    "app/**/*.{ts,tsx,js,jsx}",
+    "pages/**/*.{ts,tsx,js,jsx}",
+    "components/**/*.{ts,tsx,js,jsx}",
+    "lib/**/*.{ts,tsx,js,jsx}",
+    "utils/**/*.{ts,tsx,js,jsx}"
+  ],
+  
+  "excludePaths": [
+    "**/node_modules/**",
+    "**/.next/**",
+    "**/out/**",
+    "**/public/**",
+    "**/*.test.{ts,tsx}",
+    "**/*.spec.{ts,tsx}",
+    "**/__tests__/**",
+    "**/coverage/**"
+  ],
+  
+  "enabledAnalyzers": [
+    "component",
+    "security",
+    "solid",
+    "dry",
+    "data-access"
+  ],
+  
+  "analyzerConfig": {
+    "component": {
+      "checkErrorBoundaries": true,
+      "checkPropTypes": false,
+      "maxComplexity": 15
+    },
+    "security": {
+      "authPatterns": ["withAuth", "useSession", "getServerSession"],
+      "publicPatterns": ["public", "skipAuth"]
+    }
+  },
+  
+  "customPatterns": {
+    "components": [
+      "**/app/**/page.{ts,tsx}",
+      "**/app/**/layout.{ts,tsx}",
+      "**/pages/**/*.{ts,tsx}",
+      "**/components/**/*.{ts,tsx}"
+    ],
+    "endpoints": [
+      "**/app/api/**/route.{ts,js}",
+      "**/pages/api/**/*.{ts,js}"
+    ]
+  },
+  
+  "outputFormats": ["html"],
+  "outputDirectory": "./audit-reports",
+  
+  "thresholds": {
+    "maxCritical": 0,
+    "maxWarnings": 20,
+    "minHealthScore": 85
+  }
+}

package/examples/node-api.auditrc.json

@@ -0,0 +1,82 @@
+{
+  "projectRoot": ".",
+  "reportTitle": "Node.js API Audit",
+  
+  "includePaths": [
+    "src/**/*.{ts,js}",
+    "lib/**/*.{ts,js}",
+    "api/**/*.{ts,js}",
+    "routes/**/*.{ts,js}",
+    "controllers/**/*.{ts,js}",
+    "services/**/*.{ts,js}",
+    "models/**/*.{ts,js}"
+  ],
+  
+  "excludePaths": [
+    "**/node_modules/**",
+    "**/dist/**",
+    "**/build/**",
+    "**/*.test.{ts,js}",
+    "**/*.spec.{ts,js}",
+    "**/__tests__/**",
+    "**/coverage/**"
+  ],
+  
+  "enabledAnalyzers": [
+    "security",
+    "data-access",
+    "solid",
+    "dry"
+  ],
+  
+  "analyzerConfig": {
+    "security": {
+      "authPatterns": ["authenticate", "authorize", "requireAuth", "passport"],
+      "rateLimitPatterns": ["rateLimit", "throttle", "limiter"],
+      "securityHeaders": [
+        "helmet",
+        "cors",
+        "Content-Security-Policy"
+      ]
+    },
+    "data-access": {
+      "databasePatterns": {
+        "postgres": ["pg", "postgres"],
+        "mysql": ["mysql", "mysql2"],
+        "mongodb": ["mongodb", "mongoose"]
+      },
+      "securityPatterns": {
+        "parameterized": ["?", "$1", ":id"],
+        "sanitized": ["sanitize", "escape", "validator"]
+      },
+      "performanceThresholds": {
+        "maxJoins": 4,
+        "warnOnSelectStar": true
+      }
+    },
+    "solid": {
+      "maxMethodsPerClass": 12,
+      "maxLinesPerMethod": 60,
+      "maxParametersPerMethod": 5
+    }
+  },
+  
+  "outputFormats": ["json", "html"],
+  "outputDirectory": "./audit-reports",
+  
+  "minSeverity": "warning",
+  "failOnCritical": true,
+  
+  "thresholds": {
+    "maxCritical": 0,
+    "maxWarnings": 10,
+    "minHealthScore": 90
+  },
+  
+  "integrations": {
+    "ci": {
+      "provider": "github",
+      "failOnThreshold": true
+    }
+  }
+}