@aiready/cli 0.9.38 → 0.9.40

package/dist/cli.mjs

@@ -2,7 +2,7 @@
 import {
   __require,
   analyzeUnified
-} from "./chunk-JQG7ZATX.mjs";
+} from "./chunk-PDOONNSK.mjs";
 
 // src/cli.ts
 import { Command } from "commander";
@@ -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,19 +140,23 @@ async function scanAction(directory, options) {
   const resolvedDir = resolvePath2(process.cwd(), directory || ".");
   try {
     const defaults = {
-      tools: ["patterns", "context", "consistency", "hallucination", "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
       }
     };
-    let profileTools = options.tools ? options.tools.split(",").map((t) => t.trim()) : void 0;
+    let profileTools = options.tools ? options.tools.split(",").map((t) => {
+      const tool = t.trim();
+      if (tool === "hallucination" || tool === "hallucination-risk") return "aiSignalClarity";
+      return tool;
+    }) : void 0;
     if (options.profile) {
       switch (options.profile.toLowerCase()) {
         case "agentic":
-          profileTools = ["hallucination", "grounding", "testability"];
+          profileTools = ["aiSignalClarity", "grounding", "testability"];
           break;
         case "cost":
           profileTools = ["patterns", "context"];
@@ -168,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");
@@ -315,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) {
       }
@@ -327,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;
@@ -360,11 +374,11 @@ async function scanAction(directory, options) {
         } catch (err) {
         }
       }
-      if (results.hallucination) {
-        const { calculateHallucinationScore } = await import("@aiready/hallucination-risk");
+      if (results.aiSignalClarity) {
+        const { calculateAiSignalClarityScore } = await import("@aiready/ai-signal-clarity");
         try {
-          const hrScore = calculateHallucinationScore(results.hallucination);
-          toolScores.set("hallucination-risk", hrScore);
+          const hrScore = calculateAiSignalClarityScore(results.aiSignalClarity);
+          toolScores.set("ai-signal-clarity", hrScore);
         } catch (err) {
         }
       }
@@ -390,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) {
@@ -399,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);
@@ -463,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) {
@@ -566,7 +600,7 @@ EXAMPLES:
   $ aiready scan --output json --output-file report.json
 
 PROFILES:
-  agentic:      hallucination, grounding, testability
+  agentic:      aiSignalClarity, grounding, testability
   cost:         patterns, context
   security:     consistency, testability
   onboarding:   context, consistency, grounding
@@ -1220,7 +1254,7 @@ NOTES:
   - Same options as 'visualize'. Use --serve to host the static HTML, or --dev for live reload.
 `;
 
-// src/commands/hallucination-risk.ts
+// src/commands/ai-signal-clarity.ts
 import chalk7 from "chalk";
 import { loadConfig, mergeConfigWithDefaults } from "@aiready/core";
 
@@ -1232,6 +1266,9 @@ import { loadConfig as loadConfig2, mergeConfigWithDefaults as mergeConfigWithDe
 import chalk9 from "chalk";
 import { loadConfig as loadConfig3, mergeConfigWithDefaults as mergeConfigWithDefaults3 } from "@aiready/core";
 
+// src/commands/change-amplification.ts
+import { changeAmplificationAction } from "@aiready/change-amplification/dist/cli.js";
+
 // src/cli.ts
 var getDirname = () => {
   if (typeof __dirname !== "undefined") return __dirname;
@@ -1245,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
@@ -1275,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,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) => {
+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) => {
@@ -1293,4 +1330,7 @@ program.command("visualise").description("Alias for visualize (British spelling)
 program.command("visualize").description("Generate interactive visualization from an AIReady report").argument("[directory]", "Directory to analyze", ".").option("--report <path>", "Report path (auto-detects latest .aiready/aiready-report-*.json if not provided)").option("-o, --output <path>", "Output HTML path (relative to directory)", "packages/visualizer/visualization.html").option("--open", "Open generated HTML in default browser").option("--serve [port]", "Start a local static server to serve the visualization (optional port number)", false).option("--dev", "Start Vite dev server (live reload) for interactive development", false).addHelpText("after", visualizeHelpText).action(async (directory, options) => {
   await visualizeAction(directory, options);
 });
+program.command("change-amplification").description("Analyze graph metrics for change amplification").argument("[directory]", "Directory to analyze", ".").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)").action(async (directory, options) => {
+  await changeAmplificationAction(directory, options);
+});
 program.parse();

package/dist/index.js

@@ -141,17 +141,17 @@ async function analyzeUnified(options) {
     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({
+  if (tools.includes("aiSignalClarity")) {
+    const { analyzeAiSignalClarity } = await import("@aiready/ai-signal-clarity");
+    const report = await analyzeAiSignalClarity({
       rootDir: options.rootDir,
       include: options.include,
       exclude: options.exclude
     });
     if (options.progressCallback) {
-      options.progressCallback({ tool: "hallucination", data: report });
+      options.progressCallback({ tool: "aiSignalClarity", data: report });
     }
-    result.hallucination = report;
+    result.aiSignalClarity = report;
     result.summary.totalIssues += report.results?.reduce((sum, r) => sum + (r.issues?.length || 0), 0) || 0;
   }
   if (tools.includes("grounding")) {
@@ -180,6 +180,19 @@ async function analyzeUnified(options) {
     result.testability = report;
     result.summary.totalIssues += report.issues?.length || 0;
   }
+  if (tools.includes("changeAmplification")) {
+    const { analyzeChangeAmplification } = await import("@aiready/change-amplification");
+    const report = await analyzeChangeAmplification({
+      rootDir: options.rootDir,
+      include: options.include,
+      exclude: options.exclude
+    });
+    if (options.progressCallback) {
+      options.progressCallback({ tool: "changeAmplification", data: report });
+    }
+    result.changeAmplification = report;
+    result.summary.totalIssues += report.summary?.totalIssues || 0;
+  }
   result.summary.executionTime = Date.now() - startTime;
   return result;
 }
@@ -217,8 +230,8 @@ function generateUnifiedSummary(result) {
     output += `\u{1F4E6} Dependency Health: ${result.deps.issues?.length || 0} issues
 `;
   }
-  if (result.hallucination) {
-    output += `\u{1F9E0} Hallucination Risk: ${result.hallucination.summary?.totalSignals || 0} signals
+  if (result.aiSignalClarity) {
+    output += `\u{1F9E0} AI Signal Clarity: ${result.aiSignalClarity.summary?.totalSignals || 0} signals
 `;
   }
   if (result.grounding) {
@@ -227,6 +240,10 @@ function generateUnifiedSummary(result) {
   }
   if (result.testability) {
     output += `\u{1F9EA} Testability Index: ${result.testability.issues?.length || 0} issues
+`;
+  }
+  if (result.changeAmplification) {
+    output += `\u{1F4A5} Change Amplification: ${result.changeAmplification.summary?.totalIssues || 0} cascading risks
 `;
   }
   return output;

package/dist/index.mjs

@@ -1,7 +1,7 @@
 import {
   analyzeUnified,
   generateUnifiedSummary
-} from "./chunk-JQG7ZATX.mjs";
+} from "./chunk-PDOONNSK.mjs";
 export {
   analyzeUnified,
   generateUnifiedSummary

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aiready/cli",
-  "version": "0.9.38",
+  "version": "0.9.40",
   "description": "Unified CLI for AIReady analysis tools",
   "main": "./dist/index.js",
   "module": "./dist/index.mjs",
@@ -11,16 +11,17 @@
   "dependencies": {
     "chalk": "^5.3.0",
     "commander": "^14.0.0",
-    "@aiready/core": "0.9.30",
-    "@aiready/context-analyzer": "0.9.33",
-    "@aiready/deps": "0.1.3",
-    "@aiready/agent-grounding": "0.1.3",
-    "@aiready/consistency": "0.8.29",
-    "@aiready/visualizer": "0.1.35",
-    "@aiready/testability": "0.1.3",
-    "@aiready/pattern-detect": "0.11.29",
-    "@aiready/hallucination-risk": "0.1.3",
-    "@aiready/doc-drift": "0.1.3"
+    "@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

@@ -15,6 +15,7 @@ import {
   visualizeAction,
   visualizeHelpText,
   visualiseHelpText,
+  changeAmplificationAction,
 } from './commands';
 
 const getDirname = () => {
@@ -36,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
@@ -72,12 +73,12 @@ 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('-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('-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')
@@ -174,4 +175,17 @@ program
     await visualizeAction(directory, options);
   });
 
+// Change Amplification command
+program
+  .command('change-amplification')
+  .description('Analyze graph metrics for change amplification')
+  .argument('[directory]', 'Directory to analyze', '.')
+  .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)')
+  .action(async (directory, options) => {
+    await changeAmplificationAction(directory, options);
+  });
+
 program.parse();

package/src/commands/{hallucination-risk.ts → ai-signal-clarity.ts}

@@ -1,5 +1,5 @@
 /**
- * Hallucination risk command for unified CLI
+ * AI signal clarity command for unified CLI
  */
 
 import chalk from 'chalk';
@@ -8,18 +8,18 @@ import { join } from 'path';
 import { resolveOutputPath, loadConfig, mergeConfigWithDefaults } from '@aiready/core';
 import type { ToolScoringOutput } from '@aiready/core';
 
-export async function hallucinationRiskAction(
+export async function aiSignalClarityAction(
   directory: string,
   options: any,
 ): Promise<ToolScoringOutput | undefined> {
-  const { analyzeHallucinationRisk, calculateHallucinationScore } = await import('@aiready/hallucination-risk');
+  const { analyzeAiSignalClarity, calculateHallucinationScore } = await import('@aiready/ai-signal-clarity');
 
   const config = await loadConfig(directory);
   const merged = mergeConfigWithDefaults(config, {
     minSeverity: 'info',
   });
 
-  const report = await analyzeHallucinationRisk({
+  const report = await analyzeAiSignalClarity({
     rootDir: directory,
     minSeverity: options.minSeverity ?? merged.minSeverity ?? 'info',
     include: options.include,
@@ -41,7 +41,7 @@ export async function hallucinationRiskAction(
     severe: chalk.bgRed.white,
   };
   const color = ratingColors[summary.rating] ?? chalk.white;
-  console.log(`  🧠 Hallucination Risk:  ${chalk.bold(scoring.score + '/100')} (${color(summary.rating)})`);
+  console.log(`  🧠 AI Signal Clarity:  ${chalk.bold(scoring.score + '/100')} (${color(summary.rating)})`);
   console.log(`     Top Risk: ${chalk.italic(summary.topRisk)}`);
   if (summary.totalSignals > 0) {
     console.log(chalk.dim(`     ${summary.criticalSignals} critical  ${summary.majorSignals} major  ${summary.minorSignals} minor signals`));

package/src/commands/change-amplification.ts

@@ -0,0 +1,3 @@
+import { changeAmplificationAction } from '@aiready/change-amplification/dist/cli.js';
+
+export { changeAmplificationAction };

package/src/commands/index.ts

@@ -7,6 +7,7 @@ export { patternsAction, patternsHelpText } from './patterns';
 export { contextAction } from './context';
 export { consistencyAction } from './consistency';
 export { visualizeAction, visualizeHelpText, visualiseHelpText } from './visualize';
-export { hallucinationRiskAction } from './hallucination-risk';
+export { aiSignalClarityAction } from './ai-signal-clarity';
 export { agentGroundingAction } from './agent-grounding';
-export { testabilityAction } from './testability';
+export { testabilityAction } from './testability';
+export { changeAmplificationAction } from './change-amplification';

package/src/commands/scan.ts

@@ -49,20 +49,24 @@ export async function scanAction(directory: string, options: ScanOptions) {
   try {
     // Define defaults
     const defaults = {
-      tools: ['patterns', 'context', 'consistency', 'hallucination', '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,
       },
     };
 
-    let profileTools = options.tools ? options.tools.split(',').map((t: string) => t.trim()) : undefined;
+    let profileTools = options.tools ? options.tools.split(',').map((t: string) => {
+      const tool = t.trim();
+      if (tool === 'hallucination' || tool === 'hallucination-risk') return 'aiSignalClarity';
+      return tool;
+    }) : undefined;
     if (options.profile) {
       switch (options.profile.toLowerCase()) {
         case 'agentic':
-          profileTools = ['hallucination', 'grounding', 'testability'];
+          profileTools = ['aiSignalClarity', 'grounding', 'testability'];
           break;
         case 'cost':
           profileTools = ['patterns', 'context'];
@@ -79,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
@@ -254,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
@@ -272,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);
@@ -318,12 +333,12 @@ export async function scanAction(directory: string, options: ScanOptions) {
         }
       }
 
-      // Hallucination risk score
-      if (results.hallucination) {
-        const { calculateHallucinationScore } = await import('@aiready/hallucination-risk');
+      // AI signal clarity score
+      if (results.aiSignalClarity) {
+        const { calculateAiSignalClarityScore } = await import('@aiready/ai-signal-clarity');
         try {
-          const hrScore = calculateHallucinationScore(results.hallucination);
-          toolScores.set('hallucination-risk', hrScore);
+          const hrScore = calculateAiSignalClarityScore(results.aiSignalClarity);
+          toolScores.set('ai-signal-clarity', hrScore);
         } catch (err) {
           // ignore
         }
@@ -358,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' }))
         });
       }
 
@@ -369,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);
 
@@ -450,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
@@ -572,7 +614,7 @@ EXAMPLES:
   $ aiready scan --output json --output-file report.json
 
 PROFILES:
-  agentic:      hallucination, grounding, testability
+  agentic:      aiSignalClarity, grounding, testability
   cost:         patterns, context
   security:     consistency, testability
   onboarding:   context, consistency, grounding