node-janitor 1.0.1 → 1.2.0

package/dist/commands/watch.d.ts

@@ -0,0 +1,57 @@
+import type { NodeModulesInfo } from '../types/index.js';
+export interface WatchOptions {
+    path: string;
+    depth?: number;
+    olderThan?: string;
+    dryRun?: boolean;
+    interval?: number;
+    onClean?: boolean;
+}
+export interface WatchState {
+    isWatching: boolean;
+    lastScan: Date | null;
+    foldersFound: number;
+    totalCleaned: number;
+    totalFreed: number;
+}
+/**
+ * Create initial watch state
+ */
+export declare function createInitialWatchState(): WatchState;
+/**
+ * Parse watch interval with default
+ */
+export declare function parseWatchInterval(interval?: number): number;
+/**
+ * Parse olderThan to days
+ */
+export declare function parseOlderThanDays(olderThan?: string): number | undefined;
+/**
+ * Start watching a directory for node_modules folders
+ */
+export declare function startWatch(options: WatchOptions): Promise<void>;
+/**
+ * Perform a scan and optionally clean (exported for testing)
+ */
+export declare function performScan(watchPath: string, options: WatchOptions, olderThanDays: number | undefined, state: WatchState): Promise<{
+    found: number;
+    cleaned: number;
+    freed: number;
+}>;
+/**
+ * Auto-clean found folders (exported for testing)
+ */
+export declare function performAutoClean(folders: NodeModulesInfo[], state: WatchState): Promise<{
+    cleaned: number;
+    freed: number;
+}>;
+declare const _default: {
+    startWatch: typeof startWatch;
+    performScan: typeof performScan;
+    performAutoClean: typeof performAutoClean;
+    createInitialWatchState: typeof createInitialWatchState;
+    parseWatchInterval: typeof parseWatchInterval;
+    parseOlderThanDays: typeof parseOlderThanDays;
+};
+export default _default;
+//# sourceMappingURL=watch.d.ts.map

package/dist/commands/watch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"watch.d.ts","sourceRoot":"","sources":["../../src/commands/watch.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAEzD,MAAM,WAAW,YAAY;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,OAAO,CAAC;CACrB;AAED,MAAM,WAAW,UAAU;IACvB,UAAU,EAAE,OAAO,CAAC;IACpB,QAAQ,EAAE,IAAI,GAAG,IAAI,CAAC;IACtB,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;CACtB;AAED;;GAEG;AACH,wBAAgB,uBAAuB,IAAI,UAAU,CAQpD;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,CAE5D;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAEzE;AAED;;GAEG;AACH,wBAAsB,UAAU,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CAsCrE;AAED;;GAEG;AACH,wBAAsB,WAAW,CAC7B,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,YAAY,EACrB,aAAa,EAAE,MAAM,GAAG,SAAS,EACjC,KAAK,EAAE,UAAU,GAClB,OAAO,CAAC;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC,CA8C5D;AAED;;GAEG;AACH,wBAAsB,gBAAgB,CAClC,OAAO,EAAE,eAAe,EAAE,EAC1B,KAAK,EAAE,UAAU,GAClB,OAAO,CAAC;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC,CAa7C;;;;;;;;;AAED,wBAOE"}

package/dist/commands/watch.js

@@ -0,0 +1,138 @@
+import path from 'path';
+import { scanNodeModules, calculateTotals } from '../core/scanner.js';
+import { cleanNodeModules } from '../core/cleaner.js';
+import { formatBytes, parseDuration } from '../utils/formatter.js';
+import logger from '../utils/logger.js';
+import chalk from 'chalk';
+/**
+ * Create initial watch state
+ */
+export function createInitialWatchState() {
+    return {
+        isWatching: true,
+        lastScan: null,
+        foldersFound: 0,
+        totalCleaned: 0,
+        totalFreed: 0,
+    };
+}
+/**
+ * Parse watch interval with default
+ */
+export function parseWatchInterval(interval) {
+    return interval || 60000; // Default 1 minute
+}
+/**
+ * Parse olderThan to days
+ */
+export function parseOlderThanDays(olderThan) {
+    return olderThan ? parseDuration(olderThan) : undefined;
+}
+/**
+ * Start watching a directory for node_modules folders
+ */
+export async function startWatch(options) {
+    const watchPath = path.resolve(options.path);
+    const interval = parseWatchInterval(options.interval);
+    const olderThanDays = parseOlderThanDays(options.olderThan);
+    const state = createInitialWatchState();
+    console.log(chalk.cyan('🔄 Watch Mode Started'));
+    console.log(chalk.gray(`Watching: ${watchPath}`));
+    console.log(chalk.gray(`Interval: ${interval / 1000}s`));
+    if (olderThanDays) {
+        console.log(chalk.gray(`Age filter: >${olderThanDays} days`));
+    }
+    if (options.onClean) {
+        console.log(chalk.yellow('⚠️  Auto-clean enabled'));
+    }
+    console.log(chalk.gray('Press Ctrl+C to stop\n'));
+    // Initial scan
+    await performScan(watchPath, options, olderThanDays, state);
+    // Set up interval for periodic scanning
+    const intervalId = setInterval(async () => {
+        await performScan(watchPath, options, olderThanDays, state);
+    }, interval);
+    // Handle graceful shutdown
+    process.on('SIGINT', () => {
+        clearInterval(intervalId);
+        console.log();
+        logger.success('Watch mode stopped');
+        console.log(chalk.gray(`Total cleaned: ${state.totalCleaned} folders`));
+        console.log(chalk.gray(`Total freed: ${formatBytes(state.totalFreed)}`));
+        process.exit(0);
+    });
+    // Keep the process running
+    await new Promise(() => { }); // Never resolves, wait for SIGINT
+}
+/**
+ * Perform a scan and optionally clean (exported for testing)
+ */
+export async function performScan(watchPath, options, olderThanDays, state) {
+    const timestamp = new Date().toLocaleTimeString();
+    process.stdout.write(chalk.gray(`[${timestamp}] Scanning... `));
+    try {
+        let folders = await scanNodeModules({
+            path: watchPath,
+            depth: options.depth,
+            quick: true, // Use quick mode for watching
+        });
+        // Apply age filter
+        if (olderThanDays !== undefined) {
+            folders = folders.filter(f => f.ageDays >= olderThanDays);
+        }
+        state.lastScan = new Date();
+        state.foldersFound = folders.length;
+        if (folders.length === 0) {
+            console.log(chalk.green('✓ No matching folders'));
+            return { found: 0, cleaned: 0, freed: 0 };
+        }
+        const totals = calculateTotals(folders);
+        console.log(chalk.yellow(`Found ${folders.length} folders (${formatBytes(totals.totalSize)})`));
+        // Auto-clean if enabled
+        if (options.onClean && !options.dryRun) {
+            const cleanResult = await performAutoClean(folders, state);
+            return { found: folders.length, ...cleanResult };
+        }
+        else {
+            // Just list folders
+            folders.slice(0, 5).forEach(f => {
+                console.log(chalk.gray(`  → ${f.projectPath} (${f.ageDays}d)`));
+            });
+            if (folders.length > 5) {
+                console.log(chalk.gray(`  ... and ${folders.length - 5} more`));
+            }
+            return { found: folders.length, cleaned: 0, freed: 0 };
+        }
+    }
+    catch (error) {
+        console.log(chalk.red('✗ Scan failed'));
+        logger.debug(error instanceof Error ? error.message : String(error));
+        return { found: 0, cleaned: 0, freed: 0 };
+    }
+}
+/**
+ * Auto-clean found folders (exported for testing)
+ */
+export async function performAutoClean(folders, state) {
+    try {
+        const result = await cleanNodeModules(folders, { fast: true });
+        state.totalCleaned += result.deletedCount;
+        state.totalFreed += result.freedBytes;
+        console.log(chalk.green(`  ✓ Cleaned ${result.deletedCount} folders (${formatBytes(result.freedBytes)})`));
+        return { cleaned: result.deletedCount, freed: result.freedBytes };
+    }
+    catch (error) {
+        console.log(chalk.red('  ✗ Clean failed'));
+        logger.debug(error instanceof Error ? error.message : String(error));
+        return { cleaned: 0, freed: 0 };
+    }
+}
+export default {
+    startWatch,
+    performScan,
+    performAutoClean,
+    createInitialWatchState,
+    parseWatchInterval,
+    parseOlderThanDays,
+};
+//# sourceMappingURL=watch.js.map

package/dist/commands/watch.js.map

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

package/dist/core/config.d.ts

@@ -0,0 +1,21 @@
+import type { Config } from '../types/index.js';
+/**
+ * Load configuration from .janitorrc, .janitorrc.json, .janitorrc.yaml,
+ * janitor.config.js, or package.json "janitor" key
+ */
+export declare function loadConfig(configPath?: string): Promise<Config>;
+/**
+ * Get default configuration
+ */
+export declare function getDefaultConfig(): Config;
+/**
+ * Merge CLI options with config file options (CLI takes precedence)
+ */
+export declare function mergeOptions(cliOptions: Record<string, unknown>, config: Config): Record<string, unknown>;
+declare const _default: {
+    loadConfig: typeof loadConfig;
+    getDefaultConfig: typeof getDefaultConfig;
+    mergeOptions: typeof mergeOptions;
+};
+export default _default;
+//# sourceMappingURL=config.d.ts.map

package/dist/core/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/core/config.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAKhD;;;GAGG;AACH,wBAAsB,UAAU,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAgCrE;AAED;;GAEG;AACH,wBAAgB,gBAAgB,IAAI,MAAM,CASzC;AAwBD;;GAEG;AACH,wBAAgB,YAAY,CACxB,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACnC,MAAM,EAAE,MAAM,GACf,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CA0BzB;;;;;;AAED,wBAIE"}

package/dist/core/config.js

@@ -0,0 +1,103 @@
+import { cosmiconfig } from 'cosmiconfig';
+import logger from '../utils/logger.js';
+const MODULE_NAME = 'janitor';
+/**
+ * Load configuration from .janitorrc, .janitorrc.json, .janitorrc.yaml,
+ * janitor.config.js, or package.json "janitor" key
+ */
+export async function loadConfig(configPath) {
+    const explorer = cosmiconfig(MODULE_NAME, {
+        searchPlaces: [
+            'package.json',
+            `.${MODULE_NAME}rc`,
+            `.${MODULE_NAME}rc.json`,
+            `.${MODULE_NAME}rc.yaml`,
+            `.${MODULE_NAME}rc.yml`,
+            `.${MODULE_NAME}rc.js`,
+            `.${MODULE_NAME}rc.cjs`,
+            `${MODULE_NAME}.config.js`,
+            `${MODULE_NAME}.config.cjs`,
+        ],
+    });
+    try {
+        let result;
+        if (configPath) {
+            result = await explorer.load(configPath);
+        }
+        else {
+            result = await explorer.search();
+        }
+        if (result && result.config) {
+            logger.debug(`Loaded config from: ${result.filepath}`);
+            return validateConfig(result.config);
+        }
+    }
+    catch (error) {
+        logger.debug(`Config load error: ${error instanceof Error ? error.message : String(error)}`);
+    }
+    return getDefaultConfig();
+}
+/**
+ * Get default configuration
+ */
+export function getDefaultConfig() {
+    return {
+        exclude: [],
+        excludePattern: [],
+        defaultOlderThan: undefined,
+        defaultPath: undefined,
+        defaultDepth: undefined,
+        lang: 'en',
+    };
+}
+/**
+ * Validate and normalize config
+ */
+function validateConfig(config) {
+    const defaultConfig = getDefaultConfig();
+    if (typeof config !== 'object' || config === null) {
+        return defaultConfig;
+    }
+    const cfg = config;
+    return {
+        exclude: Array.isArray(cfg.exclude) ? cfg.exclude.filter(s => typeof s === 'string') : defaultConfig.exclude,
+        excludePattern: Array.isArray(cfg.excludePattern) ? cfg.excludePattern.filter(s => typeof s === 'string') : defaultConfig.excludePattern,
+        defaultOlderThan: typeof cfg.defaultOlderThan === 'string' ? cfg.defaultOlderThan : defaultConfig.defaultOlderThan,
+        defaultPath: typeof cfg.defaultPath === 'string' ? cfg.defaultPath : defaultConfig.defaultPath,
+        defaultDepth: typeof cfg.defaultDepth === 'number' ? cfg.defaultDepth : defaultConfig.defaultDepth,
+        lang: typeof cfg.lang === 'string' ? cfg.lang : defaultConfig.lang,
+    };
+}
+/**
+ * Merge CLI options with config file options (CLI takes precedence)
+ */
+export function mergeOptions(cliOptions, config) {
+    const merged = { ...cliOptions };
+    // Apply config defaults only if CLI option is not provided
+    if (!merged.path && config.defaultPath) {
+        merged.path = config.defaultPath;
+    }
+    if (!merged.depth && config.defaultDepth) {
+        merged.depth = config.defaultDepth;
+    }
+    if (!merged.olderThan && config.defaultOlderThan) {
+        merged.olderThan = config.defaultOlderThan;
+    }
+    if (!merged.lang && config.lang) {
+        merged.lang = config.lang;
+    }
+    // Merge exclude patterns
+    if (config.exclude && config.exclude.length > 0) {
+        const cliExclude = merged.exclude || '';
+        const cliPatterns = cliExclude ? cliExclude.split(',').map(s => s.trim()) : [];
+        const allPatterns = [...new Set([...cliPatterns, ...config.exclude])];
+        merged.exclude = allPatterns.join(',');
+    }
+    return merged;
+}
+export default {
+    loadConfig,
+    getDefaultConfig,
+    mergeOptions,
+};
+//# sourceMappingURL=config.js.map

package/dist/core/config.js.map

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

package/dist/core/fast-scanner.d.ts

@@ -0,0 +1,16 @@
+import type { NodeModulesInfo, ScanOptions } from '../types/index.js';
+/**
+ * Ultra-fast scanner using native OS commands
+ * Uses `find` on Unix for blazing fast directory discovery
+ */
+export declare function scanNodeModulesFast(options: ScanOptions, onProgress?: (current: number, found: number, path: string) => void): Promise<NodeModulesInfo[]>;
+/**
+ * Use native find command for blazing fast discovery
+ */
+declare function findNodeModulesNative(startPath: string, maxDepth?: number): string[];
+declare const _default: {
+    scanNodeModulesFast: typeof scanNodeModulesFast;
+    findNodeModulesNative: typeof findNodeModulesNative;
+};
+export default _default;
+//# sourceMappingURL=fast-scanner.d.ts.map

package/dist/core/fast-scanner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fast-scanner.d.ts","sourceRoot":"","sources":["../../src/core/fast-scanner.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAUtE;;;GAGG;AACH,wBAAsB,mBAAmB,CACrC,OAAO,EAAE,WAAW,EACpB,UAAU,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,KAAK,IAAI,GACpE,OAAO,CAAC,eAAe,EAAE,CAAC,CA8E5B;AAED;;GAEG;AACH,iBAAS,qBAAqB,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CA4B7E;;;;;AAsDD,wBAGE"}

package/dist/core/fast-scanner.js

@@ -0,0 +1,150 @@
+import { execSync } from 'child_process';
+import path from 'path';
+import pLimit from 'p-limit';
+import { getFolderSizeFast, getLastModified, countPackages, fileExists, } from '../utils/fs-utils.js';
+import { getAgeDays } from '../utils/formatter.js';
+import logger from '../utils/logger.js';
+/**
+ * Ultra-fast scanner using native OS commands
+ * Uses `find` on Unix for blazing fast directory discovery
+ */
+export async function scanNodeModulesFast(options, onProgress) {
+    const startPath = path.resolve(options.path);
+    logger.debug(`Fast scan starting from: ${startPath}`);
+    // Use native find command for discovery
+    const nodeModulesPaths = findNodeModulesNative(startPath, options.depth);
+    logger.debug(`Found ${nodeModulesPaths.length} node_modules via native find`);
+    if (nodeModulesPaths.length === 0) {
+        return [];
+    }
+    // Apply exclusion patterns and skip hidden/system folders
+    let filteredPaths = nodeModulesPaths.filter(p => {
+        // Skip paths containing hidden folders (starting with .)
+        const parts = p.split(path.sep);
+        const hasHidden = parts.some(part => part.startsWith('.') && part !== '.' && part !== '..');
+        if (hasHidden)
+            return false;
+        // Skip system folders
+        const skipFolders = ['Library', 'Applications', '.Trash', '.npm', '.yarn', '.pnpm-store'];
+        const hasSystemFolder = parts.some(part => skipFolders.includes(part));
+        if (hasSystemFolder)
+            return false;
+        return true;
+    });
+    // Apply user exclusion patterns
+    if (options.excludePatterns && options.excludePatterns.length > 0) {
+        filteredPaths = filteredPaths.filter(p => {
+            return !options.excludePatterns.some(pattern => {
+                if (pattern.includes('*')) {
+                    const regex = new RegExp(pattern.replace(/\*/g, '.*'));
+                    return regex.test(p);
+                }
+                return p.includes(pattern);
+            });
+        });
+    }
+    // Collect metadata in parallel
+    const limit = pLimit(10); // 10 concurrent operations
+    const results = [];
+    let completed = 0;
+    const promises = filteredPaths.map(nodeModulesPath => limit(async () => {
+        const projectPath = path.dirname(nodeModulesPath);
+        const info = await getNodeModulesInfoFast(nodeModulesPath, projectPath, options.quick);
+        completed++;
+        onProgress?.(completed, filteredPaths.length, projectPath);
+        return info;
+    }));
+    const collected = await Promise.all(promises);
+    results.push(...collected);
+    // Apply include pattern filter
+    let finalResults = results;
+    if (options.includePatterns && options.includePatterns.length > 0) {
+        finalResults = results.filter(folder => {
+            return options.includePatterns.some(pattern => {
+                if (pattern.includes('*')) {
+                    const regex = new RegExp(pattern.replace(/\*/g, '.*'));
+                    return regex.test(folder.projectPath) || regex.test(folder.path);
+                }
+                return folder.projectPath.includes(pattern) || folder.path.includes(pattern);
+            });
+        });
+    }
+    // Sort by size descending
+    finalResults.sort((a, b) => b.size - a.size);
+    return finalResults;
+}
+/**
+ * Use native find command for blazing fast discovery
+ */
+function findNodeModulesNative(startPath, maxDepth) {
+    try {
+        // Build find command
+        let cmd;
+        const depthArg = maxDepth !== undefined ? `-maxdepth ${maxDepth + 1}` : '';
+        if (process.platform === 'win32') {
+            // Windows: use dir command
+            cmd = `dir /s /b /ad "${startPath}" 2>nul | findstr /i "\\\\node_modules$"`;
+        }
+        else {
+            // Unix: use find with prune for efficiency
+            cmd = `find "${startPath}" ${depthArg} -type d -name "node_modules" -prune 2>/dev/null`;
+        }
+        const output = execSync(cmd, {
+            encoding: 'utf-8',
+            maxBuffer: 100 * 1024 * 1024, // 100MB buffer
+            timeout: 60000, // 60s timeout
+        });
+        return output
+            .trim()
+            .split('\n')
+            .filter(line => line.length > 0);
+    }
+    catch (error) {
+        logger.debug(`Native find failed, falling back to JS: ${error}`);
+        return [];
+    }
+}
+/**
+ * Get folder info with optimized parallel operations
+ */
+async function getNodeModulesInfoFast(nodeModulesPath, projectPath, quick = false) {
+    // Run independent operations in parallel
+    const [lastModified, hasPackageLock, hasYarnLock, hasPnpmLock,] = await Promise.all([
+        getLastModified(nodeModulesPath),
+        fileExists(path.join(projectPath, 'package-lock.json')),
+        fileExists(path.join(projectPath, 'yarn.lock')),
+        fileExists(path.join(projectPath, 'pnpm-lock.yaml')),
+    ]);
+    const ageDays = getAgeDays(lastModified);
+    // Size and package count - only if needed
+    let size = 0;
+    let packageCount = 0;
+    if (!quick) {
+        // Run size and package count in parallel
+        [size, packageCount] = await Promise.all([
+            getFolderSizeFast(nodeModulesPath),
+            countPackages(nodeModulesPath),
+        ]);
+    }
+    else {
+        // Quick mode: only get package count (fast)
+        packageCount = await countPackages(nodeModulesPath);
+    }
+    return {
+        path: nodeModulesPath,
+        projectPath,
+        size,
+        lastModified,
+        packageCount,
+        hasPackageLock,
+        hasYarnLock,
+        hasPnpmLock,
+        ageDays,
+        // Skip git status in fast mode - it's expensive
+    };
+}
+export default {
+    scanNodeModulesFast,
+    findNodeModulesNative,
+};
+//# sourceMappingURL=fast-scanner.js.map

package/dist/core/fast-scanner.js.map

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

package/dist/core/scanner.d.ts

@@ -1,6 +1,7 @@
 import type { NodeModulesInfo, ScanOptions } from '../types/index.js';
 /**
  * Scan for node_modules folders
+ * Uses fast native scanner by default, falls back to JS scanner on error
  */
 export declare function scanNodeModules(options: ScanOptions, onProgress?: (current: number, found: number, path: string) => void): Promise<NodeModulesInfo[]>;
 /**
@@ -15,6 +16,10 @@ export declare function filterBySize(folders: NodeModulesInfo[], minSize?: numbe
  * Filter folders that have lockfile
  */
 export declare function filterWithLockfile(folders: NodeModulesInfo[]): NodeModulesInfo[];
+/**
+ * Filter folders by git status (skip dirty repos)
+ */
+export declare function filterByGitStatus(folders: NodeModulesInfo[], skipDirty?: boolean, onlyInGitRepo?: boolean): NodeModulesInfo[];
 /**
  * Calculate totals
  */
@@ -28,6 +33,7 @@ declare const _default: {
     scanNodeModules: typeof scanNodeModules;
     filterByAge: typeof filterByAge;
     filterBySize: typeof filterBySize;
+    filterByGitStatus: typeof filterByGitStatus;
     filterWithLockfile: typeof filterWithLockfile;
     calculateTotals: typeof calculateTotals;
 };

package/dist/core/scanner.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"scanner.d.ts","sourceRoot":"","sources":["../../src/core/scanner.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAwBtE;;GAEG;AACH,wBAAsB,eAAe,CACjC,OAAO,EAAE,WAAW,EACpB,UAAU,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,KAAK,IAAI,GACpE,OAAO,CAAC,eAAe,EAAE,CAAC,CA2F5B;AA2CD;;GAEG;AACH,wBAAgB,WAAW,CACvB,OAAO,EAAE,eAAe,EAAE,EAC1B,UAAU,CAAC,EAAE,MAAM,EACnB,UAAU,CAAC,EAAE,MAAM,GACpB,eAAe,EAAE,CAUnB;AAED;;GAEG;AACH,wBAAgB,YAAY,CACxB,OAAO,EAAE,eAAe,EAAE,EAC1B,OAAO,CAAC,EAAE,MAAM,EAChB,OAAO,CAAC,EAAE,MAAM,GACjB,eAAe,EAAE,CAUnB;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,eAAe,EAAE,GAAG,eAAe,EAAE,CAIhF;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,eAAe,EAAE,GAAG;IACzD,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACrB,CAYA;;;;;;;;AAED,wBAME"}
+{"version":3,"file":"scanner.d.ts","sourceRoot":"","sources":["../../src/core/scanner.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AA0BtE;;;GAGG;AACH,wBAAsB,eAAe,CACjC,OAAO,EAAE,WAAW,EACpB,UAAU,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,KAAK,IAAI,GACpE,OAAO,CAAC,eAAe,EAAE,CAAC,CAe5B;AAkJD;;GAEG;AACH,wBAAgB,WAAW,CACvB,OAAO,EAAE,eAAe,EAAE,EAC1B,UAAU,CAAC,EAAE,MAAM,EACnB,UAAU,CAAC,EAAE,MAAM,GACpB,eAAe,EAAE,CAUnB;AAED;;GAEG;AACH,wBAAgB,YAAY,CACxB,OAAO,EAAE,eAAe,EAAE,EAC1B,OAAO,CAAC,EAAE,MAAM,EAChB,OAAO,CAAC,EAAE,MAAM,GACjB,eAAe,EAAE,CAUnB;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,eAAe,EAAE,GAAG,eAAe,EAAE,CAIhF;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAC7B,OAAO,EAAE,eAAe,EAAE,EAC1B,SAAS,UAAQ,EACjB,aAAa,UAAQ,GACtB,eAAe,EAAE,CAUnB;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,eAAe,EAAE,GAAG;IACzD,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACrB,CAYA;;;;;;;;;AAED,wBAOE"}

package/dist/core/scanner.js

@@ -2,7 +2,9 @@ import fs from 'fs-extra';
 import path from 'path';
 import { getFolderSizeFast, getLastModified, countPackages, fileExists, } from '../utils/fs-utils.js';
 import { getAgeDays } from '../utils/formatter.js';
+import { getGitStatus } from '../utils/git-utils.js';
 import logger from '../utils/logger.js';
+import { scanNodeModulesFast } from './fast-scanner.js';
 // Folders to skip when scanning
 const SKIP_FOLDERS = new Set([
     '.git',
@@ -18,8 +20,28 @@ const SKIP_FOLDERS = new Set([
 ]);
 /**
  * Scan for node_modules folders
+ * Uses fast native scanner by default, falls back to JS scanner on error
  */
 export async function scanNodeModules(options, onProgress) {
+    // Try fast scanner first (uses native find command)
+    try {
+        const fastResults = await scanNodeModulesFast(options, onProgress);
+        if (fastResults.length > 0 || options.quick) {
+            return fastResults;
+        }
+        // If no results, try JS scanner as fallback
+        logger.debug('Fast scanner returned 0 results, trying JS scanner');
+    }
+    catch (error) {
+        logger.debug(`Fast scanner failed, using JS fallback: ${error}`);
+    }
+    // Fallback to JS scanner
+    return scanNodeModulesJS(options, onProgress);
+}
+/**
+ * Original JS-based scanner (fallback)
+ */
+async function scanNodeModulesJS(options, onProgress) {
     const results = [];
     let scannedCount = 0;
     async function scan(dir, depth) {
@@ -116,6 +138,8 @@ async function getNodeModulesInfo(nodeModulesPath, projectPath, quick = false) {
         fileExists(path.join(projectPath, 'yarn.lock')),
         fileExists(path.join(projectPath, 'pnpm-lock.yaml')),
     ]);
+    // Get git status
+    const gitStatus = await getGitStatus(projectPath);
     return {
         path: nodeModulesPath,
         projectPath,
@@ -126,6 +150,7 @@ async function getNodeModulesInfo(nodeModulesPath, projectPath, quick = false) {
         hasYarnLock,
         hasPnpmLock,
         ageDays,
+        gitStatus,
     };
 }
 /**
@@ -162,6 +187,20 @@ export function filterBySize(folders, minSize, maxSize) {
 export function filterWithLockfile(folders) {
     return folders.filter(folder => folder.hasPackageLock || folder.hasYarnLock || folder.hasPnpmLock);
 }
+/**
+ * Filter folders by git status (skip dirty repos)
+ */
+export function filterByGitStatus(folders, skipDirty = false, onlyInGitRepo = false) {
+    return folders.filter(folder => {
+        if (onlyInGitRepo && !folder.gitStatus?.isGitRepo) {
+            return false;
+        }
+        if (skipDirty && folder.gitStatus?.isDirty) {
+            return false;
+        }
+        return true;
+    });
+}
 /**
  * Calculate totals
  */
@@ -180,6 +219,7 @@ export default {
     scanNodeModules,
     filterByAge,
     filterBySize,
+    filterByGitStatus,
     filterWithLockfile,
     calculateTotals,
 };