@aiready/pattern-detect 0.16.19 → 0.16.21

package/dist/cli.mjs

@@ -1,10 +1,10 @@
 #!/usr/bin/env node
-import "./chunk-UB3CGOQ7.mjs";
+import "./chunk-6JTVOBJX.mjs";
 import {
   analyzePatterns,
   generateSummary
-} from "./chunk-WMOGJFME.mjs";
-import "./chunk-THF4RW63.mjs";
+} from "./chunk-DNZS4ESD.mjs";
+import "./chunk-VGMM3L3O.mjs";
 import {
   filterBySeverity
 } from "./chunk-I6ETJC7L.mjs";
@@ -23,7 +23,9 @@ import {
   resolveOutputPath,
   Severity,
   getSeverityBadge as getSeverityBadge2,
-  getSeverityValue as getSeverityValue2
+  getSeverityValue as getSeverityValue2,
+  printTerminalHeader,
+  getTerminalDivider
 } from "@aiready/core";
 
 // src/cli-output.ts
@@ -32,6 +34,7 @@ import {
   getSeverityValue,
   generateReportHead,
   generateStatCards,
+  generateScoreCard,
   generateTable,
   generateReportFooter
 } from "@aiready/core";
@@ -52,10 +55,14 @@ function generateHTMLReport(results, summary) {
   const { metadata } = data;
   const s = data.summary;
   const head = generateReportHead("AIReady - Pattern Detection Report");
-  const scoreCard = `<div class="stat-card" style="margin-bottom: 2rem;">
-    <div class="stat-label">AI Ready Score (Deduplication)</div>
-    <div class="stat-value">${Math.max(0, 100 - Math.round((s.duplicates?.length || 0) / (s.totalFiles || 1) * 20))}%</div>
-  </div>`;
+  const score = Math.max(
+    0,
+    100 - Math.round((s.duplicates?.length || 0) / (s.totalFiles || 1) * 20)
+  );
+  const scoreCard = generateScoreCard(
+    `${score}%`,
+    "AI Ready Score (Deduplication)"
+  );
   const stats = generateStatCards([
     { value: s.totalFiles, label: "Files Analyzed" },
     { value: s.duplicates?.length || 0, label: "Duplicate Clusters" },
@@ -254,12 +261,7 @@ async function patternActionHandler(directory, options) {
 \u2713 HTML report saved to ${outputPath}`));
     return;
   }
-  const terminalWidth = process.stdout.columns || 80;
-  const dividerWidth = Math.min(60, terminalWidth - 2);
-  const divider = "\u2501".repeat(dividerWidth);
-  console.log(chalk.cyan(divider));
-  console.log(chalk.bold.white("  PATTERN ANALYSIS SUMMARY"));
-  console.log(chalk.cyan(divider) + "\n");
+  printTerminalHeader("PATTERN ANALYSIS SUMMARY");
   console.log(chalk.white(`\u{1F4C1} Files analyzed: ${chalk.bold(results.length)}`));
   console.log(
     chalk.yellow(
@@ -274,9 +276,9 @@ async function patternActionHandler(directory, options) {
   console.log(chalk.gray(`\u23F1  Analysis time: ${chalk.bold(elapsedTime + "s")}`));
   const sortedTypes = Object.entries(summary.patternsByType).filter(([, count]) => count > 0).sort(([, a], [, b]) => b - a);
   if (sortedTypes.length > 0) {
-    console.log(chalk.cyan("\n" + divider));
+    console.log("\n" + getTerminalDivider());
     console.log(chalk.bold.white("  PATTERNS BY TYPE"));
-    console.log(chalk.cyan(divider) + "\n");
+    console.log(getTerminalDivider() + "\n");
     sortedTypes.forEach(([type, count]) => {
       const icon = getPatternIcon(type);
       console.log(
@@ -285,11 +287,11 @@ async function patternActionHandler(directory, options) {
     });
   }
   if (!finalOptions.showRawDuplicates && groups && groups.length > 0) {
-    console.log(chalk.cyan("\n" + divider));
+    console.log("\n" + getTerminalDivider());
     console.log(
       chalk.bold.white(`  \u{1F4E6} DUPLICATE GROUPS (${groups.length} file pairs)`)
     );
-    console.log(chalk.cyan(divider) + "\n");
+    console.log(getTerminalDivider() + "\n");
     const topGroups = groups.sort((a, b) => {
       const bVal = getSeverityValue2(b.severity);
       const aVal = getSeverityValue2(a.severity);
@@ -330,11 +332,11 @@ async function patternActionHandler(directory, options) {
     }
   }
   if (!finalOptions.showRawDuplicates && clusters && clusters.length > 0) {
-    console.log(chalk.cyan("\n" + divider));
+    console.log("\n" + getTerminalDivider());
     console.log(
       chalk.bold.white(`  \u{1F3AF} REFACTOR CLUSTERS (${clusters.length} patterns)`)
     );
-    console.log(chalk.cyan(divider) + "\n");
+    console.log(getTerminalDivider() + "\n");
     clusters.sort((a, b) => b.totalTokenCost - a.totalTokenCost).forEach((cluster, idx) => {
       const severityBadge = getSeverityBadge2(cluster.severity);
       console.log(`${idx + 1}. ${severityBadge} ${chalk.bold(cluster.name)}`);
@@ -362,9 +364,9 @@ async function patternActionHandler(directory, options) {
     });
   }
   if (totalIssues > 0 && (finalOptions.showRawDuplicates || !groups || groups.length === 0)) {
-    console.log(chalk.cyan("\n" + divider));
+    console.log("\n" + getTerminalDivider());
     console.log(chalk.bold.white("  TOP DUPLICATE PATTERNS"));
-    console.log(chalk.cyan(divider) + "\n");
+    console.log(getTerminalDivider() + "\n");
     const topDuplicates = filteredDuplicates.sort((a, b) => {
       const bVal = getSeverityValue2(b.severity);
       const aVal = getSeverityValue2(a.severity);
@@ -411,9 +413,9 @@ async function patternActionHandler(directory, options) {
     (issue) => getSeverityValue2(issue.severity) === 4
   );
   if (criticalIssues.length > 0) {
-    console.log(chalk.cyan(divider));
+    console.log(getTerminalDivider());
     console.log(chalk.bold.white("  CRITICAL ISSUES (>95% similar)"));
-    console.log(chalk.cyan(divider) + "\n");
+    console.log(getTerminalDivider() + "\n");
     criticalIssues.slice(0, 5).forEach((issue) => {
       console.log(
         chalk.red("\u25CF ") + chalk.white(`${issue.file}:${issue.location.line}`)
@@ -450,7 +452,7 @@ async function patternActionHandler(directory, options) {
     );
     console.log("");
   }
-  console.log(chalk.cyan(divider));
+  console.log(getTerminalDivider());
   if (totalIssues > 0) {
     console.log(
       chalk.white(

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 };