@aiready/cli 0.9.27 → 0.9.29

package/src/commands/consistency.ts

@@ -0,0 +1,192 @@
+/**
+ * Consistency command - Check naming conventions and architectural consistency
+ */
+
+import chalk from 'chalk';
+import { writeFileSync } from 'fs';
+import { resolve as resolvePath } from 'path';
+import { 
+  loadMergedConfig, 
+  handleJSONOutput, 
+  handleCLIError, 
+  getElapsedTime, 
+  resolveOutputPath,
+  formatToolScore,
+} from '@aiready/core';
+import type { ToolScoringOutput } from '@aiready/core';
+import { getReportTimestamp, generateMarkdownReport } from '../utils/helpers';
+
+interface ConsistencyOptions {
+  naming?: boolean;
+  patterns?: boolean;
+  minSeverity?: string;
+  include?: string;
+  exclude?: string;
+  output?: string;
+  outputFile?: string;
+  score?: boolean;
+}
+
+export async function consistencyAction(directory: string, options: ConsistencyOptions) {
+  console.log(chalk.blue('🔍 Analyzing consistency...\n'));
+
+  const startTime = Date.now();
+  const resolvedDir = resolvePath(process.cwd(), directory || '.');
+
+  try {
+    // Define defaults
+    const defaults = {
+      checkNaming: true,
+      checkPatterns: true,
+      minSeverity: 'info' as const,
+      include: undefined,
+      exclude: undefined,
+      output: {
+        format: 'console',
+        file: undefined,
+      },
+    };
+
+    // Load and merge config with CLI options
+    const finalOptions = await loadMergedConfig(resolvedDir, defaults, {
+      checkNaming: options.naming !== false,
+      checkPatterns: options.patterns !== false,
+      minSeverity: options.minSeverity,
+      include: options.include?.split(','),
+      exclude: options.exclude?.split(','),
+    });
+
+    const { analyzeConsistency, calculateConsistencyScore } = await import('@aiready/consistency');
+
+    const report = await analyzeConsistency(finalOptions);
+
+    const elapsedTime = getElapsedTime(startTime);
+    
+    // Calculate score if requested
+    let consistencyScore: ToolScoringOutput | undefined;
+    if (options.score) {
+      const issues = report.results?.flatMap((r: any) => r.issues) || [];
+      consistencyScore = calculateConsistencyScore(issues, report.summary.filesAnalyzed);
+    }
+
+    const outputFormat = options.output || finalOptions.output?.format || 'console';
+    const userOutputFile = options.outputFile || finalOptions.output?.file;
+
+    if (outputFormat === 'json') {
+      const outputData = {
+        ...report,
+        summary: {
+          ...report.summary,
+          executionTime: parseFloat(elapsedTime),
+        },
+        ...(consistencyScore && { scoring: consistencyScore }),
+      };
+
+      const outputPath = resolveOutputPath(
+        userOutputFile,
+        `aiready-report-${getReportTimestamp()}.json`,
+        resolvedDir
+      );
+      
+      handleJSONOutput(outputData, outputPath, `✅ Results saved to ${outputPath}`);
+    } else if (outputFormat === 'markdown') {
+      // Markdown output
+      const markdown = generateMarkdownReport(report, elapsedTime);
+      const outputPath = resolveOutputPath(
+        userOutputFile,
+        `aiready-report-${getReportTimestamp()}.md`,
+        resolvedDir
+      );
+      writeFileSync(outputPath, markdown);
+      console.log(chalk.green(`✅ Report saved to ${outputPath}`));
+    } else {
+      // Console output - format to match standalone CLI
+      console.log(chalk.bold('\n📊 Summary\n'));
+      console.log(`Files Analyzed: ${chalk.cyan(report.summary.filesAnalyzed)}`);
+      console.log(`Total Issues: ${chalk.yellow(report.summary.totalIssues)}`);
+      console.log(`  Naming: ${chalk.yellow(report.summary.namingIssues)}`);
+      console.log(`  Patterns: ${chalk.yellow(report.summary.patternIssues)}`);
+      console.log(`  Architecture: ${chalk.yellow(report.summary.architectureIssues || 0)}`);
+      console.log(`Analysis Time: ${chalk.gray(elapsedTime + 's')}\n`);
+
+      if (report.summary.totalIssues === 0) {
+        console.log(chalk.green('✨ No consistency issues found! Your codebase is well-maintained.\n'));
+      } else {
+        // Group and display issues by category
+        const namingResults = report.results.filter((r: any) =>
+          r.issues.some((i: any) => i.category === 'naming')
+        );
+        const patternResults = report.results.filter((r: any) =>
+          r.issues.some((i: any) => i.category === 'patterns')
+        );
+
+        if (namingResults.length > 0) {
+          console.log(chalk.bold('🏷️  Naming Issues\n'));
+          let shown = 0;
+          for (const result of namingResults) {
+            if (shown >= 5) break;
+            for (const issue of result.issues) {
+              if (shown >= 5) break;
+              const severityColor = issue.severity === 'critical' ? chalk.red :
+                issue.severity === 'major' ? chalk.yellow :
+                issue.severity === 'minor' ? chalk.blue : chalk.gray;
+              console.log(`${severityColor(issue.severity.toUpperCase())} ${chalk.dim(`${issue.location.file}:${issue.location.line}`)}`);
+              console.log(`  ${issue.message}`);
+              if (issue.suggestion) {
+                console.log(`  ${chalk.dim('→')} ${chalk.italic(issue.suggestion)}`);
+              }
+              console.log();
+              shown++;
+            }
+          }
+          const remaining = namingResults.reduce((sum, r) => sum + r.issues.length, 0) - shown;
+          if (remaining > 0) {
+            console.log(chalk.dim(`  ... and ${remaining} more issues\n`));
+          }
+        }
+
+        if (patternResults.length > 0) {
+          console.log(chalk.bold('🔄 Pattern Issues\n'));
+          let shown = 0;
+          for (const result of patternResults) {
+            if (shown >= 5) break;
+            for (const issue of result.issues) {
+              if (shown >= 5) break;
+              const severityColor = issue.severity === 'critical' ? chalk.red :
+                issue.severity === 'major' ? chalk.yellow :
+                issue.severity === 'minor' ? chalk.blue : chalk.gray;
+              console.log(`${severityColor(issue.severity.toUpperCase())} ${chalk.dim(`${issue.location.file}:${issue.location.line}`)}`);
+              console.log(`  ${issue.message}`);
+              if (issue.suggestion) {
+                console.log(`  ${chalk.dim('→')} ${chalk.italic(issue.suggestion)}`);
+              }
+              console.log();
+              shown++;
+            }
+          }
+          const remaining = patternResults.reduce((sum, r) => sum + r.issues.length, 0) - shown;
+          if (remaining > 0) {
+            console.log(chalk.dim(`  ... and ${remaining} more issues\n`));
+          }
+        }
+
+        if (report.recommendations.length > 0) {
+          console.log(chalk.bold('💡 Recommendations\n'));
+          report.recommendations.forEach((rec: string, i: number) => {
+            console.log(`${i + 1}. ${rec}`);
+          });
+          console.log();
+        }
+      }
+      
+      // Display score if calculated
+      if (consistencyScore) {
+        console.log(chalk.bold('\n📊 AI Readiness Score (Consistency)\n'));
+        console.log(formatToolScore(consistencyScore));
+        console.log();
+      }
+    }
+  } catch (error) {
+    handleCLIError(error, 'Consistency analysis');
+  }
+}

package/src/commands/context.ts

@@ -0,0 +1,192 @@
+/**
+ * Context command - Analyze context window costs and dependency fragmentation
+ */
+
+import chalk from 'chalk';
+import { resolve as resolvePath } from 'path';
+import { 
+  loadMergedConfig, 
+  handleJSONOutput, 
+  handleCLIError, 
+  getElapsedTime, 
+  resolveOutputPath,
+  formatToolScore,
+} from '@aiready/core';
+import type { ToolScoringOutput } from '@aiready/core';
+import { getReportTimestamp } from '../utils/helpers';
+
+interface ContextOptions {
+  maxDepth?: string;
+  maxContext?: string;
+  include?: string;
+  exclude?: string;
+  output?: string;
+  outputFile?: string;
+  score?: boolean;
+}
+
+export async function contextAction(directory: string, options: ContextOptions) {
+  console.log(chalk.blue('🧠 Analyzing context costs...\n'));
+
+  const startTime = Date.now();
+  const resolvedDir = resolvePath(process.cwd(), directory || '.');
+
+  try {
+    // Define defaults
+    const defaults = {
+      maxDepth: 5,
+      maxContextBudget: 10000,
+      include: undefined,
+      exclude: undefined,
+      output: {
+        format: 'console',
+        file: undefined,
+      },
+    };
+
+    // Load and merge config with CLI options
+    let baseOptions = await loadMergedConfig(resolvedDir, defaults, {
+      maxDepth: options.maxDepth ? parseInt(options.maxDepth) : undefined,
+      maxContextBudget: options.maxContext ? parseInt(options.maxContext) : undefined,
+      include: options.include?.split(','),
+      exclude: options.exclude?.split(','),
+    });
+
+    // 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);
+    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(`   Analysis focus: ${finalOptions.focus}`);
+    console.log('');
+
+    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 userOutputFile = options.outputFile || finalOptions.output?.file;
+
+    if (outputFormat === 'json') {
+      const outputData = {
+        results,
+        summary: { ...summary, executionTime: parseFloat(elapsedTime) },
+        ...(contextScore && { scoring: contextScore }),
+      };
+
+      const outputPath = resolveOutputPath(
+        userOutputFile,
+        `aiready-report-${getReportTimestamp()}.json`,
+        resolvedDir
+      );
+      
+      handleJSONOutput(outputData, outputPath, `✅ Results saved to ${outputPath}`);
+    } else {
+      // Console output - format the results nicely
+      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('  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`));
+
+      // Issues summary
+      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)}`));
+        }
+        if (summary.majorIssues > 0) {
+          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.green(`\n   💡 Potential savings: ${chalk.bold(summary.totalPotentialSavings.toLocaleString())} tokens\n`));
+      } else {
+        console.log(chalk.green('✅ No significant issues found!\n'));
+      }
+
+      // 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`));
+        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();
+      }
+
+      // 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`));
+        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();
+      }
+
+      // 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`));
+        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();
+      }
+
+      // Top expensive files
+      if (summary.topExpensiveFiles.length > 0) {
+        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)`)}`);
+        });
+        console.log();
+      }
+      
+      // Display score if calculated
+      if (contextScore) {
+        console.log(chalk.cyan(divider));
+        console.log(chalk.bold.white('  AI READINESS SCORE (Context)'));
+        console.log(chalk.cyan(divider) + '\n');
+        console.log(formatToolScore(contextScore));
+        console.log();
+      }
+    }
+  } catch (error) {
+    handleCLIError(error, 'Context analysis');
+  }
+}

package/src/commands/index.ts

@@ -0,0 +1,9 @@
+/**
+ * Command exports for CLI
+ */
+
+export { scanAction, scanHelpText } from './scan';
+export { patternsAction, patternsHelpText } from './patterns';
+export { contextAction } from './context';
+export { consistencyAction } from './consistency';
+export { visualizeAction, visualizeHelpText, visualiseHelpText } from './visualize';

package/src/commands/patterns.ts

@@ -0,0 +1,179 @@
+/**
+ * Patterns command - Detect duplicate code patterns that confuse AI models
+ */
+
+import chalk from 'chalk';
+import { resolve as resolvePath } from 'path';
+import { 
+  loadMergedConfig, 
+  handleJSONOutput, 
+  handleCLIError, 
+  getElapsedTime, 
+  resolveOutputPath,
+  formatToolScore,
+} from '@aiready/core';
+import type { ToolScoringOutput } from '@aiready/core';
+import { getReportTimestamp } from '../utils/helpers';
+
+interface PatternsOptions {
+  similarity?: string;
+  minLines?: string;
+  maxCandidates?: string;
+  minSharedTokens?: string;
+  fullScan?: boolean;
+  include?: string;
+  exclude?: string;
+  output?: string;
+  outputFile?: string;
+  score?: boolean;
+}
+
+export async function patternsAction(directory: string, options: PatternsOptions) {
+  console.log(chalk.blue('🔍 Analyzing patterns...\n'));
+
+  const startTime = Date.now();
+  const resolvedDir = resolvePath(process.cwd(), directory || '.');
+
+  try {
+    // Determine if smart defaults should be used
+    const useSmartDefaults = !options.fullScan;
+
+    // Define defaults (only for options not handled by smart defaults)
+    const defaults = {
+      useSmartDefaults,
+      include: undefined,
+      exclude: undefined,
+      output: {
+        format: 'console',
+        file: undefined,
+      },
+    };
+
+    // Set fallback defaults only if smart defaults are disabled
+    if (!useSmartDefaults) {
+      (defaults as any).minSimilarity = 0.4;
+      (defaults as any).minLines = 5;
+    }
+
+    // Load and merge config with CLI options
+    const cliOptions: any = {
+      minSimilarity: options.similarity ? parseFloat(options.similarity) : undefined,
+      minLines: options.minLines ? parseInt(options.minLines) : undefined,
+      useSmartDefaults,
+      include: options.include?.split(','),
+      exclude: options.exclude?.split(','),
+    };
+
+    // Only include performance tuning options if explicitly specified
+    if (options.maxCandidates) {
+      cliOptions.maxCandidatesPerBlock = parseInt(options.maxCandidates);
+    }
+    if (options.minSharedTokens) {
+      cliOptions.minSharedTokens = parseInt(options.minSharedTokens);
+    }
+
+    const finalOptions = await loadMergedConfig(resolvedDir, defaults, cliOptions);
+
+    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 userOutputFile = options.outputFile || finalOptions.output?.file;
+
+    if (outputFormat === 'json') {
+      const outputData = {
+        results,
+        summary: { ...summary, executionTime: parseFloat(elapsedTime) },
+        ...(patternScore && { scoring: patternScore }),
+      };
+
+      const outputPath = resolveOutputPath(
+        userOutputFile,
+        `aiready-report-${getReportTimestamp()}.json`,
+        resolvedDir
+      );
+      
+      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')}`));
+
+      // Show breakdown by pattern type
+      const sortedTypes = Object.entries(summary.patternsByType || {})
+        .filter(([, count]) => count > 0)
+        .sort(([, a], [, b]) => (b as number) - (a as number));
+
+      if (sortedTypes.length > 0) {
+        console.log(chalk.cyan('\n' + divider));
+        console.log(chalk.bold.white('  PATTERNS BY TYPE'));
+        console.log(chalk.cyan(divider) + '\n');
+        sortedTypes.forEach(([type, count]) => {
+          console.log(`  ${chalk.white(type.padEnd(15))} ${chalk.bold(count)}`);
+        });
+      }
+
+      // Show top duplicates
+      if (summary.totalPatterns > 0 && duplicates.length > 0) {
+        console.log(chalk.cyan('\n' + divider));
+        console.log(chalk.bold.white('  TOP DUPLICATE PATTERNS'));
+        console.log(chalk.cyan(divider) + '\n');
+
+        // Sort by similarity and take top 10
+        const topDuplicates = [...duplicates]
+          .sort((a, b) => b.similarity - a.similarity)
+          .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 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`);
+        });
+      } else {
+        console.log(chalk.green('\n✨ Great! No duplicate patterns detected.\n'));
+      }
+      
+      // Display score if calculated
+      if (patternScore) {
+        console.log(chalk.cyan(divider));
+        console.log(chalk.bold.white('  AI READINESS SCORE (Patterns)'));
+        console.log(chalk.cyan(divider) + '\n');
+        console.log(formatToolScore(patternScore));
+        console.log();
+      }
+    }
+  } catch (error) {
+    handleCLIError(error, 'Pattern analysis');
+  }
+}
+
+export const patternsHelpText = `
+EXAMPLES:
+  $ aiready patterns                                 # Default analysis
+  $ aiready patterns --similarity 0.6               # Stricter matching
+  $ aiready patterns --min-lines 10                 # Larger patterns only
+`;