@aiready/cli 0.9.33 → 0.9.36

package/dist/cli.mjs

@@ -1,16 +1,23 @@
 #!/usr/bin/env node
 import {
-  __require,
   analyzeUnified
-} from "./chunk-5GZDRZ3T.mjs";
+} from "./chunk-N4SLON5K.mjs";
+import "./chunk-RBWLQRKR.mjs";
+import "./chunk-YIS6WTY5.mjs";
+import "./chunk-XAF2EW5H.mjs";
+import {
+  __require
+} from "./chunk-Y6FXYEAI.mjs";
 
 // src/cli.ts
 import { Command } from "commander";
-import { readFileSync as readFileSync3 } from "fs";
-import { join } from "path";
+import { readFileSync as readFileSync4 } from "fs";
+import { join, dirname } from "path";
+import { fileURLToPath } from "url";
 
 // src/commands/scan.ts
 import chalk2 from "chalk";
+import { readFileSync as readFileSync2 } from "fs";
 import { resolve as resolvePath2 } from "path";
 import {
   loadMergedConfig,
@@ -138,7 +145,7 @@ async function scanAction(directory, options) {
   const resolvedDir = resolvePath2(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: {
@@ -146,8 +153,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(chalk2.yellow(`
+\u26A0\uFE0F  Unknown profile '${options.profile}'. Using specified tools or defaults.`));
+      }
+    }
     const baseOptions = await 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(",")
     });
@@ -279,6 +306,20 @@ async function scanAction(directory, options) {
               console.log(chalk2.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: ${chalk2.bold(String(dr.issues?.length || 0))}`);
+          if (dr.rawData) {
+            console.log(`  Signature Mismatches: ${chalk2.bold(dr.rawData.outdatedComments || 0)}`);
+            console.log(`  Undocumented Complexity: ${chalk2.bold(dr.rawData.undocumentedComplexity || 0)}`);
+          }
+        } else if (event.tool === "deps-health") {
+          const dr = event.data;
+          console.log(`  Packages Analyzed: ${chalk2.bold(String(dr.summary?.packagesAnalyzed || 0))}`);
+          if (dr.rawData) {
+            console.log(`  Deprecated Packages: ${chalk2.bold(dr.rawData.deprecatedPackages || 0)}`);
+            console.log(`  AI Cutoff Skew Score: ${chalk2.bold(dr.rawData.trainingCutoffSkew?.toFixed(1) || 0)}`);
+          }
         }
       } catch (err) {
       }
@@ -324,11 +365,82 @@ async function scanAction(directory, options) {
         } catch (err) {
         }
       }
+      if (finalOptions.tools.includes("hallucination") || finalOptions.tools.includes("hallucination-risk")) {
+        try {
+          const { hallucinationRiskAction: hallucinationRiskAction2 } = await import("./hallucination-risk-XU6E7IGN.mjs");
+          const hrScore = await hallucinationRiskAction2(resolvedDir, { ...finalOptions, output: "json" });
+          if (hrScore) toolScores.set("hallucination-risk", hrScore);
+        } catch (err) {
+        }
+      }
+      if (finalOptions.tools.includes("grounding") || finalOptions.tools.includes("agent-grounding")) {
+        try {
+          const { agentGroundingAction: agentGroundingAction2 } = await import("./agent-grounding-DAOSU4MF.mjs");
+          const agScore = await agentGroundingAction2(resolvedDir, { ...finalOptions, output: "json" });
+          if (agScore) toolScores.set("agent-grounding", agScore);
+        } catch (err) {
+        }
+      }
+      if (finalOptions.tools.includes("testability")) {
+        try {
+          const { testabilityAction: testabilityAction2 } = await import("./testability-VDZJZ4MF.mjs");
+          const tbScore = await testabilityAction2(resolvedDir, { ...finalOptions, output: "json" });
+          if (tbScore) 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 = parseWeightString(options.weights);
       if (toolScores.size > 0) {
         scoringResult = calculateOverallScore(toolScores, finalOptions, cliWeights.size ? cliWeights : void 0);
         console.log(chalk2.bold("\n\u{1F4CA} AI Readiness Overall Score"));
         console.log(`  ${formatScore(scoringResult)}`);
+        if (options.compareTo) {
+          try {
+            const prevReportStr = readFileSync2(resolvePath2(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(chalk2.green(`  \u{1F4C8} Trend: ${diffStr} compared to ${options.compareTo} (${prevScore} \u2192 ${scoringResult.overall})`));
+              } else if (diff < 0) {
+                console.log(chalk2.red(`  \u{1F4C9} Trend: ${diffStr} compared to ${options.compareTo} (${prevScore} \u2192 ${scoringResult.overall})`));
+              } else {
+                console.log(chalk2.blue(`  \u2796 Trend: No change compared to ${options.compareTo} (${prevScore} \u2192 ${scoringResult.overall})`));
+              }
+              scoringResult.trend = {
+                previousScore: prevScore,
+                difference: diff
+              };
+            } else {
+              console.log(chalk2.yellow(`
+  \u26A0\uFE0F  Previous report at ${options.compareTo} does not contain an overall score.`));
+            }
+          } catch (e) {
+            console.log(chalk2.yellow(`
+  \u26A0\uFE0F  Could not read or parse previous report at ${options.compareTo}.`));
+          }
+        }
         if (scoringResult.breakdown && scoringResult.breakdown.length > 0) {
           console.log(chalk2.bold("\nTool breakdown:"));
           scoringResult.breakdown.forEach((tool) => {
@@ -364,17 +476,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(
@@ -387,9 +499,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 };
@@ -437,7 +549,7 @@ async function scanAction(directory, options) {
       } else {
         console.log(chalk2.green("\n\u2705 PR PASSED: AI Readiness Check"));
         if (threshold) {
-          console.log(chalk2.green(`   Score: ${scoringResult.overallScore}/100 (threshold: ${threshold})`));
+          console.log(chalk2.green(`   Score: ${scoringResult.overall}/100 (threshold: ${threshold})`));
         }
         console.log(chalk2.dim("\n   \u{1F4A1} Track historical trends: https://getaiready.dev \u2014 Team plan $99/mo"));
       }
@@ -450,11 +562,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
@@ -741,7 +862,7 @@ async function contextAction(directory, options) {
 
 // src/commands/consistency.ts
 import chalk5 from "chalk";
-import { writeFileSync } from "fs";
+import { writeFileSync as writeFileSync2 } from "fs";
 import { resolve as resolvePath5 } from "path";
 import {
   loadMergedConfig as loadMergedConfig4,
@@ -806,7 +927,7 @@ async function consistencyAction(directory, options) {
         `aiready-report-${getReportTimestamp()}.md`,
         resolvedDir
       );
-      writeFileSync(outputPath, markdown);
+      writeFileSync2(outputPath, markdown);
       console.log(chalk5.green(`\u2705 Report saved to ${outputPath}`));
     } else {
       console.log(chalk5.bold("\n\u{1F4CA} Summary\n"));
@@ -893,7 +1014,7 @@ async function consistencyAction(directory, options) {
 
 // src/commands/visualize.ts
 import chalk6 from "chalk";
-import { writeFileSync as writeFileSync2, readFileSync as readFileSync2, existsSync as existsSync2, copyFileSync as copyFileSync2 } from "fs";
+import { writeFileSync as writeFileSync3, readFileSync as readFileSync3, existsSync as existsSync2, copyFileSync as copyFileSync2 } from "fs";
 import { resolve as resolvePath6 } from "path";
 import { spawn } from "child_process";
 import { handleCLIError as handleCLIError5 } from "@aiready/core";
@@ -918,13 +1039,13 @@ Or specify a custom report:
         return;
       }
     }
-    const raw = readFileSync2(reportPath, "utf8");
+    const raw = readFileSync3(reportPath, "utf8");
     const report = JSON.parse(raw);
     const configPath = resolvePath6(dirPath, "aiready.json");
     let graphConfig = { maxNodes: 400, maxEdges: 600 };
     if (existsSync2(configPath)) {
       try {
-        const rawConfig = JSON.parse(readFileSync2(configPath, "utf8"));
+        const rawConfig = JSON.parse(readFileSync3(configPath, "utf8"));
         if (rawConfig.visualizer?.graph) {
           graphConfig = {
             maxNodes: rawConfig.visualizer.graph.maxNodes ?? graphConfig.maxNodes,
@@ -1032,7 +1153,7 @@ Or specify a custom report:
     const html = generateHTML(graph);
     const defaultOutput = "visualization.html";
     const outPath = resolvePath6(dirPath, options.output || defaultOutput);
-    writeFileSync2(outPath, html, "utf8");
+    writeFileSync3(outPath, html, "utf8");
     console.log(chalk6.green(`\u2705 Visualization written to: ${outPath}`));
     if (options.open || options.serve) {
       const opener = process.platform === "darwin" ? "open" : process.platform === "win32" ? "start" : "xdg-open";
@@ -1105,7 +1226,11 @@ NOTES:
 `;
 
 // src/cli.ts
-var packageJson = JSON.parse(readFileSync3(join(__dirname, "../package.json"), "utf8"));
+var getDirname = () => {
+  if (typeof __dirname !== "undefined") return __dirname;
+  return dirname(fileURLToPath(import.meta.url));
+};
+var packageJson = JSON.parse(readFileSync4(join(getDirname(), "../package.json"), "utf8"));
 var program = new Command();
 program.name("aiready").description("AIReady - Assess and improve AI-readiness of codebases").version(packageJson.version).addHelpText("after", `
 AI READINESS SCORING:
@@ -1143,7 +1268,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) => {

package/dist/deps-health-UWVYJ7FZ.mjs

@@ -0,0 +1,47 @@
+import "./chunk-Y6FXYEAI.mjs";
+
+// src/commands/deps-health.ts
+import chalk from "chalk";
+import { loadConfig, mergeConfigWithDefaults } from "@aiready/core";
+async function depsHealthAction(directory, options) {
+  const { analyzeDeps } = await import("@aiready/deps");
+  const config = await loadConfig(directory);
+  const merged = mergeConfigWithDefaults(config, {
+    trainingCutoffYear: 2023
+  });
+  const report = await analyzeDeps({
+    rootDir: directory,
+    include: options.include,
+    exclude: options.exclude,
+    trainingCutoffYear: options.trainingCutoffYear ?? merged.trainingCutoffYear ?? 2023
+  });
+  const scoring = {
+    toolName: "dependency-health",
+    score: report.summary.score,
+    rawMetrics: report.rawData,
+    factors: [],
+    recommendations: report.recommendations.map((action) => ({ action, estimatedImpact: 5, priority: "medium" }))
+  };
+  if (options.output === "json") {
+    return scoring;
+  }
+  const { summary } = report;
+  const ratingColors = {
+    excellent: chalk.green,
+    good: chalk.blueBright,
+    moderate: chalk.yellow,
+    poor: chalk.red,
+    hazardous: chalk.bgRed.white
+  };
+  const color = ratingColors[summary.rating] ?? chalk.white;
+  console.log(`  \u{1F4E6} Dependency Health:  ${chalk.bold(scoring.score + "/100 health")} (${color(summary.rating)})`);
+  if (report.issues.length > 0) {
+    console.log(chalk.dim(`     Found ${report.issues.length} dependency issues.`));
+  } else {
+    console.log(chalk.dim(`     Dependencies look healthy for AI assistance.`));
+  }
+  return scoring;
+}
+export {
+  depsHealthAction
+};

package/dist/doc-drift-G7MGAZAE.mjs

@@ -0,0 +1,47 @@
+import "./chunk-Y6FXYEAI.mjs";
+
+// src/commands/doc-drift.ts
+import chalk from "chalk";
+import { loadConfig, mergeConfigWithDefaults } from "@aiready/core";
+async function docDriftAction(directory, options) {
+  const { analyzeDocDrift } = await import("@aiready/doc-drift");
+  const config = await loadConfig(directory);
+  const merged = mergeConfigWithDefaults(config, {
+    staleMonths: 6
+  });
+  const report = await analyzeDocDrift({
+    rootDir: directory,
+    include: options.include,
+    exclude: options.exclude,
+    staleMonths: options.staleMonths ?? merged.staleMonths ?? 6
+  });
+  const scoring = {
+    toolName: "doc-drift",
+    score: report.summary.score,
+    rawMetrics: report.rawData,
+    factors: [],
+    recommendations: report.recommendations.map((action) => ({ action, estimatedImpact: 5, priority: "medium" }))
+  };
+  if (options.output === "json") {
+    return scoring;
+  }
+  const { summary } = report;
+  const ratingColors = {
+    minimal: chalk.green,
+    low: chalk.cyan,
+    moderate: chalk.yellow,
+    high: chalk.red,
+    severe: chalk.bgRed.white
+  };
+  const color = ratingColors[summary.rating] ?? chalk.white;
+  console.log(`  \u{1F4DD} Documentation Drift:  ${chalk.bold(100 - scoring.score + "/100 health")} (${color(summary.rating)} risk)`);
+  if (report.issues.length > 0) {
+    console.log(chalk.dim(`     Found ${report.issues.length} drift issues.`));
+  } else {
+    console.log(chalk.dim(`     No documentation drift detected.`));
+  }
+  return scoring;
+}
+export {
+  docDriftAction
+};

package/dist/hallucination-risk-XU6E7IGN.mjs

@@ -0,0 +1,7 @@
+import {
+  hallucinationRiskAction
+} from "./chunk-RBWLQRKR.mjs";
+import "./chunk-Y6FXYEAI.mjs";
+export {
+  hallucinationRiskAction
+};

package/dist/index.js

@@ -1,7 +1,9 @@
 "use strict";
+var __create = Object.create;
 var __defProp = Object.defineProperty;
 var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
 var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
 var __hasOwnProp = Object.prototype.hasOwnProperty;
 var __export = (target, all) => {
   for (var name in all)
@@ -15,6 +17,14 @@ var __copyProps = (to, from, except, desc) => {
   }
   return to;
 };
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
 var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
 
 // src/index.ts
@@ -105,6 +115,32 @@ 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;
+  }
   result.summary.executionTime = Date.now() - startTime;
   return result;
 }
@@ -132,6 +168,14 @@ function generateUnifiedSummary(result) {
   }
   if (result.consistency) {
     output += `\u{1F3F7}\uFE0F Consistency Analysis: ${result.consistency.summary.totalIssues} issues
+`;
+  }
+  if (result.docDrift) {
+    output += `\u{1F4DD} Doc Drift Analysis: ${result.docDrift.issues?.length || 0} issues
+`;
+  }
+  if (result.deps) {
+    output += `\u{1F4E6} Dependency Health: ${result.deps.issues?.length || 0} issues
 `;
   }
   return output;

package/dist/index.mjs

@@ -1,7 +1,8 @@
 import {
   analyzeUnified,
   generateUnifiedSummary
-} from "./chunk-5GZDRZ3T.mjs";
+} from "./chunk-N4SLON5K.mjs";
+import "./chunk-Y6FXYEAI.mjs";
 export {
   analyzeUnified,
   generateUnifiedSummary

package/dist/testability-VDZJZ4MF.mjs

@@ -0,0 +1,7 @@
+import {
+  testabilityAction
+} from "./chunk-XAF2EW5H.mjs";
+import "./chunk-Y6FXYEAI.mjs";
+export {
+  testabilityAction
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aiready/cli",
-  "version": "0.9.33",
+  "version": "0.9.36",
   "description": "Unified CLI for AIReady analysis tools",
   "main": "./dist/index.js",
   "module": "./dist/index.mjs",
@@ -9,17 +9,22 @@
     "aiready": "./dist/cli.js"
   },
   "dependencies": {
-    "commander": "^14.0.0",
     "chalk": "^5.3.0",
-    "@aiready/context-analyzer": "0.9.28",
-    "@aiready/core": "0.9.25",
-    "@aiready/visualizer": "0.1.30",
-    "@aiready/pattern-detect": "0.11.24",
-    "@aiready/consistency": "0.8.24"
+    "commander": "^14.0.0",
+    "@aiready/consistency": "0.8.27",
+    "@aiready/context-analyzer": "0.9.31",
+    "@aiready/core": "0.9.28",
+    "@aiready/deps": "0.1.1",
+    "@aiready/agent-grounding": "0.1.1",
+    "@aiready/doc-drift": "0.1.1",
+    "@aiready/pattern-detect": "0.11.27",
+    "@aiready/testability": "0.1.1",
+    "@aiready/visualizer": "0.1.33",
+    "@aiready/hallucination-risk": "0.1.1"
   },
   "devDependencies": {
-    "tsup": "^8.3.5",
-    "@types/node": "^24.0.0"
+    "@types/node": "^24.0.0",
+    "tsup": "^8.3.5"
   },
   "keywords": [
     "aiready",

package/src/cli.ts

@@ -2,7 +2,8 @@
 
 import { Command } from 'commander';
 import { readFileSync } from 'fs';
-import { join } from 'path';
+import { join, dirname } from 'path';
+import { fileURLToPath } from 'url';
 
 import {
   scanAction,
@@ -16,7 +17,12 @@ import {
   visualiseHelpText,
 } from './commands';
 
-const packageJson = JSON.parse(readFileSync(join(__dirname, '../package.json'), 'utf8'));
+const getDirname = () => {
+  if (typeof __dirname !== 'undefined') return __dirname;
+  return dirname(fileURLToPath(import.meta.url));
+};
+
+const packageJson = JSON.parse(readFileSync(join(getDirname(), '../package.json'), 'utf8'));
 
 const program = new Command();
 
@@ -66,13 +72,15 @@ 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('-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 (patterns:40,context:35,consistency:25)')
+  .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')

package/src/commands/agent-grounding.ts

@@ -0,0 +1,47 @@
+/**
+ * Agent grounding command for unified CLI
+ */
+
+import chalk from 'chalk';
+import { loadConfig, mergeConfigWithDefaults } from '@aiready/core';
+import type { ToolScoringOutput } from '@aiready/core';
+
+export async function agentGroundingAction(
+  directory: string,
+  options: any,
+): Promise<ToolScoringOutput | undefined> {
+  const { analyzeAgentGrounding, calculateGroundingScore } = await import('@aiready/agent-grounding');
+
+  const config = await loadConfig(directory);
+  const merged = mergeConfigWithDefaults(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: number) =>
+    s >= 85 ? chalk.green : s >= 70 ? chalk.cyan : s >= 50 ? chalk.yellow : chalk.red;
+
+  console.log(`  🧭 Agent Grounding:     ${chalk.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(chalk.dim(`     Weakest dimension: ${name} (${worstDim[1]}/100)`));
+  }
+
+  return scoring;
+}