@aiready/cli 0.14.22 → 0.14.24

package/dist/cli.js

@@ -25,286 +25,24 @@ var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__ge
 
 // src/cli.ts
 var import_commander = require("commander");
-var import_fs7 = require("fs");
-var import_path9 = require("path");
+var import_fs8 = require("fs");
+var import_path7 = require("path");
 var import_url = require("url");
 
 // src/commands/scan.ts
-var import_chalk5 = __toESM(require("chalk"));
-var import_fs3 = require("fs");
-var import_path3 = require("path");
-var import_core7 = require("@aiready/core");
+var import_chalk6 = __toESM(require("chalk"));
+var import_fs4 = require("fs");
+var import_path4 = require("path");
+var import_core9 = require("@aiready/core");
 
-// src/index.ts
-var import_core = require("@aiready/core");
-var import_pattern_detect = require("@aiready/pattern-detect");
-var import_context_analyzer = require("@aiready/context-analyzer");
-var import_consistency = require("@aiready/consistency");
-var import_ai_signal_clarity = require("@aiready/ai-signal-clarity");
-var import_agent_grounding = require("@aiready/agent-grounding");
-var import_testability = require("@aiready/testability");
-var import_doc_drift = require("@aiready/doc-drift");
-var import_deps = require("@aiready/deps");
-var import_change_amplification = require("@aiready/change-amplification");
-var TOOL_PACKAGE_MAP = {
-  [import_core.ToolName.PatternDetect]: "@aiready/pattern-detect",
-  [import_core.ToolName.ContextAnalyzer]: "@aiready/context-analyzer",
-  [import_core.ToolName.NamingConsistency]: "@aiready/consistency",
-  [import_core.ToolName.AiSignalClarity]: "@aiready/ai-signal-clarity",
-  [import_core.ToolName.AgentGrounding]: "@aiready/agent-grounding",
-  [import_core.ToolName.TestabilityIndex]: "@aiready/testability",
-  [import_core.ToolName.DocDrift]: "@aiready/doc-drift",
-  [import_core.ToolName.DependencyHealth]: "@aiready/deps",
-  [import_core.ToolName.ChangeAmplification]: "@aiready/change-amplification",
-  // Aliases handled by registry
-  patterns: "@aiready/pattern-detect",
-  duplicates: "@aiready/pattern-detect",
-  context: "@aiready/context-analyzer",
-  fragmentation: "@aiready/context-analyzer",
-  consistency: "@aiready/consistency",
-  "ai-signal": "@aiready/ai-signal-clarity",
-  grounding: "@aiready/agent-grounding",
-  testability: "@aiready/testability",
-  "deps-health": "@aiready/deps",
-  "change-amp": "@aiready/change-amplification"
-};
-function sanitizeConfigRecursive(obj) {
-  if (!obj || typeof obj !== "object" || Array.isArray(obj)) return obj;
-  const sanitized = {};
-  const infraToStrip = [
-    "rootDir",
-    "onProgress",
-    "progressCallback",
-    "streamResults",
-    "batchSize",
-    "useSmartDefaults"
-  ];
-  for (const [key, value] of Object.entries(obj)) {
-    if (infraToStrip.includes(key)) continue;
-    if (typeof value === "object" && value !== null && !Array.isArray(value)) {
-      sanitized[key] = sanitizeConfigRecursive(value);
-    } else {
-      sanitized[key] = value;
-    }
-  }
-  return sanitized;
-}
-function sanitizeToolConfig(config) {
-  return sanitizeConfigRecursive(config);
-}
-async function analyzeUnified(options) {
-  await (0, import_core.initializeParsers)();
-  const startTime = Date.now();
-  const requestedTools = options.tools ?? [
-    "patterns",
-    "context",
-    "consistency"
-  ];
-  const result = {
-    summary: {
-      totalIssues: 0,
-      criticalIssues: 0,
-      // Added as per instruction
-      majorIssues: 0,
-      // Added as per instruction
-      totalFiles: 0,
-      toolsRun: [],
-      executionTime: 0,
-      config: options,
-      toolConfigs: {}
-    }
-  };
-  for (const toolName of requestedTools) {
-    let provider = import_core.ToolRegistry.find(toolName);
-    if (!provider) {
-      const packageName = TOOL_PACKAGE_MAP[toolName] ?? (toolName.startsWith("@aiready/") ? toolName : `@aiready/${toolName}`);
-      try {
-        await import(packageName);
-        provider = import_core.ToolRegistry.find(toolName);
-        if (provider) {
-          console.log(
-            `\u2705 Successfully loaded tool provider: ${toolName} from ${packageName}`
-          );
-        } else {
-          console.log(
-            `\u26A0\uFE0F Loaded ${packageName} but provider ${toolName} still not found in registry.`
-          );
-        }
-      } catch (err) {
-        console.log(
-          `\u274C Failed to dynamically load tool ${toolName} (${packageName}):`,
-          err.message
-        );
-      }
-    }
-    if (!provider) {
-      console.warn(
-        `\u26A0\uFE0F  Warning: Tool provider for '${toolName}' not found. Skipping.`
-      );
-      continue;
-    }
-    try {
-      const sanitizedOptions = { ...options };
-      delete sanitizedOptions.onProgress;
-      delete sanitizedOptions.progressCallback;
-      const toolOptions = {
-        rootDir: options.rootDir
-        // Always include rootDir
-      };
-      [...import_core.GLOBAL_INFRA_OPTIONS, ...import_core.COMMON_FINE_TUNING_OPTIONS].forEach(
-        (key) => {
-          if (key in options && key !== "toolConfigs" && key !== "tools") {
-            toolOptions[key] = options[key];
-          }
-        }
-      );
-      if (options.toolConfigs?.[provider.id]) {
-        Object.assign(toolOptions, options.toolConfigs[provider.id]);
-      } else if (options.tools && !Array.isArray(options.tools) && typeof options.tools === "object" && options.tools[provider.id]) {
-        Object.assign(toolOptions, options.tools[provider.id]);
-      } else if (options[provider.id]) {
-        Object.assign(toolOptions, options[provider.id]);
-      }
-      toolOptions.onProgress = (processed, total, message) => {
-        if (options.progressCallback) {
-          options.progressCallback({
-            tool: provider.id,
-            processed,
-            total,
-            message
-          });
-        }
-      };
-      const output = await provider.analyze(toolOptions);
-      if (output.metadata) {
-        output.metadata.config = sanitizeToolConfig(toolOptions);
-      }
-      if (options.progressCallback) {
-        options.progressCallback({ tool: provider.id, data: output });
-      }
-      result[provider.id] = output;
-      result.summary.toolsRun.push(provider.id);
-      if (output.summary?.config) {
-        result.summary.toolConfigs[provider.id] = sanitizeToolConfig(
-          output.summary.config
-        );
-      } else if (output.metadata?.config) {
-        result.summary.toolConfigs[provider.id] = sanitizeToolConfig(
-          output.metadata.config
-        );
-      } else {
-        result.summary.toolConfigs[provider.id] = sanitizeToolConfig(toolOptions);
-      }
-      const toolFiles = output.summary?.totalFiles ?? output.summary?.filesAnalyzed ?? 0;
-      if (toolFiles > result.summary.totalFiles) {
-        result.summary.totalFiles = toolFiles;
-      }
-      const issueCount = output.results.reduce(
-        (sum, file) => sum + (file.issues?.length ?? 0),
-        0
-      );
-      result.summary.totalIssues += issueCount;
-    } catch (err) {
-      console.error(`\u274C Error running tool '${provider.id}':`, err);
-    }
-  }
-  result.summary.config = sanitizeConfigRecursive({
-    scan: {
-      tools: requestedTools,
-      include: options.include,
-      exclude: options.exclude
-    },
-    // Use 'tools' for tool-specific configurations to match AIReadyConfig
-    tools: result.summary.toolConfigs
-  });
-  result.summary.executionTime = Date.now() - startTime;
-  const keyMappings = {
-    "pattern-detect": ["patternDetect", "patterns"],
-    "context-analyzer": ["contextAnalyzer", "context"],
-    "naming-consistency": ["namingConsistency", "consistency"],
-    "ai-signal-clarity": ["aiSignalClarity"],
-    "agent-grounding": ["agentGrounding"],
-    "testability-index": ["testabilityIndex", "testability"],
-    "doc-drift": ["docDrift"],
-    "dependency-health": ["dependencyHealth", "deps"],
-    "change-amplification": ["changeAmplification"]
-  };
-  for (const [kebabKey, aliases] of Object.entries(keyMappings)) {
-    if (result[kebabKey]) {
-      for (const alias of aliases) {
-        result[alias] = result[kebabKey];
-      }
-    }
-  }
-  return result;
-}
-async function scoreUnified(results, options) {
-  const toolScores = /* @__PURE__ */ new Map();
-  for (const toolId of results.summary.toolsRun) {
-    const provider = import_core.ToolRegistry.get(toolId);
-    if (!provider) continue;
-    const output = results[toolId];
-    if (!output) continue;
-    try {
-      const toolScore = provider.score(output, options);
-      if (!toolScore.tokenBudget) {
-        if (toolId === import_core.ToolName.PatternDetect && output.duplicates) {
-          const wastedTokens = output.duplicates.reduce(
-            (sum, d) => sum + (d.tokenCost ?? 0),
-            0
-          );
-          toolScore.tokenBudget = (0, import_core.calculateTokenBudget)({
-            totalContextTokens: wastedTokens * 2,
-            wastedTokens: {
-              duplication: wastedTokens,
-              fragmentation: 0,
-              chattiness: 0
-            }
-          });
-        } else if (toolId === import_core.ToolName.ContextAnalyzer && output.summary) {
-          toolScore.tokenBudget = (0, import_core.calculateTokenBudget)({
-            totalContextTokens: output.summary.totalTokens,
-            wastedTokens: {
-              duplication: 0,
-              fragmentation: output.summary.totalPotentialSavings ?? 0,
-              chattiness: 0
-            }
-          });
-        }
-      }
-      toolScores.set(toolId, toolScore);
-    } catch (err) {
-      console.error(`\u274C Error scoring tool '${toolId}':`, err);
-    }
-  }
-  if (toolScores.size === 0) {
-    return {
-      overall: 0,
-      rating: "Critical",
-      timestamp: (/* @__PURE__ */ new Date()).toISOString(),
-      toolsUsed: [],
-      breakdown: [],
-      calculation: {
-        formula: "0 / 0 = 0",
-        weights: {},
-        normalized: "0 / 0 = 0"
-      }
-    };
-  }
-  return (0, import_core.calculateOverallScore)(toolScores, options, void 0);
-}
+// src/utils/index.ts
+var import_core2 = require("@aiready/core");
 
 // src/utils/helpers.ts
 var import_path = require("path");
 var import_fs = require("fs");
 var import_chalk = __toESM(require("chalk"));
-var import_core2 = require("@aiready/core");
-var import_core3 = require("@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())}`;
-}
+var import_core = require("@aiready/core");
 async function warnIfGraphCapExceeded(report, dirPath) {
   try {
     const { loadConfig: loadConfig4 } = await import("@aiready/core");
@@ -393,7 +131,7 @@ function generateMarkdownReport(report, elapsedTime) {
 
 // src/commands/report-formatter.ts
 var import_chalk2 = __toESM(require("chalk"));
-var import_core4 = require("@aiready/core");
+var import_core3 = require("@aiready/core");
 function generateProgressBar(score, width = 20) {
   const filled = Math.round(score / 100 * width);
   const empty = width - filled;
@@ -498,31 +236,34 @@ function printBusinessImpact(roi, unifiedBudget) {
 }
 function printScoring(scoringResult, scoringProfile) {
   console.log(import_chalk2.default.bold("\n\u{1F4CA} AI Readiness Overall Score"));
-  console.log(`  ${(0, import_core4.formatScore)(scoringResult)}`);
+  console.log(`  ${(0, import_core3.formatScore)(scoringResult)}`);
   console.log(import_chalk2.default.dim(`  (Scoring Profile: ${scoringProfile})`));
   if (scoringResult.breakdown) {
     console.log(import_chalk2.default.bold("\nTool breakdown:"));
     scoringResult.breakdown.forEach((tool) => {
-      const rating = (0, import_core4.getRating)(tool.score);
-      const emoji = (0, import_core4.getRatingDisplay)(rating).emoji;
+      const rating = (0, import_core3.getRating)(tool.score);
+      const emoji = (0, import_core3.getRatingDisplay)(rating).emoji;
       const progressBar = generateProgressBar(tool.score, 15);
       console.log(
         `  ${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(import_chalk2.default.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} ${import_chalk2.default.bold(rec.action)}`);
-        console.log(
-          `     Impact: ${import_chalk2.default.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(import_chalk2.default.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} ${import_chalk2.default.bold(rec.action)}`);
+      console.log(
+        `     Impact: ${import_chalk2.default.green(`+${rec.estimatedImpact} points`)} to ${rec.tool}`
+      );
+    });
   }
 }
 function mapToUnifiedReport(res, scoring) {
@@ -537,9 +278,9 @@ function mapToUnifiedReport(res, scoring) {
       totalFilesSet.add(r.fileName);
       allResults.push(r);
       r.issues?.forEach((i) => {
-        if (i.severity === import_core4.Severity.Critical || i.severity === "critical")
+        if (i.severity === import_core3.Severity.Critical || i.severity === "critical")
           criticalCount++;
-        if (i.severity === import_core4.Severity.Major || i.severity === "major")
+        if (i.severity === import_core3.Severity.Major || i.severity === "major")
           majorCount++;
       });
     });
@@ -561,7 +302,7 @@ function mapToUnifiedReport(res, scoring) {
 var import_fs2 = __toESM(require("fs"));
 var import_path2 = require("path");
 var import_chalk3 = __toESM(require("chalk"));
-var import_core5 = require("@aiready/core");
+var import_core4 = require("@aiready/core");
 async function uploadAction(file, options) {
   const startTime = Date.now();
   const filePath = (0, import_path2.resolve)(process.cwd(), file);
@@ -648,265 +389,551 @@ async function uploadAction(file, options) {
       console.log(import_chalk3.default.dim(`   Score: ${uploadResult.analysis.aiScore}/100`));
     }
   } catch (error) {
-    (0, import_core5.handleCLIError)(error, "Upload");
+    (0, import_core4.handleCLIError)(error, "Upload");
+  }
+}
+var UPLOAD_HELP_TEXT = `
+EXAMPLES:
+  $ aiready upload report.json --api-key ar_...
+  $ aiready upload .aiready/latest.json
+  $ AIREADY_API_KEY=ar_... aiready upload report.json
+
+ENVIRONMENT VARIABLES:
+  AIREADY_API_KEY    Your platform API key
+  AIREADY_SERVER     Custom platform URL (default: https://dev.platform.getaiready.dev)
+`;
+
+// src/commands/scan-config.ts
+var import_core6 = require("@aiready/core");
+
+// src/commands/scan-helpers.ts
+var import_chalk4 = __toESM(require("chalk"));
+var import_core5 = require("@aiready/core");
+function getProfileTools(profile) {
+  switch (profile.toLowerCase()) {
+    case "agentic":
+      return [
+        import_core5.ToolName.AiSignalClarity,
+        import_core5.ToolName.AgentGrounding,
+        import_core5.ToolName.TestabilityIndex
+      ];
+    case "cost":
+      return [import_core5.ToolName.PatternDetect, import_core5.ToolName.ContextAnalyzer];
+    case "logic":
+      return [
+        import_core5.ToolName.TestabilityIndex,
+        import_core5.ToolName.NamingConsistency,
+        import_core5.ToolName.ContextAnalyzer,
+        import_core5.ToolName.PatternDetect,
+        import_core5.ToolName.ChangeAmplification
+      ];
+    case "ui":
+      return [
+        import_core5.ToolName.NamingConsistency,
+        import_core5.ToolName.ContextAnalyzer,
+        import_core5.ToolName.PatternDetect,
+        import_core5.ToolName.DocDrift,
+        import_core5.ToolName.AiSignalClarity
+      ];
+    case "security":
+      return [import_core5.ToolName.NamingConsistency, import_core5.ToolName.TestabilityIndex];
+    case "onboarding":
+      return [
+        import_core5.ToolName.ContextAnalyzer,
+        import_core5.ToolName.NamingConsistency,
+        import_core5.ToolName.AgentGrounding
+      ];
+    default:
+      console.log(
+        import_chalk4.default.yellow(`
+\u26A0\uFE0F  Unknown profile '${profile}'. Using defaults.`)
+      );
+      return void 0;
+  }
+}
+function createProgressCallback() {
+  return (event) => {
+    if (event.message) {
+      process.stdout.write(`\r\x1B[K   [${event.tool}] ${event.message}`);
+      return;
+    }
+    process.stdout.write("\r\x1B[K");
+    console.log(import_chalk4.default.cyan(`--- ${event.tool.toUpperCase()} RESULTS ---`));
+    const toolResult = event.data;
+    if (toolResult && toolResult.summary) {
+      if (toolResult.summary.totalIssues !== void 0)
+        console.log(
+          `  Issues found: ${import_chalk4.default.bold(toolResult.summary.totalIssues)}`
+        );
+      if (toolResult.summary.score !== void 0)
+        console.log(
+          `  Tool Score: ${import_chalk4.default.bold(toolResult.summary.score)}/100`
+        );
+      if (toolResult.summary.totalFiles !== void 0)
+        console.log(
+          `  Files analyzed: ${import_chalk4.default.bold(toolResult.summary.totalFiles)}`
+        );
+    }
+  };
+}
+
+// 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 (0, import_core6.loadMergedConfig)(
+    resolvedDir,
+    SCAN_DEFAULTS,
+    cliOverrides
+  );
+  const finalOptions = { ...baseOptions };
+  if (baseOptions.tools.includes(import_core6.ToolName.PatternDetect) || baseOptions.tools.includes("patterns")) {
+    const { getSmartDefaults } = await import("@aiready/pattern-detect");
+    const patternSmartDefaults = await getSmartDefaults(
+      resolvedDir,
+      finalOptions.toolConfigs?.[import_core6.ToolName.PatternDetect] ?? {}
+    );
+    if (!finalOptions.toolConfigs) finalOptions.toolConfigs = {};
+    finalOptions.toolConfigs[import_core6.ToolName.PatternDetect] = {
+      ...patternSmartDefaults,
+      ...finalOptions.toolConfigs[import_core6.ToolName.PatternDetect]
+    };
+  }
+  return finalOptions;
+}
+
+// src/commands/scan-orchestrator.ts
+var import_chalk5 = __toESM(require("chalk"));
+var import_fs3 = require("fs");
+var import_path3 = require("path");
+var import_core8 = require("@aiready/core");
+
+// src/index.ts
+var import_core7 = require("@aiready/core");
+var TOOL_PACKAGE_MAP = {
+  [import_core7.ToolName.PatternDetect]: "@aiready/pattern-detect",
+  [import_core7.ToolName.ContextAnalyzer]: "@aiready/context-analyzer",
+  [import_core7.ToolName.NamingConsistency]: "@aiready/consistency",
+  [import_core7.ToolName.AiSignalClarity]: "@aiready/ai-signal-clarity",
+  [import_core7.ToolName.AgentGrounding]: "@aiready/agent-grounding",
+  [import_core7.ToolName.TestabilityIndex]: "@aiready/testability",
+  [import_core7.ToolName.DocDrift]: "@aiready/doc-drift",
+  [import_core7.ToolName.DependencyHealth]: "@aiready/deps",
+  [import_core7.ToolName.ChangeAmplification]: "@aiready/change-amplification",
+  // Aliases handled by registry
+  patterns: "@aiready/pattern-detect",
+  duplicates: "@aiready/pattern-detect",
+  context: "@aiready/context-analyzer",
+  fragmentation: "@aiready/context-analyzer",
+  consistency: "@aiready/consistency",
+  "ai-signal": "@aiready/ai-signal-clarity",
+  grounding: "@aiready/agent-grounding",
+  testability: "@aiready/testability",
+  "deps-health": "@aiready/deps",
+  "change-amp": "@aiready/change-amplification"
+};
+function sanitizeConfigRecursive(obj) {
+  if (!obj || typeof obj !== "object" || Array.isArray(obj)) return obj;
+  const sanitized = {};
+  const infraToStrip = [
+    "rootDir",
+    "onProgress",
+    "progressCallback",
+    "streamResults",
+    "batchSize",
+    "useSmartDefaults"
+  ];
+  for (const [key, value] of Object.entries(obj)) {
+    if (infraToStrip.includes(key)) continue;
+    if (typeof value === "object" && value !== null && !Array.isArray(value)) {
+      sanitized[key] = sanitizeConfigRecursive(value);
+    } else {
+      sanitized[key] = value;
+    }
+  }
+  return sanitized;
+}
+function sanitizeToolConfig(config) {
+  return sanitizeConfigRecursive(config);
+}
+async function analyzeUnified(options) {
+  await (0, import_core7.initializeParsers)();
+  const startTime = Date.now();
+  const requestedTools = options.tools ?? [
+    "patterns",
+    "context",
+    "consistency"
+  ];
+  const result = {
+    summary: {
+      totalIssues: 0,
+      criticalIssues: 0,
+      // Added as per instruction
+      majorIssues: 0,
+      // Added as per instruction
+      totalFiles: 0,
+      toolsRun: [],
+      executionTime: 0,
+      config: options,
+      toolConfigs: {}
+    }
+  };
+  for (const toolName of requestedTools) {
+    let provider = import_core7.ToolRegistry.find(toolName);
+    if (!provider) {
+      const packageName = TOOL_PACKAGE_MAP[toolName] ?? (toolName.startsWith("@aiready/") ? toolName : `@aiready/${toolName}`);
+      try {
+        await import(packageName);
+        provider = import_core7.ToolRegistry.find(toolName);
+        if (provider) {
+          console.log(
+            `\u2705 Successfully loaded tool provider: ${toolName} from ${packageName}`
+          );
+        } else {
+          console.log(
+            `\u26A0\uFE0F Loaded ${packageName} but provider ${toolName} still not found in registry.`
+          );
+        }
+      } catch (err) {
+        console.log(
+          `\u274C Failed to dynamically load tool ${toolName} (${packageName}):`,
+          err.message
+        );
+      }
+    }
+    if (!provider) {
+      console.warn(
+        `\u26A0\uFE0F  Warning: Tool provider for '${toolName}' not found. Skipping.`
+      );
+      continue;
+    }
+    try {
+      const sanitizedOptions = { ...options };
+      delete sanitizedOptions.onProgress;
+      delete sanitizedOptions.progressCallback;
+      const toolOptions = {
+        rootDir: options.rootDir
+        // Always include rootDir
+      };
+      [...import_core7.GLOBAL_INFRA_OPTIONS, ...import_core7.COMMON_FINE_TUNING_OPTIONS].forEach(
+        (key) => {
+          if (key in options && key !== "toolConfigs" && key !== "tools") {
+            toolOptions[key] = options[key];
+          }
+        }
+      );
+      if (options.toolConfigs?.[provider.id]) {
+        Object.assign(toolOptions, options.toolConfigs[provider.id]);
+      } else if (options.tools && !Array.isArray(options.tools) && typeof options.tools === "object" && options.tools[provider.id]) {
+        Object.assign(toolOptions, options.tools[provider.id]);
+      } else if (options[provider.id]) {
+        Object.assign(toolOptions, options[provider.id]);
+      }
+      toolOptions.onProgress = (processed, total, message) => {
+        if (options.progressCallback) {
+          options.progressCallback({
+            tool: provider.id,
+            processed,
+            total,
+            message
+          });
+        }
+      };
+      const output = await provider.analyze(toolOptions);
+      if (output.metadata) {
+        output.metadata.config = sanitizeToolConfig(toolOptions);
+      }
+      if (options.progressCallback) {
+        options.progressCallback({ tool: provider.id, data: output });
+      }
+      result[provider.id] = output;
+      result.summary.toolsRun.push(provider.id);
+      if (output.summary?.config) {
+        result.summary.toolConfigs[provider.id] = sanitizeToolConfig(
+          output.summary.config
+        );
+      } else if (output.metadata?.config) {
+        result.summary.toolConfigs[provider.id] = sanitizeToolConfig(
+          output.metadata.config
+        );
+      } else {
+        result.summary.toolConfigs[provider.id] = sanitizeToolConfig(toolOptions);
+      }
+      const toolFiles = output.summary?.totalFiles ?? output.summary?.filesAnalyzed ?? 0;
+      if (toolFiles > result.summary.totalFiles) {
+        result.summary.totalFiles = toolFiles;
+      }
+      const issueCount = output.results.reduce(
+        (sum, file) => sum + (file.issues?.length ?? 0),
+        0
+      );
+      result.summary.totalIssues += issueCount;
+    } catch (err) {
+      console.error(`\u274C Error running tool '${provider.id}':`, err);
+    }
+  }
+  result.summary.config = sanitizeConfigRecursive({
+    scan: {
+      tools: requestedTools,
+      include: options.include,
+      exclude: options.exclude
+    },
+    // Use 'tools' for tool-specific configurations to match AIReadyConfig
+    tools: result.summary.toolConfigs
+  });
+  result.summary.executionTime = Date.now() - startTime;
+  const keyMappings = {
+    "pattern-detect": ["patternDetect", "patterns"],
+    "context-analyzer": ["contextAnalyzer", "context"],
+    "naming-consistency": ["namingConsistency", "consistency"],
+    "ai-signal-clarity": ["aiSignalClarity"],
+    "agent-grounding": ["agentGrounding"],
+    "testability-index": ["testabilityIndex", "testability"],
+    "doc-drift": ["docDrift"],
+    "dependency-health": ["dependencyHealth", "deps"],
+    "change-amplification": ["changeAmplification"]
+  };
+  for (const [kebabKey, aliases] of Object.entries(keyMappings)) {
+    if (result[kebabKey]) {
+      for (const alias of aliases) {
+        result[alias] = result[kebabKey];
+      }
+    }
+  }
+  return result;
+}
+async function scoreUnified(results, options) {
+  const toolScores = /* @__PURE__ */ new Map();
+  for (const toolId of results.summary.toolsRun) {
+    const provider = import_core7.ToolRegistry.get(toolId);
+    if (!provider) continue;
+    const output = results[toolId];
+    if (!output) continue;
+    try {
+      const toolScore = provider.score(output, options);
+      if (!toolScore.tokenBudget) {
+        if (toolId === import_core7.ToolName.PatternDetect && output.duplicates) {
+          const wastedTokens = output.duplicates.reduce(
+            (sum, d) => sum + (d.tokenCost ?? 0),
+            0
+          );
+          toolScore.tokenBudget = (0, import_core7.calculateTokenBudget)({
+            totalContextTokens: wastedTokens * 2,
+            wastedTokens: {
+              duplication: wastedTokens,
+              fragmentation: 0,
+              chattiness: 0
+            }
+          });
+        } else if (toolId === import_core7.ToolName.ContextAnalyzer && output.summary) {
+          toolScore.tokenBudget = (0, import_core7.calculateTokenBudget)({
+            totalContextTokens: output.summary.totalTokens,
+            wastedTokens: {
+              duplication: 0,
+              fragmentation: output.summary.totalPotentialSavings ?? 0,
+              chattiness: 0
+            }
+          });
+        }
+      }
+      toolScores.set(toolId, toolScore);
+    } catch (err) {
+      console.error(`\u274C Error scoring tool '${toolId}':`, err);
+    }
+  }
+  if (toolScores.size === 0) {
+    return {
+      overall: 0,
+      rating: "Critical",
+      timestamp: (/* @__PURE__ */ new Date()).toISOString(),
+      toolsUsed: [],
+      breakdown: [],
+      calculation: {
+        formula: "0 / 0 = 0",
+        weights: {},
+        normalized: "0 / 0 = 0"
+      }
+    };
   }
+  return (0, import_core7.calculateOverallScore)(toolScores, options, void 0);
 }
-var UPLOAD_HELP_TEXT = `
-EXAMPLES:
-  $ aiready upload report.json --api-key ar_...
-  $ aiready upload .aiready/latest.json
-  $ AIREADY_API_KEY=ar_... aiready upload report.json
-
-ENVIRONMENT VARIABLES:
-  AIREADY_API_KEY    Your platform API key
-  AIREADY_SERVER     Custom platform URL (default: https://dev.platform.getaiready.dev)
-`;
 
-// src/commands/scan-helpers.ts
-var import_chalk4 = __toESM(require("chalk"));
-var import_core6 = require("@aiready/core");
-function getProfileTools(profile) {
-  switch (profile.toLowerCase()) {
-    case "agentic":
-      return [
-        import_core6.ToolName.AiSignalClarity,
-        import_core6.ToolName.AgentGrounding,
-        import_core6.ToolName.TestabilityIndex
-      ];
-    case "cost":
-      return [import_core6.ToolName.PatternDetect, import_core6.ToolName.ContextAnalyzer];
-    case "logic":
-      return [
-        import_core6.ToolName.TestabilityIndex,
-        import_core6.ToolName.NamingConsistency,
-        import_core6.ToolName.ContextAnalyzer,
-        import_core6.ToolName.PatternDetect,
-        import_core6.ToolName.ChangeAmplification
-      ];
-    case "ui":
-      return [
-        import_core6.ToolName.NamingConsistency,
-        import_core6.ToolName.ContextAnalyzer,
-        import_core6.ToolName.PatternDetect,
-        import_core6.ToolName.DocDrift,
-        import_core6.ToolName.AiSignalClarity
-      ];
-    case "security":
-      return [import_core6.ToolName.NamingConsistency, import_core6.ToolName.TestabilityIndex];
-    case "onboarding":
-      return [
-        import_core6.ToolName.ContextAnalyzer,
-        import_core6.ToolName.NamingConsistency,
-        import_core6.ToolName.AgentGrounding
-      ];
-    default:
-      console.log(
-        import_chalk4.default.yellow(`
-\u26A0\uFE0F  Unknown profile '${profile}'. Using defaults.`)
-      );
-      return void 0;
+// src/commands/scan-orchestrator.ts
+async function runUnifiedScan(resolvedDir, finalOptions, options, startTime) {
+  console.log(import_chalk5.default.cyan("\n=== AIReady Run Preview ==="));
+  console.log(
+    import_chalk5.default.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,
+      scoring: {
+        ...finalOptions.scoring,
+        profile: scoringProfile
+      }
+    });
+    printScoring(scoringResult, scoringProfile);
+    if (options.compareTo) {
+      handleTrendComparison(options.compareTo, scoringResult);
+    }
+    await handleBusinessImpactMetrics(
+      results,
+      scoringResult,
+      options.model ?? "gpt-5.4-mini"
+    );
   }
+  return { results, scoringResult };
 }
-function createProgressCallback() {
-  return (event) => {
-    if (event.message) {
-      process.stdout.write(`\r\x1B[K   [${event.tool}] ${event.message}`);
-      return;
-    }
-    process.stdout.write("\r\x1B[K");
-    console.log(import_chalk4.default.cyan(`--- ${event.tool.toUpperCase()} RESULTS ---`));
-    const toolResult = event.data;
-    if (toolResult && toolResult.summary) {
-      if (toolResult.summary.totalIssues !== void 0)
+function handleTrendComparison(baselinePath, currentScoring) {
+  try {
+    const prevReport = JSON.parse(
+      (0, import_fs3.readFileSync)((0, import_path3.resolve)(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(
-          `  Issues found: ${import_chalk4.default.bold(toolResult.summary.totalIssues)}`
+          import_chalk5.default.green(
+            `  \u{1F4C8} Trend: ${diffStr} compared to ${baselinePath} (${prevScore} \u2192 ${currentScoring.overall})`
+          )
         );
-      if (toolResult.summary.score !== void 0)
+      else if (diff < 0)
         console.log(
-          `  Tool Score: ${import_chalk4.default.bold(toolResult.summary.score)}/100`
+          import_chalk5.default.red(
+            `  \u{1F4C9} Trend: ${diffStr} compared to ${baselinePath} (${prevScore} \u2192 ${currentScoring.overall})`
+          )
         );
-      if (toolResult.summary.totalFiles !== void 0)
+      else
         console.log(
-          `  Files analyzed: ${import_chalk4.default.bold(toolResult.summary.totalFiles)}`
+          import_chalk5.default.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 = (0, import_core8.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 { 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(import_chalk5.default.blue("\u{1F680} Starting AIReady unified analysis...\n"));
+  console.log(import_chalk6.default.blue("\u{1F680} Starting AIReady unified analysis...\n"));
   const startTime = Date.now();
-  const resolvedDir = (0, import_path3.resolve)(process.cwd(), directory ?? ".");
-  const repoMetadata = (0, import_core7.getRepoMetadata)(resolvedDir);
+  const resolvedDir = (0, import_path4.resolve)(process.cwd(), directory ?? ".");
+  const repoMetadata = (0, import_core9.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 (0, import_core7.loadMergedConfig)(
+    const finalOptions = await resolveScanConfig(resolvedDir, options);
+    const { results, scoringResult } = await runUnifiedScan(
       resolvedDir,
-      defaults,
-      cliOverrides
-    );
-    const finalOptions = { ...baseOptions };
-    if (baseOptions.tools.includes(import_core7.ToolName.PatternDetect) || baseOptions.tools.includes("patterns")) {
-      const { getSmartDefaults } = await import("@aiready/pattern-detect");
-      const patternSmartDefaults = await getSmartDefaults(
-        resolvedDir,
-        finalOptions.toolConfigs?.[import_core7.ToolName.PatternDetect] ?? {}
-      );
-      if (!finalOptions.toolConfigs) finalOptions.toolConfigs = {};
-      finalOptions.toolConfigs[import_core7.ToolName.PatternDetect] = {
-        ...patternSmartDefaults,
-        ...finalOptions.toolConfigs[import_core7.ToolName.PatternDetect]
-      };
-    }
-    console.log(import_chalk5.default.cyan("\n=== AIReady Run Preview ==="));
-    console.log(
-      import_chalk5.default.white("Tools to run:"),
-      (finalOptions.tools ?? []).join(", ")
+      finalOptions,
+      options,
+      startTime
     );
-    const progressCallback = createProgressCallback();
-    const scoringProfile = options.profile ?? baseOptions.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,
-        scoring: {
-          ...finalOptions.scoring,
-          profile: scoringProfile
-        }
-      });
-      printScoring(scoringResult, scoringProfile);
-      if (options.compareTo) {
-        try {
-          const prevReport = JSON.parse(
-            (0, import_fs3.readFileSync)((0, import_path3.resolve)(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(
-                import_chalk5.default.green(
-                  `  \u{1F4C8} Trend: ${diffStr} compared to ${options.compareTo} (${prevScore} \u2192 ${scoringResult.overall})`
-                )
-              );
-            else if (diff < 0)
-              console.log(
-                import_chalk5.default.red(
-                  `  \u{1F4C9} Trend: ${diffStr} compared to ${options.compareTo} (${prevScore} \u2192 ${scoringResult.overall})`
-                )
-              );
-            else
-              console.log(
-                import_chalk5.default.blue(
-                  `  \u2796 Trend: No change (${prevScore} \u2192 ${scoringResult.overall})`
-                )
-              );
-          }
-        } catch (e) {
-          void e;
-        }
-      }
-      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 = (0, import_core7.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 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;
-      }
-    }
     console.log(
-      import_chalk5.default.dim(
+      import_chalk6.default.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(import_chalk5.default.dim("\u{1F4AC} Found a bug or have a metric idea?"));
-    console.log(import_chalk5.default.dim("\u{1F449} Copy/paste this to your AI agent:"));
+    console.log(import_chalk6.default.dim("\u{1F4AC} Found a bug or have a metric idea?"));
+    console.log(import_chalk6.default.dim("\u{1F449} Copy/paste this to your AI agent:"));
     console.log(
-      import_chalk5.default.cyan(
+      import_chalk6.default.cyan(
         `   "Any feedback for the tools? Please use 'aiready bug' to report \u2764\uFE0F"`
       )
     );
     console.log(
-      import_chalk5.default.dim(
+      import_chalk6.default.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"
       )
     );
@@ -915,21 +942,21 @@ async function scanAction(directory, options) {
       repository: repoMetadata
     };
     const outputFormat = options.output ?? finalOptions.output?.format ?? "console";
-    const outputPath = (0, import_core7.resolveOutputPath)(
+    const outputPath = (0, import_core9.resolveOutputPath)(
       options.outputFile ?? finalOptions.output?.file,
-      `aiready-report-${getReportTimestamp()}.json`,
+      `aiready-report-${(0, import_core2.getReportTimestamp)()}.json`,
       resolvedDir
     );
     if (outputFormat === "json") {
-      (0, import_core7.handleJSONOutput)(
+      (0, import_core9.handleJSONOutput)(
         outputData,
         outputPath,
         `\u2705 Report saved to ${outputPath}`
       );
     } else {
       try {
-        (0, import_fs3.writeFileSync)(outputPath, JSON.stringify(outputData, null, 2));
-        console.log(import_chalk5.default.dim(`\u2705 Report auto-persisted to ${outputPath}`));
+        (0, import_fs4.writeFileSync)(outputPath, JSON.stringify(outputData, null, 2));
+        console.log(import_chalk6.default.dim(`\u2705 Report auto-persisted to ${outputPath}`));
       } catch (err) {
         void err;
       }
@@ -941,61 +968,83 @@ 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(
-          import_chalk5.default.cyan(
-            `
+    await handleGatekeeper(outputData, scoringResult, options, results);
+  } catch (error) {
+    (0, import_core9.handleCLIError)(error, "Analysis");
+  }
+}
+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(
+      import_chalk6.default.cyan(
+        `
 \u{1F4DD} Emitting GitHub Action annotations for ${report.results.length} issues...`
-          )
-        );
-        (0, import_core7.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(import_chalk5.default.red(`
-\u{1F6AB} SCAN FAILED: ${failReason}`));
-        process.exit(1);
-      } else {
-        console.log(import_chalk5.default.green("\n\u2705 SCAN PASSED"));
-      }
+      )
+    );
+    (0, import_core9.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`;
     }
-  } catch (error) {
-    (0, import_core7.handleCLIError)(error, "Analysis");
+  }
+  if (shouldFail) {
+    console.log(import_chalk6.default.red(`
+\u{1F6AB} SCAN FAILED: ${failReason}`));
+    process.exit(1);
+  } else {
+    console.log(import_chalk6.default.green("\n\u2705 SCAN PASSED"));
   }
 }
-var SCAN_HELP_TEXT = `...`;
+var SCAN_HELP_TEXT = `
+Run a comprehensive AI-readiness scan of your codebase.
+
+${import_chalk6.default.bold("Examples:")}
+  $ aiready scan .
+  $ aiready scan src --profile agentic
+  $ aiready scan . --threshold 80 --fail-on critical
+  $ aiready scan . --output json --output-file report.json
+
+${import_chalk6.default.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
+
+${import_chalk6.default.bold("CI/CD Integration:")}
+  Use --threshold and --fail-on to use AIReady as a quality gate in your CI pipelines.
+  When running in GitHub Actions, it will automatically emit annotations for found issues.
+`;
 
 // src/commands/init.ts
-var import_fs4 = require("fs");
-var import_path4 = require("path");
-var import_chalk6 = __toESM(require("chalk"));
-var import_core8 = require("@aiready/core");
+var import_fs5 = require("fs");
+var import_path5 = require("path");
+var import_chalk7 = __toESM(require("chalk"));
+var import_core10 = require("@aiready/core");
 async function initAction(options) {
   const fileExt = options.format === "js" ? "js" : "json";
   const fileName = fileExt === "js" ? "aiready.config.js" : "aiready.json";
-  const filePath = (0, import_path4.join)(process.cwd(), fileName);
-  if ((0, import_fs4.existsSync)(filePath) && !options.force) {
+  const filePath = (0, import_path5.join)(process.cwd(), fileName);
+  if ((0, import_fs5.existsSync)(filePath) && !options.force) {
     console.error(
-      import_chalk6.default.red(`Error: ${fileName} already exists. Use --force to overwrite.`)
+      import_chalk7.default.red(`Error: ${fileName} already exists. Use --force to overwrite.`)
     );
     process.exit(1);
   }
@@ -1019,15 +1068,15 @@ async function initAction(options) {
         "**/*.spec.ts"
       ],
       tools: [
-        import_core8.ToolName.PatternDetect,
-        import_core8.ToolName.ContextAnalyzer,
-        import_core8.ToolName.NamingConsistency,
-        import_core8.ToolName.AiSignalClarity,
-        import_core8.ToolName.AgentGrounding,
-        import_core8.ToolName.TestabilityIndex,
-        import_core8.ToolName.DocDrift,
-        import_core8.ToolName.DependencyHealth,
-        import_core8.ToolName.ChangeAmplification
+        import_core10.ToolName.PatternDetect,
+        import_core10.ToolName.ContextAnalyzer,
+        import_core10.ToolName.NamingConsistency,
+        import_core10.ToolName.AiSignalClarity,
+        import_core10.ToolName.AgentGrounding,
+        import_core10.ToolName.TestabilityIndex,
+        import_core10.ToolName.DocDrift,
+        import_core10.ToolName.DependencyHealth,
+        import_core10.ToolName.ChangeAmplification
       ]
     },
     // Output preferences
@@ -1042,7 +1091,7 @@ async function initAction(options) {
     },
     // Tool-specific configurations
     tools: {
-      [import_core8.ToolName.PatternDetect]: {
+      [import_core10.ToolName.PatternDetect]: {
         // Core detection thresholds
         minSimilarity: 0.4,
         // Jaccard similarity threshold (0-1)
@@ -1072,7 +1121,7 @@ async function initAction(options) {
           // Add any additional advanced options here
         } : {}
       },
-      [import_core8.ToolName.ContextAnalyzer]: {
+      [import_core10.ToolName.ContextAnalyzer]: {
         // Smart defaults are generated dynamically based on repository size
         // These are fallback values for when smart defaults can't be calculated
         maxContextBudget: 25e3,
@@ -1089,7 +1138,7 @@ async function initAction(options) {
         includeNodeModules: false
         // Whether to include node_modules in analysis
       },
-      [import_core8.ToolName.NamingConsistency]: {
+      [import_core10.ToolName.NamingConsistency]: {
         // Core checks
         checkNaming: true,
         // Check naming conventions and quality
@@ -1136,7 +1185,7 @@ async function initAction(options) {
         ],
         ...options.full ? { disableChecks: [] } : {}
       },
-      [import_core8.ToolName.AiSignalClarity]: {
+      [import_core10.ToolName.AiSignalClarity]: {
         // All signal clarity checks enabled by default
         checkMagicLiterals: true,
         // Detect magic numbers and strings
@@ -1155,7 +1204,7 @@ async function initAction(options) {
         checkLargeFiles: true
         // Detect files that are too large
       },
-      [import_core8.ToolName.AgentGrounding]: {
+      [import_core10.ToolName.AgentGrounding]: {
         // Structure clarity
         maxRecommendedDepth: 4,
         // Max directory depth before flagging as "too deep"
@@ -1166,7 +1215,7 @@ async function initAction(options) {
         additionalVagueNames: ["stuff", "misc", "temp", "test"]
         // Custom vague file names
       },
-      [import_core8.ToolName.TestabilityIndex]: {
+      [import_core10.ToolName.TestabilityIndex]: {
         // Coverage thresholds
         minCoverageRatio: 0.3,
         // Minimum acceptable test/source ratio
@@ -1176,19 +1225,19 @@ async function initAction(options) {
         maxDepth: 10
         // Maximum scan depth
       },
-      [import_core8.ToolName.DocDrift]: {
+      [import_core10.ToolName.DocDrift]: {
         // Drift detection
         maxCommits: 50,
         // Maximum commit distance to check for drift
         staleMonths: 3
         // Consider comments older than this as outdated
       },
-      [import_core8.ToolName.DependencyHealth]: {
+      [import_core10.ToolName.DependencyHealth]: {
         // Training cutoff for AI knowledge assessment
         trainingCutoffYear: 2023
         // Year cutoff for AI training data
       },
-      [import_core8.ToolName.ChangeAmplification]: {
+      [import_core10.ToolName.ChangeAmplification]: {
         // Change amplification primarily relies on global scan settings
         // No additional tool-specific configuration required
       }
@@ -1215,30 +1264,28 @@ module.exports = ${JSON.stringify(defaultConfig, null, 2)};
     content = JSON.stringify(defaultConfig, null, 2);
   }
   try {
-    (0, import_fs4.writeFileSync)(filePath, content, "utf8");
+    (0, import_fs5.writeFileSync)(filePath, content, "utf8");
     console.log(
-      import_chalk6.default.green(`
-\u2705 Created default configuration: ${import_chalk6.default.bold(fileName)}`)
+      import_chalk7.default.green(`
+\u2705 Created default configuration: ${import_chalk7.default.bold(fileName)}`)
     );
     console.log(
-      import_chalk6.default.cyan("You can now fine-tune your settings and run AIReady with:")
+      import_chalk7.default.cyan("You can now fine-tune your settings and run AIReady with:")
     );
-    console.log(import_chalk6.default.white(`  $ aiready scan
+    console.log(import_chalk7.default.white(`  $ aiready scan
 `));
   } catch (error) {
-    console.error(import_chalk6.default.red(`Failed to write configuration file: ${error}`));
+    console.error(import_chalk7.default.red(`Failed to write configuration file: ${error}`));
     process.exit(1);
   }
 }
 
 // src/commands/patterns.ts
-var import_chalk7 = __toESM(require("chalk"));
-var import_path5 = require("path");
-var import_core9 = require("@aiready/core");
+var import_chalk8 = __toESM(require("chalk"));
+var import_core11 = require("@aiready/core");
 async function patternsAction(directory, options) {
-  console.log(import_chalk7.default.blue("\u{1F50D} Analyzing patterns...\n"));
+  console.log(import_chalk8.default.blue("\u{1F50D} Analyzing patterns...\n"));
   const startTime = Date.now();
-  const resolvedDir = (0, import_path5.resolve)(process.cwd(), directory ?? ".");
   try {
     const useSmartDefaults = !options.fullScan;
     const defaults = {
@@ -1267,8 +1314,8 @@ async function patternsAction(directory, options) {
     if (options.minSharedTokens) {
       cliOptions.minSharedTokens = parseInt(options.minSharedTokens);
     }
-    const finalOptions = await (0, import_core9.loadMergedConfig)(
-      resolvedDir,
+    const { resolvedDir, finalOptions } = await (0, import_core11.prepareActionConfig)(
+      directory,
       defaults,
       cliOptions
     );
@@ -1276,66 +1323,59 @@ async function patternsAction(directory, options) {
     const { results, duplicates } = await analyzePatterns(
       finalOptions
     );
-    const elapsedTime = (0, import_core9.getElapsedTime)(startTime);
+    const elapsedTime = (0, import_core11.getElapsedTime)(startTime);
     const summary = generateSummary(results);
     let patternScore;
     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 } = (0, import_core11.resolveOutputFormat)(
+      options,
+      finalOptions
+    );
     if (outputFormat === "json") {
-      const outputData = {
+      const outputData = (0, import_core11.formatStandardReport)({
         results,
-        summary: { ...summary, executionTime: parseFloat(elapsedTime) },
-        ...patternScore && { scoring: patternScore }
-      };
-      const outputPath = (0, import_core9.resolveOutputPath)(
-        userOutputFile,
-        `aiready-report-${getReportTimestamp()}.json`,
-        resolvedDir
-      );
-      (0, import_core9.handleJSONOutput)(
+        summary,
+        elapsedTime,
+        score: patternScore
+      });
+      (0, import_core11.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(import_chalk7.default.cyan(divider));
-      console.log(import_chalk7.default.bold.white("  PATTERN ANALYSIS SUMMARY"));
-      console.log(import_chalk7.default.cyan(divider) + "\n");
+      (0, import_core11.printTerminalHeader)("PATTERN ANALYSIS SUMMARY");
       console.log(
-        import_chalk7.default.white(`\u{1F4C1} Files analyzed: ${import_chalk7.default.bold(results.length)}`)
+        import_chalk8.default.white(`\u{1F4C1} Files analyzed: ${import_chalk8.default.bold(results.length)}`)
       );
       console.log(
-        import_chalk7.default.yellow(
-          `\u26A0  Duplicate patterns found: ${import_chalk7.default.bold(summary.totalPatterns)}`
+        import_chalk8.default.yellow(
+          `\u26A0  Duplicate patterns found: ${import_chalk8.default.bold(summary.totalPatterns)}`
         )
       );
       console.log(
-        import_chalk7.default.red(
-          `\u{1F4B0} Token cost (wasted): ${import_chalk7.default.bold(summary.totalTokenCost.toLocaleString())}`
+        import_chalk8.default.red(
+          `\u{1F4B0} Token cost (wasted): ${import_chalk8.default.bold(summary.totalTokenCost.toLocaleString())}`
         )
       );
       console.log(
-        import_chalk7.default.gray(`\u23F1  Analysis time: ${import_chalk7.default.bold(elapsedTime + "s")}`)
+        import_chalk8.default.gray(`\u23F1  Analysis time: ${import_chalk8.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_chalk7.default.cyan("\n" + divider));
-        console.log(import_chalk7.default.bold.white("  PATTERNS BY TYPE"));
-        console.log(import_chalk7.default.cyan(divider) + "\n");
+        console.log("\n" + (0, import_core11.getTerminalDivider)());
+        console.log(import_chalk8.default.bold.white("  PATTERNS BY TYPE"));
+        console.log((0, import_core11.getTerminalDivider)() + "\n");
         sortedTypes.forEach(([type, count]) => {
-          console.log(`  ${import_chalk7.default.white(type.padEnd(15))} ${import_chalk7.default.bold(count)}`);
+          console.log(`  ${import_chalk8.default.white(type.padEnd(15))} ${import_chalk8.default.bold(count)}`);
         });
       }
       if (summary.totalPatterns > 0 && duplicates.length > 0) {
-        console.log(import_chalk7.default.cyan("\n" + divider));
-        console.log(import_chalk7.default.bold.white("  TOP DUPLICATE PATTERNS"));
-        console.log(import_chalk7.default.cyan(divider) + "\n");
+        console.log("\n" + (0, import_core11.getTerminalDivider)());
+        console.log(import_chalk8.default.bold.white("  TOP DUPLICATE PATTERNS"));
+        console.log((0, import_core11.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";
@@ -1343,31 +1383,31 @@ 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}: ${import_chalk7.default.bold(file1Name)} \u2194 ${import_chalk7.default.bold(file2Name)}`
+            `${severityIcon} ${severity}: ${import_chalk8.default.bold(file1Name)} \u2194 ${import_chalk8.default.bold(file2Name)}`
           );
           console.log(
-            `   Similarity: ${import_chalk7.default.bold(Math.round(dup.similarity * 100) + "%")} | Wasted: ${import_chalk7.default.bold(dup.tokenCost.toLocaleString())} tokens each`
+            `   Similarity: ${import_chalk8.default.bold(Math.round(dup.similarity * 100) + "%")} | Wasted: ${import_chalk8.default.bold(dup.tokenCost.toLocaleString())} tokens each`
           );
           console.log(
-            `   Lines: ${import_chalk7.default.cyan(dup.line1 + "-" + dup.endLine1)} \u2194 ${import_chalk7.default.cyan(dup.line2 + "-" + dup.endLine2)}
+            `   Lines: ${import_chalk8.default.cyan(dup.line1 + "-" + dup.endLine1)} \u2194 ${import_chalk8.default.cyan(dup.line2 + "-" + dup.endLine2)}
 `
           );
         });
       } else {
         console.log(
-          import_chalk7.default.green("\n\u2728 Great! No duplicate patterns detected.\n")
+          import_chalk8.default.green("\n\u2728 Great! No duplicate patterns detected.\n")
         );
       }
       if (patternScore) {
-        console.log(import_chalk7.default.cyan(divider));
-        console.log(import_chalk7.default.bold.white("  AI READINESS SCORE (Patterns)"));
-        console.log(import_chalk7.default.cyan(divider) + "\n");
-        console.log((0, import_core9.formatToolScore)(patternScore));
+        console.log((0, import_core11.getTerminalDivider)());
+        console.log(import_chalk8.default.bold.white("  AI READINESS SCORE (Patterns)"));
+        console.log((0, import_core11.getTerminalDivider)() + "\n");
+        console.log((0, import_core11.formatToolScore)(patternScore));
         console.log();
       }
     }
   } catch (error) {
-    (0, import_core9.handleCLIError)(error, "Pattern analysis");
+    (0, import_core11.handleCLIError)(error, "Pattern analysis");
   }
 }
 var PATTERNS_HELP_TEXT = `
@@ -1378,13 +1418,11 @@ EXAMPLES:
 `;
 
 // src/commands/context.ts
-var import_chalk8 = __toESM(require("chalk"));
-var import_path6 = require("path");
-var import_core10 = require("@aiready/core");
+var import_chalk9 = __toESM(require("chalk"));
+var import_core12 = require("@aiready/core");
 async function contextAction(directory, options) {
-  console.log(import_chalk8.default.blue("\u{1F9E0} Analyzing context costs...\n"));
+  console.log(import_chalk9.default.blue("\u{1F9E0} Analyzing context costs...\n"));
   const startTime = Date.now();
-  const resolvedDir = (0, import_path6.resolve)(process.cwd(), directory ?? ".");
   try {
     const defaults = {
       maxDepth: 5,
@@ -1396,7 +1434,7 @@ async function contextAction(directory, options) {
         file: void 0
       }
     };
-    const baseOptions = await (0, import_core10.loadMergedConfig)(resolvedDir, defaults, {
+    const { resolvedDir, finalOptions: baseOptions } = await (0, import_core12.prepareActionConfig)(directory, defaults, {
       maxDepth: options.maxDepth ? parseInt(options.maxDepth) : void 0,
       maxContextBudget: options.maxContext ? parseInt(options.maxContext) : void 0,
       include: options.include?.split(","),
@@ -1422,113 +1460,111 @@ async function contextAction(directory, options) {
     console.log("");
     const { analyzeContext, generateSummary, calculateContextScore } = await import("@aiready/context-analyzer");
     const results = await analyzeContext(finalOptions);
-    const elapsedTime = (0, import_core10.getElapsedTime)(startTime);
+    const elapsedTime = (0, import_core12.getElapsedTime)(startTime);
     const summary = generateSummary(results);
     let contextScore;
     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 } = (0, import_core12.resolveOutputFormat)(
+      options,
+      finalOptions
+    );
     if (outputFormat === "json") {
-      const outputData = {
+      const outputData = (0, import_core12.formatStandardReport)({
         results,
-        summary: { ...summary, executionTime: parseFloat(elapsedTime) },
-        ...contextScore && { scoring: contextScore }
-      };
-      const outputPath = (0, import_core10.resolveOutputPath)(
-        userOutputFile,
-        `aiready-report-${getReportTimestamp()}.json`,
-        resolvedDir
-      );
-      (0, import_core10.handleJSONOutput)(
+        summary,
+        elapsedTime,
+        score: contextScore
+      });
+      (0, import_core12.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(import_chalk8.default.cyan(divider));
-      console.log(import_chalk8.default.bold.white("  CONTEXT ANALYSIS SUMMARY"));
-      console.log(import_chalk8.default.cyan(divider) + "\n");
+      console.log(import_chalk9.default.cyan(divider));
+      console.log(import_chalk9.default.bold.white("  CONTEXT ANALYSIS SUMMARY"));
+      console.log(import_chalk9.default.cyan(divider) + "\n");
       console.log(
-        import_chalk8.default.white(`\u{1F4C1} Files analyzed: ${import_chalk8.default.bold(summary.totalFiles)}`)
+        import_chalk9.default.white(`\u{1F4C1} Files analyzed: ${import_chalk9.default.bold(summary.totalFiles)}`)
       );
       console.log(
-        import_chalk8.default.white(
-          `\u{1F4CA} Total tokens: ${import_chalk8.default.bold(summary.totalTokens.toLocaleString())}`
+        import_chalk9.default.white(
+          `\u{1F4CA} Total tokens: ${import_chalk9.default.bold(summary.totalTokens.toLocaleString())}`
         )
       );
       console.log(
-        import_chalk8.default.yellow(
-          `\u{1F4B0} Avg context budget: ${import_chalk8.default.bold(summary.avgContextBudget.toFixed(0))} tokens/file`
+        import_chalk9.default.yellow(
+          `\u{1F4B0} Avg context budget: ${import_chalk9.default.bold(summary.avgContextBudget.toFixed(0))} tokens/file`
         )
       );
       console.log(
-        import_chalk8.default.white(`\u23F1  Analysis time: ${import_chalk8.default.bold(elapsedTime + "s")}
+        import_chalk9.default.white(`\u23F1  Analysis time: ${import_chalk9.default.bold(elapsedTime + "s")}
 `)
       );
       const totalIssues = summary.criticalIssues + summary.majorIssues + summary.minorIssues;
       if (totalIssues > 0) {
-        console.log(import_chalk8.default.bold("\u26A0\uFE0F  Issues Found:\n"));
+        console.log(import_chalk9.default.bold("\u26A0\uFE0F  Issues Found:\n"));
         if (summary.criticalIssues > 0) {
           console.log(
-            import_chalk8.default.red(`   \u{1F534} Critical: ${import_chalk8.default.bold(summary.criticalIssues)}`)
+            import_chalk9.default.red(`   \u{1F534} Critical: ${import_chalk9.default.bold(summary.criticalIssues)}`)
           );
         }
         if (summary.majorIssues > 0) {
           console.log(
-            import_chalk8.default.yellow(`   \u{1F7E1} Major: ${import_chalk8.default.bold(summary.majorIssues)}`)
+            import_chalk9.default.yellow(`   \u{1F7E1} Major: ${import_chalk9.default.bold(summary.majorIssues)}`)
           );
         }
         if (summary.minorIssues > 0) {
           console.log(
-            import_chalk8.default.blue(`   \u{1F535} Minor: ${import_chalk8.default.bold(summary.minorIssues)}`)
+            import_chalk9.default.blue(`   \u{1F535} Minor: ${import_chalk9.default.bold(summary.minorIssues)}`)
           );
         }
         console.log(
-          import_chalk8.default.green(
+          import_chalk9.default.green(
             `
-   \u{1F4A1} Potential savings: ${import_chalk8.default.bold(summary.totalPotentialSavings.toLocaleString())} tokens
+   \u{1F4A1} Potential savings: ${import_chalk9.default.bold(summary.totalPotentialSavings.toLocaleString())} tokens
 `
           )
         );
       } else {
-        console.log(import_chalk8.default.green("\u2705 No significant issues found!\n"));
+        console.log(import_chalk9.default.green("\u2705 No significant issues found!\n"));
       }
       if (summary.deepFiles.length > 0) {
-        console.log(import_chalk8.default.bold("\u{1F4CF} Deep Import Chains:\n"));
+        console.log(import_chalk9.default.bold("\u{1F4CF} Deep Import Chains:\n"));
         console.log(
-          import_chalk8.default.gray(`   Average depth: ${summary.avgImportDepth.toFixed(1)}`)
+          import_chalk9.default.gray(`   Average depth: ${summary.avgImportDepth.toFixed(1)}`)
         );
         console.log(
-          import_chalk8.default.gray(`   Maximum depth: ${summary.maxImportDepth}
+          import_chalk9.default.gray(`   Maximum depth: ${summary.maxImportDepth}
 `)
         );
         summary.deepFiles.slice(0, 10).forEach((item) => {
           const fileName = item.file.split("/").slice(-2).join("/");
           console.log(
-            `   ${import_chalk8.default.cyan("\u2192")} ${import_chalk8.default.white(fileName)} ${import_chalk8.default.dim(`(depth: ${item.depth})`)}`
+            `   ${import_chalk9.default.cyan("\u2192")} ${import_chalk9.default.white(fileName)} ${import_chalk9.default.dim(`(depth: ${item.depth})`)}`
           );
         });
         console.log();
       }
       if (summary.fragmentedModules.length > 0) {
-        console.log(import_chalk8.default.bold("\u{1F9E9} Fragmented Modules:\n"));
+        console.log(import_chalk9.default.bold("\u{1F9E9} Fragmented Modules:\n"));
         console.log(
-          import_chalk8.default.gray(
+          import_chalk9.default.gray(
             `   Average fragmentation: ${(summary.avgFragmentation * 100).toFixed(0)}%
 `
           )
         );
         summary.fragmentedModules.slice(0, 10).forEach((module2) => {
           console.log(
-            `   ${import_chalk8.default.yellow("\u25CF")} ${import_chalk8.default.white(module2.domain)} - ${import_chalk8.default.dim(`${module2.files.length} files, ${(module2.fragmentationScore * 100).toFixed(0)}% scattered`)}`
+            `   ${import_chalk9.default.yellow("\u25CF")} ${import_chalk9.default.white(module2.domain)} - ${import_chalk9.default.dim(`${module2.files.length} files, ${(module2.fragmentationScore * 100).toFixed(0)}% scattered`)}`
           );
           console.log(
-            import_chalk8.default.dim(
+            import_chalk9.default.dim(
               `     Token cost: ${module2.totalTokens.toLocaleString()}, Cohesion: ${(module2.avgCohesion * 100).toFixed(0)}%`
             )
           );
@@ -1536,9 +1572,9 @@ async function contextAction(directory, options) {
         console.log();
       }
       if (summary.lowCohesionFiles.length > 0) {
-        console.log(import_chalk8.default.bold("\u{1F500} Low Cohesion Files:\n"));
+        console.log(import_chalk9.default.bold("\u{1F500} Low Cohesion Files:\n"));
         console.log(
-          import_chalk8.default.gray(
+          import_chalk9.default.gray(
             `   Average cohesion: ${(summary.avgCohesion * 100).toFixed(0)}%
 `
           )
@@ -1546,46 +1582,44 @@ 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 ? import_chalk8.default.red : import_chalk8.default.yellow;
+          const color = item.score < 0.4 ? import_chalk9.default.red : import_chalk9.default.yellow;
           console.log(
-            `   ${color("\u25CB")} ${import_chalk8.default.white(fileName)} ${import_chalk8.default.dim(`(${scorePercent}% cohesion)`)}`
+            `   ${color("\u25CB")} ${import_chalk9.default.white(fileName)} ${import_chalk9.default.dim(`(${scorePercent}% cohesion)`)}`
           );
         });
         console.log();
       }
       if (summary.topExpensiveFiles.length > 0) {
-        console.log(import_chalk8.default.bold("\u{1F4B8} Most Expensive Files (Context Budget):\n"));
+        console.log(import_chalk9.default.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" ? import_chalk8.default.red : item.severity === "major" ? import_chalk8.default.yellow : import_chalk8.default.blue;
+          const severityColor = item.severity === "critical" ? import_chalk9.default.red : item.severity === "major" ? import_chalk9.default.yellow : import_chalk9.default.blue;
           console.log(
-            `   ${severityColor("\u25CF")} ${import_chalk8.default.white(fileName)} ${import_chalk8.default.dim(`(${item.contextBudget.toLocaleString()} tokens)`)}`
+            `   ${severityColor("\u25CF")} ${import_chalk9.default.white(fileName)} ${import_chalk9.default.dim(`(${item.contextBudget.toLocaleString()} tokens)`)}`
           );
         });
         console.log();
       }
       if (contextScore) {
-        console.log(import_chalk8.default.cyan(divider));
-        console.log(import_chalk8.default.bold.white("  AI READINESS SCORE (Context)"));
-        console.log(import_chalk8.default.cyan(divider) + "\n");
-        console.log((0, import_core10.formatToolScore)(contextScore));
+        console.log(import_chalk9.default.cyan(divider));
+        console.log(import_chalk9.default.bold.white("  AI READINESS SCORE (Context)"));
+        console.log(import_chalk9.default.cyan(divider) + "\n");
+        console.log((0, import_core12.formatToolScore)(contextScore));
         console.log();
       }
     }
   } catch (error) {
-    (0, import_core10.handleCLIError)(error, "Context analysis");
+    (0, import_core12.handleCLIError)(error, "Context analysis");
   }
 }
 
 // src/commands/consistency.ts
-var import_chalk9 = __toESM(require("chalk"));
-var import_fs5 = require("fs");
-var import_path7 = require("path");
-var import_core11 = require("@aiready/core");
+var import_chalk10 = __toESM(require("chalk"));
+var import_fs6 = require("fs");
+var import_core13 = require("@aiready/core");
 async function consistencyAction(directory, options) {
-  console.log(import_chalk9.default.blue("\u{1F50D} Analyzing consistency...\n"));
+  console.log(import_chalk10.default.blue("\u{1F50D} Analyzing consistency...\n"));
   const startTime = Date.now();
-  const resolvedDir = (0, import_path7.resolve)(process.cwd(), directory ?? ".");
   try {
     const defaults = {
       checkNaming: true,
@@ -1598,16 +1632,20 @@ async function consistencyAction(directory, options) {
         file: void 0
       }
     };
-    const finalOptions = await (0, import_core11.loadMergedConfig)(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 (0, import_core13.prepareActionConfig)(
+      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 = (0, import_core11.getElapsedTime)(startTime);
+    const elapsedTime = (0, import_core13.getElapsedTime)(startTime);
     let consistencyScore;
     if (options.score) {
       const issues = report.results?.flatMap((r) => r.issues) ?? [];
@@ -1616,52 +1654,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 } = (0, import_core13.resolveOutputFormat)(
+      options,
+      finalOptions
+    );
     if (outputFormat === "json") {
-      const outputData = {
-        ...report,
-        summary: {
-          ...report.summary,
-          executionTime: parseFloat(elapsedTime)
-        },
-        ...consistencyScore && { scoring: consistencyScore }
-      };
-      const outputPath = (0, import_core11.resolveOutputPath)(
-        userOutputFile,
-        `aiready-report-${getReportTimestamp()}.json`,
-        resolvedDir
-      );
-      (0, import_core11.handleJSONOutput)(
+      const outputData = (0, import_core13.formatStandardReport)({
+        report,
+        summary: report.summary,
+        elapsedTime,
+        score: consistencyScore
+      });
+      (0, import_core13.handleStandardJSONOutput)({
         outputData,
-        outputPath,
-        `\u2705 Results saved to ${outputPath}`
-      );
+        outputFile: userOutputFile,
+        resolvedDir
+      });
     } else if (outputFormat === "markdown") {
       const markdown = generateMarkdownReport(report, elapsedTime);
-      const outputPath = (0, import_core11.resolveOutputPath)(
+      const outputPath = (0, import_core13.resolveOutputPath)(
         userOutputFile,
-        `aiready-report-${getReportTimestamp()}.md`,
+        `aiready-report-${(0, import_core2.getReportTimestamp)()}.md`,
         resolvedDir
       );
-      (0, import_fs5.writeFileSync)(outputPath, markdown);
-      console.log(import_chalk9.default.green(`\u2705 Report saved to ${outputPath}`));
+      (0, import_fs6.writeFileSync)(outputPath, markdown);
+      console.log(import_chalk10.default.green(`\u2705 Report saved to ${outputPath}`));
     } else {
-      console.log(import_chalk9.default.bold("\n\u{1F4CA} Summary\n"));
+      console.log(import_chalk10.default.bold("\n\u{1F4CA} Summary\n"));
       console.log(
-        `Files Analyzed: ${import_chalk9.default.cyan(report.summary.filesAnalyzed)}`
+        `Files Analyzed: ${import_chalk10.default.cyan(report.summary.filesAnalyzed)}`
       );
-      console.log(`Total Issues: ${import_chalk9.default.yellow(report.summary.totalIssues)}`);
-      console.log(`  Naming: ${import_chalk9.default.yellow(report.summary.namingIssues)}`);
-      console.log(`  Patterns: ${import_chalk9.default.yellow(report.summary.patternIssues)}`);
+      console.log(`Total Issues: ${import_chalk10.default.yellow(report.summary.totalIssues)}`);
+      console.log(`  Naming: ${import_chalk10.default.yellow(report.summary.namingIssues)}`);
+      console.log(`  Patterns: ${import_chalk10.default.yellow(report.summary.patternIssues)}`);
       console.log(
-        `  Architecture: ${import_chalk9.default.yellow(report.summary.architectureIssues ?? 0)}`
+        `  Architecture: ${import_chalk10.default.yellow(report.summary.architectureIssues ?? 0)}`
       );
-      console.log(`Analysis Time: ${import_chalk9.default.gray(elapsedTime + "s")}
+      console.log(`Analysis Time: ${import_chalk10.default.gray(elapsedTime + "s")}
 `);
       if (report.summary.totalIssues === 0) {
         console.log(
-          import_chalk9.default.green(
+          import_chalk10.default.green(
             "\u2728 No consistency issues found! Your codebase is well-maintained.\n"
           )
         );
@@ -1673,20 +1706,20 @@ async function consistencyAction(directory, options) {
           (r) => r.issues.some((i) => i.category === "patterns")
         );
         if (namingResults.length > 0) {
-          console.log(import_chalk9.default.bold("\u{1F3F7}\uFE0F  Naming Issues\n"));
+          console.log(import_chalk10.default.bold("\u{1F3F7}\uFE0F  Naming Issues\n"));
           let shown = 0;
           for (const namingFileResult of namingResults) {
             if (shown >= 5) break;
             for (const issue of namingFileResult.issues) {
               if (shown >= 5) break;
-              const severityColor = issue.severity === "critical" ? import_chalk9.default.red : issue.severity === "major" ? import_chalk9.default.yellow : issue.severity === "minor" ? import_chalk9.default.blue : import_chalk9.default.gray;
+              const severityColor = issue.severity === "critical" ? import_chalk10.default.red : issue.severity === "major" ? import_chalk10.default.yellow : issue.severity === "minor" ? import_chalk10.default.blue : import_chalk10.default.gray;
               console.log(
-                `${severityColor(issue.severity.toUpperCase())} ${import_chalk9.default.dim(`${issue.location.file}:${issue.location.line}`)}`
+                `${severityColor(issue.severity.toUpperCase())} ${import_chalk10.default.dim(`${issue.location.file}:${issue.location.line}`)}`
               );
               console.log(`  ${issue.message}`);
               if (issue.suggestion) {
                 console.log(
-                  `  ${import_chalk9.default.dim("\u2192")} ${import_chalk9.default.italic(issue.suggestion)}`
+                  `  ${import_chalk10.default.dim("\u2192")} ${import_chalk10.default.italic(issue.suggestion)}`
                 );
               }
               console.log();
@@ -1695,25 +1728,25 @@ async function consistencyAction(directory, options) {
           }
           const remaining = namingResults.reduce((sum, r) => sum + r.issues.length, 0) - shown;
           if (remaining > 0) {
-            console.log(import_chalk9.default.dim(`  ... and ${remaining} more issues
+            console.log(import_chalk10.default.dim(`  ... and ${remaining} more issues
 `));
           }
         }
         if (patternResults.length > 0) {
-          console.log(import_chalk9.default.bold("\u{1F504} Pattern Issues\n"));
+          console.log(import_chalk10.default.bold("\u{1F504} Pattern Issues\n"));
           let shown = 0;
           for (const patternFileResult of patternResults) {
             if (shown >= 5) break;
             for (const issue of patternFileResult.issues) {
               if (shown >= 5) break;
-              const severityColor = issue.severity === "critical" ? import_chalk9.default.red : issue.severity === "major" ? import_chalk9.default.yellow : issue.severity === "minor" ? import_chalk9.default.blue : import_chalk9.default.gray;
+              const severityColor = issue.severity === "critical" ? import_chalk10.default.red : issue.severity === "major" ? import_chalk10.default.yellow : issue.severity === "minor" ? import_chalk10.default.blue : import_chalk10.default.gray;
               console.log(
-                `${severityColor(issue.severity.toUpperCase())} ${import_chalk9.default.dim(`${issue.location.file}:${issue.location.line}`)}`
+                `${severityColor(issue.severity.toUpperCase())} ${import_chalk10.default.dim(`${issue.location.file}:${issue.location.line}`)}`
               );
               console.log(`  ${issue.message}`);
               if (issue.suggestion) {
                 console.log(
-                  `  ${import_chalk9.default.dim("\u2192")} ${import_chalk9.default.italic(issue.suggestion)}`
+                  `  ${import_chalk10.default.dim("\u2192")} ${import_chalk10.default.italic(issue.suggestion)}`
                 );
               }
               console.log();
@@ -1722,12 +1755,12 @@ async function consistencyAction(directory, options) {
           }
           const remaining = patternResults.reduce((sum, r) => sum + r.issues.length, 0) - shown;
           if (remaining > 0) {
-            console.log(import_chalk9.default.dim(`  ... and ${remaining} more issues
+            console.log(import_chalk10.default.dim(`  ... and ${remaining} more issues
 `));
           }
         }
         if (report.recommendations.length > 0) {
-          console.log(import_chalk9.default.bold("\u{1F4A1} Recommendations\n"));
+          console.log(import_chalk10.default.bold("\u{1F4A1} Recommendations\n"));
           report.recommendations.forEach((rec, i) => {
             console.log(`${i + 1}. ${rec}`);
           });
@@ -1735,38 +1768,38 @@ async function consistencyAction(directory, options) {
         }
       }
       if (consistencyScore) {
-        console.log(import_chalk9.default.bold("\n\u{1F4CA} AI Readiness Score (Consistency)\n"));
-        console.log((0, import_core11.formatToolScore)(consistencyScore));
+        console.log(import_chalk10.default.bold("\n\u{1F4CA} AI Readiness Score (Consistency)\n"));
+        console.log((0, import_core13.formatToolScore)(consistencyScore));
         console.log();
       }
     }
   } catch (error) {
-    (0, import_core11.handleCLIError)(error, "Consistency analysis");
+    (0, import_core13.handleCLIError)(error, "Consistency analysis");
   }
 }
 
 // src/commands/visualize.ts
-var import_chalk10 = __toESM(require("chalk"));
-var import_fs6 = require("fs");
-var import_path8 = require("path");
+var import_chalk11 = __toESM(require("chalk"));
+var import_fs7 = require("fs");
+var import_path6 = require("path");
 var import_child_process = require("child_process");
-var import_core12 = require("@aiready/core");
-var import_core13 = require("@aiready/core");
+var import_core14 = require("@aiready/core");
+var import_core15 = require("@aiready/core");
 async function visualizeAction(directory, options) {
   try {
-    const dirPath = (0, import_path8.resolve)(process.cwd(), directory ?? ".");
-    let reportPath = options.report ? (0, import_path8.resolve)(dirPath, options.report) : null;
-    if (!reportPath || !(0, import_fs6.existsSync)(reportPath)) {
-      const latestScan = (0, import_core13.findLatestReport)(dirPath);
+    const dirPath = (0, import_path6.resolve)(process.cwd(), directory ?? ".");
+    let reportPath = options.report ? (0, import_path6.resolve)(dirPath, options.report) : null;
+    if (!reportPath || !(0, import_fs7.existsSync)(reportPath)) {
+      const latestScan = (0, import_core15.findLatestReport)(dirPath);
       if (latestScan) {
         reportPath = latestScan;
         console.log(
-          import_chalk10.default.dim(`Found latest report: ${latestScan.split("/").pop()}`)
+          import_chalk11.default.dim(`Found latest report: ${latestScan.split("/").pop()}`)
         );
       } else {
-        console.error(import_chalk10.default.red("\u274C No AI readiness report found"));
+        console.error(import_chalk11.default.red("\u274C No AI readiness report found"));
         console.log(
-          import_chalk10.default.dim(
+          import_chalk11.default.dim(
             `
 Generate a report with:
   aiready scan --output json
@@ -1778,13 +1811,13 @@ Or specify a custom report:
         return;
       }
     }
-    const raw = (0, import_fs6.readFileSync)(reportPath, "utf8");
+    const raw = (0, import_fs7.readFileSync)(reportPath, "utf8");
     const report = JSON.parse(raw);
-    const configPath = (0, import_path8.resolve)(dirPath, "aiready.json");
+    const configPath = (0, import_path6.resolve)(dirPath, "aiready.json");
     let graphConfig = { maxNodes: 400, maxEdges: 600 };
-    if ((0, import_fs6.existsSync)(configPath)) {
+    if ((0, import_fs7.existsSync)(configPath)) {
       try {
-        const rawConfig = JSON.parse((0, import_fs6.readFileSync)(configPath, "utf8"));
+        const rawConfig = JSON.parse((0, import_fs7.readFileSync)(configPath, "utf8"));
         if (rawConfig.visualizer?.graph) {
           graphConfig = {
             maxNodes: rawConfig.visualizer.graph.maxNodes ?? graphConfig.maxNodes,
@@ -1804,16 +1837,16 @@ Or specify a custom report:
     let devServerStarted = false;
     if (useDevMode) {
       try {
-        const localWebDir = (0, import_path8.resolve)(dirPath, "packages/visualizer");
+        const localWebDir = (0, import_path6.resolve)(dirPath, "packages/visualizer");
         let webDir = "";
         let visualizerAvailable = false;
-        if ((0, import_fs6.existsSync)(localWebDir)) {
+        if ((0, import_fs7.existsSync)(localWebDir)) {
           webDir = localWebDir;
           visualizerAvailable = true;
         } else {
           const nodemodulesLocations = [
-            (0, import_path8.resolve)(dirPath, "node_modules", "@aiready", "visualizer"),
-            (0, import_path8.resolve)(
+            (0, import_path6.resolve)(dirPath, "node_modules", "@aiready", "visualizer"),
+            (0, import_path6.resolve)(
               process.cwd(),
               "node_modules",
               "@aiready",
@@ -1823,14 +1856,14 @@ Or specify a custom report:
           let currentDir = dirPath;
           while (currentDir !== "/" && currentDir !== ".") {
             nodemodulesLocations.push(
-              (0, import_path8.resolve)(currentDir, "node_modules", "@aiready", "visualizer")
+              (0, import_path6.resolve)(currentDir, "node_modules", "@aiready", "visualizer")
             );
-            const parent = (0, import_path8.resolve)(currentDir, "..");
+            const parent = (0, import_path6.resolve)(currentDir, "..");
             if (parent === currentDir) break;
             currentDir = parent;
           }
           for (const location of nodemodulesLocations) {
-            if ((0, import_fs6.existsSync)(location) && (0, import_fs6.existsSync)((0, import_path8.resolve)(location, "package.json"))) {
+            if ((0, import_fs7.existsSync)(location) && (0, import_fs7.existsSync)((0, import_path6.resolve)(location, "package.json"))) {
               webDir = location;
               visualizerAvailable = true;
               break;
@@ -1839,21 +1872,21 @@ Or specify a custom report:
           if (!visualizerAvailable) {
             try {
               const vizPkgPath = require.resolve("@aiready/visualizer/package.json");
-              webDir = (0, import_path8.resolve)(vizPkgPath, "..");
+              webDir = (0, import_path6.resolve)(vizPkgPath, "..");
               visualizerAvailable = true;
             } catch (err) {
               void err;
             }
           }
         }
-        const webViteConfigExists = webDir && (0, import_fs6.existsSync)((0, import_path8.resolve)(webDir, "web", "vite.config.ts"));
+        const webViteConfigExists = webDir && (0, import_fs7.existsSync)((0, import_path6.resolve)(webDir, "web", "vite.config.ts"));
         if (visualizerAvailable && webViteConfigExists) {
           const spawnCwd = webDir;
           const { watch } = await import("fs");
           const copyReportToViz = () => {
             try {
-              const destPath = (0, import_path8.resolve)(spawnCwd, "web", "report-data.json");
-              (0, import_fs6.copyFileSync)(reportPath, destPath);
+              const destPath = (0, import_path6.resolve)(spawnCwd, "web", "report-data.json");
+              (0, import_fs7.copyFileSync)(reportPath, destPath);
               console.log(`\u{1F4CB} Report synced to ${destPath}`);
             } catch (e) {
               console.error("Failed to sync report:", e);
@@ -1896,29 +1929,29 @@ Or specify a custom report:
           return;
         } else {
           console.log(
-            import_chalk10.default.yellow(
+            import_chalk11.default.yellow(
               "\u26A0\uFE0F  Dev server not available (requires local @aiready/visualizer with web assets)."
             )
           );
           console.log(
-            import_chalk10.default.cyan("   Falling back to static HTML generation...\n")
+            import_chalk11.default.cyan("   Falling back to static HTML generation...\n")
           );
           useDevMode = false;
         }
       } catch (err) {
         console.error("Failed to start dev server:", err);
         console.log(
-          import_chalk10.default.cyan("   Falling back to static HTML generation...\n")
+          import_chalk11.default.cyan("   Falling back to static HTML generation...\n")
         );
         useDevMode = false;
       }
     }
     console.log("Generating HTML...");
-    const html = (0, import_core13.generateHTML)(graph);
+    const html = (0, import_core15.generateHTML)(graph);
     const defaultOutput = "visualization.html";
-    const outPath = (0, import_path8.resolve)(dirPath, options.output ?? defaultOutput);
-    (0, import_fs6.writeFileSync)(outPath, html, "utf8");
-    console.log(import_chalk10.default.green(`\u2705 Visualization written to: ${outPath}`));
+    const outPath = (0, import_path6.resolve)(dirPath, options.output ?? defaultOutput);
+    (0, import_fs7.writeFileSync)(outPath, html, "utf8");
+    console.log(import_chalk11.default.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) {
@@ -1948,7 +1981,7 @@ Or specify a custom report:
           server.listen(port, () => {
             const addr = `http://localhost:${port}/`;
             console.log(
-              import_chalk10.default.cyan(`\u{1F310} Local visualization server running at ${addr}`)
+              import_chalk11.default.cyan(`\u{1F310} Local visualization server running at ${addr}`)
             );
             (0, import_child_process.spawn)(opener, [`"${addr}"`], { shell: true });
           });
@@ -1964,7 +1997,7 @@ Or specify a custom report:
       }
     }
   } catch (err) {
-    (0, import_core12.handleCLIError)(err, "Visualization");
+    (0, import_core14.handleCLIError)(err, "Visualization");
   }
 }
 var VISUALIZE_HELP_TEXT = `
@@ -1995,19 +2028,19 @@ NOTES:
 `;
 
 // src/commands/shared/standard-tool-actions.ts
-var import_chalk11 = __toESM(require("chalk"));
+var import_chalk12 = __toESM(require("chalk"));
 
 // src/commands/agent-grounding.ts
-var import_chalk12 = __toESM(require("chalk"));
-var import_core14 = require("@aiready/core");
+var import_chalk13 = __toESM(require("chalk"));
+var import_core16 = require("@aiready/core");
 
 // src/commands/testability.ts
-var import_chalk13 = __toESM(require("chalk"));
-var import_core15 = require("@aiready/core");
+var import_chalk14 = __toESM(require("chalk"));
+var import_core17 = require("@aiready/core");
 async function testabilityAction(directory, options) {
   const { analyzeTestability, calculateTestabilityScore } = await import("@aiready/testability");
-  const config = await (0, import_core15.loadConfig)(directory);
-  const merged = (0, import_core15.mergeConfigWithDefaults)(config, {
+  const config = await (0, import_core17.loadConfig)(directory);
+  const merged = (0, import_core17.mergeConfigWithDefaults)(config, {
     minCoverageRatio: 0.3
   });
   const report = await analyzeTestability({
@@ -2027,28 +2060,28 @@ async function testabilityAction(directory, options) {
     "blind-risk": "\u{1F480}"
   };
   const safetyColors = {
-    safe: import_chalk13.default.green,
-    "moderate-risk": import_chalk13.default.yellow,
-    "high-risk": import_chalk13.default.red,
-    "blind-risk": import_chalk13.default.bgRed.white
+    safe: import_chalk14.default.green,
+    "moderate-risk": import_chalk14.default.yellow,
+    "high-risk": import_chalk14.default.red,
+    "blind-risk": import_chalk14.default.bgRed.white
   };
   const safety = report.summary.aiChangeSafetyRating;
   const icon = safetyIcons[safety] ?? "\u2753";
-  const color = safetyColors[safety] ?? import_chalk13.default.white;
+  const color = safetyColors[safety] ?? import_chalk14.default.white;
   console.log(
-    `  \u{1F9EA} Testability:         ${import_chalk13.default.bold(scoring.score + "/100")} (${report.summary.rating})`
+    `  \u{1F9EA} Testability:         ${import_chalk14.default.bold(scoring.score + "/100")} (${report.summary.rating})`
   );
   console.log(
     `     AI Change Safety:  ${color(`${icon} ${safety.toUpperCase()}`)}`
   );
   console.log(
-    import_chalk13.default.dim(
+    import_chalk14.default.dim(
       `     Coverage: ${Math.round(report.summary.coverageRatio * 100)}%  (${report.rawData.testFiles} test / ${report.rawData.sourceFiles} source files)`
     )
   );
   if (safety === "blind-risk") {
     console.log(
-      import_chalk13.default.red.bold(
+      import_chalk14.default.red.bold(
         "\n     \u26A0\uFE0F  NO TESTS \u2014 AI changes to this codebase are completely unverifiable!\n"
       )
     );
@@ -2060,7 +2093,7 @@ async function testabilityAction(directory, options) {
 var import_cli = require("@aiready/change-amplification/dist/cli.js");
 
 // src/commands/bug.ts
-var import_chalk14 = __toESM(require("chalk"));
+var import_chalk15 = __toESM(require("chalk"));
 var import_child_process2 = require("child_process");
 async function bugAction(message, options) {
   const repoUrl = "https://github.com/caopengau/aiready-cli";
@@ -2078,35 +2111,35 @@ Generated via AIReady CLI 'bug' command.
 Type: ${type}
     `.trim();
     if (options.submit) {
-      console.log(import_chalk14.default.blue("\u{1F680} Submitting issue via GitHub CLI...\n"));
+      console.log(import_chalk15.default.blue("\u{1F680} Submitting issue via GitHub CLI...\n"));
       try {
         (0, import_child_process2.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 = (0, import_child_process2.execSync)(command, { encoding: "utf8" }).trim();
-        console.log(import_chalk14.default.green("\u2705 Issue Created Successfully!"));
-        console.log(import_chalk14.default.cyan(output));
+        console.log(import_chalk15.default.green("\u2705 Issue Created Successfully!"));
+        console.log(import_chalk15.default.cyan(output));
         return;
       } catch {
-        console.error(import_chalk14.default.red("\n\u274C Failed to submit via gh CLI."));
+        console.error(import_chalk15.default.red("\n\u274C Failed to submit via gh CLI."));
         console.log(
-          import_chalk14.default.yellow(
+          import_chalk15.default.yellow(
             '   Make sure gh is installed and run "gh auth login".\n'
           )
         );
-        console.log(import_chalk14.default.dim("   Falling back to URL generation..."));
+        console.log(import_chalk15.default.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(import_chalk14.default.green("\u{1F680} Issue Draft Prepared!\n"));
-    console.log(import_chalk14.default.bold("Title:  ") + title);
-    console.log(import_chalk14.default.bold("Type:   ") + type);
-    console.log(import_chalk14.default.bold("\nClick the link below to submit this issue:"));
-    console.log(import_chalk14.default.cyan(fullUrl));
-    console.log(import_chalk14.default.bold("\n\u{1F916} [FOR AI AGENTS]:"));
-    console.log(import_chalk14.default.dim("   You have successfully prepared a report."));
+    console.log(import_chalk15.default.green("\u{1F680} Issue Draft Prepared!\n"));
+    console.log(import_chalk15.default.bold("Title:  ") + title);
+    console.log(import_chalk15.default.bold("Type:   ") + type);
+    console.log(import_chalk15.default.bold("\nClick the link below to submit this issue:"));
+    console.log(import_chalk15.default.cyan(fullUrl));
+    console.log(import_chalk15.default.bold("\n\u{1F916} [FOR AI AGENTS]:"));
+    console.log(import_chalk15.default.dim("   You have successfully prepared a report."));
     console.log(
-      import_chalk14.default.dim(
+      import_chalk15.default.dim(
         "   Please present the URL above to the user so they can finalize the submission."
       )
     );
@@ -2115,14 +2148,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(import_chalk14.default.blue("\u{1F4AC} Feedback & Bug Reports\n"));
-  console.log(`  Report a Bug:        ${import_chalk14.default.cyan(bugUrl)}`);
-  console.log(`  Request a Feature:   ${import_chalk14.default.cyan(featureUrl)}`);
-  console.log(`  Suggest a Metric:    ${import_chalk14.default.cyan(metricUrl)}`);
-  console.log(import_chalk14.default.bold("\n\u{1F916} [FOR AI AGENTS]:"));
-  console.log(import_chalk14.default.dim("   To prepare a specific report, run:"));
+  console.log(import_chalk15.default.blue("\u{1F4AC} Feedback & Bug Reports\n"));
+  console.log(`  Report a Bug:        ${import_chalk15.default.cyan(bugUrl)}`);
+  console.log(`  Request a Feature:   ${import_chalk15.default.cyan(featureUrl)}`);
+  console.log(`  Suggest a Metric:    ${import_chalk15.default.cyan(metricUrl)}`);
+  console.log(import_chalk15.default.bold("\n\u{1F916} [FOR AI AGENTS]:"));
+  console.log(import_chalk15.default.dim("   To prepare a specific report, run:"));
   console.log(
-    import_chalk14.default.cyan(
+    import_chalk15.default.cyan(
       '   aiready bug "your description here" --type bug|feature|metric'
     )
   );
@@ -2139,10 +2172,10 @@ EXAMPLES:
 var import_meta = {};
 var getDirname = () => {
   if (typeof __dirname !== "undefined") return __dirname;
-  return (0, import_path9.dirname)((0, import_url.fileURLToPath)(import_meta.url));
+  return (0, import_path7.dirname)((0, import_url.fileURLToPath)(import_meta.url));
 };
 var packageJson = JSON.parse(
-  (0, import_fs7.readFileSync)((0, import_path9.join)(getDirname(), "../package.json"), "utf8")
+  (0, import_fs8.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(
@@ -2197,7 +2230,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(
@@ -2223,7 +2256,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(