@aiready/cli 0.14.13 → 0.14.15

package/src/commands/init.ts

@@ -1,199 +0,0 @@
-import { writeFileSync, existsSync } from 'fs';
-import { join } from 'path';
-import chalk from 'chalk';
-import { ToolName } from '@aiready/core';
-
-export async function initAction(options: {
-  force?: boolean;
-  format?: 'json' | 'js';
-  full?: boolean;
-}) {
-  const fileExt = options.format === 'js' ? 'js' : 'json';
-  const fileName = fileExt === 'js' ? 'aiready.config.js' : 'aiready.json';
-  const filePath = join(process.cwd(), fileName);
-
-  if (existsSync(filePath) && !options.force) {
-    console.error(
-      chalk.red(`Error: ${fileName} already exists. Use --force to overwrite.`)
-    );
-    process.exit(1);
-  }
-
-  const baseConfig = {
-    $schema: 'https://getaiready.dev/schema.json',
-
-    // Target quality score threshold (0-100)
-    threshold: 75,
-
-    // Global scan settings
-    scan: {
-      include: [
-        'src/**/*.ts',
-        'src/**/*.js',
-        'lib/**/*.ts',
-        'packages/*/src/**/*.ts',
-      ],
-      exclude: [
-        '**/node_modules/**',
-        '**/dist/**',
-        '**/build/**',
-        '**/*.test.ts',
-        '**/*.spec.ts',
-      ],
-      tools: [
-        ToolName.PatternDetect,
-        ToolName.ContextAnalyzer,
-        ToolName.NamingConsistency,
-        ToolName.AiSignalClarity,
-        ToolName.AgentGrounding,
-        ToolName.TestabilityIndex,
-        ToolName.DocDrift,
-        ToolName.DependencyHealth,
-        ToolName.ChangeAmplification,
-      ],
-    },
-
-    // Output preferences
-    output: {
-      format: 'console',
-      showBreakdown: true,
-      saveTo: 'aiready-report.json',
-    },
-
-    // Scoring profile and weights
-    scoring: {
-      profile: 'balanced',
-    },
-
-    // Tool-specific configurations
-    tools: {
-      [ToolName.PatternDetect]: {
-        minSimilarity: 0.8,
-        minLines: 5,
-        minSharedTokens: 10,
-        approx: true,
-        ...(options.full
-          ? {
-              batchSize: 300,
-              maxCandidatesPerBlock: 500,
-              minClusterFiles: 3,
-              minClusterTokenCost: 1000,
-            }
-          : {}),
-      },
-      [ToolName.ContextAnalyzer]: {
-        maxContextBudget: 128000,
-        minCohesion: 0.6,
-        maxDepth: 7,
-        maxFragmentation: 0.4,
-        focus: 'all',
-        includeNodeModules: false,
-      },
-      [ToolName.NamingConsistency]: {
-        checkNaming: true,
-        checkPatterns: true,
-        checkArchitecture: true,
-        shortWords: ['id', 'db', 'ui', 'ai'],
-        acceptedAbbreviations: [
-          'API',
-          'JSON',
-          'CSV',
-          'HTML',
-          'CSS',
-          'HTTP',
-          'URL',
-          'SDK',
-          'CLI',
-          'AI',
-          'ML',
-          'ID',
-          'DB',
-          'UI',
-          'UX',
-          'DOM',
-          'UUID',
-          'GUID',
-          'DEFAULT',
-          'MAX',
-          'MIN',
-          'config',
-          'INIT',
-          'SKILL',
-          'ENV',
-          'DEV',
-          'PROD',
-          'AWS',
-          'S3',
-          'ARN',
-        ],
-        ...(options.full ? { disableChecks: [] } : {}),
-      },
-      [ToolName.AiSignalClarity]: {
-        checkMagicLiterals: true,
-        checkBooleanTraps: true,
-        checkAmbiguousNames: true,
-        checkUndocumentedExports: true,
-        checkImplicitSideEffects: true,
-        checkDeepCallbacks: true,
-        checkOverloadedSymbols: true,
-        checkLargeFiles: true,
-      },
-      [ToolName.AgentGrounding]: {
-        maxRecommendedDepth: 5,
-        readmeStaleDays: 30,
-        additionalVagueNames: ['stuff', 'misc', 'temp', 'test'],
-      },
-      [ToolName.TestabilityIndex]: {
-        minCoverageRatio: 0.7,
-        testPatterns: ['**/*.test.ts', '**/__tests__/**', '**/*.spec.ts'],
-        maxDepth: 10,
-      },
-      [ToolName.DocDrift]: {
-        maxCommits: 50,
-        staleMonths: 3,
-      },
-      [ToolName.DependencyHealth]: {
-        trainingCutoffYear: 2023,
-      },
-      [ToolName.ChangeAmplification]: {
-        // Change amplification primarily relies on global scan settings
-      },
-    },
-
-    // Visualizer settings (interactive graph)
-    visualizer: {
-      groupingDirs: ['packages', 'src', 'lib'],
-      graph: {
-        maxNodes: 5000,
-        maxEdges: 10000,
-      },
-    },
-  };
-
-  const defaultConfig = baseConfig;
-
-  let content: string;
-  if (fileExt === 'js') {
-    content = `/** 
- * AIReady Configuration
- * @type {import('@aiready/core').AIReadyConfig} 
- */
-module.exports = ${JSON.stringify(defaultConfig, null, 2)};\n`;
-  } else {
-    content = JSON.stringify(defaultConfig, null, 2);
-  }
-
-  try {
-    writeFileSync(filePath, content, 'utf8');
-    console.log(
-      chalk.green(`\n✅ Created default configuration: ${chalk.bold(fileName)}`)
-    );
-    console.log(
-      chalk.cyan('You can now fine-tune your settings and run AIReady with:')
-    );
-    console.log(chalk.white(`  $ aiready scan\n`));
-  } catch (error) {
-    console.error(chalk.red(`Failed to write configuration file: ${error}`));
-    process.exit(1);
-  }
-}

package/src/commands/patterns.ts

@@ -1,222 +0,0 @@
-/**
- * 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
-    )) as any;
-
-    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
-`;

package/src/commands/report-formatter.ts

@@ -1,267 +0,0 @@
-import chalk from 'chalk';
-import {
-  Severity,
-  ScoringResult,
-  formatScore,
-  getRating,
-  getRatingDisplay,
-} from '@aiready/core';
-
-/**
- * Generate a visual progress bar for a score.
- *
- * @param score - The score value (0-100)
- * @param width - The width of the progress bar
- * @returns A colored progress bar string
- */
-function generateProgressBar(score: number, width: number = 20): string {
-  const filled = Math.round((score / 100) * width);
-  const empty = width - filled;
-
-  let color = chalk.red;
-  if (score >= 90) color = chalk.green;
-  else if (score >= 75) color = chalk.cyan;
-  else if (score >= 60) color = chalk.yellow;
-
-  const bar = '█'.repeat(filled) + '░'.repeat(empty);
-  return color(bar);
-}
-
-/**
- * Count issues by severity level from all tool results.
- *
- * @param results - The unified results object
- * @returns Object with counts for each severity level
- */
-function countIssuesBySeverity(results: any): {
-  critical: number;
-  major: number;
-  minor: number;
-} {
-  let critical = 0;
-  let major = 0;
-  let minor = 0;
-
-  if (results.summary?.toolsRun) {
-    for (const toolId of results.summary.toolsRun) {
-      const toolRes = results[toolId];
-      if (toolRes?.results) {
-        for (const fileRes of toolRes.results) {
-          if (fileRes.issues) {
-            for (const issue of fileRes.issues) {
-              const sev = issue.severity?.toLowerCase();
-              if (sev === 'critical') critical++;
-              else if (sev === 'major') major++;
-              else minor++;
-            }
-          }
-        }
-      }
-    }
-  }
-
-  return { critical, major, minor };
-}
-
-/**
- * Get top files with most issues.
- *
- * @param results - The unified results object
- * @param limit - Maximum number of files to return
- * @returns Array of files with issue counts
- */
-function getTopFilesWithIssues(
-  results: any,
-  limit: number = 5
-): Array<{ file: string; count: number }> {
-  const fileCounts = new Map<string, number>();
-
-  if (results.summary?.toolsRun) {
-    for (const toolId of results.summary.toolsRun) {
-      const toolRes = results[toolId];
-      if (toolRes?.results) {
-        for (const fileRes of toolRes.results) {
-          if (fileRes.issues?.length > 0) {
-            const current = fileCounts.get(fileRes.fileName) || 0;
-            fileCounts.set(fileRes.fileName, current + fileRes.issues.length);
-          }
-        }
-      }
-    }
-  }
-
-  return Array.from(fileCounts.entries())
-    .map(([file, count]) => ({ file, count }))
-    .sort((a, b) => b.count - a.count)
-    .slice(0, limit);
-}
-
-/**
- * Handle console output for the scan results.
- *
- * @param results - The combined results from all tools.
- * @param startTime - The timestamp when the scan started.
- */
-export function printScanSummary(results: any, startTime: number) {
-  // Count issues by severity
-  const severity = countIssuesBySeverity(results);
-  const totalIssues = severity.critical + severity.major + severity.minor;
-
-  // Get top files with issues
-  const topFiles = getTopFilesWithIssues(results);
-
-  console.log(chalk.cyan('\n=== AIReady Run Summary ==='));
-  console.log(`  Total issues: ${chalk.bold(String(totalIssues))}`);
-
-  // Severity breakdown
-  if (totalIssues > 0) {
-    console.log(chalk.dim('  Severity breakdown:'));
-    if (severity.critical > 0) {
-      console.log(
-        `    ${chalk.red('●')} Critical: ${chalk.bold(severity.critical)}`
-      );
-    }
-    if (severity.major > 0) {
-      console.log(
-        `    ${chalk.yellow('●')} Major: ${chalk.bold(severity.major)}`
-      );
-    }
-    if (severity.minor > 0) {
-      console.log(
-        `    ${chalk.blue('●')} Minor: ${chalk.bold(severity.minor)}`
-      );
-    }
-  }
-
-  // Top files with issues
-  if (topFiles.length > 0) {
-    console.log(chalk.dim('\n  Top files with issues:'));
-    topFiles.forEach((item) => {
-      console.log(
-        `    ${chalk.yellow('→')} ${item.file}: ${chalk.bold(item.count)} issues`
-      );
-    });
-  }
-
-  console.log(
-    `\n  Execution time: ${chalk.bold(((Date.now() - startTime) / 1000).toFixed(2) + 's')}`
-  );
-}
-
-/**
- * Print business impact analysis based on ROI and budget metrics.
- *
- * @param roi - Calculated Return on Investment metrics.
- * @param unifiedBudget - Consolidated context budget metrics.
- */
-export function printBusinessImpact(roi: any, unifiedBudget: any) {
-  console.log(chalk.bold('\n💰 Business Impact Analysis (Monthly)'));
-  console.log(
-    `  Potential Savings: ${chalk.green(chalk.bold('$' + roi.monthlySavings.toLocaleString()))}`
-  );
-  console.log(
-    `  Productivity Gain: ${chalk.cyan(chalk.bold(roi.productivityGainHours + 'h'))} (est. dev time)`
-  );
-  console.log(
-    `  Context Efficiency: ${chalk.yellow((unifiedBudget.efficiencyRatio * 100).toFixed(0) + '%')}`
-  );
-  console.log(
-    `  Annual Value: ${chalk.bold('$' + roi.annualValue.toLocaleString())} (ROI Prediction)`
-  );
-}
-
-/**
- * Print detailed scoring breakdown by tool.
- *
- * @param scoringResult - The overall scoring result.
- * @param scoringProfile - The name of the scoring profile used.
- */
-export function printScoring(
-  scoringResult: ScoringResult,
-  scoringProfile: string
-) {
-  console.log(chalk.bold('\n📊 AI Readiness Overall Score'));
-  console.log(`  ${formatScore(scoringResult)}`);
-  console.log(chalk.dim(`  (Scoring Profile: ${scoringProfile})`));
-
-  if (scoringResult.breakdown) {
-    console.log(chalk.bold('\nTool breakdown:'));
-    scoringResult.breakdown.forEach((tool: any) => {
-      const rating = getRating(tool.score);
-      const emoji = getRatingDisplay(rating).emoji;
-      const progressBar = generateProgressBar(tool.score, 15);
-      console.log(
-        `  ${progressBar} ${tool.score}/100 (${rating}) ${emoji} ${tool.toolName}`
-      );
-    });
-
-    // Top Actionable Recommendations - increased from 3 to 5
-    const allRecs = scoringResult.breakdown
-      .flatMap((t: any) =>
-        (t.recommendations ?? []).map((r: any) => ({ ...r, tool: t.toolName }))
-      )
-      .sort((a: any, b: any) => b.estimatedImpact - a.estimatedImpact)
-      .slice(0, 5); // Increased from 3 to 5
-
-    if (allRecs.length > 0) {
-      console.log(chalk.bold('\n🎯 Top Actionable Recommendations:'));
-      allRecs.forEach((rec: any, i: number) => {
-        const priorityIcon =
-          rec.priority === 'high'
-            ? '🔴'
-            : rec.priority === 'medium'
-              ? '🟡'
-              : '🔵';
-        console.log(`  ${i + 1}. ${priorityIcon} ${chalk.bold(rec.action)}`);
-        console.log(
-          `     Impact: ${chalk.green(`+${rec.estimatedImpact} points`)} to ${rec.tool}`
-        );
-      });
-    }
-  }
-}
-
-/**
- * Normalize and map tool-specific results to a unified report structure.
- *
- * @param res - Raw unified results object.
- * @param scoring - Optional scoring result to include.
- * @returns Enhanced report with totals and scoring.
- */
-export function mapToUnifiedReport(
-  res: any,
-  scoring: ScoringResult | undefined
-) {
-  const allResults: any[] = [];
-  const totalFilesSet = new Set<string>();
-  let criticalCount = 0;
-  let majorCount = 0;
-
-  res.summary.toolsRun.forEach((toolId: string) => {
-    const spokeRes = res[toolId];
-    if (!spokeRes || !spokeRes.results) return;
-
-    spokeRes.results.forEach((r: any) => {
-      totalFilesSet.add(r.fileName);
-      allResults.push(r);
-      r.issues?.forEach((i: any) => {
-        if (i.severity === Severity.Critical || i.severity === 'critical')
-          criticalCount++;
-        if (i.severity === Severity.Major || i.severity === 'major')
-          majorCount++;
-      });
-    });
-  });
-
-  return {
-    ...res,
-    results: allResults,
-    summary: {
-      ...res.summary,
-      totalFiles: totalFilesSet.size,
-      criticalIssues: criticalCount,
-      majorIssues: majorCount,
-    },
-    scoring,
-  };
-}