@aiready/cli 0.14.22 → 0.14.23

package/dist/cli.mjs

@@ -3,7 +3,7 @@ import {
   __require,
   analyzeUnified,
   scoreUnified
-} from "./chunk-JRRBBFYB.mjs";
+} from "./chunk-HUSUJEQJ.mjs";
 
 // src/cli.ts
 import { Command } from "commander";
@@ -12,17 +12,14 @@ import { join as join2, dirname } from "path";
 import { fileURLToPath } from "url";
 
 // src/commands/scan.ts
-import chalk5 from "chalk";
-import { writeFileSync, readFileSync as readFileSync2 } from "fs";
-import { resolve as resolvePath3 } from "path";
+import chalk6 from "chalk";
+import { writeFileSync } from "fs";
+import { resolve as resolvePath4 } from "path";
 import {
-  loadMergedConfig,
-  handleJSONOutput,
+  handleJSONOutput as handleJSONOutput2,
   handleCLIError as handleCLIError2,
   resolveOutputPath,
   getRepoMetadata,
-  calculateTokenBudget,
-  ToolName as ToolName2,
   emitIssuesAsAnnotations
 } from "@aiready/core";
 
@@ -31,12 +28,11 @@ import { resolve as resolvePath } from "path";
 import { existsSync, readFileSync } from "fs";
 import chalk from "chalk";
 import { loadConfig, mergeConfigWithDefaults } from "@aiready/core";
-import { findLatestReport } from "@aiready/core";
-function getReportTimestamp() {
-  const now = /* @__PURE__ */ new Date();
-  const pad = (n) => String(n).padStart(2, "0");
-  return `${now.getFullYear()}${pad(now.getMonth() + 1)}${pad(now.getDate())}-${pad(now.getHours())}${pad(now.getMinutes())}${pad(now.getSeconds())}`;
-}
+import {
+  findLatestReport,
+  getReportTimestamp,
+  handleJSONOutput
+} from "@aiready/core";
 async function warnIfGraphCapExceeded(report, dirPath) {
   try {
     const { loadConfig: loadConfig4 } = await import("@aiready/core");
@@ -247,19 +243,22 @@ function printScoring(scoringResult, scoringProfile) {
         `  ${progressBar} ${tool.score}/100 (${rating}) ${emoji} ${tool.toolName}`
       );
     });
-    const allRecs = scoringResult.breakdown.flatMap(
-      (t) => (t.recommendations ?? []).map((r) => ({ ...r, tool: t.toolName }))
-    ).sort((a, b) => b.estimatedImpact - a.estimatedImpact).slice(0, 5);
-    if (allRecs.length > 0) {
-      console.log(chalk2.bold("\n\u{1F3AF} Top Actionable Recommendations:"));
-      allRecs.forEach((rec, i) => {
-        const priorityIcon = rec.priority === "high" ? "\u{1F534}" : rec.priority === "medium" ? "\u{1F7E1}" : "\u{1F535}";
-        console.log(`  ${i + 1}. ${priorityIcon} ${chalk2.bold(rec.action)}`);
-        console.log(
-          `     Impact: ${chalk2.green(`+${rec.estimatedImpact} points`)} to ${rec.tool}`
-        );
-      });
-    }
+    printTopRecommendations(scoringResult.breakdown);
+  }
+}
+function printTopRecommendations(breakdown) {
+  const allRecs = breakdown.flatMap(
+    (t) => (t.recommendations ?? []).map((r) => ({ ...r, tool: t.toolName }))
+  ).sort((a, b) => b.estimatedImpact - a.estimatedImpact).slice(0, 5);
+  if (allRecs.length > 0) {
+    console.log(chalk2.bold("\n\u{1F3AF} Top Actionable Recommendations:"));
+    allRecs.forEach((rec, i) => {
+      const priorityIcon = rec.priority === "high" ? "\u{1F534}" : rec.priority === "medium" ? "\u{1F7E1}" : "\u{1F535}";
+      console.log(`  ${i + 1}. ${priorityIcon} ${chalk2.bold(rec.action)}`);
+      console.log(
+        `     Impact: ${chalk2.green(`+${rec.estimatedImpact} points`)} to ${rec.tool}`
+      );
+    });
   }
 }
 function mapToUnifiedReport(res, scoring) {
@@ -399,6 +398,9 @@ ENVIRONMENT VARIABLES:
   AIREADY_SERVER     Custom platform URL (default: https://dev.platform.getaiready.dev)
 `;
 
+// src/commands/scan-config.ts
+import { loadMergedConfig, ToolName as ToolName2 } from "@aiready/core";
+
 // src/commands/scan-helpers.ts
 import chalk4 from "chalk";
 import { ToolName } from "@aiready/core";
@@ -470,180 +472,211 @@ function createProgressCallback() {
   };
 }
 
-// src/commands/scan.ts
-async function scanAction(directory, options) {
-  console.log(chalk5.blue("\u{1F680} Starting AIReady unified analysis...\n"));
-  const startTime = Date.now();
-  const resolvedDir = resolvePath3(process.cwd(), directory ?? ".");
-  const repoMetadata = getRepoMetadata(resolvedDir);
-  try {
-    const defaults = {
-      tools: [
-        "pattern-detect",
-        "context-analyzer",
-        "naming-consistency",
-        "ai-signal-clarity",
-        "agent-grounding",
-        "testability-index",
-        "doc-drift",
-        "dependency-health",
-        "change-amplification"
-      ],
-      include: void 0,
-      exclude: void 0,
-      output: {
-        format: "console",
-        file: void 0
-      }
-    };
-    let profileTools = options.tools ? options.tools.split(",").map((t) => t.trim()) : void 0;
-    if (options.profile) {
-      profileTools = getProfileTools(options.profile);
-    }
-    const cliOverrides = {
-      include: options.include?.split(","),
-      exclude: options.exclude?.split(",")
-    };
-    if (profileTools) cliOverrides.tools = profileTools;
-    const baseOptions = await loadMergedConfig(
+// src/commands/scan-config.ts
+var SCAN_DEFAULTS = {
+  tools: [
+    "pattern-detect",
+    "context-analyzer",
+    "naming-consistency",
+    "ai-signal-clarity",
+    "agent-grounding",
+    "testability-index",
+    "doc-drift",
+    "dependency-health",
+    "change-amplification"
+  ],
+  include: void 0,
+  exclude: void 0,
+  output: {
+    format: "console",
+    file: void 0
+  }
+};
+async function resolveScanConfig(resolvedDir, options) {
+  let profileTools = options.tools ? options.tools.split(",").map((t) => t.trim()) : void 0;
+  if (options.profile) {
+    profileTools = getProfileTools(options.profile);
+  }
+  const cliOverrides = {
+    include: options.include?.split(","),
+    exclude: options.exclude?.split(",")
+  };
+  if (profileTools) cliOverrides.tools = profileTools;
+  const baseOptions = await loadMergedConfig(
+    resolvedDir,
+    SCAN_DEFAULTS,
+    cliOverrides
+  );
+  const finalOptions = { ...baseOptions };
+  if (baseOptions.tools.includes(ToolName2.PatternDetect) || baseOptions.tools.includes("patterns")) {
+    const { getSmartDefaults } = await import("@aiready/pattern-detect");
+    const patternSmartDefaults = await getSmartDefaults(
       resolvedDir,
-      defaults,
-      cliOverrides
+      finalOptions.toolConfigs?.[ToolName2.PatternDetect] ?? {}
     );
-    const finalOptions = { ...baseOptions };
-    if (baseOptions.tools.includes(ToolName2.PatternDetect) || baseOptions.tools.includes("patterns")) {
-      const { getSmartDefaults } = await import("@aiready/pattern-detect");
-      const patternSmartDefaults = await getSmartDefaults(
-        resolvedDir,
-        finalOptions.toolConfigs?.[ToolName2.PatternDetect] ?? {}
-      );
-      if (!finalOptions.toolConfigs) finalOptions.toolConfigs = {};
-      finalOptions.toolConfigs[ToolName2.PatternDetect] = {
-        ...patternSmartDefaults,
-        ...finalOptions.toolConfigs[ToolName2.PatternDetect]
-      };
-    }
-    console.log(chalk5.cyan("\n=== AIReady Run Preview ==="));
-    console.log(
-      chalk5.white("Tools to run:"),
-      (finalOptions.tools ?? []).join(", ")
-    );
-    const progressCallback = createProgressCallback();
-    const scoringProfile = options.profile ?? baseOptions.scoring?.profile ?? "default";
-    const results = await analyzeUnified({
+    if (!finalOptions.toolConfigs) finalOptions.toolConfigs = {};
+    finalOptions.toolConfigs[ToolName2.PatternDetect] = {
+      ...patternSmartDefaults,
+      ...finalOptions.toolConfigs[ToolName2.PatternDetect]
+    };
+  }
+  return finalOptions;
+}
+
+// src/commands/scan-orchestrator.ts
+import chalk5 from "chalk";
+import { readFileSync as readFileSync2 } from "fs";
+import { resolve as resolvePath3 } from "path";
+import { calculateTokenBudget } from "@aiready/core";
+async function runUnifiedScan(resolvedDir, finalOptions, options, startTime) {
+  console.log(chalk5.cyan("\n=== AIReady Run Preview ==="));
+  console.log(
+    chalk5.white("Tools to run:"),
+    (finalOptions.tools ?? []).join(", ")
+  );
+  const progressCallback = createProgressCallback();
+  const scoringProfile = options.profile ?? finalOptions.scoring?.profile ?? "default";
+  const results = await analyzeUnified({
+    ...finalOptions,
+    progressCallback,
+    onProgress: () => {
+    },
+    suppressToolConfig: true
+  });
+  printScanSummary(results, startTime);
+  let scoringResult;
+  if (options.score || finalOptions.scoring?.showBreakdown) {
+    scoringResult = await scoreUnified(results, {
       ...finalOptions,
-      progressCallback,
-      onProgress: () => {
-      },
-      suppressToolConfig: true
+      scoring: {
+        ...finalOptions.scoring,
+        profile: scoringProfile
+      }
     });
-    printScanSummary(results, startTime);
-    let scoringResult;
-    if (options.score || finalOptions.scoring?.showBreakdown) {
-      scoringResult = await scoreUnified(results, {
-        ...finalOptions,
-        scoring: {
-          ...finalOptions.scoring,
-          profile: scoringProfile
-        }
-      });
-      printScoring(scoringResult, scoringProfile);
-      if (options.compareTo) {
-        try {
-          const prevReport = JSON.parse(
-            readFileSync2(resolvePath3(process.cwd(), options.compareTo), "utf8")
-          );
-          const prevScore = prevReport.scoring?.overall ?? prevReport.scoring?.score;
-          if (typeof prevScore === "number") {
-            const diff = scoringResult.overall - prevScore;
-            const diffStr = diff > 0 ? `+${diff}` : String(diff);
-            if (diff > 0)
-              console.log(
-                chalk5.green(
-                  `  \u{1F4C8} Trend: ${diffStr} compared to ${options.compareTo} (${prevScore} \u2192 ${scoringResult.overall})`
-                )
-              );
-            else if (diff < 0)
-              console.log(
-                chalk5.red(
-                  `  \u{1F4C9} Trend: ${diffStr} compared to ${options.compareTo} (${prevScore} \u2192 ${scoringResult.overall})`
-                )
-              );
-            else
-              console.log(
-                chalk5.blue(
-                  `  \u2796 Trend: No change (${prevScore} \u2192 ${scoringResult.overall})`
-                )
-              );
-          }
-        } catch (e) {
-          void e;
-        }
+    printScoring(scoringResult, scoringProfile);
+    if (options.compareTo) {
+      handleTrendComparison(options.compareTo, scoringResult);
+    }
+    await handleBusinessImpactMetrics(
+      results,
+      scoringResult,
+      options.model ?? "gpt-5.4-mini"
+    );
+  }
+  return { results, scoringResult };
+}
+function handleTrendComparison(baselinePath, currentScoring) {
+  try {
+    const prevReport = JSON.parse(
+      readFileSync2(resolvePath3(process.cwd(), baselinePath), "utf8")
+    );
+    const prevScore = prevReport.scoring?.overall ?? prevReport.scoring?.score;
+    if (typeof prevScore === "number") {
+      const diff = currentScoring.overall - prevScore;
+      const diffStr = diff > 0 ? `+${diff}` : String(diff);
+      if (diff > 0)
+        console.log(
+          chalk5.green(
+            `  \u{1F4C8} Trend: ${diffStr} compared to ${baselinePath} (${prevScore} \u2192 ${currentScoring.overall})`
+          )
+        );
+      else if (diff < 0)
+        console.log(
+          chalk5.red(
+            `  \u{1F4C9} Trend: ${diffStr} compared to ${baselinePath} (${prevScore} \u2192 ${currentScoring.overall})`
+          )
+        );
+      else
+        console.log(
+          chalk5.blue(
+            `  \u2796 Trend: No change (${prevScore} \u2192 ${currentScoring.overall})`
+          )
+        );
+    }
+  } catch (e) {
+    void e;
+  }
+}
+async function handleBusinessImpactMetrics(results, scoringResult, modelId) {
+  const totalWastedDuplication = (scoringResult.breakdown ?? []).reduce(
+    (sum, s) => sum + (s.tokenBudget?.wastedTokens?.bySource?.duplication ?? 0),
+    0
+  );
+  const totalWastedFragmentation = (scoringResult.breakdown ?? []).reduce(
+    (sum, s) => sum + (s.tokenBudget?.wastedTokens?.bySource?.fragmentation ?? 0),
+    0
+  );
+  const totalContext = Math.max(
+    ...(scoringResult.breakdown ?? []).map(
+      (s) => s.tokenBudget?.totalContextTokens ?? 0
+    ),
+    0
+  );
+  if (totalContext > 0) {
+    const unifiedBudget = calculateTokenBudget({
+      totalContextTokens: totalContext,
+      wastedTokens: {
+        duplication: totalWastedDuplication,
+        fragmentation: totalWastedFragmentation,
+        chattiness: totalContext * 0.1
+        // Default chattiness
       }
-      const totalWastedDuplication = (scoringResult.breakdown ?? []).reduce(
-        (sum, s) => sum + (s.tokenBudget?.wastedTokens?.bySource?.duplication ?? 0),
-        0
-      );
-      const totalWastedFragmentation = (scoringResult.breakdown ?? []).reduce(
-        (sum, s) => sum + (s.tokenBudget?.wastedTokens?.bySource?.fragmentation ?? 0),
-        0
-      );
-      const totalContext = Math.max(
-        ...(scoringResult.breakdown ?? []).map(
-          (s) => s.tokenBudget?.totalContextTokens ?? 0
-        ),
-        0
-      );
-      if (totalContext > 0) {
-        const unifiedBudget = calculateTokenBudget({
-          totalContextTokens: totalContext,
-          wastedTokens: {
-            duplication: totalWastedDuplication,
-            fragmentation: totalWastedFragmentation,
-            chattiness: totalContext * 0.1
-            // Default chattiness
-          }
-        });
-        const allIssues = [];
-        for (const toolId of results.summary.toolsRun) {
-          if (results[toolId]?.results) {
-            results[toolId].results.forEach((fileRes) => {
-              if (fileRes.issues) {
-                allIssues.push(...fileRes.issues);
-              }
-            });
+    });
+    const allIssues = [];
+    for (const toolId of results.summary.toolsRun) {
+      if (results[toolId]?.results) {
+        results[toolId].results.forEach((fileRes) => {
+          if (fileRes.issues) {
+            allIssues.push(...fileRes.issues);
           }
-        }
-        const modelId = options.model ?? "gpt-5.4-mini";
-        const roi = (await import("@aiready/core")).calculateBusinessROI({
-          tokenWaste: unifiedBudget.wastedTokens.total,
-          issues: allIssues,
-          modelId
         });
-        printBusinessImpact(roi, unifiedBudget);
-        results.summary.businessImpact = {
-          estimatedMonthlyWaste: roi.monthlySavings,
-          potentialSavings: roi.monthlySavings,
-          productivityHours: roi.productivityGainHours
-        };
-        scoringResult.tokenBudget = unifiedBudget;
-        scoringResult.businessROI = roi;
       }
     }
+    const { calculateBusinessROI } = await import("@aiready/core");
+    const roi = calculateBusinessROI({
+      tokenWaste: unifiedBudget.wastedTokens.total,
+      issues: allIssues,
+      modelId
+    });
+    printBusinessImpact(roi, unifiedBudget);
+    results.summary.businessImpact = {
+      estimatedMonthlyWaste: roi.monthlySavings,
+      potentialSavings: roi.monthlySavings,
+      productivityHours: roi.productivityGainHours
+    };
+    scoringResult.tokenBudget = unifiedBudget;
+    scoringResult.businessROI = roi;
+  }
+}
+
+// src/commands/scan.ts
+async function scanAction(directory, options) {
+  console.log(chalk6.blue("\u{1F680} Starting AIReady unified analysis...\n"));
+  const startTime = Date.now();
+  const resolvedDir = resolvePath4(process.cwd(), directory ?? ".");
+  const repoMetadata = getRepoMetadata(resolvedDir);
+  try {
+    const finalOptions = await resolveScanConfig(resolvedDir, options);
+    const { results, scoringResult } = await runUnifiedScan(
+      resolvedDir,
+      finalOptions,
+      options,
+      startTime
+    );
     console.log(
-      chalk5.dim(
+      chalk6.dim(
         "\n\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500"
       )
     );
-    console.log(chalk5.dim("\u{1F4AC} Found a bug or have a metric idea?"));
-    console.log(chalk5.dim("\u{1F449} Copy/paste this to your AI agent:"));
+    console.log(chalk6.dim("\u{1F4AC} Found a bug or have a metric idea?"));
+    console.log(chalk6.dim("\u{1F449} Copy/paste this to your AI agent:"));
     console.log(
-      chalk5.cyan(
+      chalk6.cyan(
         `   "Any feedback for the tools? Please use 'aiready bug' to report \u2764\uFE0F"`
       )
     );
     console.log(
-      chalk5.dim(
+      chalk6.dim(
         "\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500"
       )
     );
@@ -658,7 +691,7 @@ async function scanAction(directory, options) {
       resolvedDir
     );
     if (outputFormat === "json") {
-      handleJSONOutput(
+      handleJSONOutput2(
         outputData,
         outputPath,
         `\u2705 Report saved to ${outputPath}`
@@ -666,7 +699,7 @@ async function scanAction(directory, options) {
     } else {
       try {
         writeFileSync(outputPath, JSON.stringify(outputData, null, 2));
-        console.log(chalk5.dim(`\u2705 Report auto-persisted to ${outputPath}`));
+        console.log(chalk6.dim(`\u2705 Report auto-persisted to ${outputPath}`));
       } catch (err) {
         void err;
       }
@@ -678,53 +711,75 @@ async function scanAction(directory, options) {
       });
     }
     await warnIfGraphCapExceeded(outputData, resolvedDir);
-    if (scoringResult) {
-      const threshold = options.threshold ? parseInt(options.threshold) : void 0;
-      const failOnLevel = options.failOn ?? "critical";
-      const isCI = options.ci ?? process.env.CI === "true";
-      let shouldFail = false;
-      let failReason = "";
-      const report = mapToUnifiedReport(results, scoringResult);
-      if (isCI && report.results && report.results.length > 0) {
-        console.log(
-          chalk5.cyan(
-            `
-\u{1F4DD} Emitting GitHub Action annotations for ${report.results.length} issues...`
-          )
-        );
-        emitIssuesAsAnnotations(report.results);
-      }
-      if (threshold && scoringResult.overall < threshold) {
-        shouldFail = true;
-        failReason = `Score ${scoringResult.overall} < threshold ${threshold}`;
-      }
-      if (failOnLevel !== "none") {
-        if (failOnLevel === "critical" && report.summary.criticalIssues > 0) {
-          shouldFail = true;
-          failReason = `Found ${report.summary.criticalIssues} critical issues`;
-        } else if (failOnLevel === "major" && report.summary.criticalIssues + report.summary.majorIssues > 0) {
-          shouldFail = true;
-          failReason = `Found ${report.summary.criticalIssues} critical and ${report.summary.majorIssues} major issues`;
-        }
-      }
-      if (shouldFail) {
-        console.log(chalk5.red(`
-\u{1F6AB} SCAN FAILED: ${failReason}`));
-        process.exit(1);
-      } else {
-        console.log(chalk5.green("\n\u2705 SCAN PASSED"));
-      }
-    }
+    await handleGatekeeper(outputData, scoringResult, options, results);
   } catch (error) {
     handleCLIError2(error, "Analysis");
   }
 }
-var SCAN_HELP_TEXT = `...`;
+async function handleGatekeeper(outputData, scoringResult, options, results) {
+  if (!scoringResult) return;
+  const threshold = options.threshold ? parseInt(options.threshold) : void 0;
+  const failOnLevel = options.failOn ?? "critical";
+  const isCI = options.ci ?? process.env.CI === "true";
+  let shouldFail = false;
+  let failReason = "";
+  const report = mapToUnifiedReport(results, scoringResult);
+  if (isCI && report.results && report.results.length > 0) {
+    console.log(
+      chalk6.cyan(
+        `
+\u{1F4DD} Emitting GitHub Action annotations for ${report.results.length} issues...`
+      )
+    );
+    emitIssuesAsAnnotations(report.results);
+  }
+  if (threshold && scoringResult.overall < threshold) {
+    shouldFail = true;
+    failReason = `Score ${scoringResult.overall} < threshold ${threshold}`;
+  }
+  if (failOnLevel !== "none") {
+    if (failOnLevel === "critical" && report.summary.criticalIssues > 0) {
+      shouldFail = true;
+      failReason = `Found ${report.summary.criticalIssues} critical issues`;
+    } else if (failOnLevel === "major" && report.summary.criticalIssues + report.summary.majorIssues > 0) {
+      shouldFail = true;
+      failReason = `Found ${report.summary.criticalIssues} critical and ${report.summary.majorIssues} major issues`;
+    }
+  }
+  if (shouldFail) {
+    console.log(chalk6.red(`
+\u{1F6AB} SCAN FAILED: ${failReason}`));
+    process.exit(1);
+  } else {
+    console.log(chalk6.green("\n\u2705 SCAN PASSED"));
+  }
+}
+var SCAN_HELP_TEXT = `
+Run a comprehensive AI-readiness scan of your codebase.
+
+${chalk6.bold("Examples:")}
+  $ aiready scan .
+  $ aiready scan src --profile agentic
+  $ aiready scan . --threshold 80 --fail-on critical
+  $ aiready scan . --output json --output-file report.json
+
+${chalk6.bold("Profiles:")}
+  agentic     - Focus on AI signal clarity and agent grounding
+  cost        - Focus on token budget and pattern reuse
+  logic       - Focus on testability and naming consistency
+  ui          - Focus on component naming and documentation
+  security    - Focus on naming and testability
+  onboarding  - Focus on context and grounding
+
+${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.
+`;
 
 // src/commands/init.ts
 import { writeFileSync as writeFileSync2, existsSync as existsSync2 } from "fs";
 import { join } from "path";
-import chalk6 from "chalk";
+import chalk7 from "chalk";
 import { ToolName as ToolName3 } from "@aiready/core";
 async function initAction(options) {
   const fileExt = options.format === "js" ? "js" : "json";
@@ -732,7 +787,7 @@ async function initAction(options) {
   const filePath = join(process.cwd(), fileName);
   if (existsSync2(filePath) && !options.force) {
     console.error(
-      chalk6.red(`Error: ${fileName} already exists. Use --force to overwrite.`)
+      chalk7.red(`Error: ${fileName} already exists. Use --force to overwrite.`)
     );
     process.exit(1);
   }
@@ -954,35 +1009,36 @@ module.exports = ${JSON.stringify(defaultConfig, null, 2)};
   try {
     writeFileSync2(filePath, content, "utf8");
     console.log(
-      chalk6.green(`
-\u2705 Created default configuration: ${chalk6.bold(fileName)}`)
+      chalk7.green(`
+\u2705 Created default configuration: ${chalk7.bold(fileName)}`)
     );
     console.log(
-      chalk6.cyan("You can now fine-tune your settings and run AIReady with:")
+      chalk7.cyan("You can now fine-tune your settings and run AIReady with:")
     );
-    console.log(chalk6.white(`  $ aiready scan
+    console.log(chalk7.white(`  $ aiready scan
 `));
   } catch (error) {
-    console.error(chalk6.red(`Failed to write configuration file: ${error}`));
+    console.error(chalk7.red(`Failed to write configuration file: ${error}`));
     process.exit(1);
   }
 }
 
 // src/commands/patterns.ts
-import chalk7 from "chalk";
-import { resolve as resolvePath4 } from "path";
+import chalk8 from "chalk";
 import {
-  loadMergedConfig as loadMergedConfig2,
-  handleJSONOutput as handleJSONOutput2,
   handleCLIError as handleCLIError3,
   getElapsedTime,
-  resolveOutputPath as resolveOutputPath2,
-  formatToolScore
+  formatToolScore,
+  printTerminalHeader,
+  getTerminalDivider,
+  prepareActionConfig,
+  resolveOutputFormat,
+  formatStandardReport,
+  handleStandardJSONOutput
 } from "@aiready/core";
 async function patternsAction(directory, options) {
-  console.log(chalk7.blue("\u{1F50D} Analyzing patterns...\n"));
+  console.log(chalk8.blue("\u{1F50D} Analyzing patterns...\n"));
   const startTime = Date.now();
-  const resolvedDir = resolvePath4(process.cwd(), directory ?? ".");
   try {
     const useSmartDefaults = !options.fullScan;
     const defaults = {
@@ -1011,8 +1067,8 @@ async function patternsAction(directory, options) {
     if (options.minSharedTokens) {
       cliOptions.minSharedTokens = parseInt(options.minSharedTokens);
     }
-    const finalOptions = await loadMergedConfig2(
-      resolvedDir,
+    const { resolvedDir, finalOptions } = await prepareActionConfig(
+      directory,
       defaults,
       cliOptions
     );
@@ -1026,60 +1082,53 @@ async function patternsAction(directory, options) {
     if (options.score) {
       patternScore = calculatePatternScore(duplicates, results.length);
     }
-    const outputFormat = options.output ?? finalOptions.output?.format ?? "console";
-    const userOutputFile = options.outputFile ?? finalOptions.output?.file;
+    const { format: outputFormat, file: userOutputFile } = resolveOutputFormat(
+      options,
+      finalOptions
+    );
     if (outputFormat === "json") {
-      const outputData = {
+      const outputData = formatStandardReport({
         results,
-        summary: { ...summary, executionTime: parseFloat(elapsedTime) },
-        ...patternScore && { scoring: patternScore }
-      };
-      const outputPath = resolveOutputPath2(
-        userOutputFile,
-        `aiready-report-${getReportTimestamp()}.json`,
-        resolvedDir
-      );
-      handleJSONOutput2(
+        summary,
+        elapsedTime,
+        score: patternScore
+      });
+      handleStandardJSONOutput({
         outputData,
-        outputPath,
-        `\u2705 Results saved to ${outputPath}`
-      );
+        outputFile: userOutputFile,
+        resolvedDir
+      });
     } else {
-      const terminalWidth = process.stdout.columns || 80;
-      const dividerWidth = Math.min(60, terminalWidth - 2);
-      const divider = "\u2501".repeat(dividerWidth);
-      console.log(chalk7.cyan(divider));
-      console.log(chalk7.bold.white("  PATTERN ANALYSIS SUMMARY"));
-      console.log(chalk7.cyan(divider) + "\n");
+      printTerminalHeader("PATTERN ANALYSIS SUMMARY");
       console.log(
-        chalk7.white(`\u{1F4C1} Files analyzed: ${chalk7.bold(results.length)}`)
+        chalk8.white(`\u{1F4C1} Files analyzed: ${chalk8.bold(results.length)}`)
       );
       console.log(
-        chalk7.yellow(
-          `\u26A0  Duplicate patterns found: ${chalk7.bold(summary.totalPatterns)}`
+        chalk8.yellow(
+          `\u26A0  Duplicate patterns found: ${chalk8.bold(summary.totalPatterns)}`
         )
       );
       console.log(
-        chalk7.red(
-          `\u{1F4B0} Token cost (wasted): ${chalk7.bold(summary.totalTokenCost.toLocaleString())}`
+        chalk8.red(
+          `\u{1F4B0} Token cost (wasted): ${chalk8.bold(summary.totalTokenCost.toLocaleString())}`
         )
       );
       console.log(
-        chalk7.gray(`\u23F1  Analysis time: ${chalk7.bold(elapsedTime + "s")}`)
+        chalk8.gray(`\u23F1  Analysis time: ${chalk8.bold(elapsedTime + "s")}`)
       );
       const sortedTypes = Object.entries(summary.patternsByType || {}).filter(([, count]) => count > 0).sort(([, a], [, b]) => b - a);
       if (sortedTypes.length > 0) {
-        console.log(chalk7.cyan("\n" + divider));
-        console.log(chalk7.bold.white("  PATTERNS BY TYPE"));
-        console.log(chalk7.cyan(divider) + "\n");
+        console.log("\n" + getTerminalDivider());
+        console.log(chalk8.bold.white("  PATTERNS BY TYPE"));
+        console.log(getTerminalDivider() + "\n");
         sortedTypes.forEach(([type, count]) => {
-          console.log(`  ${chalk7.white(type.padEnd(15))} ${chalk7.bold(count)}`);
+          console.log(`  ${chalk8.white(type.padEnd(15))} ${chalk8.bold(count)}`);
         });
       }
       if (summary.totalPatterns > 0 && duplicates.length > 0) {
-        console.log(chalk7.cyan("\n" + divider));
-        console.log(chalk7.bold.white("  TOP DUPLICATE PATTERNS"));
-        console.log(chalk7.cyan(divider) + "\n");
+        console.log("\n" + getTerminalDivider());
+        console.log(chalk8.bold.white("  TOP DUPLICATE PATTERNS"));
+        console.log(getTerminalDivider() + "\n");
         const topDuplicates = [...duplicates].sort((a, b) => b.similarity - a.similarity).slice(0, 10);
         topDuplicates.forEach((dup) => {
           const severity = dup.similarity > 0.95 ? "CRITICAL" : dup.similarity > 0.9 ? "HIGH" : "MEDIUM";
@@ -1087,25 +1136,25 @@ async function patternsAction(directory, options) {
           const file1Name = dup.file1.split("/").pop() || dup.file1;
           const file2Name = dup.file2.split("/").pop() || dup.file2;
           console.log(
-            `${severityIcon} ${severity}: ${chalk7.bold(file1Name)} \u2194 ${chalk7.bold(file2Name)}`
+            `${severityIcon} ${severity}: ${chalk8.bold(file1Name)} \u2194 ${chalk8.bold(file2Name)}`
           );
           console.log(
-            `   Similarity: ${chalk7.bold(Math.round(dup.similarity * 100) + "%")} | Wasted: ${chalk7.bold(dup.tokenCost.toLocaleString())} tokens each`
+            `   Similarity: ${chalk8.bold(Math.round(dup.similarity * 100) + "%")} | Wasted: ${chalk8.bold(dup.tokenCost.toLocaleString())} tokens each`
           );
           console.log(
-            `   Lines: ${chalk7.cyan(dup.line1 + "-" + dup.endLine1)} \u2194 ${chalk7.cyan(dup.line2 + "-" + dup.endLine2)}
+            `   Lines: ${chalk8.cyan(dup.line1 + "-" + dup.endLine1)} \u2194 ${chalk8.cyan(dup.line2 + "-" + dup.endLine2)}
 `
           );
         });
       } else {
         console.log(
-          chalk7.green("\n\u2728 Great! No duplicate patterns detected.\n")
+          chalk8.green("\n\u2728 Great! No duplicate patterns detected.\n")
         );
       }
       if (patternScore) {
-        console.log(chalk7.cyan(divider));
-        console.log(chalk7.bold.white("  AI READINESS SCORE (Patterns)"));
-        console.log(chalk7.cyan(divider) + "\n");
+        console.log(getTerminalDivider());
+        console.log(chalk8.bold.white("  AI READINESS SCORE (Patterns)"));
+        console.log(getTerminalDivider() + "\n");
         console.log(formatToolScore(patternScore));
         console.log();
       }
@@ -1122,20 +1171,19 @@ EXAMPLES:
 `;
 
 // src/commands/context.ts
-import chalk8 from "chalk";
-import { resolve as resolvePath5 } from "path";
+import chalk9 from "chalk";
 import {
-  loadMergedConfig as loadMergedConfig3,
-  handleJSONOutput as handleJSONOutput3,
   handleCLIError as handleCLIError4,
   getElapsedTime as getElapsedTime2,
-  resolveOutputPath as resolveOutputPath3,
-  formatToolScore as formatToolScore2
+  formatToolScore as formatToolScore2,
+  prepareActionConfig as prepareActionConfig2,
+  resolveOutputFormat as resolveOutputFormat2,
+  formatStandardReport as formatStandardReport2,
+  handleStandardJSONOutput as handleStandardJSONOutput2
 } from "@aiready/core";
 async function contextAction(directory, options) {
-  console.log(chalk8.blue("\u{1F9E0} Analyzing context costs...\n"));
+  console.log(chalk9.blue("\u{1F9E0} Analyzing context costs...\n"));
   const startTime = Date.now();
-  const resolvedDir = resolvePath5(process.cwd(), directory ?? ".");
   try {
     const defaults = {
       maxDepth: 5,
@@ -1147,7 +1195,7 @@ async function contextAction(directory, options) {
         file: void 0
       }
     };
-    const baseOptions = await loadMergedConfig3(resolvedDir, defaults, {
+    const { resolvedDir, finalOptions: baseOptions } = await prepareActionConfig2(directory, defaults, {
       maxDepth: options.maxDepth ? parseInt(options.maxDepth) : void 0,
       maxContextBudget: options.maxContext ? parseInt(options.maxContext) : void 0,
       include: options.include?.split(","),
@@ -1179,107 +1227,105 @@ async function contextAction(directory, options) {
     if (options.score) {
       contextScore = calculateContextScore(summary);
     }
-    const outputFormat = options.output ?? finalOptions.output?.format ?? "console";
-    const userOutputFile = options.outputFile ?? finalOptions.output?.file;
+    const { format: outputFormat, file: userOutputFile } = resolveOutputFormat2(
+      options,
+      finalOptions
+    );
     if (outputFormat === "json") {
-      const outputData = {
+      const outputData = formatStandardReport2({
         results,
-        summary: { ...summary, executionTime: parseFloat(elapsedTime) },
-        ...contextScore && { scoring: contextScore }
-      };
-      const outputPath = resolveOutputPath3(
-        userOutputFile,
-        `aiready-report-${getReportTimestamp()}.json`,
-        resolvedDir
-      );
-      handleJSONOutput3(
+        summary,
+        elapsedTime,
+        score: contextScore
+      });
+      handleStandardJSONOutput2({
         outputData,
-        outputPath,
-        `\u2705 Results saved to ${outputPath}`
-      );
+        outputFile: userOutputFile,
+        resolvedDir
+      });
     } else {
       const terminalWidth = process.stdout.columns ?? 80;
       const dividerWidth = Math.min(60, terminalWidth - 2);
       const divider = "\u2501".repeat(dividerWidth);
-      console.log(chalk8.cyan(divider));
-      console.log(chalk8.bold.white("  CONTEXT ANALYSIS SUMMARY"));
-      console.log(chalk8.cyan(divider) + "\n");
+      console.log(chalk9.cyan(divider));
+      console.log(chalk9.bold.white("  CONTEXT ANALYSIS SUMMARY"));
+      console.log(chalk9.cyan(divider) + "\n");
       console.log(
-        chalk8.white(`\u{1F4C1} Files analyzed: ${chalk8.bold(summary.totalFiles)}`)
+        chalk9.white(`\u{1F4C1} Files analyzed: ${chalk9.bold(summary.totalFiles)}`)
       );
       console.log(
-        chalk8.white(
-          `\u{1F4CA} Total tokens: ${chalk8.bold(summary.totalTokens.toLocaleString())}`
+        chalk9.white(
+          `\u{1F4CA} Total tokens: ${chalk9.bold(summary.totalTokens.toLocaleString())}`
         )
       );
       console.log(
-        chalk8.yellow(
-          `\u{1F4B0} Avg context budget: ${chalk8.bold(summary.avgContextBudget.toFixed(0))} tokens/file`
+        chalk9.yellow(
+          `\u{1F4B0} Avg context budget: ${chalk9.bold(summary.avgContextBudget.toFixed(0))} tokens/file`
         )
       );
       console.log(
-        chalk8.white(`\u23F1  Analysis time: ${chalk8.bold(elapsedTime + "s")}
+        chalk9.white(`\u23F1  Analysis time: ${chalk9.bold(elapsedTime + "s")}
 `)
       );
       const totalIssues = summary.criticalIssues + summary.majorIssues + summary.minorIssues;
       if (totalIssues > 0) {
-        console.log(chalk8.bold("\u26A0\uFE0F  Issues Found:\n"));
+        console.log(chalk9.bold("\u26A0\uFE0F  Issues Found:\n"));
         if (summary.criticalIssues > 0) {
           console.log(
-            chalk8.red(`   \u{1F534} Critical: ${chalk8.bold(summary.criticalIssues)}`)
+            chalk9.red(`   \u{1F534} Critical: ${chalk9.bold(summary.criticalIssues)}`)
           );
         }
         if (summary.majorIssues > 0) {
           console.log(
-            chalk8.yellow(`   \u{1F7E1} Major: ${chalk8.bold(summary.majorIssues)}`)
+            chalk9.yellow(`   \u{1F7E1} Major: ${chalk9.bold(summary.majorIssues)}`)
           );
         }
         if (summary.minorIssues > 0) {
           console.log(
-            chalk8.blue(`   \u{1F535} Minor: ${chalk8.bold(summary.minorIssues)}`)
+            chalk9.blue(`   \u{1F535} Minor: ${chalk9.bold(summary.minorIssues)}`)
           );
         }
         console.log(
-          chalk8.green(
+          chalk9.green(
             `
-   \u{1F4A1} Potential savings: ${chalk8.bold(summary.totalPotentialSavings.toLocaleString())} tokens
+   \u{1F4A1} Potential savings: ${chalk9.bold(summary.totalPotentialSavings.toLocaleString())} tokens
 `
           )
         );
       } else {
-        console.log(chalk8.green("\u2705 No significant issues found!\n"));
+        console.log(chalk9.green("\u2705 No significant issues found!\n"));
       }
       if (summary.deepFiles.length > 0) {
-        console.log(chalk8.bold("\u{1F4CF} Deep Import Chains:\n"));
+        console.log(chalk9.bold("\u{1F4CF} Deep Import Chains:\n"));
         console.log(
-          chalk8.gray(`   Average depth: ${summary.avgImportDepth.toFixed(1)}`)
+          chalk9.gray(`   Average depth: ${summary.avgImportDepth.toFixed(1)}`)
         );
         console.log(
-          chalk8.gray(`   Maximum depth: ${summary.maxImportDepth}
+          chalk9.gray(`   Maximum depth: ${summary.maxImportDepth}
 `)
         );
         summary.deepFiles.slice(0, 10).forEach((item) => {
           const fileName = item.file.split("/").slice(-2).join("/");
           console.log(
-            `   ${chalk8.cyan("\u2192")} ${chalk8.white(fileName)} ${chalk8.dim(`(depth: ${item.depth})`)}`
+            `   ${chalk9.cyan("\u2192")} ${chalk9.white(fileName)} ${chalk9.dim(`(depth: ${item.depth})`)}`
           );
         });
         console.log();
       }
       if (summary.fragmentedModules.length > 0) {
-        console.log(chalk8.bold("\u{1F9E9} Fragmented Modules:\n"));
+        console.log(chalk9.bold("\u{1F9E9} Fragmented Modules:\n"));
         console.log(
-          chalk8.gray(
+          chalk9.gray(
             `   Average fragmentation: ${(summary.avgFragmentation * 100).toFixed(0)}%
 `
           )
         );
         summary.fragmentedModules.slice(0, 10).forEach((module) => {
           console.log(
-            `   ${chalk8.yellow("\u25CF")} ${chalk8.white(module.domain)} - ${chalk8.dim(`${module.files.length} files, ${(module.fragmentationScore * 100).toFixed(0)}% scattered`)}`
+            `   ${chalk9.yellow("\u25CF")} ${chalk9.white(module.domain)} - ${chalk9.dim(`${module.files.length} files, ${(module.fragmentationScore * 100).toFixed(0)}% scattered`)}`
           );
           console.log(
-            chalk8.dim(
+            chalk9.dim(
               `     Token cost: ${module.totalTokens.toLocaleString()}, Cohesion: ${(module.avgCohesion * 100).toFixed(0)}%`
             )
           );
@@ -1287,9 +1333,9 @@ async function contextAction(directory, options) {
         console.log();
       }
       if (summary.lowCohesionFiles.length > 0) {
-        console.log(chalk8.bold("\u{1F500} Low Cohesion Files:\n"));
+        console.log(chalk9.bold("\u{1F500} Low Cohesion Files:\n"));
         console.log(
-          chalk8.gray(
+          chalk9.gray(
             `   Average cohesion: ${(summary.avgCohesion * 100).toFixed(0)}%
 `
           )
@@ -1297,28 +1343,28 @@ async function contextAction(directory, options) {
         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 ? chalk8.red : chalk8.yellow;
+          const color = item.score < 0.4 ? chalk9.red : chalk9.yellow;
           console.log(
-            `   ${color("\u25CB")} ${chalk8.white(fileName)} ${chalk8.dim(`(${scorePercent}% cohesion)`)}`
+            `   ${color("\u25CB")} ${chalk9.white(fileName)} ${chalk9.dim(`(${scorePercent}% cohesion)`)}`
           );
         });
         console.log();
       }
       if (summary.topExpensiveFiles.length > 0) {
-        console.log(chalk8.bold("\u{1F4B8} Most Expensive Files (Context Budget):\n"));
+        console.log(chalk9.bold("\u{1F4B8} Most Expensive Files (Context Budget):\n"));
         summary.topExpensiveFiles.slice(0, 10).forEach((item) => {
           const fileName = item.file.split("/").slice(-2).join("/");
-          const severityColor = item.severity === "critical" ? chalk8.red : item.severity === "major" ? chalk8.yellow : chalk8.blue;
+          const severityColor = item.severity === "critical" ? chalk9.red : item.severity === "major" ? chalk9.yellow : chalk9.blue;
           console.log(
-            `   ${severityColor("\u25CF")} ${chalk8.white(fileName)} ${chalk8.dim(`(${item.contextBudget.toLocaleString()} tokens)`)}`
+            `   ${severityColor("\u25CF")} ${chalk9.white(fileName)} ${chalk9.dim(`(${item.contextBudget.toLocaleString()} tokens)`)}`
           );
         });
         console.log();
       }
       if (contextScore) {
-        console.log(chalk8.cyan(divider));
-        console.log(chalk8.bold.white("  AI READINESS SCORE (Context)"));
-        console.log(chalk8.cyan(divider) + "\n");
+        console.log(chalk9.cyan(divider));
+        console.log(chalk9.bold.white("  AI READINESS SCORE (Context)"));
+        console.log(chalk9.cyan(divider) + "\n");
         console.log(formatToolScore2(contextScore));
         console.log();
       }
@@ -1329,21 +1375,21 @@ async function contextAction(directory, options) {
 }
 
 // src/commands/consistency.ts
-import chalk9 from "chalk";
+import chalk10 from "chalk";
 import { writeFileSync as writeFileSync3 } from "fs";
-import { resolve as resolvePath6 } from "path";
 import {
-  loadMergedConfig as loadMergedConfig4,
-  handleJSONOutput as handleJSONOutput4,
   handleCLIError as handleCLIError5,
   getElapsedTime as getElapsedTime3,
-  resolveOutputPath as resolveOutputPath4,
-  formatToolScore as formatToolScore3
+  resolveOutputPath as resolveOutputPath2,
+  formatToolScore as formatToolScore3,
+  prepareActionConfig as prepareActionConfig3,
+  resolveOutputFormat as resolveOutputFormat3,
+  formatStandardReport as formatStandardReport3,
+  handleStandardJSONOutput as handleStandardJSONOutput3
 } from "@aiready/core";
 async function consistencyAction(directory, options) {
-  console.log(chalk9.blue("\u{1F50D} Analyzing consistency...\n"));
+  console.log(chalk10.blue("\u{1F50D} Analyzing consistency...\n"));
   const startTime = Date.now();
-  const resolvedDir = resolvePath6(process.cwd(), directory ?? ".");
   try {
     const defaults = {
       checkNaming: true,
@@ -1356,13 +1402,17 @@ async function consistencyAction(directory, options) {
         file: void 0
       }
     };
-    const finalOptions = await loadMergedConfig4(resolvedDir, defaults, {
-      checkNaming: options.naming !== false,
-      checkPatterns: options.patterns !== false,
-      minSeverity: options.minSeverity,
-      include: options.include?.split(","),
-      exclude: options.exclude?.split(",")
-    });
+    const { resolvedDir, finalOptions } = await prepareActionConfig3(
+      directory,
+      defaults,
+      {
+        checkNaming: options.naming !== false,
+        checkPatterns: options.patterns !== false,
+        minSeverity: options.minSeverity,
+        include: options.include?.split(","),
+        exclude: options.exclude?.split(",")
+      }
+    );
     const { analyzeConsistency, calculateConsistencyScore } = await import("@aiready/consistency");
     const report = await analyzeConsistency(finalOptions);
     const elapsedTime = getElapsedTime3(startTime);
@@ -1374,52 +1424,47 @@ async function consistencyAction(directory, options) {
         report.summary.filesAnalyzed
       );
     }
-    const outputFormat = options.output ?? finalOptions.output?.format ?? "console";
-    const userOutputFile = options.outputFile ?? finalOptions.output?.file;
+    const { format: outputFormat, file: userOutputFile } = resolveOutputFormat3(
+      options,
+      finalOptions
+    );
     if (outputFormat === "json") {
-      const outputData = {
-        ...report,
-        summary: {
-          ...report.summary,
-          executionTime: parseFloat(elapsedTime)
-        },
-        ...consistencyScore && { scoring: consistencyScore }
-      };
-      const outputPath = resolveOutputPath4(
-        userOutputFile,
-        `aiready-report-${getReportTimestamp()}.json`,
-        resolvedDir
-      );
-      handleJSONOutput4(
+      const outputData = formatStandardReport3({
+        report,
+        summary: report.summary,
+        elapsedTime,
+        score: consistencyScore
+      });
+      handleStandardJSONOutput3({
         outputData,
-        outputPath,
-        `\u2705 Results saved to ${outputPath}`
-      );
+        outputFile: userOutputFile,
+        resolvedDir
+      });
     } else if (outputFormat === "markdown") {
       const markdown = generateMarkdownReport(report, elapsedTime);
-      const outputPath = resolveOutputPath4(
+      const outputPath = resolveOutputPath2(
         userOutputFile,
         `aiready-report-${getReportTimestamp()}.md`,
         resolvedDir
       );
       writeFileSync3(outputPath, markdown);
-      console.log(chalk9.green(`\u2705 Report saved to ${outputPath}`));
+      console.log(chalk10.green(`\u2705 Report saved to ${outputPath}`));
     } else {
-      console.log(chalk9.bold("\n\u{1F4CA} Summary\n"));
+      console.log(chalk10.bold("\n\u{1F4CA} Summary\n"));
       console.log(
-        `Files Analyzed: ${chalk9.cyan(report.summary.filesAnalyzed)}`
+        `Files Analyzed: ${chalk10.cyan(report.summary.filesAnalyzed)}`
       );
-      console.log(`Total Issues: ${chalk9.yellow(report.summary.totalIssues)}`);
-      console.log(`  Naming: ${chalk9.yellow(report.summary.namingIssues)}`);
-      console.log(`  Patterns: ${chalk9.yellow(report.summary.patternIssues)}`);
+      console.log(`Total Issues: ${chalk10.yellow(report.summary.totalIssues)}`);
+      console.log(`  Naming: ${chalk10.yellow(report.summary.namingIssues)}`);
+      console.log(`  Patterns: ${chalk10.yellow(report.summary.patternIssues)}`);
       console.log(
-        `  Architecture: ${chalk9.yellow(report.summary.architectureIssues ?? 0)}`
+        `  Architecture: ${chalk10.yellow(report.summary.architectureIssues ?? 0)}`
       );
-      console.log(`Analysis Time: ${chalk9.gray(elapsedTime + "s")}
+      console.log(`Analysis Time: ${chalk10.gray(elapsedTime + "s")}
 `);
       if (report.summary.totalIssues === 0) {
         console.log(
-          chalk9.green(
+          chalk10.green(
             "\u2728 No consistency issues found! Your codebase is well-maintained.\n"
           )
         );
@@ -1431,20 +1476,20 @@ async function consistencyAction(directory, options) {
           (r) => r.issues.some((i) => i.category === "patterns")
         );
         if (namingResults.length > 0) {
-          console.log(chalk9.bold("\u{1F3F7}\uFE0F  Naming Issues\n"));
+          console.log(chalk10.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" ? chalk9.red : issue.severity === "major" ? chalk9.yellow : issue.severity === "minor" ? chalk9.blue : chalk9.gray;
+              const severityColor = issue.severity === "critical" ? chalk10.red : issue.severity === "major" ? chalk10.yellow : issue.severity === "minor" ? chalk10.blue : chalk10.gray;
               console.log(
-                `${severityColor(issue.severity.toUpperCase())} ${chalk9.dim(`${issue.location.file}:${issue.location.line}`)}`
+                `${severityColor(issue.severity.toUpperCase())} ${chalk10.dim(`${issue.location.file}:${issue.location.line}`)}`
               );
               console.log(`  ${issue.message}`);
               if (issue.suggestion) {
                 console.log(
-                  `  ${chalk9.dim("\u2192")} ${chalk9.italic(issue.suggestion)}`
+                  `  ${chalk10.dim("\u2192")} ${chalk10.italic(issue.suggestion)}`
                 );
               }
               console.log();
@@ -1453,25 +1498,25 @@ async function consistencyAction(directory, options) {
           }
           const remaining = namingResults.reduce((sum, r) => sum + r.issues.length, 0) - shown;
           if (remaining > 0) {
-            console.log(chalk9.dim(`  ... and ${remaining} more issues
+            console.log(chalk10.dim(`  ... and ${remaining} more issues
 `));
           }
         }
         if (patternResults.length > 0) {
-          console.log(chalk9.bold("\u{1F504} Pattern Issues\n"));
+          console.log(chalk10.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" ? chalk9.red : issue.severity === "major" ? chalk9.yellow : issue.severity === "minor" ? chalk9.blue : chalk9.gray;
+              const severityColor = issue.severity === "critical" ? chalk10.red : issue.severity === "major" ? chalk10.yellow : issue.severity === "minor" ? chalk10.blue : chalk10.gray;
               console.log(
-                `${severityColor(issue.severity.toUpperCase())} ${chalk9.dim(`${issue.location.file}:${issue.location.line}`)}`
+                `${severityColor(issue.severity.toUpperCase())} ${chalk10.dim(`${issue.location.file}:${issue.location.line}`)}`
               );
               console.log(`  ${issue.message}`);
               if (issue.suggestion) {
                 console.log(
-                  `  ${chalk9.dim("\u2192")} ${chalk9.italic(issue.suggestion)}`
+                  `  ${chalk10.dim("\u2192")} ${chalk10.italic(issue.suggestion)}`
                 );
               }
               console.log();
@@ -1480,12 +1525,12 @@ async function consistencyAction(directory, options) {
           }
           const remaining = patternResults.reduce((sum, r) => sum + r.issues.length, 0) - shown;
           if (remaining > 0) {
-            console.log(chalk9.dim(`  ... and ${remaining} more issues
+            console.log(chalk10.dim(`  ... and ${remaining} more issues
 `));
           }
         }
         if (report.recommendations.length > 0) {
-          console.log(chalk9.bold("\u{1F4A1} Recommendations\n"));
+          console.log(chalk10.bold("\u{1F4A1} Recommendations\n"));
           report.recommendations.forEach((rec, i) => {
             console.log(`${i + 1}. ${rec}`);
           });
@@ -1493,7 +1538,7 @@ async function consistencyAction(directory, options) {
         }
       }
       if (consistencyScore) {
-        console.log(chalk9.bold("\n\u{1F4CA} AI Readiness Score (Consistency)\n"));
+        console.log(chalk10.bold("\n\u{1F4CA} AI Readiness Score (Consistency)\n"));
         console.log(formatToolScore3(consistencyScore));
         console.log();
       }
@@ -1504,27 +1549,27 @@ async function consistencyAction(directory, options) {
 }
 
 // src/commands/visualize.ts
-import chalk10 from "chalk";
+import chalk11 from "chalk";
 import { writeFileSync as writeFileSync4, readFileSync as readFileSync3, existsSync as existsSync3, copyFileSync } from "fs";
-import { resolve as resolvePath7 } from "path";
+import { resolve as resolvePath5 } from "path";
 import { spawn } from "child_process";
 import { handleCLIError as handleCLIError6 } from "@aiready/core";
 import { generateHTML, findLatestReport as findLatestReport2 } from "@aiready/core";
 async function visualizeAction(directory, options) {
   try {
-    const dirPath = resolvePath7(process.cwd(), directory ?? ".");
-    let reportPath = options.report ? resolvePath7(dirPath, options.report) : null;
+    const dirPath = resolvePath5(process.cwd(), directory ?? ".");
+    let reportPath = options.report ? resolvePath5(dirPath, options.report) : null;
     if (!reportPath || !existsSync3(reportPath)) {
       const latestScan = findLatestReport2(dirPath);
       if (latestScan) {
         reportPath = latestScan;
         console.log(
-          chalk10.dim(`Found latest report: ${latestScan.split("/").pop()}`)
+          chalk11.dim(`Found latest report: ${latestScan.split("/").pop()}`)
         );
       } else {
-        console.error(chalk10.red("\u274C No AI readiness report found"));
+        console.error(chalk11.red("\u274C No AI readiness report found"));
         console.log(
-          chalk10.dim(
+          chalk11.dim(
             `
 Generate a report with:
   aiready scan --output json
@@ -1538,7 +1583,7 @@ Or specify a custom report:
     }
     const raw = readFileSync3(reportPath, "utf8");
     const report = JSON.parse(raw);
-    const configPath = resolvePath7(dirPath, "aiready.json");
+    const configPath = resolvePath5(dirPath, "aiready.json");
     let graphConfig = { maxNodes: 400, maxEdges: 600 };
     if (existsSync3(configPath)) {
       try {
@@ -1562,7 +1607,7 @@ Or specify a custom report:
     let devServerStarted = false;
     if (useDevMode) {
       try {
-        const localWebDir = resolvePath7(dirPath, "packages/visualizer");
+        const localWebDir = resolvePath5(dirPath, "packages/visualizer");
         let webDir = "";
         let visualizerAvailable = false;
         if (existsSync3(localWebDir)) {
@@ -1570,8 +1615,8 @@ Or specify a custom report:
           visualizerAvailable = true;
         } else {
           const nodemodulesLocations = [
-            resolvePath7(dirPath, "node_modules", "@aiready", "visualizer"),
-            resolvePath7(
+            resolvePath5(dirPath, "node_modules", "@aiready", "visualizer"),
+            resolvePath5(
               process.cwd(),
               "node_modules",
               "@aiready",
@@ -1581,14 +1626,14 @@ Or specify a custom report:
           let currentDir = dirPath;
           while (currentDir !== "/" && currentDir !== ".") {
             nodemodulesLocations.push(
-              resolvePath7(currentDir, "node_modules", "@aiready", "visualizer")
+              resolvePath5(currentDir, "node_modules", "@aiready", "visualizer")
             );
-            const parent = resolvePath7(currentDir, "..");
+            const parent = resolvePath5(currentDir, "..");
             if (parent === currentDir) break;
             currentDir = parent;
           }
           for (const location of nodemodulesLocations) {
-            if (existsSync3(location) && existsSync3(resolvePath7(location, "package.json"))) {
+            if (existsSync3(location) && existsSync3(resolvePath5(location, "package.json"))) {
               webDir = location;
               visualizerAvailable = true;
               break;
@@ -1597,20 +1642,20 @@ Or specify a custom report:
           if (!visualizerAvailable) {
             try {
               const vizPkgPath = __require.resolve("@aiready/visualizer/package.json");
-              webDir = resolvePath7(vizPkgPath, "..");
+              webDir = resolvePath5(vizPkgPath, "..");
               visualizerAvailable = true;
             } catch (err) {
               void err;
             }
           }
         }
-        const webViteConfigExists = webDir && existsSync3(resolvePath7(webDir, "web", "vite.config.ts"));
+        const webViteConfigExists = webDir && existsSync3(resolvePath5(webDir, "web", "vite.config.ts"));
         if (visualizerAvailable && webViteConfigExists) {
           const spawnCwd = webDir;
           const { watch } = await import("fs");
           const copyReportToViz = () => {
             try {
-              const destPath = resolvePath7(spawnCwd, "web", "report-data.json");
+              const destPath = resolvePath5(spawnCwd, "web", "report-data.json");
               copyFileSync(reportPath, destPath);
               console.log(`\u{1F4CB} Report synced to ${destPath}`);
             } catch (e) {
@@ -1654,19 +1699,19 @@ Or specify a custom report:
           return;
         } else {
           console.log(
-            chalk10.yellow(
+            chalk11.yellow(
               "\u26A0\uFE0F  Dev server not available (requires local @aiready/visualizer with web assets)."
             )
           );
           console.log(
-            chalk10.cyan("   Falling back to static HTML generation...\n")
+            chalk11.cyan("   Falling back to static HTML generation...\n")
           );
           useDevMode = false;
         }
       } catch (err) {
         console.error("Failed to start dev server:", err);
         console.log(
-          chalk10.cyan("   Falling back to static HTML generation...\n")
+          chalk11.cyan("   Falling back to static HTML generation...\n")
         );
         useDevMode = false;
       }
@@ -1674,9 +1719,9 @@ Or specify a custom report:
     console.log("Generating HTML...");
     const html = generateHTML(graph);
     const defaultOutput = "visualization.html";
-    const outPath = resolvePath7(dirPath, options.output ?? defaultOutput);
+    const outPath = resolvePath5(dirPath, options.output ?? defaultOutput);
     writeFileSync4(outPath, html, "utf8");
-    console.log(chalk10.green(`\u2705 Visualization written to: ${outPath}`));
+    console.log(chalk11.green(`\u2705 Visualization written to: ${outPath}`));
     if (options.open || options.serve) {
       const opener = process.platform === "darwin" ? "open" : process.platform === "win32" ? "start" : "xdg-open";
       if (options.serve) {
@@ -1706,7 +1751,7 @@ Or specify a custom report:
           server.listen(port, () => {
             const addr = `http://localhost:${port}/`;
             console.log(
-              chalk10.cyan(`\u{1F310} Local visualization server running at ${addr}`)
+              chalk11.cyan(`\u{1F310} Local visualization server running at ${addr}`)
             );
             spawn(opener, [`"${addr}"`], { shell: true });
           });
@@ -1753,14 +1798,14 @@ NOTES:
 `;
 
 // src/commands/shared/standard-tool-actions.ts
-import chalk11 from "chalk";
+import chalk12 from "chalk";
 
 // src/commands/agent-grounding.ts
-import chalk12 from "chalk";
+import chalk13 from "chalk";
 import { loadConfig as loadConfig2, mergeConfigWithDefaults as mergeConfigWithDefaults2 } from "@aiready/core";
 
 // src/commands/testability.ts
-import chalk13 from "chalk";
+import chalk14 from "chalk";
 import { loadConfig as loadConfig3, mergeConfigWithDefaults as mergeConfigWithDefaults3 } from "@aiready/core";
 async function testabilityAction(directory, options) {
   const { analyzeTestability, calculateTestabilityScore } = await import("@aiready/testability");
@@ -1785,28 +1830,28 @@ async function testabilityAction(directory, options) {
     "blind-risk": "\u{1F480}"
   };
   const safetyColors = {
-    safe: chalk13.green,
-    "moderate-risk": chalk13.yellow,
-    "high-risk": chalk13.red,
-    "blind-risk": chalk13.bgRed.white
+    safe: chalk14.green,
+    "moderate-risk": chalk14.yellow,
+    "high-risk": chalk14.red,
+    "blind-risk": chalk14.bgRed.white
   };
   const safety = report.summary.aiChangeSafetyRating;
   const icon = safetyIcons[safety] ?? "\u2753";
-  const color = safetyColors[safety] ?? chalk13.white;
+  const color = safetyColors[safety] ?? chalk14.white;
   console.log(
-    `  \u{1F9EA} Testability:         ${chalk13.bold(scoring.score + "/100")} (${report.summary.rating})`
+    `  \u{1F9EA} Testability:         ${chalk14.bold(scoring.score + "/100")} (${report.summary.rating})`
   );
   console.log(
     `     AI Change Safety:  ${color(`${icon} ${safety.toUpperCase()}`)}`
   );
   console.log(
-    chalk13.dim(
+    chalk14.dim(
       `     Coverage: ${Math.round(report.summary.coverageRatio * 100)}%  (${report.rawData.testFiles} test / ${report.rawData.sourceFiles} source files)`
     )
   );
   if (safety === "blind-risk") {
     console.log(
-      chalk13.red.bold(
+      chalk14.red.bold(
         "\n     \u26A0\uFE0F  NO TESTS \u2014 AI changes to this codebase are completely unverifiable!\n"
       )
     );
@@ -1818,7 +1863,7 @@ async function testabilityAction(directory, options) {
 import { changeAmplificationAction } from "@aiready/change-amplification/dist/cli.js";
 
 // src/commands/bug.ts
-import chalk14 from "chalk";
+import chalk15 from "chalk";
 import { execSync } from "child_process";
 async function bugAction(message, options) {
   const repoUrl = "https://github.com/caopengau/aiready-cli";
@@ -1836,35 +1881,35 @@ Generated via AIReady CLI 'bug' command.
 Type: ${type}
     `.trim();
     if (options.submit) {
-      console.log(chalk14.blue("\u{1F680} Submitting issue via GitHub CLI...\n"));
+      console.log(chalk15.blue("\u{1F680} Submitting issue via GitHub CLI...\n"));
       try {
         execSync("gh auth status", { stdio: "ignore" });
         const command = `gh issue create --repo ${repoSlug} --title ${JSON.stringify(title)} --body ${JSON.stringify(body)} --label ${label}`;
         const output = execSync(command, { encoding: "utf8" }).trim();
-        console.log(chalk14.green("\u2705 Issue Created Successfully!"));
-        console.log(chalk14.cyan(output));
+        console.log(chalk15.green("\u2705 Issue Created Successfully!"));
+        console.log(chalk15.cyan(output));
         return;
       } catch {
-        console.error(chalk14.red("\n\u274C Failed to submit via gh CLI."));
+        console.error(chalk15.red("\n\u274C Failed to submit via gh CLI."));
         console.log(
-          chalk14.yellow(
+          chalk15.yellow(
             '   Make sure gh is installed and run "gh auth login".\n'
           )
         );
-        console.log(chalk14.dim("   Falling back to URL generation..."));
+        console.log(chalk15.dim("   Falling back to URL generation..."));
       }
     }
     const template = type === "bug" ? "bug_report.md" : type === "feature" ? "feature_request.md" : "new_metric_idea.md";
     const fullUrl = `${repoUrl}/issues/new?title=${encodeURIComponent(title)}&body=${encodeURIComponent(body)}&labels=${label}&template=${template}`;
-    console.log(chalk14.green("\u{1F680} Issue Draft Prepared!\n"));
-    console.log(chalk14.bold("Title:  ") + title);
-    console.log(chalk14.bold("Type:   ") + type);
-    console.log(chalk14.bold("\nClick the link below to submit this issue:"));
-    console.log(chalk14.cyan(fullUrl));
-    console.log(chalk14.bold("\n\u{1F916} [FOR AI AGENTS]:"));
-    console.log(chalk14.dim("   You have successfully prepared a report."));
+    console.log(chalk15.green("\u{1F680} Issue Draft Prepared!\n"));
+    console.log(chalk15.bold("Title:  ") + title);
+    console.log(chalk15.bold("Type:   ") + type);
+    console.log(chalk15.bold("\nClick the link below to submit this issue:"));
+    console.log(chalk15.cyan(fullUrl));
+    console.log(chalk15.bold("\n\u{1F916} [FOR AI AGENTS]:"));
+    console.log(chalk15.dim("   You have successfully prepared a report."));
     console.log(
-      chalk14.dim(
+      chalk15.dim(
         "   Please present the URL above to the user so they can finalize the submission."
       )
     );
@@ -1873,14 +1918,14 @@ Type: ${type}
   const bugUrl = `${repoUrl}/issues/new?template=bug_report.md`;
   const featureUrl = `${repoUrl}/issues/new?template=feature_request.md`;
   const metricUrl = `${repoUrl}/issues/new?template=new_metric_idea.md`;
-  console.log(chalk14.blue("\u{1F4AC} Feedback & Bug Reports\n"));
-  console.log(`  Report a Bug:        ${chalk14.cyan(bugUrl)}`);
-  console.log(`  Request a Feature:   ${chalk14.cyan(featureUrl)}`);
-  console.log(`  Suggest a Metric:    ${chalk14.cyan(metricUrl)}`);
-  console.log(chalk14.bold("\n\u{1F916} [FOR AI AGENTS]:"));
-  console.log(chalk14.dim("   To prepare a specific report, run:"));
+  console.log(chalk15.blue("\u{1F4AC} Feedback & Bug Reports\n"));
+  console.log(`  Report a Bug:        ${chalk15.cyan(bugUrl)}`);
+  console.log(`  Request a Feature:   ${chalk15.cyan(featureUrl)}`);
+  console.log(`  Suggest a Metric:    ${chalk15.cyan(metricUrl)}`);
+  console.log(chalk15.bold("\n\u{1F916} [FOR AI AGENTS]:"));
+  console.log(chalk15.dim("   To prepare a specific report, run:"));
   console.log(
-    chalk14.cyan(
+    chalk15.cyan(
       '   aiready bug "your description here" --type bug|feature|metric'
     )
   );
@@ -1954,7 +1999,7 @@ program.command("scan").description(
 ).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)", true).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(
+).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(
@@ -1980,7 +2025,7 @@ program.command("patterns").description("Detect duplicate code patterns that con
 ).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)", true).option("--no-score", "Disable calculating AI Readiness Score").addHelpText("after", PATTERNS_HELP_TEXT).action(async (directory, options) => {
+).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(