@aiready/cli 0.9.35 → 0.9.38

package/dist/cli.js

@@ -25,11 +25,13 @@ var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__ge
 
 // src/cli.ts
 var import_commander = require("commander");
-var import_fs4 = require("fs");
+var import_fs5 = require("fs");
 var import_path7 = require("path");
+var import_url = require("url");
 
 // src/commands/scan.ts
 var import_chalk2 = __toESM(require("chalk"));
+var import_fs2 = require("fs");
 var import_path2 = require("path");
 var import_core = require("@aiready/core");
 
@@ -115,6 +117,71 @@ async function analyzeUnified(options) {
     result.consistency = report;
     result.summary.totalIssues += report.summary.totalIssues;
   }
+  if (tools.includes("doc-drift")) {
+    const { analyzeDocDrift } = await import("@aiready/doc-drift");
+    const report = await analyzeDocDrift({
+      rootDir: options.rootDir,
+      include: options.include,
+      exclude: options.exclude
+    });
+    if (options.progressCallback) {
+      options.progressCallback({ tool: "doc-drift", data: report });
+    }
+    result.docDrift = report;
+    result.summary.totalIssues += report.issues?.length || 0;
+  }
+  if (tools.includes("deps-health")) {
+    const { analyzeDeps } = await import("@aiready/deps");
+    const report = await analyzeDeps({
+      rootDir: options.rootDir,
+      include: options.include,
+      exclude: options.exclude
+    });
+    if (options.progressCallback) {
+      options.progressCallback({ tool: "deps-health", data: report });
+    }
+    result.deps = report;
+    result.summary.totalIssues += report.issues?.length || 0;
+  }
+  if (tools.includes("hallucination")) {
+    const { analyzeHallucinationRisk } = await import("@aiready/hallucination-risk");
+    const report = await analyzeHallucinationRisk({
+      rootDir: options.rootDir,
+      include: options.include,
+      exclude: options.exclude
+    });
+    if (options.progressCallback) {
+      options.progressCallback({ tool: "hallucination", data: report });
+    }
+    result.hallucination = report;
+    result.summary.totalIssues += report.results?.reduce((sum, r) => sum + (r.issues?.length || 0), 0) || 0;
+  }
+  if (tools.includes("grounding")) {
+    const { analyzeAgentGrounding } = await import("@aiready/agent-grounding");
+    const report = await analyzeAgentGrounding({
+      rootDir: options.rootDir,
+      include: options.include,
+      exclude: options.exclude
+    });
+    if (options.progressCallback) {
+      options.progressCallback({ tool: "grounding", data: report });
+    }
+    result.grounding = report;
+    result.summary.totalIssues += report.issues?.length || 0;
+  }
+  if (tools.includes("testability")) {
+    const { analyzeTestability } = await import("@aiready/testability");
+    const report = await analyzeTestability({
+      rootDir: options.rootDir,
+      include: options.include,
+      exclude: options.exclude
+    });
+    if (options.progressCallback) {
+      options.progressCallback({ tool: "testability", data: report });
+    }
+    result.testability = report;
+    result.summary.totalIssues += report.issues?.length || 0;
+  }
   result.summary.executionTime = Date.now() - startTime;
   return result;
 }
@@ -145,7 +212,7 @@ function findLatestScanReport(dirPath) {
 }
 function warnIfGraphCapExceeded(report, dirPath) {
   try {
-    const { loadConfig } = require("@aiready/core");
+    const { loadConfig: loadConfig4 } = require("@aiready/core");
     let graphConfig = { maxNodes: 400, maxEdges: 600 };
     const configPath = (0, import_path.resolve)(dirPath, "aiready.json");
     if ((0, import_fs.existsSync)(configPath)) {
@@ -231,7 +298,7 @@ async function scanAction(directory, options) {
   const resolvedDir = (0, import_path2.resolve)(process.cwd(), directory || ".");
   try {
     const defaults = {
-      tools: ["patterns", "context", "consistency"],
+      tools: ["patterns", "context", "consistency", "hallucination", "grounding", "testability", "doc-drift", "deps-health"],
       include: void 0,
       exclude: void 0,
       output: {
@@ -239,8 +306,28 @@ async function scanAction(directory, options) {
         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 = ["hallucination", "grounding", "testability"];
+          break;
+        case "cost":
+          profileTools = ["patterns", "context"];
+          break;
+        case "security":
+          profileTools = ["consistency", "testability"];
+          break;
+        case "onboarding":
+          profileTools = ["context", "consistency", "grounding"];
+          break;
+        default:
+          console.log(import_chalk2.default.yellow(`
+\u26A0\uFE0F  Unknown profile '${options.profile}'. Using specified tools or defaults.`));
+      }
+    }
     const baseOptions = await (0, import_core.loadMergedConfig)(resolvedDir, defaults, {
-      tools: options.tools ? options.tools.split(",").map((t) => t.trim()) : void 0,
+      tools: profileTools,
       include: options.include?.split(","),
       exclude: options.exclude?.split(",")
     });
@@ -372,6 +459,20 @@ async function scanAction(directory, options) {
               console.log(import_chalk2.default.dim(`   ... and ${remaining} more files with issues (use --output json for full details)`));
             }
           }
+        } else if (event.tool === "doc-drift") {
+          const dr = event.data;
+          console.log(`  Issues found: ${import_chalk2.default.bold(String(dr.issues?.length || 0))}`);
+          if (dr.rawData) {
+            console.log(`  Signature Mismatches: ${import_chalk2.default.bold(dr.rawData.outdatedComments || 0)}`);
+            console.log(`  Undocumented Complexity: ${import_chalk2.default.bold(dr.rawData.undocumentedComplexity || 0)}`);
+          }
+        } else if (event.tool === "deps-health") {
+          const dr = event.data;
+          console.log(`  Packages Analyzed: ${import_chalk2.default.bold(String(dr.summary?.packagesAnalyzed || 0))}`);
+          if (dr.rawData) {
+            console.log(`  Deprecated Packages: ${import_chalk2.default.bold(dr.rawData.deprecatedPackages || 0)}`);
+            console.log(`  AI Cutoff Skew Score: ${import_chalk2.default.bold(dr.rawData.trainingCutoffSkew?.toFixed(1) || 0)}`);
+          }
         }
       } catch (err) {
       }
@@ -417,11 +518,82 @@ async function scanAction(directory, options) {
         } catch (err) {
         }
       }
+      if (results.hallucination) {
+        const { calculateHallucinationScore } = await import("@aiready/hallucination-risk");
+        try {
+          const hrScore = calculateHallucinationScore(results.hallucination);
+          toolScores.set("hallucination-risk", hrScore);
+        } catch (err) {
+        }
+      }
+      if (results.grounding) {
+        const { calculateGroundingScore } = await import("@aiready/agent-grounding");
+        try {
+          const agScore = calculateGroundingScore(results.grounding);
+          toolScores.set("agent-grounding", agScore);
+        } catch (err) {
+        }
+      }
+      if (results.testability) {
+        const { calculateTestabilityScore } = await import("@aiready/testability");
+        try {
+          const tbScore = calculateTestabilityScore(results.testability);
+          toolScores.set("testability", tbScore);
+        } catch (err) {
+        }
+      }
+      if (results.docDrift) {
+        toolScores.set("doc-drift", {
+          toolName: "doc-drift",
+          score: results.docDrift.summary.score,
+          rawMetrics: results.docDrift.rawData,
+          factors: [],
+          recommendations: results.docDrift.recommendations.map((action) => ({ action, estimatedImpact: 5, priority: "medium" }))
+        });
+      }
+      if (results.deps) {
+        toolScores.set("dependency-health", {
+          toolName: "dependency-health",
+          score: results.deps.summary.score,
+          rawMetrics: results.deps.rawData,
+          factors: [],
+          recommendations: results.deps.recommendations.map((action) => ({ action, estimatedImpact: 5, priority: "medium" }))
+        });
+      }
       const cliWeights = (0, import_core.parseWeightString)(options.weights);
       if (toolScores.size > 0) {
         scoringResult = (0, import_core.calculateOverallScore)(toolScores, finalOptions, cliWeights.size ? cliWeights : void 0);
         console.log(import_chalk2.default.bold("\n\u{1F4CA} AI Readiness Overall Score"));
         console.log(`  ${(0, import_core.formatScore)(scoringResult)}`);
+        if (options.compareTo) {
+          try {
+            const prevReportStr = (0, import_fs2.readFileSync)((0, import_path2.resolve)(process.cwd(), options.compareTo), "utf8");
+            const prevReport = JSON.parse(prevReportStr);
+            const prevScore = prevReport.scoring?.score || prevReport.scoring?.overallScore;
+            if (typeof prevScore === "number") {
+              const diff = scoringResult.overall - prevScore;
+              const diffStr = diff > 0 ? `+${diff}` : String(diff);
+              console.log();
+              if (diff > 0) {
+                console.log(import_chalk2.default.green(`  \u{1F4C8} Trend: ${diffStr} compared to ${options.compareTo} (${prevScore} \u2192 ${scoringResult.overall})`));
+              } else if (diff < 0) {
+                console.log(import_chalk2.default.red(`  \u{1F4C9} Trend: ${diffStr} compared to ${options.compareTo} (${prevScore} \u2192 ${scoringResult.overall})`));
+              } else {
+                console.log(import_chalk2.default.blue(`  \u2796 Trend: No change compared to ${options.compareTo} (${prevScore} \u2192 ${scoringResult.overall})`));
+              }
+              scoringResult.trend = {
+                previousScore: prevScore,
+                difference: diff
+              };
+            } else {
+              console.log(import_chalk2.default.yellow(`
+  \u26A0\uFE0F  Previous report at ${options.compareTo} does not contain an overall score.`));
+            }
+          } catch (e) {
+            console.log(import_chalk2.default.yellow(`
+  \u26A0\uFE0F  Could not read or parse previous report at ${options.compareTo}.`));
+          }
+        }
         if (scoringResult.breakdown && scoringResult.breakdown.length > 0) {
           console.log(import_chalk2.default.bold("\nTool breakdown:"));
           scoringResult.breakdown.forEach((tool) => {
@@ -457,17 +629,17 @@ async function scanAction(directory, options) {
       if (process.env.GITHUB_ACTIONS === "true") {
         console.log(`
 ::group::AI Readiness Score`);
-        console.log(`score=${scoringResult.overallScore}`);
+        console.log(`score=${scoringResult.overall}`);
         if (scoringResult.breakdown) {
           scoringResult.breakdown.forEach((tool) => {
             console.log(`${tool.toolName}=${tool.score}`);
           });
         }
         console.log("::endgroup::");
-        if (threshold && scoringResult.overallScore < threshold) {
-          console.log(`::error::AI Readiness Score ${scoringResult.overallScore} is below threshold ${threshold}`);
+        if (threshold && scoringResult.overall < threshold) {
+          console.log(`::error::AI Readiness Score ${scoringResult.overall} is below threshold ${threshold}`);
         } else if (threshold) {
-          console.log(`::notice::AI Readiness Score: ${scoringResult.overallScore}/100 (threshold: ${threshold})`);
+          console.log(`::notice::AI Readiness Score: ${scoringResult.overall}/100 (threshold: ${threshold})`);
         }
         if (results.patterns) {
           const criticalPatterns = results.patterns.flatMap(
@@ -480,9 +652,9 @@ async function scanAction(directory, options) {
       }
       let shouldFail = false;
       let failReason = "";
-      if (threshold && scoringResult.overallScore < threshold) {
+      if (threshold && scoringResult.overall < threshold) {
         shouldFail = true;
-        failReason = `AI Readiness Score ${scoringResult.overallScore} is below threshold ${threshold}`;
+        failReason = `AI Readiness Score ${scoringResult.overall} is below threshold ${threshold}`;
       }
       if (failOnLevel !== "none") {
         const severityLevels = { critical: 4, major: 3, minor: 2, any: 1 };
@@ -530,7 +702,7 @@ async function scanAction(directory, options) {
       } else {
         console.log(import_chalk2.default.green("\n\u2705 PR PASSED: AI Readiness Check"));
         if (threshold) {
-          console.log(import_chalk2.default.green(`   Score: ${scoringResult.overallScore}/100 (threshold: ${threshold})`));
+          console.log(import_chalk2.default.green(`   Score: ${scoringResult.overall}/100 (threshold: ${threshold})`));
         }
         console.log(import_chalk2.default.dim("\n   \u{1F4A1} Track historical trends: https://getaiready.dev \u2014 Team plan $99/mo"));
       }
@@ -543,11 +715,20 @@ var scanHelpText = `
 EXAMPLES:
   $ aiready scan                                    # Analyze all tools
   $ aiready scan --tools patterns,context           # Skip consistency
+  $ aiready scan --profile agentic                  # Optimize for AI agent execution
+  $ aiready scan --profile security                 # Optimize for secure coding (testability)
+  $ aiready scan --compare-to prev-report.json      # Compare trends against previous run
   $ aiready scan --score --threshold 75             # CI/CD with threshold
   $ aiready scan --ci --threshold 70                # GitHub Actions gatekeeper
   $ aiready scan --ci --fail-on major               # Fail on major+ issues
   $ aiready scan --output json --output-file report.json
 
+PROFILES:
+  agentic:      hallucination, grounding, testability
+  cost:         patterns, context
+  security:     consistency, testability
+  onboarding:   context, consistency, grounding
+
 CI/CD INTEGRATION (Gatekeeper Mode):
   Use --ci for GitHub Actions integration:
   - Outputs GitHub Actions annotations for PR checks
@@ -820,7 +1001,7 @@ async function contextAction(directory, options) {
 
 // src/commands/consistency.ts
 var import_chalk5 = __toESM(require("chalk"));
-var import_fs2 = require("fs");
+var import_fs3 = require("fs");
 var import_path5 = require("path");
 var import_core4 = require("@aiready/core");
 async function consistencyAction(directory, options) {
@@ -878,7 +1059,7 @@ async function consistencyAction(directory, options) {
         `aiready-report-${getReportTimestamp()}.md`,
         resolvedDir
       );
-      (0, import_fs2.writeFileSync)(outputPath, markdown);
+      (0, import_fs3.writeFileSync)(outputPath, markdown);
       console.log(import_chalk5.default.green(`\u2705 Report saved to ${outputPath}`));
     } else {
       console.log(import_chalk5.default.bold("\n\u{1F4CA} Summary\n"));
@@ -965,7 +1146,7 @@ async function consistencyAction(directory, options) {
 
 // src/commands/visualize.ts
 var import_chalk6 = __toESM(require("chalk"));
-var import_fs3 = require("fs");
+var import_fs4 = require("fs");
 var import_path6 = require("path");
 var import_child_process = require("child_process");
 var import_core5 = require("@aiready/core");
@@ -974,7 +1155,7 @@ async function visualizeAction(directory, options) {
   try {
     const dirPath = (0, import_path6.resolve)(process.cwd(), directory || ".");
     let reportPath = options.report ? (0, import_path6.resolve)(dirPath, options.report) : null;
-    if (!reportPath || !(0, import_fs3.existsSync)(reportPath)) {
+    if (!reportPath || !(0, import_fs4.existsSync)(reportPath)) {
       const latestScan = findLatestScanReport(dirPath);
       if (latestScan) {
         reportPath = latestScan;
@@ -990,13 +1171,13 @@ Or specify a custom report:
         return;
       }
     }
-    const raw = (0, import_fs3.readFileSync)(reportPath, "utf8");
+    const raw = (0, import_fs4.readFileSync)(reportPath, "utf8");
     const report = JSON.parse(raw);
     const configPath = (0, import_path6.resolve)(dirPath, "aiready.json");
     let graphConfig = { maxNodes: 400, maxEdges: 600 };
-    if ((0, import_fs3.existsSync)(configPath)) {
+    if ((0, import_fs4.existsSync)(configPath)) {
       try {
-        const rawConfig = JSON.parse((0, import_fs3.readFileSync)(configPath, "utf8"));
+        const rawConfig = JSON.parse((0, import_fs4.readFileSync)(configPath, "utf8"));
         if (rawConfig.visualizer?.graph) {
           graphConfig = {
             maxNodes: rawConfig.visualizer.graph.maxNodes ?? graphConfig.maxNodes,
@@ -1018,7 +1199,7 @@ Or specify a custom report:
         const monorepoWebDir = (0, import_path6.resolve)(dirPath, "packages/visualizer");
         let webDir = "";
         let visualizerAvailable = false;
-        if ((0, import_fs3.existsSync)(monorepoWebDir)) {
+        if ((0, import_fs4.existsSync)(monorepoWebDir)) {
           webDir = monorepoWebDir;
           visualizerAvailable = true;
         } else {
@@ -1034,7 +1215,7 @@ Or specify a custom report:
             currentDir = parent;
           }
           for (const location of nodemodulesLocations) {
-            if ((0, import_fs3.existsSync)(location) && (0, import_fs3.existsSync)((0, import_path6.resolve)(location, "package.json"))) {
+            if ((0, import_fs4.existsSync)(location) && (0, import_fs4.existsSync)((0, import_path6.resolve)(location, "package.json"))) {
               webDir = location;
               visualizerAvailable = true;
               break;
@@ -1049,14 +1230,14 @@ Or specify a custom report:
             }
           }
         }
-        const webViteConfigExists = webDir && (0, import_fs3.existsSync)((0, import_path6.resolve)(webDir, "web", "vite.config.ts"));
+        const webViteConfigExists = webDir && (0, import_fs4.existsSync)((0, import_path6.resolve)(webDir, "web", "vite.config.ts"));
         if (visualizerAvailable && webViteConfigExists) {
           const spawnCwd = webDir;
           const { watch } = await import("fs");
           const copyReportToViz = () => {
             try {
               const destPath = (0, import_path6.resolve)(spawnCwd, "web", "report-data.json");
-              (0, import_fs3.copyFileSync)(reportPath, destPath);
+              (0, import_fs4.copyFileSync)(reportPath, destPath);
               console.log(`\u{1F4CB} Report synced to ${destPath}`);
             } catch (e) {
               console.error("Failed to sync report:", e);
@@ -1104,7 +1285,7 @@ Or specify a custom report:
     const html = (0, import_core6.generateHTML)(graph);
     const defaultOutput = "visualization.html";
     const outPath = (0, import_path6.resolve)(dirPath, options.output || defaultOutput);
-    (0, import_fs3.writeFileSync)(outPath, html, "utf8");
+    (0, import_fs4.writeFileSync)(outPath, html, "utf8");
     console.log(import_chalk6.default.green(`\u2705 Visualization written to: ${outPath}`));
     if (options.open || options.serve) {
       const opener = process.platform === "darwin" ? "open" : process.platform === "win32" ? "start" : "xdg-open";
@@ -1176,8 +1357,25 @@ NOTES:
   - Same options as 'visualize'. Use --serve to host the static HTML, or --dev for live reload.
 `;
 
+// src/commands/hallucination-risk.ts
+var import_chalk7 = __toESM(require("chalk"));
+var import_core7 = require("@aiready/core");
+
+// src/commands/agent-grounding.ts
+var import_chalk8 = __toESM(require("chalk"));
+var import_core8 = require("@aiready/core");
+
+// src/commands/testability.ts
+var import_chalk9 = __toESM(require("chalk"));
+var import_core9 = require("@aiready/core");
+
 // src/cli.ts
-var packageJson = JSON.parse((0, import_fs4.readFileSync)((0, import_path7.join)(__dirname, "../package.json"), "utf8"));
+var import_meta = {};
+var getDirname = () => {
+  if (typeof __dirname !== "undefined") return __dirname;
+  return (0, import_path7.dirname)((0, import_url.fileURLToPath)(import_meta.url));
+};
+var packageJson = JSON.parse((0, import_fs5.readFileSync)((0, import_path7.join)(getDirname(), "../package.json"), "utf8"));
 var program = new import_commander.Command();
 program.name("aiready").description("AIReady - Assess and improve AI-readiness of codebases").version(packageJson.version).addHelpText("after", `
 AI READINESS SCORING:
@@ -1215,7 +1413,7 @@ VERSION: ${packageJson.version}
 DOCUMENTATION: https://aiready.dev/docs/cli
 GITHUB: https://github.com/caopengau/aiready-cli
 LANDING: https://github.com/caopengau/aiready-landing`);
-program.command("scan").description("Run comprehensive AI-readiness analysis (patterns + context + consistency)").argument("[directory]", "Directory to analyze", ".").option("-t, --tools <tools>", "Tools to run (comma-separated: patterns,context,consistency)", "patterns,context,consistency").option("--include <patterns>", "File patterns to include (comma-separated)").option("--exclude <patterns>", "File patterns to exclude (comma-separated)").option("-o, --output <format>", "Output format: console, json", "json").option("--output-file <path>", "Output file path (for json)").option("--no-score", "Disable calculating AI Readiness Score (enabled by default)").option("--weights <weights>", "Custom scoring weights (patterns:40,context:35,consistency:25)").option("--threshold <score>", "Fail CI/CD if score below threshold (0-100)").option("--ci", "CI mode: GitHub Actions annotations, no colors, fail on threshold").option("--fail-on <level>", "Fail on issues: critical, major, any", "critical").addHelpText("after", scanHelpText).action(async (directory, options) => {
+program.command("scan").description("Run comprehensive AI-readiness analysis (patterns + context + consistency)").argument("[directory]", "Directory to analyze", ".").option("-t, --tools <tools>", "Tools to run (comma-separated: patterns,context,consistency,hallucination,grounding,testability)").option("--profile <type>", "Scan profile to use (agentic, cost, security, onboarding)").option("--compare-to <path>", "Compare results against a previous AIReady report JSON").option("--include <patterns>", "File patterns to include (comma-separated)").option("--exclude <patterns>", "File patterns to exclude (comma-separated)").option("-o, --output <format>", "Output format: console, json", "json").option("--output-file <path>", "Output file path (for json)").option("--no-score", "Disable calculating AI Readiness Score (enabled by default)").option("--weights <weights>", "Custom scoring weights").option("--threshold <score>", "Fail CI/CD if score below threshold (0-100)").option("--ci", "CI mode: GitHub Actions annotations, no colors, fail on threshold").option("--fail-on <level>", "Fail on issues: critical, major, any", "critical").addHelpText("after", scanHelpText).action(async (directory, options) => {
   await scanAction(directory, options);
 });
 program.command("patterns").description("Detect duplicate code patterns that confuse AI models").argument("[directory]", "Directory to analyze", ".").option("-s, --similarity <number>", "Minimum similarity score (0-1)", "0.40").option("-l, --min-lines <number>", "Minimum lines to consider", "5").option("--max-candidates <number>", "Maximum candidates per block (performance tuning)").option("--min-shared-tokens <number>", "Minimum shared tokens for candidates (performance tuning)").option("--full-scan", "Disable smart defaults for comprehensive analysis (slower)").option("--include <patterns>", "File patterns to include (comma-separated)").option("--exclude <patterns>", "File patterns to exclude (comma-separated)").option("-o, --output <format>", "Output format: console, json", "console").option("--output-file <path>", "Output file path (for json)").option("--score", "Calculate and display AI Readiness Score for patterns (0-100)").addHelpText("after", patternsHelpText).action(async (directory, options) => {