@aiready/cli 0.9.40 → 0.9.43

package/dist/cli.js

@@ -54,8 +54,14 @@ function sortBySeverity(results) {
     });
     return { ...file, issues: sortedIssues };
   }).sort((a, b) => {
-    const aMaxSeverity = Math.max(...a.issues.map((i) => severityOrder[i.severity] || 0), 0);
-    const bMaxSeverity = Math.max(...b.issues.map((i) => severityOrder[i.severity] || 0), 0);
+    const aMaxSeverity = Math.max(
+      ...a.issues.map((i) => severityOrder[i.severity] || 0),
+      0
+    );
+    const bMaxSeverity = Math.max(
+      ...b.issues.map((i) => severityOrder[i.severity] || 0),
+      0
+    );
     if (aMaxSeverity !== bMaxSeverity) {
       return bMaxSeverity - aMaxSeverity;
     }
@@ -122,7 +128,8 @@ async function analyzeUnified(options) {
     const report = await analyzeDocDrift({
       rootDir: options.rootDir,
       include: options.include,
-      exclude: options.exclude
+      exclude: options.exclude,
+      onProgress: options.onProgress
     });
     if (options.progressCallback) {
       options.progressCallback({ tool: "doc-drift", data: report });
@@ -135,7 +142,8 @@ async function analyzeUnified(options) {
     const report = await analyzeDeps({
       rootDir: options.rootDir,
       include: options.include,
-      exclude: options.exclude
+      exclude: options.exclude,
+      onProgress: options.onProgress
     });
     if (options.progressCallback) {
       options.progressCallback({ tool: "deps-health", data: report });
@@ -148,20 +156,25 @@ async function analyzeUnified(options) {
     const report = await analyzeAiSignalClarity({
       rootDir: options.rootDir,
       include: options.include,
-      exclude: options.exclude
+      exclude: options.exclude,
+      onProgress: options.onProgress
     });
     if (options.progressCallback) {
       options.progressCallback({ tool: "aiSignalClarity", data: report });
     }
     result.aiSignalClarity = report;
-    result.summary.totalIssues += report.results?.reduce((sum, r) => sum + (r.issues?.length || 0), 0) || 0;
+    result.summary.totalIssues += report.results?.reduce(
+      (sum, r) => sum + (r.issues?.length || 0),
+      0
+    ) || 0;
   }
   if (tools.includes("grounding")) {
     const { analyzeAgentGrounding } = await import("@aiready/agent-grounding");
     const report = await analyzeAgentGrounding({
       rootDir: options.rootDir,
       include: options.include,
-      exclude: options.exclude
+      exclude: options.exclude,
+      onProgress: options.onProgress
     });
     if (options.progressCallback) {
       options.progressCallback({ tool: "grounding", data: report });
@@ -174,7 +187,8 @@ async function analyzeUnified(options) {
     const report = await analyzeTestability({
       rootDir: options.rootDir,
       include: options.include,
-      exclude: options.exclude
+      exclude: options.exclude,
+      onProgress: options.onProgress
     });
     if (options.progressCallback) {
       options.progressCallback({ tool: "testability", data: report });
@@ -187,7 +201,8 @@ async function analyzeUnified(options) {
     const report = await analyzeChangeAmplification({
       rootDir: options.rootDir,
       include: options.include,
-      exclude: options.exclude
+      exclude: options.exclude,
+      onProgress: options.onProgress
     });
     if (options.progressCallback) {
       options.progressCallback({ tool: "changeAmplification", data: report });
@@ -213,19 +228,28 @@ function findLatestScanReport(dirPath) {
   if (!(0, import_fs.existsSync)(aireadyDir)) {
     return null;
   }
-  let files = (0, import_fs.readdirSync)(aireadyDir).filter((f) => f.startsWith("aiready-report-") && f.endsWith(".json"));
+  let files = (0, import_fs.readdirSync)(aireadyDir).filter(
+    (f) => f.startsWith("aiready-report-") && f.endsWith(".json")
+  );
   if (files.length === 0) {
-    files = (0, import_fs.readdirSync)(aireadyDir).filter((f) => f.startsWith("aiready-scan-") && f.endsWith(".json"));
+    files = (0, import_fs.readdirSync)(aireadyDir).filter(
+      (f) => f.startsWith("aiready-scan-") && f.endsWith(".json")
+    );
   }
   if (files.length === 0) {
     return null;
   }
-  const sortedFiles = files.map((f) => ({ name: f, path: (0, import_path.resolve)(aireadyDir, f), mtime: (0, import_fs.statSync)((0, import_path.resolve)(aireadyDir, f)).mtime })).sort((a, b) => b.mtime.getTime() - a.mtime.getTime());
+  const sortedFiles = files.map((f) => ({
+    name: f,
+    path: (0, import_path.resolve)(aireadyDir, f),
+    mtime: (0, import_fs.statSync)((0, import_path.resolve)(aireadyDir, f)).mtime
+  })).sort((a, b) => b.mtime.getTime() - a.mtime.getTime());
   return sortedFiles[0].path;
 }
-function warnIfGraphCapExceeded(report, dirPath) {
+async function warnIfGraphCapExceeded(report, dirPath) {
   try {
-    const { loadConfig: loadConfig4 } = require("@aiready/core");
+    const { loadConfig: loadConfig4 } = await import("@aiready/core");
+    void loadConfig4;
     let graphConfig = { maxNodes: 400, maxEdges: 600 };
     const configPath = (0, import_path.resolve)(dirPath, "aiready.json");
     if ((0, import_fs.existsSync)(configPath)) {
@@ -237,7 +261,8 @@ function warnIfGraphCapExceeded(report, dirPath) {
             maxEdges: rawConfig.visualizer.graph.maxEdges ?? graphConfig.maxEdges
           };
         }
-      } catch (e) {
+      } catch (err) {
+        void err;
       }
     }
     const nodeCount = (report.context?.length || 0) + (report.patterns?.length || 0);
@@ -248,21 +273,30 @@ function warnIfGraphCapExceeded(report, dirPath) {
     }, 0) || 0;
     if (nodeCount > graphConfig.maxNodes || edgeCount > graphConfig.maxEdges) {
       console.log("");
-      console.log(import_chalk.default.yellow(`\u26A0\uFE0F  Graph may be truncated at visualization time:`));
+      console.log(
+        import_chalk.default.yellow(`\u26A0\uFE0F  Graph may be truncated at visualization time:`)
+      );
       if (nodeCount > graphConfig.maxNodes) {
-        console.log(import_chalk.default.dim(`   \u2022 Nodes: ${nodeCount} > limit ${graphConfig.maxNodes}`));
+        console.log(
+          import_chalk.default.dim(`   \u2022 Nodes: ${nodeCount} > limit ${graphConfig.maxNodes}`)
+        );
       }
       if (edgeCount > graphConfig.maxEdges) {
-        console.log(import_chalk.default.dim(`   \u2022 Edges: ${edgeCount} > limit ${graphConfig.maxEdges}`));
+        console.log(
+          import_chalk.default.dim(`   \u2022 Edges: ${edgeCount} > limit ${graphConfig.maxEdges}`)
+        );
       }
       console.log(import_chalk.default.dim(`   To increase limits, add to aiready.json:`));
       console.log(import_chalk.default.dim(`   {`));
       console.log(import_chalk.default.dim(`     "visualizer": {`));
-      console.log(import_chalk.default.dim(`       "graph": { "maxNodes": 2000, "maxEdges": 5000 }`));
+      console.log(
+        import_chalk.default.dim(`       "graph": { "maxNodes": 2000, "maxEdges": 5000 }`)
+      );
       console.log(import_chalk.default.dim(`     }`));
       console.log(import_chalk.default.dim(`   }`));
     }
-  } catch (e) {
+  } catch (err) {
+    void err;
   }
 }
 function generateMarkdownReport(report, elapsedTime) {
@@ -311,7 +345,17 @@ async function scanAction(directory, options) {
   const resolvedDir = (0, import_path2.resolve)(process.cwd(), directory || ".");
   try {
     const defaults = {
-      tools: ["patterns", "context", "consistency", "aiSignalClarity", "grounding", "testability", "doc-drift", "deps-health", "changeAmplification"],
+      tools: [
+        "patterns",
+        "context",
+        "consistency",
+        "aiSignalClarity",
+        "grounding",
+        "testability",
+        "doc-drift",
+        "deps-health",
+        "changeAmplification"
+      ],
       include: void 0,
       exclude: void 0,
       output: {
@@ -321,7 +365,8 @@ async function scanAction(directory, options) {
     };
     let profileTools = options.tools ? options.tools.split(",").map((t) => {
       const tool = t.trim();
-      if (tool === "hallucination" || tool === "hallucination-risk") return "aiSignalClarity";
+      if (tool === "hallucination" || tool === "hallucination-risk")
+        return "aiSignalClarity";
       return tool;
     }) : void 0;
     if (options.profile) {
@@ -339,8 +384,12 @@ async function scanAction(directory, options) {
           profileTools = ["context", "consistency", "grounding"];
           break;
         default:
-          console.log(import_chalk2.default.yellow(`
-\u26A0\uFE0F  Unknown profile '${options.profile}'. Using specified tools or defaults.`));
+          console.log(
+            import_chalk2.default.yellow(
+              `
+\u26A0\uFE0F  Unknown profile '${options.profile}'. Using specified tools or defaults.`
+            )
+          );
       }
     }
     const cliOverrides = {
@@ -350,20 +399,41 @@ async function scanAction(directory, options) {
     if (profileTools) {
       cliOverrides.tools = profileTools;
     }
-    const baseOptions = await (0, import_core.loadMergedConfig)(resolvedDir, defaults, cliOverrides);
+    const baseOptions = await (0, import_core.loadMergedConfig)(
+      resolvedDir,
+      defaults,
+      cliOverrides
+    );
     let finalOptions = { ...baseOptions };
     if (baseOptions.tools.includes("patterns")) {
       const { getSmartDefaults } = await import("@aiready/pattern-detect");
-      const patternSmartDefaults = await getSmartDefaults(resolvedDir, baseOptions);
-      finalOptions = { ...patternSmartDefaults, ...finalOptions, ...baseOptions };
+      const patternSmartDefaults = await getSmartDefaults(
+        resolvedDir,
+        baseOptions
+      );
+      finalOptions = {
+        ...patternSmartDefaults,
+        ...finalOptions,
+        ...baseOptions
+      };
     }
     console.log(import_chalk2.default.cyan("\n=== AIReady Run Preview ==="));
-    console.log(import_chalk2.default.white("Tools to run:"), (finalOptions.tools || ["patterns", "context", "consistency"]).join(", "));
+    console.log(
+      import_chalk2.default.white("Tools to run:"),
+      (finalOptions.tools || ["patterns", "context", "consistency"]).join(", ")
+    );
     console.log(import_chalk2.default.white("Will use settings from config and defaults."));
     console.log(import_chalk2.default.white("\nGeneral settings:"));
-    if (finalOptions.rootDir) console.log(`  rootDir: ${import_chalk2.default.bold(String(finalOptions.rootDir))}`);
-    if (finalOptions.include) console.log(`  include: ${import_chalk2.default.bold(truncateArray(finalOptions.include, 6))}`);
-    if (finalOptions.exclude) console.log(`  exclude: ${import_chalk2.default.bold(truncateArray(finalOptions.exclude, 6))}`);
+    if (finalOptions.rootDir)
+      console.log(`  rootDir: ${import_chalk2.default.bold(String(finalOptions.rootDir))}`);
+    if (finalOptions.include)
+      console.log(
+        `  include: ${import_chalk2.default.bold(truncateArray(finalOptions.include, 6))}`
+      );
+    if (finalOptions.exclude)
+      console.log(
+        `  exclude: ${import_chalk2.default.bold(truncateArray(finalOptions.exclude, 6))}`
+      );
     if (finalOptions["pattern-detect"] || finalOptions.minSimilarity) {
       const patternDetectConfig = finalOptions["pattern-detect"] || {
         minSimilarity: finalOptions.minSimilarity,
@@ -377,15 +447,40 @@ async function scanAction(directory, options) {
         includeTests: finalOptions.includeTests
       };
       console.log(import_chalk2.default.white("\nPattern-detect settings:"));
-      console.log(`  minSimilarity: ${import_chalk2.default.bold(patternDetectConfig.minSimilarity ?? "default")}`);
-      console.log(`  minLines: ${import_chalk2.default.bold(patternDetectConfig.minLines ?? "default")}`);
-      if (patternDetectConfig.approx !== void 0) console.log(`  approx: ${import_chalk2.default.bold(String(patternDetectConfig.approx))}`);
-      if (patternDetectConfig.minSharedTokens !== void 0) console.log(`  minSharedTokens: ${import_chalk2.default.bold(String(patternDetectConfig.minSharedTokens))}`);
-      if (patternDetectConfig.maxCandidatesPerBlock !== void 0) console.log(`  maxCandidatesPerBlock: ${import_chalk2.default.bold(String(patternDetectConfig.maxCandidatesPerBlock))}`);
-      if (patternDetectConfig.batchSize !== void 0) console.log(`  batchSize: ${import_chalk2.default.bold(String(patternDetectConfig.batchSize))}`);
-      if (patternDetectConfig.streamResults !== void 0) console.log(`  streamResults: ${import_chalk2.default.bold(String(patternDetectConfig.streamResults))}`);
-      if (patternDetectConfig.severity !== void 0) console.log(`  severity: ${import_chalk2.default.bold(String(patternDetectConfig.severity))}`);
-      if (patternDetectConfig.includeTests !== void 0) console.log(`  includeTests: ${import_chalk2.default.bold(String(patternDetectConfig.includeTests))}`);
+      console.log(
+        `  minSimilarity: ${import_chalk2.default.bold(patternDetectConfig.minSimilarity ?? "default")}`
+      );
+      console.log(
+        `  minLines: ${import_chalk2.default.bold(patternDetectConfig.minLines ?? "default")}`
+      );
+      if (patternDetectConfig.approx !== void 0)
+        console.log(
+          `  approx: ${import_chalk2.default.bold(String(patternDetectConfig.approx))}`
+        );
+      if (patternDetectConfig.minSharedTokens !== void 0)
+        console.log(
+          `  minSharedTokens: ${import_chalk2.default.bold(String(patternDetectConfig.minSharedTokens))}`
+        );
+      if (patternDetectConfig.maxCandidatesPerBlock !== void 0)
+        console.log(
+          `  maxCandidatesPerBlock: ${import_chalk2.default.bold(String(patternDetectConfig.maxCandidatesPerBlock))}`
+        );
+      if (patternDetectConfig.batchSize !== void 0)
+        console.log(
+          `  batchSize: ${import_chalk2.default.bold(String(patternDetectConfig.batchSize))}`
+        );
+      if (patternDetectConfig.streamResults !== void 0)
+        console.log(
+          `  streamResults: ${import_chalk2.default.bold(String(patternDetectConfig.streamResults))}`
+        );
+      if (patternDetectConfig.severity !== void 0)
+        console.log(
+          `  severity: ${import_chalk2.default.bold(String(patternDetectConfig.severity))}`
+        );
+      if (patternDetectConfig.includeTests !== void 0)
+        console.log(
+          `  includeTests: ${import_chalk2.default.bold(String(patternDetectConfig.includeTests))}`
+        );
     }
     if (finalOptions["context-analyzer"] || finalOptions.maxDepth) {
       const ca = finalOptions["context-analyzer"] || {
@@ -397,20 +492,42 @@ async function scanAction(directory, options) {
       };
       console.log(import_chalk2.default.white("\nContext-analyzer settings:"));
       console.log(`  maxDepth: ${import_chalk2.default.bold(ca.maxDepth ?? "default")}`);
-      console.log(`  maxContextBudget: ${import_chalk2.default.bold(ca.maxContextBudget ?? "default")}`);
-      if (ca.minCohesion !== void 0) console.log(`  minCohesion: ${import_chalk2.default.bold(String(ca.minCohesion))}`);
-      if (ca.maxFragmentation !== void 0) console.log(`  maxFragmentation: ${import_chalk2.default.bold(String(ca.maxFragmentation))}`);
-      if (ca.includeNodeModules !== void 0) console.log(`  includeNodeModules: ${import_chalk2.default.bold(String(ca.includeNodeModules))}`);
+      console.log(
+        `  maxContextBudget: ${import_chalk2.default.bold(ca.maxContextBudget ?? "default")}`
+      );
+      if (ca.minCohesion !== void 0)
+        console.log(`  minCohesion: ${import_chalk2.default.bold(String(ca.minCohesion))}`);
+      if (ca.maxFragmentation !== void 0)
+        console.log(
+          `  maxFragmentation: ${import_chalk2.default.bold(String(ca.maxFragmentation))}`
+        );
+      if (ca.includeNodeModules !== void 0)
+        console.log(
+          `  includeNodeModules: ${import_chalk2.default.bold(String(ca.includeNodeModules))}`
+        );
     }
     if (finalOptions.consistency) {
       const c = finalOptions.consistency;
       console.log(import_chalk2.default.white("\nConsistency settings:"));
-      console.log(`  checkNaming: ${import_chalk2.default.bold(String(c.checkNaming ?? true))}`);
-      console.log(`  checkPatterns: ${import_chalk2.default.bold(String(c.checkPatterns ?? true))}`);
-      console.log(`  checkArchitecture: ${import_chalk2.default.bold(String(c.checkArchitecture ?? false))}`);
-      if (c.minSeverity) console.log(`  minSeverity: ${import_chalk2.default.bold(c.minSeverity)}`);
-      if (c.acceptedAbbreviations) console.log(`  acceptedAbbreviations: ${import_chalk2.default.bold(truncateArray(c.acceptedAbbreviations, 8))}`);
-      if (c.shortWords) console.log(`  shortWords: ${import_chalk2.default.bold(truncateArray(c.shortWords, 8))}`);
+      console.log(
+        `  checkNaming: ${import_chalk2.default.bold(String(c.checkNaming ?? true))}`
+      );
+      console.log(
+        `  checkPatterns: ${import_chalk2.default.bold(String(c.checkPatterns ?? true))}`
+      );
+      console.log(
+        `  checkArchitecture: ${import_chalk2.default.bold(String(c.checkArchitecture ?? false))}`
+      );
+      if (c.minSeverity)
+        console.log(`  minSeverity: ${import_chalk2.default.bold(c.minSeverity)}`);
+      if (c.acceptedAbbreviations)
+        console.log(
+          `  acceptedAbbreviations: ${import_chalk2.default.bold(truncateArray(c.acceptedAbbreviations, 8))}`
+        );
+      if (c.shortWords)
+        console.log(
+          `  shortWords: ${import_chalk2.default.bold(truncateArray(c.shortWords, 8))}`
+        );
     }
     console.log(import_chalk2.default.white("\nStarting analysis..."));
     const progressCallback = (event) => {
@@ -419,40 +536,62 @@ async function scanAction(directory, options) {
       try {
         if (event.tool === "patterns") {
           const pr = event.data;
-          console.log(`  Duplicate patterns: ${import_chalk2.default.bold(String(pr.duplicates?.length || 0))}`);
-          console.log(`  Files with pattern issues: ${import_chalk2.default.bold(String(pr.results?.length || 0))}`);
+          console.log(
+            `  Duplicate patterns: ${import_chalk2.default.bold(String(pr.duplicates?.length || 0))}`
+          );
+          console.log(
+            `  Files with pattern issues: ${import_chalk2.default.bold(String(pr.results?.length || 0))}`
+          );
           if (pr.duplicates && pr.duplicates.length > 0) {
             pr.duplicates.slice(0, 5).forEach((d, i) => {
-              console.log(`   ${i + 1}. ${d.file1.split("/").pop()} \u2194 ${d.file2.split("/").pop()} (sim=${(d.similarity * 100).toFixed(1)}%)`);
+              console.log(
+                `   ${i + 1}. ${d.file1.split("/").pop()} \u2194 ${d.file2.split("/").pop()} (sim=${(d.similarity * 100).toFixed(1)}%)`
+              );
             });
           }
           if (pr.results && pr.results.length > 0) {
             console.log(`  Top files with pattern issues:`);
-            const sortedByIssues = [...pr.results].sort((a, b) => (b.issues?.length || 0) - (a.issues?.length || 0));
+            const sortedByIssues = [...pr.results].sort(
+              (a, b) => (b.issues?.length || 0) - (a.issues?.length || 0)
+            );
             sortedByIssues.slice(0, 5).forEach((r, i) => {
-              console.log(`   ${i + 1}. ${r.fileName.split("/").pop()} - ${r.issues.length} issue(s)`);
+              console.log(
+                `   ${i + 1}. ${r.fileName.split("/").pop()} - ${r.issues.length} issue(s)`
+              );
             });
           }
           if (pr.groups && pr.groups.length >= 0) {
-            console.log(`  \u2705 Grouped ${import_chalk2.default.bold(String(pr.duplicates?.length || 0))} duplicates into ${import_chalk2.default.bold(String(pr.groups.length))} file pairs`);
+            console.log(
+              `  \u2705 Grouped ${import_chalk2.default.bold(String(pr.duplicates?.length || 0))} duplicates into ${import_chalk2.default.bold(String(pr.groups.length))} file pairs`
+            );
           }
           if (pr.clusters && pr.clusters.length >= 0) {
-            console.log(`  \u2705 Created ${import_chalk2.default.bold(String(pr.clusters.length))} refactor clusters`);
+            console.log(
+              `  \u2705 Created ${import_chalk2.default.bold(String(pr.clusters.length))} refactor clusters`
+            );
             pr.clusters.slice(0, 3).forEach((cl, idx) => {
               const files = (cl.files || []).map((f) => f.path.split("/").pop()).join(", ");
-              console.log(`   ${idx + 1}. ${files} (${cl.tokenCost || "n/a"} tokens)`);
+              console.log(
+                `   ${idx + 1}. ${files} (${cl.tokenCost || "n/a"} tokens)`
+              );
             });
           }
         } else if (event.tool === "context") {
           const cr = event.data;
-          console.log(`  Context issues found: ${import_chalk2.default.bold(String(cr.length || 0))}`);
+          console.log(
+            `  Context issues found: ${import_chalk2.default.bold(String(cr.length || 0))}`
+          );
           cr.slice(0, 5).forEach((c, i) => {
             const msg = c.message ? ` - ${c.message}` : "";
-            console.log(`   ${i + 1}. ${c.file} (${c.severity || "n/a"})${msg}`);
+            console.log(
+              `   ${i + 1}. ${c.file} (${c.severity || "n/a"})${msg}`
+            );
           });
         } else if (event.tool === "consistency") {
           const rep = event.data;
-          console.log(`  Consistency totalIssues: ${import_chalk2.default.bold(String(rep.summary?.totalIssues || 0))}`);
+          console.log(
+            `  Consistency totalIssues: ${import_chalk2.default.bold(String(rep.summary?.totalIssues || 0))}`
+          );
           if (rep.results && rep.results.length > 0) {
             const fileMap = /* @__PURE__ */ new Map();
             rep.results.forEach((r) => {
@@ -462,68 +601,134 @@ async function scanAction(directory, options) {
                 fileMap.get(file).push(issue);
               });
             });
-            const files = Array.from(fileMap.entries()).sort((a, b) => b[1].length - a[1].length);
+            const files = Array.from(fileMap.entries()).sort(
+              (a, b) => b[1].length - a[1].length
+            );
             const topFiles = files.slice(0, 10);
             topFiles.forEach(([file, issues], idx) => {
-              const counts = issues.reduce((acc, it) => {
-                const s = (it.severity || "info").toLowerCase();
-                acc[s] = (acc[s] || 0) + 1;
-                return acc;
-              }, {});
-              const sample = issues.find((it) => it.severity === "critical" || it.severity === "major") || issues[0];
+              const counts = issues.reduce(
+                (acc, it) => {
+                  const s = (it.severity || "info").toLowerCase();
+                  acc[s] = (acc[s] || 0) + 1;
+                  return acc;
+                },
+                {}
+              );
+              const sample = issues.find(
+                (it) => it.severity === "critical" || it.severity === "major"
+              ) || issues[0];
               const sampleMsg = sample ? ` \u2014 ${sample.message}` : "";
-              console.log(`   ${idx + 1}. ${file} \u2014 ${issues.length} issue(s) (critical:${counts.critical || 0} major:${counts.major || 0} minor:${counts.minor || 0} info:${counts.info || 0})${sampleMsg}`);
+              console.log(
+                `   ${idx + 1}. ${file} \u2014 ${issues.length} issue(s) (critical:${counts.critical || 0} major:${counts.major || 0} minor:${counts.minor || 0} info:${counts.info || 0})${sampleMsg}`
+              );
             });
             const remaining = files.length - topFiles.length;
             if (remaining > 0) {
-              console.log(import_chalk2.default.dim(`   ... and ${remaining} more files with issues (use --output json for full details)`));
+              console.log(
+                import_chalk2.default.dim(
+                  `   ... and ${remaining} more files with issues (use --output json for full details)`
+                )
+              );
             }
           }
         } else if (event.tool === "doc-drift") {
           const dr = event.data;
-          console.log(`  Issues found: ${import_chalk2.default.bold(String(dr.issues?.length || 0))}`);
+          console.log(
+            `  Issues found: ${import_chalk2.default.bold(String(dr.issues?.length || 0))}`
+          );
           if (dr.rawData) {
-            console.log(`  Signature Mismatches: ${import_chalk2.default.bold(dr.rawData.outdatedComments || 0)}`);
-            console.log(`  Undocumented Complexity: ${import_chalk2.default.bold(dr.rawData.undocumentedComplexity || 0)}`);
+            console.log(
+              `  Signature Mismatches: ${import_chalk2.default.bold(dr.rawData.outdatedComments || 0)}`
+            );
+            console.log(
+              `  Undocumented Complexity: ${import_chalk2.default.bold(dr.rawData.undocumentedComplexity || 0)}`
+            );
           }
         } else if (event.tool === "deps-health") {
           const dr = event.data;
-          console.log(`  Packages Analyzed: ${import_chalk2.default.bold(String(dr.summary?.packagesAnalyzed || 0))}`);
+          console.log(
+            `  Packages Analyzed: ${import_chalk2.default.bold(String(dr.summary?.packagesAnalyzed || 0))}`
+          );
           if (dr.rawData) {
-            console.log(`  Deprecated Packages: ${import_chalk2.default.bold(dr.rawData.deprecatedPackages || 0)}`);
-            console.log(`  AI Cutoff Skew Score: ${import_chalk2.default.bold(dr.rawData.trainingCutoffSkew?.toFixed(1) || 0)}`);
+            console.log(
+              `  Deprecated Packages: ${import_chalk2.default.bold(dr.rawData.deprecatedPackages || 0)}`
+            );
+            console.log(
+              `  AI Cutoff Skew Score: ${import_chalk2.default.bold(dr.rawData.trainingCutoffSkew?.toFixed(1) || 0)}`
+            );
           }
         } else if (event.tool === "change-amplification" || event.tool === "changeAmplification") {
           const dr = event.data;
-          console.log(`  Coupling issues: ${import_chalk2.default.bold(String(dr.issues?.length || 0))}`);
+          console.log(
+            `  Coupling issues: ${import_chalk2.default.bold(String(dr.issues?.length || 0))}`
+          );
           if (dr.summary) {
-            console.log(`  Complexity Score: ${import_chalk2.default.bold(dr.summary.score || 0)}/100`);
+            console.log(
+              `  Complexity Score: ${import_chalk2.default.bold(dr.summary.score || 0)}/100`
+            );
           }
         }
       } catch (err) {
+        void err;
       }
     };
-    const results = await analyzeUnified({ ...finalOptions, progressCallback, suppressToolConfig: true });
+    const results = await analyzeUnified({
+      ...finalOptions,
+      progressCallback,
+      onProgress: (processed, total, message) => {
+        process.stdout.write(
+          `\r\x1B[K   [${processed}/${total}] ${message}...`
+        );
+        if (processed === total) {
+          process.stdout.write("\n");
+        }
+      },
+      suppressToolConfig: true
+    });
     console.log(import_chalk2.default.cyan("\n=== AIReady Run Summary ==="));
-    console.log(import_chalk2.default.white("Tools run:"), (finalOptions.tools || ["patterns", "context", "consistency"]).join(", "));
+    console.log(
+      import_chalk2.default.white("Tools run:"),
+      (finalOptions.tools || ["patterns", "context", "consistency"]).join(", ")
+    );
     console.log(import_chalk2.default.cyan("\nResults summary:"));
-    console.log(`  Total issues (all tools): ${import_chalk2.default.bold(String(results.summary.totalIssues || 0))}`);
-    if (results.duplicates) console.log(`  Duplicate patterns found: ${import_chalk2.default.bold(String(results.duplicates.length || 0))}`);
-    if (results.patterns) console.log(`  Pattern files with issues: ${import_chalk2.default.bold(String(results.patterns.length || 0))}`);
-    if (results.context) console.log(`  Context issues: ${import_chalk2.default.bold(String(results.context.length || 0))}`);
-    console.log(`  Consistency issues: ${import_chalk2.default.bold(String(results.consistency?.summary?.totalIssues || 0))}`);
-    if (results.changeAmplification) console.log(`  Change amplification: ${import_chalk2.default.bold(String(results.changeAmplification.summary?.score || 0))}/100`);
+    console.log(
+      `  Total issues (all tools): ${import_chalk2.default.bold(String(results.summary.totalIssues || 0))}`
+    );
+    if (results.duplicates)
+      console.log(
+        `  Duplicate patterns found: ${import_chalk2.default.bold(String(results.duplicates.length || 0))}`
+      );
+    if (results.patterns)
+      console.log(
+        `  Pattern files with issues: ${import_chalk2.default.bold(String(results.patterns.length || 0))}`
+      );
+    if (results.context)
+      console.log(
+        `  Context issues: ${import_chalk2.default.bold(String(results.context.length || 0))}`
+      );
+    console.log(
+      `  Consistency issues: ${import_chalk2.default.bold(String(results.consistency?.summary?.totalIssues || 0))}`
+    );
+    if (results.changeAmplification)
+      console.log(
+        `  Change amplification: ${import_chalk2.default.bold(String(results.changeAmplification.summary?.score || 0))}/100`
+      );
     console.log(import_chalk2.default.cyan("===========================\n"));
     const elapsedTime = (0, import_core.getElapsedTime)(startTime);
+    void elapsedTime;
     let scoringResult;
     if (options.score || finalOptions.scoring?.showBreakdown) {
       const toolScores = /* @__PURE__ */ new Map();
       if (results.duplicates) {
         const { calculatePatternScore } = await import("@aiready/pattern-detect");
         try {
-          const patternScore = calculatePatternScore(results.duplicates, results.patterns?.length || 0);
+          const patternScore = calculatePatternScore(
+            results.duplicates,
+            results.patterns?.length || 0
+          );
           toolScores.set("pattern-detect", patternScore);
         } catch (err) {
+          void err;
         }
       }
       if (results.context) {
@@ -533,6 +738,7 @@ async function scanAction(directory, options) {
           const contextScore = calculateContextScore(ctxSummary);
           toolScores.set("context-analyzer", contextScore);
         } catch (err) {
+          void err;
         }
       }
       if (results.consistency) {
@@ -540,17 +746,24 @@ async function scanAction(directory, options) {
         try {
           const issues = results.consistency.results?.flatMap((r) => r.issues) || [];
           const totalFiles = results.consistency.summary?.filesAnalyzed || 0;
-          const consistencyScore = calculateConsistencyScore(issues, totalFiles);
+          const consistencyScore = calculateConsistencyScore(
+            issues,
+            totalFiles
+          );
           toolScores.set("consistency", consistencyScore);
         } catch (err) {
+          void err;
         }
       }
       if (results.aiSignalClarity) {
         const { calculateAiSignalClarityScore } = await import("@aiready/ai-signal-clarity");
         try {
-          const hrScore = calculateAiSignalClarityScore(results.aiSignalClarity);
+          const hrScore = calculateAiSignalClarityScore(
+            results.aiSignalClarity
+          );
           toolScores.set("ai-signal-clarity", hrScore);
         } catch (err) {
+          void err;
         }
       }
       if (results.grounding) {
@@ -559,6 +772,7 @@ async function scanAction(directory, options) {
           const agScore = calculateGroundingScore(results.grounding);
           toolScores.set("agent-grounding", agScore);
         } catch (err) {
+          void err;
         }
       }
       if (results.testability) {
@@ -567,6 +781,7 @@ async function scanAction(directory, options) {
           const tbScore = calculateTestabilityScore(results.testability);
           toolScores.set("testability", tbScore);
         } catch (err) {
+          void err;
         }
       }
       if (results.docDrift) {
@@ -575,7 +790,13 @@ async function scanAction(directory, options) {
           score: results.docDrift.summary.score,
           rawMetrics: results.docDrift.rawData,
           factors: [],
-          recommendations: (results.docDrift.recommendations || []).map((action) => ({ action, estimatedImpact: 5, priority: "medium" }))
+          recommendations: (results.docDrift.recommendations || []).map(
+            (action) => ({
+              action,
+              estimatedImpact: 5,
+              priority: "medium"
+            })
+          )
         });
       }
       if (results.deps) {
@@ -584,7 +805,13 @@ async function scanAction(directory, options) {
           score: results.deps.summary.score,
           rawMetrics: results.deps.rawData,
           factors: [],
-          recommendations: (results.deps.recommendations || []).map((action) => ({ action, estimatedImpact: 5, priority: "medium" }))
+          recommendations: (results.deps.recommendations || []).map(
+            (action) => ({
+              action,
+              estimatedImpact: 5,
+              priority: "medium"
+            })
+          )
         });
       }
       if (results.changeAmplification) {
@@ -593,17 +820,28 @@ async function scanAction(directory, options) {
           score: results.changeAmplification.summary.score,
           rawMetrics: results.changeAmplification.rawData,
           factors: [],
-          recommendations: (results.changeAmplification.recommendations || []).map((action) => ({ action, estimatedImpact: 5, priority: "medium" }))
+          recommendations: (results.changeAmplification.recommendations || []).map((action) => ({
+            action,
+            estimatedImpact: 5,
+            priority: "medium"
+          }))
         });
       }
       const cliWeights = (0, import_core.parseWeightString)(options.weights);
       if (toolScores.size > 0) {
-        scoringResult = (0, import_core.calculateOverallScore)(toolScores, finalOptions, cliWeights.size ? cliWeights : void 0);
+        scoringResult = (0, import_core.calculateOverallScore)(
+          toolScores,
+          finalOptions,
+          cliWeights.size ? cliWeights : void 0
+        );
         console.log(import_chalk2.default.bold("\n\u{1F4CA} AI Readiness Overall Score"));
         console.log(`  ${(0, import_core.formatScore)(scoringResult)}`);
         if (options.compareTo) {
           try {
-            const prevReportStr = (0, import_fs2.readFileSync)((0, import_path2.resolve)(process.cwd(), options.compareTo), "utf8");
+            const prevReportStr = (0, import_fs2.readFileSync)(
+              (0, import_path2.resolve)(process.cwd(), options.compareTo),
+              "utf8"
+            );
             const prevReport = JSON.parse(prevReportStr);
             const prevScore = prevReport.scoring?.score || prevReport.scoring?.overallScore;
             if (typeof prevScore === "number") {
@@ -611,23 +849,44 @@ async function scanAction(directory, options) {
               const diffStr = diff > 0 ? `+${diff}` : String(diff);
               console.log();
               if (diff > 0) {
-                console.log(import_chalk2.default.green(`  \u{1F4C8} Trend: ${diffStr} compared to ${options.compareTo} (${prevScore} \u2192 ${scoringResult.overall})`));
+                console.log(
+                  import_chalk2.default.green(
+                    `  \u{1F4C8} Trend: ${diffStr} compared to ${options.compareTo} (${prevScore} \u2192 ${scoringResult.overall})`
+                  )
+                );
               } else if (diff < 0) {
-                console.log(import_chalk2.default.red(`  \u{1F4C9} Trend: ${diffStr} compared to ${options.compareTo} (${prevScore} \u2192 ${scoringResult.overall})`));
+                console.log(
+                  import_chalk2.default.red(
+                    `  \u{1F4C9} Trend: ${diffStr} compared to ${options.compareTo} (${prevScore} \u2192 ${scoringResult.overall})`
+                  )
+                );
               } else {
-                console.log(import_chalk2.default.blue(`  \u2796 Trend: No change compared to ${options.compareTo} (${prevScore} \u2192 ${scoringResult.overall})`));
+                console.log(
+                  import_chalk2.default.blue(
+                    `  \u2796 Trend: No change compared to ${options.compareTo} (${prevScore} \u2192 ${scoringResult.overall})`
+                  )
+                );
               }
               scoringResult.trend = {
                 previousScore: prevScore,
                 difference: diff
               };
             } else {
-              console.log(import_chalk2.default.yellow(`
-  \u26A0\uFE0F  Previous report at ${options.compareTo} does not contain an overall score.`));
+              console.log(
+                import_chalk2.default.yellow(
+                  `
+  \u26A0\uFE0F  Previous report at ${options.compareTo} does not contain an overall score.`
+                )
+              );
             }
           } catch (e) {
-            console.log(import_chalk2.default.yellow(`
-  \u26A0\uFE0F  Could not read or parse previous report at ${options.compareTo}.`));
+            void e;
+            console.log(
+              import_chalk2.default.yellow(
+                `
+  \u26A0\uFE0F  Could not read or parse previous report at ${options.compareTo}.`
+              )
+            );
           }
         }
         if (scoringResult.breakdown && scoringResult.breakdown.length > 0) {
@@ -635,7 +894,9 @@ async function scanAction(directory, options) {
           scoringResult.breakdown.forEach((tool) => {
             const rating = (0, import_core.getRating)(tool.score);
             const rd = (0, import_core.getRatingDisplay)(rating);
-            console.log(`  - ${tool.toolName}: ${tool.score}/100 (${rating}) ${rd.emoji}`);
+            console.log(
+              `  - ${tool.toolName}: ${tool.score}/100 (${rating}) ${rd.emoji}`
+            );
           });
           console.log();
           if (finalOptions.scoring?.showBreakdown) {
@@ -653,20 +914,33 @@ async function scanAction(directory, options) {
     if (outputFormat === "json") {
       const timestamp = getReportTimestamp();
       const defaultFilename = `aiready-report-${timestamp}.json`;
-      const outputPath = (0, import_core.resolveOutputPath)(userOutputFile, defaultFilename, resolvedDir);
+      const outputPath = (0, import_core.resolveOutputPath)(
+        userOutputFile,
+        defaultFilename,
+        resolvedDir
+      );
       const outputData = { ...results, scoring: scoringResult };
-      (0, import_core.handleJSONOutput)(outputData, outputPath, `\u2705 Report saved to ${outputPath}`);
-      warnIfGraphCapExceeded(outputData, resolvedDir);
+      (0, import_core.handleJSONOutput)(
+        outputData,
+        outputPath,
+        `\u2705 Report saved to ${outputPath}`
+      );
+      await warnIfGraphCapExceeded(outputData, resolvedDir);
     } else {
       const timestamp = getReportTimestamp();
       const defaultFilename = `aiready-report-${timestamp}.json`;
-      const outputPath = (0, import_core.resolveOutputPath)(userOutputFile, defaultFilename, resolvedDir);
+      const outputPath = (0, import_core.resolveOutputPath)(
+        userOutputFile,
+        defaultFilename,
+        resolvedDir
+      );
       const outputData = { ...results, scoring: scoringResult };
       try {
         (0, import_fs2.writeFileSync)(outputPath, JSON.stringify(outputData, null, 2));
         console.log(import_chalk2.default.dim(`\u2705 Report auto-persisted to ${outputPath}`));
-        warnIfGraphCapExceeded(outputData, resolvedDir);
+        await warnIfGraphCapExceeded(outputData, resolvedDir);
       } catch (err) {
+        void err;
       }
     }
     const isCI = options.ci || process.env.CI === "true" || process.env.GITHUB_ACTIONS === "true";
@@ -684,16 +958,22 @@ async function scanAction(directory, options) {
         }
         console.log("::endgroup::");
         if (threshold && scoringResult.overall < threshold) {
-          console.log(`::error::AI Readiness Score ${scoringResult.overall} is below threshold ${threshold}`);
+          console.log(
+            `::error::AI Readiness Score ${scoringResult.overall} is below threshold ${threshold}`
+          );
         } else if (threshold) {
-          console.log(`::notice::AI Readiness Score: ${scoringResult.overall}/100 (threshold: ${threshold})`);
+          console.log(
+            `::notice::AI Readiness Score: ${scoringResult.overall}/100 (threshold: ${threshold})`
+          );
         }
         if (results.patterns) {
           const criticalPatterns = results.patterns.flatMap(
             (p) => p.issues.filter((i) => i.severity === "critical")
           );
           criticalPatterns.slice(0, 10).forEach((issue) => {
-            console.log(`::warning file=${issue.location?.file || "unknown"},line=${issue.location?.line || 1}::${issue.message}`);
+            console.log(
+              `::warning file=${issue.location?.file || "unknown"},line=${issue.location?.line || 1}::${issue.message}`
+            );
           });
         }
       }
@@ -742,16 +1022,30 @@ async function scanAction(directory, options) {
         console.log(import_chalk2.default.red("\n\u{1F6AB} PR BLOCKED: AI Readiness Check Failed"));
         console.log(import_chalk2.default.red(`   Reason: ${failReason}`));
         console.log(import_chalk2.default.dim("\n   Remediation steps:"));
-        console.log(import_chalk2.default.dim("   1. Run `aiready scan` locally to see detailed issues"));
+        console.log(
+          import_chalk2.default.dim("   1. Run `aiready scan` locally to see detailed issues")
+        );
         console.log(import_chalk2.default.dim("   2. Fix the critical issues before merging"));
-        console.log(import_chalk2.default.dim("   3. Consider upgrading to Team plan for historical tracking: https://getaiready.dev/pricing"));
+        console.log(
+          import_chalk2.default.dim(
+            "   3. Consider upgrading to Team plan for historical tracking: https://getaiready.dev/pricing"
+          )
+        );
         process.exit(1);
       } else {
         console.log(import_chalk2.default.green("\n\u2705 PR PASSED: AI Readiness Check"));
         if (threshold) {
-          console.log(import_chalk2.default.green(`   Score: ${scoringResult.overall}/100 (threshold: ${threshold})`));
+          console.log(
+            import_chalk2.default.green(
+              `   Score: ${scoringResult.overall}/100 (threshold: ${threshold})`
+            )
+          );
         }
-        console.log(import_chalk2.default.dim("\n   \u{1F4A1} Track historical trends: https://getaiready.dev \u2014 Team plan $99/mo"));
+        console.log(
+          import_chalk2.default.dim(
+            "\n   \u{1F4A1} Track historical trends: https://getaiready.dev \u2014 Team plan $99/mo"
+          )
+        );
       }
     }
   } catch (error) {
@@ -823,7 +1117,11 @@ async function patternsAction(directory, options) {
     if (options.minSharedTokens) {
       cliOptions.minSharedTokens = parseInt(options.minSharedTokens);
     }
-    const finalOptions = await (0, import_core2.loadMergedConfig)(resolvedDir, defaults, cliOptions);
+    const finalOptions = await (0, import_core2.loadMergedConfig)(
+      resolvedDir,
+      defaults,
+      cliOptions
+    );
     const { analyzePatterns: analyzePatterns2, generateSummary, calculatePatternScore } = await import("@aiready/pattern-detect");
     const { results, duplicates } = await analyzePatterns2(finalOptions);
     const elapsedTime = (0, import_core2.getElapsedTime)(startTime);
@@ -845,7 +1143,11 @@ async function patternsAction(directory, options) {
         `aiready-report-${getReportTimestamp()}.json`,
         resolvedDir
       );
-      (0, import_core2.handleJSONOutput)(outputData, outputPath, `\u2705 Results saved to ${outputPath}`);
+      (0, import_core2.handleJSONOutput)(
+        outputData,
+        outputPath,
+        `\u2705 Results saved to ${outputPath}`
+      );
     } else {
       const terminalWidth = process.stdout.columns || 80;
       const dividerWidth = Math.min(60, terminalWidth - 2);
@@ -853,10 +1155,22 @@ async function patternsAction(directory, options) {
       console.log(import_chalk3.default.cyan(divider));
       console.log(import_chalk3.default.bold.white("  PATTERN ANALYSIS SUMMARY"));
       console.log(import_chalk3.default.cyan(divider) + "\n");
-      console.log(import_chalk3.default.white(`\u{1F4C1} Files analyzed: ${import_chalk3.default.bold(results.length)}`));
-      console.log(import_chalk3.default.yellow(`\u26A0  Duplicate patterns found: ${import_chalk3.default.bold(summary.totalPatterns)}`));
-      console.log(import_chalk3.default.red(`\u{1F4B0} Token cost (wasted): ${import_chalk3.default.bold(summary.totalTokenCost.toLocaleString())}`));
-      console.log(import_chalk3.default.gray(`\u23F1  Analysis time: ${import_chalk3.default.bold(elapsedTime + "s")}`));
+      console.log(
+        import_chalk3.default.white(`\u{1F4C1} Files analyzed: ${import_chalk3.default.bold(results.length)}`)
+      );
+      console.log(
+        import_chalk3.default.yellow(
+          `\u26A0  Duplicate patterns found: ${import_chalk3.default.bold(summary.totalPatterns)}`
+        )
+      );
+      console.log(
+        import_chalk3.default.red(
+          `\u{1F4B0} Token cost (wasted): ${import_chalk3.default.bold(summary.totalTokenCost.toLocaleString())}`
+        )
+      );
+      console.log(
+        import_chalk3.default.gray(`\u23F1  Analysis time: ${import_chalk3.default.bold(elapsedTime + "s")}`)
+      );
       const sortedTypes = Object.entries(summary.patternsByType || {}).filter(([, count]) => count > 0).sort(([, a], [, b]) => b - a);
       if (sortedTypes.length > 0) {
         console.log(import_chalk3.default.cyan("\n" + divider));
@@ -876,13 +1190,21 @@ async function patternsAction(directory, options) {
           const severityIcon = dup.similarity > 0.95 ? "\u{1F534}" : dup.similarity > 0.9 ? "\u{1F7E1}" : "\u{1F535}";
           const file1Name = dup.file1.split("/").pop() || dup.file1;
           const file2Name = dup.file2.split("/").pop() || dup.file2;
-          console.log(`${severityIcon} ${severity}: ${import_chalk3.default.bold(file1Name)} \u2194 ${import_chalk3.default.bold(file2Name)}`);
-          console.log(`   Similarity: ${import_chalk3.default.bold(Math.round(dup.similarity * 100) + "%")} | Wasted: ${import_chalk3.default.bold(dup.tokenCost.toLocaleString())} tokens each`);
-          console.log(`   Lines: ${import_chalk3.default.cyan(dup.line1 + "-" + dup.endLine1)} \u2194 ${import_chalk3.default.cyan(dup.line2 + "-" + dup.endLine2)}
-`);
+          console.log(
+            `${severityIcon} ${severity}: ${import_chalk3.default.bold(file1Name)} \u2194 ${import_chalk3.default.bold(file2Name)}`
+          );
+          console.log(
+            `   Similarity: ${import_chalk3.default.bold(Math.round(dup.similarity * 100) + "%")} | Wasted: ${import_chalk3.default.bold(dup.tokenCost.toLocaleString())} tokens each`
+          );
+          console.log(
+            `   Lines: ${import_chalk3.default.cyan(dup.line1 + "-" + dup.endLine1)} \u2194 ${import_chalk3.default.cyan(dup.line2 + "-" + dup.endLine2)}
+`
+          );
         });
       } else {
-        console.log(import_chalk3.default.green("\n\u2728 Great! No duplicate patterns detected.\n"));
+        console.log(
+          import_chalk3.default.green("\n\u2728 Great! No duplicate patterns detected.\n")
+        );
       }
       if (patternScore) {
         console.log(import_chalk3.default.cyan(divider));
@@ -922,7 +1244,7 @@ async function contextAction(directory, options) {
         file: void 0
       }
     };
-    let baseOptions = await (0, import_core3.loadMergedConfig)(resolvedDir, defaults, {
+    const baseOptions = await (0, import_core3.loadMergedConfig)(resolvedDir, defaults, {
       maxDepth: options.maxDepth ? parseInt(options.maxDepth) : void 0,
       maxContextBudget: options.maxContext ? parseInt(options.maxContext) : void 0,
       include: options.include?.split(","),
@@ -930,13 +1252,20 @@ async function contextAction(directory, options) {
     });
     let finalOptions = { ...baseOptions };
     const { getSmartDefaults } = await import("@aiready/context-analyzer");
-    const contextSmartDefaults = await getSmartDefaults(resolvedDir, baseOptions);
+    const contextSmartDefaults = await getSmartDefaults(
+      resolvedDir,
+      baseOptions
+    );
     finalOptions = { ...contextSmartDefaults, ...finalOptions };
     console.log("\u{1F4CB} Configuration:");
     console.log(`   Max depth: ${finalOptions.maxDepth}`);
     console.log(`   Max context budget: ${finalOptions.maxContextBudget}`);
-    console.log(`   Min cohesion: ${(finalOptions.minCohesion * 100).toFixed(1)}%`);
-    console.log(`   Max fragmentation: ${(finalOptions.maxFragmentation * 100).toFixed(1)}%`);
+    console.log(
+      `   Min cohesion: ${(finalOptions.minCohesion * 100).toFixed(1)}%`
+    );
+    console.log(
+      `   Max fragmentation: ${(finalOptions.maxFragmentation * 100).toFixed(1)}%`
+    );
     console.log(`   Analysis focus: ${finalOptions.focus}`);
     console.log("");
     const { analyzeContext: analyzeContext2, generateSummary, calculateContextScore } = await import("@aiready/context-analyzer");
@@ -960,7 +1289,11 @@ async function contextAction(directory, options) {
         `aiready-report-${getReportTimestamp()}.json`,
         resolvedDir
       );
-      (0, import_core3.handleJSONOutput)(outputData, outputPath, `\u2705 Results saved to ${outputPath}`);
+      (0, import_core3.handleJSONOutput)(
+        outputData,
+        outputPath,
+        `\u2705 Results saved to ${outputPath}`
+      );
     } else {
       const terminalWidth = process.stdout.columns || 80;
       const dividerWidth = Math.min(60, terminalWidth - 2);
@@ -968,59 +1301,103 @@ async function contextAction(directory, options) {
       console.log(import_chalk4.default.cyan(divider));
       console.log(import_chalk4.default.bold.white("  CONTEXT ANALYSIS SUMMARY"));
       console.log(import_chalk4.default.cyan(divider) + "\n");
-      console.log(import_chalk4.default.white(`\u{1F4C1} Files analyzed: ${import_chalk4.default.bold(summary.totalFiles)}`));
-      console.log(import_chalk4.default.white(`\u{1F4CA} Total tokens: ${import_chalk4.default.bold(summary.totalTokens.toLocaleString())}`));
-      console.log(import_chalk4.default.yellow(`\u{1F4B0} Avg context budget: ${import_chalk4.default.bold(summary.avgContextBudget.toFixed(0))} tokens/file`));
-      console.log(import_chalk4.default.white(`\u23F1  Analysis time: ${import_chalk4.default.bold(elapsedTime + "s")}
-`));
+      console.log(
+        import_chalk4.default.white(`\u{1F4C1} Files analyzed: ${import_chalk4.default.bold(summary.totalFiles)}`)
+      );
+      console.log(
+        import_chalk4.default.white(
+          `\u{1F4CA} Total tokens: ${import_chalk4.default.bold(summary.totalTokens.toLocaleString())}`
+        )
+      );
+      console.log(
+        import_chalk4.default.yellow(
+          `\u{1F4B0} Avg context budget: ${import_chalk4.default.bold(summary.avgContextBudget.toFixed(0))} tokens/file`
+        )
+      );
+      console.log(
+        import_chalk4.default.white(`\u23F1  Analysis time: ${import_chalk4.default.bold(elapsedTime + "s")}
+`)
+      );
       const totalIssues = summary.criticalIssues + summary.majorIssues + summary.minorIssues;
       if (totalIssues > 0) {
         console.log(import_chalk4.default.bold("\u26A0\uFE0F  Issues Found:\n"));
         if (summary.criticalIssues > 0) {
-          console.log(import_chalk4.default.red(`   \u{1F534} Critical: ${import_chalk4.default.bold(summary.criticalIssues)}`));
+          console.log(
+            import_chalk4.default.red(`   \u{1F534} Critical: ${import_chalk4.default.bold(summary.criticalIssues)}`)
+          );
         }
         if (summary.majorIssues > 0) {
-          console.log(import_chalk4.default.yellow(`   \u{1F7E1} Major: ${import_chalk4.default.bold(summary.majorIssues)}`));
+          console.log(
+            import_chalk4.default.yellow(`   \u{1F7E1} Major: ${import_chalk4.default.bold(summary.majorIssues)}`)
+          );
         }
         if (summary.minorIssues > 0) {
-          console.log(import_chalk4.default.blue(`   \u{1F535} Minor: ${import_chalk4.default.bold(summary.minorIssues)}`));
+          console.log(
+            import_chalk4.default.blue(`   \u{1F535} Minor: ${import_chalk4.default.bold(summary.minorIssues)}`)
+          );
         }
-        console.log(import_chalk4.default.green(`
+        console.log(
+          import_chalk4.default.green(
+            `
    \u{1F4A1} Potential savings: ${import_chalk4.default.bold(summary.totalPotentialSavings.toLocaleString())} tokens
-`));
+`
+          )
+        );
       } else {
         console.log(import_chalk4.default.green("\u2705 No significant issues found!\n"));
       }
       if (summary.deepFiles.length > 0) {
         console.log(import_chalk4.default.bold("\u{1F4CF} Deep Import Chains:\n"));
-        console.log(import_chalk4.default.gray(`   Average depth: ${summary.avgImportDepth.toFixed(1)}`));
-        console.log(import_chalk4.default.gray(`   Maximum depth: ${summary.maxImportDepth}
-`));
+        console.log(
+          import_chalk4.default.gray(`   Average depth: ${summary.avgImportDepth.toFixed(1)}`)
+        );
+        console.log(
+          import_chalk4.default.gray(`   Maximum depth: ${summary.maxImportDepth}
+`)
+        );
         summary.deepFiles.slice(0, 10).forEach((item) => {
           const fileName = item.file.split("/").slice(-2).join("/");
-          console.log(`   ${import_chalk4.default.cyan("\u2192")} ${import_chalk4.default.white(fileName)} ${import_chalk4.default.dim(`(depth: ${item.depth})`)}`);
+          console.log(
+            `   ${import_chalk4.default.cyan("\u2192")} ${import_chalk4.default.white(fileName)} ${import_chalk4.default.dim(`(depth: ${item.depth})`)}`
+          );
         });
         console.log();
       }
       if (summary.fragmentedModules.length > 0) {
         console.log(import_chalk4.default.bold("\u{1F9E9} Fragmented Modules:\n"));
-        console.log(import_chalk4.default.gray(`   Average fragmentation: ${(summary.avgFragmentation * 100).toFixed(0)}%
-`));
+        console.log(
+          import_chalk4.default.gray(
+            `   Average fragmentation: ${(summary.avgFragmentation * 100).toFixed(0)}%
+`
+          )
+        );
         summary.fragmentedModules.slice(0, 10).forEach((module2) => {
-          console.log(`   ${import_chalk4.default.yellow("\u25CF")} ${import_chalk4.default.white(module2.domain)} - ${import_chalk4.default.dim(`${module2.files.length} files, ${(module2.fragmentationScore * 100).toFixed(0)}% scattered`)}`);
-          console.log(import_chalk4.default.dim(`     Token cost: ${module2.totalTokens.toLocaleString()}, Cohesion: ${(module2.avgCohesion * 100).toFixed(0)}%`));
+          console.log(
+            `   ${import_chalk4.default.yellow("\u25CF")} ${import_chalk4.default.white(module2.domain)} - ${import_chalk4.default.dim(`${module2.files.length} files, ${(module2.fragmentationScore * 100).toFixed(0)}% scattered`)}`
+          );
+          console.log(
+            import_chalk4.default.dim(
+              `     Token cost: ${module2.totalTokens.toLocaleString()}, Cohesion: ${(module2.avgCohesion * 100).toFixed(0)}%`
+            )
+          );
         });
         console.log();
       }
       if (summary.lowCohesionFiles.length > 0) {
         console.log(import_chalk4.default.bold("\u{1F500} Low Cohesion Files:\n"));
-        console.log(import_chalk4.default.gray(`   Average cohesion: ${(summary.avgCohesion * 100).toFixed(0)}%
-`));
+        console.log(
+          import_chalk4.default.gray(
+            `   Average cohesion: ${(summary.avgCohesion * 100).toFixed(0)}%
+`
+          )
+        );
         summary.lowCohesionFiles.slice(0, 10).forEach((item) => {
           const fileName = item.file.split("/").slice(-2).join("/");
           const scorePercent = (item.score * 100).toFixed(0);
           const color = item.score < 0.4 ? import_chalk4.default.red : import_chalk4.default.yellow;
-          console.log(`   ${color("\u25CB")} ${import_chalk4.default.white(fileName)} ${import_chalk4.default.dim(`(${scorePercent}% cohesion)`)}`);
+          console.log(
+            `   ${color("\u25CB")} ${import_chalk4.default.white(fileName)} ${import_chalk4.default.dim(`(${scorePercent}% cohesion)`)}`
+          );
         });
         console.log();
       }
@@ -1029,7 +1406,9 @@ async function contextAction(directory, options) {
         summary.topExpensiveFiles.slice(0, 10).forEach((item) => {
           const fileName = item.file.split("/").slice(-2).join("/");
           const severityColor = item.severity === "critical" ? import_chalk4.default.red : item.severity === "major" ? import_chalk4.default.yellow : import_chalk4.default.blue;
-          console.log(`   ${severityColor("\u25CF")} ${import_chalk4.default.white(fileName)} ${import_chalk4.default.dim(`(${item.contextBudget.toLocaleString()} tokens)`)}`);
+          console.log(
+            `   ${severityColor("\u25CF")} ${import_chalk4.default.white(fileName)} ${import_chalk4.default.dim(`(${item.contextBudget.toLocaleString()} tokens)`)}`
+          );
         });
         console.log();
       }
@@ -1080,7 +1459,10 @@ async function consistencyAction(directory, options) {
     let consistencyScore;
     if (options.score) {
       const issues = report.results?.flatMap((r) => r.issues) || [];
-      consistencyScore = calculateConsistencyScore(issues, report.summary.filesAnalyzed);
+      consistencyScore = calculateConsistencyScore(
+        issues,
+        report.summary.filesAnalyzed
+      );
     }
     const outputFormat = options.output || finalOptions.output?.format || "console";
     const userOutputFile = options.outputFile || finalOptions.output?.file;
@@ -1098,7 +1480,11 @@ async function consistencyAction(directory, options) {
         `aiready-report-${getReportTimestamp()}.json`,
         resolvedDir
       );
-      (0, import_core4.handleJSONOutput)(outputData, outputPath, `\u2705 Results saved to ${outputPath}`);
+      (0, import_core4.handleJSONOutput)(
+        outputData,
+        outputPath,
+        `\u2705 Results saved to ${outputPath}`
+      );
     } else if (outputFormat === "markdown") {
       const markdown = generateMarkdownReport(report, elapsedTime);
       const outputPath = (0, import_core4.resolveOutputPath)(
@@ -1110,15 +1496,23 @@ async function consistencyAction(directory, options) {
       console.log(import_chalk5.default.green(`\u2705 Report saved to ${outputPath}`));
     } else {
       console.log(import_chalk5.default.bold("\n\u{1F4CA} Summary\n"));
-      console.log(`Files Analyzed: ${import_chalk5.default.cyan(report.summary.filesAnalyzed)}`);
+      console.log(
+        `Files Analyzed: ${import_chalk5.default.cyan(report.summary.filesAnalyzed)}`
+      );
       console.log(`Total Issues: ${import_chalk5.default.yellow(report.summary.totalIssues)}`);
       console.log(`  Naming: ${import_chalk5.default.yellow(report.summary.namingIssues)}`);
       console.log(`  Patterns: ${import_chalk5.default.yellow(report.summary.patternIssues)}`);
-      console.log(`  Architecture: ${import_chalk5.default.yellow(report.summary.architectureIssues || 0)}`);
+      console.log(
+        `  Architecture: ${import_chalk5.default.yellow(report.summary.architectureIssues || 0)}`
+      );
       console.log(`Analysis Time: ${import_chalk5.default.gray(elapsedTime + "s")}
 `);
       if (report.summary.totalIssues === 0) {
-        console.log(import_chalk5.default.green("\u2728 No consistency issues found! Your codebase is well-maintained.\n"));
+        console.log(
+          import_chalk5.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")
@@ -1134,10 +1528,14 @@ async function consistencyAction(directory, options) {
             for (const issue of result.issues) {
               if (shown >= 5) break;
               const severityColor = issue.severity === "critical" ? import_chalk5.default.red : issue.severity === "major" ? import_chalk5.default.yellow : issue.severity === "minor" ? import_chalk5.default.blue : import_chalk5.default.gray;
-              console.log(`${severityColor(issue.severity.toUpperCase())} ${import_chalk5.default.dim(`${issue.location.file}:${issue.location.line}`)}`);
+              console.log(
+                `${severityColor(issue.severity.toUpperCase())} ${import_chalk5.default.dim(`${issue.location.file}:${issue.location.line}`)}`
+              );
               console.log(`  ${issue.message}`);
               if (issue.suggestion) {
-                console.log(`  ${import_chalk5.default.dim("\u2192")} ${import_chalk5.default.italic(issue.suggestion)}`);
+                console.log(
+                  `  ${import_chalk5.default.dim("\u2192")} ${import_chalk5.default.italic(issue.suggestion)}`
+                );
               }
               console.log();
               shown++;
@@ -1157,10 +1555,14 @@ async function consistencyAction(directory, options) {
             for (const issue of result.issues) {
               if (shown >= 5) break;
               const severityColor = issue.severity === "critical" ? import_chalk5.default.red : issue.severity === "major" ? import_chalk5.default.yellow : issue.severity === "minor" ? import_chalk5.default.blue : import_chalk5.default.gray;
-              console.log(`${severityColor(issue.severity.toUpperCase())} ${import_chalk5.default.dim(`${issue.location.file}:${issue.location.line}`)}`);
+              console.log(
+                `${severityColor(issue.severity.toUpperCase())} ${import_chalk5.default.dim(`${issue.location.file}:${issue.location.line}`)}`
+              );
               console.log(`  ${issue.message}`);
               if (issue.suggestion) {
-                console.log(`  ${import_chalk5.default.dim("\u2192")} ${import_chalk5.default.italic(issue.suggestion)}`);
+                console.log(
+                  `  ${import_chalk5.default.dim("\u2192")} ${import_chalk5.default.italic(issue.suggestion)}`
+                );
               }
               console.log();
               shown++;
@@ -1206,15 +1608,21 @@ async function visualizeAction(directory, options) {
       const latestScan = findLatestScanReport(dirPath);
       if (latestScan) {
         reportPath = latestScan;
-        console.log(import_chalk6.default.dim(`Found latest report: ${latestScan.split("/").pop()}`));
+        console.log(
+          import_chalk6.default.dim(`Found latest report: ${latestScan.split("/").pop()}`)
+        );
       } else {
         console.error(import_chalk6.default.red("\u274C No AI readiness report found"));
-        console.log(import_chalk6.default.dim(`
+        console.log(
+          import_chalk6.default.dim(
+            `
 Generate a report with:
   aiready scan --output json
 
 Or specify a custom report:
-  aiready visualise --report <path-to-report.json>`));
+  aiready visualise --report <path-to-report.json>`
+          )
+        );
         return;
       }
     }
@@ -1232,6 +1640,7 @@ Or specify a custom report:
           };
         }
       } catch (e) {
+        void e;
       }
     }
     const envVisualizerConfig = JSON.stringify(graphConfig);
@@ -1252,11 +1661,18 @@ Or specify a custom report:
         } else {
           const nodemodulesLocations = [
             (0, import_path6.resolve)(dirPath, "node_modules", "@aiready", "visualizer"),
-            (0, import_path6.resolve)(process.cwd(), "node_modules", "@aiready", "visualizer")
+            (0, import_path6.resolve)(
+              process.cwd(),
+              "node_modules",
+              "@aiready",
+              "visualizer"
+            )
           ];
           let currentDir = dirPath;
           while (currentDir !== "/" && currentDir !== ".") {
-            nodemodulesLocations.push((0, import_path6.resolve)(currentDir, "node_modules", "@aiready", "visualizer"));
+            nodemodulesLocations.push(
+              (0, import_path6.resolve)(currentDir, "node_modules", "@aiready", "visualizer")
+            );
             const parent = (0, import_path6.resolve)(currentDir, "..");
             if (parent === currentDir) break;
             currentDir = parent;
@@ -1273,7 +1689,8 @@ Or specify a custom report:
               const vizPkgPath = require.resolve("@aiready/visualizer/package.json");
               webDir = (0, import_path6.resolve)(vizPkgPath, "..");
               visualizerAvailable = true;
-            } catch (e) {
+            } catch (err) {
+              void err;
             }
           }
         }
@@ -1301,30 +1718,46 @@ Or specify a custom report:
             AIREADY_REPORT_PATH: reportPath,
             AIREADY_VISUALIZER_CONFIG: envVisualizerConfig
           };
-          const vite = (0, import_child_process.spawn)("pnpm", ["run", "dev:web"], { cwd: spawnCwd, stdio: "inherit", shell: true, env: envForSpawn });
+          const vite = (0, import_child_process.spawn)("pnpm", ["run", "dev:web"], {
+            cwd: spawnCwd,
+            stdio: "inherit",
+            shell: true,
+            env: envForSpawn
+          });
           const onExit = () => {
             try {
               reportWatcher.close();
-            } catch (e) {
+            } catch (err) {
+              void err;
             }
             try {
               vite.kill();
-            } catch (e) {
+            } catch (err) {
+              void err;
             }
             process.exit(0);
           };
           process.on("SIGINT", onExit);
           process.on("SIGTERM", onExit);
           devServerStarted = true;
+          void devServerStarted;
           return;
         } else {
-          console.log(import_chalk6.default.yellow("\u26A0\uFE0F  Dev server not available (requires local @aiready/visualizer with web assets)."));
-          console.log(import_chalk6.default.cyan("   Falling back to static HTML generation...\n"));
+          console.log(
+            import_chalk6.default.yellow(
+              "\u26A0\uFE0F  Dev server not available (requires local @aiready/visualizer with web assets)."
+            )
+          );
+          console.log(
+            import_chalk6.default.cyan("   Falling back to static HTML generation...\n")
+          );
           useDevMode = false;
         }
       } catch (err) {
         console.error("Failed to start dev server:", err);
-        console.log(import_chalk6.default.cyan("   Falling back to static HTML generation...\n"));
+        console.log(
+          import_chalk6.default.cyan("   Falling back to static HTML generation...\n")
+        );
         useDevMode = false;
       }
     }
@@ -1346,20 +1779,25 @@ Or specify a custom report:
               const urlPath = req.url || "/";
               if (urlPath === "/" || urlPath === "/index.html") {
                 const content = await fsp.readFile(outPath, "utf8");
-                res.writeHead(200, { "Content-Type": "text/html; charset=utf-8" });
+                res.writeHead(200, {
+                  "Content-Type": "text/html; charset=utf-8"
+                });
                 res.end(content);
                 return;
               }
               res.writeHead(404, { "Content-Type": "text/plain" });
               res.end("Not found");
             } catch (e) {
+              void e;
               res.writeHead(500, { "Content-Type": "text/plain" });
               res.end("Server error");
             }
           });
           server.listen(port, () => {
             const addr = `http://localhost:${port}/`;
-            console.log(import_chalk6.default.cyan(`\u{1F310} Local visualization server running at ${addr}`));
+            console.log(
+              import_chalk6.default.cyan(`\u{1F310} Local visualization server running at ${addr}`)
+            );
             (0, import_child_process.spawn)(opener, [`"${addr}"`], { shell: true });
           });
           process.on("SIGINT", () => {
@@ -1425,9 +1863,13 @@ var getDirname = () => {
   if (typeof __dirname !== "undefined") return __dirname;
   return (0, import_path7.dirname)((0, import_url.fileURLToPath)(import_meta.url));
 };
-var packageJson = JSON.parse((0, import_fs5.readFileSync)((0, import_path7.join)(getDirname(), "../package.json"), "utf8"));
+var packageJson = JSON.parse(
+  (0, import_fs5.readFileSync)((0, import_path7.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("after", `
+program.name("aiready").description("AIReady - Assess and improve AI-readiness of codebases").version(packageJson.version).addHelpText(
+  "after",
+  `
 AI READINESS SCORING:
   Get a 0-100 score indicating how AI-ready your codebase is.
   Use --score flag with any analysis command for detailed breakdown.
@@ -1462,23 +1904,105 @@ CONFIGURATION:
 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, 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("--no-score", "Disable calculating AI Readiness Score (enabled by default)").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").addHelpText("after", scanHelpText).action(async (directory, options) => {
+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, 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(
+  "--no-score",
+  "Disable calculating AI Readiness Score (enabled by default)"
+).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"
+).addHelpText("after", scanHelpText).action(async (directory, options) => {
   await scanAction(directory, options);
 });
-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 for patterns (0-100)").addHelpText("after", patternsHelpText).action(async (directory, options) => {
+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 for patterns (0-100)"
+).addHelpText("after", patternsHelpText).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 for context (0-100)").action(async (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 for context (0-100)"
+).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 for consistency (0-100)").action(async (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 for consistency (0-100)"
+).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)").option("-o, --output <path>", "Output HTML path (relative to directory)", "packages/visualizer/visualization.html").option("--open", "Open generated HTML in default browser").option("--serve [port]", "Start a local static server to serve the visualization (optional port number)", false).option("--dev", "Start Vite dev server (live reload) for interactive development", true).addHelpText("after", visualiseHelpText).action(async (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)"
+).option(
+  "-o, --output <path>",
+  "Output HTML path (relative to directory)",
+  "packages/visualizer/visualization.html"
+).option("--open", "Open generated HTML in default browser").option(
+  "--serve [port]",
+  "Start a local static server to serve the visualization (optional port number)",
+  false
+).option(
+  "--dev",
+  "Start Vite dev server (live reload) for interactive development",
+  true
+).addHelpText("after", visualiseHelpText).action(async (directory, options) => {
   await visualizeAction(directory, options);
 });
-program.command("visualize").description("Generate interactive visualization from an AIReady report").argument("[directory]", "Directory to analyze", ".").option("--report <path>", "Report path (auto-detects latest .aiready/aiready-report-*.json if not provided)").option("-o, --output <path>", "Output HTML path (relative to directory)", "packages/visualizer/visualization.html").option("--open", "Open generated HTML in default browser").option("--serve [port]", "Start a local static server to serve the visualization (optional port number)", false).option("--dev", "Start Vite dev server (live reload) for interactive development", false).addHelpText("after", visualizeHelpText).action(async (directory, options) => {
+program.command("visualize").description("Generate interactive visualization from an AIReady report").argument("[directory]", "Directory to analyze", ".").option(
+  "--report <path>",
+  "Report path (auto-detects latest .aiready/aiready-report-*.json if not provided)"
+).option(
+  "-o, --output <path>",
+  "Output HTML path (relative to directory)",
+  "packages/visualizer/visualization.html"
+).option("--open", "Open generated HTML in default browser").option(
+  "--serve [port]",
+  "Start a local static server to serve the visualization (optional port number)",
+  false
+).option(
+  "--dev",
+  "Start Vite dev server (live reload) for interactive development",
+  false
+).addHelpText("after", visualizeHelpText).action(async (directory, options) => {
   await visualizeAction(directory, options);
 });
 program.command("change-amplification").description("Analyze graph metrics for change amplification").argument("[directory]", "Directory to analyze", ".").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)").action(async (directory, options) => {