@aiready/cli 0.14.6 → 0.14.7

package/dist/chunk-MVEYWWJM.mjs

@@ -1,1894 +0,0 @@
-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
-};