@aiready/cli 0.9.18 → 0.9.20

package/.turbo/turbo-build.log

@@ -1,6 +1,6 @@
 
 
-> @aiready/cli@0.9.18 build /Users/pengcao/projects/aiready/packages/cli
+> @aiready/cli@0.9.20 build /Users/pengcao/projects/aiready/packages/cli
 > tsup src/index.ts src/cli.ts --format cjs,esm
 
 CLI Building entry: src/cli.ts, src/index.ts
@@ -9,10 +9,10 @@
 CLI Target: es2020
 CJS Build start
 ESM Build start
-CJS dist/cli.js   62.33 KB
 CJS dist/index.js 4.93 KB
-CJS ⚡️ Build success in 17ms
+CJS dist/cli.js   65.17 KB
+CJS ⚡️ Build success in 19ms
+ESM dist/cli.mjs            57.52 KB
 ESM dist/index.mjs          138.00 B
-ESM dist/cli.mjs            54.86 KB
 ESM dist/chunk-5GZDRZ3T.mjs 4.17 KB
-ESM ⚡️ Build success in 18ms
+ESM ⚡️ Build success in 20ms

package/.turbo/turbo-test.log

@@ -1,17 +1,17 @@
 
 
-> @aiready/cli@0.9.18 test /Users/pengcao/projects/aiready/packages/cli
+> @aiready/cli@0.9.20 test /Users/pengcao/projects/aiready/packages/cli
 > vitest run
 
 [?25l
  RUN  v4.0.18 /Users/pengcao/projects/aiready/packages/cli
 
- ✓ dist/__tests__/cli.test.js (3 tests) 7ms
  ✓ src/__tests__/cli.test.ts (3 tests) 2ms
+ ✓ dist/__tests__/cli.test.js (3 tests) 15ms
 
  Test Files  2 passed (2)
       Tests  6 passed (6)
-   Start at  13:51:03
-   Duration  1.26s (transform 279ms, setup 0ms, import 1.82s, tests 9ms, environment 0ms)
+   Start at  00:26:59
+   Duration  4.25s (transform 1.20s, setup 0ms, import 5.70s, tests 17ms, environment 0ms)
 
 [?25h

package/dist/cli.js

@@ -157,7 +157,7 @@ VERSION: ${packageJson.version}
 DOCUMENTATION: https://aiready.dev/docs/cli
 GITHUB: https://github.com/caopengau/aiready-cli
 LANDING: https://github.com/caopengau/aiready-landing`);
-program.command("scan").description("Run comprehensive AI-readiness analysis (patterns + context + consistency)").argument("[directory]", "Directory to analyze", ".").option("-t, --tools <tools>", "Tools to run (comma-separated: patterns,context,consistency)", "patterns,context,consistency").option("--include <patterns>", "File patterns to include (comma-separated)").option("--exclude <patterns>", "File patterns to exclude (comma-separated)").option("-o, --output <format>", "Output format: console, json", "console").option("--output-file <path>", "Output file path (for json)").option("--score", "Calculate and display AI Readiness Score (0-100) with breakdown").option("--weights <weights>", "Custom scoring weights (patterns:40,context:35,consistency:25)").option("--threshold <score>", "Fail CI/CD if score below threshold (0-100)").addHelpText("after", `
+program.command("scan").description("Run comprehensive AI-readiness analysis (patterns + context + consistency)").argument("[directory]", "Directory to analyze", ".").option("-t, --tools <tools>", "Tools to run (comma-separated: patterns,context,consistency)", "patterns,context,consistency").option("--include <patterns>", "File patterns to include (comma-separated)").option("--exclude <patterns>", "File patterns to exclude (comma-separated)").option("-o, --output <format>", "Output format: console, json", "json").option("--output-file <path>", "Output file path (for json)").option("--score", "Calculate and display AI Readiness Score (0-100) with breakdown").option("--weights <weights>", "Custom scoring weights (patterns:40,context:35,consistency:25)").option("--threshold <score>", "Fail CI/CD if score below threshold (0-100)").addHelpText("after", `
 EXAMPLES:
   $ aiready scan                                    # Analyze all tools
   $ aiready scan --tools patterns,context           # Skip consistency
@@ -173,7 +173,7 @@ EXAMPLES:
       include: void 0,
       exclude: void 0,
       output: {
-        format: "console",
+        format: "json",
         file: void 0
       }
     };
@@ -392,6 +392,7 @@ EXAMPLES:
       const outputPath = (0, import_core.resolveOutputPath)(userOutputFile, defaultFilename, resolvedDir);
       const outputData = { ...results, scoring: scoringResult };
       (0, import_core.handleJSONOutput)(outputData, outputPath, `\u2705 Report saved to ${outputPath}`);
+      warnIfGraphCapExceeded(outputData, resolvedDir);
     }
   } catch (error) {
     (0, import_core.handleCLIError)(error, "Analysis");
@@ -1001,6 +1002,50 @@ function findLatestScanReport(dirPath) {
   const sortedFiles = files.map((f) => ({ name: f, path: (0, import_path2.resolve)(aireadyDir, f), mtime: statSync((0, import_path2.resolve)(aireadyDir, f)).mtime })).sort((a, b) => b.mtime.getTime() - a.mtime.getTime());
   return sortedFiles[0].path;
 }
+function warnIfGraphCapExceeded(report, dirPath) {
+  try {
+    const { loadConfig } = require("@aiready/core");
+    const { existsSync: existsSync2, readFileSync: readFileSync2 } = require("fs");
+    const { resolve } = require("path");
+    let graphConfig = { maxNodes: 400, maxEdges: 600 };
+    const configPath = resolve(dirPath, "aiready.json");
+    if (existsSync2(configPath)) {
+      try {
+        const rawConfig = JSON.parse(readFileSync2(configPath, "utf8"));
+        if (rawConfig.visualizer?.graph) {
+          graphConfig = {
+            maxNodes: rawConfig.visualizer.graph.maxNodes ?? graphConfig.maxNodes,
+            maxEdges: rawConfig.visualizer.graph.maxEdges ?? graphConfig.maxEdges
+          };
+        }
+      } catch (e) {
+      }
+    }
+    const nodeCount = (report.context?.length || 0) + (report.patterns?.length || 0);
+    const edgeCount = report.context?.reduce((sum, ctx) => {
+      const relCount = ctx.relatedFiles?.length || 0;
+      const depCount = ctx.dependencies?.length || 0;
+      return sum + relCount + depCount;
+    }, 0) || 0;
+    if (nodeCount > graphConfig.maxNodes || edgeCount > graphConfig.maxEdges) {
+      console.log("");
+      console.log(import_chalk.default.yellow(`\u26A0\uFE0F  Graph may be truncated at visualization time:`));
+      if (nodeCount > graphConfig.maxNodes) {
+        console.log(import_chalk.default.dim(`   \u2022 Nodes: ${nodeCount} > limit ${graphConfig.maxNodes}`));
+      }
+      if (edgeCount > graphConfig.maxEdges) {
+        console.log(import_chalk.default.dim(`   \u2022 Edges: ${edgeCount} > limit ${graphConfig.maxEdges}`));
+      }
+      console.log(import_chalk.default.dim(`   To increase limits, add to aiready.json:`));
+      console.log(import_chalk.default.dim(`   {`));
+      console.log(import_chalk.default.dim(`     "visualizer": {`));
+      console.log(import_chalk.default.dim(`       "graph": { "maxNodes": 2000, "maxEdges": 5000 }`));
+      console.log(import_chalk.default.dim(`     }`));
+      console.log(import_chalk.default.dim(`   }`));
+    }
+  } catch (e) {
+  }
+}
 async function handleVisualize(directory, options) {
   try {
     const dirPath = (0, import_path2.resolve)(process.cwd(), directory || ".");
@@ -1023,6 +1068,22 @@ Or specify a custom report:
     }
     const raw = (0, import_fs2.readFileSync)(reportPath, "utf8");
     const report = JSON.parse(raw);
+    const configPath = (0, import_path2.resolve)(dirPath, "aiready.json");
+    let graphConfig = { maxNodes: 400, maxEdges: 600 };
+    if ((0, import_fs2.existsSync)(configPath)) {
+      try {
+        const rawConfig = JSON.parse((0, import_fs2.readFileSync)(configPath, "utf8"));
+        if (rawConfig.visualizer?.graph) {
+          graphConfig = {
+            maxNodes: rawConfig.visualizer.graph.maxNodes ?? graphConfig.maxNodes,
+            maxEdges: rawConfig.visualizer.graph.maxEdges ?? graphConfig.maxEdges
+          };
+        }
+      } catch (e) {
+      }
+    }
+    const envVisualizerConfig = JSON.stringify(graphConfig);
+    process.env.AIREADY_VISUALIZER_CONFIG = envVisualizerConfig;
     console.log("Building graph from report...");
     const { GraphBuilder } = await import("@aiready/visualizer/graph");
     const graph = GraphBuilder.buildFromReport(report, dirPath);
@@ -1087,7 +1148,11 @@ Or specify a custom report:
           if (watchTimeout) clearTimeout(watchTimeout);
           watchTimeout = setTimeout(copyReportToViz, 100);
         });
-        const envForSpawn = { ...process.env, AIREADY_REPORT_PATH: reportPath };
+        const envForSpawn = {
+          ...process.env,
+          AIREADY_REPORT_PATH: reportPath,
+          AIREADY_VISUALIZER_CONFIG: envVisualizerConfig
+        };
         const vite = spawn("pnpm", ["run", "dev:web"], { cwd: spawnCwd, stdio: "inherit", shell: true, env: envForSpawn });
         const onExit = () => {
           try {

package/dist/cli.mjs

@@ -62,7 +62,7 @@ VERSION: ${packageJson.version}
 DOCUMENTATION: https://aiready.dev/docs/cli
 GITHUB: https://github.com/caopengau/aiready-cli
 LANDING: https://github.com/caopengau/aiready-landing`);
-program.command("scan").description("Run comprehensive AI-readiness analysis (patterns + context + consistency)").argument("[directory]", "Directory to analyze", ".").option("-t, --tools <tools>", "Tools to run (comma-separated: patterns,context,consistency)", "patterns,context,consistency").option("--include <patterns>", "File patterns to include (comma-separated)").option("--exclude <patterns>", "File patterns to exclude (comma-separated)").option("-o, --output <format>", "Output format: console, json", "console").option("--output-file <path>", "Output file path (for json)").option("--score", "Calculate and display AI Readiness Score (0-100) with breakdown").option("--weights <weights>", "Custom scoring weights (patterns:40,context:35,consistency:25)").option("--threshold <score>", "Fail CI/CD if score below threshold (0-100)").addHelpText("after", `
+program.command("scan").description("Run comprehensive AI-readiness analysis (patterns + context + consistency)").argument("[directory]", "Directory to analyze", ".").option("-t, --tools <tools>", "Tools to run (comma-separated: patterns,context,consistency)", "patterns,context,consistency").option("--include <patterns>", "File patterns to include (comma-separated)").option("--exclude <patterns>", "File patterns to exclude (comma-separated)").option("-o, --output <format>", "Output format: console, json", "json").option("--output-file <path>", "Output file path (for json)").option("--score", "Calculate and display AI Readiness Score (0-100) with breakdown").option("--weights <weights>", "Custom scoring weights (patterns:40,context:35,consistency:25)").option("--threshold <score>", "Fail CI/CD if score below threshold (0-100)").addHelpText("after", `
 EXAMPLES:
   $ aiready scan                                    # Analyze all tools
   $ aiready scan --tools patterns,context           # Skip consistency
@@ -78,7 +78,7 @@ EXAMPLES:
       include: void 0,
       exclude: void 0,
       output: {
-        format: "console",
+        format: "json",
         file: void 0
       }
     };
@@ -297,6 +297,7 @@ EXAMPLES:
       const outputPath = resolveOutputPath(userOutputFile, defaultFilename, resolvedDir);
       const outputData = { ...results, scoring: scoringResult };
       handleJSONOutput(outputData, outputPath, `\u2705 Report saved to ${outputPath}`);
+      warnIfGraphCapExceeded(outputData, resolvedDir);
     }
   } catch (error) {
     handleCLIError(error, "Analysis");
@@ -906,6 +907,50 @@ function findLatestScanReport(dirPath) {
   const sortedFiles = files.map((f) => ({ name: f, path: resolvePath(aireadyDir, f), mtime: statSync(resolvePath(aireadyDir, f)).mtime })).sort((a, b) => b.mtime.getTime() - a.mtime.getTime());
   return sortedFiles[0].path;
 }
+function warnIfGraphCapExceeded(report, dirPath) {
+  try {
+    const { loadConfig } = __require("@aiready/core");
+    const { existsSync: existsSync2, readFileSync: readFileSync2 } = __require("fs");
+    const { resolve } = __require("path");
+    let graphConfig = { maxNodes: 400, maxEdges: 600 };
+    const configPath = resolve(dirPath, "aiready.json");
+    if (existsSync2(configPath)) {
+      try {
+        const rawConfig = JSON.parse(readFileSync2(configPath, "utf8"));
+        if (rawConfig.visualizer?.graph) {
+          graphConfig = {
+            maxNodes: rawConfig.visualizer.graph.maxNodes ?? graphConfig.maxNodes,
+            maxEdges: rawConfig.visualizer.graph.maxEdges ?? graphConfig.maxEdges
+          };
+        }
+      } catch (e) {
+      }
+    }
+    const nodeCount = (report.context?.length || 0) + (report.patterns?.length || 0);
+    const edgeCount = report.context?.reduce((sum, ctx) => {
+      const relCount = ctx.relatedFiles?.length || 0;
+      const depCount = ctx.dependencies?.length || 0;
+      return sum + relCount + depCount;
+    }, 0) || 0;
+    if (nodeCount > graphConfig.maxNodes || edgeCount > graphConfig.maxEdges) {
+      console.log("");
+      console.log(chalk.yellow(`\u26A0\uFE0F  Graph may be truncated at visualization time:`));
+      if (nodeCount > graphConfig.maxNodes) {
+        console.log(chalk.dim(`   \u2022 Nodes: ${nodeCount} > limit ${graphConfig.maxNodes}`));
+      }
+      if (edgeCount > graphConfig.maxEdges) {
+        console.log(chalk.dim(`   \u2022 Edges: ${edgeCount} > limit ${graphConfig.maxEdges}`));
+      }
+      console.log(chalk.dim(`   To increase limits, add to aiready.json:`));
+      console.log(chalk.dim(`   {`));
+      console.log(chalk.dim(`     "visualizer": {`));
+      console.log(chalk.dim(`       "graph": { "maxNodes": 2000, "maxEdges": 5000 }`));
+      console.log(chalk.dim(`     }`));
+      console.log(chalk.dim(`   }`));
+    }
+  } catch (e) {
+  }
+}
 async function handleVisualize(directory, options) {
   try {
     const dirPath = resolvePath(process.cwd(), directory || ".");
@@ -928,6 +973,22 @@ Or specify a custom report:
     }
     const raw = readFileSync(reportPath, "utf8");
     const report = JSON.parse(raw);
+    const configPath = resolvePath(dirPath, "aiready.json");
+    let graphConfig = { maxNodes: 400, maxEdges: 600 };
+    if (existsSync(configPath)) {
+      try {
+        const rawConfig = JSON.parse(readFileSync(configPath, "utf8"));
+        if (rawConfig.visualizer?.graph) {
+          graphConfig = {
+            maxNodes: rawConfig.visualizer.graph.maxNodes ?? graphConfig.maxNodes,
+            maxEdges: rawConfig.visualizer.graph.maxEdges ?? graphConfig.maxEdges
+          };
+        }
+      } catch (e) {
+      }
+    }
+    const envVisualizerConfig = JSON.stringify(graphConfig);
+    process.env.AIREADY_VISUALIZER_CONFIG = envVisualizerConfig;
     console.log("Building graph from report...");
     const { GraphBuilder } = await import("@aiready/visualizer/graph");
     const graph = GraphBuilder.buildFromReport(report, dirPath);
@@ -992,7 +1053,11 @@ Or specify a custom report:
           if (watchTimeout) clearTimeout(watchTimeout);
           watchTimeout = setTimeout(copyReportToViz, 100);
         });
-        const envForSpawn = { ...process.env, AIREADY_REPORT_PATH: reportPath };
+        const envForSpawn = {
+          ...process.env,
+          AIREADY_REPORT_PATH: reportPath,
+          AIREADY_VISUALIZER_CONFIG: envVisualizerConfig
+        };
         const vite = spawn("pnpm", ["run", "dev:web"], { cwd: spawnCwd, stdio: "inherit", shell: true, env: envForSpawn });
         const onExit = () => {
           try {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aiready/cli",
-  "version": "0.9.18",
+  "version": "0.9.20",
   "description": "Unified CLI for AIReady analysis tools",
   "main": "./dist/index.js",
   "module": "./dist/index.mjs",
@@ -11,11 +11,11 @@
   "dependencies": {
     "commander": "^14.0.0",
     "chalk": "^5.3.0",
-    "@aiready/visualizer": "0.1.21",
-    "@aiready/consistency": "0.8.17",
-    "@aiready/pattern-detect": "0.11.17",
-    "@aiready/context-analyzer": "0.9.17",
-    "@aiready/core": "0.9.17"
+    "@aiready/visualizer": "0.1.25",
+    "@aiready/consistency": "0.8.19",
+    "@aiready/context-analyzer": "0.9.19",
+    "@aiready/core": "0.9.19",
+    "@aiready/pattern-detect": "0.11.19"
   },
   "devDependencies": {
     "tsup": "^8.3.5",

package/src/cli.ts

@@ -77,7 +77,7 @@ program
   .option('-t, --tools <tools>', 'Tools to run (comma-separated: patterns,context,consistency)', 'patterns,context,consistency')
   .option('--include <patterns>', 'File patterns to include (comma-separated)')
   .option('--exclude <patterns>', 'File patterns to exclude (comma-separated)')
-  .option('-o, --output <format>', 'Output format: console, json', 'console')
+  .option('-o, --output <format>', 'Output format: console, json', 'json')
   .option('--output-file <path>', 'Output file path (for json)')
   .option('--score', 'Calculate and display AI Readiness Score (0-100) with breakdown')
   .option('--weights <weights>', 'Custom scoring weights (patterns:40,context:35,consistency:25)')
@@ -103,7 +103,7 @@ EXAMPLES:
         include: undefined,
         exclude: undefined,
         output: {
-          format: 'console',
+          format: 'json',
           file: undefined,
         },
       };
@@ -381,6 +381,9 @@ EXAMPLES:
         const outputPath = resolveOutputPath(userOutputFile, defaultFilename, resolvedDir);
         const outputData = { ...results, scoring: scoringResult };
         handleJSONOutput(outputData, outputPath, `✅ Report saved to ${outputPath}`);
+        
+        // Warn if graph caps may be exceeded
+        warnIfGraphCapExceeded(outputData, resolvedDir);
       }
     } catch (error) {
       handleCLIError(error, 'Analysis');
@@ -1131,6 +1134,61 @@ program
     return sortedFiles[0].path;
   }
 
+  function warnIfGraphCapExceeded(report: any, dirPath: string) {
+    try {
+      // Use dynamic import and loadConfig to get the raw visualizer config
+      const { loadConfig } = require('@aiready/core');
+      
+      // Sync file system check since we can't easily call loadConfig synchronously
+      const { existsSync, readFileSync } = require('fs');
+      const { resolve } = require('path');
+      
+      let graphConfig = { maxNodes: 400, maxEdges: 600 };
+      
+      // Try to read aiready.json synchronously
+      const configPath = resolve(dirPath, 'aiready.json');
+      if (existsSync(configPath)) {
+        try {
+          const rawConfig = JSON.parse(readFileSync(configPath, 'utf8'));
+          if (rawConfig.visualizer?.graph) {
+            graphConfig = {
+              maxNodes: rawConfig.visualizer.graph.maxNodes ?? graphConfig.maxNodes,
+              maxEdges: rawConfig.visualizer.graph.maxEdges ?? graphConfig.maxEdges,
+            };
+          }
+        } catch (e) {
+          // Silently ignore parse errors and use defaults
+        }
+      }
+      
+      const nodeCount = (report.context?.length || 0) + (report.patterns?.length || 0);
+      const edgeCount = report.context?.reduce((sum: number, ctx: any) => {
+        const relCount = ctx.relatedFiles?.length || 0;
+        const depCount = ctx.dependencies?.length || 0;
+        return sum + relCount + depCount;
+      }, 0) || 0;
+      
+      if (nodeCount > graphConfig.maxNodes || edgeCount > graphConfig.maxEdges) {
+        console.log('');
+        console.log(chalk.yellow(`⚠️  Graph may be truncated at visualization time:`));
+        if (nodeCount > graphConfig.maxNodes) {
+          console.log(chalk.dim(`   • Nodes: ${nodeCount} > limit ${graphConfig.maxNodes}`));
+        }
+        if (edgeCount > graphConfig.maxEdges) {
+          console.log(chalk.dim(`   • Edges: ${edgeCount} > limit ${graphConfig.maxEdges}`));
+        }
+        console.log(chalk.dim(`   To increase limits, add to aiready.json:`));
+        console.log(chalk.dim(`   {`));
+        console.log(chalk.dim(`     "visualizer": {`));
+        console.log(chalk.dim(`       "graph": { "maxNodes": 2000, "maxEdges": 5000 }`));
+        console.log(chalk.dim(`     }`));
+        console.log(chalk.dim(`   }`));
+      }
+    } catch (e) {
+      // Silently fail on config read errors
+    }
+  }
+
   async function handleVisualize(directory: string | undefined, options: any) {
     try {
       const dirPath = resolvePath(process.cwd(), directory || '.');
@@ -1152,6 +1210,28 @@ program
       const raw = readFileSync(reportPath, 'utf8');
       const report = JSON.parse(raw);
 
+      // Load config to extract graph caps
+      const configPath = resolvePath(dirPath, 'aiready.json');
+      let graphConfig = { maxNodes: 400, maxEdges: 600 };
+      
+      if (existsSync(configPath)) {
+        try {
+          const rawConfig = JSON.parse(readFileSync(configPath, 'utf8'));
+          if (rawConfig.visualizer?.graph) {
+            graphConfig = {
+              maxNodes: rawConfig.visualizer.graph.maxNodes ?? graphConfig.maxNodes,
+              maxEdges: rawConfig.visualizer.graph.maxEdges ?? graphConfig.maxEdges,
+            };
+          }
+        } catch (e) {
+          // Silently ignore parse errors and use defaults
+        }
+      }
+      
+      // Store config in env for vite middleware to pass to client
+      const envVisualizerConfig = JSON.stringify(graphConfig);
+      process.env.AIREADY_VISUALIZER_CONFIG = envVisualizerConfig;
+
       console.log("Building graph from report...");
       const { GraphBuilder } = await import('@aiready/visualizer/graph');
       const graph = GraphBuilder.buildFromReport(report, dirPath);
@@ -1233,7 +1313,11 @@ program
             watchTimeout = setTimeout(copyReportToViz, 100);
           });
 
-          const envForSpawn = { ...process.env, AIREADY_REPORT_PATH: reportPath };
+          const envForSpawn = { 
+            ...process.env, 
+            AIREADY_REPORT_PATH: reportPath,
+            AIREADY_VISUALIZER_CONFIG: envVisualizerConfig 
+          };
           const vite = spawn("pnpm", ["run", "dev:web"], { cwd: spawnCwd, stdio: "inherit", shell: true, env: envForSpawn });
           const onExit = () => {
             try {