@aiready/pattern-detect 0.16.18 → 0.16.19

package/dist/index.d.ts

@@ -1,242 +1,14 @@
-import { ToolProvider, Severity, FileContent, ScanOptions, AnalysisResult, CostConfig, ToolScoringOutput } from '@aiready/core';
+import { ToolProvider } from '@aiready/core';
 export { Severity } from '@aiready/core';
+export { D as DuplicateGroup, P as PatternDetectOptions, a as PatternSummary, R as RefactorCluster, b as analyzePatterns, c as createRefactorClusters, f as filterClustersByImpact, g as generateSummary, d as getSmartDefaults, e as groupDuplicatesByFilePair } from './analyzer-entry-BwuoiCNm.js';
+export { detectDuplicatePatterns } from './detector-entry.js';
+export { calculatePatternScore } from './scoring-entry.js';
+export { C as CONTEXT_RULES, a as ContextRule, c as calculateSeverity, f as filterBySeverity, g as getSeverityLabel, b as getSeverityThreshold } from './context-rules-entry-y2uJSngh.js';
+export { D as DuplicatePattern, P as PatternType } from './types-DU2mmhwb.js';
 
 /**
  * Pattern Detection Tool Provider
  */
 declare const PatternDetectProvider: ToolProvider;
 
-type PatternType = 'api-handler' | 'validator' | 'utility' | 'class-method' | 'component' | 'function' | 'unknown';
-interface DuplicatePattern {
-    file1: string;
-    line1: number;
-    endLine1: number;
-    file2: string;
-    line2: number;
-    endLine2: number;
-    code1: string;
-    code2: string;
-    similarity: number;
-    confidence: number;
-    patternType: PatternType;
-    tokenCost: number;
-    severity: Severity;
-    reason?: string;
-    suggestion?: string;
-    matchedRule?: string;
-}
-interface DetectionOptions {
-    minSimilarity: number;
-    minLines: number;
-    batchSize: number;
-    approx: boolean;
-    minSharedTokens: number;
-    maxCandidatesPerBlock: number;
-    streamResults: boolean;
-    excludePatterns?: string[];
-    confidenceThreshold?: number;
-    ignoreWhitelist?: string[];
-    onProgress?: (processed: number, total: number, message: string) => void;
-}
-
-/**
- * Detect duplicate patterns across files
- *
- * @param fileContents - Array of file contents to analyze.
- * @param options - Configuration for duplicate detection (thresholds, progress, etc).
- * @returns Promise resolving to an array of detected duplicate patterns sorted by similarity.
- */
-declare function detectDuplicatePatterns(fileContents: FileContent[], options: DetectionOptions): Promise<DuplicatePattern[]>;
-
-interface DuplicateGroup {
-    filePair: string;
-    severity: Severity;
-    occurrences: number;
-    totalTokenCost: number;
-    averageSimilarity: number;
-    patternTypes: Set<PatternType>;
-    lineRanges: Array<{
-        file1: {
-            start: number;
-            end: number;
-        };
-        file2: {
-            start: number;
-            end: number;
-        };
-    }>;
-}
-interface RefactorCluster {
-    id: string;
-    name: string;
-    files: string[];
-    severity: Severity;
-    duplicateCount: number;
-    totalTokenCost: number;
-    averageSimilarity: number;
-    reason?: string;
-    suggestion?: string;
-}
-/**
- * Group raw duplicates by file pairs to reduce noise
- */
-declare function groupDuplicatesByFilePair(duplicates: DuplicatePattern[]): DuplicateGroup[];
-/**
- * Create clusters of highly related files (refactor targets)
- * Uses a simple connected components algorithm
- * @param duplicates - Array of duplicate patterns to cluster
- * @returns Array of refactor clusters
- */
-declare function createRefactorClusters(duplicates: DuplicatePattern[]): RefactorCluster[];
-/**
- * Filter clusters by impact threshold
- * @param clusters - Array of refactor clusters to filter
- * @param minTokenCost - Minimum token cost threshold (default: 1000)
- * @param minFiles - Minimum number of files in cluster (default: 3)
- * @returns Filtered array of refactor clusters
- */
-declare function filterClustersByImpact(clusters: RefactorCluster[], minTokenCost?: number, minFiles?: number): RefactorCluster[];
-
-interface PatternDetectOptions extends ScanOptions {
-    minSimilarity?: number;
-    minLines?: number;
-    batchSize?: number;
-    approx?: boolean;
-    minSharedTokens?: number;
-    maxCandidatesPerBlock?: number;
-    streamResults?: boolean;
-    severity?: string;
-    includeTests?: boolean;
-    useSmartDefaults?: boolean;
-    groupByFilePair?: boolean;
-    createClusters?: boolean;
-    minClusterTokenCost?: number;
-    minClusterFiles?: number;
-    excludePatterns?: string[];
-    confidenceThreshold?: number;
-    ignoreWhitelist?: string[];
-    onProgress?: (processed: number, total: number, message: string) => void;
-}
-interface PatternSummary {
-    totalPatterns: number;
-    totalTokenCost: number;
-    patternsByType: Record<PatternType, number>;
-    topDuplicates: Array<{
-        files: Array<{
-            path: string;
-            startLine: number;
-            endLine: number;
-        }>;
-        similarity: number;
-        patternType: PatternType;
-        tokenCost: number;
-    }>;
-}
-/**
- * Determine smart defaults based on repository size estimation.
- *
- * @param directory - The directory to analyze for size.
- * @param userOptions - User-provided option overrides.
- * @returns Promise resolving to optimal detection options.
- */
-declare function getSmartDefaults(directory: string, userOptions: Partial<PatternDetectOptions>): Promise<PatternDetectOptions>;
-/**
- * Main entry point for pattern detection analysis.
- *
- * @param options - Configuration including rootDir and detection parameters.
- * @returns Promise resolving to the comprehensive pattern detect report.
- * @lastUpdated 2026-03-18
- */
-declare function analyzePatterns(options: PatternDetectOptions): Promise<{
-    results: AnalysisResult[];
-    duplicates: DuplicatePattern[];
-    files: string[];
-    groups?: DuplicateGroup[];
-    clusters?: RefactorCluster[];
-    config: PatternDetectOptions;
-}>;
-/**
- * Generate a summary of pattern detection results.
- *
- * @param results - Array of file-level analysis results.
- * @returns Consolidated pattern summary object.
- */
-declare function generateSummary(results: AnalysisResult[]): PatternSummary;
-
-/**
- * Calculate AI Readiness Score for pattern duplication (0-100)
- *
- * Based on:
- * - Number of duplicates per file
- * - Token waste per file
- * - High-impact duplicates (>1000 tokens or >70% similarity)
- *
- * Includes business value metrics:
- * - Estimated monthly cost of token waste
- * - Estimated developer hours to fix
- *
- * @param duplicates - Array of detected duplicate patterns.
- * @param totalFilesAnalyzed - Total count of files scanned.
- * @param costConfig - Optional configuration for business value calculations.
- * @returns Standardized scoring output for pattern detection.
- */
-declare function calculatePatternScore(duplicates: DuplicatePattern[], totalFilesAnalyzed: number, costConfig?: Partial<CostConfig>): ToolScoringOutput;
-
-/**
- * Context-aware severity detection for duplicate patterns
- * Identifies intentional duplication patterns and adjusts severity accordingly
- */
-interface ContextRule {
-    name: string;
-    detect: (file: string, code: string) => boolean;
-    severity: Severity;
-    reason: string;
-    suggestion?: string;
-}
-/**
- * Context rules for detecting intentional or acceptable duplication patterns
- * Rules are checked in order - first match wins
- */
-declare const CONTEXT_RULES: ContextRule[];
-/**
- * Calculate severity based on context rules and code characteristics
- *
- * @param file1 - First file path in the duplicate pair.
- * @param file2 - Second file path in the duplicate pair.
- * @param code - Snippet of the duplicated code.
- * @param similarity - The calculated similarity score (0-1).
- * @param linesOfCode - Number of lines in the duplicated block.
- * @returns An object containing the severity level and reasoning.
- */
-declare function calculateSeverity(file1: string, file2: string, code: string, similarity: number, linesOfCode: number): {
-    severity: Severity;
-    reason?: string;
-    suggestion?: string;
-    matchedRule?: string;
-};
-/**
- * Get a human-readable severity label with emoji
- *
- * @param severity - The severity level to label.
- * @returns Formatted label string for UI display.
- */
-declare function getSeverityLabel(severity: Severity): string;
-/**
- * Filter duplicates by minimum severity threshold
- *
- * @param duplicates - List of items with a severity property.
- * @param minSeverity - Minimum threshold for inclusion.
- * @returns Filtered list of items.
- */
-declare function filterBySeverity<T extends {
-    severity: Severity;
-}>(duplicates: T[], minSeverity: Severity): T[];
-/**
- * Get numerical similarity threshold associated with a severity level
- *
- * @param severity - The severity level to look up.
- * @returns Minimum similarity value for this severity.
- */
-declare function getSeverityThreshold(severity: Severity): number;
-
-export { CONTEXT_RULES, type ContextRule, type DuplicateGroup, type DuplicatePattern, type PatternDetectOptions, PatternDetectProvider, type PatternSummary, type PatternType, type RefactorCluster, analyzePatterns, calculatePatternScore, calculateSeverity, createRefactorClusters, detectDuplicatePatterns, filterBySeverity, filterClustersByImpact, generateSummary, getSeverityLabel, getSeverityThreshold, getSmartDefaults, groupDuplicatesByFilePair };
+export { PatternDetectProvider };

package/dist/index.mjs

@@ -1,20 +1,28 @@
 import {
-  CONTEXT_RULES,
   PatternDetectProvider,
-  Severity,
+  Severity
+} from "./chunk-UB3CGOQ7.mjs";
+import {
   analyzePatterns,
-  calculatePatternScore,
-  calculateSeverity,
   createRefactorClusters,
-  detectDuplicatePatterns,
-  filterBySeverity,
   filterClustersByImpact,
   generateSummary,
-  getSeverityLabel,
-  getSeverityThreshold,
   getSmartDefaults,
   groupDuplicatesByFilePair
-} from "./chunk-BUBQ3W6W.mjs";
+} from "./chunk-WMOGJFME.mjs";
+import {
+  detectDuplicatePatterns
+} from "./chunk-THF4RW63.mjs";
+import {
+  CONTEXT_RULES,
+  calculateSeverity,
+  filterBySeverity,
+  getSeverityLabel,
+  getSeverityThreshold
+} from "./chunk-I6ETJC7L.mjs";
+import {
+  calculatePatternScore
+} from "./chunk-WBBO35SC.mjs";
 export {
   CONTEXT_RULES,
   PatternDetectProvider,

package/dist/scoring-entry.d.mts

@@ -0,0 +1,23 @@
+import { CostConfig, ToolScoringOutput } from '@aiready/core';
+import { D as DuplicatePattern } from './types-DU2mmhwb.mjs';
+
+/**
+ * Calculate AI Readiness Score for pattern duplication (0-100)
+ *
+ * Based on:
+ * - Number of duplicates per file
+ * - Token waste per file
+ * - High-impact duplicates (>1000 tokens or >70% similarity)
+ *
+ * Includes business value metrics:
+ * - Estimated monthly cost of token waste
+ * - Estimated developer hours to fix
+ *
+ * @param duplicates - Array of detected duplicate patterns.
+ * @param totalFilesAnalyzed - Total count of files scanned.
+ * @param costConfig - Optional configuration for business value calculations.
+ * @returns Standardized scoring output for pattern detection.
+ */
+declare function calculatePatternScore(duplicates: DuplicatePattern[], totalFilesAnalyzed: number, costConfig?: Partial<CostConfig>): ToolScoringOutput;
+
+export { calculatePatternScore };

package/dist/scoring-entry.d.ts

@@ -0,0 +1,23 @@
+import { CostConfig, ToolScoringOutput } from '@aiready/core';
+import { D as DuplicatePattern } from './types-DU2mmhwb.js';
+
+/**
+ * Calculate AI Readiness Score for pattern duplication (0-100)
+ *
+ * Based on:
+ * - Number of duplicates per file
+ * - Token waste per file
+ * - High-impact duplicates (>1000 tokens or >70% similarity)
+ *
+ * Includes business value metrics:
+ * - Estimated monthly cost of token waste
+ * - Estimated developer hours to fix
+ *
+ * @param duplicates - Array of detected duplicate patterns.
+ * @param totalFilesAnalyzed - Total count of files scanned.
+ * @param costConfig - Optional configuration for business value calculations.
+ * @returns Standardized scoring output for pattern detection.
+ */
+declare function calculatePatternScore(duplicates: DuplicatePattern[], totalFilesAnalyzed: number, costConfig?: Partial<CostConfig>): ToolScoringOutput;
+
+export { calculatePatternScore };

package/dist/scoring-entry.js

@@ -0,0 +1,133 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/scoring-entry.ts
+var scoring_entry_exports = {};
+__export(scoring_entry_exports, {
+  calculatePatternScore: () => calculatePatternScore
+});
+module.exports = __toCommonJS(scoring_entry_exports);
+
+// src/scoring.ts
+var import_core = require("@aiready/core");
+function calculatePatternScore(duplicates, totalFilesAnalyzed, costConfig) {
+  const totalDuplicates = duplicates.length;
+  const totalTokenCost = duplicates.reduce((sum, d) => sum + d.tokenCost, 0);
+  const highImpactDuplicates = duplicates.filter(
+    (d) => d.tokenCost > 1e3 || d.similarity > 0.7
+  ).length;
+  if (totalFilesAnalyzed === 0) {
+    return {
+      toolName: import_core.ToolName.PatternDetect,
+      score: 100,
+      rawMetrics: {
+        totalDuplicates: 0,
+        totalTokenCost: 0,
+        highImpactDuplicates: 0,
+        totalFilesAnalyzed: 0
+      },
+      factors: [],
+      recommendations: []
+    };
+  }
+  const duplicatesPerFile = totalDuplicates / totalFilesAnalyzed * 100;
+  const tokenWastePerFile = totalTokenCost / totalFilesAnalyzed;
+  const duplicatesPenalty = Math.min(60, duplicatesPerFile * 0.6);
+  const tokenPenalty = Math.min(40, tokenWastePerFile / 125);
+  const highImpactPenalty = highImpactDuplicates > 0 ? Math.min(15, highImpactDuplicates * 2 - 5) : -5;
+  const score = 100 - duplicatesPenalty - tokenPenalty - highImpactPenalty;
+  const finalScore = Math.max(0, Math.min(100, Math.round(score)));
+  const factors = [
+    {
+      name: "Duplication Density",
+      impact: -Math.round(duplicatesPenalty),
+      description: `${duplicatesPerFile.toFixed(1)} duplicates per 100 files`
+    },
+    {
+      name: "Token Waste",
+      impact: -Math.round(tokenPenalty),
+      description: `${Math.round(tokenWastePerFile)} tokens wasted per file`
+    }
+  ];
+  if (highImpactDuplicates > 0) {
+    factors.push({
+      name: "High-Impact Patterns",
+      impact: -Math.round(highImpactPenalty),
+      description: `${highImpactDuplicates} high-impact duplicates (>1000 tokens or >70% similar)`
+    });
+  } else {
+    factors.push({
+      name: "No High-Impact Patterns",
+      impact: 5,
+      description: "No severe duplicates detected"
+    });
+  }
+  const recommendations = [];
+  if (highImpactDuplicates > 0) {
+    const estimatedImpact = Math.min(15, highImpactDuplicates * 3);
+    recommendations.push({
+      action: `Deduplicate ${highImpactDuplicates} high-impact pattern${highImpactDuplicates > 1 ? "s" : ""}`,
+      estimatedImpact,
+      priority: "high"
+    });
+  }
+  if (totalDuplicates > 10 && duplicatesPerFile > 20) {
+    const estimatedImpact = Math.min(10, Math.round(duplicatesPenalty * 0.3));
+    recommendations.push({
+      action: "Extract common patterns into shared utilities",
+      estimatedImpact,
+      priority: "medium"
+    });
+  }
+  if (tokenWastePerFile > 2e3) {
+    const estimatedImpact = Math.min(8, Math.round(tokenPenalty * 0.4));
+    recommendations.push({
+      action: "Consolidate duplicated logic to reduce AI context waste",
+      estimatedImpact,
+      priority: totalTokenCost > 1e4 ? "high" : "medium"
+    });
+  }
+  const cfg = { ...import_core.DEFAULT_COST_CONFIG, ...costConfig };
+  const estimatedMonthlyCost = (0, import_core.calculateMonthlyCost)(totalTokenCost, cfg);
+  const issues = duplicates.map((d) => ({
+    severity: d.severity === "critical" ? "critical" : d.severity === "major" ? "major" : "minor"
+  }));
+  const productivityImpact = (0, import_core.calculateProductivityImpact)(issues);
+  return {
+    toolName: "pattern-detect",
+    score: finalScore,
+    rawMetrics: {
+      totalDuplicates,
+      totalTokenCost,
+      highImpactDuplicates,
+      totalFilesAnalyzed,
+      duplicatesPerFile: Math.round(duplicatesPerFile * 10) / 10,
+      tokenWastePerFile: Math.round(tokenWastePerFile),
+      // Business value metrics
+      estimatedMonthlyCost,
+      estimatedDeveloperHours: productivityImpact.totalHours
+    },
+    factors,
+    recommendations
+  };
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  calculatePatternScore
+});

package/dist/scoring-entry.mjs

@@ -0,0 +1,6 @@
+import {
+  calculatePatternScore
+} from "./chunk-WBBO35SC.mjs";
+export {
+  calculatePatternScore
+};

package/dist/types-DU2mmhwb.d.mts

@@ -0,0 +1,36 @@
+import { Severity } from '@aiready/core';
+
+type PatternType = 'api-handler' | 'validator' | 'utility' | 'class-method' | 'component' | 'function' | 'unknown';
+interface DuplicatePattern {
+    file1: string;
+    line1: number;
+    endLine1: number;
+    file2: string;
+    line2: number;
+    endLine2: number;
+    code1: string;
+    code2: string;
+    similarity: number;
+    confidence: number;
+    patternType: PatternType;
+    tokenCost: number;
+    severity: Severity;
+    reason?: string;
+    suggestion?: string;
+    matchedRule?: string;
+}
+interface DetectionOptions {
+    minSimilarity: number;
+    minLines: number;
+    batchSize: number;
+    approx: boolean;
+    minSharedTokens: number;
+    maxCandidatesPerBlock: number;
+    streamResults: boolean;
+    excludePatterns?: string[];
+    confidenceThreshold?: number;
+    ignoreWhitelist?: string[];
+    onProgress?: (processed: number, total: number, message: string) => void;
+}
+
+export type { DuplicatePattern as D, PatternType as P, DetectionOptions as a };

package/dist/types-DU2mmhwb.d.ts

@@ -0,0 +1,36 @@
+import { Severity } from '@aiready/core';
+
+type PatternType = 'api-handler' | 'validator' | 'utility' | 'class-method' | 'component' | 'function' | 'unknown';
+interface DuplicatePattern {
+    file1: string;
+    line1: number;
+    endLine1: number;
+    file2: string;
+    line2: number;
+    endLine2: number;
+    code1: string;
+    code2: string;
+    similarity: number;
+    confidence: number;
+    patternType: PatternType;
+    tokenCost: number;
+    severity: Severity;
+    reason?: string;
+    suggestion?: string;
+    matchedRule?: string;
+}
+interface DetectionOptions {
+    minSimilarity: number;
+    minLines: number;
+    batchSize: number;
+    approx: boolean;
+    minSharedTokens: number;
+    maxCandidatesPerBlock: number;
+    streamResults: boolean;
+    excludePatterns?: string[];
+    confidenceThreshold?: number;
+    ignoreWhitelist?: string[];
+    onProgress?: (processed: number, total: number, message: string) => void;
+}
+
+export type { DuplicatePattern as D, PatternType as P, DetectionOptions as a };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aiready/pattern-detect",
-  "version": "0.16.18",
+  "version": "0.16.19",
   "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",
@@ -13,6 +13,26 @@
       "types": "./dist/index.d.ts",
       "require": "./dist/index.js",
       "import": "./dist/index.mjs"
+    },
+    "./analyzer": {
+      "types": "./dist/analyzer-entry.d.ts",
+      "require": "./dist/analyzer-entry.js",
+      "import": "./dist/analyzer-entry.mjs"
+    },
+    "./detector": {
+      "types": "./dist/detector-entry.d.ts",
+      "require": "./dist/detector-entry.js",
+      "import": "./dist/detector-entry.mjs"
+    },
+    "./scoring": {
+      "types": "./dist/scoring-entry.d.ts",
+      "require": "./dist/scoring-entry.js",
+      "import": "./dist/scoring-entry.mjs"
+    },
+    "./context-rules": {
+      "types": "./dist/context-rules-entry.d.ts",
+      "require": "./dist/context-rules-entry.js",
+      "import": "./dist/context-rules-entry.mjs"
     }
   },
   "keywords": [
@@ -45,7 +65,7 @@
   "dependencies": {
     "commander": "^14.0.0",
     "chalk": "^5.3.0",
-    "@aiready/core": "0.23.19"
+    "@aiready/core": "0.23.20"
   },
   "devDependencies": {
     "tsup": "^8.3.5",
@@ -64,8 +84,8 @@
     "access": "public"
   },
   "scripts": {
-    "build": "tsup src/index.ts src/cli.ts --format cjs,esm --dts",
-    "dev": "tsup src/index.ts src/cli.ts --format cjs,esm --dts --watch",
+    "build": "tsup src/index.ts src/cli.ts src/analyzer-entry.ts src/detector-entry.ts src/scoring-entry.ts src/context-rules-entry.ts --format cjs,esm --dts",
+    "dev": "tsup src/index.ts src/cli.ts src/analyzer-entry.ts src/detector-entry.ts src/scoring-entry.ts src/context-rules-entry.ts --format cjs,esm --dts --watch",
     "test": "vitest run",
     "lint": "eslint src",
     "clean": "rm -rf dist",