@aiready/cli 0.4.1 → 0.4.2

package/.turbo/turbo-build.log

@@ -1,6 +1,6 @@
 
 
-> @aiready/cli@0.4.1 build /Users/pengcao/projects/aiready/packages/cli
+> @aiready/cli@0.4.2 build /Users/pengcao/projects/aiready/packages/cli
 > tsup src/index.ts src/cli.ts --format cjs,esm --dts
 
 CLI Building entry: src/cli.ts, src/index.ts
@@ -9,15 +9,15 @@
 CLI Target: es2020
 CJS Build start
 ESM Build start
-CJS dist/cli.js   15.94 KB
 CJS dist/index.js 3.15 KB
-CJS ⚡️ Build success in 48ms
-ESM dist/chunk-VOB7SA3E.mjs 2.02 KB
+CJS dist/cli.js   16.87 KB
+CJS ⚡️ Build success in 66ms
 ESM dist/index.mjs          138.00 B
-ESM dist/cli.mjs            12.36 KB
-ESM ⚡️ Build success in 49ms
+ESM dist/chunk-VOB7SA3E.mjs 2.02 KB
+ESM dist/cli.mjs            13.23 KB
+ESM ⚡️ Build success in 66ms
 DTS Build start
-DTS ⚡️ Build success in 554ms
+DTS ⚡️ Build success in 489ms
 DTS dist/cli.d.ts    20.00 B
 DTS dist/index.d.ts  991.00 B
 DTS dist/cli.d.mts   20.00 B

package/README.md

@@ -36,7 +36,7 @@ Options:
 - `--include <patterns>`: File patterns to include (comma-separated)
 - `--exclude <patterns>`: File patterns to exclude (comma-separated)
 - `-o, --output <format>`: Output format: console, json (default: console)
-- `--output-file <path>`: Output file path (for json)
+- `--output-file <path>`: Output file path (defaults to `.aiready/pattern-report-YYYY-MM-DD.json`)
 
 #### Context Analysis
 
@@ -50,7 +50,7 @@ Options:
 - `--include <patterns>`: File patterns to include (comma-separated)
 - `--exclude <patterns>`: File patterns to exclude (comma-separated)
 - `-o, --output <format>`: Output format: console, json (default: console)
-- `--output-file <path>`: Output file path (for json)
+- `--output-file <path>`: Output file path (defaults to `.aiready/context-report-YYYY-MM-DD.json`)
 
 ### Unified Scan Options
 
@@ -63,7 +63,9 @@ Options:
 - `--include <patterns>`: File patterns to include (comma-separated)
 - `--exclude <patterns>`: File patterns to exclude (comma-separated)
 - `-o, --output <format>`: Output format: console, json (default: console)
-- `--output-file <path>`: Output file path (for json)
+- `--output-file <path>`: Output file path (defaults to `.aiready/aiready-scan-YYYY-MM-DD.json`)
+
+> **📁 Output Files:** By default, all output files are saved to the `.aiready/` directory in your project root with timestamped filenames. You can override this with `--output-file`.
 
 ## Examples
 
@@ -89,8 +91,11 @@ aiready scan ./src --include "**/*.ts,**/*.js"
 # Exclude test files
 aiready scan . --exclude "**/*.test.*,**/*.spec.*"
 
-# Save results to JSON file
-aiready scan . --output json --output-file results.json
+# Save results to JSON file (.aiready/ directory by default)
+aiready scan . --output json
+
+# Save to custom location
+aiready scan . --output json --output-file custom-results.json
 
 # Run only pattern analysis with custom similarity threshold
 aiready patterns . --similarity 0.6 --min-lines 10

package/dist/cli.js

@@ -129,7 +129,7 @@ program.command("scan").description("Run unified analysis on a codebase").argume
     const results = await analyzeUnified(finalOptions);
     const elapsedTime = (0, import_core.getElapsedTime)(startTime);
     const outputFormat = options.output || finalOptions.output?.format || "console";
-    const outputFile = options.outputFile || finalOptions.output?.file;
+    const userOutputFile = options.outputFile || finalOptions.output?.file;
     if (outputFormat === "json") {
       const outputData = {
         ...results,
@@ -138,7 +138,12 @@ program.command("scan").description("Run unified analysis on a codebase").argume
           executionTime: parseFloat(elapsedTime)
         }
       };
-      (0, import_core.handleJSONOutput)(outputData, outputFile, `\u2705 Results saved to ${outputFile}`);
+      const outputPath = (0, import_core.resolveOutputPath)(
+        userOutputFile,
+        `aiready-scan-${(/* @__PURE__ */ new Date()).toISOString().split("T")[0]}.json`,
+        directory
+      );
+      (0, import_core.handleJSONOutput)(outputData, outputPath, `\u2705 Results saved to ${outputPath}`);
     } else {
       console.log(generateUnifiedSummary(results));
     }
@@ -183,13 +188,18 @@ program.command("patterns").description("Run pattern detection analysis").argume
     const elapsedTime = (0, import_core.getElapsedTime)(startTime);
     const summary = generateSummary(results);
     const outputFormat = options.output || finalOptions.output?.format || "console";
-    const outputFile = options.outputFile || finalOptions.output?.file;
+    const userOutputFile = options.outputFile || finalOptions.output?.file;
     if (outputFormat === "json") {
       const outputData = {
         results,
         summary: { ...summary, executionTime: parseFloat(elapsedTime) }
       };
-      (0, import_core.handleJSONOutput)(outputData, outputFile, `\u2705 Results saved to ${outputFile}`);
+      const outputPath = (0, import_core.resolveOutputPath)(
+        userOutputFile,
+        `pattern-report-${(/* @__PURE__ */ new Date()).toISOString().split("T")[0]}.json`,
+        directory
+      );
+      (0, import_core.handleJSONOutput)(outputData, outputPath, `\u2705 Results saved to ${outputPath}`);
     } else {
       console.log(`Pattern Analysis Complete (${elapsedTime}s)`);
       console.log(`Found ${summary.totalPatterns} duplicate patterns`);
@@ -235,13 +245,18 @@ program.command("context").description("Run context window cost analysis").argum
     const elapsedTime = (0, import_core.getElapsedTime)(startTime);
     const summary = generateSummary(results);
     const outputFormat = options.output || finalOptions.output?.format || "console";
-    const outputFile = options.outputFile || finalOptions.output?.file;
+    const userOutputFile = options.outputFile || finalOptions.output?.file;
     if (outputFormat === "json") {
       const outputData = {
         results,
         summary: { ...summary, executionTime: parseFloat(elapsedTime) }
       };
-      (0, import_core.handleJSONOutput)(outputData, outputFile, `\u2705 Results saved to ${outputFile}`);
+      const outputPath = (0, import_core.resolveOutputPath)(
+        userOutputFile,
+        `context-report-${(/* @__PURE__ */ new Date()).toISOString().split("T")[0]}.json`,
+        directory
+      );
+      (0, import_core.handleJSONOutput)(outputData, outputPath, `\u2705 Results saved to ${outputPath}`);
     } else {
       console.log(`Context Analysis Complete (${elapsedTime}s)`);
       console.log(`Files analyzed: ${summary.totalFiles}`);
@@ -279,7 +294,7 @@ program.command("consistency").description("Check naming, patterns, and architec
     const report = await analyzeConsistency2(finalOptions);
     const elapsedTime = (0, import_core.getElapsedTime)(startTime);
     const outputFormat = options.output || finalOptions.output?.format || "console";
-    const outputFile = options.outputFile || finalOptions.output?.file;
+    const userOutputFile = options.outputFile || finalOptions.output?.file;
     if (outputFormat === "json") {
       const outputData = {
         ...report,
@@ -288,15 +303,21 @@ program.command("consistency").description("Check naming, patterns, and architec
           executionTime: parseFloat(elapsedTime)
         }
       };
-      (0, import_core.handleJSONOutput)(outputData, outputFile, `\u2705 Results saved to ${outputFile}`);
+      const outputPath = (0, import_core.resolveOutputPath)(
+        userOutputFile,
+        `consistency-report-${(/* @__PURE__ */ new Date()).toISOString().split("T")[0]}.json`,
+        directory
+      );
+      (0, import_core.handleJSONOutput)(outputData, outputPath, `\u2705 Results saved to ${outputPath}`);
     } else if (outputFormat === "markdown") {
       const markdown = generateMarkdownReport(report, elapsedTime);
-      if (outputFile) {
-        (0, import_fs.writeFileSync)(outputFile, markdown);
-        console.log(import_chalk.default.green(`\u2705 Report saved to ${outputFile}`));
-      } else {
-        console.log(markdown);
-      }
+      const outputPath = (0, import_core.resolveOutputPath)(
+        userOutputFile,
+        `consistency-report-${(/* @__PURE__ */ new Date()).toISOString().split("T")[0]}.md`,
+        directory
+      );
+      (0, import_fs.writeFileSync)(outputPath, markdown);
+      console.log(import_chalk.default.green(`\u2705 Report saved to ${outputPath}`));
     } else {
       console.log(`Consistency Analysis Complete (${elapsedTime}s)`);
       console.log(`Files analyzed: ${report.summary.filesAnalyzed}`);

package/dist/cli.mjs

@@ -9,7 +9,7 @@ import { Command } from "commander";
 import chalk from "chalk";
 import { writeFileSync } from "fs";
 import { join } from "path";
-import { loadMergedConfig, handleJSONOutput, handleCLIError, getElapsedTime } from "@aiready/core";
+import { loadMergedConfig, handleJSONOutput, handleCLIError, getElapsedTime, resolveOutputPath } from "@aiready/core";
 import { readFileSync } from "fs";
 var packageJson = JSON.parse(readFileSync(join(__dirname, "../package.json"), "utf8"));
 var program = new Command();
@@ -41,7 +41,7 @@ program.command("scan").description("Run unified analysis on a codebase").argume
     const results = await analyzeUnified(finalOptions);
     const elapsedTime = getElapsedTime(startTime);
     const outputFormat = options.output || finalOptions.output?.format || "console";
-    const outputFile = options.outputFile || finalOptions.output?.file;
+    const userOutputFile = options.outputFile || finalOptions.output?.file;
     if (outputFormat === "json") {
       const outputData = {
         ...results,
@@ -50,7 +50,12 @@ program.command("scan").description("Run unified analysis on a codebase").argume
           executionTime: parseFloat(elapsedTime)
         }
       };
-      handleJSONOutput(outputData, outputFile, `\u2705 Results saved to ${outputFile}`);
+      const outputPath = resolveOutputPath(
+        userOutputFile,
+        `aiready-scan-${(/* @__PURE__ */ new Date()).toISOString().split("T")[0]}.json`,
+        directory
+      );
+      handleJSONOutput(outputData, outputPath, `\u2705 Results saved to ${outputPath}`);
     } else {
       console.log(generateUnifiedSummary(results));
     }
@@ -95,13 +100,18 @@ program.command("patterns").description("Run pattern detection analysis").argume
     const elapsedTime = getElapsedTime(startTime);
     const summary = generateSummary(results);
     const outputFormat = options.output || finalOptions.output?.format || "console";
-    const outputFile = options.outputFile || finalOptions.output?.file;
+    const userOutputFile = options.outputFile || finalOptions.output?.file;
     if (outputFormat === "json") {
       const outputData = {
         results,
         summary: { ...summary, executionTime: parseFloat(elapsedTime) }
       };
-      handleJSONOutput(outputData, outputFile, `\u2705 Results saved to ${outputFile}`);
+      const outputPath = resolveOutputPath(
+        userOutputFile,
+        `pattern-report-${(/* @__PURE__ */ new Date()).toISOString().split("T")[0]}.json`,
+        directory
+      );
+      handleJSONOutput(outputData, outputPath, `\u2705 Results saved to ${outputPath}`);
     } else {
       console.log(`Pattern Analysis Complete (${elapsedTime}s)`);
       console.log(`Found ${summary.totalPatterns} duplicate patterns`);
@@ -147,13 +157,18 @@ program.command("context").description("Run context window cost analysis").argum
     const elapsedTime = getElapsedTime(startTime);
     const summary = generateSummary(results);
     const outputFormat = options.output || finalOptions.output?.format || "console";
-    const outputFile = options.outputFile || finalOptions.output?.file;
+    const userOutputFile = options.outputFile || finalOptions.output?.file;
     if (outputFormat === "json") {
       const outputData = {
         results,
         summary: { ...summary, executionTime: parseFloat(elapsedTime) }
       };
-      handleJSONOutput(outputData, outputFile, `\u2705 Results saved to ${outputFile}`);
+      const outputPath = resolveOutputPath(
+        userOutputFile,
+        `context-report-${(/* @__PURE__ */ new Date()).toISOString().split("T")[0]}.json`,
+        directory
+      );
+      handleJSONOutput(outputData, outputPath, `\u2705 Results saved to ${outputPath}`);
     } else {
       console.log(`Context Analysis Complete (${elapsedTime}s)`);
       console.log(`Files analyzed: ${summary.totalFiles}`);
@@ -191,7 +206,7 @@ program.command("consistency").description("Check naming, patterns, and architec
     const report = await analyzeConsistency(finalOptions);
     const elapsedTime = getElapsedTime(startTime);
     const outputFormat = options.output || finalOptions.output?.format || "console";
-    const outputFile = options.outputFile || finalOptions.output?.file;
+    const userOutputFile = options.outputFile || finalOptions.output?.file;
     if (outputFormat === "json") {
       const outputData = {
         ...report,
@@ -200,15 +215,21 @@ program.command("consistency").description("Check naming, patterns, and architec
           executionTime: parseFloat(elapsedTime)
         }
       };
-      handleJSONOutput(outputData, outputFile, `\u2705 Results saved to ${outputFile}`);
+      const outputPath = resolveOutputPath(
+        userOutputFile,
+        `consistency-report-${(/* @__PURE__ */ new Date()).toISOString().split("T")[0]}.json`,
+        directory
+      );
+      handleJSONOutput(outputData, outputPath, `\u2705 Results saved to ${outputPath}`);
     } else if (outputFormat === "markdown") {
       const markdown = generateMarkdownReport(report, elapsedTime);
-      if (outputFile) {
-        writeFileSync(outputFile, markdown);
-        console.log(chalk.green(`\u2705 Report saved to ${outputFile}`));
-      } else {
-        console.log(markdown);
-      }
+      const outputPath = resolveOutputPath(
+        userOutputFile,
+        `consistency-report-${(/* @__PURE__ */ new Date()).toISOString().split("T")[0]}.md`,
+        directory
+      );
+      writeFileSync(outputPath, markdown);
+      console.log(chalk.green(`\u2705 Report saved to ${outputPath}`));
     } else {
       console.log(`Consistency Analysis Complete (${elapsedTime}s)`);
       console.log(`Files analyzed: ${report.summary.filesAnalyzed}`);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aiready/cli",
-  "version": "0.4.1",
+  "version": "0.4.2",
   "description": "Unified CLI for AIReady analysis tools",
   "main": "./dist/index.js",
   "module": "./dist/index.mjs",
@@ -11,10 +11,10 @@
   "dependencies": {
     "commander": "^12.1.0",
     "chalk": "^5.3.0",
-    "@aiready/core": "0.5.1",
-    "@aiready/context-analyzer": "0.4.1",
-    "@aiready/pattern-detect": "0.8.1",
-    "@aiready/consistency": "0.2.1"
+    "@aiready/core": "0.5.3",
+    "@aiready/pattern-detect": "0.8.2",
+    "@aiready/context-analyzer": "0.4.3",
+    "@aiready/consistency": "0.2.2"
   },
   "devDependencies": {
     "tsup": "^8.3.5",

package/src/cli.ts

@@ -5,7 +5,7 @@ import { analyzeUnified, generateUnifiedSummary } from './index';
 import chalk from 'chalk';
 import { writeFileSync } from 'fs';
 import { join } from 'path';
-import { loadMergedConfig, handleJSONOutput, handleCLIError, getElapsedTime } from '@aiready/core';
+import { loadMergedConfig, handleJSONOutput, handleCLIError, getElapsedTime, resolveOutputPath } from '@aiready/core';
 import { readFileSync } from 'fs';
 
 const packageJson = JSON.parse(readFileSync(join(__dirname, '../package.json'), 'utf8'));
@@ -64,7 +64,7 @@ program
       const elapsedTime = getElapsedTime(startTime);
 
       const outputFormat = options.output || finalOptions.output?.format || 'console';
-      const outputFile = options.outputFile || finalOptions.output?.file;
+      const userOutputFile = options.outputFile || finalOptions.output?.file;
 
       if (outputFormat === 'json') {
         const outputData = {
@@ -75,7 +75,13 @@ program
           },
         };
 
-        handleJSONOutput(outputData, outputFile, `✅ Results saved to ${outputFile}`);
+        const outputPath = resolveOutputPath(
+          userOutputFile,
+          `aiready-scan-${new Date().toISOString().split('T')[0]}.json`,
+          directory
+        );
+        
+        handleJSONOutput(outputData, outputPath, `✅ Results saved to ${outputPath}`);
       } else {
         // Console output
         console.log(generateUnifiedSummary(results));
@@ -152,7 +158,7 @@ program
       const summary = generateSummary(results);
 
       const outputFormat = options.output || finalOptions.output?.format || 'console';
-      const outputFile = options.outputFile || finalOptions.output?.file;
+      const userOutputFile = options.outputFile || finalOptions.output?.file;
 
       if (outputFormat === 'json') {
         const outputData = {
@@ -160,7 +166,13 @@ program
           summary: { ...summary, executionTime: parseFloat(elapsedTime) },
         };
 
-        handleJSONOutput(outputData, outputFile, `✅ Results saved to ${outputFile}`);
+        const outputPath = resolveOutputPath(
+          userOutputFile,
+          `pattern-report-${new Date().toISOString().split('T')[0]}.json`,
+          directory
+        );
+        
+        handleJSONOutput(outputData, outputPath, `✅ Results saved to ${outputPath}`);
       } else {
         console.log(`Pattern Analysis Complete (${elapsedTime}s)`);
         console.log(`Found ${summary.totalPatterns} duplicate patterns`);
@@ -230,7 +242,7 @@ program
       const summary = generateSummary(results);
 
       const outputFormat = options.output || finalOptions.output?.format || 'console';
-      const outputFile = options.outputFile || finalOptions.output?.file;
+      const userOutputFile = options.outputFile || finalOptions.output?.file;
 
       if (outputFormat === 'json') {
         const outputData = {
@@ -238,7 +250,13 @@ program
           summary: { ...summary, executionTime: parseFloat(elapsedTime) },
         };
 
-        handleJSONOutput(outputData, outputFile, `✅ Results saved to ${outputFile}`);
+        const outputPath = resolveOutputPath(
+          userOutputFile,
+          `context-report-${new Date().toISOString().split('T')[0]}.json`,
+          directory
+        );
+        
+        handleJSONOutput(outputData, outputPath, `✅ Results saved to ${outputPath}`);
       } else {
         console.log(`Context Analysis Complete (${elapsedTime}s)`);
         console.log(`Files analyzed: ${summary.totalFiles}`);
@@ -299,7 +317,7 @@ program
         const elapsedTime = getElapsedTime(startTime);
 
         const outputFormat = options.output || finalOptions.output?.format || 'console';
-        const outputFile = options.outputFile || finalOptions.output?.file;
+        const userOutputFile = options.outputFile || finalOptions.output?.file;
 
         if (outputFormat === 'json') {
           const outputData = {
@@ -310,16 +328,23 @@ program
             },
           };
 
-          handleJSONOutput(outputData, outputFile, `✅ Results saved to ${outputFile}`);
+          const outputPath = resolveOutputPath(
+            userOutputFile,
+            `consistency-report-${new Date().toISOString().split('T')[0]}.json`,
+            directory
+          );
+          
+          handleJSONOutput(outputData, outputPath, `✅ Results saved to ${outputPath}`);
         } else if (outputFormat === 'markdown') {
           // Markdown output
           const markdown = generateMarkdownReport(report, elapsedTime);
-          if (outputFile) {
-            writeFileSync(outputFile, markdown);
-            console.log(chalk.green(`✅ Report saved to ${outputFile}`));
-          } else {
-            console.log(markdown);
-          }
+          const outputPath = resolveOutputPath(
+            userOutputFile,
+            `consistency-report-${new Date().toISOString().split('T')[0]}.md`,
+            directory
+          );
+          writeFileSync(outputPath, markdown);
+          console.log(chalk.green(`✅ Report saved to ${outputPath}`));
         } else {
           console.log(`Consistency Analysis Complete (${elapsedTime}s)`);
           console.log(`Files analyzed: ${report.summary.filesAnalyzed}`);