@aiready/pattern-detect 0.16.20 → 0.16.22

package/dist/analyzer-entry/index.mjs

@@ -0,0 +1,12 @@
+import {
+  analyzePatterns,
+  generateSummary,
+  getSmartDefaults
+} from "../chunk-DNZS4ESD.mjs";
+import "../chunk-VGMM3L3O.mjs";
+import "../chunk-I6ETJC7L.mjs";
+export {
+  analyzePatterns,
+  generateSummary,
+  getSmartDefaults
+};

package/dist/analyzer-entry.d.mts

@@ -1,3 +1,100 @@
-export { P as PatternDetectOptions, a as PatternSummary, b as analyzePatterns, g as generateSummary, d as getSmartDefaults } from './analyzer-entry-BVz-HnZd.mjs';
-import '@aiready/core';
-import './types-DU2mmhwb.mjs';
+import { Severity, ScanOptions, AnalysisResult } from '@aiready/core';
+import { P as PatternType, a as DuplicatePattern } from './types-C4lmb2Yh.mjs';
+
+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;
+}
+
+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;
+
+export { type PatternDetectOptions, type PatternSummary, analyzePatterns, generateSummary, getSmartDefaults };

package/dist/analyzer-entry.d.ts

@@ -1,3 +1,100 @@
-export { P as PatternDetectOptions, a as PatternSummary, b as analyzePatterns, g as generateSummary, d as getSmartDefaults } from './analyzer-entry-BwuoiCNm.js';
-import '@aiready/core';
-import './types-DU2mmhwb.js';
+import { Severity, ScanOptions, AnalysisResult } from '@aiready/core';
+import { P as PatternType, a as DuplicatePattern } from './types-C4lmb2Yh.js';
+
+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;
+}
+
+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;
+
+export { type PatternDetectOptions, type PatternSummary, analyzePatterns, generateSummary, getSmartDefaults };

package/dist/context-rules-entry/index.d.mts

@@ -0,0 +1,2 @@
+export { a as ContextRule, c as calculateSeverity, f as filterBySeverity, g as getSeverityLabel, b as getSeverityThreshold } from '../index-y2uJSngh.mjs';
+import '@aiready/core';

package/dist/context-rules-entry/index.d.ts

@@ -0,0 +1,2 @@
+export { a as ContextRule, c as calculateSeverity, f as filterBySeverity, g as getSeverityLabel, b as getSeverityThreshold } from '../index-y2uJSngh.js';
+import '@aiready/core';

package/dist/context-rules-entry/index.js

@@ -0,0 +1,207 @@
+"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/context-rules-entry/index.ts
+var context_rules_entry_exports = {};
+__export(context_rules_entry_exports, {
+  calculateSeverity: () => calculateSeverity,
+  filterBySeverity: () => filterBySeverity,
+  getSeverityLabel: () => getSeverityLabel,
+  getSeverityThreshold: () => getSeverityThreshold
+});
+module.exports = __toCommonJS(context_rules_entry_exports);
+
+// src/context-rules.ts
+var import_core = require("@aiready/core");
+var CONTEXT_RULES = [
+  // Test Fixtures - Intentional duplication for test isolation
+  {
+    name: "test-fixtures",
+    detect: (file, code) => {
+      const isTestFile = file.includes(".test.") || file.includes(".spec.") || file.includes("__tests__") || file.includes("/test/") || file.includes("/tests/");
+      const hasTestFixtures = code.includes("beforeAll") || code.includes("afterAll") || code.includes("beforeEach") || code.includes("afterEach") || code.includes("setUp") || code.includes("tearDown");
+      return isTestFile && hasTestFixtures;
+    },
+    severity: import_core.Severity.Info,
+    reason: "Test fixture duplication is intentional for test isolation",
+    suggestion: "Consider if shared test setup would improve maintainability without coupling tests"
+  },
+  // Email/Document Templates - Often intentionally similar for consistency
+  {
+    name: "templates",
+    detect: (file, code) => {
+      const isTemplate = file.includes("/templates/") || file.includes("-template") || file.includes("/email-templates/") || file.includes("/emails/");
+      const hasTemplateContent = (code.includes("return") || code.includes("export")) && (code.includes("html") || code.includes("subject") || code.includes("body"));
+      return isTemplate && hasTemplateContent;
+    },
+    severity: import_core.Severity.Minor,
+    reason: "Template duplication may be intentional for maintainability and branding consistency",
+    suggestion: "Extract shared structure only if templates become hard to maintain"
+  },
+  // E2E/Integration Test Page Objects - Test independence
+  {
+    name: "e2e-page-objects",
+    detect: (file, code) => {
+      const isE2ETest = file.includes("e2e/") || file.includes("/e2e/") || file.includes(".e2e.") || file.includes("/playwright/") || file.includes("playwright/") || file.includes("/cypress/") || file.includes("cypress/") || file.includes("/integration/") || file.includes("integration/");
+      const hasPageObjectPatterns = code.includes("page.") || code.includes("await page") || code.includes("locator") || code.includes("getBy") || code.includes("selector") || code.includes("click(") || code.includes("fill(");
+      return isE2ETest && hasPageObjectPatterns;
+    },
+    severity: import_core.Severity.Minor,
+    reason: "E2E test duplication ensures test independence and reduces coupling",
+    suggestion: "Consider page object pattern only if duplication causes maintenance issues"
+  },
+  // Configuration Files - Often necessarily similar by design
+  {
+    name: "config-files",
+    detect: (file) => {
+      return file.endsWith(".config.ts") || file.endsWith(".config.js") || file.includes("jest.config") || file.includes("vite.config") || file.includes("webpack.config") || file.includes("rollup.config") || file.includes("tsconfig");
+    },
+    severity: import_core.Severity.Minor,
+    reason: "Configuration files often have similar structure by design",
+    suggestion: "Consider shared config base only if configurations become hard to maintain"
+  },
+  // Type Definitions - Duplication for type safety and module independence
+  {
+    name: "type-definitions",
+    detect: (file, code) => {
+      const isTypeFile = file.endsWith(".d.ts") || file.includes("/types/");
+      const hasTypeDefinitions = code.includes("interface ") || code.includes("type ") || code.includes("enum ");
+      return isTypeFile && hasTypeDefinitions;
+    },
+    severity: import_core.Severity.Info,
+    reason: "Type duplication may be intentional for module independence and type safety",
+    suggestion: "Extract to shared types package only if causing maintenance burden"
+  },
+  // Migration Scripts - One-off scripts that are similar by nature
+  {
+    name: "migration-scripts",
+    detect: (file) => {
+      return file.includes("/migrations/") || file.includes("/migrate/") || file.includes(".migration.");
+    },
+    severity: import_core.Severity.Info,
+    reason: "Migration scripts are typically one-off and intentionally similar",
+    suggestion: "Duplication is acceptable for migration scripts"
+  },
+  // Mock Data - Test data intentionally duplicated
+  {
+    name: "mock-data",
+    detect: (file, code) => {
+      const isMockFile = file.includes("/mocks/") || file.includes("/__mocks__/") || file.includes("/fixtures/") || file.includes(".mock.") || file.includes(".fixture.");
+      const hasMockData = code.includes("mock") || code.includes("Mock") || code.includes("fixture") || code.includes("stub") || code.includes("export const");
+      return isMockFile && hasMockData;
+    },
+    severity: import_core.Severity.Info,
+    reason: "Mock data duplication is expected for comprehensive test coverage",
+    suggestion: "Consider shared factories only for complex mock generation"
+  },
+  // Tool Implementations - Structural Boilerplate
+  {
+    name: "tool-implementations",
+    detect: (file, code) => {
+      const isToolFile = file.includes("/tools/") || file.endsWith(".tool.ts") || code.includes("toolDefinitions");
+      const hasToolStructure = code.includes("execute") && (code.includes("try") || code.includes("catch"));
+      return isToolFile && hasToolStructure;
+    },
+    severity: import_core.Severity.Info,
+    reason: "Tool implementations share structural boilerplate but have distinct business logic",
+    suggestion: "Tool duplication is acceptable for boilerplate interface wrappers"
+  }
+];
+function calculateSeverity(file1, file2, code, similarity, linesOfCode) {
+  for (const rule of CONTEXT_RULES) {
+    if (rule.detect(file1, code) || rule.detect(file2, code)) {
+      return {
+        severity: rule.severity,
+        reason: rule.reason,
+        suggestion: rule.suggestion,
+        matchedRule: rule.name
+      };
+    }
+  }
+  if (similarity >= 0.95 && linesOfCode >= 30) {
+    return {
+      severity: import_core.Severity.Critical,
+      reason: "Large nearly-identical code blocks waste tokens and create maintenance burden",
+      suggestion: "Extract to shared utility module immediately"
+    };
+  } else if (similarity >= 0.95 && linesOfCode >= 15) {
+    return {
+      severity: import_core.Severity.Major,
+      reason: "Nearly identical code should be consolidated",
+      suggestion: "Move to shared utility file"
+    };
+  } else if (similarity >= 0.85) {
+    return {
+      severity: import_core.Severity.Major,
+      reason: "High similarity indicates significant duplication",
+      suggestion: "Extract common logic to shared function"
+    };
+  } else if (similarity >= 0.7) {
+    return {
+      severity: import_core.Severity.Minor,
+      reason: "Moderate similarity detected",
+      suggestion: "Consider extracting shared patterns if code evolves together"
+    };
+  } else {
+    return {
+      severity: import_core.Severity.Minor,
+      reason: "Minor similarity detected",
+      suggestion: "Monitor but refactoring may not be worthwhile"
+    };
+  }
+}
+function getSeverityLabel(severity) {
+  const labels = {
+    [import_core.Severity.Critical]: "\u{1F534} CRITICAL",
+    [import_core.Severity.Major]: "\u{1F7E1} MAJOR",
+    [import_core.Severity.Minor]: "\u{1F535} MINOR",
+    [import_core.Severity.Info]: "\u2139\uFE0F  INFO"
+  };
+  return labels[severity];
+}
+function filterBySeverity(duplicates, minSeverity) {
+  const severityOrder = [
+    import_core.Severity.Info,
+    import_core.Severity.Minor,
+    import_core.Severity.Major,
+    import_core.Severity.Critical
+  ];
+  const minIndex = severityOrder.indexOf(minSeverity);
+  if (minIndex === -1) return duplicates;
+  return duplicates.filter((dup) => {
+    const dupIndex = severityOrder.indexOf(dup.severity);
+    return dupIndex >= minIndex;
+  });
+}
+function getSeverityThreshold(severity) {
+  const thresholds = {
+    [import_core.Severity.Critical]: 0.95,
+    [import_core.Severity.Major]: 0.85,
+    [import_core.Severity.Minor]: 0.5,
+    [import_core.Severity.Info]: 0
+  };
+  return thresholds[severity] || 0;
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  calculateSeverity,
+  filterBySeverity,
+  getSeverityLabel,
+  getSeverityThreshold
+});

package/dist/context-rules-entry/index.mjs

@@ -0,0 +1,12 @@
+import {
+  calculateSeverity,
+  filterBySeverity,
+  getSeverityLabel,
+  getSeverityThreshold
+} from "../chunk-I6ETJC7L.mjs";
+export {
+  calculateSeverity,
+  filterBySeverity,
+  getSeverityLabel,
+  getSeverityThreshold
+};

package/dist/context-rules-entry.d.mts

@@ -1,2 +1,55 @@
-export { a as ContextRule, c as calculateSeverity, f as filterBySeverity, g as getSeverityLabel, b as getSeverityThreshold } from './context-rules-entry-y2uJSngh.mjs';
-import '@aiready/core';
+import { Severity } from '@aiready/core';
+
+/**
+ * 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;
+}
+/**
+ * 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 { type ContextRule, calculateSeverity, filterBySeverity, getSeverityLabel, getSeverityThreshold };

package/dist/context-rules-entry.d.ts

@@ -1,2 +1,55 @@
-export { a as ContextRule, c as calculateSeverity, f as filterBySeverity, g as getSeverityLabel, b as getSeverityThreshold } from './context-rules-entry-y2uJSngh.js';
-import '@aiready/core';
+import { Severity } from '@aiready/core';
+
+/**
+ * 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;
+}
+/**
+ * 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 { type ContextRule, calculateSeverity, filterBySeverity, getSeverityLabel, getSeverityThreshold };

package/dist/detector-entry/index.d.mts

@@ -0,0 +1,14 @@
+import { a as DetectionOptions, D as DuplicatePattern } from '../types-DU2mmhwb.mjs';
+export { P as PatternType } from '../types-DU2mmhwb.mjs';
+import { FileContent } from '@aiready/core';
+
+/**
+ * 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[]>;
+
+export { DuplicatePattern, detectDuplicatePatterns };

package/dist/detector-entry/index.d.ts

@@ -0,0 +1,14 @@
+import { a as DetectionOptions, D as DuplicatePattern } from '../types-DU2mmhwb.js';
+export { P as PatternType } from '../types-DU2mmhwb.js';
+import { FileContent } from '@aiready/core';
+
+/**
+ * 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[]>;
+
+export { DuplicatePattern, detectDuplicatePatterns };