@aiready/cli 0.9.39 → 0.9.40

package/.turbo/turbo-build.log

@@ -1,6 +1,6 @@
 
 
-> @aiready/cli@0.9.39 build /Users/pengcao/projects/aiready/packages/cli
+> @aiready/cli@0.9.40 build /Users/pengcao/projects/aiready/packages/cli
 > tsup src/index.ts src/cli.ts --format cjs,esm
 
 CLI Building entry: src/cli.ts, src/index.ts
@@ -10,7 +10,7 @@
 CJS Build start
 ESM Build start
 
-[1:04:00 PM]  WARN  ▲ [WARNING] "import.meta" is not available with the "cjs" output format and will be empty [empty-import-meta]
+[2:35:42 PM]  WARN  ▲ [WARNING] "import.meta" is not available with the "cjs" output format and will be empty [empty-import-meta]
 
     src/cli.ts:23:31:
       23 │   return dirname(fileURLToPath(import.meta.url));
@@ -20,10 +20,10 @@
 
 
 
+ESM dist/cli.mjs            65.28 KB
 ESM dist/index.mjs          138.00 B
-ESM dist/cli.mjs            63.68 KB
 ESM dist/chunk-PDOONNSK.mjs 7.80 KB
-ESM ⚡️ Build success in 34ms
-CJS dist/cli.js   73.85 KB
+ESM ⚡️ Build success in 491ms
 CJS dist/index.js 9.15 KB
-CJS ⚡️ Build success in 35ms
+CJS dist/cli.js   75.53 KB
+CJS ⚡️ Build success in 492ms

package/.turbo/turbo-test.log

@@ -1,17 +1,17 @@
 
 
-> @aiready/cli@0.9.39 test /Users/pengcao/projects/aiready/packages/cli
+> @aiready/cli@0.9.40 test /Users/pengcao/projects/aiready/packages/cli
 > vitest run
 
 [?25l
  RUN  v4.0.18 /Users/pengcao/projects/aiready/packages/cli
 
- ✓ dist/__tests__/cli.test.js (3 tests) 4ms
- ✓ src/__tests__/cli.test.ts (3 tests) 6ms
+ ✓ src/__tests__/cli.test.ts (3 tests) 5ms
+ ✓ dist/__tests__/cli.test.js (3 tests) 2ms
 
  Test Files  2 passed (2)
       Tests  6 passed (6)
-   Start at  13:04:30
-   Duration  2.67s (transform 1.17s, setup 0ms, import 4.60s, tests 10ms, environment 0ms)
+   Start at  14:39:26
+   Duration  11.33s (transform 3.58s, setup 0ms, import 16.97s, tests 6ms, environment 0ms)
 
 [?25h

package/dist/cli.js

@@ -311,11 +311,11 @@ async function scanAction(directory, options) {
   const resolvedDir = (0, import_path2.resolve)(process.cwd(), directory || ".");
   try {
     const defaults = {
-      tools: ["patterns", "context", "consistency", "aiSignalClarity", "grounding", "testability", "doc-drift", "deps-health"],
+      tools: ["patterns", "context", "consistency", "aiSignalClarity", "grounding", "testability", "doc-drift", "deps-health", "changeAmplification"],
       include: void 0,
       exclude: void 0,
       output: {
-        format: "json",
+        format: "console",
         file: void 0
       }
     };
@@ -343,11 +343,14 @@ async function scanAction(directory, options) {
 \u26A0\uFE0F  Unknown profile '${options.profile}'. Using specified tools or defaults.`));
       }
     }
-    const baseOptions = await (0, import_core.loadMergedConfig)(resolvedDir, defaults, {
-      tools: profileTools,
+    const cliOverrides = {
       include: options.include?.split(","),
       exclude: options.exclude?.split(",")
-    });
+    };
+    if (profileTools) {
+      cliOverrides.tools = profileTools;
+    }
+    const baseOptions = await (0, import_core.loadMergedConfig)(resolvedDir, defaults, cliOverrides);
     let finalOptions = { ...baseOptions };
     if (baseOptions.tools.includes("patterns")) {
       const { getSmartDefaults } = await import("@aiready/pattern-detect");
@@ -490,6 +493,12 @@ async function scanAction(directory, options) {
             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)}`);
           }
+        } else if (event.tool === "change-amplification" || event.tool === "changeAmplification") {
+          const dr = event.data;
+          console.log(`  Coupling issues: ${import_chalk2.default.bold(String(dr.issues?.length || 0))}`);
+          if (dr.summary) {
+            console.log(`  Complexity Score: ${import_chalk2.default.bold(dr.summary.score || 0)}/100`);
+          }
         }
       } catch (err) {
       }
@@ -502,7 +511,8 @@ async function scanAction(directory, options) {
     if (results.duplicates) console.log(`  Duplicate patterns found: ${import_chalk2.default.bold(String(results.duplicates.length || 0))}`);
     if (results.patterns) console.log(`  Pattern files with issues: ${import_chalk2.default.bold(String(results.patterns.length || 0))}`);
     if (results.context) console.log(`  Context issues: ${import_chalk2.default.bold(String(results.context.length || 0))}`);
-    if (results.consistency) console.log(`  Consistency issues: ${import_chalk2.default.bold(String(results.consistency.summary.totalIssues || 0))}`);
+    console.log(`  Consistency issues: ${import_chalk2.default.bold(String(results.consistency?.summary?.totalIssues || 0))}`);
+    if (results.changeAmplification) console.log(`  Change amplification: ${import_chalk2.default.bold(String(results.changeAmplification.summary?.score || 0))}/100`);
     console.log(import_chalk2.default.cyan("===========================\n"));
     const elapsedTime = (0, import_core.getElapsedTime)(startTime);
     let scoringResult;
@@ -536,9 +546,9 @@ async function scanAction(directory, options) {
         }
       }
       if (results.aiSignalClarity) {
-        const { calculateHallucinationScore } = await import("@aiready/ai-signal-clarity");
+        const { calculateAiSignalClarityScore } = await import("@aiready/ai-signal-clarity");
         try {
-          const hrScore = calculateHallucinationScore(results.aiSignalClarity);
+          const hrScore = calculateAiSignalClarityScore(results.aiSignalClarity);
           toolScores.set("ai-signal-clarity", hrScore);
         } catch (err) {
         }
@@ -565,7 +575,7 @@ async function scanAction(directory, options) {
           score: results.docDrift.summary.score,
           rawMetrics: results.docDrift.rawData,
           factors: [],
-          recommendations: results.docDrift.recommendations.map((action) => ({ action, estimatedImpact: 5, priority: "medium" }))
+          recommendations: (results.docDrift.recommendations || []).map((action) => ({ action, estimatedImpact: 5, priority: "medium" }))
         });
       }
       if (results.deps) {
@@ -574,7 +584,16 @@ async function scanAction(directory, options) {
           score: results.deps.summary.score,
           rawMetrics: results.deps.rawData,
           factors: [],
-          recommendations: results.deps.recommendations.map((action) => ({ action, estimatedImpact: 5, priority: "medium" }))
+          recommendations: (results.deps.recommendations || []).map((action) => ({ action, estimatedImpact: 5, priority: "medium" }))
+        });
+      }
+      if (results.changeAmplification) {
+        toolScores.set("change-amplification", {
+          toolName: "change-amplification",
+          score: results.changeAmplification.summary.score,
+          rawMetrics: results.changeAmplification.rawData,
+          factors: [],
+          recommendations: (results.changeAmplification.recommendations || []).map((action) => ({ action, estimatedImpact: 5, priority: "medium" }))
         });
       }
       const cliWeights = (0, import_core.parseWeightString)(options.weights);
@@ -638,6 +657,17 @@ async function scanAction(directory, options) {
       const outputData = { ...results, scoring: scoringResult };
       (0, import_core.handleJSONOutput)(outputData, outputPath, `\u2705 Report saved to ${outputPath}`);
       warnIfGraphCapExceeded(outputData, resolvedDir);
+    } else {
+      const timestamp = getReportTimestamp();
+      const defaultFilename = `aiready-report-${timestamp}.json`;
+      const outputPath = (0, import_core.resolveOutputPath)(userOutputFile, defaultFilename, resolvedDir);
+      const outputData = { ...results, scoring: scoringResult };
+      try {
+        (0, import_fs2.writeFileSync)(outputPath, JSON.stringify(outputData, null, 2));
+        console.log(import_chalk2.default.dim(`\u2705 Report auto-persisted to ${outputPath}`));
+        warnIfGraphCapExceeded(outputData, resolvedDir);
+      } catch (err) {
+      }
     }
     const isCI = options.ci || process.env.CI === "true" || process.env.GITHUB_ACTIONS === "true";
     if (isCI && scoringResult) {
@@ -1403,11 +1433,11 @@ AI READINESS SCORING:
   Use --score flag with any analysis command for detailed breakdown.
 
 EXAMPLES:
-  $ aiready scan                          # Quick analysis of current directory
+  $ aiready scan                          # Comprehensive analysis of current directory
   $ aiready scan --score                  # Get AI Readiness Score (0-100)
   $ aiready scan --tools patterns         # Run only pattern detection
-  $ aiready patterns --similarity 0.6     # Custom similarity threshold
-  $ aiready scan --output json --output-file results.json
+  $ npx @aiready/cli scan                 # Industry standard way to run standard scan
+  $ aiready scan --output json            # Output raw JSON for piping
 
 GETTING STARTED:
   1. Run 'aiready scan' to analyze your codebase
@@ -1433,7 +1463,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,doc-drift,deps-health,aiSignalClarity,grounding,testability,changeAmplification)").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) => {
+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,doc-drift,deps-health,aiSignalClarity,grounding,testability,changeAmplification)").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", "console").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/cli.mjs

@@ -12,7 +12,7 @@ import { fileURLToPath } from "url";
 
 // src/commands/scan.ts
 import chalk2 from "chalk";
-import { readFileSync as readFileSync2 } from "fs";
+import { writeFileSync, readFileSync as readFileSync2 } from "fs";
 import { resolve as resolvePath2 } from "path";
 import {
   loadMergedConfig,
@@ -140,11 +140,11 @@ async function scanAction(directory, options) {
   const resolvedDir = resolvePath2(process.cwd(), directory || ".");
   try {
     const defaults = {
-      tools: ["patterns", "context", "consistency", "aiSignalClarity", "grounding", "testability", "doc-drift", "deps-health"],
+      tools: ["patterns", "context", "consistency", "aiSignalClarity", "grounding", "testability", "doc-drift", "deps-health", "changeAmplification"],
       include: void 0,
       exclude: void 0,
       output: {
-        format: "json",
+        format: "console",
         file: void 0
       }
     };
@@ -172,11 +172,14 @@ async function scanAction(directory, options) {
 \u26A0\uFE0F  Unknown profile '${options.profile}'. Using specified tools or defaults.`));
       }
     }
-    const baseOptions = await loadMergedConfig(resolvedDir, defaults, {
-      tools: profileTools,
+    const cliOverrides = {
       include: options.include?.split(","),
       exclude: options.exclude?.split(",")
-    });
+    };
+    if (profileTools) {
+      cliOverrides.tools = profileTools;
+    }
+    const baseOptions = await loadMergedConfig(resolvedDir, defaults, cliOverrides);
     let finalOptions = { ...baseOptions };
     if (baseOptions.tools.includes("patterns")) {
       const { getSmartDefaults } = await import("@aiready/pattern-detect");
@@ -319,6 +322,12 @@ async function scanAction(directory, options) {
             console.log(`  Deprecated Packages: ${chalk2.bold(dr.rawData.deprecatedPackages || 0)}`);
             console.log(`  AI Cutoff Skew Score: ${chalk2.bold(dr.rawData.trainingCutoffSkew?.toFixed(1) || 0)}`);
           }
+        } else if (event.tool === "change-amplification" || event.tool === "changeAmplification") {
+          const dr = event.data;
+          console.log(`  Coupling issues: ${chalk2.bold(String(dr.issues?.length || 0))}`);
+          if (dr.summary) {
+            console.log(`  Complexity Score: ${chalk2.bold(dr.summary.score || 0)}/100`);
+          }
         }
       } catch (err) {
       }
@@ -331,7 +340,8 @@ async function scanAction(directory, options) {
     if (results.duplicates) console.log(`  Duplicate patterns found: ${chalk2.bold(String(results.duplicates.length || 0))}`);
     if (results.patterns) console.log(`  Pattern files with issues: ${chalk2.bold(String(results.patterns.length || 0))}`);
     if (results.context) console.log(`  Context issues: ${chalk2.bold(String(results.context.length || 0))}`);
-    if (results.consistency) console.log(`  Consistency issues: ${chalk2.bold(String(results.consistency.summary.totalIssues || 0))}`);
+    console.log(`  Consistency issues: ${chalk2.bold(String(results.consistency?.summary?.totalIssues || 0))}`);
+    if (results.changeAmplification) console.log(`  Change amplification: ${chalk2.bold(String(results.changeAmplification.summary?.score || 0))}/100`);
     console.log(chalk2.cyan("===========================\n"));
     const elapsedTime = getElapsedTime(startTime);
     let scoringResult;
@@ -365,9 +375,9 @@ async function scanAction(directory, options) {
         }
       }
       if (results.aiSignalClarity) {
-        const { calculateHallucinationScore } = await import("@aiready/ai-signal-clarity");
+        const { calculateAiSignalClarityScore } = await import("@aiready/ai-signal-clarity");
         try {
-          const hrScore = calculateHallucinationScore(results.aiSignalClarity);
+          const hrScore = calculateAiSignalClarityScore(results.aiSignalClarity);
           toolScores.set("ai-signal-clarity", hrScore);
         } catch (err) {
         }
@@ -394,7 +404,7 @@ async function scanAction(directory, options) {
           score: results.docDrift.summary.score,
           rawMetrics: results.docDrift.rawData,
           factors: [],
-          recommendations: results.docDrift.recommendations.map((action) => ({ action, estimatedImpact: 5, priority: "medium" }))
+          recommendations: (results.docDrift.recommendations || []).map((action) => ({ action, estimatedImpact: 5, priority: "medium" }))
         });
       }
       if (results.deps) {
@@ -403,7 +413,16 @@ async function scanAction(directory, options) {
           score: results.deps.summary.score,
           rawMetrics: results.deps.rawData,
           factors: [],
-          recommendations: results.deps.recommendations.map((action) => ({ action, estimatedImpact: 5, priority: "medium" }))
+          recommendations: (results.deps.recommendations || []).map((action) => ({ action, estimatedImpact: 5, priority: "medium" }))
+        });
+      }
+      if (results.changeAmplification) {
+        toolScores.set("change-amplification", {
+          toolName: "change-amplification",
+          score: results.changeAmplification.summary.score,
+          rawMetrics: results.changeAmplification.rawData,
+          factors: [],
+          recommendations: (results.changeAmplification.recommendations || []).map((action) => ({ action, estimatedImpact: 5, priority: "medium" }))
         });
       }
       const cliWeights = parseWeightString(options.weights);
@@ -467,6 +486,17 @@ async function scanAction(directory, options) {
       const outputData = { ...results, scoring: scoringResult };
       handleJSONOutput(outputData, outputPath, `\u2705 Report saved to ${outputPath}`);
       warnIfGraphCapExceeded(outputData, resolvedDir);
+    } else {
+      const timestamp = getReportTimestamp();
+      const defaultFilename = `aiready-report-${timestamp}.json`;
+      const outputPath = resolveOutputPath(userOutputFile, defaultFilename, resolvedDir);
+      const outputData = { ...results, scoring: scoringResult };
+      try {
+        writeFileSync(outputPath, JSON.stringify(outputData, null, 2));
+        console.log(chalk2.dim(`\u2705 Report auto-persisted to ${outputPath}`));
+        warnIfGraphCapExceeded(outputData, resolvedDir);
+      } catch (err) {
+      }
     }
     const isCI = options.ci || process.env.CI === "true" || process.env.GITHUB_ACTIONS === "true";
     if (isCI && scoringResult) {
@@ -1252,11 +1282,11 @@ AI READINESS SCORING:
   Use --score flag with any analysis command for detailed breakdown.
 
 EXAMPLES:
-  $ aiready scan                          # Quick analysis of current directory
+  $ aiready scan                          # Comprehensive analysis of current directory
   $ aiready scan --score                  # Get AI Readiness Score (0-100)
   $ aiready scan --tools patterns         # Run only pattern detection
-  $ aiready patterns --similarity 0.6     # Custom similarity threshold
-  $ aiready scan --output json --output-file results.json
+  $ npx @aiready/cli scan                 # Industry standard way to run standard scan
+  $ aiready scan --output json            # Output raw JSON for piping
 
 GETTING STARTED:
   1. Run 'aiready scan' to analyze your codebase
@@ -1282,7 +1312,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,doc-drift,deps-health,aiSignalClarity,grounding,testability,changeAmplification)").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) => {
+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,doc-drift,deps-health,aiSignalClarity,grounding,testability,changeAmplification)").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", "console").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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aiready/cli",
-  "version": "0.9.39",
+  "version": "0.9.40",
   "description": "Unified CLI for AIReady analysis tools",
   "main": "./dist/index.js",
   "module": "./dist/index.mjs",
@@ -11,17 +11,17 @@
   "dependencies": {
     "chalk": "^5.3.0",
     "commander": "^14.0.0",
-    "@aiready/agent-grounding": "0.1.4",
-    "@aiready/core": "0.9.31",
-    "@aiready/context-analyzer": "0.9.34",
-    "@aiready/consistency": "0.8.30",
-    "@aiready/visualizer": "0.1.36",
-    "@aiready/doc-drift": "0.1.4",
-    "@aiready/pattern-detect": "0.11.30",
-    "@aiready/deps": "0.1.4",
-    "@aiready/ai-signal-clarity": "0.1.4",
-    "@aiready/change-amplification": "0.1.4",
-    "@aiready/testability": "0.1.4"
+    "@aiready/agent-grounding": "0.1.5",
+    "@aiready/consistency": "0.8.31",
+    "@aiready/core": "0.9.32",
+    "@aiready/context-analyzer": "0.9.35",
+    "@aiready/pattern-detect": "0.11.31",
+    "@aiready/change-amplification": "0.1.5",
+    "@aiready/testability": "0.1.5",
+    "@aiready/visualizer": "0.1.37",
+    "@aiready/deps": "0.1.5",
+    "@aiready/doc-drift": "0.1.5",
+    "@aiready/ai-signal-clarity": "0.1.5"
   },
   "devDependencies": {
     "@types/node": "^24.0.0",

package/src/cli.ts

@@ -37,11 +37,11 @@ AI READINESS SCORING:
   Use --score flag with any analysis command for detailed breakdown.
 
 EXAMPLES:
-  $ aiready scan                          # Quick analysis of current directory
+  $ aiready scan                          # Comprehensive analysis of current directory
   $ aiready scan --score                  # Get AI Readiness Score (0-100)
   $ aiready scan --tools patterns         # Run only pattern detection
-  $ aiready patterns --similarity 0.6     # Custom similarity threshold
-  $ aiready scan --output json --output-file results.json
+  $ npx @aiready/cli scan                 # Industry standard way to run standard scan
+  $ aiready scan --output json            # Output raw JSON for piping
 
 GETTING STARTED:
   1. Run 'aiready scan' to analyze your codebase
@@ -78,7 +78,7 @@ program
   .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('-o, --output <format>', 'Output format: console, json', 'console')
   .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')

package/src/commands/scan.ts

@@ -49,11 +49,11 @@ export async function scanAction(directory: string, options: ScanOptions) {
   try {
     // Define defaults
     const defaults = {
-      tools: ['patterns', 'context', 'consistency', 'aiSignalClarity', 'grounding', 'testability', 'doc-drift', 'deps-health'],
+      tools: ['patterns', 'context', 'consistency', 'aiSignalClarity', 'grounding', 'testability', 'doc-drift', 'deps-health', 'changeAmplification'],
       include: undefined,
       exclude: undefined,
       output: {
-        format: 'json',
+        format: 'console',
         file: undefined,
       },
     };
@@ -83,11 +83,15 @@ export async function scanAction(directory: string, options: ScanOptions) {
     }
 
     // Load and merge config with CLI options
-    const baseOptions = await loadMergedConfig(resolvedDir, defaults, {
-      tools: profileTools as any,
+    const cliOverrides: any = {
       include: options.include?.split(','),
       exclude: options.exclude?.split(','),
-    }) as any;
+    };
+    if (profileTools) {
+      cliOverrides.tools = profileTools;
+    }
+
+    const baseOptions = await loadMergedConfig(resolvedDir, defaults, cliOverrides) as any;
 
 
     // Apply smart defaults for pattern detection if patterns tool is enabled
@@ -258,6 +262,12 @@ export async function scanAction(directory: string, options: ScanOptions) {
             console.log(`  Deprecated Packages: ${chalk.bold(dr.rawData.deprecatedPackages || 0)}`);
             console.log(`  AI Cutoff Skew Score: ${chalk.bold(dr.rawData.trainingCutoffSkew?.toFixed(1) || 0)}`);
           }
+        } else if (event.tool === 'change-amplification' || event.tool === 'changeAmplification') {
+          const dr = event.data as any;
+          console.log(`  Coupling issues: ${chalk.bold(String(dr.issues?.length || 0))}`);
+          if (dr.summary) {
+            console.log(`  Complexity Score: ${chalk.bold(dr.summary.score || 0)}/100`);
+          }
         }
       } catch (err) {
         // don't crash the run for progress printing errors
@@ -276,7 +286,8 @@ export async function scanAction(directory: string, options: ScanOptions) {
     if (results.duplicates) console.log(`  Duplicate patterns found: ${chalk.bold(String(results.duplicates.length || 0))}`);
     if (results.patterns) console.log(`  Pattern files with issues: ${chalk.bold(String(results.patterns.length || 0))}`);
     if (results.context) console.log(`  Context issues: ${chalk.bold(String(results.context.length || 0))}`);
-    if (results.consistency) console.log(`  Consistency issues: ${chalk.bold(String(results.consistency.summary.totalIssues || 0))}`);
+    console.log(`  Consistency issues: ${chalk.bold(String(results.consistency?.summary?.totalIssues || 0))}`);
+    if (results.changeAmplification) console.log(`  Change amplification: ${chalk.bold(String(results.changeAmplification.summary?.score || 0))}/100`);
     console.log(chalk.cyan('===========================\n'));
 
     const elapsedTime = getElapsedTime(startTime);
@@ -324,9 +335,9 @@ export async function scanAction(directory: string, options: ScanOptions) {
 
       // AI signal clarity score
       if (results.aiSignalClarity) {
-        const { calculateHallucinationScore } = await import('@aiready/ai-signal-clarity');
+        const { calculateAiSignalClarityScore } = await import('@aiready/ai-signal-clarity');
         try {
-          const hrScore = calculateHallucinationScore(results.aiSignalClarity);
+          const hrScore = calculateAiSignalClarityScore(results.aiSignalClarity);
           toolScores.set('ai-signal-clarity', hrScore);
         } catch (err) {
           // ignore
@@ -362,7 +373,7 @@ export async function scanAction(directory: string, options: ScanOptions) {
           score: results.docDrift.summary.score,
           rawMetrics: results.docDrift.rawData,
           factors: [],
-          recommendations: results.docDrift.recommendations.map((action: string) => ({ action, estimatedImpact: 5, priority: 'medium' }))
+          recommendations: (results.docDrift.recommendations || []).map((action: string) => ({ action, estimatedImpact: 5, priority: 'medium' }))
         });
       }
 
@@ -373,10 +384,22 @@ export async function scanAction(directory: string, options: ScanOptions) {
           score: results.deps.summary.score,
           rawMetrics: results.deps.rawData,
           factors: [],
-          recommendations: results.deps.recommendations.map((action: string) => ({ action, estimatedImpact: 5, priority: 'medium' }))
+          recommendations: (results.deps.recommendations || []).map((action: string) => ({ action, estimatedImpact: 5, priority: 'medium' }))
+        });
+      }
+
+      // Change Amplification score
+      if (results.changeAmplification) {
+        toolScores.set('change-amplification', {
+          toolName: 'change-amplification',
+          score: results.changeAmplification.summary.score,
+          rawMetrics: results.changeAmplification.rawData,
+          factors: [],
+          recommendations: (results.changeAmplification.recommendations || []).map((action: string) => ({ action, estimatedImpact: 5, priority: 'medium' }))
         });
       }
 
+
       // Parse CLI weight overrides (if any)
       const cliWeights = parseWeightString((options as any).weights);
 
@@ -454,6 +477,21 @@ export async function scanAction(directory: string, options: ScanOptions) {
 
       // Warn if graph caps may be exceeded
       warnIfGraphCapExceeded(outputData, resolvedDir);
+    } else {
+      // Auto-persist report even in console mode for downstream tools
+      const timestamp = getReportTimestamp();
+      const defaultFilename = `aiready-report-${timestamp}.json`;
+      const outputPath = resolveOutputPath(userOutputFile, defaultFilename, resolvedDir);
+      const outputData = { ...results, scoring: scoringResult };
+
+      try {
+        writeFileSync(outputPath, JSON.stringify(outputData, null, 2));
+        console.log(chalk.dim(`✅ Report auto-persisted to ${outputPath}`));
+        // Warn if graph caps may be exceeded
+        warnIfGraphCapExceeded(outputData, resolvedDir);
+      } catch (err) {
+        // failed to save report, but don't fail the command
+      }
     }
 
     // CI/CD Gatekeeper Mode