@aiready/cli 0.9.40 → 0.9.41

package/src/commands/context.ts

@@ -4,11 +4,11 @@
 
 import chalk from 'chalk';
 import { resolve as resolvePath } from 'path';
-import { 
-  loadMergedConfig, 
-  handleJSONOutput, 
-  handleCLIError, 
-  getElapsedTime, 
+import {
+  loadMergedConfig,
+  handleJSONOutput,
+  handleCLIError,
+  getElapsedTime,
   resolveOutputPath,
   formatToolScore,
 } from '@aiready/core';
@@ -25,7 +25,10 @@ interface ContextOptions {
   score?: boolean;
 }
 
-export async function contextAction(directory: string, options: ContextOptions) {
+export async function contextAction(
+  directory: string,
+  options: ContextOptions
+) {
   console.log(chalk.blue('🧠 Analyzing context costs...\n'));
 
   const startTime = Date.now();
@@ -45,9 +48,11 @@ export async function contextAction(directory: string, options: ContextOptions)
     };
 
     // Load and merge config with CLI options
-    let baseOptions = await loadMergedConfig(resolvedDir, defaults, {
+    const baseOptions = await loadMergedConfig(resolvedDir, defaults, {
       maxDepth: options.maxDepth ? parseInt(options.maxDepth) : undefined,
-      maxContextBudget: options.maxContext ? parseInt(options.maxContext) : undefined,
+      maxContextBudget: options.maxContext
+        ? parseInt(options.maxContext)
+        : undefined,
       include: options.include?.split(','),
       exclude: options.exclude?.split(','),
     });
@@ -55,32 +60,41 @@ export async function contextAction(directory: string, options: ContextOptions)
     // Apply smart defaults for context analysis (always for individual context command)
     let finalOptions: any = { ...baseOptions };
     const { getSmartDefaults } = await import('@aiready/context-analyzer');
-    const contextSmartDefaults = await getSmartDefaults(resolvedDir, baseOptions);
+    const contextSmartDefaults = await getSmartDefaults(
+      resolvedDir,
+      baseOptions
+    );
     finalOptions = { ...contextSmartDefaults, ...finalOptions };
-    
+
     // Display configuration
     console.log('📋 Configuration:');
     console.log(`   Max depth: ${finalOptions.maxDepth}`);
     console.log(`   Max context budget: ${finalOptions.maxContextBudget}`);
-    console.log(`   Min cohesion: ${(finalOptions.minCohesion * 100).toFixed(1)}%`);
-    console.log(`   Max fragmentation: ${(finalOptions.maxFragmentation * 100).toFixed(1)}%`);
+    console.log(
+      `   Min cohesion: ${(finalOptions.minCohesion * 100).toFixed(1)}%`
+    );
+    console.log(
+      `   Max fragmentation: ${(finalOptions.maxFragmentation * 100).toFixed(1)}%`
+    );
     console.log(`   Analysis focus: ${finalOptions.focus}`);
     console.log('');
 
-    const { analyzeContext, generateSummary, calculateContextScore } = await import('@aiready/context-analyzer');
+    const { analyzeContext, generateSummary, calculateContextScore } =
+      await import('@aiready/context-analyzer');
 
     const results = await analyzeContext(finalOptions);
 
     const elapsedTime = getElapsedTime(startTime);
     const summary = generateSummary(results);
-    
+
     // Calculate score if requested
     let contextScore: ToolScoringOutput | undefined;
     if (options.score) {
       contextScore = calculateContextScore(summary as any);
     }
 
-    const outputFormat = options.output || finalOptions.output?.format || 'console';
+    const outputFormat =
+      options.output || finalOptions.output?.format || 'console';
     const userOutputFile = options.outputFile || finalOptions.output?.file;
 
     if (outputFormat === 'json') {
@@ -95,8 +109,12 @@ export async function contextAction(directory: string, options: ContextOptions)
         `aiready-report-${getReportTimestamp()}.json`,
         resolvedDir
       );
-      
-      handleJSONOutput(outputData, outputPath, `✅ Results saved to ${outputPath}`);
+
+      handleJSONOutput(
+        outputData,
+        outputPath,
+        `✅ Results saved to ${outputPath}`
+      );
     } else {
       // Console output - format the results nicely
       const terminalWidth = process.stdout.columns || 80;
@@ -107,25 +125,48 @@ export async function contextAction(directory: string, options: ContextOptions)
       console.log(chalk.bold.white('  CONTEXT ANALYSIS SUMMARY'));
       console.log(chalk.cyan(divider) + '\n');
 
-      console.log(chalk.white(`📁 Files analyzed: ${chalk.bold(summary.totalFiles)}`));
-      console.log(chalk.white(`📊 Total tokens: ${chalk.bold(summary.totalTokens.toLocaleString())}`));
-      console.log(chalk.yellow(`💰 Avg context budget: ${chalk.bold(summary.avgContextBudget.toFixed(0))} tokens/file`));
-      console.log(chalk.white(`⏱  Analysis time: ${chalk.bold(elapsedTime + 's')}\n`));
+      console.log(
+        chalk.white(`📁 Files analyzed: ${chalk.bold(summary.totalFiles)}`)
+      );
+      console.log(
+        chalk.white(
+          `📊 Total tokens: ${chalk.bold(summary.totalTokens.toLocaleString())}`
+        )
+      );
+      console.log(
+        chalk.yellow(
+          `💰 Avg context budget: ${chalk.bold(summary.avgContextBudget.toFixed(0))} tokens/file`
+        )
+      );
+      console.log(
+        chalk.white(`⏱  Analysis time: ${chalk.bold(elapsedTime + 's')}\n`)
+      );
 
       // Issues summary
-      const totalIssues = summary.criticalIssues + summary.majorIssues + summary.minorIssues;
+      const totalIssues =
+        summary.criticalIssues + summary.majorIssues + summary.minorIssues;
       if (totalIssues > 0) {
         console.log(chalk.bold('⚠️  Issues Found:\n'));
         if (summary.criticalIssues > 0) {
-          console.log(chalk.red(`   🔴 Critical: ${chalk.bold(summary.criticalIssues)}`));
+          console.log(
+            chalk.red(`   🔴 Critical: ${chalk.bold(summary.criticalIssues)}`)
+          );
         }
         if (summary.majorIssues > 0) {
-          console.log(chalk.yellow(`   🟡 Major: ${chalk.bold(summary.majorIssues)}`));
+          console.log(
+            chalk.yellow(`   🟡 Major: ${chalk.bold(summary.majorIssues)}`)
+          );
         }
         if (summary.minorIssues > 0) {
-          console.log(chalk.blue(`   🔵 Minor: ${chalk.bold(summary.minorIssues)}`));
+          console.log(
+            chalk.blue(`   🔵 Minor: ${chalk.bold(summary.minorIssues)}`)
+          );
         }
-        console.log(chalk.green(`\n   💡 Potential savings: ${chalk.bold(summary.totalPotentialSavings.toLocaleString())} tokens\n`));
+        console.log(
+          chalk.green(
+            `\n   💡 Potential savings: ${chalk.bold(summary.totalPotentialSavings.toLocaleString())} tokens\n`
+          )
+        );
       } else {
         console.log(chalk.green('✅ No significant issues found!\n'));
       }
@@ -133,11 +174,17 @@ export async function contextAction(directory: string, options: ContextOptions)
       // Deep import chains
       if (summary.deepFiles.length > 0) {
         console.log(chalk.bold('📏 Deep Import Chains:\n'));
-        console.log(chalk.gray(`   Average depth: ${summary.avgImportDepth.toFixed(1)}`));
-        console.log(chalk.gray(`   Maximum depth: ${summary.maxImportDepth}\n`));
+        console.log(
+          chalk.gray(`   Average depth: ${summary.avgImportDepth.toFixed(1)}`)
+        );
+        console.log(
+          chalk.gray(`   Maximum depth: ${summary.maxImportDepth}\n`)
+        );
         summary.deepFiles.slice(0, 10).forEach((item) => {
           const fileName = item.file.split('/').slice(-2).join('/');
-          console.log(`   ${chalk.cyan('→')} ${chalk.white(fileName)} ${chalk.dim(`(depth: ${item.depth})`)}`);
+          console.log(
+            `   ${chalk.cyan('→')} ${chalk.white(fileName)} ${chalk.dim(`(depth: ${item.depth})`)}`
+          );
         });
         console.log();
       }
@@ -145,10 +192,20 @@ export async function contextAction(directory: string, options: ContextOptions)
       // Fragmented modules
       if (summary.fragmentedModules.length > 0) {
         console.log(chalk.bold('🧩 Fragmented Modules:\n'));
-        console.log(chalk.gray(`   Average fragmentation: ${(summary.avgFragmentation * 100).toFixed(0)}%\n`));
+        console.log(
+          chalk.gray(
+            `   Average fragmentation: ${(summary.avgFragmentation * 100).toFixed(0)}%\n`
+          )
+        );
         summary.fragmentedModules.slice(0, 10).forEach((module) => {
-          console.log(`   ${chalk.yellow('●')} ${chalk.white(module.domain)} - ${chalk.dim(`${module.files.length} files, ${(module.fragmentationScore * 100).toFixed(0)}% scattered`)}`);
-          console.log(chalk.dim(`     Token cost: ${module.totalTokens.toLocaleString()}, Cohesion: ${(module.avgCohesion * 100).toFixed(0)}%`));
+          console.log(
+            `   ${chalk.yellow('●')} ${chalk.white(module.domain)} - ${chalk.dim(`${module.files.length} files, ${(module.fragmentationScore * 100).toFixed(0)}% scattered`)}`
+          );
+          console.log(
+            chalk.dim(
+              `     Token cost: ${module.totalTokens.toLocaleString()}, Cohesion: ${(module.avgCohesion * 100).toFixed(0)}%`
+            )
+          );
         });
         console.log();
       }
@@ -156,12 +213,18 @@ export async function contextAction(directory: string, options: ContextOptions)
       // Low cohesion files
       if (summary.lowCohesionFiles.length > 0) {
         console.log(chalk.bold('🔀 Low Cohesion Files:\n'));
-        console.log(chalk.gray(`   Average cohesion: ${(summary.avgCohesion * 100).toFixed(0)}%\n`));
+        console.log(
+          chalk.gray(
+            `   Average cohesion: ${(summary.avgCohesion * 100).toFixed(0)}%\n`
+          )
+        );
         summary.lowCohesionFiles.slice(0, 10).forEach((item) => {
           const fileName = item.file.split('/').slice(-2).join('/');
           const scorePercent = (item.score * 100).toFixed(0);
           const color = item.score < 0.4 ? chalk.red : chalk.yellow;
-          console.log(`   ${color('○')} ${chalk.white(fileName)} ${chalk.dim(`(${scorePercent}% cohesion)`)}`);
+          console.log(
+            `   ${color('○')} ${chalk.white(fileName)} ${chalk.dim(`(${scorePercent}% cohesion)`)}`
+          );
         });
         console.log();
       }
@@ -171,12 +234,19 @@ export async function contextAction(directory: string, options: ContextOptions)
         console.log(chalk.bold('💸 Most Expensive Files (Context Budget):\n'));
         summary.topExpensiveFiles.slice(0, 10).forEach((item) => {
           const fileName = item.file.split('/').slice(-2).join('/');
-          const severityColor = item.severity === 'critical' ? chalk.red : item.severity === 'major' ? chalk.yellow : chalk.blue;
-          console.log(`   ${severityColor('●')} ${chalk.white(fileName)} ${chalk.dim(`(${item.contextBudget.toLocaleString()} tokens)`)}`);
+          const severityColor =
+            item.severity === 'critical'
+              ? chalk.red
+              : item.severity === 'major'
+                ? chalk.yellow
+                : chalk.blue;
+          console.log(
+            `   ${severityColor('●')} ${chalk.white(fileName)} ${chalk.dim(`(${item.contextBudget.toLocaleString()} tokens)`)}`
+          );
         });
         console.log();
       }
-      
+
       // Display score if calculated
       if (contextScore) {
         console.log(chalk.cyan(divider));
@@ -189,4 +259,4 @@ export async function contextAction(directory: string, options: ContextOptions)
   } catch (error) {
     handleCLIError(error, 'Context analysis');
   }
-}
+}

package/src/commands/deps-health.ts

@@ -8,7 +8,7 @@ import type { ToolScoringOutput } from '@aiready/core';
 
 export async function depsHealthAction(
   directory: string,
-  options: any,
+  options: any
 ): Promise<ToolScoringOutput | undefined> {
   const { analyzeDeps } = await import('@aiready/deps');
 
@@ -21,7 +21,8 @@ export async function depsHealthAction(
     rootDir: directory,
     include: options.include,
     exclude: options.exclude,
-    trainingCutoffYear: options.trainingCutoffYear ?? merged.trainingCutoffYear ?? 2023,
+    trainingCutoffYear:
+      options.trainingCutoffYear ?? merged.trainingCutoffYear ?? 2023,
   });
 
   const scoring: ToolScoringOutput = {
@@ -29,7 +30,11 @@ export async function depsHealthAction(
     score: report.summary.score,
     rawMetrics: report.rawData,
     factors: [],
-    recommendations: report.recommendations.map((action: string) => ({ action, estimatedImpact: 5, priority: 'medium' }))
+    recommendations: report.recommendations.map((action: string) => ({
+      action,
+      estimatedImpact: 5,
+      priority: 'medium',
+    })),
   };
 
   if (options.output === 'json') {
@@ -37,7 +42,7 @@ export async function depsHealthAction(
   }
 
   const { summary } = report;
-  const ratingColors: Record<string, Function> = {
+  const ratingColors: Record<string, (s: string) => string> = {
     excellent: chalk.green,
     good: chalk.blueBright,
     moderate: chalk.yellow,
@@ -45,9 +50,13 @@ export async function depsHealthAction(
     hazardous: chalk.bgRed.white,
   };
   const color = ratingColors[summary.rating] ?? chalk.white;
-  console.log(`  📦 Dependency Health:  ${chalk.bold(scoring.score + '/100 health')} (${color(summary.rating)})`);
+  console.log(
+    `  📦 Dependency Health:  ${chalk.bold(scoring.score + '/100 health')} (${color(summary.rating)})`
+  );
   if (report.issues.length > 0) {
-    console.log(chalk.dim(`     Found ${report.issues.length} dependency issues.`));
+    console.log(
+      chalk.dim(`     Found ${report.issues.length} dependency issues.`)
+    );
   } else {
     console.log(chalk.dim(`     Dependencies look healthy for AI assistance.`));
   }

package/src/commands/doc-drift.ts

@@ -8,7 +8,7 @@ import type { ToolScoringOutput } from '@aiready/core';
 
 export async function docDriftAction(
   directory: string,
-  options: any,
+  options: any
 ): Promise<ToolScoringOutput | undefined> {
   const { analyzeDocDrift } = await import('@aiready/doc-drift');
 
@@ -29,7 +29,11 @@ export async function docDriftAction(
     score: report.summary.score,
     rawMetrics: report.rawData,
     factors: [],
-    recommendations: report.recommendations.map((action: string) => ({ action, estimatedImpact: 5, priority: 'medium' }))
+    recommendations: report.recommendations.map((action: string) => ({
+      action,
+      estimatedImpact: 5,
+      priority: 'medium',
+    })),
   };
 
   if (options.output === 'json') {
@@ -37,7 +41,7 @@ export async function docDriftAction(
   }
 
   const { summary } = report;
-  const ratingColors: Record<string, Function> = {
+  const ratingColors: Record<string, (s: string) => string> = {
     minimal: chalk.green,
     low: chalk.cyan,
     moderate: chalk.yellow,
@@ -45,7 +49,9 @@ export async function docDriftAction(
     severe: chalk.bgRed.white,
   };
   const color = ratingColors[summary.rating] ?? chalk.white;
-  console.log(`  📝 Documentation Drift:  ${chalk.bold(100 - scoring.score + '/100 health')} (${color(summary.rating)} risk)`);
+  console.log(
+    `  📝 Documentation Drift:  ${chalk.bold(100 - scoring.score + '/100 health')} (${color(summary.rating)} risk)`
+  );
   if (report.issues.length > 0) {
     console.log(chalk.dim(`     Found ${report.issues.length} drift issues.`));
   } else {

package/src/commands/index.ts

@@ -6,8 +6,12 @@ export { scanAction, scanHelpText } from './scan';
 export { patternsAction, patternsHelpText } from './patterns';
 export { contextAction } from './context';
 export { consistencyAction } from './consistency';
-export { visualizeAction, visualizeHelpText, visualiseHelpText } from './visualize';
+export {
+  visualizeAction,
+  visualizeHelpText,
+  visualiseHelpText,
+} from './visualize';
 export { aiSignalClarityAction } from './ai-signal-clarity';
 export { agentGroundingAction } from './agent-grounding';
 export { testabilityAction } from './testability';
-export { changeAmplificationAction } from './change-amplification';
+export { changeAmplificationAction } from './change-amplification';

package/src/commands/patterns.ts

@@ -4,11 +4,11 @@
 
 import chalk from 'chalk';
 import { resolve as resolvePath } from 'path';
-import { 
-  loadMergedConfig, 
-  handleJSONOutput, 
-  handleCLIError, 
-  getElapsedTime, 
+import {
+  loadMergedConfig,
+  handleJSONOutput,
+  handleCLIError,
+  getElapsedTime,
   resolveOutputPath,
   formatToolScore,
 } from '@aiready/core';
@@ -28,7 +28,10 @@ interface PatternsOptions {
   score?: boolean;
 }
 
-export async function patternsAction(directory: string, options: PatternsOptions) {
+export async function patternsAction(
+  directory: string,
+  options: PatternsOptions
+) {
   console.log(chalk.blue('🔍 Analyzing patterns...\n'));
 
   const startTime = Date.now();
@@ -57,7 +60,9 @@ export async function patternsAction(directory: string, options: PatternsOptions
 
     // Load and merge config with CLI options
     const cliOptions: any = {
-      minSimilarity: options.similarity ? parseFloat(options.similarity) : undefined,
+      minSimilarity: options.similarity
+        ? parseFloat(options.similarity)
+        : undefined,
       minLines: options.minLines ? parseInt(options.minLines) : undefined,
       useSmartDefaults,
       include: options.include?.split(','),
@@ -72,22 +77,28 @@ export async function patternsAction(directory: string, options: PatternsOptions
       cliOptions.minSharedTokens = parseInt(options.minSharedTokens);
     }
 
-    const finalOptions = await loadMergedConfig(resolvedDir, defaults, cliOptions);
+    const finalOptions = await loadMergedConfig(
+      resolvedDir,
+      defaults,
+      cliOptions
+    );
 
-    const { analyzePatterns, generateSummary, calculatePatternScore } = await import('@aiready/pattern-detect');
+    const { analyzePatterns, generateSummary, calculatePatternScore } =
+      await import('@aiready/pattern-detect');
 
     const { results, duplicates } = await analyzePatterns(finalOptions);
 
     const elapsedTime = getElapsedTime(startTime);
     const summary = generateSummary(results);
-    
+
     // Calculate score if requested
     let patternScore: ToolScoringOutput | undefined;
     if (options.score) {
       patternScore = calculatePatternScore(duplicates, results.length);
     }
 
-    const outputFormat = options.output || finalOptions.output?.format || 'console';
+    const outputFormat =
+      options.output || finalOptions.output?.format || 'console';
     const userOutputFile = options.outputFile || finalOptions.output?.file;
 
     if (outputFormat === 'json') {
@@ -102,22 +113,38 @@ export async function patternsAction(directory: string, options: PatternsOptions
         `aiready-report-${getReportTimestamp()}.json`,
         resolvedDir
       );
-      
-      handleJSONOutput(outputData, outputPath, `✅ Results saved to ${outputPath}`);
+
+      handleJSONOutput(
+        outputData,
+        outputPath,
+        `✅ Results saved to ${outputPath}`
+      );
     } else {
       // Console output - format to match standalone CLI
       const terminalWidth = process.stdout.columns || 80;
       const dividerWidth = Math.min(60, terminalWidth - 2);
       const divider = '━'.repeat(dividerWidth);
-      
+
       console.log(chalk.cyan(divider));
       console.log(chalk.bold.white('  PATTERN ANALYSIS SUMMARY'));
       console.log(chalk.cyan(divider) + '\n');
 
-      console.log(chalk.white(`📁 Files analyzed: ${chalk.bold(results.length)}`));
-      console.log(chalk.yellow(`⚠  Duplicate patterns found: ${chalk.bold(summary.totalPatterns)}`));
-      console.log(chalk.red(`💰 Token cost (wasted): ${chalk.bold(summary.totalTokenCost.toLocaleString())}`));
-      console.log(chalk.gray(`⏱  Analysis time: ${chalk.bold(elapsedTime + 's')}`));
+      console.log(
+        chalk.white(`📁 Files analyzed: ${chalk.bold(results.length)}`)
+      );
+      console.log(
+        chalk.yellow(
+          `⚠  Duplicate patterns found: ${chalk.bold(summary.totalPatterns)}`
+        )
+      );
+      console.log(
+        chalk.red(
+          `💰 Token cost (wasted): ${chalk.bold(summary.totalTokenCost.toLocaleString())}`
+        )
+      );
+      console.log(
+        chalk.gray(`⏱  Analysis time: ${chalk.bold(elapsedTime + 's')}`)
+      );
 
       // Show breakdown by pattern type
       const sortedTypes = Object.entries(summary.patternsByType || {})
@@ -145,18 +172,32 @@ export async function patternsAction(directory: string, options: PatternsOptions
           .slice(0, 10);
 
         topDuplicates.forEach((dup) => {
-          const severity = dup.similarity > 0.95 ? 'CRITICAL' : dup.similarity > 0.9 ? 'HIGH' : 'MEDIUM';
-          const severityIcon = dup.similarity > 0.95 ? '🔴' : dup.similarity > 0.9 ? '🟡' : '🔵';
+          const severity =
+            dup.similarity > 0.95
+              ? 'CRITICAL'
+              : dup.similarity > 0.9
+                ? 'HIGH'
+                : 'MEDIUM';
+          const severityIcon =
+            dup.similarity > 0.95 ? '🔴' : dup.similarity > 0.9 ? '🟡' : '🔵';
           const file1Name = dup.file1.split('/').pop() || dup.file1;
           const file2Name = dup.file2.split('/').pop() || dup.file2;
-          console.log(`${severityIcon} ${severity}: ${chalk.bold(file1Name)} ↔ ${chalk.bold(file2Name)}`);
-          console.log(`   Similarity: ${chalk.bold(Math.round(dup.similarity * 100) + '%')} | Wasted: ${chalk.bold(dup.tokenCost.toLocaleString())} tokens each`);
-          console.log(`   Lines: ${chalk.cyan(dup.line1 + '-' + dup.endLine1)} ↔ ${chalk.cyan(dup.line2 + '-' + dup.endLine2)}\n`);
+          console.log(
+            `${severityIcon} ${severity}: ${chalk.bold(file1Name)} ↔ ${chalk.bold(file2Name)}`
+          );
+          console.log(
+            `   Similarity: ${chalk.bold(Math.round(dup.similarity * 100) + '%')} | Wasted: ${chalk.bold(dup.tokenCost.toLocaleString())} tokens each`
+          );
+          console.log(
+            `   Lines: ${chalk.cyan(dup.line1 + '-' + dup.endLine1)} ↔ ${chalk.cyan(dup.line2 + '-' + dup.endLine2)}\n`
+          );
         });
       } else {
-        console.log(chalk.green('\n✨ Great! No duplicate patterns detected.\n'));
+        console.log(
+          chalk.green('\n✨ Great! No duplicate patterns detected.\n')
+        );
       }
-      
+
       // Display score if calculated
       if (patternScore) {
         console.log(chalk.cyan(divider));
@@ -176,4 +217,4 @@ EXAMPLES:
   $ aiready patterns                                 # Default analysis
   $ aiready patterns --similarity 0.6               # Stricter matching
   $ aiready patterns --min-lines 10                 # Larger patterns only
-`;
+`;