@aiready/cli 0.14.4 → 0.14.6

package/dist/chunk-MVEYWWJM.mjs

@@ -0,0 +1,1894 @@
+import {
+  __require,
+  analyzeUnified,
+  scoreUnified
+} from "./chunk-VOKP7FGM.mjs";
+
+// src/commands/scan.ts
+import chalk4 from "chalk";
+import { writeFileSync, readFileSync as readFileSync2 } from "fs";
+import { resolve as resolvePath3 } from "path";
+import {
+  loadMergedConfig,
+  handleJSONOutput,
+  handleCLIError as handleCLIError2,
+  resolveOutputPath,
+  getRepoMetadata,
+  calculateTokenBudget,
+  ToolName,
+  emitIssuesAsAnnotations
+} from "@aiready/core";
+
+// src/utils/helpers.ts
+import { resolve as resolvePath } from "path";
+import { existsSync, readFileSync } from "fs";
+import chalk from "chalk";
+import { loadConfig, mergeConfigWithDefaults } from "@aiready/core";
+import { findLatestReport } from "@aiready/core";
+function getReportTimestamp() {
+  const now = /* @__PURE__ */ new Date();
+  const pad = (n) => String(n).padStart(2, "0");
+  return `${now.getFullYear()}${pad(now.getMonth() + 1)}${pad(now.getDate())}-${pad(now.getHours())}${pad(now.getMinutes())}${pad(now.getSeconds())}`;
+}
+async function warnIfGraphCapExceeded(report, dirPath) {
+  try {
+    const { loadConfig: loadConfig4 } = await import("@aiready/core");
+    void loadConfig4;
+    let graphConfig = { maxNodes: 400, maxEdges: 600 };
+    const configPath = resolvePath(dirPath, "aiready.json");
+    if (existsSync(configPath)) {
+      try {
+        const rawConfig = JSON.parse(readFileSync(configPath, "utf8"));
+        if (rawConfig.visualizer?.graph) {
+          graphConfig = {
+            maxNodes: rawConfig.visualizer.graph.maxNodes ?? graphConfig.maxNodes,
+            maxEdges: rawConfig.visualizer.graph.maxEdges ?? graphConfig.maxEdges
+          };
+        }
+      } catch (err) {
+        void err;
+      }
+    }
+    const nodeCount = (report.context?.length || 0) + (report.patterns?.length || 0);
+    const edgeCount = report.context?.reduce((sum, ctx) => {
+      const relCount = ctx.relatedFiles?.length || 0;
+      const depCount = ctx.dependencies?.length || 0;
+      return sum + relCount + depCount;
+    }, 0) || 0;
+    if (nodeCount > graphConfig.maxNodes || edgeCount > graphConfig.maxEdges) {
+      console.log("");
+      console.log(
+        chalk.yellow(`\u26A0\uFE0F  Graph may be truncated at visualization time:`)
+      );
+      if (nodeCount > graphConfig.maxNodes) {
+        console.log(
+          chalk.dim(`   \u2022 Nodes: ${nodeCount} > limit ${graphConfig.maxNodes}`)
+        );
+      }
+      if (edgeCount > graphConfig.maxEdges) {
+        console.log(
+          chalk.dim(`   \u2022 Edges: ${edgeCount} > limit ${graphConfig.maxEdges}`)
+        );
+      }
+      console.log(chalk.dim(`   To increase limits, add to aiready.json:`));
+      console.log(chalk.dim(`   {`));
+      console.log(chalk.dim(`     "visualizer": {`));
+      console.log(
+        chalk.dim(`       "graph": { "maxNodes": 2000, "maxEdges": 5000 }`)
+      );
+      console.log(chalk.dim(`     }`));
+      console.log(chalk.dim(`   }`));
+    }
+  } catch (err) {
+    void err;
+  }
+}
+function generateMarkdownReport(report, elapsedTime) {
+  let markdown = `# Consistency Analysis Report
+
+`;
+  markdown += `**Generated:** ${(/* @__PURE__ */ new Date()).toISOString()}
+`;
+  markdown += `**Analysis Time:** ${elapsedTime}s
+
+`;
+  markdown += `## Summary
+
+`;
+  markdown += `- **Files Analyzed:** ${report.summary.filesAnalyzed}
+`;
+  markdown += `- **Total Issues:** ${report.summary.totalIssues}
+`;
+  markdown += `  - Naming: ${report.summary.namingIssues}
+`;
+  markdown += `  - Patterns: ${report.summary.patternIssues}
+
+`;
+  if (report.recommendations.length > 0) {
+    markdown += `## Recommendations
+
+`;
+    report.recommendations.forEach((rec, i) => {
+      markdown += `${i + 1}. ${rec}
+`;
+    });
+  }
+  return markdown;
+}
+async function loadMergedToolConfig(directory, defaults) {
+  const config = await loadConfig(directory);
+  return mergeConfigWithDefaults(config, defaults);
+}
+function buildCommonScanOptions(directory, options, extras = {}) {
+  return {
+    rootDir: directory,
+    include: options.include,
+    exclude: options.exclude,
+    ...extras
+  };
+}
+async function runConfiguredToolCommand(params) {
+  const merged = await loadMergedToolConfig(params.directory, params.defaults);
+  const report = await params.analyze(
+    buildCommonScanOptions(
+      params.directory,
+      params.options,
+      params.getExtras(params.options, merged)
+    )
+  );
+  return {
+    report,
+    scoring: params.score(report)
+  };
+}
+
+// src/commands/report-formatter.ts
+import chalk2 from "chalk";
+import {
+  Severity,
+  formatScore,
+  getRating,
+  getRatingDisplay
+} from "@aiready/core";
+function printScanSummary(results, startTime) {
+  console.log(chalk2.cyan("\n=== AIReady Run Summary ==="));
+  console.log(
+    `  Total issues (all tools): ${chalk2.bold(String(results.summary.totalIssues || 0))}`
+  );
+  console.log(
+    `  Execution time: ${chalk2.bold(((Date.now() - startTime) / 1e3).toFixed(2) + "s")}`
+  );
+}
+function printBusinessImpact(roi, unifiedBudget) {
+  console.log(chalk2.bold("\n\u{1F4B0} Business Impact Analysis (Monthly)"));
+  console.log(
+    `  Potential Savings: ${chalk2.green(chalk2.bold("$" + roi.monthlySavings.toLocaleString()))}`
+  );
+  console.log(
+    `  Productivity Gain: ${chalk2.cyan(chalk2.bold(roi.productivityGainHours + "h"))} (est. dev time)`
+  );
+  console.log(
+    `  Context Efficiency: ${chalk2.yellow((unifiedBudget.efficiencyRatio * 100).toFixed(0) + "%")}`
+  );
+  console.log(
+    `  Annual Value: ${chalk2.bold("$" + roi.annualValue.toLocaleString())} (ROI Prediction)`
+  );
+}
+function printScoring(scoringResult, scoringProfile) {
+  console.log(chalk2.bold("\n\u{1F4CA} AI Readiness Overall Score"));
+  console.log(`  ${formatScore(scoringResult)}`);
+  console.log(chalk2.dim(`  (Scoring Profile: ${scoringProfile})`));
+  if (scoringResult.breakdown) {
+    console.log(chalk2.bold("\nTool breakdown:"));
+    scoringResult.breakdown.forEach((tool) => {
+      const rating = getRating(tool.score);
+      const emoji = getRatingDisplay(rating).emoji;
+      console.log(
+        `  - ${tool.toolName}: ${tool.score}/100 (${rating}) ${emoji}`
+      );
+    });
+    const allRecs = scoringResult.breakdown.flatMap(
+      (t) => (t.recommendations || []).map((r) => ({ ...r, tool: t.toolName }))
+    ).sort((a, b) => b.estimatedImpact - a.estimatedImpact).slice(0, 3);
+    if (allRecs.length > 0) {
+      console.log(chalk2.bold("\n\u{1F3AF} Top Actionable Recommendations:"));
+      allRecs.forEach((rec, i) => {
+        const priorityIcon = rec.priority === "high" ? "\u{1F534}" : rec.priority === "medium" ? "\u{1F7E1}" : "\u{1F535}";
+        console.log(`  ${i + 1}. ${priorityIcon} ${chalk2.bold(rec.action)}`);
+        console.log(
+          `     Impact: ${chalk2.green(`+${rec.estimatedImpact} points`)} to ${rec.tool}`
+        );
+      });
+    }
+  }
+}
+function mapToUnifiedReport(res, scoring) {
+  const allResults = [];
+  const totalFilesSet = /* @__PURE__ */ new Set();
+  let criticalCount = 0;
+  let majorCount = 0;
+  res.summary.toolsRun.forEach((toolId) => {
+    const spokeRes = res[toolId];
+    if (!spokeRes || !spokeRes.results) return;
+    spokeRes.results.forEach((r) => {
+      totalFilesSet.add(r.fileName);
+      allResults.push(r);
+      r.issues?.forEach((i) => {
+        if (i.severity === Severity.Critical || i.severity === "critical")
+          criticalCount++;
+        if (i.severity === Severity.Major || i.severity === "major")
+          majorCount++;
+      });
+    });
+  });
+  return {
+    ...res,
+    results: allResults,
+    summary: {
+      ...res.summary,
+      totalFiles: totalFilesSet.size,
+      criticalIssues: criticalCount,
+      majorIssues: majorCount
+    },
+    scoring
+  };
+}
+
+// src/commands/upload.ts
+import fs from "fs";
+import { resolve as resolvePath2 } from "path";
+import chalk3 from "chalk";
+import { handleCLIError } from "@aiready/core";
+async function uploadAction(file, options) {
+  const startTime = Date.now();
+  const filePath = resolvePath2(process.cwd(), file);
+  const serverUrl = options.server || process.env.AIREADY_SERVER || "https://dev.platform.getaiready.dev";
+  const apiKey = options.apiKey || process.env.AIREADY_API_KEY;
+  if (!apiKey) {
+    console.error(chalk3.red("\u274C API Key is required for upload."));
+    console.log(
+      chalk3.dim(
+        "   Set AIREADY_API_KEY environment variable or use --api-key flag."
+      )
+    );
+    console.log(
+      chalk3.dim(
+        "   Get an API key from https://platform.getaiready.dev/dashboard"
+      )
+    );
+    process.exit(1);
+  }
+  if (!fs.existsSync(filePath)) {
+    console.error(chalk3.red(`\u274C File not found: ${filePath}`));
+    process.exit(1);
+  }
+  try {
+    console.log(chalk3.blue(`\u{1F680} Uploading report to ${serverUrl}...`));
+    console.log(chalk3.dim(`   Reading report from ${filePath}...`));
+    const reportContent = fs.readFileSync(filePath, "utf-8");
+    const reportData = JSON.parse(reportContent);
+    console.log(chalk3.dim(`   Successfully parsed report JSON.`));
+    const repoId = options.repoId || reportData.repository?.repoId;
+    const response = await fetch(`${serverUrl}/api/analysis/upload`, {
+      method: "POST",
+      headers: {
+        "Content-Type": "application/json",
+        Authorization: `Bearer ${apiKey}`
+      },
+      body: JSON.stringify({
+        data: reportData,
+        repoId
+        // Might be null, server will handle mapping
+      })
+    });
+    const contentType = response.headers.get("content-type");
+    let uploadResult = {};
+    if (contentType?.includes("application/json")) {
+      uploadResult = await response.json();
+    } else {
+      const text = await response.text();
+      uploadResult = { error: text || response.statusText };
+    }
+    if (!response.ok) {
+      console.error(
+        chalk3.red(
+          `\u274C Upload failed: ${uploadResult.error || response.statusText}`
+        )
+      );
+      if (contentType?.includes("text/html")) {
+        console.log(
+          chalk3.yellow(
+            "   Note: Received an HTML response. This often indicates a redirect (e.g., to a login page) or a server error."
+          )
+        );
+        if (uploadResult.error?.includes("Redirecting")) {
+          console.log(
+            chalk3.dim(
+              "   Detected redirect. Check if the API endpoint requires authentication or has changed."
+            )
+          );
+        }
+      }
+      if (response.status === 401) {
+        console.log(
+          chalk3.dim("   Hint: Your API key may be invalid or expired.")
+        );
+      }
+      process.exit(1);
+    }
+    const duration = ((Date.now() - startTime) / 1e3).toFixed(2);
+    console.log(chalk3.green(`
+\u2705 Upload successful! (${duration}s)`));
+    console.log(chalk3.cyan(`   View results: ${serverUrl}/dashboard`));
+    if (uploadResult.analysis) {
+      console.log(chalk3.dim(`   Analysis ID: ${uploadResult.analysis.id}`));
+      console.log(chalk3.dim(`   Score: ${uploadResult.analysis.aiScore}/100`));
+    }
+  } catch (error) {
+    handleCLIError(error, "Upload");
+  }
+}
+var uploadHelpText = `
+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.ts
+async function scanAction(directory, options) {
+  console.log(chalk4.blue("\u{1F680} Starting AIReady unified analysis...\n"));
+  const startTime = Date.now();
+  const resolvedDir = resolvePath3(process.cwd(), directory || ".");
+  const repoMetadata = getRepoMetadata(resolvedDir);
+  try {
+    const defaults = {
+      tools: [
+        "pattern-detect",
+        "context-analyzer",
+        "naming-consistency",
+        "ai-signal-clarity",
+        "agent-grounding",
+        "testability-index",
+        "doc-drift",
+        "dependency-health",
+        "change-amplification"
+      ],
+      include: void 0,
+      exclude: void 0,
+      output: {
+        format: "console",
+        file: void 0
+      }
+    };
+    let profileTools = options.tools ? options.tools.split(",").map((t) => t.trim()) : void 0;
+    if (options.profile) {
+      switch (options.profile.toLowerCase()) {
+        case "agentic":
+          profileTools = [
+            ToolName.AiSignalClarity,
+            ToolName.AgentGrounding,
+            ToolName.TestabilityIndex
+          ];
+          break;
+        case "cost":
+          profileTools = [ToolName.PatternDetect, ToolName.ContextAnalyzer];
+          break;
+        case "logic":
+          profileTools = [
+            ToolName.TestabilityIndex,
+            ToolName.NamingConsistency,
+            ToolName.ContextAnalyzer,
+            ToolName.PatternDetect,
+            ToolName.ChangeAmplification
+          ];
+          break;
+        case "ui":
+          profileTools = [
+            ToolName.NamingConsistency,
+            ToolName.ContextAnalyzer,
+            ToolName.PatternDetect,
+            ToolName.DocDrift,
+            ToolName.AiSignalClarity
+          ];
+          break;
+        case "security":
+          profileTools = [
+            ToolName.NamingConsistency,
+            ToolName.TestabilityIndex
+          ];
+          break;
+        case "onboarding":
+          profileTools = [
+            ToolName.ContextAnalyzer,
+            ToolName.NamingConsistency,
+            ToolName.AgentGrounding
+          ];
+          break;
+        default:
+          console.log(
+            chalk4.yellow(
+              `
+\u26A0\uFE0F  Unknown profile '${options.profile}'. Using defaults.`
+            )
+          );
+      }
+    }
+    const cliOverrides = {
+      include: options.include?.split(","),
+      exclude: options.exclude?.split(",")
+    };
+    if (profileTools) cliOverrides.tools = profileTools;
+    const baseOptions = await loadMergedConfig(
+      resolvedDir,
+      defaults,
+      cliOverrides
+    );
+    const finalOptions = { ...baseOptions };
+    if (baseOptions.tools.includes(ToolName.PatternDetect) || baseOptions.tools.includes("patterns")) {
+      const { getSmartDefaults } = await import("@aiready/pattern-detect");
+      const patternSmartDefaults = await getSmartDefaults(
+        resolvedDir,
+        finalOptions.toolConfigs?.[ToolName.PatternDetect] || {}
+      );
+      if (!finalOptions.toolConfigs) finalOptions.toolConfigs = {};
+      finalOptions.toolConfigs[ToolName.PatternDetect] = {
+        ...patternSmartDefaults,
+        ...finalOptions.toolConfigs[ToolName.PatternDetect]
+      };
+    }
+    console.log(chalk4.cyan("\n=== AIReady Run Preview ==="));
+    console.log(
+      chalk4.white("Tools to run:"),
+      (finalOptions.tools || []).join(", ")
+    );
+    const progressCallback = (event) => {
+      if (event.message) {
+        process.stdout.write(`\r\x1B[K   [${event.tool}] ${event.message}`);
+        return;
+      }
+      process.stdout.write("\r\x1B[K");
+      console.log(chalk4.cyan(`--- ${event.tool.toUpperCase()} RESULTS ---`));
+      const res = event.data;
+      if (res && res.summary) {
+        if (res.summary.totalIssues !== void 0)
+          console.log(`  Issues found: ${chalk4.bold(res.summary.totalIssues)}`);
+        if (res.summary.score !== void 0)
+          console.log(`  Tool Score: ${chalk4.bold(res.summary.score)}/100`);
+        if (res.summary.totalFiles !== void 0)
+          console.log(
+            `  Files analyzed: ${chalk4.bold(res.summary.totalFiles)}`
+          );
+      }
+    };
+    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(
+            readFileSync2(resolvePath3(process.cwd(), options.compareTo), "utf8")
+          );
+          const prevScore = prevReport.scoring?.overall || prevReport.scoring?.score;
+          if (typeof prevScore === "number") {
+            const diff = scoringResult.overall - prevScore;
+            const diffStr = diff > 0 ? `+${diff}` : String(diff);
+            if (diff > 0)
+              console.log(
+                chalk4.green(
+                  `  \u{1F4C8} Trend: ${diffStr} compared to ${options.compareTo} (${prevScore} \u2192 ${scoringResult.overall})`
+                )
+              );
+            else if (diff < 0)
+              console.log(
+                chalk4.red(
+                  `  \u{1F4C9} Trend: ${diffStr} compared to ${options.compareTo} (${prevScore} \u2192 ${scoringResult.overall})`
+                )
+              );
+            else
+              console.log(
+                chalk4.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 = 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 || "claude-3-5-sonnet";
+        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(
+      chalk4.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(chalk4.dim("\u{1F4AC} Found a bug or have a metric idea?"));
+    console.log(chalk4.dim("\u{1F449} Copy/paste this to your AI agent:"));
+    console.log(
+      chalk4.cyan(
+        `   "Any feedback for the tools? Please use 'aiready bug' to report \u2764\uFE0F"`
+      )
+    );
+    console.log(
+      chalk4.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"
+      )
+    );
+    const outputData = {
+      ...mapToUnifiedReport(results, scoringResult),
+      repository: repoMetadata
+    };
+    const outputFormat = options.output || finalOptions.output?.format || "console";
+    const outputPath = resolveOutputPath(
+      options.outputFile || finalOptions.output?.file,
+      `aiready-report-${getReportTimestamp()}.json`,
+      resolvedDir
+    );
+    if (outputFormat === "json") {
+      handleJSONOutput(
+        outputData,
+        outputPath,
+        `\u2705 Report saved to ${outputPath}`
+      );
+    } else {
+      try {
+        writeFileSync(outputPath, JSON.stringify(outputData, null, 2));
+        console.log(chalk4.dim(`\u2705 Report auto-persisted to ${outputPath}`));
+      } catch (err) {
+        void err;
+      }
+    }
+    if (options.upload) {
+      await uploadAction(outputPath, {
+        apiKey: options.apiKey,
+        server: options.server
+      });
+    }
+    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(
+          chalk4.cyan(
+            `
+\u{1F4DD} Emitting GitHub Action annotations for ${report.results.length} issues...`
+          )
+        );
+        emitIssuesAsAnnotations(report.results);
+      }
+      if (threshold && scoringResult.overall < threshold) {
+        shouldFail = true;
+        failReason = `Score ${scoringResult.overall} < threshold ${threshold}`;
+      }
+      if (failOnLevel !== "none") {
+        if (failOnLevel === "critical" && report.summary.criticalIssues > 0) {
+          shouldFail = true;
+          failReason = `Found ${report.summary.criticalIssues} critical issues`;
+        } else if (failOnLevel === "major" && report.summary.criticalIssues + report.summary.majorIssues > 0) {
+          shouldFail = true;
+          failReason = `Found ${report.summary.criticalIssues} critical and ${report.summary.majorIssues} major issues`;
+        }
+      }
+      if (shouldFail) {
+        console.log(chalk4.red(`
+\u{1F6AB} SCAN FAILED: ${failReason}`));
+        process.exit(1);
+      } else {
+        console.log(chalk4.green("\n\u2705 SCAN PASSED"));
+      }
+    }
+  } catch (error) {
+    handleCLIError2(error, "Analysis");
+  }
+}
+var scanHelpText = `...`;
+
+// src/commands/init.ts
+import { writeFileSync as writeFileSync2, existsSync as existsSync2 } from "fs";
+import { join } from "path";
+import chalk5 from "chalk";
+import { ToolName as ToolName2 } from "@aiready/core";
+async function initAction(options) {
+  const fileExt = options.format === "js" ? "js" : "json";
+  const fileName = fileExt === "js" ? "aiready.config.js" : "aiready.json";
+  const filePath = join(process.cwd(), fileName);
+  if (existsSync2(filePath) && !options.force) {
+    console.error(
+      chalk5.red(`Error: ${fileName} already exists. Use --force to overwrite.`)
+    );
+    process.exit(1);
+  }
+  const baseConfig = {
+    scan: {
+      include: [
+        "src/**/*.ts",
+        "src/**/*.js",
+        "lib/**/*.ts",
+        "packages/*/src/**/*.ts"
+      ],
+      exclude: [
+        "**/node_modules/**",
+        "**/dist/**",
+        "**/build/**",
+        "**/*.test.ts",
+        "**/*.spec.ts"
+      ],
+      tools: [
+        ToolName2.PatternDetect,
+        ToolName2.ContextAnalyzer,
+        ToolName2.NamingConsistency,
+        ToolName2.AiSignalClarity,
+        ToolName2.AgentGrounding,
+        ToolName2.TestabilityIndex,
+        ToolName2.DocDrift,
+        ToolName2.DependencyHealth,
+        ToolName2.ChangeAmplification
+      ]
+    },
+    tools: {
+      [ToolName2.PatternDetect]: {
+        minSimilarity: 0.8,
+        minLines: 5,
+        ...options.full ? {
+          batchSize: 50,
+          approx: true,
+          minSharedTokens: 10,
+          maxCandidatesPerBlock: 100
+        } : {}
+      },
+      [ToolName2.ContextAnalyzer]: {
+        maxContextBudget: 128e3,
+        minCohesion: 0.6,
+        ...options.full ? {
+          maxDepth: 7,
+          maxFragmentation: 0.4,
+          focus: "all",
+          includeNodeModules: false
+        } : {}
+      },
+      [ToolName2.NamingConsistency]: {
+        shortWords: ["id", "db", "ui", "ai"],
+        ...options.full ? { acceptedAbbreviations: [], disableChecks: [] } : {}
+      },
+      [ToolName2.AiSignalClarity]: {
+        checkMagicLiterals: true,
+        checkBooleanTraps: true,
+        checkAmbiguousNames: true,
+        checkUndocumentedExports: true,
+        ...options.full ? { checkImplicitSideEffects: false, checkDeepCallbacks: false } : {}
+      },
+      ...options.full ? {
+        [ToolName2.AgentGrounding]: {
+          maxRecommendedDepth: 5,
+          readmeStaleDays: 30
+        },
+        [ToolName2.TestabilityIndex]: {
+          minCoverageRatio: 0.7,
+          testPatterns: ["**/*.test.ts", "**/__tests__/**"]
+        },
+        [ToolName2.DocDrift]: {
+          maxCommits: 50,
+          staleMonths: 3
+        },
+        [ToolName2.DependencyHealth]: {
+          trainingCutoffYear: 2023
+        }
+      } : {}
+    },
+    scoring: {
+      threshold: 70,
+      showBreakdown: true,
+      ...options.full ? { profile: "default" } : {}
+    },
+    ...options.full ? {
+      visualizer: {
+        groupingDirs: ["packages", "src", "lib"],
+        graph: {
+          maxNodes: 5e3,
+          maxEdges: 1e4
+        }
+      }
+    } : {}
+  };
+  const defaultConfig = baseConfig;
+  let content;
+  if (fileExt === "js") {
+    content = `/** @type {import('@aiready/core').AIReadyConfig} */
+module.exports = ${JSON.stringify(
+      defaultConfig,
+      null,
+      2
+    )};
+`;
+  } else {
+    content = JSON.stringify(defaultConfig, null, 2);
+  }
+  try {
+    writeFileSync2(filePath, content, "utf8");
+    console.log(
+      chalk5.green(`
+\u2705 Created default configuration: ${chalk5.bold(fileName)}`)
+    );
+    console.log(
+      chalk5.cyan("You can now fine-tune your settings and run AIReady with:")
+    );
+    console.log(chalk5.white(`  $ aiready scan
+`));
+  } catch (error) {
+    console.error(chalk5.red(`Failed to write configuration file: ${error}`));
+    process.exit(1);
+  }
+}
+
+// src/commands/patterns.ts
+import chalk6 from "chalk";
+import { resolve as resolvePath4 } from "path";
+import {
+  loadMergedConfig as loadMergedConfig2,
+  handleJSONOutput as handleJSONOutput2,
+  handleCLIError as handleCLIError3,
+  getElapsedTime,
+  resolveOutputPath as resolveOutputPath2,
+  formatToolScore
+} from "@aiready/core";
+async function patternsAction(directory, options) {
+  console.log(chalk6.blue("\u{1F50D} Analyzing patterns...\n"));
+  const startTime = Date.now();
+  const resolvedDir = resolvePath4(process.cwd(), directory || ".");
+  try {
+    const useSmartDefaults = !options.fullScan;
+    const defaults = {
+      useSmartDefaults,
+      include: void 0,
+      exclude: void 0,
+      output: {
+        format: "console",
+        file: void 0
+      }
+    };
+    if (!useSmartDefaults) {
+      defaults.minSimilarity = 0.4;
+      defaults.minLines = 5;
+    }
+    const cliOptions = {
+      minSimilarity: options.similarity ? parseFloat(options.similarity) : void 0,
+      minLines: options.minLines ? parseInt(options.minLines) : void 0,
+      useSmartDefaults,
+      include: options.include?.split(","),
+      exclude: options.exclude?.split(",")
+    };
+    if (options.maxCandidates) {
+      cliOptions.maxCandidatesPerBlock = parseInt(options.maxCandidates);
+    }
+    if (options.minSharedTokens) {
+      cliOptions.minSharedTokens = parseInt(options.minSharedTokens);
+    }
+    const finalOptions = await loadMergedConfig2(
+      resolvedDir,
+      defaults,
+      cliOptions
+    );
+    const { analyzePatterns, generateSummary, calculatePatternScore } = await import("@aiready/pattern-detect");
+    const { results, duplicates } = await analyzePatterns(
+      finalOptions
+    );
+    const elapsedTime = 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;
+    if (outputFormat === "json") {
+      const outputData = {
+        results,
+        summary: { ...summary, executionTime: parseFloat(elapsedTime) },
+        ...patternScore && { scoring: patternScore }
+      };
+      const outputPath = resolveOutputPath2(
+        userOutputFile,
+        `aiready-report-${getReportTimestamp()}.json`,
+        resolvedDir
+      );
+      handleJSONOutput2(
+        outputData,
+        outputPath,
+        `\u2705 Results saved to ${outputPath}`
+      );
+    } else {
+      const terminalWidth = process.stdout.columns || 80;
+      const dividerWidth = Math.min(60, terminalWidth - 2);
+      const divider = "\u2501".repeat(dividerWidth);
+      console.log(chalk6.cyan(divider));
+      console.log(chalk6.bold.white("  PATTERN ANALYSIS SUMMARY"));
+      console.log(chalk6.cyan(divider) + "\n");
+      console.log(
+        chalk6.white(`\u{1F4C1} Files analyzed: ${chalk6.bold(results.length)}`)
+      );
+      console.log(
+        chalk6.yellow(
+          `\u26A0  Duplicate patterns found: ${chalk6.bold(summary.totalPatterns)}`
+        )
+      );
+      console.log(
+        chalk6.red(
+          `\u{1F4B0} Token cost (wasted): ${chalk6.bold(summary.totalTokenCost.toLocaleString())}`
+        )
+      );
+      console.log(
+        chalk6.gray(`\u23F1  Analysis time: ${chalk6.bold(elapsedTime + "s")}`)
+      );
+      const sortedTypes = Object.entries(summary.patternsByType || {}).filter(([, count]) => count > 0).sort(([, a], [, b]) => b - a);
+      if (sortedTypes.length > 0) {
+        console.log(chalk6.cyan("\n" + divider));
+        console.log(chalk6.bold.white("  PATTERNS BY TYPE"));
+        console.log(chalk6.cyan(divider) + "\n");
+        sortedTypes.forEach(([type, count]) => {
+          console.log(`  ${chalk6.white(type.padEnd(15))} ${chalk6.bold(count)}`);
+        });
+      }
+      if (summary.totalPatterns > 0 && duplicates.length > 0) {
+        console.log(chalk6.cyan("\n" + divider));
+        console.log(chalk6.bold.white("  TOP DUPLICATE PATTERNS"));
+        console.log(chalk6.cyan(divider) + "\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";
+          const severityIcon = dup.similarity > 0.95 ? "\u{1F534}" : dup.similarity > 0.9 ? "\u{1F7E1}" : "\u{1F535}";
+          const file1Name = dup.file1.split("/").pop() || dup.file1;
+          const file2Name = dup.file2.split("/").pop() || dup.file2;
+          console.log(
+            `${severityIcon} ${severity}: ${chalk6.bold(file1Name)} \u2194 ${chalk6.bold(file2Name)}`
+          );
+          console.log(
+            `   Similarity: ${chalk6.bold(Math.round(dup.similarity * 100) + "%")} | Wasted: ${chalk6.bold(dup.tokenCost.toLocaleString())} tokens each`
+          );
+          console.log(
+            `   Lines: ${chalk6.cyan(dup.line1 + "-" + dup.endLine1)} \u2194 ${chalk6.cyan(dup.line2 + "-" + dup.endLine2)}
+`
+          );
+        });
+      } else {
+        console.log(
+          chalk6.green("\n\u2728 Great! No duplicate patterns detected.\n")
+        );
+      }
+      if (patternScore) {
+        console.log(chalk6.cyan(divider));
+        console.log(chalk6.bold.white("  AI READINESS SCORE (Patterns)"));
+        console.log(chalk6.cyan(divider) + "\n");
+        console.log(formatToolScore(patternScore));
+        console.log();
+      }
+    }
+  } catch (error) {
+    handleCLIError3(error, "Pattern analysis");
+  }
+}
+var patternsHelpText = `
+EXAMPLES:
+  $ aiready patterns                                 # Default analysis
+  $ aiready patterns --similarity 0.6               # Stricter matching
+  $ aiready patterns --min-lines 10                 # Larger patterns only
+`;
+
+// src/commands/context.ts
+import chalk7 from "chalk";
+import { resolve as resolvePath5 } from "path";
+import {
+  loadMergedConfig as loadMergedConfig3,
+  handleJSONOutput as handleJSONOutput3,
+  handleCLIError as handleCLIError4,
+  getElapsedTime as getElapsedTime2,
+  resolveOutputPath as resolveOutputPath3,
+  formatToolScore as formatToolScore2
+} from "@aiready/core";
+async function contextAction(directory, options) {
+  console.log(chalk7.blue("\u{1F9E0} Analyzing context costs...\n"));
+  const startTime = Date.now();
+  const resolvedDir = resolvePath5(process.cwd(), directory || ".");
+  try {
+    const defaults = {
+      maxDepth: 5,
+      maxContextBudget: 1e4,
+      include: void 0,
+      exclude: void 0,
+      output: {
+        format: "console",
+        file: void 0
+      }
+    };
+    const baseOptions = await loadMergedConfig3(resolvedDir, defaults, {
+      maxDepth: options.maxDepth ? parseInt(options.maxDepth) : void 0,
+      maxContextBudget: options.maxContext ? parseInt(options.maxContext) : void 0,
+      include: options.include?.split(","),
+      exclude: options.exclude?.split(",")
+    });
+    let finalOptions = { ...baseOptions };
+    const { getSmartDefaults } = await import("@aiready/context-analyzer");
+    const contextSmartDefaults = await getSmartDefaults(
+      resolvedDir,
+      baseOptions
+    );
+    finalOptions = { ...contextSmartDefaults, ...finalOptions };
+    console.log("\u{1F4CB} Configuration:");
+    console.log(`   Max depth: ${finalOptions.maxDepth}`);
+    console.log(`   Max context budget: ${finalOptions.maxContextBudget}`);
+    console.log(
+      `   Min cohesion: ${(finalOptions.minCohesion * 100).toFixed(1)}%`
+    );
+    console.log(
+      `   Max fragmentation: ${(finalOptions.maxFragmentation * 100).toFixed(1)}%`
+    );
+    console.log(`   Analysis focus: ${finalOptions.focus}`);
+    console.log("");
+    const { analyzeContext, generateSummary, calculateContextScore } = await import("@aiready/context-analyzer");
+    const results = await analyzeContext(finalOptions);
+    const elapsedTime = getElapsedTime2(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;
+    if (outputFormat === "json") {
+      const outputData = {
+        results,
+        summary: { ...summary, executionTime: parseFloat(elapsedTime) },
+        ...contextScore && { scoring: contextScore }
+      };
+      const outputPath = resolveOutputPath3(
+        userOutputFile,
+        `aiready-report-${getReportTimestamp()}.json`,
+        resolvedDir
+      );
+      handleJSONOutput3(
+        outputData,
+        outputPath,
+        `\u2705 Results saved to ${outputPath}`
+      );
+    } else {
+      const terminalWidth = process.stdout.columns || 80;
+      const dividerWidth = Math.min(60, terminalWidth - 2);
+      const divider = "\u2501".repeat(dividerWidth);
+      console.log(chalk7.cyan(divider));
+      console.log(chalk7.bold.white("  CONTEXT ANALYSIS SUMMARY"));
+      console.log(chalk7.cyan(divider) + "\n");
+      console.log(
+        chalk7.white(`\u{1F4C1} Files analyzed: ${chalk7.bold(summary.totalFiles)}`)
+      );
+      console.log(
+        chalk7.white(
+          `\u{1F4CA} Total tokens: ${chalk7.bold(summary.totalTokens.toLocaleString())}`
+        )
+      );
+      console.log(
+        chalk7.yellow(
+          `\u{1F4B0} Avg context budget: ${chalk7.bold(summary.avgContextBudget.toFixed(0))} tokens/file`
+        )
+      );
+      console.log(
+        chalk7.white(`\u23F1  Analysis time: ${chalk7.bold(elapsedTime + "s")}
+`)
+      );
+      const totalIssues = summary.criticalIssues + summary.majorIssues + summary.minorIssues;
+      if (totalIssues > 0) {
+        console.log(chalk7.bold("\u26A0\uFE0F  Issues Found:\n"));
+        if (summary.criticalIssues > 0) {
+          console.log(
+            chalk7.red(`   \u{1F534} Critical: ${chalk7.bold(summary.criticalIssues)}`)
+          );
+        }
+        if (summary.majorIssues > 0) {
+          console.log(
+            chalk7.yellow(`   \u{1F7E1} Major: ${chalk7.bold(summary.majorIssues)}`)
+          );
+        }
+        if (summary.minorIssues > 0) {
+          console.log(
+            chalk7.blue(`   \u{1F535} Minor: ${chalk7.bold(summary.minorIssues)}`)
+          );
+        }
+        console.log(
+          chalk7.green(
+            `
+   \u{1F4A1} Potential savings: ${chalk7.bold(summary.totalPotentialSavings.toLocaleString())} tokens
+`
+          )
+        );
+      } else {
+        console.log(chalk7.green("\u2705 No significant issues found!\n"));
+      }
+      if (summary.deepFiles.length > 0) {
+        console.log(chalk7.bold("\u{1F4CF} Deep Import Chains:\n"));
+        console.log(
+          chalk7.gray(`   Average depth: ${summary.avgImportDepth.toFixed(1)}`)
+        );
+        console.log(
+          chalk7.gray(`   Maximum depth: ${summary.maxImportDepth}
+`)
+        );
+        summary.deepFiles.slice(0, 10).forEach((item) => {
+          const fileName = item.file.split("/").slice(-2).join("/");
+          console.log(
+            `   ${chalk7.cyan("\u2192")} ${chalk7.white(fileName)} ${chalk7.dim(`(depth: ${item.depth})`)}`
+          );
+        });
+        console.log();
+      }
+      if (summary.fragmentedModules.length > 0) {
+        console.log(chalk7.bold("\u{1F9E9} Fragmented Modules:\n"));
+        console.log(
+          chalk7.gray(
+            `   Average fragmentation: ${(summary.avgFragmentation * 100).toFixed(0)}%
+`
+          )
+        );
+        summary.fragmentedModules.slice(0, 10).forEach((module) => {
+          console.log(
+            `   ${chalk7.yellow("\u25CF")} ${chalk7.white(module.domain)} - ${chalk7.dim(`${module.files.length} files, ${(module.fragmentationScore * 100).toFixed(0)}% scattered`)}`
+          );
+          console.log(
+            chalk7.dim(
+              `     Token cost: ${module.totalTokens.toLocaleString()}, Cohesion: ${(module.avgCohesion * 100).toFixed(0)}%`
+            )
+          );
+        });
+        console.log();
+      }
+      if (summary.lowCohesionFiles.length > 0) {
+        console.log(chalk7.bold("\u{1F500} Low Cohesion Files:\n"));
+        console.log(
+          chalk7.gray(
+            `   Average cohesion: ${(summary.avgCohesion * 100).toFixed(0)}%
+`
+          )
+        );
+        summary.lowCohesionFiles.slice(0, 10).forEach((item) => {
+          const fileName = item.file.split("/").slice(-2).join("/");
+          const scorePercent = (item.score * 100).toFixed(0);
+          const color = item.score < 0.4 ? chalk7.red : chalk7.yellow;
+          console.log(
+            `   ${color("\u25CB")} ${chalk7.white(fileName)} ${chalk7.dim(`(${scorePercent}% cohesion)`)}`
+          );
+        });
+        console.log();
+      }
+      if (summary.topExpensiveFiles.length > 0) {
+        console.log(chalk7.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" ? chalk7.red : item.severity === "major" ? chalk7.yellow : chalk7.blue;
+          console.log(
+            `   ${severityColor("\u25CF")} ${chalk7.white(fileName)} ${chalk7.dim(`(${item.contextBudget.toLocaleString()} tokens)`)}`
+          );
+        });
+        console.log();
+      }
+      if (contextScore) {
+        console.log(chalk7.cyan(divider));
+        console.log(chalk7.bold.white("  AI READINESS SCORE (Context)"));
+        console.log(chalk7.cyan(divider) + "\n");
+        console.log(formatToolScore2(contextScore));
+        console.log();
+      }
+    }
+  } catch (error) {
+    handleCLIError4(error, "Context analysis");
+  }
+}
+
+// src/commands/consistency.ts
+import chalk8 from "chalk";
+import { writeFileSync as writeFileSync3 } from "fs";
+import { resolve as resolvePath6 } from "path";
+import {
+  loadMergedConfig as loadMergedConfig4,
+  handleJSONOutput as handleJSONOutput4,
+  handleCLIError as handleCLIError5,
+  getElapsedTime as getElapsedTime3,
+  resolveOutputPath as resolveOutputPath4,
+  formatToolScore as formatToolScore3
+} from "@aiready/core";
+async function consistencyAction(directory, options) {
+  console.log(chalk8.blue("\u{1F50D} Analyzing consistency...\n"));
+  const startTime = Date.now();
+  const resolvedDir = resolvePath6(process.cwd(), directory || ".");
+  try {
+    const defaults = {
+      checkNaming: true,
+      checkPatterns: true,
+      minSeverity: "info",
+      include: void 0,
+      exclude: void 0,
+      output: {
+        format: "console",
+        file: void 0
+      }
+    };
+    const finalOptions = await loadMergedConfig4(resolvedDir, defaults, {
+      checkNaming: options.naming !== false,
+      checkPatterns: options.patterns !== false,
+      minSeverity: options.minSeverity,
+      include: options.include?.split(","),
+      exclude: options.exclude?.split(",")
+    });
+    const { analyzeConsistency, calculateConsistencyScore } = await import("@aiready/consistency");
+    const report = await analyzeConsistency(finalOptions);
+    const elapsedTime = getElapsedTime3(startTime);
+    let consistencyScore;
+    if (options.score) {
+      const issues = report.results?.flatMap((r) => r.issues) || [];
+      consistencyScore = calculateConsistencyScore(
+        issues,
+        report.summary.filesAnalyzed
+      );
+    }
+    const outputFormat = options.output || finalOptions.output?.format || "console";
+    const userOutputFile = options.outputFile || finalOptions.output?.file;
+    if (outputFormat === "json") {
+      const outputData = {
+        ...report,
+        summary: {
+          ...report.summary,
+          executionTime: parseFloat(elapsedTime)
+        },
+        ...consistencyScore && { scoring: consistencyScore }
+      };
+      const outputPath = resolveOutputPath4(
+        userOutputFile,
+        `aiready-report-${getReportTimestamp()}.json`,
+        resolvedDir
+      );
+      handleJSONOutput4(
+        outputData,
+        outputPath,
+        `\u2705 Results saved to ${outputPath}`
+      );
+    } else if (outputFormat === "markdown") {
+      const markdown = generateMarkdownReport(report, elapsedTime);
+      const outputPath = resolveOutputPath4(
+        userOutputFile,
+        `aiready-report-${getReportTimestamp()}.md`,
+        resolvedDir
+      );
+      writeFileSync3(outputPath, markdown);
+      console.log(chalk8.green(`\u2705 Report saved to ${outputPath}`));
+    } else {
+      console.log(chalk8.bold("\n\u{1F4CA} Summary\n"));
+      console.log(
+        `Files Analyzed: ${chalk8.cyan(report.summary.filesAnalyzed)}`
+      );
+      console.log(`Total Issues: ${chalk8.yellow(report.summary.totalIssues)}`);
+      console.log(`  Naming: ${chalk8.yellow(report.summary.namingIssues)}`);
+      console.log(`  Patterns: ${chalk8.yellow(report.summary.patternIssues)}`);
+      console.log(
+        `  Architecture: ${chalk8.yellow(report.summary.architectureIssues || 0)}`
+      );
+      console.log(`Analysis Time: ${chalk8.gray(elapsedTime + "s")}
+`);
+      if (report.summary.totalIssues === 0) {
+        console.log(
+          chalk8.green(
+            "\u2728 No consistency issues found! Your codebase is well-maintained.\n"
+          )
+        );
+      } else {
+        const namingResults = report.results.filter(
+          (r) => r.issues.some((i) => i.category === "naming")
+        );
+        const patternResults = report.results.filter(
+          (r) => r.issues.some((i) => i.category === "patterns")
+        );
+        if (namingResults.length > 0) {
+          console.log(chalk8.bold("\u{1F3F7}\uFE0F  Naming Issues\n"));
+          let shown = 0;
+          for (const result of namingResults) {
+            if (shown >= 5) break;
+            for (const issue of result.issues) {
+              if (shown >= 5) break;
+              const severityColor = issue.severity === "critical" ? chalk8.red : issue.severity === "major" ? chalk8.yellow : issue.severity === "minor" ? chalk8.blue : chalk8.gray;
+              console.log(
+                `${severityColor(issue.severity.toUpperCase())} ${chalk8.dim(`${issue.location.file}:${issue.location.line}`)}`
+              );
+              console.log(`  ${issue.message}`);
+              if (issue.suggestion) {
+                console.log(
+                  `  ${chalk8.dim("\u2192")} ${chalk8.italic(issue.suggestion)}`
+                );
+              }
+              console.log();
+              shown++;
+            }
+          }
+          const remaining = namingResults.reduce((sum, r) => sum + r.issues.length, 0) - shown;
+          if (remaining > 0) {
+            console.log(chalk8.dim(`  ... and ${remaining} more issues
+`));
+          }
+        }
+        if (patternResults.length > 0) {
+          console.log(chalk8.bold("\u{1F504} Pattern Issues\n"));
+          let shown = 0;
+          for (const result of patternResults) {
+            if (shown >= 5) break;
+            for (const issue of result.issues) {
+              if (shown >= 5) break;
+              const severityColor = issue.severity === "critical" ? chalk8.red : issue.severity === "major" ? chalk8.yellow : issue.severity === "minor" ? chalk8.blue : chalk8.gray;
+              console.log(
+                `${severityColor(issue.severity.toUpperCase())} ${chalk8.dim(`${issue.location.file}:${issue.location.line}`)}`
+              );
+              console.log(`  ${issue.message}`);
+              if (issue.suggestion) {
+                console.log(
+                  `  ${chalk8.dim("\u2192")} ${chalk8.italic(issue.suggestion)}`
+                );
+              }
+              console.log();
+              shown++;
+            }
+          }
+          const remaining = patternResults.reduce((sum, r) => sum + r.issues.length, 0) - shown;
+          if (remaining > 0) {
+            console.log(chalk8.dim(`  ... and ${remaining} more issues
+`));
+          }
+        }
+        if (report.recommendations.length > 0) {
+          console.log(chalk8.bold("\u{1F4A1} Recommendations\n"));
+          report.recommendations.forEach((rec, i) => {
+            console.log(`${i + 1}. ${rec}`);
+          });
+          console.log();
+        }
+      }
+      if (consistencyScore) {
+        console.log(chalk8.bold("\n\u{1F4CA} AI Readiness Score (Consistency)\n"));
+        console.log(formatToolScore3(consistencyScore));
+        console.log();
+      }
+    }
+  } catch (error) {
+    handleCLIError5(error, "Consistency analysis");
+  }
+}
+
+// src/commands/visualize.ts
+import chalk9 from "chalk";
+import { writeFileSync as writeFileSync4, readFileSync as readFileSync3, existsSync as existsSync3, copyFileSync } from "fs";
+import { resolve as resolvePath7 } from "path";
+import { spawn } from "child_process";
+import { handleCLIError as handleCLIError6 } from "@aiready/core";
+import { generateHTML, findLatestReport as findLatestReport2 } from "@aiready/core";
+async function visualizeAction(directory, options) {
+  try {
+    const dirPath = resolvePath7(process.cwd(), directory || ".");
+    let reportPath = options.report ? resolvePath7(dirPath, options.report) : null;
+    if (!reportPath || !existsSync3(reportPath)) {
+      const latestScan = findLatestReport2(dirPath);
+      if (latestScan) {
+        reportPath = latestScan;
+        console.log(
+          chalk9.dim(`Found latest report: ${latestScan.split("/").pop()}`)
+        );
+      } else {
+        console.error(chalk9.red("\u274C No AI readiness report found"));
+        console.log(
+          chalk9.dim(
+            `
+Generate a report with:
+  aiready scan --output json
+
+Or specify a custom report:
+  aiready visualise --report <path-to-report.json>`
+          )
+        );
+        return;
+      }
+    }
+    const raw = readFileSync3(reportPath, "utf8");
+    const report = JSON.parse(raw);
+    const configPath = resolvePath7(dirPath, "aiready.json");
+    let graphConfig = { maxNodes: 400, maxEdges: 600 };
+    if (existsSync3(configPath)) {
+      try {
+        const rawConfig = JSON.parse(readFileSync3(configPath, "utf8"));
+        if (rawConfig.visualizer?.graph) {
+          graphConfig = {
+            maxNodes: rawConfig.visualizer.graph.maxNodes ?? graphConfig.maxNodes,
+            maxEdges: rawConfig.visualizer.graph.maxEdges ?? graphConfig.maxEdges
+          };
+        }
+      } catch (e) {
+        void e;
+      }
+    }
+    const envVisualizerConfig = JSON.stringify(graphConfig);
+    process.env.AIREADY_VISUALIZER_CONFIG = envVisualizerConfig;
+    console.log("Building graph from report...");
+    const { GraphBuilder } = await import("@aiready/visualizer/graph");
+    const graph = GraphBuilder.buildFromReport(report, dirPath);
+    let useDevMode = options.dev || false;
+    let devServerStarted = false;
+    if (useDevMode) {
+      try {
+        const localWebDir = resolvePath7(dirPath, "packages/visualizer");
+        let webDir = "";
+        let visualizerAvailable = false;
+        if (existsSync3(localWebDir)) {
+          webDir = localWebDir;
+          visualizerAvailable = true;
+        } else {
+          const nodemodulesLocations = [
+            resolvePath7(dirPath, "node_modules", "@aiready", "visualizer"),
+            resolvePath7(
+              process.cwd(),
+              "node_modules",
+              "@aiready",
+              "visualizer"
+            )
+          ];
+          let currentDir = dirPath;
+          while (currentDir !== "/" && currentDir !== ".") {
+            nodemodulesLocations.push(
+              resolvePath7(currentDir, "node_modules", "@aiready", "visualizer")
+            );
+            const parent = resolvePath7(currentDir, "..");
+            if (parent === currentDir) break;
+            currentDir = parent;
+          }
+          for (const location of nodemodulesLocations) {
+            if (existsSync3(location) && existsSync3(resolvePath7(location, "package.json"))) {
+              webDir = location;
+              visualizerAvailable = true;
+              break;
+            }
+          }
+          if (!visualizerAvailable) {
+            try {
+              const vizPkgPath = __require.resolve("@aiready/visualizer/package.json");
+              webDir = resolvePath7(vizPkgPath, "..");
+              visualizerAvailable = true;
+            } catch (err) {
+              void err;
+            }
+          }
+        }
+        const webViteConfigExists = webDir && existsSync3(resolvePath7(webDir, "web", "vite.config.ts"));
+        if (visualizerAvailable && webViteConfigExists) {
+          const spawnCwd = webDir;
+          const { watch } = await import("fs");
+          const copyReportToViz = () => {
+            try {
+              const destPath = resolvePath7(spawnCwd, "web", "report-data.json");
+              copyFileSync(reportPath, destPath);
+              console.log(`\u{1F4CB} Report synced to ${destPath}`);
+            } catch (e) {
+              console.error("Failed to sync report:", e);
+            }
+          };
+          copyReportToViz();
+          let watchTimeout = null;
+          const reportWatcher = watch(reportPath, () => {
+            if (watchTimeout) clearTimeout(watchTimeout);
+            watchTimeout = setTimeout(copyReportToViz, 100);
+          });
+          const envForSpawn = {
+            ...process.env,
+            AIREADY_REPORT_PATH: reportPath,
+            AIREADY_VISUALIZER_CONFIG: envVisualizerConfig
+          };
+          const vite = spawn("pnpm", ["run", "dev:web"], {
+            cwd: spawnCwd,
+            stdio: "inherit",
+            shell: true,
+            env: envForSpawn
+          });
+          const onExit = () => {
+            try {
+              reportWatcher.close();
+            } catch (err) {
+              void err;
+            }
+            try {
+              vite.kill();
+            } catch (err) {
+              void err;
+            }
+            process.exit(0);
+          };
+          process.on("SIGINT", onExit);
+          process.on("SIGTERM", onExit);
+          devServerStarted = true;
+          void devServerStarted;
+          return;
+        } else {
+          console.log(
+            chalk9.yellow(
+              "\u26A0\uFE0F  Dev server not available (requires local @aiready/visualizer with web assets)."
+            )
+          );
+          console.log(
+            chalk9.cyan("   Falling back to static HTML generation...\n")
+          );
+          useDevMode = false;
+        }
+      } catch (err) {
+        console.error("Failed to start dev server:", err);
+        console.log(
+          chalk9.cyan("   Falling back to static HTML generation...\n")
+        );
+        useDevMode = false;
+      }
+    }
+    console.log("Generating HTML...");
+    const html = generateHTML(graph);
+    const defaultOutput = "visualization.html";
+    const outPath = resolvePath7(dirPath, options.output || defaultOutput);
+    writeFileSync4(outPath, html, "utf8");
+    console.log(chalk9.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) {
+        try {
+          const port = typeof options.serve === "number" ? options.serve : 5173;
+          const http = await import("http");
+          const fsp = await import("fs/promises");
+          const server = http.createServer(async (req, res) => {
+            try {
+              const urlPath = req.url || "/";
+              if (urlPath === "/" || urlPath === "/index.html") {
+                const content = await fsp.readFile(outPath, "utf8");
+                res.writeHead(200, {
+                  "Content-Type": "text/html; charset=utf-8"
+                });
+                res.end(content);
+                return;
+              }
+              res.writeHead(404, { "Content-Type": "text/plain" });
+              res.end("Not found");
+            } catch (e) {
+              void e;
+              res.writeHead(500, { "Content-Type": "text/plain" });
+              res.end("Server error");
+            }
+          });
+          server.listen(port, () => {
+            const addr = `http://localhost:${port}/`;
+            console.log(
+              chalk9.cyan(`\u{1F310} Local visualization server running at ${addr}`)
+            );
+            spawn(opener, [`"${addr}"`], { shell: true });
+          });
+          process.on("SIGINT", () => {
+            server.close();
+            process.exit(0);
+          });
+        } catch (err) {
+          console.error("Failed to start local server:", err);
+        }
+      } else if (options.open) {
+        spawn(opener, [`"${outPath}"`], { shell: true });
+      }
+    }
+  } catch (err) {
+    handleCLIError6(err, "Visualization");
+  }
+}
+var visualizeHelpText = `
+EXAMPLES:
+  $ aiready visualize .  # Auto-detects latest report, generates HTML
+  $ aiready visualize . --report .aiready/aiready-report-20260217-143022.json
+  $ aiready visualize . --report report.json -o out/visualization.html --open
+  $ aiready visualize . --report report.json --serve
+  $ aiready visualize . --report report.json --serve 8080
+  $ aiready visualize . --report report.json --dev
+
+NOTES:
+  - The value passed to --report is interpreted relative to the directory argument (first positional).
+    If the report is not found, the CLI will suggest running 'aiready scan' to generate it.
+  - Default output path: visualization.html (in the current directory).
+  - --serve starts a tiny single-file HTTP server (default port: 5173) and opens your browser.
+  - --dev starts a Vite dev server with live reload (requires local @aiready/visualizer installation).
+    When --dev is not available, it falls back to static HTML generation.
+`;
+var visualiseHelpText = `
+EXAMPLES:
+  $ aiready visualise .  # Auto-detects latest report
+  $ aiready visualise . --report .aiready/aiready-report-20260217-143022.json
+  $ aiready visualise . --report report.json --serve 8080
+
+NOTES:
+  - Same options as 'visualize'. Use --serve to host the static HTML, or --dev for live reload.
+`;
+
+// src/commands/shared/standard-tool-actions.ts
+import chalk10 from "chalk";
+
+// src/commands/shared/configured-tool-action.ts
+async function runConfiguredToolAction(directory, options, config) {
+  const { report, scoring } = await runConfiguredToolCommand({
+    directory,
+    options,
+    defaults: config.defaults,
+    analyze: config.analyze,
+    getExtras: config.getExtras,
+    score: config.score
+  });
+  if (options.output === "json") {
+    return scoring;
+  }
+  config.render(report, scoring);
+  return scoring;
+}
+
+// src/commands/shared/standard-tool-actions.ts
+async function aiSignalClarityAction(directory, options) {
+  const { analyzeAiSignalClarity, calculateAiSignalClarityScore } = await import("@aiready/ai-signal-clarity");
+  return runConfiguredToolAction(directory, options, {
+    defaults: { minSeverity: "info" },
+    analyze: analyzeAiSignalClarity,
+    getExtras: (cmdOptions, merged) => ({
+      minSeverity: cmdOptions.minSeverity ?? merged.minSeverity ?? "info"
+    }),
+    score: (toolReport) => calculateAiSignalClarityScore(toolReport),
+    render: (report, scoring) => {
+      const { summary } = report;
+      const ratingColors = {
+        minimal: chalk10.green,
+        low: chalk10.cyan,
+        moderate: chalk10.yellow,
+        high: chalk10.red,
+        severe: chalk10.bgRed.white
+      };
+      const color = ratingColors[summary.rating] ?? chalk10.white;
+      console.log(
+        `  \u{1F9E0} AI Signal Clarity:  ${chalk10.bold(scoring.score + "/100")} (${color(summary.rating)})`
+      );
+      console.log(`     Top Risk: ${chalk10.italic(summary.topRisk)}`);
+      if (summary.totalSignals > 0) {
+        console.log(
+          chalk10.dim(
+            `     ${summary.criticalSignals} critical  ${summary.majorSignals} major  ${summary.minorSignals} minor signals`
+          )
+        );
+      }
+    }
+  });
+}
+
+// src/commands/agent-grounding.ts
+import chalk11 from "chalk";
+import { loadConfig as loadConfig2, mergeConfigWithDefaults as mergeConfigWithDefaults2 } from "@aiready/core";
+async function agentGroundingAction(directory, options) {
+  const { analyzeAgentGrounding, calculateGroundingScore } = await import("@aiready/agent-grounding");
+  const config = await loadConfig2(directory);
+  const merged = mergeConfigWithDefaults2(config, {
+    maxRecommendedDepth: 4,
+    readmeStaleDays: 90
+  });
+  const report = await analyzeAgentGrounding({
+    rootDir: directory,
+    maxRecommendedDepth: options.maxDepth ?? merged.maxRecommendedDepth,
+    readmeStaleDays: options.readmeStaleDays ?? merged.readmeStaleDays,
+    include: options.include,
+    exclude: options.exclude
+  });
+  const scoring = calculateGroundingScore(report);
+  if (options.output === "json") {
+    return scoring;
+  }
+  const scoreColor = (s) => s >= 85 ? chalk11.green : s >= 70 ? chalk11.cyan : s >= 50 ? chalk11.yellow : chalk11.red;
+  void scoreColor;
+  console.log(
+    `  \u{1F9ED} Agent Grounding:     ${chalk11.bold(scoring.score + "/100")} (${report.summary.rating})`
+  );
+  const dims = report.summary.dimensions;
+  const worstDim = Object.entries(dims).sort(([, a], [, b]) => a - b)[0];
+  if (worstDim && worstDim[1] < 70) {
+    const name = worstDim[0].replace(/([A-Z])/g, " $1").replace("Score", "").trim();
+    console.log(
+      chalk11.dim(`     Weakest dimension: ${name} (${worstDim[1]}/100)`)
+    );
+  }
+  return scoring;
+}
+
+// src/commands/testability.ts
+import chalk12 from "chalk";
+import { loadConfig as loadConfig3, mergeConfigWithDefaults as mergeConfigWithDefaults3 } from "@aiready/core";
+async function testabilityAction(directory, options) {
+  const { analyzeTestability, calculateTestabilityScore } = await import("@aiready/testability");
+  const config = await loadConfig3(directory);
+  const merged = mergeConfigWithDefaults3(config, {
+    minCoverageRatio: 0.3
+  });
+  const report = await analyzeTestability({
+    rootDir: directory,
+    minCoverageRatio: options.minCoverageRatio ?? merged.minCoverageRatio,
+    include: options.include,
+    exclude: options.exclude
+  });
+  const scoring = calculateTestabilityScore(report);
+  if (options.output === "json") {
+    return scoring;
+  }
+  const safetyIcons = {
+    safe: "\u2705",
+    "moderate-risk": "\u26A0\uFE0F ",
+    "high-risk": "\u{1F534}",
+    "blind-risk": "\u{1F480}"
+  };
+  const safetyColors = {
+    safe: chalk12.green,
+    "moderate-risk": chalk12.yellow,
+    "high-risk": chalk12.red,
+    "blind-risk": chalk12.bgRed.white
+  };
+  const safety = report.summary.aiChangeSafetyRating;
+  const icon = safetyIcons[safety] ?? "\u2753";
+  const color = safetyColors[safety] ?? chalk12.white;
+  console.log(
+    `  \u{1F9EA} Testability:         ${chalk12.bold(scoring.score + "/100")} (${report.summary.rating})`
+  );
+  console.log(
+    `     AI Change Safety:  ${color(`${icon} ${safety.toUpperCase()}`)}`
+  );
+  console.log(
+    chalk12.dim(
+      `     Coverage: ${Math.round(report.summary.coverageRatio * 100)}%  (${report.rawData.testFiles} test / ${report.rawData.sourceFiles} source files)`
+    )
+  );
+  if (safety === "blind-risk") {
+    console.log(
+      chalk12.red.bold(
+        "\n     \u26A0\uFE0F  NO TESTS \u2014 AI changes to this codebase are completely unverifiable!\n"
+      )
+    );
+  }
+  return scoring;
+}
+
+// src/commands/change-amplification.ts
+import { changeAmplificationAction } from "@aiready/change-amplification/dist/cli.js";
+
+// src/commands/bug.ts
+import chalk13 from "chalk";
+import { execSync } from "child_process";
+async function bugAction(message, options) {
+  const repoUrl = "https://github.com/caopengau/aiready-cli";
+  const repoSlug = "caopengau/aiready-cli";
+  if (message) {
+    const type = options.type || "bug";
+    const title = `[${type.toUpperCase()}] ${message}`;
+    const label = type === "bug" ? "bug" : type === "feature" ? "enhancement" : "metric";
+    const body = `
+## Description
+${message}
+
+## Context
+Generated via AIReady CLI 'bug' command.
+Type: ${type}
+    `.trim();
+    if (options.submit) {
+      console.log(chalk13.blue("\u{1F680} Submitting issue via GitHub CLI...\n"));
+      try {
+        execSync("gh auth status", { stdio: "ignore" });
+        const command = `gh issue create --repo ${repoSlug} --title ${JSON.stringify(title)} --body ${JSON.stringify(body)} --label ${label}`;
+        const output = execSync(command, { encoding: "utf8" }).trim();
+        console.log(chalk13.green("\u2705 Issue Created Successfully!"));
+        console.log(chalk13.cyan(output));
+        return;
+      } catch {
+        console.error(chalk13.red("\n\u274C Failed to submit via gh CLI."));
+        console.log(
+          chalk13.yellow(
+            '   Make sure gh is installed and run "gh auth login".\n'
+          )
+        );
+        console.log(chalk13.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(chalk13.green("\u{1F680} Issue Draft Prepared!\n"));
+    console.log(chalk13.bold("Title:  ") + title);
+    console.log(chalk13.bold("Type:   ") + type);
+    console.log(chalk13.bold("\nClick the link below to submit this issue:"));
+    console.log(chalk13.cyan(fullUrl));
+    console.log(chalk13.bold("\n\u{1F916} [FOR AI AGENTS]:"));
+    console.log(chalk13.dim("   You have successfully prepared a report."));
+    console.log(
+      chalk13.dim(
+        "   Please present the URL above to the user so they can finalize the submission."
+      )
+    );
+    return;
+  }
+  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(chalk13.blue("\u{1F4AC} Feedback & Bug Reports\n"));
+  console.log(`  Report a Bug:        ${chalk13.cyan(bugUrl)}`);
+  console.log(`  Request a Feature:   ${chalk13.cyan(featureUrl)}`);
+  console.log(`  Suggest a Metric:    ${chalk13.cyan(metricUrl)}`);
+  console.log(chalk13.bold("\n\u{1F916} [FOR AI AGENTS]:"));
+  console.log(chalk13.dim("   To prepare a specific report, run:"));
+  console.log(
+    chalk13.cyan(
+      '   aiready bug "your description here" --type bug|feature|metric'
+    )
+  );
+}
+var bugHelpText = `
+EXAMPLES:
+  $ aiready bug                                      # Show general links
+  $ aiready bug "Naming check is too slow"           # Prepare a pre-filled bug report
+  $ aiready bug "Add CO2 impact metric" --type metric # Prepare a metric suggestion
+  $ aiready bug "Fix typo in scan output" --submit   # Submit directly via gh CLI
+`;
+
+// src/commands/stack-sync.ts
+import { execSync as execSync2 } from "child_process";
+import { existsSync as existsSync4 } from "fs";
+import { join as join2 } from "path";
+import chalk14 from "chalk";
+async function stackSyncAction(options) {
+  const remote = options.remote || "https://github.com/caopengau/aiready-clawmore.git";
+  const branch = options.branch || "main";
+  console.log(chalk14.cyan("\u{1F50D} Checking stack environment..."));
+  if (!existsSync4(join2(process.cwd(), ".git"))) {
+    console.error(chalk14.red("Error: Not a git repository."));
+    process.exit(1);
+  }
+  let remoteName = "upstream";
+  try {
+    const remotes = execSync2("git remote").toString().split("\n");
+    const existingUpstream = remotes.find((r) => {
+      try {
+        const url = execSync2(`git remote get-url ${r}`).toString().trim();
+        return url === remote;
+      } catch {
+        return false;
+      }
+    });
+    if (existingUpstream) {
+      remoteName = existingUpstream;
+      console.log(chalk14.green(`\u2713 Found existing upstream remote: ${remoteName}`));
+    } else {
+      console.log(chalk14.yellow(`! Upstream remote not found. Adding ${remote} as 'upstream'...`));
+      execSync2(`git remote add upstream ${remote}`);
+      remoteName = "upstream";
+    }
+  } catch (error) {
+    console.error(chalk14.red(`Failed to handle git remotes: ${error}`));
+    process.exit(1);
+  }
+  console.log(chalk14.cyan(`\u{1F4E5} Fetching latest from ${remoteName}/${branch}...`));
+  try {
+    execSync2(`git fetch ${remoteName} ${branch}`, { stdio: "inherit" });
+  } catch (error) {
+    console.error(chalk14.red(`Failed to fetch from ${remoteName}: ${error}`));
+    process.exit(1);
+  }
+  try {
+    const localHash = execSync2("git rev-parse HEAD").toString().trim();
+    const remoteHash = execSync2(`git rev-parse ${remoteName}/${branch}`).toString().trim();
+    if (localHash === remoteHash) {
+      console.log(chalk14.green("\u2705 Stack is up to date with upstream."));
+      return;
+    }
+    console.log(chalk14.yellow(`
+\u{1F680} Updates available! Current: ${localHash.substring(0, 7)}, Upstream: ${remoteHash.substring(0, 7)}`));
+    if (options.pull) {
+      console.log(chalk14.cyan(`\u{1F504} Merging updates from ${remoteName}/${branch}...`));
+      execSync2(`git merge ${remoteName}/${branch}`, { stdio: "inherit" });
+      console.log(chalk14.green("\u2705 Successfully updated stack."));
+    } else {
+      console.log(chalk14.cyan("\nRun the following command to update your stack:"));
+      console.log(chalk14.white(`  $ aiready stack sync --pull
+`));
+    }
+  } catch (error) {
+    console.error(chalk14.red(`Failed to compare versions or merge: ${error}`));
+    process.exit(1);
+  }
+}
+
+export {
+  uploadAction,
+  uploadHelpText,
+  scanAction,
+  scanHelpText,
+  initAction,
+  patternsAction,
+  patternsHelpText,
+  contextAction,
+  consistencyAction,
+  visualizeAction,
+  visualizeHelpText,
+  visualiseHelpText,
+  aiSignalClarityAction,
+  agentGroundingAction,
+  testabilityAction,
+  changeAmplificationAction,
+  bugAction,
+  bugHelpText,
+  stackSyncAction
+};