@aiready/cli 0.15.0 → 0.15.2

package/dist/cli.mjs

@@ -88,38 +88,6 @@ async function warnIfGraphCapExceeded(report, dirPath) {
     void err;
   }
 }
-function generateMarkdownReport(report, elapsedTime) {
-  let markdown = `# Consistency Analysis Report
-
-`;
-  markdown += `**Generated:** ${(/* @__PURE__ */ new Date()).toISOString()}
-`;
-  markdown += `**Analysis Time:** ${elapsedTime}s
-
-`;
-  markdown += `## Summary
-
-`;
-  markdown += `- **Files Analyzed:** ${report.summary.filesAnalyzed}
-`;
-  markdown += `- **Total Issues:** ${report.summary.totalIssues}
-`;
-  markdown += `  - Naming: ${report.summary.namingIssues}
-`;
-  markdown += `  - Patterns: ${report.summary.patternIssues}
-
-`;
-  if (report.recommendations.length > 0) {
-    markdown += `## Recommendations
-
-`;
-    report.recommendations.forEach((rec, i) => {
-      markdown += `${i + 1}. ${rec}
-`;
-    });
-  }
-  return markdown;
-}
 
 // src/commands/report-formatter.ts
 import chalk2 from "chalk";
@@ -476,7 +444,8 @@ function getProfileTools(profile) {
       return [
         ToolName.AiSignalClarity,
         ToolName.AgentGrounding,
-        ToolName.TestabilityIndex
+        ToolName.TestabilityIndex,
+        ToolName.ContractEnforcement
       ];
     case "cost":
       return [ToolName.PatternDetect, ToolName.ContextAnalyzer];
@@ -486,7 +455,8 @@ function getProfileTools(profile) {
         ToolName.NamingConsistency,
         ToolName.ContextAnalyzer,
         ToolName.PatternDetect,
-        ToolName.ChangeAmplification
+        ToolName.ChangeAmplification,
+        ToolName.ContractEnforcement
       ];
     case "ui":
       return [
@@ -497,7 +467,11 @@ function getProfileTools(profile) {
         ToolName.AiSignalClarity
       ];
     case "security":
-      return [ToolName.NamingConsistency, ToolName.TestabilityIndex];
+      return [
+        ToolName.NamingConsistency,
+        ToolName.TestabilityIndex,
+        ToolName.ContractEnforcement
+      ];
     case "onboarding":
       return [
         ToolName.ContextAnalyzer,
@@ -870,6 +844,38 @@ ${chalk6.bold("CI/CD Integration:")}
   Use --threshold and --fail-on to use AIReady as a quality gate in your CI pipelines.
   When running in GitHub Actions, it will automatically emit annotations for found issues.
 `;
+function defineScanCommand(program2) {
+  program2.command("scan").description(
+    "Run comprehensive AI-readiness analysis (patterns + context + consistency)"
+  ).argument("[directory]", "Directory to analyze", ".").option(
+    "-t, --tools <tools>",
+    "Tools to run (comma-separated: patterns,context,consistency,doc-drift,deps-health,aiSignalClarity,grounding,testability,changeAmplification)"
+  ).option(
+    "--profile <type>",
+    "Scan profile to use (agentic, cost, logic, ui, security, onboarding)"
+  ).option(
+    "--compare-to <path>",
+    "Compare results against a previous AIReady report JSON"
+  ).option(
+    "--include <patterns>",
+    "File patterns to include (comma-separated)"
+  ).option(
+    "--exclude <patterns>",
+    "File patterns to exclude (comma-separated)"
+  ).option("-o, --output <format>", "Output format: console, json", "console").option("--output-file <path>", "Output file path (for json)").option("--score", "Calculate and display AI Readiness Score (0-100)").option("--no-score", "Disable calculating AI Readiness Score").option("--weights <weights>", "Custom scoring weights").option(
+    "--threshold <score>",
+    "Fail CI/CD if score below threshold (0-100)"
+  ).option(
+    "--ci",
+    "CI mode: GitHub Actions annotations, no colors, fail on threshold"
+  ).option(
+    "--fail-on <level>",
+    "Fail on issues: critical, major, any",
+    "critical"
+  ).option("--api-key <key>", "Platform API key for automatic upload").option("--upload", "Automatically upload results to the platform").option("--server <url>", "Custom platform URL").addHelpText("after", SCAN_HELP_TEXT).action(async (directory, options) => {
+    await scanAction(directory, options);
+  });
+}
 
 // src/commands/init.ts
 import { writeFileSync as writeFileSync2, existsSync as existsSync2 } from "fs";
@@ -1152,33 +1158,6 @@ function renderSafetyRating(safety) {
     `     AI Change Safety:  ${color(`${icon} ${safety.toUpperCase()}`)}`
   );
 }
-function renderIssueSummaryBlock(summary) {
-  const total = (summary.criticalIssues || 0) + (summary.majorIssues || 0) + (summary.minorIssues || 0);
-  if (total === 0) {
-    console.log(chalk8.green("\u2705 No significant issues found!\n"));
-    return;
-  }
-  console.log(chalk8.bold("\u26A0\uFE0F  Issues Found:\n"));
-  if (summary.criticalIssues > 0)
-    console.log(
-      chalk8.red(`   \u{1F534} Critical: ${chalk8.bold(summary.criticalIssues)}`)
-    );
-  if (summary.majorIssues > 0)
-    console.log(
-      chalk8.yellow(`   \u{1F7E1} Major: ${chalk8.bold(summary.majorIssues)}`)
-    );
-  if (summary.minorIssues > 0)
-    console.log(chalk8.blue(`   \u{1F535} Minor: ${chalk8.bold(summary.minorIssues)}`));
-  if (summary.totalPotentialSavings) {
-    console.log(
-      chalk8.green(
-        `
-   \u{1F4A1} Potential savings: ${chalk8.bold(summary.totalPotentialSavings.toLocaleString())} tokens
-`
-      )
-    );
-  }
-}
 function renderSubSection(title) {
   console.log("\n" + coreGetDivider());
   console.log(chalk8.bold.white(`  ${title.toUpperCase()}`));
@@ -1195,6 +1174,36 @@ function renderToolScoreFooter(score) {
 }
 
 // src/commands/patterns.ts
+var PATTERNS_HELP_TEXT = `
+EXAMPLES:
+  $ aiready patterns                                 # Default analysis
+  $ aiready patterns --similarity 0.6               # Stricter matching
+  $ aiready patterns --min-lines 10                 # Larger patterns only
+`;
+function definePatternsCommand(program2) {
+  program2.command("patterns").description("Detect duplicate code patterns that confuse AI models").argument("[directory]", "Directory to analyze", ".").option(
+    "-s, --similarity <number>",
+    "Minimum similarity score (0-1)",
+    "0.40"
+  ).option("-l, --min-lines <number>", "Minimum lines to consider", "5").option(
+    "--max-candidates <number>",
+    "Maximum candidates per block (performance tuning)"
+  ).option(
+    "--min-shared-tokens <number>",
+    "Minimum shared tokens for candidates (performance tuning)"
+  ).option(
+    "--full-scan",
+    "Disable smart defaults for comprehensive analysis (slower)"
+  ).option(
+    "--include <patterns>",
+    "File patterns to include (comma-separated)"
+  ).option(
+    "--exclude <patterns>",
+    "File patterns to exclude (comma-separated)"
+  ).option("-o, --output <format>", "Output format: console, json", "console").option("--output-file <path>", "Output file path (for json)").option("--score", "Calculate and display AI Readiness Score (0-100)").option("--no-score", "Disable calculating AI Readiness Score").addHelpText("after", PATTERNS_HELP_TEXT).action(async (directory, options) => {
+    await patternsAction(directory, options);
+  });
+}
 async function patternsAction(directory, options) {
   return await executeToolAction(directory, options, {
     toolName: "pattern-detect",
@@ -1274,21 +1283,30 @@ async function patternsAction(directory, options) {
     }
   });
 }
-var PATTERNS_HELP_TEXT = `
-EXAMPLES:
-  $ aiready patterns                                 # Default analysis
-  $ aiready patterns --similarity 0.6               # Stricter matching
-  $ aiready patterns --min-lines 10                 # Larger patterns only
-`;
 
 // src/commands/context.ts
 import chalk10 from "chalk";
 import { printTerminalHeader as printTerminalHeader2 } from "@aiready/core";
+function defineContextCommand(program2) {
+  program2.command("context").description("Analyze context window costs and dependency fragmentation").argument("[directory]", "Directory to analyze", ".").option("--max-depth <number>", "Maximum acceptable import depth", "5").option(
+    "--max-context <number>",
+    "Maximum acceptable context budget (tokens)",
+    "10000"
+  ).option(
+    "--include <patterns>",
+    "File patterns to include (comma-separated)"
+  ).option(
+    "--exclude <patterns>",
+    "File patterns to exclude (comma-separated)"
+  ).option("-o, --output <format>", "Output format: console, json", "console").option("--output-file <path>", "Output file path (for json)").option("--score", "Calculate and display AI Readiness Score (0-100)", true).option("--no-score", "Disable calculating AI Readiness Score").action(async (directory, options) => {
+    await contextAction(directory, options);
+  });
+}
 async function contextAction(directory, options) {
   return await executeToolAction(directory, options, {
     toolName: "context-analyzer",
     label: "Context analysis",
-    emoji: "\u{1F9E0}",
+    emoji: "\u{1F9E9}",
     defaults: {
       maxDepth: 5,
       maxContextBudget: 1e4,
@@ -1300,11 +1318,6 @@ async function contextAction(directory, options) {
       maxDepth: opts.maxDepth ? parseInt(opts.maxDepth) : void 0,
       maxContextBudget: opts.maxContext ? parseInt(opts.maxContext) : void 0
     }),
-    preAnalyze: async (resolvedDir, baseOptions) => {
-      const { getSmartDefaults } = await import("@aiready/context-analyzer");
-      const smartDefaults = await getSmartDefaults(resolvedDir, baseOptions);
-      return { ...smartDefaults, ...baseOptions };
-    },
     importTool: async () => {
       const { analyzeContext, generateSummary, calculateContextScore } = await import("@aiready/context-analyzer");
       return {
@@ -1313,45 +1326,40 @@ async function contextAction(directory, options) {
         calculateScore: calculateContextScore
       };
     },
-    renderConsole: ({ summary, elapsedTime, score }) => {
+    renderConsole: ({ results: _results, summary, elapsedTime, score }) => {
       printTerminalHeader2("CONTEXT ANALYSIS SUMMARY");
       console.log(
-        chalk10.white(`\u{1F4C1} Files analyzed: ${chalk10.bold(summary.totalFiles)}`)
+        chalk10.white(`\u{1F4C1} Total files: ${chalk10.bold(summary.totalFiles)}`)
       );
       console.log(
         chalk10.white(
-          `\u{1F4CA} Total tokens: ${chalk10.bold(summary.totalTokens.toLocaleString())}`
+          `\u{1F4B8} Total tokens (context budget): ${chalk10.bold(summary.totalTokens.toLocaleString())}`
         )
       );
       console.log(
-        chalk10.yellow(
-          `\u{1F4B0} Avg context budget: ${chalk10.bold(summary.avgContextBudget.toFixed(0))} tokens/file`
+        chalk10.cyan(
+          `\u{1F4CA} Average context budget: ${chalk10.bold(summary.avgContextBudget.toFixed(0))} tokens`
         )
       );
       console.log(
-        chalk10.white(`\u23F1  Analysis time: ${chalk10.bold(elapsedTime + "s")}
-`)
+        chalk10.gray(`\u23F1  Analysis time: ${chalk10.bold(elapsedTime + "s")}`)
       );
-      renderIssueSummaryBlock(summary);
-      if (summary.deepFiles && summary.deepFiles.length > 0) {
-        renderSubSection("Deep Import Chains");
-        summary.deepFiles.slice(0, 10).forEach((item) => {
-          const fileName = item.file.split("/").slice(-2).join("/");
+      if (summary.fragmentedModules.length > 0) {
+        renderSubSection("Top Fragmented Modules");
+        summary.fragmentedModules.slice(0, 5).forEach((mod) => {
+          const scoreColor = mod.fragmentationScore > 0.7 ? chalk10.red : mod.fragmentationScore > 0.4 ? chalk10.yellow : chalk10.green;
           console.log(
-            `   ${chalk10.cyan("\u2192")} ${chalk10.white(fileName)} ${chalk10.dim(`(depth: ${item.depth})`)}`
+            `  ${scoreColor("\u25A0")} ${chalk10.white(mod.domain.padEnd(20))} ${chalk10.bold((mod.fragmentationScore * 100).toFixed(0) + "%")} fragmentation`
           );
         });
       }
-      if (summary.fragmentedModules && summary.fragmentedModules.length > 0) {
-        renderSubSection("Fragmented Modules");
-        summary.fragmentedModules.slice(0, 10).forEach((module) => {
-          console.log(
-            `   ${chalk10.yellow("\u25CF")} ${chalk10.white(module.domain)} - ${chalk10.dim(`${module.files.length} files, ${(module.fragmentationScore * 100).toFixed(0)}% scattered`)}`
-          );
+      if (summary.topExpensiveFiles.length > 0) {
+        renderSubSection("Top Context-Expensive Files");
+        summary.topExpensiveFiles.slice(0, 5).forEach((item) => {
+          const icon = item.severity === "critical" ? "\u{1F534}" : item.severity === "major" ? "\u{1F7E1}" : "\u{1F535}";
+          const color = item.severity === "critical" ? chalk10.red : item.severity === "major" ? chalk10.yellow : chalk10.blue;
           console.log(
-            chalk10.dim(
-              `     Token cost: ${module.totalTokens.toLocaleString()}, Cohesion: ${(module.avgCohesion * 100).toFixed(0)}%`
-            )
+            `  ${icon} ${color(item.severity.toUpperCase())}: ${chalk10.white(item.file.split("/").pop())} ${chalk10.dim(`(${item.contextBudget.toLocaleString()} tokens)`)}`
           );
         });
       }
@@ -1362,21 +1370,35 @@ async function contextAction(directory, options) {
 
 // src/commands/consistency.ts
 import chalk11 from "chalk";
-import { writeFileSync as writeFileSync3 } from "fs";
-import {
-  resolveOutputPath as resolveOutputPath2,
-  formatToolScore as formatToolScore2,
-  resolveOutputFormat as resolveOutputFormat2
-} from "@aiready/core";
+import { printTerminalHeader as printTerminalHeader3 } from "@aiready/core";
+function defineConsistencyCommand(program2) {
+  program2.command("consistency").description("Check naming conventions and architectural consistency").argument("[directory]", "Directory to analyze", ".").option("--naming", "Check naming conventions (default: true)").option("--no-naming", "Skip naming analysis").option("--patterns", "Check code patterns (default: true)").option("--no-patterns", "Skip pattern analysis").option(
+    "--min-severity <level>",
+    "Minimum severity: info|minor|major|critical",
+    "info"
+  ).option(
+    "--include <patterns>",
+    "File patterns to include (comma-separated)"
+  ).option(
+    "--exclude <patterns>",
+    "File patterns to exclude (comma-separated)"
+  ).option(
+    "-o, --output <format>",
+    "Output format: console, json, markdown",
+    "console"
+  ).option("--output-file <path>", "Output file path (for json/markdown)").option("--score", "Calculate and display AI Readiness Score (0-100)", true).option("--no-score", "Disable calculating AI Readiness Score").action(async (directory, options) => {
+    await consistencyAction(directory, options);
+  });
+}
 async function consistencyAction(directory, options) {
   return await executeToolAction(directory, options, {
     toolName: "naming-consistency",
     label: "Consistency analysis",
-    emoji: "\u{1F50D}",
+    emoji: "\u{1F4CF}",
     defaults: {
-      checkNaming: true,
-      checkPatterns: true,
-      minSeverity: "info",
+      checkNaming: options.naming !== false,
+      checkPatterns: options.patterns !== false,
+      minSeverity: options.minSeverity || "info",
       include: void 0,
       exclude: void 0,
       output: { format: "console", file: void 0 }
@@ -1387,119 +1409,68 @@ async function consistencyAction(directory, options) {
       minSeverity: opts.minSeverity
     }),
     importTool: async () => {
-      const { analyzeConsistency, calculateConsistencyScore } = await import("@aiready/consistency");
+      const { analyzeConsistency, generateSummary, calculateConsistencyScore } = await import("@aiready/consistency");
       return {
-        analyze: analyzeConsistency,
-        generateSummary: (report) => report.summary,
-        calculateScore: (summary, _resultsCount) => {
-          return calculateConsistencyScore(
-            summary.results?.flatMap((r) => r.issues) ?? [],
-            summary.summary.filesAnalyzed
-          );
-        }
+        analyze: async (opts) => {
+          const report = await analyzeConsistency(opts);
+          return report;
+        },
+        generateSummary,
+        calculateScore: calculateConsistencyScore
       };
     },
-    renderConsole: ({ results, summary, elapsedTime, score, finalOptions }) => {
-      const report = results;
-      const { format: outputFormat, file: userOutputFile } = resolveOutputFormat2(options, finalOptions);
-      if (outputFormat === "markdown") {
-        const markdown = generateMarkdownReport(report, elapsedTime);
-        const outputPath = resolveOutputPath2(
-          userOutputFile,
-          `aiready-report-${getReportTimestamp()}.md`,
-          directory
-        );
-        writeFileSync3(outputPath, markdown);
-        console.log(chalk11.green(`\u2705 Report saved to ${outputPath}`));
-        return;
-      }
-      console.log(chalk11.bold("\n\u{1F4CA} Summary\n"));
-      console.log(`Files Analyzed: ${chalk11.cyan(summary.filesAnalyzed)}`);
-      console.log(`Total Issues: ${chalk11.yellow(summary.totalIssues)}`);
-      console.log(`  Naming: ${chalk11.yellow(summary.namingIssues)}`);
-      console.log(`  Patterns: ${chalk11.yellow(summary.patternIssues)}`);
+    renderConsole: ({ results: report, summary, elapsedTime, score }) => {
+      printTerminalHeader3("CONSISTENCY ANALYSIS SUMMARY");
       console.log(
-        `  Architecture: ${chalk11.yellow(summary.architectureIssues ?? 0)}`
+        chalk11.white(`\u{1F4C1} Files analyzed: ${chalk11.bold(summary.filesAnalyzed)}`)
       );
-      console.log(`Analysis Time: ${chalk11.gray(elapsedTime + "s")}
-`);
-      if (summary.totalIssues === 0) {
-        console.log(
-          chalk11.green(
-            "\u2728 No consistency issues found! Your codebase is well-maintained.\n"
-          )
-        );
-      } else {
-        const namingResults = report.results.filter(
-          (r) => r.issues.some((i) => i.category === "naming")
-        );
-        const patternResults = report.results.filter(
-          (r) => r.issues.some((i) => i.category === "patterns")
-        );
-        if (namingResults.length > 0) {
-          console.log(chalk11.bold("\u{1F3F7}\uFE0F  Naming Issues\n"));
-          let shown = 0;
-          for (const namingFileResult of namingResults) {
-            if (shown >= 5) break;
-            for (const issue of namingFileResult.issues) {
-              if (shown >= 5) break;
-              const severityColor = issue.severity === "critical" ? chalk11.red : issue.severity === "major" ? chalk11.yellow : issue.severity === "minor" ? chalk11.blue : chalk11.gray;
-              console.log(
-                `${severityColor(issue.severity.toUpperCase())} ${chalk11.dim(`${issue.location.file}:${issue.location.line}`)}`
-              );
-              console.log(`  ${issue.message}`);
-              if (issue.suggestion) {
-                console.log(
-                  `  ${chalk11.dim("\u2192")} ${chalk11.italic(issue.suggestion)}`
-                );
-              }
-              console.log();
-              shown++;
-            }
-          }
-        }
-        if (patternResults.length > 0) {
-          console.log(chalk11.bold("\u{1F504} Pattern Issues\n"));
-          let shown = 0;
-          for (const patternFileResult of patternResults) {
-            if (shown >= 5) break;
-            for (const issue of patternFileResult.issues) {
-              if (shown >= 5) break;
-              const severityColor = issue.severity === "critical" ? chalk11.red : issue.severity === "major" ? chalk11.yellow : issue.severity === "minor" ? chalk11.blue : chalk11.gray;
-              console.log(
-                `${severityColor(issue.severity.toUpperCase())} ${chalk11.dim(`${issue.location.file}:${issue.location.line}`)}`
-              );
-              console.log(`  ${issue.message}`);
-              if (issue.suggestion) {
-                console.log(
-                  `  ${chalk11.dim("\u2192")} ${chalk11.italic(issue.suggestion)}`
-                );
-              }
-              console.log();
-              shown++;
-            }
+      console.log(
+        chalk11.white(`\u26A0  Total issues: ${chalk11.bold(summary.totalIssues)}`)
+      );
+      console.log(
+        chalk11.gray(`\u23F1  Analysis time: ${chalk11.bold(elapsedTime + "s")}`)
+      );
+      if (summary.totalIssues > 0 && report.results) {
+        renderSubSection("Issues Breakdown");
+        const sortedIssues = [...report.results].flatMap(
+          (file) => (file.issues || []).map((issue) => ({
+            ...issue,
+            file: file.fileName
+          }))
+        ).sort((a, b) => {
+          const levels = {
+            critical: 4,
+            major: 3,
+            minor: 2,
+            info: 1
+          };
+          return (levels[b.severity] || 0) - (levels[a.severity] || 0);
+        }).slice(0, 10);
+        sortedIssues.forEach((issue) => {
+          const icon = issue.severity === "critical" ? "\u{1F534}" : issue.severity === "major" ? "\u{1F7E1}" : "\u{1F535}";
+          const color = issue.severity === "critical" ? chalk11.red : issue.severity === "major" ? chalk11.yellow : chalk11.blue;
+          console.log(
+            `  ${icon} ${color(issue.severity.toUpperCase())}: ${chalk11.white(issue.file)}${issue.line ? `:${issue.line}` : ""}`
+          );
+          console.log(`     ${issue.message}`);
+          if (issue.suggestion) {
+            console.log(chalk11.dim(`     \u{1F4A1} ${issue.suggestion}`));
           }
-        }
-        if (report.recommendations?.length > 0) {
-          console.log(chalk11.bold("\u{1F4A1} Recommendations\n"));
-          report.recommendations.forEach((rec, i) => {
-            console.log(`${i + 1}. ${rec}`);
-          });
           console.log();
-        }
-      }
-      if (score) {
-        console.log(chalk11.bold("\n\u{1F4CA} AI Readiness Score (Consistency)\n"));
-        console.log(formatToolScore2(score));
-        console.log();
+        });
+      } else {
+        console.log(
+          chalk11.green("\n\u2728 Great! No consistency issues detected.\n")
+        );
       }
+      renderToolScoreFooter(score);
     }
   });
 }
 
 // src/commands/visualize.ts
 import chalk12 from "chalk";
-import { writeFileSync as writeFileSync4, readFileSync as readFileSync3, existsSync as existsSync3, copyFileSync } from "fs";
+import { writeFileSync as writeFileSync3, readFileSync as readFileSync3, existsSync as existsSync3, copyFileSync } from "fs";
 import { resolve as resolvePath5 } from "path";
 import { spawn } from "child_process";
 import { handleCLIError as handleCLIError4 } from "@aiready/core";
@@ -1669,7 +1640,7 @@ Or specify a custom report:
     const html = generateHTML(graph);
     const defaultOutput = "visualization.html";
     const outPath = resolvePath5(dirPath, options.output ?? defaultOutput);
-    writeFileSync4(outPath, html, "utf8");
+    writeFileSync3(outPath, html, "utf8");
     console.log(chalk12.green(`\u2705 Visualization written to: ${outPath}`));
     if (options.open || options.serve) {
       const opener = process.platform === "darwin" ? "open" : process.platform === "win32" ? "start" : "xdg-open";
@@ -1953,11 +1924,11 @@ EXAMPLES:
 import chalk18 from "chalk";
 import { resolve as resolvePath6 } from "path";
 import { existsSync as existsSync4, readdirSync } from "fs";
-import { printTerminalHeader as printTerminalHeader3 } from "@aiready/core";
+import { printTerminalHeader as printTerminalHeader4 } from "@aiready/core";
 async function remediateAction(directory, options) {
   const resolvedDir = resolvePath6(process.cwd(), directory || ".");
   const serverUrl = options.server || "https://platform.getaiready.dev";
-  printTerminalHeader3("AIREADY REMEDIATION SWARM");
+  printTerminalHeader4("AIREADY REMEDIATION SWARM");
   console.log(chalk18.cyan("\u{1F916} Initializing local remediation agent..."));
   let reportPath = options.report;
   if (!reportPath) {
@@ -2075,42 +2046,15 @@ CONFIGURATION:
   Config files (searched upward): aiready.json, .aiready.json, aiready.config.*
   CLI options override config file settings
 
-  Example aiready.json:
-  {
-    "scan": { "exclude": ["**/dist/**", "**/node_modules/**"] },
-    "tools": {
-      "pattern-detect": { "minSimilarity": 0.5 },
-      "context-analyzer": { "maxContextBudget": 15000 }
-    },
-    "output": { "format": "json", "directory": ".aiready" }
-  }
-
 VERSION: ${packageJson.version}
 DOCUMENTATION: https://aiready.dev/docs/cli
 GITHUB: https://github.com/caopengau/aiready-cli
 LANDING: https://github.com/caopengau/aiready-landing`
 );
-program.command("scan").description(
-  "Run comprehensive AI-readiness analysis (patterns + context + consistency)"
-).argument("[directory]", "Directory to analyze", ".").option(
-  "-t, --tools <tools>",
-  "Tools to run (comma-separated: patterns,context,consistency,doc-drift,deps-health,aiSignalClarity,grounding,testability,changeAmplification)"
-).option(
-  "--profile <type>",
-  "Scan profile to use (agentic, cost, logic, ui, security, onboarding)"
-).option(
-  "--compare-to <path>",
-  "Compare results against a previous AIReady report JSON"
-).option("--include <patterns>", "File patterns to include (comma-separated)").option("--exclude <patterns>", "File patterns to exclude (comma-separated)").option("-o, --output <format>", "Output format: console, json", "console").option("--output-file <path>", "Output file path (for json)").option("--score", "Calculate and display AI Readiness Score (0-100)").option("--no-score", "Disable calculating AI Readiness Score").option("--weights <weights>", "Custom scoring weights").option("--threshold <score>", "Fail CI/CD if score below threshold (0-100)").option(
-  "--ci",
-  "CI mode: GitHub Actions annotations, no colors, fail on threshold"
-).option(
-  "--fail-on <level>",
-  "Fail on issues: critical, major, any",
-  "critical"
-).option("--api-key <key>", "Platform API key for automatic upload").option("--upload", "Automatically upload results to the platform").option("--server <url>", "Custom platform URL").addHelpText("after", SCAN_HELP_TEXT).action(async (directory, options) => {
-  await scanAction(directory, options);
-});
+defineScanCommand(program);
+definePatternsCommand(program);
+defineContextCommand(program);
+defineConsistencyCommand(program);
 program.command("init").description("Generate a default configuration (aiready.json)").option("-f, --force", "Overwrite existing configuration file").option(
   "--js",
   "Generate configuration as a JavaScript file (aiready.config.js)"
@@ -2118,36 +2062,6 @@ program.command("init").description("Generate a default configuration (aiready.j
   const format = options.js ? "js" : "json";
   await initAction({ force: options.force, format, full: options.full });
 });
-program.command("patterns").description("Detect duplicate code patterns that confuse AI models").argument("[directory]", "Directory to analyze", ".").option("-s, --similarity <number>", "Minimum similarity score (0-1)", "0.40").option("-l, --min-lines <number>", "Minimum lines to consider", "5").option(
-  "--max-candidates <number>",
-  "Maximum candidates per block (performance tuning)"
-).option(
-  "--min-shared-tokens <number>",
-  "Minimum shared tokens for candidates (performance tuning)"
-).option(
-  "--full-scan",
-  "Disable smart defaults for comprehensive analysis (slower)"
-).option("--include <patterns>", "File patterns to include (comma-separated)").option("--exclude <patterns>", "File patterns to exclude (comma-separated)").option("-o, --output <format>", "Output format: console, json", "console").option("--output-file <path>", "Output file path (for json)").option("--score", "Calculate and display AI Readiness Score (0-100)").option("--no-score", "Disable calculating AI Readiness Score").addHelpText("after", PATTERNS_HELP_TEXT).action(async (directory, options) => {
-  await patternsAction(directory, options);
-});
-program.command("context").description("Analyze context window costs and dependency fragmentation").argument("[directory]", "Directory to analyze", ".").option("--max-depth <number>", "Maximum acceptable import depth", "5").option(
-  "--max-context <number>",
-  "Maximum acceptable context budget (tokens)",
-  "10000"
-).option("--include <patterns>", "File patterns to include (comma-separated)").option("--exclude <patterns>", "File patterns to exclude (comma-separated)").option("-o, --output <format>", "Output format: console, json", "console").option("--output-file <path>", "Output file path (for json)").option("--score", "Calculate and display AI Readiness Score (0-100)", true).option("--no-score", "Disable calculating AI Readiness Score").action(async (directory, options) => {
-  await contextAction(directory, options);
-});
-program.command("consistency").description("Check naming conventions and architectural consistency").argument("[directory]", "Directory to analyze", ".").option("--naming", "Check naming conventions (default: true)").option("--no-naming", "Skip naming analysis").option("--patterns", "Check code patterns (default: true)").option("--no-patterns", "Skip pattern analysis").option(
-  "--min-severity <level>",
-  "Minimum severity: info|minor|major|critical",
-  "info"
-).option("--include <patterns>", "File patterns to include (comma-separated)").option("--exclude <patterns>", "File patterns to exclude (comma-separated)").option(
-  "-o, --output <format>",
-  "Output format: console, json, markdown",
-  "console"
-).option("--output-file <path>", "Output file path (for json/markdown)").option("--score", "Calculate and display AI Readiness Score (0-100)", true).option("--no-score", "Disable calculating AI Readiness Score").action(async (directory, options) => {
-  await consistencyAction(directory, options);
-});
 program.command("visualise").description("Alias for visualize (British spelling)").argument("[directory]", "Directory to analyze", ".").option(
   "--report <path>",
   "Report path (auto-detects latest .aiready/aiready-report-*.json if not provided)"

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aiready/cli",
-  "version": "0.15.0",
+  "version": "0.15.2",
   "description": "Assess and improve your codebase's AI-readiness. Get an AI Readiness Score (0-100) and detect semantic duplicates, context fragmentation, and naming inconsistencies.",
   "main": "./dist/index.js",
   "module": "./dist/index.mjs",
@@ -24,18 +24,18 @@
   "dependencies": {
     "chalk": "^5.3.0",
     "commander": "^14.0.0",
-    "@aiready/agent-grounding": "0.14.0",
-    "@aiready/consistency": "0.21.0",
-    "@aiready/deps": "0.14.0",
-    "@aiready/context-analyzer": "0.22.0",
-    "@aiready/core": "0.24.0",
-    "@aiready/doc-drift": "0.14.0",
-    "@aiready/change-amplification": "0.14.0",
-    "@aiready/contract-enforcement": "0.2.0",
-    "@aiready/ai-signal-clarity": "0.14.0",
-    "@aiready/pattern-detect": "0.17.0",
-    "@aiready/testability": "0.7.0",
-    "@aiready/visualizer": "0.7.0"
+    "@aiready/agent-grounding": "0.14.2",
+    "@aiready/consistency": "0.21.2",
+    "@aiready/context-analyzer": "0.22.2",
+    "@aiready/core": "0.24.2",
+    "@aiready/deps": "0.14.2",
+    "@aiready/doc-drift": "0.14.2",
+    "@aiready/change-amplification": "0.14.2",
+    "@aiready/contract-enforcement": "0.2.2",
+    "@aiready/ai-signal-clarity": "0.14.2",
+    "@aiready/pattern-detect": "0.17.2",
+    "@aiready/testability": "0.7.2",
+    "@aiready/visualizer": "0.7.2"
   },
   "devDependencies": {
     "@types/node": "^24.0.0",