feat: Add --force-refresh flag to bypass npm cache

- Added forceRefresh option to CLI
- When flag is set, npm outdated/audit cache is ignored
- Useful when you know dependencies changed
- All 72 tests passing

Author: Dev Optimizer Bot

src/analyzers/DepsAnalyzer.ts

@@ -19,6 +19,7 @@ interface DepsAnalyzerOptions {
   mode?: 'quick' | 'full' | 'deep';
   runNpmOutdated?: boolean;
   runNpmAudit?: boolean;
+  forceRefresh?: boolean;
 }
 
 interface KnipResult {
@@ -826,8 +827,8 @@ export class DepsAnalyzer implements Analyzer {
       // Ignore errors
     }
 
-    // Check cache first (24h TTL)
-    let outdated: Record<string, any> | null = getCachedOutdated(projectPath);
+    // Check cache first (24h TTL), skip if forceRefresh
+    let outdated: Record<string, any> | null = this.options.forceRefresh ? null : getCachedOutdated(projectPath);
 
     // Run npm outdated if no cache
     if (!outdated) {
@@ -923,8 +924,8 @@ export class DepsAnalyzer implements Analyzer {
 
     const findings: Finding[] = [];
 
-    // Check cache first (6h TTL)
-    let audit: any = getCachedAudit(projectPath);
+    // Check cache first (6h TTL), skip if forceRefresh
+    let audit: any = this.options.forceRefresh ? null : getCachedAudit(projectPath);
 
     // Run npm audit if no cache
     if (!audit) {

src/commands/analyze.ts

@@ -24,6 +24,7 @@ interface AnalyzeOptions {
   top: number;
   quick?: boolean;
   deep?: boolean;
+  forceRefresh?: boolean;
   verbose?: boolean;
   quiet?: boolean;
 }
@@ -60,7 +61,7 @@ export async function analyzeCommand(options: AnalyzeOptions): Promise<void> {
   // Initialize analyzers - pass mode based on quick option
   const analyzerMode = options.quick ? 'quick' : 'full';
   const dockerAnalyzer = new DockerAnalyzer({ mode: analyzerMode });
-  const depsAnalyzer = new DepsAnalyzer({ mode: analyzerMode });
+  const depsAnalyzer = new DepsAnalyzer({ mode: analyzerMode, forceRefresh: options.forceRefresh });
   const ciAnalyzer = new CiAnalyzer();
 
   const allFindings: Finding[] = [];

src/index.ts

@@ -25,6 +25,7 @@ program
   .option('--top <n>', 'Show top N findings', '5')
   .option('--quick', 'Quick mode - fast analysis without npm commands', false)
   .option('--deep', 'Deep mode - thorough analysis with size estimates', false)
+  .option('--force-refresh', 'Force refresh - ignore npm cache', false)
   .option('--verbose', 'Verbose output - show more details', false)
   .option('--quiet', 'Quiet mode - minimal output', false)
   .action(analyzeCommand);