@aiready/cli 0.14.10 → 0.14.11

package/dist/cli.mjs

@@ -131,13 +131,91 @@ import {
   getRating,
   getRatingDisplay
 } from "@aiready/core";
+function generateProgressBar(score, width = 20) {
+  const filled = Math.round(score / 100 * width);
+  const empty = width - filled;
+  let color = chalk2.red;
+  if (score >= 90) color = chalk2.green;
+  else if (score >= 75) color = chalk2.cyan;
+  else if (score >= 60) color = chalk2.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(chalk2.cyan("\n=== AIReady Run Summary ==="));
+  console.log(`  Total issues: ${chalk2.bold(String(totalIssues))}`);
+  if (totalIssues > 0) {
+    console.log(chalk2.dim("  Severity breakdown:"));
+    if (severity.critical > 0) {
+      console.log(
+        `    ${chalk2.red("\u25CF")} Critical: ${chalk2.bold(severity.critical)}`
+      );
+    }
+    if (severity.major > 0) {
+      console.log(
+        `    ${chalk2.yellow("\u25CF")} Major: ${chalk2.bold(severity.major)}`
+      );
+    }
+    if (severity.minor > 0) {
+      console.log(
+        `    ${chalk2.blue("\u25CF")} Minor: ${chalk2.bold(severity.minor)}`
+      );
+    }
+  }
+  if (topFiles.length > 0) {
+    console.log(chalk2.dim("\n  Top files with issues:"));
+    topFiles.forEach((item) => {
+      console.log(
+        `    ${chalk2.yellow("\u2192")} ${item.file}: ${chalk2.bold(item.count)} issues`
+      );
+    });
+  }
   console.log(
-    `  Total issues (all tools): ${chalk2.bold(String(results.summary.totalIssues ?? 0))}`
-  );
-  console.log(
-    `  Execution time: ${chalk2.bold(((Date.now() - startTime) / 1e3).toFixed(2) + "s")}`
+    `
+  Execution time: ${chalk2.bold(((Date.now() - startTime) / 1e3).toFixed(2) + "s")}`
   );
 }
 function printBusinessImpact(roi, unifiedBudget) {
@@ -164,13 +242,14 @@ function printScoring(scoringResult, scoringProfile) {
     scoringResult.breakdown.forEach((tool) => {
       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}`
       );
     });
     const allRecs = scoringResult.breakdown.flatMap(
       (t) => (t.recommendations ?? []).map((r) => ({ ...r, tool: t.toolName }))
-    ).sort((a, b) => b.estimatedImpact - a.estimatedImpact).slice(0, 3);
+    ).sort((a, b) => b.estimatedImpact - a.estimatedImpact).slice(0, 5);
     if (allRecs.length > 0) {
       console.log(chalk2.bold("\n\u{1F3AF} Top Actionable Recommendations:"));
       allRecs.forEach((rec, i) => {
@@ -654,6 +733,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",
@@ -680,6 +762,17 @@ async function initAction(options) {
         ToolName2.ChangeAmplification
       ]
     },
+    // Output preferences
+    output: {
+      format: "console",
+      showBreakdown: true,
+      saveTo: "aiready-report.json"
+    },
+    // Scoring profile and weights
+    scoring: {
+      profile: "balanced"
+    },
+    // Tool-specific configurations
     tools: {
       [ToolName2.PatternDetect]: {
         minSimilarity: 0.8,
@@ -703,7 +796,33 @@ async function initAction(options) {
       },
       [ToolName2.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: [] } : {}
       },
       [ToolName2.AiSignalClarity]: {
         checkMagicLiterals: true,
@@ -712,48 +831,42 @@ async function initAction(options) {
         checkUndocumentedExports: true,
         ...options.full ? { checkImplicitSideEffects: false, checkDeepCallbacks: false } : {}
       },
-      ...options.full ? {
-        [ToolName2.AgentGrounding]: {
-          maxRecommendedDepth: 5,
-          readmeStaleDays: 30
-        },
-        [ToolName2.TestabilityIndex]: {
-          minCoverageRatio: 0.7,
-          testPatterns: ["**/*.test.ts", "**/__tests__/**"]
-        },
-        [ToolName2.DocDrift]: {
-          maxCommits: 50,
-          staleMonths: 3
-        },
-        [ToolName2.DependencyHealth]: {
-          trainingCutoffYear: 2023
-        }
-      } : {}
-    },
-    scoring: {
-      threshold: 70,
-      showBreakdown: true,
-      ...options.full ? { profile: "default" } : {}
+      [ToolName2.AgentGrounding]: {
+        maxRecommendedDepth: 5,
+        readmeStaleDays: 30
+      },
+      [ToolName2.TestabilityIndex]: {
+        minCoverageRatio: 0.7,
+        testPatterns: ["**/*.test.ts", "**/__tests__/**"]
+      },
+      [ToolName2.DocDrift]: {
+        maxCommits: 50,
+        staleMonths: 3
+      },
+      [ToolName2.DependencyHealth]: {
+        trainingCutoffYear: 2023
+      },
+      [ToolName2.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);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aiready/cli",
-  "version": "0.14.10",
+  "version": "0.14.11",
   "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.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"
+    "@aiready/context-analyzer": "0.21.12",
+    "@aiready/consistency": "0.20.8",
+    "@aiready/core": "0.23.9",
+    "@aiready/agent-grounding": "0.13.8",
+    "@aiready/pattern-detect": "0.16.8",
+    "@aiready/deps": "0.13.9",
+    "@aiready/visualizer": "0.6.8",
+    "@aiready/change-amplification": "0.13.8",
+    "@aiready/doc-drift": "0.13.8",
+    "@aiready/testability": "0.6.8",
+    "@aiready/ai-signal-clarity": "0.13.9"
   },
   "devDependencies": {
     "@types/node": "^24.0.0",

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/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/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')}`
   );
 }
 
@@ -64,18 +189,19 @@ export function printScoring(
     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: any) =>
         (t.recommendations ?? []).map((r: any) => ({ ...r, tool: t.toolName }))
       )
       .sort((a: any, b: any) => b.estimatedImpact - a.estimatedImpact)
-      .slice(0, 3);
+      .slice(0, 5); // Increased from 3 to 5
 
     if (allRecs.length > 0) {
       console.log(chalk.bold('\n🎯 Top Actionable Recommendations:'));