@aiready/cli 0.14.10 → 0.14.12

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,80 +762,125 @@ 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,
         minLines: 5,
+        minSharedTokens: 10,
+        approx: true,
         ...options.full ? {
-          batchSize: 50,
-          approx: true,
-          minSharedTokens: 10,
-          maxCandidatesPerBlock: 100
+          batchSize: 300,
+          maxCandidatesPerBlock: 500,
+          minClusterFiles: 3,
+          minClusterTokenCost: 1e3
         } : {}
       },
       [ToolName2.ContextAnalyzer]: {
         maxContextBudget: 128e3,
         minCohesion: 0.6,
-        ...options.full ? {
-          maxDepth: 7,
-          maxFragmentation: 0.4,
-          focus: "all",
-          includeNodeModules: false
-        } : {}
+        maxDepth: 7,
+        maxFragmentation: 0.4,
+        focus: "all",
+        includeNodeModules: false
       },
       [ToolName2.NamingConsistency]: {
+        checkNaming: true,
+        checkPatterns: true,
+        checkArchitecture: true,
         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",
+          "ENV",
+          "DEV",
+          "PROD",
+          "AWS",
+          "S3",
+          "ARN"
+        ],
+        ...options.full ? { disableChecks: [] } : {}
       },
       [ToolName2.AiSignalClarity]: {
         checkMagicLiterals: true,
         checkBooleanTraps: true,
         checkAmbiguousNames: true,
         checkUndocumentedExports: true,
-        ...options.full ? { checkImplicitSideEffects: false, checkDeepCallbacks: false } : {}
+        checkImplicitSideEffects: true,
+        checkDeepCallbacks: true,
+        checkOverloadedSymbols: true,
+        checkLargeFiles: true
       },
-      ...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,
+        additionalVagueNames: ["stuff", "misc", "temp", "test"]
+      },
+      [ToolName2.TestabilityIndex]: {
+        minCoverageRatio: 0.7,
+        testPatterns: ["**/*.test.ts", "**/__tests__/**", "**/*.spec.ts"],
+        maxDepth: 10
+      },
+      [ToolName2.DocDrift]: {
+        maxCommits: 50,
+        staleMonths: 3
+      },
+      [ToolName2.DependencyHealth]: {
+        trainingCutoffYear: 2023
+      },
+      [ToolName2.ChangeAmplification]: {
+        // Change amplification primarily relies on 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.12",
   "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/consistency": "0.20.9",
+    "@aiready/doc-drift": "0.13.9",
+    "@aiready/agent-grounding": "0.13.9",
+    "@aiready/context-analyzer": "0.21.13",
+    "@aiready/change-amplification": "0.13.9",
+    "@aiready/core": "0.23.10",
+    "@aiready/deps": "0.13.10",
+    "@aiready/visualizer": "0.6.9",
+    "@aiready/ai-signal-clarity": "0.13.10",
+    "@aiready/pattern-detect": "0.16.9",
+    "@aiready/testability": "0.6.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,93 +50,133 @@ 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,
         minLines: 5,
+        minSharedTokens: 10,
+        approx: true,
         ...(options.full
           ? {
-              batchSize: 50,
-              approx: true,
-              minSharedTokens: 10,
-              maxCandidatesPerBlock: 100,
+              batchSize: 300,
+              maxCandidatesPerBlock: 500,
+              minClusterFiles: 3,
+              minClusterTokenCost: 1000,
             }
           : {}),
       },
       [ToolName.ContextAnalyzer]: {
         maxContextBudget: 128000,
         minCohesion: 0.6,
-        ...(options.full
-          ? {
-              maxDepth: 7,
-              maxFragmentation: 0.4,
-              focus: 'all',
-              includeNodeModules: false,
-            }
-          : {}),
+        maxDepth: 7,
+        maxFragmentation: 0.4,
+        focus: 'all',
+        includeNodeModules: false,
       },
       [ToolName.NamingConsistency]: {
+        checkNaming: true,
+        checkPatterns: true,
+        checkArchitecture: true,
         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',
+          'ENV',
+          'DEV',
+          'PROD',
+          'AWS',
+          'S3',
+          'ARN',
+        ],
+        ...(options.full ? { disableChecks: [] } : {}),
       },
       [ToolName.AiSignalClarity]: {
         checkMagicLiterals: true,
         checkBooleanTraps: true,
         checkAmbiguousNames: true,
         checkUndocumentedExports: true,
-        ...(options.full
-          ? { checkImplicitSideEffects: false, checkDeepCallbacks: false }
-          : {}),
+        checkImplicitSideEffects: true,
+        checkDeepCallbacks: true,
+        checkOverloadedSymbols: true,
+        checkLargeFiles: true,
+      },
+      [ToolName.AgentGrounding]: {
+        maxRecommendedDepth: 5,
+        readmeStaleDays: 30,
+        additionalVagueNames: ['stuff', 'misc', 'temp', 'test'],
+      },
+      [ToolName.TestabilityIndex]: {
+        minCoverageRatio: 0.7,
+        testPatterns: ['**/*.test.ts', '**/__tests__/**', '**/*.spec.ts'],
+        maxDepth: 10,
+      },
+      [ToolName.DocDrift]: {
+        maxCommits: 50,
+        staleMonths: 3,
+      },
+      [ToolName.DependencyHealth]: {
+        trainingCutoffYear: 2023,
+      },
+      [ToolName.ChangeAmplification]: {
+        // Change amplification primarily relies on global scan settings
       },
-      ...(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,
-            },
-          }
-        : {}),
     },
-    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);
   }