@aiready/cli 0.14.8 → 0.14.10

package/dist/chunk-ZQOTGPK4.mjs

@@ -0,0 +1,289 @@
+var __require = /* @__PURE__ */ ((x) => typeof require !== "undefined" ? require : typeof Proxy !== "undefined" ? new Proxy(x, {
+  get: (a, b) => (typeof require !== "undefined" ? require : a)[b]
+}) : x)(function(x) {
+  if (typeof require !== "undefined") return require.apply(this, arguments);
+  throw Error('Dynamic require of "' + x + '" is not supported');
+});
+
+// src/index.ts
+import {
+  ToolRegistry,
+  ToolName,
+  calculateOverallScore,
+  calculateTokenBudget,
+  GLOBAL_INFRA_OPTIONS,
+  COMMON_FINE_TUNING_OPTIONS,
+  initializeParsers
+} from "@aiready/core";
+import "@aiready/pattern-detect";
+import "@aiready/context-analyzer";
+import "@aiready/consistency";
+import "@aiready/ai-signal-clarity";
+import "@aiready/agent-grounding";
+import "@aiready/testability";
+import "@aiready/doc-drift";
+import "@aiready/deps";
+import "@aiready/change-amplification";
+var TOOL_PACKAGE_MAP = {
+  [ToolName.PatternDetect]: "@aiready/pattern-detect",
+  [ToolName.ContextAnalyzer]: "@aiready/context-analyzer",
+  [ToolName.NamingConsistency]: "@aiready/consistency",
+  [ToolName.AiSignalClarity]: "@aiready/ai-signal-clarity",
+  [ToolName.AgentGrounding]: "@aiready/agent-grounding",
+  [ToolName.TestabilityIndex]: "@aiready/testability",
+  [ToolName.DocDrift]: "@aiready/doc-drift",
+  [ToolName.DependencyHealth]: "@aiready/deps",
+  [ToolName.ChangeAmplification]: "@aiready/change-amplification",
+  // Aliases handled by registry
+  patterns: "@aiready/pattern-detect",
+  duplicates: "@aiready/pattern-detect",
+  context: "@aiready/context-analyzer",
+  fragmentation: "@aiready/context-analyzer",
+  consistency: "@aiready/consistency",
+  "ai-signal": "@aiready/ai-signal-clarity",
+  grounding: "@aiready/agent-grounding",
+  testability: "@aiready/testability",
+  "deps-health": "@aiready/deps",
+  "change-amp": "@aiready/change-amplification"
+};
+function sanitizeConfigRecursive(obj) {
+  if (!obj || typeof obj !== "object" || Array.isArray(obj)) return obj;
+  const sanitized = {};
+  const infraToStrip = [
+    "rootDir",
+    "onProgress",
+    "progressCallback",
+    "streamResults",
+    "batchSize",
+    "useSmartDefaults"
+  ];
+  for (const [key, value] of Object.entries(obj)) {
+    if (infraToStrip.includes(key)) continue;
+    if (typeof value === "object" && value !== null && !Array.isArray(value)) {
+      sanitized[key] = sanitizeConfigRecursive(value);
+    } else {
+      sanitized[key] = value;
+    }
+  }
+  return sanitized;
+}
+function sanitizeToolConfig(config) {
+  return sanitizeConfigRecursive(config);
+}
+async function analyzeUnified(options) {
+  await initializeParsers();
+  const startTime = Date.now();
+  const requestedTools = options.tools ?? [
+    "patterns",
+    "context",
+    "consistency"
+  ];
+  const result = {
+    summary: {
+      totalIssues: 0,
+      criticalIssues: 0,
+      // Added as per instruction
+      majorIssues: 0,
+      // Added as per instruction
+      totalFiles: 0,
+      toolsRun: [],
+      executionTime: 0,
+      config: options,
+      toolConfigs: {}
+    }
+  };
+  for (const toolName of requestedTools) {
+    let provider = ToolRegistry.find(toolName);
+    if (!provider) {
+      const packageName = TOOL_PACKAGE_MAP[toolName] || (toolName.startsWith("@aiready/") ? toolName : `@aiready/${toolName}`);
+      try {
+        await import(packageName);
+        provider = ToolRegistry.find(toolName);
+        if (provider) {
+          console.log(
+            `\u2705 Successfully loaded tool provider: ${toolName} from ${packageName}`
+          );
+        } else {
+          console.log(
+            `\u26A0\uFE0F Loaded ${packageName} but provider ${toolName} still not found in registry.`
+          );
+        }
+      } catch (err) {
+        console.log(
+          `\u274C Failed to dynamically load tool ${toolName} (${packageName}):`,
+          err.message
+        );
+      }
+    }
+    if (!provider) {
+      console.warn(
+        `\u26A0\uFE0F  Warning: Tool provider for '${toolName}' not found. Skipping.`
+      );
+      continue;
+    }
+    try {
+      const sanitizedOptions = { ...options };
+      delete sanitizedOptions.onProgress;
+      delete sanitizedOptions.progressCallback;
+      const toolOptions = {
+        rootDir: options.rootDir
+        // Always include rootDir
+      };
+      [...GLOBAL_INFRA_OPTIONS, ...COMMON_FINE_TUNING_OPTIONS].forEach(
+        (key) => {
+          if (key in options && key !== "toolConfigs" && key !== "tools") {
+            toolOptions[key] = options[key];
+          }
+        }
+      );
+      if (options.toolConfigs?.[provider.id]) {
+        Object.assign(toolOptions, options.toolConfigs[provider.id]);
+      } else if (options.tools && !Array.isArray(options.tools) && typeof options.tools === "object" && options.tools[provider.id]) {
+        Object.assign(toolOptions, options.tools[provider.id]);
+      } else if (options[provider.id]) {
+        Object.assign(toolOptions, options[provider.id]);
+      }
+      toolOptions.onProgress = (processed, total, message) => {
+        if (options.progressCallback) {
+          options.progressCallback({
+            tool: provider.id,
+            processed,
+            total,
+            message
+          });
+        }
+      };
+      const output = await provider.analyze(toolOptions);
+      if (output.metadata) {
+        output.metadata.config = sanitizeToolConfig(toolOptions);
+      }
+      if (options.progressCallback) {
+        options.progressCallback({ tool: provider.id, data: output });
+      }
+      result[provider.id] = output;
+      result.summary.toolsRun.push(provider.id);
+      if (output.summary?.config) {
+        result.summary.toolConfigs[provider.id] = sanitizeToolConfig(
+          output.summary.config
+        );
+      } else if (output.metadata?.config) {
+        result.summary.toolConfigs[provider.id] = sanitizeToolConfig(
+          output.metadata.config
+        );
+      } else {
+        result.summary.toolConfigs[provider.id] = sanitizeToolConfig(toolOptions);
+      }
+      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),
+        0
+      );
+      result.summary.totalIssues += issueCount;
+    } catch (err) {
+      console.error(`\u274C Error running tool '${provider.id}':`, err);
+    }
+  }
+  result.summary.config = sanitizeConfigRecursive({
+    scan: {
+      tools: requestedTools,
+      include: options.include,
+      exclude: options.exclude
+    },
+    // Use 'tools' for tool-specific configurations to match AIReadyConfig
+    tools: result.summary.toolConfigs
+  });
+  result.summary.executionTime = Date.now() - startTime;
+  return result;
+}
+async function scoreUnified(results, options) {
+  const toolScores = /* @__PURE__ */ new Map();
+  for (const toolId of results.summary.toolsRun) {
+    const provider = ToolRegistry.get(toolId);
+    if (!provider) continue;
+    const output = results[toolId];
+    if (!output) continue;
+    try {
+      const toolScore = provider.score(output, options);
+      if (!toolScore.tokenBudget) {
+        if (toolId === ToolName.PatternDetect && output.duplicates) {
+          const wastedTokens = output.duplicates.reduce(
+            (sum, d) => sum + (d.tokenCost ?? 0),
+            0
+          );
+          toolScore.tokenBudget = calculateTokenBudget({
+            totalContextTokens: wastedTokens * 2,
+            wastedTokens: {
+              duplication: wastedTokens,
+              fragmentation: 0,
+              chattiness: 0
+            }
+          });
+        } else if (toolId === ToolName.ContextAnalyzer && output.summary) {
+          toolScore.tokenBudget = calculateTokenBudget({
+            totalContextTokens: output.summary.totalTokens,
+            wastedTokens: {
+              duplication: 0,
+              fragmentation: output.summary.totalPotentialSavings ?? 0,
+              chattiness: 0
+            }
+          });
+        }
+      }
+      toolScores.set(toolId, toolScore);
+    } catch (err) {
+      console.error(`\u274C Error scoring tool '${toolId}':`, err);
+    }
+  }
+  if (toolScores.size === 0) {
+    return {
+      overall: 0,
+      rating: "Critical",
+      timestamp: (/* @__PURE__ */ new Date()).toISOString(),
+      toolsUsed: [],
+      breakdown: [],
+      calculation: {
+        formula: "0 / 0 = 0",
+        weights: {},
+        normalized: "0 / 0 = 0"
+      }
+    };
+  }
+  return calculateOverallScore(toolScores, options, void 0);
+}
+function generateUnifiedSummary(result) {
+  const { summary } = result;
+  let output = `\u{1F680} AIReady Analysis Complete
+
+`;
+  output += `\u{1F4CA} Summary:
+`;
+  output += `   Tools run: ${summary.toolsRun.join(", ")}
+`;
+  output += `   Total issues found: ${summary.totalIssues}
+`;
+  output += `   Execution time: ${(summary.executionTime / 1e3).toFixed(2)}s
+
+`;
+  for (const provider of ToolRegistry.getAll()) {
+    const toolResult = result[provider.id];
+    if (toolResult) {
+      const issueCount = toolResult.results.reduce(
+        (sum, r) => sum + (r.issues?.length ?? 0),
+        0
+      );
+      output += `\u2022 ${provider.id}: ${issueCount} issues
+`;
+    }
+  }
+  return output;
+}
+
+export {
+  __require,
+  analyzeUnified,
+  scoreUnified,
+  generateUnifiedSummary
+};

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
             }
           });
@@ -393,7 +397,7 @@ var import_core4 = require("@aiready/core");
 function printScanSummary(results, startTime) {
   console.log(import_chalk2.default.cyan("\n=== AIReady Run Summary ==="));
   console.log(
-    `  Total issues (all tools): ${import_chalk2.default.bold(String(results.summary.totalIssues || 0))}`
+    `  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")}`
@@ -428,7 +432,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(import_chalk2.default.bold("\n\u{1F3AF} Top Actionable Recommendations:"));
@@ -482,8 +486,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 +512,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 +531,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 +587,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 +677,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 +688,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 +709,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 +733,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 +760,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 +794,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 +831,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 +860,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);
@@ -1041,7 +1045,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 +1089,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 +1191,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 +1235,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 +1254,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 +1392,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 +1417,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 +1462,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 +1561,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 +1607,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 +1723,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 +1735,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 +1873,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 = `
@@ -1958,15 +1962,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.*