@aiready/cli 0.14.9 → 0.14.11

package/dist/cli.js

@@ -95,7 +95,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"
@@ -117,7 +117,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);
@@ -195,29 +195,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);
     }
@@ -232,6 +218,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) {
@@ -246,7 +250,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)({
@@ -262,7 +266,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
             }
           });
@@ -390,13 +394,91 @@ function generateMarkdownReport(report, elapsedTime) {
 // src/commands/report-formatter.ts
 var import_chalk2 = __toESM(require("chalk"));
 var import_core4 = require("@aiready/core");
+function generateProgressBar(score, width = 20) {
+  const filled = Math.round(score / 100 * width);
+  const empty = width - filled;
+  let color = import_chalk2.default.red;
+  if (score >= 90) color = import_chalk2.default.green;
+  else if (score >= 75) color = import_chalk2.default.cyan;
+  else if (score >= 60) color = import_chalk2.default.yellow;
+  const bar = "\u2588".repeat(filled) + "\u2591".repeat(empty);
+  return color(bar);
+}
+function countIssuesBySeverity(results) {
+  let critical = 0;
+  let major = 0;
+  let minor = 0;
+  if (results.summary?.toolsRun) {
+    for (const toolId of results.summary.toolsRun) {
+      const toolRes = results[toolId];
+      if (toolRes?.results) {
+        for (const fileRes of toolRes.results) {
+          if (fileRes.issues) {
+            for (const issue of fileRes.issues) {
+              const sev = issue.severity?.toLowerCase();
+              if (sev === "critical") critical++;
+              else if (sev === "major") major++;
+              else minor++;
+            }
+          }
+        }
+      }
+    }
+  }
+  return { critical, major, minor };
+}
+function getTopFilesWithIssues(results, limit = 5) {
+  const fileCounts = /* @__PURE__ */ new Map();
+  if (results.summary?.toolsRun) {
+    for (const toolId of results.summary.toolsRun) {
+      const toolRes = results[toolId];
+      if (toolRes?.results) {
+        for (const fileRes of toolRes.results) {
+          if (fileRes.issues?.length > 0) {
+            const current = fileCounts.get(fileRes.fileName) || 0;
+            fileCounts.set(fileRes.fileName, current + fileRes.issues.length);
+          }
+        }
+      }
+    }
+  }
+  return Array.from(fileCounts.entries()).map(([file, count]) => ({ file, count })).sort((a, b) => b.count - a.count).slice(0, limit);
+}
 function printScanSummary(results, startTime) {
+  const severity = countIssuesBySeverity(results);
+  const totalIssues = severity.critical + severity.major + severity.minor;
+  const topFiles = getTopFilesWithIssues(results);
   console.log(import_chalk2.default.cyan("\n=== AIReady Run Summary ==="));
+  console.log(`  Total issues: ${import_chalk2.default.bold(String(totalIssues))}`);
+  if (totalIssues > 0) {
+    console.log(import_chalk2.default.dim("  Severity breakdown:"));
+    if (severity.critical > 0) {
+      console.log(
+        `    ${import_chalk2.default.red("\u25CF")} Critical: ${import_chalk2.default.bold(severity.critical)}`
+      );
+    }
+    if (severity.major > 0) {
+      console.log(
+        `    ${import_chalk2.default.yellow("\u25CF")} Major: ${import_chalk2.default.bold(severity.major)}`
+      );
+    }
+    if (severity.minor > 0) {
+      console.log(
+        `    ${import_chalk2.default.blue("\u25CF")} Minor: ${import_chalk2.default.bold(severity.minor)}`
+      );
+    }
+  }
+  if (topFiles.length > 0) {
+    console.log(import_chalk2.default.dim("\n  Top files with issues:"));
+    topFiles.forEach((item) => {
+      console.log(
+        `    ${import_chalk2.default.yellow("\u2192")} ${item.file}: ${import_chalk2.default.bold(item.count)} issues`
+      );
+    });
+  }
   console.log(
-    `  Total issues (all tools): ${import_chalk2.default.bold(String(results.summary.totalIssues || 0))}`
-  );
-  console.log(
-    `  Execution time: ${import_chalk2.default.bold(((Date.now() - startTime) / 1e3).toFixed(2) + "s")}`
+    `
+  Execution time: ${import_chalk2.default.bold(((Date.now() - startTime) / 1e3).toFixed(2) + "s")}`
   );
 }
 function printBusinessImpact(roi, unifiedBudget) {
@@ -423,13 +505,14 @@ function printScoring(scoringResult, scoringProfile) {
     scoringResult.breakdown.forEach((tool) => {
       const rating = (0, import_core4.getRating)(tool.score);
       const emoji = (0, import_core4.getRatingDisplay)(rating).emoji;
+      const progressBar = generateProgressBar(tool.score, 15);
       console.log(
-        `  - ${tool.toolName}: ${tool.score}/100 (${rating}) ${emoji}`
+        `  ${progressBar} ${tool.score}/100 (${rating}) ${emoji} ${tool.toolName}`
       );
     });
     const allRecs = scoringResult.breakdown.flatMap(
-      (t) => (t.recommendations || []).map((r) => ({ ...r, tool: t.toolName }))
-    ).sort((a, b) => b.estimatedImpact - a.estimatedImpact).slice(0, 3);
+      (t) => (t.recommendations ?? []).map((r) => ({ ...r, tool: t.toolName }))
+    ).sort((a, b) => b.estimatedImpact - a.estimatedImpact).slice(0, 5);
     if (allRecs.length > 0) {
       console.log(import_chalk2.default.bold("\n\u{1F3AF} Top Actionable Recommendations:"));
       allRecs.forEach((rec, i) => {
@@ -482,8 +565,8 @@ var import_core5 = require("@aiready/core");
 async function uploadAction(file, options) {
   const startTime = Date.now();
   const filePath = (0, import_path2.resolve)(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(import_chalk3.default.red("\u274C API Key is required for upload."));
     console.log(
@@ -508,7 +591,7 @@ async function uploadAction(file, options) {
     const reportContent = import_fs2.default.readFileSync(filePath, "utf-8");
     const reportData = JSON.parse(reportContent);
     console.log(import_chalk3.default.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: {
@@ -527,12 +610,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(
         import_chalk3.default.red(
-          `\u274C Upload failed: ${uploadResult.error || response.statusText}`
+          `\u274C Upload failed: ${uploadResult.error ?? response.statusText}`
         )
       );
       if (contentType?.includes("text/html")) {
@@ -583,7 +666,7 @@ ENVIRONMENT VARIABLES:
 async function scanAction(directory, options) {
   console.log(import_chalk4.default.blue("\u{1F680} Starting AIReady unified analysis...\n"));
   const startTime = Date.now();
-  const resolvedDir = (0, import_path3.resolve)(process.cwd(), directory || ".");
+  const resolvedDir = (0, import_path3.resolve)(process.cwd(), directory ?? ".");
   const repoMetadata = (0, import_core6.getRepoMetadata)(resolvedDir);
   try {
     const defaults = {
@@ -673,7 +756,7 @@ async function scanAction(directory, options) {
       const { getSmartDefaults } = await import("@aiready/pattern-detect");
       const patternSmartDefaults = await getSmartDefaults(
         resolvedDir,
-        finalOptions.toolConfigs?.[import_core6.ToolName.PatternDetect] || {}
+        finalOptions.toolConfigs?.[import_core6.ToolName.PatternDetect] ?? {}
       );
       if (!finalOptions.toolConfigs) finalOptions.toolConfigs = {};
       finalOptions.toolConfigs[import_core6.ToolName.PatternDetect] = {
@@ -684,7 +767,7 @@ async function scanAction(directory, options) {
     console.log(import_chalk4.default.cyan("\n=== AIReady Run Preview ==="));
     console.log(
       import_chalk4.default.white("Tools to run:"),
-      (finalOptions.tools || []).join(", ")
+      (finalOptions.tools ?? []).join(", ")
     );
     const progressCallback = (event) => {
       if (event.message) {
@@ -705,7 +788,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,
@@ -729,7 +812,7 @@ async function scanAction(directory, options) {
           const prevReport = JSON.parse(
             (0, import_fs3.readFileSync)((0, import_path3.resolve)(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);
@@ -756,17 +839,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
       );
@@ -790,7 +873,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,
@@ -827,9 +910,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 = (0, import_core6.resolveOutputPath)(
-      options.outputFile || finalOptions.output?.file,
+      options.outputFile ?? finalOptions.output?.file,
       `aiready-report-${getReportTimestamp()}.json`,
       resolvedDir
     );
@@ -856,8 +939,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);
@@ -913,6 +996,9 @@ async function initAction(options) {
     process.exit(1);
   }
   const baseConfig = {
+    // Target quality score threshold (0-100)
+    threshold: 75,
+    // Global scan settings
     scan: {
       include: [
         "src/**/*.ts",
@@ -939,6 +1025,17 @@ async function initAction(options) {
         import_core7.ToolName.ChangeAmplification
       ]
     },
+    // Output preferences
+    output: {
+      format: "console",
+      showBreakdown: true,
+      saveTo: "aiready-report.json"
+    },
+    // Scoring profile and weights
+    scoring: {
+      profile: "balanced"
+    },
+    // Tool-specific configurations
     tools: {
       [import_core7.ToolName.PatternDetect]: {
         minSimilarity: 0.8,
@@ -962,7 +1059,33 @@ async function initAction(options) {
       },
       [import_core7.ToolName.NamingConsistency]: {
         shortWords: ["id", "db", "ui", "ai"],
-        ...options.full ? { acceptedAbbreviations: [], disableChecks: [] } : {}
+        acceptedAbbreviations: [
+          "API",
+          "JSON",
+          "CSV",
+          "HTML",
+          "CSS",
+          "HTTP",
+          "URL",
+          "SDK",
+          "CLI",
+          "AI",
+          "ML",
+          "ID",
+          "DB",
+          "UI",
+          "UX",
+          "DOM",
+          "UUID",
+          "GUID",
+          "DEFAULT",
+          "MAX",
+          "MIN",
+          "config",
+          "INIT",
+          "SKILL"
+        ],
+        ...options.full ? { disableChecks: [] } : {}
       },
       [import_core7.ToolName.AiSignalClarity]: {
         checkMagicLiterals: true,
@@ -971,48 +1094,42 @@ async function initAction(options) {
         checkUndocumentedExports: true,
         ...options.full ? { checkImplicitSideEffects: false, checkDeepCallbacks: false } : {}
       },
-      ...options.full ? {
-        [import_core7.ToolName.AgentGrounding]: {
-          maxRecommendedDepth: 5,
-          readmeStaleDays: 30
-        },
-        [import_core7.ToolName.TestabilityIndex]: {
-          minCoverageRatio: 0.7,
-          testPatterns: ["**/*.test.ts", "**/__tests__/**"]
-        },
-        [import_core7.ToolName.DocDrift]: {
-          maxCommits: 50,
-          staleMonths: 3
-        },
-        [import_core7.ToolName.DependencyHealth]: {
-          trainingCutoffYear: 2023
-        }
-      } : {}
-    },
-    scoring: {
-      threshold: 70,
-      showBreakdown: true,
-      ...options.full ? { profile: "default" } : {}
+      [import_core7.ToolName.AgentGrounding]: {
+        maxRecommendedDepth: 5,
+        readmeStaleDays: 30
+      },
+      [import_core7.ToolName.TestabilityIndex]: {
+        minCoverageRatio: 0.7,
+        testPatterns: ["**/*.test.ts", "**/__tests__/**"]
+      },
+      [import_core7.ToolName.DocDrift]: {
+        maxCommits: 50,
+        staleMonths: 3
+      },
+      [import_core7.ToolName.DependencyHealth]: {
+        trainingCutoffYear: 2023
+      },
+      [import_core7.ToolName.ChangeAmplification]: {
+        // No specific options yet, uses global scan settings
+      }
     },
-    ...options.full ? {
-      visualizer: {
-        groupingDirs: ["packages", "src", "lib"],
-        graph: {
-          maxNodes: 5e3,
-          maxEdges: 1e4
-        }
+    // Visualizer settings (interactive graph)
+    visualizer: {
+      groupingDirs: ["packages", "src", "lib"],
+      graph: {
+        maxNodes: 5e3,
+        maxEdges: 1e4
       }
-    } : {}
+    }
   };
   const defaultConfig = baseConfig;
   let content;
   if (fileExt === "js") {
-    content = `/** @type {import('@aiready/core').AIReadyConfig} */
-module.exports = ${JSON.stringify(
-      defaultConfig,
-      null,
-      2
-    )};
+    content = `/** 
+ * AIReady Configuration
+ * @type {import('@aiready/core').AIReadyConfig} 
+ */
+module.exports = ${JSON.stringify(defaultConfig, null, 2)};
 `;
   } else {
     content = JSON.stringify(defaultConfig, null, 2);
@@ -1041,7 +1158,7 @@ var import_core8 = require("@aiready/core");
 async function patternsAction(directory, options) {
   console.log(import_chalk6.default.blue("\u{1F50D} Analyzing patterns...\n"));
   const startTime = Date.now();
-  const resolvedDir = (0, import_path5.resolve)(process.cwd(), directory || ".");
+  const resolvedDir = (0, import_path5.resolve)(process.cwd(), directory ?? ".");
   try {
     const useSmartDefaults = !options.fullScan;
     const defaults = {
@@ -1085,8 +1202,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,
@@ -1187,7 +1304,7 @@ var import_core9 = require("@aiready/core");
 async function contextAction(directory, options) {
   console.log(import_chalk7.default.blue("\u{1F9E0} Analyzing context costs...\n"));
   const startTime = Date.now();
-  const resolvedDir = (0, import_path6.resolve)(process.cwd(), directory || ".");
+  const resolvedDir = (0, import_path6.resolve)(process.cwd(), directory ?? ".");
   try {
     const defaults = {
       maxDepth: 5,
@@ -1231,8 +1348,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,
@@ -1250,7 +1367,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(import_chalk7.default.cyan(divider));
@@ -1388,7 +1505,7 @@ var import_core10 = require("@aiready/core");
 async function consistencyAction(directory, options) {
   console.log(import_chalk8.default.blue("\u{1F50D} Analyzing consistency...\n"));
   const startTime = Date.now();
-  const resolvedDir = (0, import_path7.resolve)(process.cwd(), directory || ".");
+  const resolvedDir = (0, import_path7.resolve)(process.cwd(), directory ?? ".");
   try {
     const defaults = {
       checkNaming: true,
@@ -1413,14 +1530,14 @@ async function consistencyAction(directory, options) {
     const elapsedTime = (0, import_core10.getElapsedTime)(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,
@@ -1458,7 +1575,7 @@ async function consistencyAction(directory, options) {
       console.log(`  Naming: ${import_chalk8.default.yellow(report.summary.namingIssues)}`);
       console.log(`  Patterns: ${import_chalk8.default.yellow(report.summary.patternIssues)}`);
       console.log(
-        `  Architecture: ${import_chalk8.default.yellow(report.summary.architectureIssues || 0)}`
+        `  Architecture: ${import_chalk8.default.yellow(report.summary.architectureIssues ?? 0)}`
       );
       console.log(`Analysis Time: ${import_chalk8.default.gray(elapsedTime + "s")}
 `);
@@ -1557,7 +1674,7 @@ var import_core11 = require("@aiready/core");
 var import_core12 = require("@aiready/core");
 async function visualizeAction(directory, options) {
   try {
-    const dirPath = (0, import_path8.resolve)(process.cwd(), directory || ".");
+    const dirPath = (0, import_path8.resolve)(process.cwd(), directory ?? ".");
     let reportPath = options.report ? (0, import_path8.resolve)(dirPath, options.report) : null;
     if (!reportPath || !(0, import_fs6.existsSync)(reportPath)) {
       const latestScan = (0, import_core12.findLatestReport)(dirPath);
@@ -1603,7 +1720,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 {
@@ -1719,7 +1836,7 @@ Or specify a custom report:
     console.log("Generating HTML...");
     const html = (0, import_core12.generateHTML)(graph);
     const defaultOutput = "visualization.html";
-    const outPath = (0, import_path8.resolve)(dirPath, options.output || defaultOutput);
+    const outPath = (0, import_path8.resolve)(dirPath, options.output ?? defaultOutput);
     (0, import_fs6.writeFileSync)(outPath, html, "utf8");
     console.log(import_chalk9.default.green(`\u2705 Visualization written to: ${outPath}`));
     if (options.open || options.serve) {
@@ -1731,7 +1848,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, {
@@ -1869,7 +1986,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 = `