@aiready/cli 0.14.9 → 0.14.11

package/src/commands/__tests__/init.test.ts

@@ -28,29 +28,24 @@ describe('initAction', () => {
     }
   });
 
-  it('should generate aiready.json without output field by default', async () => {
+  it('should generate aiready.json with output field by default', async () => {
     await initAction({});
 
     expect(existsSync(configPath)).toBe(true);
     const config = JSON.parse(readFileSync(configPath, 'utf8'));
-    expect(config).not.toHaveProperty('output');
+    expect(config).toHaveProperty('output');
+    expect(config.output.format).toBe('console');
   });
 
-  it('should generate aiready.json without output field even with --full flag', async () => {
-    await initAction({ full: true });
-
-    expect(existsSync(configPath)).toBe(true);
-    const config = JSON.parse(readFileSync(configPath, 'utf8'));
-    expect(config).not.toHaveProperty('output');
-  });
-
-  it('should include scan, tools, and scoring sections', async () => {
+  it('should include scan, tools, scoring, and visualizer sections', async () => {
     await initAction({ full: true });
 
     const config = JSON.parse(readFileSync(configPath, 'utf8'));
     expect(config).toHaveProperty('scan');
     expect(config).toHaveProperty('tools');
     expect(config).toHaveProperty('scoring');
+    expect(config).toHaveProperty('output');
     expect(config).toHaveProperty('visualizer');
+    expect(config).toHaveProperty('threshold');
   });
 });

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/init.ts

@@ -20,6 +20,10 @@ export async function initAction(options: {
   }
 
   const baseConfig = {
+    // Target quality score threshold (0-100)
+    threshold: 75,
+
+    // Global scan settings
     scan: {
       include: [
         'src/**/*.ts',
@@ -46,6 +50,20 @@ export async function initAction(options: {
         ToolName.ChangeAmplification,
       ],
     },
+
+    // Output preferences
+    output: {
+      format: 'console',
+      showBreakdown: true,
+      saveTo: 'aiready-report.json',
+    },
+
+    // Scoring profile and weights
+    scoring: {
+      profile: 'balanced',
+    },
+
+    // Tool-specific configurations
     tools: {
       [ToolName.PatternDetect]: {
         minSimilarity: 0.8,
@@ -73,9 +91,33 @@ export async function initAction(options: {
       },
       [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: [] } : {}),
       },
       [ToolName.AiSignalClarity]: {
         checkMagicLiterals: true,
@@ -86,53 +128,45 @@ export async function initAction(options: {
           ? { checkImplicitSideEffects: false, checkDeepCallbacks: false }
           : {}),
       },
-      ...(options.full
-        ? {
-            [ToolName.AgentGrounding]: {
-              maxRecommendedDepth: 5,
-              readmeStaleDays: 30,
-            },
-            [ToolName.TestabilityIndex]: {
-              minCoverageRatio: 0.7,
-              testPatterns: ['**/*.test.ts', '**/__tests__/**'],
-            },
-            [ToolName.DocDrift]: {
-              maxCommits: 50,
-              staleMonths: 3,
-            },
-            [ToolName.DependencyHealth]: {
-              trainingCutoffYear: 2023,
-            },
-          }
-        : {}),
+      [ToolName.AgentGrounding]: {
+        maxRecommendedDepth: 5,
+        readmeStaleDays: 30,
+      },
+      [ToolName.TestabilityIndex]: {
+        minCoverageRatio: 0.7,
+        testPatterns: ['**/*.test.ts', '**/__tests__/**'],
+      },
+      [ToolName.DocDrift]: {
+        maxCommits: 50,
+        staleMonths: 3,
+      },
+      [ToolName.DependencyHealth]: {
+        trainingCutoffYear: 2023,
+      },
+      [ToolName.ChangeAmplification]: {
+        // No specific options yet, uses global scan settings
+      },
     },
-    scoring: {
-      threshold: 70,
-      showBreakdown: true,
-      ...(options.full ? { profile: 'default' } : {}),
+
+    // Visualizer settings (interactive graph)
+    visualizer: {
+      groupingDirs: ['packages', 'src', 'lib'],
+      graph: {
+        maxNodes: 5000,
+        maxEdges: 10000,
+      },
     },
-    ...(options.full
-      ? {
-          visualizer: {
-            groupingDirs: ['packages', 'src', 'lib'],
-            graph: {
-              maxNodes: 5000,
-              maxEdges: 10000,
-            },
-          },
-        }
-      : {}),
   };
 
   const defaultConfig = baseConfig;
 
   let content: string;
   if (fileExt === 'js') {
-    content = `/** @type {import('@aiready/core').AIReadyConfig} */\nmodule.exports = ${JSON.stringify(
-      defaultConfig,
-      null,
-      2
-    )};\n`;
+    content = `/** 
+ * AIReady Configuration
+ * @type {import('@aiready/core').AIReadyConfig} 
+ */
+module.exports = ${JSON.stringify(defaultConfig, null, 2)};\n`;
   } else {
     content = JSON.stringify(defaultConfig, null, 2);
   }

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

@@ -7,6 +7,95 @@ import {
   getRatingDisplay,
 } from '@aiready/core';
 
+/**
+ * Generate a visual progress bar for a score.
+ *
+ * @param score - The score value (0-100)
+ * @param width - The width of the progress bar
+ * @returns A colored progress bar string
+ */
+function generateProgressBar(score: number, width: number = 20): string {
+  const filled = Math.round((score / 100) * width);
+  const empty = width - filled;
+
+  let color = chalk.red;
+  if (score >= 90) color = chalk.green;
+  else if (score >= 75) color = chalk.cyan;
+  else if (score >= 60) color = chalk.yellow;
+
+  const bar = '█'.repeat(filled) + '░'.repeat(empty);
+  return color(bar);
+}
+
+/**
+ * Count issues by severity level from all tool results.
+ *
+ * @param results - The unified results object
+ * @returns Object with counts for each severity level
+ */
+function countIssuesBySeverity(results: any): {
+  critical: number;
+  major: number;
+  minor: number;
+} {
+  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 };
+}
+
+/**
+ * Get top files with most issues.
+ *
+ * @param results - The unified results object
+ * @param limit - Maximum number of files to return
+ * @returns Array of files with issue counts
+ */
+function getTopFilesWithIssues(
+  results: any,
+  limit: number = 5
+): Array<{ file: string; count: number }> {
+  const fileCounts = new Map<string, number>();
+
+  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);
+}
+
 /**
  * Handle console output for the scan results.
  *
@@ -14,12 +103,48 @@ import {
  * @param startTime - The timestamp when the scan started.
  */
 export function printScanSummary(results: any, startTime: number) {
+  // Count issues by severity
+  const severity = countIssuesBySeverity(results);
+  const totalIssues = severity.critical + severity.major + severity.minor;
+
+  // Get top files with issues
+  const topFiles = getTopFilesWithIssues(results);
+
   console.log(chalk.cyan('\n=== AIReady Run Summary ==='));
+  console.log(`  Total issues: ${chalk.bold(String(totalIssues))}`);
+
+  // Severity breakdown
+  if (totalIssues > 0) {
+    console.log(chalk.dim('  Severity breakdown:'));
+    if (severity.critical > 0) {
+      console.log(
+        `    ${chalk.red('●')} Critical: ${chalk.bold(severity.critical)}`
+      );
+    }
+    if (severity.major > 0) {
+      console.log(
+        `    ${chalk.yellow('●')} Major: ${chalk.bold(severity.major)}`
+      );
+    }
+    if (severity.minor > 0) {
+      console.log(
+        `    ${chalk.blue('●')} Minor: ${chalk.bold(severity.minor)}`
+      );
+    }
+  }
+
+  // Top files with issues
+  if (topFiles.length > 0) {
+    console.log(chalk.dim('\n  Top files with issues:'));
+    topFiles.forEach((item) => {
+      console.log(
+        `    ${chalk.yellow('→')} ${item.file}: ${chalk.bold(item.count)} issues`
+      );
+    });
+  }
+
   console.log(
-    `  Total issues (all tools): ${chalk.bold(String(results.summary.totalIssues || 0))}`
-  );
-  console.log(
-    `  Execution time: ${chalk.bold(((Date.now() - startTime) / 1000).toFixed(2) + 's')}`
+    `\n  Execution time: ${chalk.bold(((Date.now() - startTime) / 1000).toFixed(2) + 's')}`
   );
 }
 
@@ -61,25 +186,26 @@ 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;
+      const progressBar = generateProgressBar(tool.score, 15);
       console.log(
-        `  - ${tool.toolName}: ${tool.score}/100 (${rating}) ${emoji}`
+        `  ${progressBar} ${tool.score}/100 (${rating}) ${emoji} ${tool.toolName}`
       );
     });
 
-    // Top Actionable Recommendations
+    // Top Actionable Recommendations - increased from 3 to 5
     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)
-      .slice(0, 3);
+      .sort((a: any, b: any) => b.estimatedImpact - a.estimatedImpact)
+      .slice(0, 5); // Increased from 3 to 5
 
     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'
             ? '🔴'

package/src/commands/scan.ts

@@ -57,7 +57,7 @@ export async function scanAction(directory: string, options: ScanOptions) {
   console.log(chalk.blue('🚀 Starting AIReady unified analysis...\n'));
 
   const startTime = Date.now();
-  const resolvedDir = resolvePath(process.cwd(), directory || '.');
+  const resolvedDir = resolvePath(process.cwd(), directory ?? '.');
   const repoMetadata = getRepoMetadata(resolvedDir);
 
   try {
@@ -159,7 +159,7 @@ export async function scanAction(directory: string, options: ScanOptions) {
       const { getSmartDefaults } = await import('@aiready/pattern-detect');
       const patternSmartDefaults = await getSmartDefaults(
         resolvedDir,
-        finalOptions.toolConfigs?.[ToolName.PatternDetect] || {}
+        finalOptions.toolConfigs?.[ToolName.PatternDetect] ?? {}
       );
 
       // Merge smart defaults into toolConfigs instead of root level
@@ -173,7 +173,7 @@ export async function scanAction(directory: string, options: ScanOptions) {
     console.log(chalk.cyan('\n=== AIReady Run Preview ==='));
     console.log(
       chalk.white('Tools to run:'),
-      (finalOptions.tools || []).join(', ')
+      (finalOptions.tools ?? []).join(', ')
     );
 
     // Dynamic progress callback
@@ -202,7 +202,7 @@ export async function scanAction(directory: string, options: ScanOptions) {
 
     // Determine scoring profile for project-type-aware weighting
     const scoringProfile =
-      options.profile || baseOptions.scoring?.profile || 'default';
+      options.profile ?? baseOptions.scoring?.profile ?? 'default';
 
     const results = await analyzeUnified({
       ...finalOptions,
@@ -233,7 +233,7 @@ export async function scanAction(directory: string, options: ScanOptions) {
             readFileSync(resolvePath(process.cwd(), options.compareTo), 'utf8')
           );
           const prevScore =
-            prevReport.scoring?.overall || prevReport.scoring?.score;
+            prevReport.scoring?.overall ?? prevReport.scoring?.score;
           if (typeof prevScore === 'number') {
             const diff = scoringResult.overall - prevScore;
             const diffStr = diff > 0 ? `+${diff}` : String(diff);
@@ -262,19 +262,19 @@ export async function scanAction(directory: string, options: ScanOptions) {
       }
 
       // Token Budget & Cost Logic
-      const totalWastedDuplication = (scoringResult.breakdown || []).reduce(
-        (sum, s) =>
-          sum + (s.tokenBudget?.wastedTokens.bySource.duplication || 0),
+      const totalWastedDuplication = (scoringResult.breakdown ?? []).reduce(
+        (sum: number, s: any) =>
+          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: number, s: any) =>
+          sum + (s.tokenBudget?.wastedTokens?.bySource?.fragmentation ?? 0),
         0
       );
       const totalContext = Math.max(
-        ...(scoringResult.breakdown || []).map(
-          (s) => s.tokenBudget?.totalContextTokens || 0
+        ...(scoringResult.breakdown ?? []).map(
+          (s: any) => s.tokenBudget?.totalContextTokens ?? 0
         ),
         0
       );
@@ -300,7 +300,7 @@ export async function scanAction(directory: string, options: ScanOptions) {
           }
         }
 
-        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,
@@ -345,9 +345,9 @@ export async function scanAction(directory: string, options: ScanOptions) {
 
     // Output persistence
     const outputFormat =
-      options.output || finalOptions.output?.format || 'console';
+      options.output ?? finalOptions.output?.format ?? 'console';
     const outputPath = resolveOutputPath(
-      options.outputFile || finalOptions.output?.file,
+      options.outputFile ?? finalOptions.output?.file,
       `aiready-report-${getReportTimestamp()}.json`,
       resolvedDir
     );
@@ -380,8 +380,8 @@ export async function scanAction(directory: string, options: ScanOptions) {
       const threshold = options.threshold
         ? parseInt(options.threshold)
         : undefined;
-      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 = '';

package/src/commands/upload.ts

@@ -13,10 +13,10 @@ export async function uploadAction(file: string, options: UploadOptions) {
   const startTime = Date.now();
   const filePath = resolvePath(process.cwd(), file);
   const serverUrl =
-    options.server ||
-    process.env.AIREADY_SERVER ||
+    options.server ??
+    process.env.AIREADY_SERVER ??
     'https://dev.platform.getaiready.dev';
-  const apiKey = options.apiKey || process.env.AIREADY_API_KEY;
+  const apiKey = options.apiKey ?? process.env.AIREADY_API_KEY;
 
   if (!apiKey) {
     console.error(chalk.red('❌ API Key is required for upload.'));
@@ -49,7 +49,7 @@ export async function uploadAction(file: string, options: UploadOptions) {
 
     // Prepare upload payload
     // Note: repoId is optional if the metadata contains it, but for now we'll require it or infer from metadata
-    const repoId = options.repoId || reportData.repository?.repoId;
+    const repoId = options.repoId ?? reportData.repository?.repoId;
 
     const response = await fetch(`${serverUrl}/api/analysis/upload`, {
       method: 'POST',
@@ -70,13 +70,13 @@ export async function uploadAction(file: string, options: UploadOptions) {
       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(
         chalk.red(
-          `❌ Upload failed: ${uploadResult.error || response.statusText}`
+          `❌ Upload failed: ${uploadResult.error ?? response.statusText}`
         )
       );
 

package/src/commands/visualize.ts

@@ -30,7 +30,7 @@ export async function visualizeAction(
   options: VisualizeOptions
 ) {
   try {
-    const dirPath = resolvePath(process.cwd(), directory || '.');
+    const dirPath = resolvePath(process.cwd(), directory ?? '.');
     let reportPath = options.report
       ? resolvePath(dirPath, options.report)
       : null;
@@ -87,7 +87,7 @@ export async function visualizeAction(
     const graph = GraphBuilder.buildFromReport(report, dirPath);
 
     // Check if --dev mode is requested and available
-    let useDevMode = options.dev || false;
+    let useDevMode = options.dev ?? false;
     let devServerStarted = false;
 
     if (useDevMode) {
@@ -230,7 +230,7 @@ export async function visualizeAction(
     console.log('Generating HTML...');
     const html = generateHTML(graph as any);
     const defaultOutput = 'visualization.html';
-    const outPath = resolvePath(dirPath, options.output || defaultOutput);
+    const outPath = resolvePath(dirPath, options.output ?? defaultOutput);
     writeFileSync(outPath, html, 'utf8');
     console.log(chalk.green(`✅ Visualization written to: ${outPath}`));
 
@@ -250,7 +250,7 @@ export async function visualizeAction(
 
           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, {