@aiready/pattern-detect 0.8.0 → 0.8.2

package/README.md

@@ -24,11 +24,21 @@ aiready-patterns ./src
 
 AI tools generate similar code in different ways because they lack awareness of your codebase patterns. This tool:
 
-- **Semantic detection**: Finds functionally similar code (not just copy-paste)
+- **Semantic detection**: Finds functionally similar code (not just copy-paste) using Jaccard similarity on AST tokens
 - **Pattern classification**: Groups duplicates by type (API handlers, validators, utilities, etc.)
 - **Token cost analysis**: Shows wasted AI context budget
 - **Refactoring guidance**: Suggests specific fixes per pattern type
 
+### How It Works
+
+The tool uses **Jaccard similarity** to compare code semantically:
+1. Parses TypeScript/JavaScript files into Abstract Syntax Trees (AST)
+2. Extracts semantic tokens (identifiers, operators, keywords) from each function
+3. Calculates Jaccard similarity between token sets: `|A ∩ B| / |A ∪ B|`
+4. Groups similar functions above the similarity threshold
+
+This approach catches duplicates even when variable names or minor logic differs.
+
 ### Example Output
 
 ```
@@ -58,10 +68,15 @@ aiready patterns ./src --similarity 0.9
 # Include smaller patterns
 aiready patterns ./src --min-lines 3
 
-# Export results
-aiready patterns ./src --output json --output-file report.json
+# Export results (saved to .aiready/ by default)
+aiready patterns ./src --output json
+
+# Or specify custom path
+aiready patterns ./src --output json --output-file custom-report.json
 ```
 
+> **📁 Output Files:** By default, all output files are saved to the `.aiready/` directory in your project root. You can override this with `--output-file`.
+
 ## 🎛️ Tuning Guide
 
 ### Main Parameters

package/dist/cli.js

@@ -590,18 +590,31 @@ program.name("aiready-patterns").description("Detect duplicate patterns in your
       results,
       timestamp: (/* @__PURE__ */ new Date()).toISOString()
     };
-    if (options.outputFile) {
-      (0, import_fs.writeFileSync)(options.outputFile, JSON.stringify(jsonOutput, null, 2));
-      console.log(import_chalk.default.green(`
-\u2713 JSON report saved to ${options.outputFile}`));
-    } else {
-      console.log(JSON.stringify(jsonOutput, null, 2));
+    const outputPath = (0, import_core3.resolveOutputPath)(
+      options.outputFile,
+      `pattern-report-${(/* @__PURE__ */ new Date()).toISOString().split("T")[0]}.json`,
+      directory
+    );
+    const dir = (0, import_path.dirname)(outputPath);
+    if (!(0, import_fs.existsSync)(dir)) {
+      (0, import_fs.mkdirSync)(dir, { recursive: true });
     }
+    (0, import_fs.writeFileSync)(outputPath, JSON.stringify(jsonOutput, null, 2));
+    console.log(import_chalk.default.green(`
+\u2713 JSON report saved to ${outputPath}`));
     return;
   }
   if (options.output === "html") {
     const html = generateHTMLReport(summary, results);
-    const outputPath = options.outputFile || (0, import_path.join)(process.cwd(), "pattern-report.html");
+    const outputPath = (0, import_core3.resolveOutputPath)(
+      options.outputFile,
+      `pattern-report-${(/* @__PURE__ */ new Date()).toISOString().split("T")[0]}.html`,
+      directory
+    );
+    const dir = (0, import_path.dirname)(outputPath);
+    if (!(0, import_fs.existsSync)(dir)) {
+      (0, import_fs.mkdirSync)(dir, { recursive: true });
+    }
     (0, import_fs.writeFileSync)(outputPath, html);
     console.log(import_chalk.default.green(`
 \u2713 HTML report saved to ${outputPath}`));

package/dist/cli.mjs

@@ -7,9 +7,9 @@ import {
 // src/cli.ts
 import { Command } from "commander";
 import chalk from "chalk";
-import { writeFileSync } from "fs";
-import { join } from "path";
-import { loadConfig, mergeConfigWithDefaults } from "@aiready/core";
+import { writeFileSync, mkdirSync, existsSync } from "fs";
+import { dirname } from "path";
+import { loadConfig, mergeConfigWithDefaults, resolveOutputPath } from "@aiready/core";
 var program = new Command();
 program.name("aiready-patterns").description("Detect duplicate patterns in your codebase").version("0.1.0").addHelpText("after", "\nCONFIGURATION:\n  Supports config files: aiready.json, aiready.config.json, .aiready.json, .aireadyrc.json, aiready.config.js, .aireadyrc.js\n  CLI options override config file settings\n\nPARAMETER TUNING:\n  If you get too few results: decrease --similarity, --min-lines, or --min-shared-tokens\n  If analysis is too slow: increase --min-lines, --min-shared-tokens, or decrease --max-candidates\n  If you get too many false positives: increase --similarity or --min-lines\n\nEXAMPLES:\n  aiready-patterns .                                    # Basic analysis with smart defaults\n  aiready-patterns . --similarity 0.3 --min-lines 3     # More sensitive detection\n  aiready-patterns . --max-candidates 50 --no-approx    # Slower but more thorough\n  aiready-patterns . --output json > report.json       # JSON export").argument("<directory>", "Directory to analyze").option("-s, --similarity <number>", "Minimum similarity score (0-1). Lower = more results, higher = fewer but more accurate. Default: 0.4").option("-l, --min-lines <number>", "Minimum lines to consider. Lower = more results, higher = faster analysis. Default: 5").option("--batch-size <number>", "Batch size for comparisons. Higher = faster but more memory. Default: 100").option("--no-approx", "Disable approximate candidate selection. Slower but more thorough on small repos").option("--min-shared-tokens <number>", "Minimum shared tokens to consider a candidate. Higher = faster, fewer results. Default: 8").option("--max-candidates <number>", "Maximum candidates per block. Higher = more thorough but slower. Default: 100").option("--no-stream-results", "Disable incremental output (default: enabled)").option("--include <patterns>", "File patterns to include (comma-separated)").option("--exclude <patterns>", "File patterns to exclude (comma-separated)").option("--severity <level>", "Filter by severity: critical|high|medium|all. Default: all").option("--include-tests", "Include test files in analysis (excluded by default)").option("--max-results <number>", "Maximum number of results to show in console output. Default: 10").option(
   "-o, --output <format>",
@@ -71,18 +71,31 @@ program.name("aiready-patterns").description("Detect duplicate patterns in your
       results,
       timestamp: (/* @__PURE__ */ new Date()).toISOString()
     };
-    if (options.outputFile) {
-      writeFileSync(options.outputFile, JSON.stringify(jsonOutput, null, 2));
-      console.log(chalk.green(`
-\u2713 JSON report saved to ${options.outputFile}`));
-    } else {
-      console.log(JSON.stringify(jsonOutput, null, 2));
+    const outputPath = resolveOutputPath(
+      options.outputFile,
+      `pattern-report-${(/* @__PURE__ */ new Date()).toISOString().split("T")[0]}.json`,
+      directory
+    );
+    const dir = dirname(outputPath);
+    if (!existsSync(dir)) {
+      mkdirSync(dir, { recursive: true });
     }
+    writeFileSync(outputPath, JSON.stringify(jsonOutput, null, 2));
+    console.log(chalk.green(`
+\u2713 JSON report saved to ${outputPath}`));
     return;
   }
   if (options.output === "html") {
     const html = generateHTMLReport(summary, results);
-    const outputPath = options.outputFile || join(process.cwd(), "pattern-report.html");
+    const outputPath = resolveOutputPath(
+      options.outputFile,
+      `pattern-report-${(/* @__PURE__ */ new Date()).toISOString().split("T")[0]}.html`,
+      directory
+    );
+    const dir = dirname(outputPath);
+    if (!existsSync(dir)) {
+      mkdirSync(dir, { recursive: true });
+    }
     writeFileSync(outputPath, html);
     console.log(chalk.green(`
 \u2713 HTML report saved to ${outputPath}`));

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aiready/pattern-detect",
-  "version": "0.8.0",
+  "version": "0.8.2",
   "description": "Semantic duplicate pattern detection for AI-generated code - finds similar implementations that waste AI context tokens",
   "main": "./dist/index.js",
   "module": "./dist/index.mjs",
@@ -45,7 +45,7 @@
   "dependencies": {
     "commander": "^14.0.0",
     "chalk": "^5.3.0",
-    "@aiready/core": "0.5.0"
+    "@aiready/core": "0.5.3"
   },
   "devDependencies": {
     "tsup": "^8.3.5",