@aiready/cli 0.14.14 → 0.14.16

package/src/commands/agent-grounding.ts

@@ -1,62 +0,0 @@
-/**
- * Agent grounding command for unified CLI
- */
-
-import chalk from 'chalk';
-import { loadConfig, mergeConfigWithDefaults } from '@aiready/core';
-import type { ToolScoringOutput } from '@aiready/core';
-
-export async function agentGroundingAction(
-  directory: string,
-  options: any
-): Promise<ToolScoringOutput | undefined> {
-  const { analyzeAgentGrounding, calculateGroundingScore } =
-    await import('@aiready/agent-grounding');
-
-  const config = await loadConfig(directory);
-  const merged = mergeConfigWithDefaults(config, {
-    maxRecommendedDepth: 4,
-    readmeStaleDays: 90,
-  });
-
-  const report = await analyzeAgentGrounding({
-    rootDir: directory,
-    maxRecommendedDepth: options.maxDepth ?? merged.maxRecommendedDepth,
-    readmeStaleDays: options.readmeStaleDays ?? merged.readmeStaleDays,
-    include: options.include,
-    exclude: options.exclude,
-  });
-
-  const scoring = calculateGroundingScore(report);
-
-  if (options.output === 'json') {
-    return scoring;
-  }
-
-  const scoreColor = (s: number) =>
-    s >= 85
-      ? chalk.green
-      : s >= 70
-        ? chalk.cyan
-        : s >= 50
-          ? chalk.yellow
-          : chalk.red;
-  void scoreColor;
-
-  console.log(
-    `  🧭 Agent Grounding:     ${chalk.bold(scoring.score + '/100')} (${report.summary.rating})`
-  );
-  const dims = report.summary.dimensions;
-  const worstDim = Object.entries(dims).sort(([, a], [, b]) => a - b)[0];
-  if (worstDim && worstDim[1] < 70) {
-    const name = worstDim[0]
-      .replace(/([A-Z])/g, ' $1')
-      .replace('Score', '')
-      .trim();
-    console.log(
-      chalk.dim(`     Weakest dimension: ${name} (${worstDim[1]}/100)`)
-    );
-  }
-
-  return scoring;
-}

package/src/commands/ai-signal-clarity.ts

@@ -1 +0,0 @@
-export { aiSignalClarityAction } from './shared/standard-tool-actions';

package/src/commands/bug.ts

@@ -1,99 +0,0 @@
-import chalk from 'chalk';
-
-import { execSync } from 'child_process';
-
-/**
- * Handle bug and feedback reporting
- */
-export async function bugAction(message: string | undefined, options: any) {
-  const repoUrl = 'https://github.com/caopengau/aiready-cli';
-  const repoSlug = 'caopengau/aiready-cli';
-
-  if (message) {
-    // Agent-assisted pre-filled issue
-    const type = options.type ?? 'bug';
-    const title = `[${type.toUpperCase()}] ${message}`;
-    const label =
-      type === 'bug' ? 'bug' : type === 'feature' ? 'enhancement' : 'metric';
-
-    const body = `
-## Description
-${message}
-
-## Context
-Generated via AIReady CLI 'bug' command.
-Type: ${type}
-    `.trim();
-
-    if (options.submit) {
-      console.log(chalk.blue('🚀 Submitting issue via GitHub CLI...\n'));
-      try {
-        // Check if gh is authenticated
-        execSync('gh auth status', { stdio: 'ignore' });
-
-        const command = `gh issue create --repo ${repoSlug} --title ${JSON.stringify(title)} --body ${JSON.stringify(body)} --label ${label}`;
-        const output = execSync(command, { encoding: 'utf8' }).trim();
-
-        console.log(chalk.green('✅ Issue Created Successfully!'));
-        console.log(chalk.cyan(output));
-        return;
-      } catch {
-        console.error(chalk.red('\n❌ Failed to submit via gh CLI.'));
-        console.log(
-          chalk.yellow(
-            '   Make sure gh is installed and run "gh auth login".\n'
-          )
-        );
-        console.log(chalk.dim('   Falling back to URL generation...'));
-      }
-    }
-
-    const template =
-      type === 'bug'
-        ? 'bug_report.md'
-        : type === 'feature'
-          ? 'feature_request.md'
-          : 'new_metric_idea.md';
-    const fullUrl = `${repoUrl}/issues/new?title=${encodeURIComponent(title)}&body=${encodeURIComponent(body)}&labels=${label}&template=${template}`;
-
-    console.log(chalk.green('🚀 Issue Draft Prepared!\n'));
-    console.log(chalk.bold('Title:  ') + title);
-    console.log(chalk.bold('Type:   ') + type);
-    console.log(chalk.bold('\nClick the link below to submit this issue:'));
-    console.log(chalk.cyan(fullUrl));
-
-    console.log(chalk.bold('\n🤖 [FOR AI AGENTS]:'));
-    console.log(chalk.dim('   You have successfully prepared a report.'));
-    console.log(
-      chalk.dim(
-        '   Please present the URL above to the user so they can finalize the submission.'
-      )
-    );
-    return;
-  }
-
-  const bugUrl = `${repoUrl}/issues/new?template=bug_report.md`;
-  const featureUrl = `${repoUrl}/issues/new?template=feature_request.md`;
-  const metricUrl = `${repoUrl}/issues/new?template=new_metric_idea.md`;
-
-  console.log(chalk.blue('💬 Feedback & Bug Reports\n'));
-  console.log(`  Report a Bug:        ${chalk.cyan(bugUrl)}`);
-  console.log(`  Request a Feature:   ${chalk.cyan(featureUrl)}`);
-  console.log(`  Suggest a Metric:    ${chalk.cyan(metricUrl)}`);
-
-  console.log(chalk.bold('\n🤖 [FOR AI AGENTS]:'));
-  console.log(chalk.dim('   To prepare a specific report, run:'));
-  console.log(
-    chalk.cyan(
-      '   aiready bug "your description here" --type bug|feature|metric'
-    )
-  );
-}
-
-export const bugHelpText = `
-EXAMPLES:
-  $ aiready bug                                      # Show general links
-  $ aiready bug "Naming check is too slow"           # Prepare a pre-filled bug report
-  $ aiready bug "Add CO2 impact metric" --type metric # Prepare a metric suggestion
-  $ aiready bug "Fix typo in scan output" --submit   # Submit directly via gh CLI
-`;

package/src/commands/change-amplification.ts

@@ -1,3 +0,0 @@
-import { changeAmplificationAction } from '@aiready/change-amplification/dist/cli.js';
-
-export { changeAmplificationAction };

package/src/commands/consistency.ts

@@ -1,232 +0,0 @@
-/**
- * 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: any = {
-      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

@@ -1,262 +0,0 @@
-/**
- * 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: any = {
-      maxDepth: 5,
-      maxContextBudget: 10000,
-      include: undefined,
-      exclude: undefined,
-      output: {
-        format: 'console',
-        file: undefined,
-      },
-    };
-
-    // Load and merge config with CLI options
-    const 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/deps-health.ts

@@ -1 +0,0 @@
-export { depsHealthAction } from './shared/standard-tool-actions';

package/src/commands/doc-drift.ts

@@ -1 +0,0 @@
-export { docDriftAction } from './shared/standard-tool-actions';

package/src/commands/index.ts

@@ -1,20 +0,0 @@
-/**
- * Command exports for CLI
- */
-
-export { scanAction, scanHelpText } from './scan';
-export { initAction } from './init';
-export { patternsAction, patternsHelpText } from './patterns';
-export { contextAction } from './context';
-export { consistencyAction } from './consistency';
-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 { uploadAction, uploadHelpText } from './upload';
-export { bugAction, bugHelpText } from './bug';