@aiready/cli 0.14.8 → 0.14.10

package/dist/cli.mjs

@@ -3,7 +3,7 @@ import {
   __require,
   analyzeUnified,
   scoreUnified
-} from "./chunk-VOKP7FGM.mjs";
+} from "./chunk-JRRBBFYB.mjs";
 
 // src/cli.ts
 import { Command } from "commander";
@@ -134,7 +134,7 @@ import {
 function printScanSummary(results, startTime) {
   console.log(chalk2.cyan("\n=== AIReady Run Summary ==="));
   console.log(
-    `  Total issues (all tools): ${chalk2.bold(String(results.summary.totalIssues || 0))}`
+    `  Total issues (all tools): ${chalk2.bold(String(results.summary.totalIssues ?? 0))}`
   );
   console.log(
     `  Execution time: ${chalk2.bold(((Date.now() - startTime) / 1e3).toFixed(2) + "s")}`
@@ -169,7 +169,7 @@ function printScoring(scoringResult, scoringProfile) {
       );
     });
     const allRecs = scoringResult.breakdown.flatMap(
-      (t) => (t.recommendations || []).map((r) => ({ ...r, tool: t.toolName }))
+      (t) => (t.recommendations ?? []).map((r) => ({ ...r, tool: t.toolName }))
     ).sort((a, b) => b.estimatedImpact - a.estimatedImpact).slice(0, 3);
     if (allRecs.length > 0) {
       console.log(chalk2.bold("\n\u{1F3AF} Top Actionable Recommendations:"));
@@ -223,8 +223,8 @@ import { handleCLIError } from "@aiready/core";
 async function uploadAction(file, options) {
   const startTime = Date.now();
   const filePath = resolvePath2(process.cwd(), file);
-  const serverUrl = options.server || process.env.AIREADY_SERVER || "https://dev.platform.getaiready.dev";
-  const apiKey = options.apiKey || process.env.AIREADY_API_KEY;
+  const serverUrl = options.server ?? process.env.AIREADY_SERVER ?? "https://dev.platform.getaiready.dev";
+  const apiKey = options.apiKey ?? process.env.AIREADY_API_KEY;
   if (!apiKey) {
     console.error(chalk3.red("\u274C API Key is required for upload."));
     console.log(
@@ -249,7 +249,7 @@ async function uploadAction(file, options) {
     const reportContent = fs.readFileSync(filePath, "utf-8");
     const reportData = JSON.parse(reportContent);
     console.log(chalk3.dim(`   Successfully parsed report JSON.`));
-    const repoId = options.repoId || reportData.repository?.repoId;
+    const repoId = options.repoId ?? reportData.repository?.repoId;
     const response = await fetch(`${serverUrl}/api/analysis/upload`, {
       method: "POST",
       headers: {
@@ -268,12 +268,12 @@ async function uploadAction(file, options) {
       uploadResult = await response.json();
     } else {
       const text = await response.text();
-      uploadResult = { error: text || response.statusText };
+      uploadResult = { error: text ?? response.statusText };
     }
     if (!response.ok) {
       console.error(
         chalk3.red(
-          `\u274C Upload failed: ${uploadResult.error || response.statusText}`
+          `\u274C Upload failed: ${uploadResult.error ?? response.statusText}`
         )
       );
       if (contentType?.includes("text/html")) {
@@ -324,7 +324,7 @@ ENVIRONMENT VARIABLES:
 async function scanAction(directory, options) {
   console.log(chalk4.blue("\u{1F680} Starting AIReady unified analysis...\n"));
   const startTime = Date.now();
-  const resolvedDir = resolvePath3(process.cwd(), directory || ".");
+  const resolvedDir = resolvePath3(process.cwd(), directory ?? ".");
   const repoMetadata = getRepoMetadata(resolvedDir);
   try {
     const defaults = {
@@ -414,7 +414,7 @@ async function scanAction(directory, options) {
       const { getSmartDefaults } = await import("@aiready/pattern-detect");
       const patternSmartDefaults = await getSmartDefaults(
         resolvedDir,
-        finalOptions.toolConfigs?.[ToolName.PatternDetect] || {}
+        finalOptions.toolConfigs?.[ToolName.PatternDetect] ?? {}
       );
       if (!finalOptions.toolConfigs) finalOptions.toolConfigs = {};
       finalOptions.toolConfigs[ToolName.PatternDetect] = {
@@ -425,7 +425,7 @@ async function scanAction(directory, options) {
     console.log(chalk4.cyan("\n=== AIReady Run Preview ==="));
     console.log(
       chalk4.white("Tools to run:"),
-      (finalOptions.tools || []).join(", ")
+      (finalOptions.tools ?? []).join(", ")
     );
     const progressCallback = (event) => {
       if (event.message) {
@@ -446,7 +446,7 @@ async function scanAction(directory, options) {
           );
       }
     };
-    const scoringProfile = options.profile || baseOptions.scoring?.profile || "default";
+    const scoringProfile = options.profile ?? baseOptions.scoring?.profile ?? "default";
     const results = await analyzeUnified({
       ...finalOptions,
       progressCallback,
@@ -470,7 +470,7 @@ async function scanAction(directory, options) {
           const prevReport = JSON.parse(
             readFileSync2(resolvePath3(process.cwd(), options.compareTo), "utf8")
           );
-          const prevScore = prevReport.scoring?.overall || prevReport.scoring?.score;
+          const prevScore = prevReport.scoring?.overall ?? prevReport.scoring?.score;
           if (typeof prevScore === "number") {
             const diff = scoringResult.overall - prevScore;
             const diffStr = diff > 0 ? `+${diff}` : String(diff);
@@ -497,17 +497,17 @@ async function scanAction(directory, options) {
           void e;
         }
       }
-      const totalWastedDuplication = (scoringResult.breakdown || []).reduce(
-        (sum, s) => sum + (s.tokenBudget?.wastedTokens.bySource.duplication || 0),
+      const totalWastedDuplication = (scoringResult.breakdown ?? []).reduce(
+        (sum, s) => sum + (s.tokenBudget?.wastedTokens?.bySource?.duplication ?? 0),
         0
       );
-      const totalWastedFragmentation = (scoringResult.breakdown || []).reduce(
-        (sum, s) => sum + (s.tokenBudget?.wastedTokens.bySource.fragmentation || 0),
+      const totalWastedFragmentation = (scoringResult.breakdown ?? []).reduce(
+        (sum, s) => sum + (s.tokenBudget?.wastedTokens?.bySource?.fragmentation ?? 0),
         0
       );
       const totalContext = Math.max(
-        ...(scoringResult.breakdown || []).map(
-          (s) => s.tokenBudget?.totalContextTokens || 0
+        ...(scoringResult.breakdown ?? []).map(
+          (s) => s.tokenBudget?.totalContextTokens ?? 0
         ),
         0
       );
@@ -531,7 +531,7 @@ async function scanAction(directory, options) {
             });
           }
         }
-        const modelId = options.model || "claude-3-5-sonnet";
+        const modelId = options.model ?? "gpt-5.4-mini";
         const roi = (await import("@aiready/core")).calculateBusinessROI({
           tokenWaste: unifiedBudget.wastedTokens.total,
           issues: allIssues,
@@ -568,9 +568,9 @@ async function scanAction(directory, options) {
       ...mapToUnifiedReport(results, scoringResult),
       repository: repoMetadata
     };
-    const outputFormat = options.output || finalOptions.output?.format || "console";
+    const outputFormat = options.output ?? finalOptions.output?.format ?? "console";
     const outputPath = resolveOutputPath(
-      options.outputFile || finalOptions.output?.file,
+      options.outputFile ?? finalOptions.output?.file,
       `aiready-report-${getReportTimestamp()}.json`,
       resolvedDir
     );
@@ -597,8 +597,8 @@ async function scanAction(directory, options) {
     await warnIfGraphCapExceeded(outputData, resolvedDir);
     if (scoringResult) {
       const threshold = options.threshold ? parseInt(options.threshold) : void 0;
-      const failOnLevel = options.failOn || "critical";
-      const isCI = options.ci || process.env.CI === "true";
+      const failOnLevel = options.failOn ?? "critical";
+      const isCI = options.ci ?? process.env.CI === "true";
       let shouldFail = false;
       let failReason = "";
       const report = mapToUnifiedReport(results, scoringResult);
@@ -789,7 +789,7 @@ import {
 async function patternsAction(directory, options) {
   console.log(chalk6.blue("\u{1F50D} Analyzing patterns...\n"));
   const startTime = Date.now();
-  const resolvedDir = resolvePath4(process.cwd(), directory || ".");
+  const resolvedDir = resolvePath4(process.cwd(), directory ?? ".");
   try {
     const useSmartDefaults = !options.fullScan;
     const defaults = {
@@ -833,8 +833,8 @@ async function patternsAction(directory, options) {
     if (options.score) {
       patternScore = calculatePatternScore(duplicates, results.length);
     }
-    const outputFormat = options.output || finalOptions.output?.format || "console";
-    const userOutputFile = options.outputFile || finalOptions.output?.file;
+    const outputFormat = options.output ?? finalOptions.output?.format ?? "console";
+    const userOutputFile = options.outputFile ?? finalOptions.output?.file;
     if (outputFormat === "json") {
       const outputData = {
         results,
@@ -942,7 +942,7 @@ import {
 async function contextAction(directory, options) {
   console.log(chalk7.blue("\u{1F9E0} Analyzing context costs...\n"));
   const startTime = Date.now();
-  const resolvedDir = resolvePath5(process.cwd(), directory || ".");
+  const resolvedDir = resolvePath5(process.cwd(), directory ?? ".");
   try {
     const defaults = {
       maxDepth: 5,
@@ -986,8 +986,8 @@ async function contextAction(directory, options) {
     if (options.score) {
       contextScore = calculateContextScore(summary);
     }
-    const outputFormat = options.output || finalOptions.output?.format || "console";
-    const userOutputFile = options.outputFile || finalOptions.output?.file;
+    const outputFormat = options.output ?? finalOptions.output?.format ?? "console";
+    const userOutputFile = options.outputFile ?? finalOptions.output?.file;
     if (outputFormat === "json") {
       const outputData = {
         results,
@@ -1005,7 +1005,7 @@ async function contextAction(directory, options) {
         `\u2705 Results saved to ${outputPath}`
       );
     } else {
-      const terminalWidth = process.stdout.columns || 80;
+      const terminalWidth = process.stdout.columns ?? 80;
       const dividerWidth = Math.min(60, terminalWidth - 2);
       const divider = "\u2501".repeat(dividerWidth);
       console.log(chalk7.cyan(divider));
@@ -1150,7 +1150,7 @@ import {
 async function consistencyAction(directory, options) {
   console.log(chalk8.blue("\u{1F50D} Analyzing consistency...\n"));
   const startTime = Date.now();
-  const resolvedDir = resolvePath6(process.cwd(), directory || ".");
+  const resolvedDir = resolvePath6(process.cwd(), directory ?? ".");
   try {
     const defaults = {
       checkNaming: true,
@@ -1175,14 +1175,14 @@ async function consistencyAction(directory, options) {
     const elapsedTime = getElapsedTime3(startTime);
     let consistencyScore;
     if (options.score) {
-      const issues = report.results?.flatMap((r) => r.issues) || [];
+      const issues = report.results?.flatMap((r) => r.issues) ?? [];
       consistencyScore = calculateConsistencyScore(
         issues,
         report.summary.filesAnalyzed
       );
     }
-    const outputFormat = options.output || finalOptions.output?.format || "console";
-    const userOutputFile = options.outputFile || finalOptions.output?.file;
+    const outputFormat = options.output ?? finalOptions.output?.format ?? "console";
+    const userOutputFile = options.outputFile ?? finalOptions.output?.file;
     if (outputFormat === "json") {
       const outputData = {
         ...report,
@@ -1220,7 +1220,7 @@ async function consistencyAction(directory, options) {
       console.log(`  Naming: ${chalk8.yellow(report.summary.namingIssues)}`);
       console.log(`  Patterns: ${chalk8.yellow(report.summary.patternIssues)}`);
       console.log(
-        `  Architecture: ${chalk8.yellow(report.summary.architectureIssues || 0)}`
+        `  Architecture: ${chalk8.yellow(report.summary.architectureIssues ?? 0)}`
       );
       console.log(`Analysis Time: ${chalk8.gray(elapsedTime + "s")}
 `);
@@ -1319,7 +1319,7 @@ import { handleCLIError as handleCLIError6 } from "@aiready/core";
 import { generateHTML, findLatestReport as findLatestReport2 } from "@aiready/core";
 async function visualizeAction(directory, options) {
   try {
-    const dirPath = resolvePath7(process.cwd(), directory || ".");
+    const dirPath = resolvePath7(process.cwd(), directory ?? ".");
     let reportPath = options.report ? resolvePath7(dirPath, options.report) : null;
     if (!reportPath || !existsSync3(reportPath)) {
       const latestScan = findLatestReport2(dirPath);
@@ -1365,7 +1365,7 @@ Or specify a custom report:
     console.log("Building graph from report...");
     const { GraphBuilder } = await import("@aiready/visualizer/graph");
     const graph = GraphBuilder.buildFromReport(report, dirPath);
-    let useDevMode = options.dev || false;
+    let useDevMode = options.dev ?? false;
     let devServerStarted = false;
     if (useDevMode) {
       try {
@@ -1481,7 +1481,7 @@ Or specify a custom report:
     console.log("Generating HTML...");
     const html = generateHTML(graph);
     const defaultOutput = "visualization.html";
-    const outPath = resolvePath7(dirPath, options.output || defaultOutput);
+    const outPath = resolvePath7(dirPath, options.output ?? defaultOutput);
     writeFileSync4(outPath, html, "utf8");
     console.log(chalk9.green(`\u2705 Visualization written to: ${outPath}`));
     if (options.open || options.serve) {
@@ -1493,7 +1493,7 @@ Or specify a custom report:
           const fsp = await import("fs/promises");
           const server = http.createServer(async (req, res) => {
             try {
-              const urlPath = req.url || "/";
+              const urlPath = req.url ?? "/";
               if (urlPath === "/" || urlPath === "/index.html") {
                 const content = await fsp.readFile(outPath, "utf8");
                 res.writeHead(200, {
@@ -1631,7 +1631,7 @@ async function bugAction(message, options) {
   const repoUrl = "https://github.com/caopengau/aiready-cli";
   const repoSlug = "caopengau/aiready-cli";
   if (message) {
-    const type = options.type || "bug";
+    const type = options.type ?? "bug";
     const title = `[${type.toUpperCase()}] ${message}`;
     const label = type === "bug" ? "bug" : type === "feature" ? "enhancement" : "metric";
     const body = `
@@ -1719,15 +1719,17 @@ AI READINESS SCORING:
 EXAMPLES:
   $ aiready scan                          # Comprehensive analysis with AI Readiness Score
   $ aiready scan --no-score               # Run scan without score calculation
-  $ aiready scan --tools patterns         # Run only pattern detection
+  $ aiready init                          # Create a default aiready.json configuration
+  $ aiready init --full                   # Create configuration with ALL available options
   $ 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 and get an AI Readiness Score
-  2. Use '--profile agentic' for agent-focused analysis
-  3. Create aiready.json for persistent configuration
-  4. Set up CI/CD with '--threshold' for quality gates
+  1. Run 'aiready init' to create a persistent 'aiready.json' config file
+  2. Run 'aiready scan' to analyze your codebase and get an AI Readiness Score
+  3. Use 'aiready init --full' to see every fine-tuning parameter available
+  4. Use '--profile agentic' for agent-focused analysis
+  5. Set up CI/CD with '--threshold' for quality gates
 
 CONFIGURATION:
   Config files (searched upward): aiready.json, .aiready.json, aiready.config.*

package/dist/index.js

@@ -84,7 +84,7 @@ function sanitizeToolConfig(config) {
 async function analyzeUnified(options) {
   await (0, import_core.initializeParsers)();
   const startTime = Date.now();
-  const requestedTools = options.tools || [
+  const requestedTools = options.tools ?? [
     "patterns",
     "context",
     "consistency"
@@ -106,7 +106,7 @@ async function analyzeUnified(options) {
   for (const toolName of requestedTools) {
     let provider = import_core.ToolRegistry.find(toolName);
     if (!provider) {
-      const packageName = TOOL_PACKAGE_MAP[toolName] || (toolName.startsWith("@aiready/") ? toolName : `@aiready/${toolName}`);
+      const packageName = TOOL_PACKAGE_MAP[toolName] ?? (toolName.startsWith("@aiready/") ? toolName : `@aiready/${toolName}`);
       try {
         await import(packageName);
         provider = import_core.ToolRegistry.find(toolName);
@@ -184,29 +184,15 @@ async function analyzeUnified(options) {
       } else {
         result.summary.toolConfigs[provider.id] = sanitizeToolConfig(toolOptions);
       }
-      const toolFiles = output.summary?.totalFiles || output.summary?.filesAnalyzed || 0;
+      const toolFiles = output.summary?.totalFiles ?? output.summary?.filesAnalyzed ?? 0;
       if (toolFiles > result.summary.totalFiles) {
         result.summary.totalFiles = toolFiles;
       }
       const issueCount = output.results.reduce(
-        (sum, file) => sum + (file.issues?.length || 0),
+        (sum, file) => sum + (file.issues?.length ?? 0),
         0
       );
       result.summary.totalIssues += issueCount;
-      if (provider.alias && Array.isArray(provider.alias)) {
-        for (const alias of provider.alias) {
-          if (!result[alias]) {
-            result[alias] = output;
-          }
-        }
-      }
-      const camelCaseId = provider.id.replace(
-        /-([a-z])/g,
-        (g) => g[1].toUpperCase()
-      );
-      if (camelCaseId !== provider.id && !result[camelCaseId]) {
-        result[camelCaseId] = output;
-      }
     } catch (err) {
       console.error(`\u274C Error running tool '${provider.id}':`, err);
     }
@@ -221,6 +207,24 @@ async function analyzeUnified(options) {
     tools: result.summary.toolConfigs
   });
   result.summary.executionTime = Date.now() - startTime;
+  const keyMappings = {
+    "pattern-detect": ["patternDetect", "patterns"],
+    "context-analyzer": ["contextAnalyzer", "context"],
+    "naming-consistency": ["namingConsistency", "consistency"],
+    "ai-signal-clarity": ["aiSignalClarity"],
+    "agent-grounding": ["agentGrounding"],
+    "testability-index": ["testabilityIndex", "testability"],
+    "doc-drift": ["docDrift"],
+    "dependency-health": ["dependencyHealth", "deps"],
+    "change-amplification": ["changeAmplification"]
+  };
+  for (const [kebabKey, aliases] of Object.entries(keyMappings)) {
+    if (result[kebabKey]) {
+      for (const alias of aliases) {
+        result[alias] = result[kebabKey];
+      }
+    }
+  }
   return result;
 }
 async function scoreUnified(results, options) {
@@ -235,7 +239,7 @@ async function scoreUnified(results, options) {
       if (!toolScore.tokenBudget) {
         if (toolId === import_core.ToolName.PatternDetect && output.duplicates) {
           const wastedTokens = output.duplicates.reduce(
-            (sum, d) => sum + (d.tokenCost || 0),
+            (sum, d) => sum + (d.tokenCost ?? 0),
             0
           );
           toolScore.tokenBudget = (0, import_core.calculateTokenBudget)({
@@ -251,7 +255,7 @@ async function scoreUnified(results, options) {
             totalContextTokens: output.summary.totalTokens,
             wastedTokens: {
               duplication: 0,
-              fragmentation: output.summary.totalPotentialSavings || 0,
+              fragmentation: output.summary.totalPotentialSavings ?? 0,
               chattiness: 0
             }
           });
@@ -296,7 +300,7 @@ function generateUnifiedSummary(result) {
     const toolResult = result[provider.id];
     if (toolResult) {
       const issueCount = toolResult.results.reduce(
-        (sum, r) => sum + (r.issues?.length || 0),
+        (sum, r) => sum + (r.issues?.length ?? 0),
         0
       );
       output += `\u2022 ${provider.id}: ${issueCount} issues

package/dist/index.mjs

@@ -2,7 +2,7 @@ import {
   analyzeUnified,
   generateUnifiedSummary,
   scoreUnified
-} from "./chunk-VOKP7FGM.mjs";
+} from "./chunk-JRRBBFYB.mjs";
 export {
   analyzeUnified,
   generateUnifiedSummary,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aiready/cli",
-  "version": "0.14.8",
+  "version": "0.14.10",
   "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.13.5",
-    "@aiready/consistency": "0.20.5",
-    "@aiready/context-analyzer": "0.21.9",
-    "@aiready/core": "0.23.6",
-    "@aiready/deps": "0.13.5",
-    "@aiready/doc-drift": "0.13.5",
-    "@aiready/change-amplification": "0.13.5",
-    "@aiready/ai-signal-clarity": "0.13.6",
-    "@aiready/visualizer": "0.6.5",
-    "@aiready/pattern-detect": "0.16.5",
-    "@aiready/testability": "0.6.5"
+    "@aiready/agent-grounding": "0.13.7",
+    "@aiready/consistency": "0.20.7",
+    "@aiready/core": "0.23.8",
+    "@aiready/deps": "0.13.7",
+    "@aiready/context-analyzer": "0.21.11",
+    "@aiready/doc-drift": "0.13.7",
+    "@aiready/change-amplification": "0.13.7",
+    "@aiready/ai-signal-clarity": "0.13.8",
+    "@aiready/pattern-detect": "0.16.7",
+    "@aiready/testability": "0.6.7",
+    "@aiready/visualizer": "0.6.7"
   },
   "devDependencies": {
     "@types/node": "^24.0.0",

package/src/cli.ts

@@ -49,15 +49,17 @@ AI READINESS SCORING:
 EXAMPLES:
   $ aiready scan                          # Comprehensive analysis with AI Readiness Score
   $ aiready scan --no-score               # Run scan without score calculation
-  $ aiready scan --tools patterns         # Run only pattern detection
+  $ aiready init                          # Create a default aiready.json configuration
+  $ aiready init --full                   # Create configuration with ALL available options
   $ 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 and get an AI Readiness Score
-  2. Use '--profile agentic' for agent-focused analysis
-  3. Create aiready.json for persistent configuration
-  4. Set up CI/CD with '--threshold' for quality gates
+  1. Run 'aiready init' to create a persistent 'aiready.json' config file
+  2. Run 'aiready scan' to analyze your codebase and get an AI Readiness Score
+  3. Use 'aiready init --full' to see every fine-tuning parameter available
+  4. Use '--profile agentic' for agent-focused analysis
+  5. Set up CI/CD with '--threshold' for quality gates
 
 CONFIGURATION:
   Config files (searched upward): aiready.json, .aiready.json, aiready.config.*

package/src/commands/bug.ts

@@ -11,7 +11,7 @@ export async function bugAction(message: string | undefined, options: any) {
 
   if (message) {
     // Agent-assisted pre-filled issue
-    const type = options.type || 'bug';
+    const type = options.type ?? 'bug';
     const title = `[${type.toUpperCase()}] ${message}`;
     const label =
       type === 'bug' ? 'bug' : type === 'feature' ? 'enhancement' : 'metric';

package/src/commands/consistency.ts

@@ -34,7 +34,7 @@ export async function consistencyAction(
   console.log(chalk.blue('🔍 Analyzing consistency...\n'));
 
   const startTime = Date.now();
-  const resolvedDir = resolvePath(process.cwd(), directory || '.');
+  const resolvedDir = resolvePath(process.cwd(), directory ?? '.');
 
   try {
     // Define defaults
@@ -69,7 +69,7 @@ export async function consistencyAction(
     // Calculate score if requested
     let consistencyScore: ToolScoringOutput | undefined;
     if (options.score) {
-      const issues = report.results?.flatMap((r: any) => r.issues) || [];
+      const issues = report.results?.flatMap((r: any) => r.issues) ?? [];
       consistencyScore = calculateConsistencyScore(
         issues,
         report.summary.filesAnalyzed
@@ -77,8 +77,8 @@ export async function consistencyAction(
     }
 
     const outputFormat =
-      options.output || finalOptions.output?.format || 'console';
-    const userOutputFile = options.outputFile || finalOptions.output?.file;
+      options.output ?? finalOptions.output?.format ?? 'console';
+    const userOutputFile = options.outputFile ?? finalOptions.output?.file;
 
     if (outputFormat === 'json') {
       const outputData = {
@@ -121,7 +121,7 @@ export async function consistencyAction(
       console.log(`  Naming: ${chalk.yellow(report.summary.namingIssues)}`);
       console.log(`  Patterns: ${chalk.yellow(report.summary.patternIssues)}`);
       console.log(
-        `  Architecture: ${chalk.yellow(report.summary.architectureIssues || 0)}`
+        `  Architecture: ${chalk.yellow(report.summary.architectureIssues ?? 0)}`
       );
       console.log(`Analysis Time: ${chalk.gray(elapsedTime + 's')}\n`);
 

package/src/commands/context.ts

@@ -32,7 +32,7 @@ export async function contextAction(
   console.log(chalk.blue('🧠 Analyzing context costs...\n'));
 
   const startTime = Date.now();
-  const resolvedDir = resolvePath(process.cwd(), directory || '.');
+  const resolvedDir = resolvePath(process.cwd(), directory ?? '.');
 
   try {
     // Define defaults
@@ -94,8 +94,8 @@ export async function contextAction(
     }
 
     const outputFormat =
-      options.output || finalOptions.output?.format || 'console';
-    const userOutputFile = options.outputFile || finalOptions.output?.file;
+      options.output ?? finalOptions.output?.format ?? 'console';
+    const userOutputFile = options.outputFile ?? finalOptions.output?.file;
 
     if (outputFormat === 'json') {
       const outputData = {
@@ -117,7 +117,7 @@ export async function contextAction(
       );
     } else {
       // Console output - format the results nicely
-      const terminalWidth = process.stdout.columns || 80;
+      const terminalWidth = process.stdout.columns ?? 80;
       const dividerWidth = Math.min(60, terminalWidth - 2);
       const divider = '━'.repeat(dividerWidth);
 

package/src/commands/patterns.ts

@@ -35,7 +35,7 @@ export async function patternsAction(
   console.log(chalk.blue('🔍 Analyzing patterns...\n'));
 
   const startTime = Date.now();
-  const resolvedDir = resolvePath(process.cwd(), directory || '.');
+  const resolvedDir = resolvePath(process.cwd(), directory ?? '.');
 
   try {
     // Determine if smart defaults should be used
@@ -100,8 +100,8 @@ export async function patternsAction(
     }
 
     const outputFormat =
-      options.output || finalOptions.output?.format || 'console';
-    const userOutputFile = options.outputFile || finalOptions.output?.file;
+      options.output ?? finalOptions.output?.format ?? 'console';
+    const userOutputFile = options.outputFile ?? finalOptions.output?.file;
 
     if (outputFormat === 'json') {
       const outputData = {

package/src/commands/report-formatter.ts

@@ -8,12 +8,15 @@ import {
 } from '@aiready/core';
 
 /**
- * Handle console output for the scan results
+ * Handle console output for the scan results.
+ *
+ * @param results - The combined results from all tools.
+ * @param startTime - The timestamp when the scan started.
  */
 export function printScanSummary(results: any, startTime: number) {
   console.log(chalk.cyan('\n=== AIReady Run Summary ==='));
   console.log(
-    `  Total issues (all tools): ${chalk.bold(String(results.summary.totalIssues || 0))}`
+    `  Total issues (all tools): ${chalk.bold(String(results.summary.totalIssues ?? 0))}`
   );
   console.log(
     `  Execution time: ${chalk.bold(((Date.now() - startTime) / 1000).toFixed(2) + 's')}`
@@ -21,7 +24,10 @@ export function printScanSummary(results: any, startTime: number) {
 }
 
 /**
- * Print business impact analysis
+ * Print business impact analysis based on ROI and budget metrics.
+ *
+ * @param roi - Calculated Return on Investment metrics.
+ * @param unifiedBudget - Consolidated context budget metrics.
  */
 export function printBusinessImpact(roi: any, unifiedBudget: any) {
   console.log(chalk.bold('\n💰 Business Impact Analysis (Monthly)'));
@@ -40,7 +46,10 @@ export function printBusinessImpact(roi: any, unifiedBudget: any) {
 }
 
 /**
- * Print detailed scoring breakdown
+ * Print detailed scoring breakdown by tool.
+ *
+ * @param scoringResult - The overall scoring result.
+ * @param scoringProfile - The name of the scoring profile used.
  */
 export function printScoring(
   scoringResult: ScoringResult,
@@ -52,7 +61,7 @@ export function printScoring(
 
   if (scoringResult.breakdown) {
     console.log(chalk.bold('\nTool breakdown:'));
-    scoringResult.breakdown.forEach((tool) => {
+    scoringResult.breakdown.forEach((tool: any) => {
       const rating = getRating(tool.score);
       const emoji = getRatingDisplay(rating).emoji;
       console.log(
@@ -62,15 +71,15 @@ export function printScoring(
 
     // Top Actionable Recommendations
     const allRecs = scoringResult.breakdown
-      .flatMap((t) =>
-        (t.recommendations || []).map((r) => ({ ...r, tool: t.toolName }))
+      .flatMap((t: any) =>
+        (t.recommendations ?? []).map((r: any) => ({ ...r, tool: t.toolName }))
       )
-      .sort((a, b) => b.estimatedImpact - a.estimatedImpact)
+      .sort((a: any, b: any) => b.estimatedImpact - a.estimatedImpact)
       .slice(0, 3);
 
     if (allRecs.length > 0) {
       console.log(chalk.bold('\n🎯 Top Actionable Recommendations:'));
-      allRecs.forEach((rec, i) => {
+      allRecs.forEach((rec: any, i: number) => {
         const priorityIcon =
           rec.priority === 'high'
             ? '🔴'
@@ -87,7 +96,11 @@ export function printScoring(
 }
 
 /**
- * Normalize report mapping (CLI logic)
+ * Normalize and map tool-specific results to a unified report structure.
+ *
+ * @param res - Raw unified results object.
+ * @param scoring - Optional scoring result to include.
+ * @returns Enhanced report with totals and scoring.
  */
 export function mapToUnifiedReport(
   res: any,