@aiready/cli 0.15.1 → 0.15.2

package/dist/cli.js

@@ -25,7 +25,7 @@ var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__ge
 
 // src/cli.ts
 var import_commander = require("commander");
-var import_fs9 = require("fs");
+var import_fs8 = require("fs");
 var import_path8 = require("path");
 var import_url = require("url");
 
@@ -96,38 +96,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
 var import_chalk2 = __toESM(require("chalk"));
@@ -1170,6 +1138,38 @@ ${import_chalk6.default.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
 var import_fs5 = require("fs");
@@ -1449,33 +1449,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(import_chalk8.default.green("\u2705 No significant issues found!\n"));
-    return;
-  }
-  console.log(import_chalk8.default.bold("\u26A0\uFE0F  Issues Found:\n"));
-  if (summary.criticalIssues > 0)
-    console.log(
-      import_chalk8.default.red(`   \u{1F534} Critical: ${import_chalk8.default.bold(summary.criticalIssues)}`)
-    );
-  if (summary.majorIssues > 0)
-    console.log(
-      import_chalk8.default.yellow(`   \u{1F7E1} Major: ${import_chalk8.default.bold(summary.majorIssues)}`)
-    );
-  if (summary.minorIssues > 0)
-    console.log(import_chalk8.default.blue(`   \u{1F535} Minor: ${import_chalk8.default.bold(summary.minorIssues)}`));
-  if (summary.totalPotentialSavings) {
-    console.log(
-      import_chalk8.default.green(
-        `
-   \u{1F4A1} Potential savings: ${import_chalk8.default.bold(summary.totalPotentialSavings.toLocaleString())} tokens
-`
-      )
-    );
-  }
-}
 function renderSubSection(title) {
   console.log("\n" + (0, import_core12.getTerminalDivider)());
   console.log(import_chalk8.default.bold.white(`  ${title.toUpperCase()}`));
@@ -1492,6 +1465,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",
@@ -1571,21 +1574,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
 var import_chalk10 = __toESM(require("chalk"));
 var import_core14 = require("@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,
@@ -1597,11 +1609,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 {
@@ -1610,45 +1617,40 @@ async function contextAction(directory, options) {
         calculateScore: calculateContextScore
       };
     },
-    renderConsole: ({ summary, elapsedTime, score }) => {
+    renderConsole: ({ results: _results, summary, elapsedTime, score }) => {
       (0, import_core14.printTerminalHeader)("CONTEXT ANALYSIS SUMMARY");
       console.log(
-        import_chalk10.default.white(`\u{1F4C1} Files analyzed: ${import_chalk10.default.bold(summary.totalFiles)}`)
+        import_chalk10.default.white(`\u{1F4C1} Total files: ${import_chalk10.default.bold(summary.totalFiles)}`)
       );
       console.log(
         import_chalk10.default.white(
-          `\u{1F4CA} Total tokens: ${import_chalk10.default.bold(summary.totalTokens.toLocaleString())}`
+          `\u{1F4B8} Total tokens (context budget): ${import_chalk10.default.bold(summary.totalTokens.toLocaleString())}`
         )
       );
       console.log(
-        import_chalk10.default.yellow(
-          `\u{1F4B0} Avg context budget: ${import_chalk10.default.bold(summary.avgContextBudget.toFixed(0))} tokens/file`
+        import_chalk10.default.cyan(
+          `\u{1F4CA} Average context budget: ${import_chalk10.default.bold(summary.avgContextBudget.toFixed(0))} tokens`
         )
       );
       console.log(
-        import_chalk10.default.white(`\u23F1  Analysis time: ${import_chalk10.default.bold(elapsedTime + "s")}
-`)
+        import_chalk10.default.gray(`\u23F1  Analysis time: ${import_chalk10.default.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 ? import_chalk10.default.red : mod.fragmentationScore > 0.4 ? import_chalk10.default.yellow : import_chalk10.default.green;
           console.log(
-            `   ${import_chalk10.default.cyan("\u2192")} ${import_chalk10.default.white(fileName)} ${import_chalk10.default.dim(`(depth: ${item.depth})`)}`
+            `  ${scoreColor("\u25A0")} ${import_chalk10.default.white(mod.domain.padEnd(20))} ${import_chalk10.default.bold((mod.fragmentationScore * 100).toFixed(0) + "%")} fragmentation`
           );
         });
       }
-      if (summary.fragmentedModules && summary.fragmentedModules.length > 0) {
-        renderSubSection("Fragmented Modules");
-        summary.fragmentedModules.slice(0, 10).forEach((module2) => {
+      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" ? import_chalk10.default.red : item.severity === "major" ? import_chalk10.default.yellow : import_chalk10.default.blue;
           console.log(
-            `   ${import_chalk10.default.yellow("\u25CF")} ${import_chalk10.default.white(module2.domain)} - ${import_chalk10.default.dim(`${module2.files.length} files, ${(module2.fragmentationScore * 100).toFixed(0)}% scattered`)}`
-          );
-          console.log(
-            import_chalk10.default.dim(
-              `     Token cost: ${module2.totalTokens.toLocaleString()}, Cohesion: ${(module2.avgCohesion * 100).toFixed(0)}%`
-            )
+            `  ${icon} ${color(item.severity.toUpperCase())}: ${import_chalk10.default.white(item.file.split("/").pop())} ${import_chalk10.default.dim(`(${item.contextBudget.toLocaleString()} tokens)`)}`
           );
         });
       }
@@ -1659,17 +1661,35 @@ async function contextAction(directory, options) {
 
 // src/commands/consistency.ts
 var import_chalk11 = __toESM(require("chalk"));
-var import_fs6 = require("fs");
 var import_core15 = require("@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 }
@@ -1680,119 +1700,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 } = (0, import_core15.resolveOutputFormat)(options, finalOptions);
-      if (outputFormat === "markdown") {
-        const markdown = generateMarkdownReport(report, elapsedTime);
-        const outputPath = (0, import_core15.resolveOutputPath)(
-          userOutputFile,
-          `aiready-report-${(0, import_core2.getReportTimestamp)()}.md`,
-          directory
-        );
-        (0, import_fs6.writeFileSync)(outputPath, markdown);
-        console.log(import_chalk11.default.green(`\u2705 Report saved to ${outputPath}`));
-        return;
-      }
-      console.log(import_chalk11.default.bold("\n\u{1F4CA} Summary\n"));
-      console.log(`Files Analyzed: ${import_chalk11.default.cyan(summary.filesAnalyzed)}`);
-      console.log(`Total Issues: ${import_chalk11.default.yellow(summary.totalIssues)}`);
-      console.log(`  Naming: ${import_chalk11.default.yellow(summary.namingIssues)}`);
-      console.log(`  Patterns: ${import_chalk11.default.yellow(summary.patternIssues)}`);
+    renderConsole: ({ results: report, summary, elapsedTime, score }) => {
+      (0, import_core15.printTerminalHeader)("CONSISTENCY ANALYSIS SUMMARY");
       console.log(
-        `  Architecture: ${import_chalk11.default.yellow(summary.architectureIssues ?? 0)}`
+        import_chalk11.default.white(`\u{1F4C1} Files analyzed: ${import_chalk11.default.bold(summary.filesAnalyzed)}`)
       );
-      console.log(`Analysis Time: ${import_chalk11.default.gray(elapsedTime + "s")}
-`);
-      if (summary.totalIssues === 0) {
-        console.log(
-          import_chalk11.default.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(import_chalk11.default.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" ? import_chalk11.default.red : issue.severity === "major" ? import_chalk11.default.yellow : issue.severity === "minor" ? import_chalk11.default.blue : import_chalk11.default.gray;
-              console.log(
-                `${severityColor(issue.severity.toUpperCase())} ${import_chalk11.default.dim(`${issue.location.file}:${issue.location.line}`)}`
-              );
-              console.log(`  ${issue.message}`);
-              if (issue.suggestion) {
-                console.log(
-                  `  ${import_chalk11.default.dim("\u2192")} ${import_chalk11.default.italic(issue.suggestion)}`
-                );
-              }
-              console.log();
-              shown++;
-            }
-          }
-        }
-        if (patternResults.length > 0) {
-          console.log(import_chalk11.default.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" ? import_chalk11.default.red : issue.severity === "major" ? import_chalk11.default.yellow : issue.severity === "minor" ? import_chalk11.default.blue : import_chalk11.default.gray;
-              console.log(
-                `${severityColor(issue.severity.toUpperCase())} ${import_chalk11.default.dim(`${issue.location.file}:${issue.location.line}`)}`
-              );
-              console.log(`  ${issue.message}`);
-              if (issue.suggestion) {
-                console.log(
-                  `  ${import_chalk11.default.dim("\u2192")} ${import_chalk11.default.italic(issue.suggestion)}`
-                );
-              }
-              console.log();
-              shown++;
-            }
+      console.log(
+        import_chalk11.default.white(`\u26A0  Total issues: ${import_chalk11.default.bold(summary.totalIssues)}`)
+      );
+      console.log(
+        import_chalk11.default.gray(`\u23F1  Analysis time: ${import_chalk11.default.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" ? import_chalk11.default.red : issue.severity === "major" ? import_chalk11.default.yellow : import_chalk11.default.blue;
+          console.log(
+            `  ${icon} ${color(issue.severity.toUpperCase())}: ${import_chalk11.default.white(issue.file)}${issue.line ? `:${issue.line}` : ""}`
+          );
+          console.log(`     ${issue.message}`);
+          if (issue.suggestion) {
+            console.log(import_chalk11.default.dim(`     \u{1F4A1} ${issue.suggestion}`));
           }
-        }
-        if (report.recommendations?.length > 0) {
-          console.log(import_chalk11.default.bold("\u{1F4A1} Recommendations\n"));
-          report.recommendations.forEach((rec, i) => {
-            console.log(`${i + 1}. ${rec}`);
-          });
           console.log();
-        }
-      }
-      if (score) {
-        console.log(import_chalk11.default.bold("\n\u{1F4CA} AI Readiness Score (Consistency)\n"));
-        console.log((0, import_core15.formatToolScore)(score));
-        console.log();
+        });
+      } else {
+        console.log(
+          import_chalk11.default.green("\n\u2728 Great! No consistency issues detected.\n")
+        );
       }
+      renderToolScoreFooter(score);
     }
   });
 }
 
 // src/commands/visualize.ts
 var import_chalk12 = __toESM(require("chalk"));
-var import_fs7 = require("fs");
+var import_fs6 = require("fs");
 var import_path6 = require("path");
 var import_child_process = require("child_process");
 var import_core16 = require("@aiready/core");
@@ -1801,7 +1770,7 @@ async function visualizeAction(directory, options) {
   try {
     const dirPath = (0, import_path6.resolve)(process.cwd(), directory ?? ".");
     let reportPath = options.report ? (0, import_path6.resolve)(dirPath, options.report) : null;
-    if (!reportPath || !(0, import_fs7.existsSync)(reportPath)) {
+    if (!reportPath || !(0, import_fs6.existsSync)(reportPath)) {
       const latestScan = (0, import_core17.findLatestReport)(dirPath);
       if (latestScan) {
         reportPath = latestScan;
@@ -1823,13 +1792,13 @@ Or specify a custom report:
         return;
       }
     }
-    const raw = (0, import_fs7.readFileSync)(reportPath, "utf8");
+    const raw = (0, import_fs6.readFileSync)(reportPath, "utf8");
     const report = JSON.parse(raw);
     const configPath = (0, import_path6.resolve)(dirPath, "aiready.json");
     let graphConfig = { maxNodes: 400, maxEdges: 600 };
-    if ((0, import_fs7.existsSync)(configPath)) {
+    if ((0, import_fs6.existsSync)(configPath)) {
       try {
-        const rawConfig = JSON.parse((0, import_fs7.readFileSync)(configPath, "utf8"));
+        const rawConfig = JSON.parse((0, import_fs6.readFileSync)(configPath, "utf8"));
         if (rawConfig.visualizer?.graph) {
           graphConfig = {
             maxNodes: rawConfig.visualizer.graph.maxNodes ?? graphConfig.maxNodes,
@@ -1852,7 +1821,7 @@ Or specify a custom report:
         const localWebDir = (0, import_path6.resolve)(dirPath, "packages/visualizer");
         let webDir = "";
         let visualizerAvailable = false;
-        if ((0, import_fs7.existsSync)(localWebDir)) {
+        if ((0, import_fs6.existsSync)(localWebDir)) {
           webDir = localWebDir;
           visualizerAvailable = true;
         } else {
@@ -1875,7 +1844,7 @@ Or specify a custom report:
             currentDir = parent;
           }
           for (const location of nodemodulesLocations) {
-            if ((0, import_fs7.existsSync)(location) && (0, import_fs7.existsSync)((0, import_path6.resolve)(location, "package.json"))) {
+            if ((0, import_fs6.existsSync)(location) && (0, import_fs6.existsSync)((0, import_path6.resolve)(location, "package.json"))) {
               webDir = location;
               visualizerAvailable = true;
               break;
@@ -1891,14 +1860,14 @@ Or specify a custom report:
             }
           }
         }
-        const webViteConfigExists = webDir && (0, import_fs7.existsSync)((0, import_path6.resolve)(webDir, "web", "vite.config.ts"));
+        const webViteConfigExists = webDir && (0, import_fs6.existsSync)((0, import_path6.resolve)(webDir, "web", "vite.config.ts"));
         if (visualizerAvailable && webViteConfigExists) {
           const spawnCwd = webDir;
           const { watch } = await import("fs");
           const copyReportToViz = () => {
             try {
               const destPath = (0, import_path6.resolve)(spawnCwd, "web", "report-data.json");
-              (0, import_fs7.copyFileSync)(reportPath, destPath);
+              (0, import_fs6.copyFileSync)(reportPath, destPath);
               console.log(`\u{1F4CB} Report synced to ${destPath}`);
             } catch (e) {
               console.error("Failed to sync report:", e);
@@ -1962,7 +1931,7 @@ Or specify a custom report:
     const html = (0, import_core17.generateHTML)(graph);
     const defaultOutput = "visualization.html";
     const outPath = (0, import_path6.resolve)(dirPath, options.output ?? defaultOutput);
-    (0, import_fs7.writeFileSync)(outPath, html, "utf8");
+    (0, import_fs6.writeFileSync)(outPath, html, "utf8");
     console.log(import_chalk12.default.green(`\u2705 Visualization written to: ${outPath}`));
     if (options.open || options.serve) {
       const opener = process.platform === "darwin" ? "open" : process.platform === "win32" ? "start" : "xdg-open";
@@ -2245,7 +2214,7 @@ EXAMPLES:
 // src/commands/remediate.ts
 var import_chalk18 = __toESM(require("chalk"));
 var import_path7 = require("path");
-var import_fs8 = require("fs");
+var import_fs7 = require("fs");
 var import_core18 = require("@aiready/core");
 async function remediateAction(directory, options) {
   const resolvedDir = (0, import_path7.resolve)(process.cwd(), directory || ".");
@@ -2255,15 +2224,15 @@ async function remediateAction(directory, options) {
   let reportPath = options.report;
   if (!reportPath) {
     const aireadyDir = (0, import_path7.resolve)(resolvedDir, ".aiready");
-    if ((0, import_fs8.existsSync)(aireadyDir)) {
-      const files = (0, import_fs8.readdirSync)(aireadyDir).filter((f) => f.startsWith("aiready-report-") && f.endsWith(".json")).sort().reverse();
+    if ((0, import_fs7.existsSync)(aireadyDir)) {
+      const files = (0, import_fs7.readdirSync)(aireadyDir).filter((f) => f.startsWith("aiready-report-") && f.endsWith(".json")).sort().reverse();
       if (files.length > 0) {
         reportPath = (0, import_path7.resolve)(aireadyDir, files[0]);
         console.log(import_chalk18.default.dim(`\u{1F4C2} Using latest report: ${files[0]}`));
       }
     }
   }
-  if (!reportPath || !(0, import_fs8.existsSync)(reportPath)) {
+  if (!reportPath || !(0, import_fs7.existsSync)(reportPath)) {
     console.log(import_chalk18.default.yellow("\n\u26A0\uFE0F  No AIReady report found."));
     console.log(
       import_chalk18.default.dim(
@@ -2340,7 +2309,7 @@ var getDirname = () => {
   return (0, import_path8.dirname)((0, import_url.fileURLToPath)(import_meta.url));
 };
 var packageJson = JSON.parse(
-  (0, import_fs9.readFileSync)((0, import_path8.join)(getDirname(), "../package.json"), "utf8")
+  (0, import_fs8.readFileSync)((0, import_path8.join)(getDirname(), "../package.json"), "utf8")
 );
 var program = new import_commander.Command();
 program.name("aiready").description("AIReady - Assess and improve AI-readiness of codebases").version(packageJson.version).addHelpText(
@@ -2369,42 +2338,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)"
@@ -2412,36 +2354,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/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";
@@ -876,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";
@@ -1158,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()}`));
@@ -1201,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",
@@ -1280,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,
@@ -1306,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 {
@@ -1319,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)`)}`
           );
         });
       }
@@ -1368,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 }
@@ -1393,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";
@@ -1675,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";
@@ -1959,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) {
@@ -2081,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)"
@@ -2124,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.1",
+  "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.1",
-    "@aiready/consistency": "0.21.1",
-    "@aiready/context-analyzer": "0.22.1",
-    "@aiready/core": "0.24.1",
-    "@aiready/deps": "0.14.1",
-    "@aiready/doc-drift": "0.14.1",
-    "@aiready/ai-signal-clarity": "0.14.1",
-    "@aiready/change-amplification": "0.14.1",
-    "@aiready/pattern-detect": "0.17.1",
-    "@aiready/visualizer": "0.7.1",
-    "@aiready/testability": "0.7.1",
-    "@aiready/contract-enforcement": "0.2.1"
+    "@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",