@aiready/cli 0.9.15 → 0.9.17

package/.turbo/turbo-build.log

@@ -1,6 +1,6 @@
 
 
-> @aiready/cli@0.9.15 build /Users/pengcao/projects/aiready/packages/cli
+> @aiready/cli@0.9.17 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   58.90 KB
 CJS dist/index.js 4.93 KB
-CJS ⚡️ Build success in 18ms
+CJS dist/cli.js   62.23 KB
+CJS ⚡️ Build success in 17ms
+ESM dist/cli.mjs            54.76 KB
 ESM dist/index.mjs          138.00 B
 ESM dist/chunk-5GZDRZ3T.mjs 4.17 KB
-ESM dist/cli.mjs            51.71 KB
-ESM ⚡️ Build success in 18ms
+ESM ⚡️ Build success in 17ms

package/.turbo/turbo-test.log

@@ -1,17 +1,17 @@
 
 
-> @aiready/cli@0.9.15 test /Users/pengcao/projects/aiready/packages/cli
+> @aiready/cli@0.9.17 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) 3ms
- ✓ src/__tests__/cli.test.ts (3 tests) 7ms
+ ✓ dist/__tests__/cli.test.js (3 tests) 4ms
+ ✓ src/__tests__/cli.test.ts (3 tests) 6ms
 
  Test Files  2 passed (2)
       Tests  6 passed (6)
-   Start at  23:54:01
-   Duration  1.52s (transform 330ms, setup 0ms, import 1.30s, tests 9ms, environment 55ms)
+   Start at  12:09:08
+   Duration  2.39s (transform 599ms, setup 0ms, import 3.19s, tests 10ms, environment 0ms)
 
 [?25h

package/dist/cli.js

@@ -166,6 +166,7 @@ EXAMPLES:
 `).action(async (directory, options) => {
   console.log(import_chalk.default.blue("\u{1F680} Starting AIReady unified analysis...\n"));
   const startTime = Date.now();
+  const resolvedDir = (0, import_path2.resolve)(process.cwd(), directory || ".");
   try {
     const defaults = {
       tools: ["patterns", "context", "consistency"],
@@ -176,7 +177,7 @@ EXAMPLES:
         file: void 0
       }
     };
-    const baseOptions = await (0, import_core.loadMergedConfig)(directory, defaults, {
+    const baseOptions = await (0, import_core.loadMergedConfig)(resolvedDir, defaults, {
       tools: options.tools ? options.tools.split(",").map((t) => t.trim()) : void 0,
       include: options.include?.split(","),
       exclude: options.exclude?.split(",")
@@ -184,7 +185,7 @@ EXAMPLES:
     let finalOptions = { ...baseOptions };
     if (baseOptions.tools.includes("patterns")) {
       const { getSmartDefaults } = await import("@aiready/pattern-detect");
-      const patternSmartDefaults = await getSmartDefaults(directory, baseOptions);
+      const patternSmartDefaults = await getSmartDefaults(resolvedDir, baseOptions);
       finalOptions = { ...patternSmartDefaults, ...finalOptions, ...baseOptions };
     }
     console.log(import_chalk.default.cyan("\n=== AIReady Run Preview ==="));
@@ -381,17 +382,17 @@ EXAMPLES:
             console.log();
           }
         }
-        const outputFormat = options.output || finalOptions.output?.format || "console";
-        const userOutputFile = options.outputFile || finalOptions.output?.file;
-        if (outputFormat === "json") {
-          const dateStr = (/* @__PURE__ */ new Date()).toISOString().split("T")[0];
-          const defaultFilename = `aiready-scan-${dateStr}.json`;
-          const outputPath = (0, import_core.resolveOutputPath)(userOutputFile, defaultFilename, directory);
-          const outputData = { ...results, scoring: scoringResult };
-          (0, import_core.handleJSONOutput)(outputData, outputPath, `\u2705 Summary saved to ${outputPath}`);
-        }
       }
     }
+    const outputFormat = options.output || finalOptions.output?.format || "console";
+    const userOutputFile = options.outputFile || finalOptions.output?.file;
+    if (outputFormat === "json") {
+      const timestamp = getReportTimestamp();
+      const defaultFilename = `aiready-report-${timestamp}.json`;
+      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}`);
+    }
   } catch (error) {
     (0, import_core.handleCLIError)(error, "Analysis");
   }
@@ -404,6 +405,7 @@ EXAMPLES:
 `).action(async (directory, options) => {
   console.log(import_chalk.default.blue("\u{1F50D} Analyzing patterns...\n"));
   const startTime = Date.now();
+  const resolvedDir = (0, import_path2.resolve)(process.cwd(), directory || ".");
   try {
     const useSmartDefaults = !options.fullScan;
     const defaults = {
@@ -432,7 +434,7 @@ EXAMPLES:
     if (options.minSharedTokens) {
       cliOptions.minSharedTokens = parseInt(options.minSharedTokens);
     }
-    const finalOptions = await (0, import_core.loadMergedConfig)(directory, defaults, cliOptions);
+    const finalOptions = await (0, import_core.loadMergedConfig)(resolvedDir, defaults, cliOptions);
     const { analyzePatterns: analyzePatterns2, generateSummary, calculatePatternScore } = await import("@aiready/pattern-detect");
     const { results, duplicates } = await analyzePatterns2(finalOptions);
     const elapsedTime = (0, import_core.getElapsedTime)(startTime);
@@ -451,8 +453,8 @@ EXAMPLES:
       };
       const outputPath = (0, import_core.resolveOutputPath)(
         userOutputFile,
-        `pattern-report-${(/* @__PURE__ */ new Date()).toISOString().split("T")[0]}.json`,
-        directory
+        `aiready-report-${getReportTimestamp()}.json`,
+        resolvedDir
       );
       (0, import_core.handleJSONOutput)(outputData, outputPath, `\u2705 Results saved to ${outputPath}`);
     } else {
@@ -508,6 +510,7 @@ EXAMPLES:
 program.command("context").description("Analyze context window costs and dependency fragmentation").argument("[directory]", "Directory to analyze", ".").option("--max-depth <number>", "Maximum acceptable import depth", "5").option("--max-context <number>", "Maximum acceptable context budget (tokens)", "10000").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 for context (0-100)").action(async (directory, options) => {
   console.log(import_chalk.default.blue("\u{1F9E0} Analyzing context costs...\n"));
   const startTime = Date.now();
+  const resolvedDir = (0, import_path2.resolve)(process.cwd(), directory || ".");
   try {
     const defaults = {
       maxDepth: 5,
@@ -519,7 +522,7 @@ program.command("context").description("Analyze context window costs and depende
         file: void 0
       }
     };
-    let baseOptions = await (0, import_core.loadMergedConfig)(directory, defaults, {
+    let baseOptions = await (0, import_core.loadMergedConfig)(resolvedDir, defaults, {
       maxDepth: options.maxDepth ? parseInt(options.maxDepth) : void 0,
       maxContextBudget: options.maxContext ? parseInt(options.maxContext) : void 0,
       include: options.include?.split(","),
@@ -527,7 +530,7 @@ program.command("context").description("Analyze context window costs and depende
     });
     let finalOptions = { ...baseOptions };
     const { getSmartDefaults } = await import("@aiready/context-analyzer");
-    const contextSmartDefaults = await getSmartDefaults(directory, baseOptions);
+    const contextSmartDefaults = await getSmartDefaults(resolvedDir, baseOptions);
     finalOptions = { ...contextSmartDefaults, ...finalOptions };
     console.log("\u{1F4CB} Configuration:");
     console.log(`   Max depth: ${finalOptions.maxDepth}`);
@@ -554,8 +557,8 @@ program.command("context").description("Analyze context window costs and depende
       };
       const outputPath = (0, import_core.resolveOutputPath)(
         userOutputFile,
-        `context-report-${(/* @__PURE__ */ new Date()).toISOString().split("T")[0]}.json`,
-        directory
+        `aiready-report-${getReportTimestamp()}.json`,
+        resolvedDir
       );
       (0, import_core.handleJSONOutput)(outputData, outputPath, `\u2705 Results saved to ${outputPath}`);
     } else {
@@ -645,6 +648,7 @@ program.command("context").description("Analyze context window costs and depende
 program.command("consistency").description("Check naming conventions and architectural consistency").argument("[directory]", "Directory to analyze", ".").option("--naming", "Check naming conventions (default: true)").option("--no-naming", "Skip naming analysis").option("--patterns", "Check code patterns (default: true)").option("--no-patterns", "Skip pattern analysis").option("--min-severity <level>", "Minimum severity: info|minor|major|critical", "info").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, markdown", "console").option("--output-file <path>", "Output file path (for json/markdown)").option("--score", "Calculate and display AI Readiness Score for consistency (0-100)").action(async (directory, options) => {
   console.log(import_chalk.default.blue("\u{1F50D} Analyzing consistency...\n"));
   const startTime = Date.now();
+  const resolvedDir = (0, import_path2.resolve)(process.cwd(), directory || ".");
   try {
     const defaults = {
       checkNaming: true,
@@ -657,7 +661,7 @@ program.command("consistency").description("Check naming conventions and archite
         file: void 0
       }
     };
-    const finalOptions = await (0, import_core.loadMergedConfig)(directory, defaults, {
+    const finalOptions = await (0, import_core.loadMergedConfig)(resolvedDir, defaults, {
       checkNaming: options.naming !== false,
       checkPatterns: options.patterns !== false,
       minSeverity: options.minSeverity,
@@ -685,16 +689,16 @@ program.command("consistency").description("Check naming conventions and archite
       };
       const outputPath = (0, import_core.resolveOutputPath)(
         userOutputFile,
-        `consistency-report-${(/* @__PURE__ */ new Date()).toISOString().split("T")[0]}.json`,
-        directory
+        `aiready-report-${getReportTimestamp()}.json`,
+        resolvedDir
       );
       (0, import_core.handleJSONOutput)(outputData, outputPath, `\u2705 Results saved to ${outputPath}`);
     } else if (outputFormat === "markdown") {
       const markdown = generateMarkdownReport(report, elapsedTime);
       const outputPath = (0, import_core.resolveOutputPath)(
         userOutputFile,
-        `consistency-report-${(/* @__PURE__ */ new Date()).toISOString().split("T")[0]}.md`,
-        directory
+        `aiready-report-${getReportTimestamp()}.md`,
+        resolvedDir
       );
       (0, import_fs.writeFileSync)(outputPath, markdown);
       console.log(import_chalk.default.green(`\u2705 Report saved to ${outputPath}`));
@@ -976,13 +980,21 @@ function generateHTML(graph) {
   </body>
 </html>`;
 }
+function getReportTimestamp() {
+  const now = /* @__PURE__ */ new Date();
+  const pad = (n) => String(n).padStart(2, "0");
+  return `${now.getFullYear()}${pad(now.getMonth() + 1)}${pad(now.getDate())}-${pad(now.getHours())}${pad(now.getMinutes())}${pad(now.getSeconds())}`;
+}
 function findLatestScanReport(dirPath) {
   const aireadyDir = (0, import_path2.resolve)(dirPath, ".aiready");
   if (!(0, import_fs2.existsSync)(aireadyDir)) {
     return null;
   }
   const { readdirSync, statSync } = require("fs");
-  const files = readdirSync(aireadyDir).filter((f) => f.startsWith("aiready-scan-") && f.endsWith(".json"));
+  let files = readdirSync(aireadyDir).filter((f) => f.startsWith("aiready-report-") && f.endsWith(".json"));
+  if (files.length === 0) {
+    files = readdirSync(aireadyDir).filter((f) => f.startsWith("aiready-scan-") && f.endsWith(".json"));
+  }
   if (files.length === 0) {
     return null;
   }
@@ -992,15 +1004,20 @@ function findLatestScanReport(dirPath) {
 async function handleVisualize(directory, options) {
   try {
     const dirPath = (0, import_path2.resolve)(process.cwd(), directory || ".");
-    let reportPath = (0, import_path2.resolve)(dirPath, options.report || "aiready-improvement-report.json");
-    if (!(0, import_fs2.existsSync)(reportPath)) {
+    let reportPath = options.report ? (0, import_path2.resolve)(dirPath, options.report) : null;
+    if (!reportPath || !(0, import_fs2.existsSync)(reportPath)) {
       const latestScan = findLatestScanReport(dirPath);
       if (latestScan) {
-        console.log(`Using latest scan report: ${latestScan}`);
         reportPath = latestScan;
+        console.log(import_chalk.default.dim(`Found latest report: ${latestScan.split("/").pop()}`));
       } else {
-        console.error("Report not found at", reportPath);
-        console.log("Run `aiready scan --output json` to generate the report, or pass --report");
+        console.error(import_chalk.default.red("\u274C No AI readiness report found"));
+        console.log(import_chalk.default.dim(`
+Generate a report with:
+  aiready scan --output json
+
+Or specify a custom report:
+  aiready visualise --report <path-to-report.json>`));
         return;
       }
     }
@@ -1012,12 +1029,68 @@ async function handleVisualize(directory, options) {
     if (options.dev) {
       try {
         const { spawn } = await import("child_process");
-        const webDir = (0, import_path2.resolve)(dirPath, "packages/visualizer");
-        const watcher = spawn("node", ["scripts/watch-report.js", reportPath], { cwd: webDir, stdio: "inherit" });
-        const vite = spawn("pnpm", ["run", "dev:web"], { cwd: webDir, stdio: "inherit", shell: true });
+        const monorepoWebDir = (0, import_path2.resolve)(dirPath, "packages/visualizer");
+        let webDir = "";
+        let visualizerAvailable = false;
+        if ((0, import_fs2.existsSync)(monorepoWebDir)) {
+          webDir = monorepoWebDir;
+          visualizerAvailable = true;
+        } else {
+          const nodemodulesLocations = [
+            (0, import_path2.resolve)(dirPath, "node_modules", "@aiready", "visualizer"),
+            (0, import_path2.resolve)(process.cwd(), "node_modules", "@aiready", "visualizer")
+          ];
+          let currentDir = dirPath;
+          while (currentDir !== "/" && currentDir !== ".") {
+            nodemodulesLocations.push((0, import_path2.resolve)(currentDir, "node_modules", "@aiready", "visualizer"));
+            const parent = (0, import_path2.resolve)(currentDir, "..");
+            if (parent === currentDir) break;
+            currentDir = parent;
+          }
+          for (const location of nodemodulesLocations) {
+            if ((0, import_fs2.existsSync)(location) && (0, import_fs2.existsSync)((0, import_path2.resolve)(location, "package.json"))) {
+              webDir = location;
+              visualizerAvailable = true;
+              break;
+            }
+          }
+          if (!visualizerAvailable) {
+            try {
+              const vizPkgPath = require.resolve("@aiready/visualizer/package.json");
+              webDir = (0, import_path2.resolve)(vizPkgPath, "..");
+              visualizerAvailable = true;
+            } catch (e) {
+            }
+          }
+        }
+        const spawnCwd = webDir || process.cwd();
+        const nodeBinCandidate = process.execPath;
+        const nodeBin = (0, import_fs2.existsSync)(nodeBinCandidate) ? nodeBinCandidate : "node";
+        if (!visualizerAvailable) {
+          console.error(import_chalk.default.red("\u274C Cannot start dev server: @aiready/visualizer not available."));
+          console.log(import_chalk.default.dim("Install @aiready/visualizer in your project with:\n  npm install @aiready/visualizer"));
+          return;
+        }
+        const { watch } = await import("fs");
+        const copyReportToViz = () => {
+          try {
+            const destPath = (0, import_path2.resolve)(spawnCwd, "web", "report-data.json");
+            (0, import_fs2.copyFileSync)(reportPath, destPath);
+            console.log(`\u{1F4CB} Report synced to ${destPath}`);
+          } catch (e) {
+            console.error("Failed to sync report:", e);
+          }
+        };
+        copyReportToViz();
+        let watchTimeout = null;
+        const reportWatcher = watch(reportPath, () => {
+          if (watchTimeout) clearTimeout(watchTimeout);
+          watchTimeout = setTimeout(copyReportToViz, 100);
+        });
+        const vite = spawn("pnpm", ["run", "dev:web"], { cwd: spawnCwd, stdio: "inherit", shell: true });
         const onExit = () => {
           try {
-            watcher.kill();
+            reportWatcher.close();
           } catch (e) {
           }
           try {
@@ -1083,18 +1156,20 @@ async function handleVisualize(directory, options) {
     (0, import_core.handleCLIError)(err, "Visualization");
   }
 }
-program.command("visualise").description("Alias for visualize (British spelling)").argument("[directory]", "Directory to analyze", ".").option("--report <path>", "Report path (relative to directory)", "aiready-improvement-report.json").option("-o, --output <path>", "Output HTML path (relative to directory)", "packages/visualizer/visualization.html").option("--open", "Open generated HTML in default browser").option("--serve [port]", "Start a local static server to serve the visualization (optional port number)", false).option("--dev", "Start Vite dev server (live reload) for interactive development", true).addHelpText("after", `
+program.command("visualise").description("Alias for visualize (British spelling)").argument("[directory]", "Directory to analyze", ".").option("--report <path>", "Report path (auto-detects latest .aiready/aiready-report-*.json if not provided)").option("-o, --output <path>", "Output HTML path (relative to directory)", "packages/visualizer/visualization.html").option("--open", "Open generated HTML in default browser").option("--serve [port]", "Start a local static server to serve the visualization (optional port number)", false).option("--dev", "Start Vite dev server (live reload) for interactive development", true).addHelpText("after", `
 EXAMPLES:
-  $ aiready visualise . --report aiready-improvement-report.json
+  $ aiready visualise .  # Auto-detects latest report
+  $ aiready visualise . --report .aiready/aiready-report-20260217-143022.json
   $ aiready visualise . --report report.json --dev
   $ aiready visualise . --report report.json --serve 8080
 
 NOTES:
   - Same options as 'visualize'. Use --dev for live reload and --serve to host a static HTML.
 `).action(async (directory, options) => await handleVisualize(directory, options));
-program.command("visualize").description("Generate interactive visualization from an AIReady report").argument("[directory]", "Directory to analyze", ".").option("--report <path>", "Report path (relative to directory)", "aiready-improvement-report.json").option("-o, --output <path>", "Output HTML path (relative to directory)", "packages/visualizer/visualization.html").option("--open", "Open generated HTML in default browser").option("--serve [port]", "Start a local static server to serve the visualization (optional port number)", false).option("--dev", "Start Vite dev server (live reload) for interactive development", false).addHelpText("after", `
+program.command("visualize").description("Generate interactive visualization from an AIReady report").argument("[directory]", "Directory to analyze", ".").option("--report <path>", "Report path (auto-detects latest .aiready/aiready-report-*.json if not provided)").option("-o, --output <path>", "Output HTML path (relative to directory)", "packages/visualizer/visualization.html").option("--open", "Open generated HTML in default browser").option("--serve [port]", "Start a local static server to serve the visualization (optional port number)", false).option("--dev", "Start Vite dev server (live reload) for interactive development", false).addHelpText("after", `
 EXAMPLES:
-  $ aiready visualize . --report aiready-improvement-report.json
+  $ aiready visualize .  # Auto-detects latest report
+  $ aiready visualize . --report .aiready/aiready-report-20260217-143022.json
   $ aiready visualize . --report report.json -o out/visualization.html --open
   $ aiready visualize . --report report.json --serve
   $ aiready visualize . --report report.json --serve 8080

package/dist/cli.mjs

@@ -22,7 +22,7 @@ import {
   getRatingDisplay,
   parseWeightString
 } from "@aiready/core";
-import { readFileSync, existsSync } from "fs";
+import { readFileSync, existsSync, copyFileSync } from "fs";
 import { resolve as resolvePath } from "path";
 var packageJson = JSON.parse(readFileSync(join(__dirname, "../package.json"), "utf8"));
 var program = new Command();
@@ -71,6 +71,7 @@ EXAMPLES:
 `).action(async (directory, options) => {
   console.log(chalk.blue("\u{1F680} Starting AIReady unified analysis...\n"));
   const startTime = Date.now();
+  const resolvedDir = resolvePath(process.cwd(), directory || ".");
   try {
     const defaults = {
       tools: ["patterns", "context", "consistency"],
@@ -81,7 +82,7 @@ EXAMPLES:
         file: void 0
       }
     };
-    const baseOptions = await loadMergedConfig(directory, defaults, {
+    const baseOptions = await loadMergedConfig(resolvedDir, defaults, {
       tools: options.tools ? options.tools.split(",").map((t) => t.trim()) : void 0,
       include: options.include?.split(","),
       exclude: options.exclude?.split(",")
@@ -89,7 +90,7 @@ EXAMPLES:
     let finalOptions = { ...baseOptions };
     if (baseOptions.tools.includes("patterns")) {
       const { getSmartDefaults } = await import("@aiready/pattern-detect");
-      const patternSmartDefaults = await getSmartDefaults(directory, baseOptions);
+      const patternSmartDefaults = await getSmartDefaults(resolvedDir, baseOptions);
       finalOptions = { ...patternSmartDefaults, ...finalOptions, ...baseOptions };
     }
     console.log(chalk.cyan("\n=== AIReady Run Preview ==="));
@@ -286,17 +287,17 @@ EXAMPLES:
             console.log();
           }
         }
-        const outputFormat = options.output || finalOptions.output?.format || "console";
-        const userOutputFile = options.outputFile || finalOptions.output?.file;
-        if (outputFormat === "json") {
-          const dateStr = (/* @__PURE__ */ new Date()).toISOString().split("T")[0];
-          const defaultFilename = `aiready-scan-${dateStr}.json`;
-          const outputPath = resolveOutputPath(userOutputFile, defaultFilename, directory);
-          const outputData = { ...results, scoring: scoringResult };
-          handleJSONOutput(outputData, outputPath, `\u2705 Summary saved to ${outputPath}`);
-        }
       }
     }
+    const outputFormat = options.output || finalOptions.output?.format || "console";
+    const userOutputFile = options.outputFile || finalOptions.output?.file;
+    if (outputFormat === "json") {
+      const timestamp = getReportTimestamp();
+      const defaultFilename = `aiready-report-${timestamp}.json`;
+      const outputPath = resolveOutputPath(userOutputFile, defaultFilename, resolvedDir);
+      const outputData = { ...results, scoring: scoringResult };
+      handleJSONOutput(outputData, outputPath, `\u2705 Report saved to ${outputPath}`);
+    }
   } catch (error) {
     handleCLIError(error, "Analysis");
   }
@@ -309,6 +310,7 @@ EXAMPLES:
 `).action(async (directory, options) => {
   console.log(chalk.blue("\u{1F50D} Analyzing patterns...\n"));
   const startTime = Date.now();
+  const resolvedDir = resolvePath(process.cwd(), directory || ".");
   try {
     const useSmartDefaults = !options.fullScan;
     const defaults = {
@@ -337,7 +339,7 @@ EXAMPLES:
     if (options.minSharedTokens) {
       cliOptions.minSharedTokens = parseInt(options.minSharedTokens);
     }
-    const finalOptions = await loadMergedConfig(directory, defaults, cliOptions);
+    const finalOptions = await loadMergedConfig(resolvedDir, defaults, cliOptions);
     const { analyzePatterns, generateSummary, calculatePatternScore } = await import("@aiready/pattern-detect");
     const { results, duplicates } = await analyzePatterns(finalOptions);
     const elapsedTime = getElapsedTime(startTime);
@@ -356,8 +358,8 @@ EXAMPLES:
       };
       const outputPath = resolveOutputPath(
         userOutputFile,
-        `pattern-report-${(/* @__PURE__ */ new Date()).toISOString().split("T")[0]}.json`,
-        directory
+        `aiready-report-${getReportTimestamp()}.json`,
+        resolvedDir
       );
       handleJSONOutput(outputData, outputPath, `\u2705 Results saved to ${outputPath}`);
     } else {
@@ -413,6 +415,7 @@ EXAMPLES:
 program.command("context").description("Analyze context window costs and dependency fragmentation").argument("[directory]", "Directory to analyze", ".").option("--max-depth <number>", "Maximum acceptable import depth", "5").option("--max-context <number>", "Maximum acceptable context budget (tokens)", "10000").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 for context (0-100)").action(async (directory, options) => {
   console.log(chalk.blue("\u{1F9E0} Analyzing context costs...\n"));
   const startTime = Date.now();
+  const resolvedDir = resolvePath(process.cwd(), directory || ".");
   try {
     const defaults = {
       maxDepth: 5,
@@ -424,7 +427,7 @@ program.command("context").description("Analyze context window costs and depende
         file: void 0
       }
     };
-    let baseOptions = await loadMergedConfig(directory, defaults, {
+    let baseOptions = await loadMergedConfig(resolvedDir, defaults, {
       maxDepth: options.maxDepth ? parseInt(options.maxDepth) : void 0,
       maxContextBudget: options.maxContext ? parseInt(options.maxContext) : void 0,
       include: options.include?.split(","),
@@ -432,7 +435,7 @@ program.command("context").description("Analyze context window costs and depende
     });
     let finalOptions = { ...baseOptions };
     const { getSmartDefaults } = await import("@aiready/context-analyzer");
-    const contextSmartDefaults = await getSmartDefaults(directory, baseOptions);
+    const contextSmartDefaults = await getSmartDefaults(resolvedDir, baseOptions);
     finalOptions = { ...contextSmartDefaults, ...finalOptions };
     console.log("\u{1F4CB} Configuration:");
     console.log(`   Max depth: ${finalOptions.maxDepth}`);
@@ -459,8 +462,8 @@ program.command("context").description("Analyze context window costs and depende
       };
       const outputPath = resolveOutputPath(
         userOutputFile,
-        `context-report-${(/* @__PURE__ */ new Date()).toISOString().split("T")[0]}.json`,
-        directory
+        `aiready-report-${getReportTimestamp()}.json`,
+        resolvedDir
       );
       handleJSONOutput(outputData, outputPath, `\u2705 Results saved to ${outputPath}`);
     } else {
@@ -550,6 +553,7 @@ program.command("context").description("Analyze context window costs and depende
 program.command("consistency").description("Check naming conventions and architectural consistency").argument("[directory]", "Directory to analyze", ".").option("--naming", "Check naming conventions (default: true)").option("--no-naming", "Skip naming analysis").option("--patterns", "Check code patterns (default: true)").option("--no-patterns", "Skip pattern analysis").option("--min-severity <level>", "Minimum severity: info|minor|major|critical", "info").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, markdown", "console").option("--output-file <path>", "Output file path (for json/markdown)").option("--score", "Calculate and display AI Readiness Score for consistency (0-100)").action(async (directory, options) => {
   console.log(chalk.blue("\u{1F50D} Analyzing consistency...\n"));
   const startTime = Date.now();
+  const resolvedDir = resolvePath(process.cwd(), directory || ".");
   try {
     const defaults = {
       checkNaming: true,
@@ -562,7 +566,7 @@ program.command("consistency").description("Check naming conventions and archite
         file: void 0
       }
     };
-    const finalOptions = await loadMergedConfig(directory, defaults, {
+    const finalOptions = await loadMergedConfig(resolvedDir, defaults, {
       checkNaming: options.naming !== false,
       checkPatterns: options.patterns !== false,
       minSeverity: options.minSeverity,
@@ -590,16 +594,16 @@ program.command("consistency").description("Check naming conventions and archite
       };
       const outputPath = resolveOutputPath(
         userOutputFile,
-        `consistency-report-${(/* @__PURE__ */ new Date()).toISOString().split("T")[0]}.json`,
-        directory
+        `aiready-report-${getReportTimestamp()}.json`,
+        resolvedDir
       );
       handleJSONOutput(outputData, outputPath, `\u2705 Results saved to ${outputPath}`);
     } else if (outputFormat === "markdown") {
       const markdown = generateMarkdownReport(report, elapsedTime);
       const outputPath = resolveOutputPath(
         userOutputFile,
-        `consistency-report-${(/* @__PURE__ */ new Date()).toISOString().split("T")[0]}.md`,
-        directory
+        `aiready-report-${getReportTimestamp()}.md`,
+        resolvedDir
       );
       writeFileSync(outputPath, markdown);
       console.log(chalk.green(`\u2705 Report saved to ${outputPath}`));
@@ -881,13 +885,21 @@ function generateHTML(graph) {
   </body>
 </html>`;
 }
+function getReportTimestamp() {
+  const now = /* @__PURE__ */ new Date();
+  const pad = (n) => String(n).padStart(2, "0");
+  return `${now.getFullYear()}${pad(now.getMonth() + 1)}${pad(now.getDate())}-${pad(now.getHours())}${pad(now.getMinutes())}${pad(now.getSeconds())}`;
+}
 function findLatestScanReport(dirPath) {
   const aireadyDir = resolvePath(dirPath, ".aiready");
   if (!existsSync(aireadyDir)) {
     return null;
   }
   const { readdirSync, statSync } = __require("fs");
-  const files = readdirSync(aireadyDir).filter((f) => f.startsWith("aiready-scan-") && f.endsWith(".json"));
+  let files = readdirSync(aireadyDir).filter((f) => f.startsWith("aiready-report-") && f.endsWith(".json"));
+  if (files.length === 0) {
+    files = readdirSync(aireadyDir).filter((f) => f.startsWith("aiready-scan-") && f.endsWith(".json"));
+  }
   if (files.length === 0) {
     return null;
   }
@@ -897,15 +909,20 @@ function findLatestScanReport(dirPath) {
 async function handleVisualize(directory, options) {
   try {
     const dirPath = resolvePath(process.cwd(), directory || ".");
-    let reportPath = resolvePath(dirPath, options.report || "aiready-improvement-report.json");
-    if (!existsSync(reportPath)) {
+    let reportPath = options.report ? resolvePath(dirPath, options.report) : null;
+    if (!reportPath || !existsSync(reportPath)) {
       const latestScan = findLatestScanReport(dirPath);
       if (latestScan) {
-        console.log(`Using latest scan report: ${latestScan}`);
         reportPath = latestScan;
+        console.log(chalk.dim(`Found latest report: ${latestScan.split("/").pop()}`));
       } else {
-        console.error("Report not found at", reportPath);
-        console.log("Run `aiready scan --output json` to generate the report, or pass --report");
+        console.error(chalk.red("\u274C No AI readiness report found"));
+        console.log(chalk.dim(`
+Generate a report with:
+  aiready scan --output json
+
+Or specify a custom report:
+  aiready visualise --report <path-to-report.json>`));
         return;
       }
     }
@@ -917,12 +934,68 @@ async function handleVisualize(directory, options) {
     if (options.dev) {
       try {
         const { spawn } = await import("child_process");
-        const webDir = resolvePath(dirPath, "packages/visualizer");
-        const watcher = spawn("node", ["scripts/watch-report.js", reportPath], { cwd: webDir, stdio: "inherit" });
-        const vite = spawn("pnpm", ["run", "dev:web"], { cwd: webDir, stdio: "inherit", shell: true });
+        const monorepoWebDir = resolvePath(dirPath, "packages/visualizer");
+        let webDir = "";
+        let visualizerAvailable = false;
+        if (existsSync(monorepoWebDir)) {
+          webDir = monorepoWebDir;
+          visualizerAvailable = true;
+        } else {
+          const nodemodulesLocations = [
+            resolvePath(dirPath, "node_modules", "@aiready", "visualizer"),
+            resolvePath(process.cwd(), "node_modules", "@aiready", "visualizer")
+          ];
+          let currentDir = dirPath;
+          while (currentDir !== "/" && currentDir !== ".") {
+            nodemodulesLocations.push(resolvePath(currentDir, "node_modules", "@aiready", "visualizer"));
+            const parent = resolvePath(currentDir, "..");
+            if (parent === currentDir) break;
+            currentDir = parent;
+          }
+          for (const location of nodemodulesLocations) {
+            if (existsSync(location) && existsSync(resolvePath(location, "package.json"))) {
+              webDir = location;
+              visualizerAvailable = true;
+              break;
+            }
+          }
+          if (!visualizerAvailable) {
+            try {
+              const vizPkgPath = __require.resolve("@aiready/visualizer/package.json");
+              webDir = resolvePath(vizPkgPath, "..");
+              visualizerAvailable = true;
+            } catch (e) {
+            }
+          }
+        }
+        const spawnCwd = webDir || process.cwd();
+        const nodeBinCandidate = process.execPath;
+        const nodeBin = existsSync(nodeBinCandidate) ? nodeBinCandidate : "node";
+        if (!visualizerAvailable) {
+          console.error(chalk.red("\u274C Cannot start dev server: @aiready/visualizer not available."));
+          console.log(chalk.dim("Install @aiready/visualizer in your project with:\n  npm install @aiready/visualizer"));
+          return;
+        }
+        const { watch } = await import("fs");
+        const copyReportToViz = () => {
+          try {
+            const destPath = resolvePath(spawnCwd, "web", "report-data.json");
+            copyFileSync(reportPath, destPath);
+            console.log(`\u{1F4CB} Report synced to ${destPath}`);
+          } catch (e) {
+            console.error("Failed to sync report:", e);
+          }
+        };
+        copyReportToViz();
+        let watchTimeout = null;
+        const reportWatcher = watch(reportPath, () => {
+          if (watchTimeout) clearTimeout(watchTimeout);
+          watchTimeout = setTimeout(copyReportToViz, 100);
+        });
+        const vite = spawn("pnpm", ["run", "dev:web"], { cwd: spawnCwd, stdio: "inherit", shell: true });
         const onExit = () => {
           try {
-            watcher.kill();
+            reportWatcher.close();
           } catch (e) {
           }
           try {
@@ -988,18 +1061,20 @@ async function handleVisualize(directory, options) {
     handleCLIError(err, "Visualization");
   }
 }
-program.command("visualise").description("Alias for visualize (British spelling)").argument("[directory]", "Directory to analyze", ".").option("--report <path>", "Report path (relative to directory)", "aiready-improvement-report.json").option("-o, --output <path>", "Output HTML path (relative to directory)", "packages/visualizer/visualization.html").option("--open", "Open generated HTML in default browser").option("--serve [port]", "Start a local static server to serve the visualization (optional port number)", false).option("--dev", "Start Vite dev server (live reload) for interactive development", true).addHelpText("after", `
+program.command("visualise").description("Alias for visualize (British spelling)").argument("[directory]", "Directory to analyze", ".").option("--report <path>", "Report path (auto-detects latest .aiready/aiready-report-*.json if not provided)").option("-o, --output <path>", "Output HTML path (relative to directory)", "packages/visualizer/visualization.html").option("--open", "Open generated HTML in default browser").option("--serve [port]", "Start a local static server to serve the visualization (optional port number)", false).option("--dev", "Start Vite dev server (live reload) for interactive development", true).addHelpText("after", `
 EXAMPLES:
-  $ aiready visualise . --report aiready-improvement-report.json
+  $ aiready visualise .  # Auto-detects latest report
+  $ aiready visualise . --report .aiready/aiready-report-20260217-143022.json
   $ aiready visualise . --report report.json --dev
   $ aiready visualise . --report report.json --serve 8080
 
 NOTES:
   - Same options as 'visualize'. Use --dev for live reload and --serve to host a static HTML.
 `).action(async (directory, options) => await handleVisualize(directory, options));
-program.command("visualize").description("Generate interactive visualization from an AIReady report").argument("[directory]", "Directory to analyze", ".").option("--report <path>", "Report path (relative to directory)", "aiready-improvement-report.json").option("-o, --output <path>", "Output HTML path (relative to directory)", "packages/visualizer/visualization.html").option("--open", "Open generated HTML in default browser").option("--serve [port]", "Start a local static server to serve the visualization (optional port number)", false).option("--dev", "Start Vite dev server (live reload) for interactive development", false).addHelpText("after", `
+program.command("visualize").description("Generate interactive visualization from an AIReady report").argument("[directory]", "Directory to analyze", ".").option("--report <path>", "Report path (auto-detects latest .aiready/aiready-report-*.json if not provided)").option("-o, --output <path>", "Output HTML path (relative to directory)", "packages/visualizer/visualization.html").option("--open", "Open generated HTML in default browser").option("--serve [port]", "Start a local static server to serve the visualization (optional port number)", false).option("--dev", "Start Vite dev server (live reload) for interactive development", false).addHelpText("after", `
 EXAMPLES:
-  $ aiready visualize . --report aiready-improvement-report.json
+  $ aiready visualize .  # Auto-detects latest report
+  $ aiready visualize . --report .aiready/aiready-report-20260217-143022.json
   $ aiready visualize . --report report.json -o out/visualization.html --open
   $ aiready visualize . --report report.json --serve
   $ aiready visualize . --report report.json --serve 8080

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aiready/cli",
-  "version": "0.9.15",
+  "version": "0.9.17",
   "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.13",
-    "@aiready/core": "0.9.14",
-    "@aiready/consistency": "0.8.14",
-    "@aiready/pattern-detect": "0.11.14",
-    "@aiready/context-analyzer": "0.9.14"
+    "@aiready/visualizer": "0.1.18",
+    "@aiready/core": "0.9.16",
+    "@aiready/consistency": "0.8.16",
+    "@aiready/context-analyzer": "0.9.16",
+    "@aiready/pattern-detect": "0.11.16"
   },
   "devDependencies": {
     "tsup": "^8.3.5",

package/src/cli.ts

@@ -20,7 +20,7 @@ import {
   type AIReadyConfig,
   type ToolScoringOutput,
 } from '@aiready/core';
-import { readFileSync, existsSync } from 'fs';
+import { readFileSync, existsSync, copyFileSync } from 'fs';
 import { resolve as resolvePath } from 'path';
 import { GraphBuilder } from '@aiready/visualizer/graph';
 import type { GraphData } from '@aiready/visualizer';
@@ -93,6 +93,8 @@ EXAMPLES:
     console.log(chalk.blue('🚀 Starting AIReady unified analysis...\n'));
 
     const startTime = Date.now();
+    // Resolve directory to absolute path to ensure .aiready/ is created in the right location
+    const resolvedDir = resolvePath(process.cwd(), directory || '.');
 
     try {
       // Define defaults
@@ -107,7 +109,7 @@ EXAMPLES:
       };
 
       // Load and merge config with CLI options
-      const baseOptions = await loadMergedConfig(directory, defaults, {
+      const baseOptions = await loadMergedConfig(resolvedDir, defaults, {
         tools: options.tools ? options.tools.split(',').map((t: string) => t.trim()) as ('patterns' | 'context' | 'consistency')[] : undefined,
         include: options.include?.split(','),
         exclude: options.exclude?.split(','),
@@ -118,7 +120,7 @@ EXAMPLES:
       let finalOptions = { ...baseOptions };
       if (baseOptions.tools.includes('patterns')) {
         const { getSmartDefaults } = await import('@aiready/pattern-detect');
-        const patternSmartDefaults = await getSmartDefaults(directory, baseOptions);
+        const patternSmartDefaults = await getSmartDefaults(resolvedDir, baseOptions);
         // Merge deeply to preserve nested config
         finalOptions = { ...patternSmartDefaults, ...finalOptions, ...baseOptions };
       }
@@ -367,19 +369,19 @@ EXAMPLES:
               console.log();
             }
           }
-
-          // Persist JSON summary by default when output is json or when config directory present
-          const outputFormat = options.output || finalOptions.output?.format || 'console';
-          const userOutputFile = options.outputFile || finalOptions.output?.file;
-          if (outputFormat === 'json') {
-            const dateStr = new Date().toISOString().split('T')[0];
-            const defaultFilename = `aiready-scan-${dateStr}.json`;
-            const outputPath = resolveOutputPath(userOutputFile, defaultFilename, directory);
-            const outputData = { ...results, scoring: scoringResult };
-            handleJSONOutput(outputData, outputPath, `✅ Summary saved to ${outputPath}`);
-          }
         }
       }
+
+      // Persist JSON summary when output format is json
+      const outputFormat = options.output || finalOptions.output?.format || 'console';
+      const userOutputFile = options.outputFile || finalOptions.output?.file;
+      if (outputFormat === 'json') {
+        const timestamp = getReportTimestamp();
+        const defaultFilename = `aiready-report-${timestamp}.json`;
+        const outputPath = resolveOutputPath(userOutputFile, defaultFilename, resolvedDir);
+        const outputData = { ...results, scoring: scoringResult };
+        handleJSONOutput(outputData, outputPath, `✅ Report saved to ${outputPath}`);
+      }
     } catch (error) {
       handleCLIError(error, 'Analysis');
     }
@@ -410,6 +412,7 @@ EXAMPLES:
     console.log(chalk.blue('🔍 Analyzing patterns...\n'));
 
     const startTime = Date.now();
+    const resolvedDir = resolvePath(process.cwd(), directory || '.');
 
     try {
       // Determine if smart defaults should be used
@@ -449,7 +452,7 @@ EXAMPLES:
         cliOptions.minSharedTokens = parseInt(options.minSharedTokens);
       }
 
-      const finalOptions = await loadMergedConfig(directory, defaults, cliOptions);
+      const finalOptions = await loadMergedConfig(resolvedDir, defaults, cliOptions);
 
       const { analyzePatterns, generateSummary, calculatePatternScore } = await import('@aiready/pattern-detect');
 
@@ -476,8 +479,8 @@ EXAMPLES:
 
         const outputPath = resolveOutputPath(
           userOutputFile,
-          `pattern-report-${new Date().toISOString().split('T')[0]}.json`,
-          directory
+          `aiready-report-${getReportTimestamp()}.json`,
+          resolvedDir
         );
         
         handleJSONOutput(outputData, outputPath, `✅ Results saved to ${outputPath}`);
@@ -563,6 +566,7 @@ program
     console.log(chalk.blue('🧠 Analyzing context costs...\n'));
 
     const startTime = Date.now();
+    const resolvedDir = resolvePath(process.cwd(), directory || '.');
 
     try {
       // Define defaults
@@ -578,7 +582,7 @@ program
       };
 
       // Load and merge config with CLI options
-      let baseOptions = await loadMergedConfig(directory, defaults, {
+      let baseOptions = await loadMergedConfig(resolvedDir, defaults, {
         maxDepth: options.maxDepth ? parseInt(options.maxDepth) : undefined,
         maxContextBudget: options.maxContext ? parseInt(options.maxContext) : undefined,
         include: options.include?.split(','),
@@ -588,7 +592,7 @@ program
       // Apply smart defaults for context analysis (always for individual context command)
       let finalOptions: any = { ...baseOptions };
       const { getSmartDefaults } = await import('@aiready/context-analyzer');
-      const contextSmartDefaults = await getSmartDefaults(directory, baseOptions);
+      const contextSmartDefaults = await getSmartDefaults(resolvedDir, baseOptions);
       finalOptions = { ...contextSmartDefaults, ...finalOptions };
       
       // Display configuration
@@ -625,8 +629,8 @@ program
 
         const outputPath = resolveOutputPath(
           userOutputFile,
-          `context-report-${new Date().toISOString().split('T')[0]}.json`,
-          directory
+          `aiready-report-${getReportTimestamp()}.json`,
+          resolvedDir
         );
         
         handleJSONOutput(outputData, outputPath, `✅ Results saved to ${outputPath}`);
@@ -742,6 +746,7 @@ program
       console.log(chalk.blue('🔍 Analyzing consistency...\n'));
 
       const startTime = Date.now();
+      const resolvedDir = resolvePath(process.cwd(), directory || '.');
 
       try {
         // Define defaults
@@ -758,7 +763,7 @@ program
         };
 
         // Load and merge config with CLI options
-        const finalOptions = await loadMergedConfig(directory, defaults, {
+        const finalOptions = await loadMergedConfig(resolvedDir, defaults, {
           checkNaming: options.naming !== false,
           checkPatterns: options.patterns !== false,
           minSeverity: options.minSeverity,
@@ -794,8 +799,8 @@ program
 
           const outputPath = resolveOutputPath(
             userOutputFile,
-            `consistency-report-${new Date().toISOString().split('T')[0]}.json`,
-            directory
+            `aiready-report-${getReportTimestamp()}.json`,
+            resolvedDir
           );
           
           handleJSONOutput(outputData, outputPath, `✅ Results saved to ${outputPath}`);
@@ -804,8 +809,8 @@ program
           const markdown = generateMarkdownReport(report, elapsedTime);
           const outputPath = resolveOutputPath(
             userOutputFile,
-            `consistency-report-${new Date().toISOString().split('T')[0]}.md`,
-            directory
+            `aiready-report-${getReportTimestamp()}.md`,
+            resolvedDir
           );
           writeFileSync(outputPath, markdown);
           console.log(chalk.green(`✅ Report saved to ${outputPath}`));
@@ -1088,7 +1093,18 @@ program
   }
 
   /**
-   * Find the latest aiready scan report in the .aiready directory
+   * Generate timestamp for report filenames (YYYYMMDD-HHMMSS)
+   * Provides better granularity than date-only filenames
+   */
+  function getReportTimestamp(): string {
+    const now = new Date();
+    const pad = (n: number) => String(n).padStart(2, '0');
+    return `${now.getFullYear()}${pad(now.getMonth() + 1)}${pad(now.getDate())}-${pad(now.getHours())}${pad(now.getMinutes())}${pad(now.getSeconds())}`;
+  }
+
+  /**
+   * Find the latest aiready report in the .aiready directory
+   * Searches for both new format (aiready-report-*) and legacy format (aiready-scan-*)
    */
   function findLatestScanReport(dirPath: string): string | null {
     const aireadyDir = resolvePath(dirPath, '.aiready');
@@ -1097,7 +1113,11 @@ program
     }
     
     const { readdirSync, statSync } = require('fs');
-    const files = readdirSync(aireadyDir).filter(f => f.startsWith('aiready-scan-') && f.endsWith('.json'));
+    // Search for new format first, then legacy format
+    let files = readdirSync(aireadyDir).filter(f => f.startsWith('aiready-report-') && f.endsWith('.json'));
+    if (files.length === 0) {
+      files = readdirSync(aireadyDir).filter(f => f.startsWith('aiready-scan-') && f.endsWith('.json'));
+    }
     
     if (files.length === 0) {
       return null;
@@ -1114,17 +1134,17 @@ program
   async function handleVisualize(directory: string | undefined, options: any) {
     try {
       const dirPath = resolvePath(process.cwd(), directory || '.');
-      let reportPath = resolvePath(dirPath, options.report || 'aiready-improvement-report.json');
+      let reportPath = options.report ? resolvePath(dirPath, options.report) : null;
       
-      // If report not found, try to find latest scan report
-      if (!existsSync(reportPath)) {
+      // If report not provided or not found, try to find latest scan report
+      if (!reportPath || !existsSync(reportPath)) {
         const latestScan = findLatestScanReport(dirPath);
         if (latestScan) {
-          console.log(`Using latest scan report: ${latestScan}`);
           reportPath = latestScan;
+          console.log(chalk.dim(`Found latest report: ${latestScan.split('/').pop()}`));
         } else {
-          console.error('Report not found at', reportPath);
-          console.log('Run `aiready scan --output json` to generate the report, or pass --report');
+          console.error(chalk.red('❌ No AI readiness report found'));
+          console.log(chalk.dim(`\nGenerate a report with:\n  aiready scan --output json\n\nOr specify a custom report:\n  aiready visualise --report <path-to-report.json>`));
           return;
         }
       }
@@ -1139,12 +1159,84 @@ program
       if (options.dev) {
         try {
           const { spawn } = await import("child_process");
-          const webDir = resolvePath(dirPath, 'packages/visualizer');
-          const watcher = spawn("node", ["scripts/watch-report.js", reportPath], { cwd: webDir, stdio: "inherit" });
-          const vite = spawn("pnpm", ["run", "dev:web"], { cwd: webDir, stdio: "inherit", shell: true });
+          const monorepoWebDir = resolvePath(dirPath, 'packages/visualizer');
+          let webDir = '';
+          let visualizerAvailable = false;
+          if (existsSync(monorepoWebDir)) {
+            webDir = monorepoWebDir;
+            visualizerAvailable = true;
+          } else {
+            // Try to resolve installed @aiready/visualizer package from node_modules
+            // Check multiple locations to support pnpm, npm, yarn, etc.
+            const nodemodulesLocations: string[] = [
+              resolvePath(dirPath, 'node_modules', '@aiready', 'visualizer'),
+              resolvePath(process.cwd(), 'node_modules', '@aiready', 'visualizer'),
+            ];
+            
+            // Walk up directory tree to find node_modules in parent directories
+            let currentDir = dirPath;
+            while (currentDir !== '/' && currentDir !== '.') {
+              nodemodulesLocations.push(resolvePath(currentDir, 'node_modules', '@aiready', 'visualizer'));
+              const parent = resolvePath(currentDir, '..');
+              if (parent === currentDir) break; // Reached filesystem root
+              currentDir = parent;
+            }
+            
+            for (const location of nodemodulesLocations) {
+              if (existsSync(location) && existsSync(resolvePath(location, 'package.json'))) {
+                webDir = location;
+                visualizerAvailable = true;
+                break;
+              }
+            }
+            
+            // Fallback: try require.resolve
+            if (!visualizerAvailable) {
+              try {
+                const vizPkgPath = require.resolve('@aiready/visualizer/package.json');
+                webDir = resolvePath(vizPkgPath, '..');
+                visualizerAvailable = true;
+              } catch (e) {
+                // Visualizer not found
+              }
+            }
+          }
+          const spawnCwd = webDir || process.cwd();
+          const nodeBinCandidate = process.execPath;
+          const nodeBin = existsSync(nodeBinCandidate) ? nodeBinCandidate : 'node';
+          if (!visualizerAvailable) {
+            console.error(chalk.red('❌ Cannot start dev server: @aiready/visualizer not available.'));
+            console.log(chalk.dim('Install @aiready/visualizer in your project with:\n  npm install @aiready/visualizer'));
+            return;
+          }
+
+          // Inline report watcher: copy report to web/report-data.json and watch for changes
+          const { watch } = await import('fs');
+          const copyReportToViz = () => {
+            try {
+              const destPath = resolvePath(spawnCwd, 'web', 'report-data.json');
+              copyFileSync(reportPath, destPath);
+              console.log(`📋 Report synced to ${destPath}`);
+            } catch (e) {
+              console.error('Failed to sync report:', e);
+            }
+          };
+          
+          // Initial copy
+          copyReportToViz();
+          
+          // Watch source report for changes
+          let watchTimeout: NodeJS.Timeout | null = null;
+          const reportWatcher = watch(reportPath, () => {
+            // Debounce to avoid multiple copies during file write
+            if (watchTimeout) clearTimeout(watchTimeout);
+            watchTimeout = setTimeout(copyReportToViz, 100);
+          });
+
+          const vite = spawn("pnpm", ["run", "dev:web"], { cwd: spawnCwd, stdio: "inherit", shell: true });
           const onExit = () => {
             try {
-              watcher.kill();
+              reportWatcher.close();
             } catch (e) {}
             try {
               vite.kill();
@@ -1222,14 +1314,15 @@ program
   .command('visualise')
   .description('Alias for visualize (British spelling)')
   .argument('[directory]', 'Directory to analyze', '.')
-  .option('--report <path>', 'Report path (relative to directory)', 'aiready-improvement-report.json')
+  .option('--report <path>', 'Report path (auto-detects latest .aiready/aiready-report-*.json if not provided)')
   .option('-o, --output <path>', 'Output HTML path (relative to directory)', 'packages/visualizer/visualization.html')
   .option('--open', 'Open generated HTML in default browser')
   .option('--serve [port]', 'Start a local static server to serve the visualization (optional port number)', false)
   .option('--dev', 'Start Vite dev server (live reload) for interactive development', true)
   .addHelpText('after', `
 EXAMPLES:
-  $ aiready visualise . --report aiready-improvement-report.json
+  $ aiready visualise .  # Auto-detects latest report
+  $ aiready visualise . --report .aiready/aiready-report-20260217-143022.json
   $ aiready visualise . --report report.json --dev
   $ aiready visualise . --report report.json --serve 8080
 
@@ -1242,14 +1335,15 @@ program
   .command('visualize')
   .description('Generate interactive visualization from an AIReady report')
   .argument('[directory]', 'Directory to analyze', '.')
-  .option('--report <path>', 'Report path (relative to directory)', 'aiready-improvement-report.json')
+  .option('--report <path>', 'Report path (auto-detects latest .aiready/aiready-report-*.json if not provided)')
   .option('-o, --output <path>', 'Output HTML path (relative to directory)', 'packages/visualizer/visualization.html')
   .option('--open', 'Open generated HTML in default browser')
   .option('--serve [port]', 'Start a local static server to serve the visualization (optional port number)', false)
   .option('--dev', 'Start Vite dev server (live reload) for interactive development', false)
   .addHelpText('after', `
 EXAMPLES:
-  $ aiready visualize . --report aiready-improvement-report.json
+  $ aiready visualize .  # Auto-detects latest report
+  $ aiready visualize . --report .aiready/aiready-report-20260217-143022.json
   $ aiready visualize . --report report.json -o out/visualization.html --open
   $ aiready visualize . --report report.json --serve
   $ aiready visualize . --report report.json --serve 8080