@aiready/pattern-detect 0.17.8 → 0.17.12

package/dist/index.js

@@ -30,38 +30,41 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 // src/index.ts
 var index_exports = {};
 __export(index_exports, {
-  CONTEXT_RULES: () => CONTEXT_RULES,
-  IssueType: () => import_core.IssueType,
-  PatternDetectProvider: () => PatternDetectProvider,
-  Severity: () => import_core7.Severity,
+  PATTERN_DETECT_PROVIDER: () => PATTERN_DETECT_PROVIDER,
+  Severity: () => import_core11.Severity,
   analyzePatterns: () => analyzePatterns,
+  areBrandSpecificVariants: () => areBrandSpecificVariants,
   calculatePatternScore: () => calculatePatternScore,
-  calculateSeverity: () => calculateSeverity,
+  calculateSeverity: () => calculateSeverity2,
   createRefactorClusters: () => createRefactorClusters,
   detectDuplicatePatterns: () => detectDuplicatePatterns,
-  filterBySeverity: () => import_core.filterBySeverity,
+  filterBrandSpecificVariants: () => filterBrandSpecificVariants,
+  filterBySeverity: () => filterBySeverity2,
   filterClustersByImpact: () => filterClustersByImpact,
   generateSummary: () => generateSummary,
-  getSeverityLabel: () => import_core.getSeverityLabel,
-  getSeverityThreshold: () => getSeverityThreshold,
+  getSeverityLabel: () => getSeverityLabel2,
   getSmartDefaults: () => getSmartDefaults,
-  groupDuplicatesByFilePair: () => groupDuplicatesByFilePair
+  groupDuplicatesByFilePair: () => groupDuplicatesByFilePair,
+  logConfiguration: () => logConfiguration
 });
 module.exports = __toCommonJS(index_exports);
-var import_core7 = require("@aiready/core");
+var import_core13 = require("@aiready/core");
 
 // src/provider.ts
-var import_core6 = require("@aiready/core");
+var import_core12 = require("@aiready/core");
 
 // src/analyzer.ts
-var import_core4 = require("@aiready/core");
+var import_core11 = require("@aiready/core");
 
 // src/detector.ts
-var import_core2 = require("@aiready/core");
+var import_core6 = require("@aiready/core");
 
 // src/context-rules.ts
+var import_core5 = require("@aiready/core");
+
+// src/rules/categories/test-rules.ts
 var import_core = require("@aiready/core");
-var CONTEXT_RULES = [
+var TEST_RULES = [
   // Test Fixtures - Intentional duplication for test isolation
   {
     name: "test-fixtures",
@@ -74,6 +77,35 @@ var CONTEXT_RULES = [
     reason: "Test fixture duplication is intentional for test isolation",
     suggestion: "Consider if shared test setup would improve maintainability without coupling tests"
   },
+  // 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.Info,
+    reason: "E2E test duplication ensures test independence and reduces coupling",
+    suggestion: "Consider page object pattern only if duplication causes maintenance issues"
+  },
+  // 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"
+  }
+];
+
+// src/rules/categories/web-rules.ts
+var import_core2 = require("@aiready/core");
+var WEB_RULES = [
   // Email/Document Templates - Often intentionally similar for consistency
   {
     name: "templates",
@@ -82,66 +114,59 @@ var CONTEXT_RULES = [
       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,
+    severity: import_core2.Severity.Info,
     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
+  // Common UI Event Handlers - Very specific patterns only
   {
-    name: "e2e-page-objects",
+    name: "common-ui-handlers",
     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;
+      const isUIFile = file.includes("/components/") || file.includes(".tsx") || file.includes(".jsx") || file.includes("/hooks/");
+      const hasCommonHandler = code.includes("handleClickOutside") && code.includes("dropdownRef.current") && code.includes("!dropdownRef.current.contains") || code.includes("handleEscape") && code.includes("event.key") && code.includes("=== 'Escape'") || code.includes("handleClickInside") && code.includes("event.stopPropagation");
+      return isUIFile && hasCommonHandler;
     },
-    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"
+    severity: import_core2.Severity.Info,
+    reason: "Common UI event handlers are boilerplate patterns that repeat across components",
+    suggestion: "Consider extracting to shared hooks (useClickOutside, useEscapeKey) only if causing maintenance issues"
   },
+  // Next.js Route Handler Patterns - Boilerplate API route patterns
+  {
+    name: "nextjs-route-handlers",
+    detect: (file, code) => {
+      const isRouteFile = file.includes("/api/") && (file.endsWith("/route.ts") || file.endsWith("/route.js"));
+      const hasRoutePattern = code.includes("export async function POST") || code.includes("export async function GET") || code.includes("export async function PUT") || code.includes("export async function DELETE") || code.includes("NextResponse.json") || code.includes("NextRequest");
+      return isRouteFile && hasRoutePattern;
+    },
+    severity: import_core2.Severity.Info,
+    reason: "Next.js route handlers follow standard patterns and are intentionally similar across endpoints",
+    suggestion: "Route handler duplication is acceptable for API endpoint boilerplate"
+  }
+];
+
+// src/rules/categories/infra-rules.ts
+var import_core3 = require("@aiready/core");
+var INFRA_RULES = [
   // 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,
+    severity: import_core3.Severity.Info,
     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,
+    severity: import_core3.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",
@@ -150,11 +175,132 @@ var CONTEXT_RULES = [
       const hasToolStructure = code.includes("execute") && (code.includes("try") || code.includes("catch"));
       return isToolFile && hasToolStructure;
     },
-    severity: import_core.Severity.Info,
+    severity: import_core3.Severity.Info,
     reason: "Tool implementations share structural boilerplate but have distinct business logic",
     suggestion: "Tool duplication is acceptable for boilerplate interface wrappers"
+  },
+  // CLI Command Definitions - Commander.js boilerplate patterns
+  {
+    name: "cli-command-definitions",
+    detect: (file, code) => {
+      const isCliFile = file.includes("/commands/") || file.includes("/cli/") || file.endsWith(".command.ts");
+      const hasCommandPattern = (code.includes(".command(") || code.includes("defineCommand")) && (code.includes(".description(") || code.includes(".option(")) && (code.includes(".action(") || code.includes("async"));
+      return isCliFile && hasCommandPattern;
+    },
+    severity: import_core3.Severity.Info,
+    reason: "CLI command definitions follow standard Commander.js patterns and are intentionally similar",
+    suggestion: "Command boilerplate duplication is acceptable for CLI interfaces"
+  }
+];
+
+// src/rules/categories/logic-rules.ts
+var import_core4 = require("@aiready/core");
+var LOGIC_RULES = [
+  // 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 hasOnlyTypeDefinitions = (code.includes("interface ") || code.includes("type ") || code.includes("enum ")) && !code.includes("function ") && !code.includes("class ") && !code.includes("const ") && !code.includes("let ") && !code.includes("export default");
+      const isInterfaceOnlySnippet = code.trim().startsWith("interface ") && code.includes("{") && code.includes("}") && !code.includes("function ") && !code.includes("const ") && !code.includes("return ");
+      return isTypeFile && hasOnlyTypeDefinitions || isInterfaceOnlySnippet;
+    },
+    severity: import_core4.Severity.Info,
+    reason: "Type/interface definitions are intentionally duplicated for module independence",
+    suggestion: "Extract to shared types package only if causing maintenance burden"
+  },
+  // Utility Functions - Small helpers in dedicated utility files
+  {
+    name: "utility-functions",
+    detect: (file, code) => {
+      const isUtilFile = file.endsWith(".util.ts") || file.endsWith(".helper.ts") || file.endsWith(".utils.ts");
+      const hasUtilPattern = code.includes("function format") || code.includes("function parse") || code.includes("function sanitize") || code.includes("function normalize") || code.includes("function convert");
+      return isUtilFile && hasUtilPattern;
+    },
+    severity: import_core4.Severity.Info,
+    reason: "Utility functions in dedicated utility files may be intentionally similar",
+    suggestion: "Consider extracting to shared utilities only if causing significant duplication"
+  },
+  // React/Vue Hooks - Standard patterns
+  {
+    name: "shared-hooks",
+    detect: (file, code) => {
+      const isHookFile = file.includes("/hooks/") || file.endsWith(".hook.ts") || file.endsWith(".hook.tsx");
+      const hasHookPattern = code.includes("function use") || code.includes("export function use") || code.includes("const use") || code.includes("export const use");
+      return isHookFile && hasHookPattern;
+    },
+    severity: import_core4.Severity.Info,
+    reason: "Hooks follow standard patterns and are often intentionally similar across components",
+    suggestion: "Consider extracting common hook logic only if hooks become complex"
+  },
+  // Score/Rating Helper Functions - Common threshold patterns
+  {
+    name: "score-helpers",
+    detect: (file, code) => {
+      const isHelperFile = file.includes("/utils/") || file.includes("/helpers/") || file.endsWith(".util.ts");
+      const hasScorePattern = (code.includes("if (score >=") || code.includes("if (score >")) && code.includes("return") && code.includes("'") && code.split("if (score").length >= 3;
+      return isHelperFile && hasScorePattern;
+    },
+    severity: import_core4.Severity.Info,
+    reason: "Score/rating helper functions use common threshold patterns that are intentionally similar",
+    suggestion: "Score formatting duplication is acceptable for consistent UI display"
+  },
+  // D3/Canvas Event Handlers - Standard visualization patterns
+  {
+    name: "visualization-handlers",
+    detect: (file, code) => {
+      const isVizFile = file.includes("/visualizer/") || file.includes("/charts/") || file.includes("GraphCanvas") || file.includes("ForceDirected");
+      const hasVizPattern = (code.includes("dragstarted") || code.includes("dragged") || code.includes("dragended")) && (code.includes("simulation") || code.includes("d3.") || code.includes("alphaTarget"));
+      return isVizFile && hasVizPattern;
+    },
+    severity: import_core4.Severity.Info,
+    reason: "D3/visualization event handlers follow standard patterns and are intentionally similar",
+    suggestion: "Visualization boilerplate duplication is acceptable for interactive charts"
+  },
+  // Icon/Switch Statement Helpers - Common enum-to-value patterns
+  {
+    name: "switch-helpers",
+    detect: (file, code) => {
+      const hasSwitchPattern = code.includes("switch (") && code.includes("case '") && code.includes("return") && code.split("case ").length >= 4;
+      const hasIconPattern = code.includes("getIcon") || code.includes("getColor") || code.includes("getLabel") || code.includes("getRating");
+      return hasSwitchPattern && hasIconPattern;
+    },
+    severity: import_core4.Severity.Info,
+    reason: "Switch statement helpers for enum-to-value mapping are inherently similar",
+    suggestion: "Switch duplication is acceptable for mapping enums to display values"
+  },
+  // Common API/Utility Functions - Legitimate duplication across modules
+  {
+    name: "common-api-functions",
+    detect: (file, code) => {
+      const isApiFile = file.includes("/api/") || file.includes("/lib/") || file.includes("/utils/") || file.endsWith(".ts");
+      const hasCommonApiPattern = code.includes("getStripe") && code.includes("process.env.STRIPE_SECRET_KEY") || code.includes("getUserByEmail") && code.includes("queryItems") || code.includes("updateUser") && code.includes("buildUpdateExpression") || code.includes("listUserRepositories") && code.includes("queryItems") || code.includes("listTeamRepositories") && code.includes("queryItems") || code.includes("getRemediation") && code.includes("queryItems") || code.includes("formatBreakdownKey") && code.includes(".replace(/([A-Z])/g") || code.includes("queryItems") && code.includes("KeyConditionExpression") || code.includes("putItem") && code.includes("createdAt") || code.includes("updateItem") && code.includes("buildUpdateExpression");
+      return isApiFile && hasCommonApiPattern;
+    },
+    severity: import_core4.Severity.Info,
+    reason: "Common API/utility functions are legitimately duplicated across modules for clarity and independence",
+    suggestion: "Consider extracting to shared utilities only if causing significant duplication"
+  },
+  // Validation Functions - Inherently similar patterns
+  {
+    name: "validation-functions",
+    detect: (file, code) => {
+      const hasValidationPattern = code.includes("isValid") || code.includes("validate") || code.includes("checkValid") || code.includes("isEmail") || code.includes("isPhone") || code.includes("isUrl") || code.includes("isNumeric") || code.includes("isAlpha") || code.includes("isAlphanumeric") || code.includes("isEmpty") || code.includes("isNotEmpty") || code.includes("isRequired") || code.includes("isOptional");
+      return hasValidationPattern;
+    },
+    severity: import_core4.Severity.Info,
+    reason: "Validation functions are inherently similar and often intentionally duplicated for domain clarity",
+    suggestion: "Consider extracting to shared validators only if validation logic becomes complex"
   }
 ];
+
+// src/context-rules.ts
+var CONTEXT_RULES = [
+  ...TEST_RULES,
+  ...WEB_RULES,
+  ...INFRA_RULES,
+  ...LOGIC_RULES
+];
 function calculateSeverity(file1, file2, code, similarity, linesOfCode) {
   for (const rule of CONTEXT_RULES) {
     if (rule.detect(file1, code) || rule.detect(file2, code)) {
@@ -168,45 +314,36 @@ function calculateSeverity(file1, file2, code, similarity, linesOfCode) {
   }
   if (similarity >= 0.95 && linesOfCode >= 30) {
     return {
-      severity: import_core.Severity.Critical,
+      severity: import_core5.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,
+      severity: import_core5.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,
+      severity: import_core5.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,
+      severity: import_core5.Severity.Minor,
       reason: "Moderate similarity detected",
       suggestion: "Consider extracting shared patterns if code evolves together"
     };
   } else {
     return {
-      severity: import_core.Severity.Minor,
+      severity: import_core5.Severity.Minor,
       reason: "Minor similarity detected",
       suggestion: "Monitor but refactoring may not be worthwhile"
     };
   }
 }
-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;
-}
 
 // src/core/normalizer.ts
 function normalizeCode(code, isPython = false) {
@@ -222,13 +359,13 @@ function normalizeCode(code, isPython = false) {
 
 // src/detector.ts
 function extractBlocks(file, content) {
-  return (0, import_core2.extractCodeBlocks)(file, content);
+  return (0, import_core6.extractCodeBlocks)(file, content);
 }
 function calculateSimilarity(a, b) {
-  return (0, import_core2.calculateStringSimilarity)(a, b);
+  return (0, import_core6.calculateStringSimilarity)(a, b);
 }
 function calculateConfidence(similarity, tokens, lines) {
-  return (0, import_core2.calculateHeuristicConfidence)(similarity, tokens, lines);
+  return (0, import_core6.calculateHeuristicConfidence)(similarity, tokens, lines);
 }
 async function detectDuplicatePatterns(fileContents, options) {
   const {
@@ -338,7 +475,7 @@ async function detectDuplicatePatterns(fileContents, options) {
 }
 
 // src/grouping.ts
-var import_core3 = require("@aiready/core");
+var import_core7 = require("@aiready/core");
 var import_path = __toESM(require("path"));
 function groupDuplicatesByFilePair(duplicates) {
   const groups = /* @__PURE__ */ new Map();
@@ -366,7 +503,7 @@ function groupDuplicatesByFilePair(duplicates) {
       file2: { start: dup.line2, end: dup.endLine2 }
     });
     const currentSev = dup.severity;
-    if ((0, import_core3.getSeverityLevel)(currentSev) > (0, import_core3.getSeverityLevel)(group.severity)) {
+    if ((0, import_core7.getSeverityLevel)(currentSev) > (0, import_core7.getSeverityLevel)(group.severity)) {
       group.severity = currentSev;
     }
   }
@@ -456,21 +593,77 @@ function filterClustersByImpact(clusters, minTokenCost = 1e3, minFiles = 3) {
     (c) => c.totalTokenCost >= minTokenCost && c.files.length >= minFiles
   );
 }
-
-// src/analyzer.ts
-function getRefactoringSuggestion(patternType, similarity) {
-  const baseMessages = {
-    "api-handler": "Extract common middleware or create a base handler class",
-    validator: "Consolidate validation logic into shared schema validators (Zod/Yup)",
-    utility: "Move to a shared utilities file and reuse across modules",
-    "class-method": "Consider inheritance or composition to share behavior",
-    component: "Extract shared logic into a custom hook or HOC",
-    function: "Extract into a shared helper function",
-    unknown: "Extract common logic into a reusable module"
-  };
-  const urgency = similarity > 0.95 ? " (CRITICAL: Nearly identical code)" : similarity > 0.9 ? " (HIGH: Very similar, refactor soon)" : "";
-  return baseMessages[patternType] + urgency;
+function isPureInterfaceDefinition(code) {
+  const trimmed = code.trim();
+  if (!trimmed.startsWith("interface ") && !trimmed.startsWith("type ") && !trimmed.startsWith("export interface ") && !trimmed.startsWith("export type ") && !trimmed.startsWith("enum ") && !trimmed.startsWith("export enum ")) {
+    return false;
+  }
+  if (trimmed.includes("={") || trimmed.includes("=> {") || trimmed.includes("function ") || trimmed.includes("() {") || trimmed.includes(" implements ")) {
+    return false;
+  }
+  if (trimmed.length > 200) return false;
+  return true;
+}
+var BRAND_INDICATORS = [
+  "cyberpunk",
+  "cyber-blue",
+  "cyber-purple",
+  "slate-900",
+  "slate-400",
+  "zinc-",
+  "indigo-",
+  "neon-",
+  "glassmorphism",
+  "backdrop-blur"
+];
+function isBrandSpecificComponent(filePath) {
+  const lower = filePath.toLowerCase();
+  const brandingTerms = ["landing", "clawmore", "platform", "apps/"];
+  for (const term of brandingTerms) {
+    if (lower.includes(term)) return true;
+  }
+  return false;
+}
+function areBrandSpecificVariants(file1, file2, code1, code2) {
+  const f1IsBrand = isBrandSpecificComponent(file1);
+  const f2IsBrand = isBrandSpecificComponent(file2);
+  if (f1IsBrand && f2IsBrand && file1 !== file2) {
+    const hasBrandKeyword = (code) => {
+      const lowerCode = code.toLowerCase();
+      return BRAND_INDICATORS.some((ind) => lowerCode.includes(ind));
+    };
+    const code1Brand = hasBrandKeyword(code1);
+    const code2Brand = hasBrandKeyword(code2);
+    if (code1Brand && code2Brand) {
+      return true;
+    }
+  }
+  return false;
 }
+function filterBrandSpecificVariants(duplicates) {
+  return duplicates.filter((dup) => {
+    if (dup.file1 === dup.file2) return true;
+    const isBrandVariant = areBrandSpecificVariants(
+      dup.file1,
+      dup.file2,
+      dup.code1,
+      dup.code2
+    );
+    if (isBrandVariant) {
+      dup.severity = import_core7.Severity.Info;
+      dup.suggestion = "Brand-specific themed component variant (intentional)";
+    }
+    const isInterfaceDef = isPureInterfaceDefinition(dup.code1) && isPureInterfaceDefinition(dup.code2);
+    if (isInterfaceDef) {
+      dup.severity = import_core7.Severity.Info;
+      dup.suggestion = "Pure interface/type definition - intentional for module independence";
+    }
+    return true;
+  });
+}
+
+// src/config.ts
+var import_core8 = require("@aiready/core");
 async function getSmartDefaults(directory, userOptions) {
   if (userOptions.useSmartDefaults === false) {
     return {
@@ -491,7 +684,7 @@ async function getSmartDefaults(directory, userOptions) {
     include: userOptions.include || ["**/*.{ts,tsx,js,jsx,py,java}"],
     exclude: userOptions.exclude
   };
-  const files = await (0, import_core4.scanFiles)(scanOptions);
+  const files = await (0, import_core8.scanFiles)(scanOptions);
   const fileCount = files.length;
   const estimatedBlocks = fileCount * 5;
   const minLines = Math.max(
@@ -549,113 +742,21 @@ function logConfiguration(config, estimatedBlocks) {
   }
   console.log("");
 }
-async function analyzePatterns(options) {
-  const smartDefaults = await getSmartDefaults(options.rootDir || ".", options);
-  const finalOptions = { ...smartDefaults, ...options };
-  const {
-    minSimilarity = 0.4,
-    minLines = 5,
-    batchSize = 100,
-    approx = true,
-    minSharedTokens = 8,
-    maxCandidatesPerBlock = 100,
-    streamResults = false,
-    severity = "all",
-    groupByFilePair = true,
-    createClusters = true,
-    minClusterTokenCost = 1e3,
-    minClusterFiles = 3,
-    excludePatterns = [],
-    confidenceThreshold = 0,
-    ignoreWhitelist = [],
-    ...scanOptions
-  } = finalOptions;
-  const files = await (0, import_core4.scanFiles)(scanOptions);
-  const estimatedBlocks = files.length * 3;
-  logConfiguration(finalOptions, estimatedBlocks);
-  const results = [];
-  const READ_BATCH_SIZE = 50;
-  const fileContents = [];
-  for (let i = 0; i < files.length; i += READ_BATCH_SIZE) {
-    const batch = files.slice(i, i + READ_BATCH_SIZE);
-    const batchContents = await Promise.all(
-      batch.map(async (file) => ({
-        file,
-        content: await (0, import_core4.readFileContent)(file)
-      }))
-    );
-    fileContents.push(...batchContents);
-  }
-  const duplicates = await detectDuplicatePatterns(fileContents, {
-    minSimilarity,
-    minLines,
-    batchSize,
-    approx,
-    minSharedTokens,
-    maxCandidatesPerBlock,
-    streamResults,
-    excludePatterns,
-    confidenceThreshold,
-    ignoreWhitelist,
-    onProgress: options.onProgress
-  });
-  for (const file of files) {
-    const fileDuplicates = duplicates.filter(
-      (dup) => dup.file1 === file || dup.file2 === file
-    );
-    const issues = fileDuplicates.map((dup) => {
-      const otherFile = dup.file1 === file ? dup.file2 : dup.file1;
-      const severity2 = dup.similarity > 0.95 ? import_core4.Severity.Critical : dup.similarity > 0.9 ? import_core4.Severity.Major : import_core4.Severity.Minor;
-      return {
-        type: import_core4.IssueType.DuplicatePattern,
-        severity: severity2,
-        message: `${dup.patternType} pattern ${Math.round(dup.similarity * 100)}% similar to ${otherFile} (${dup.tokenCost} tokens wasted)`,
-        location: {
-          file,
-          line: dup.file1 === file ? dup.line1 : dup.line2
-        },
-        suggestion: getRefactoringSuggestion(dup.patternType, dup.similarity)
-      };
-    });
-    let filteredIssues = issues;
-    if (severity !== "all") {
-      const severityMap = {
-        critical: [import_core4.Severity.Critical],
-        high: [import_core4.Severity.Critical, import_core4.Severity.Major],
-        medium: [import_core4.Severity.Critical, import_core4.Severity.Major, import_core4.Severity.Minor]
-      };
-      const allowedSeverities = severityMap[severity] || [import_core4.Severity.Critical, import_core4.Severity.Major, import_core4.Severity.Minor];
-      filteredIssues = issues.filter(
-        (issue) => allowedSeverities.includes(issue.severity)
-      );
-    }
-    const totalTokenCost = fileDuplicates.reduce(
-      (sum, dup) => sum + dup.tokenCost,
-      0
-    );
-    results.push({
-      fileName: file,
-      issues: filteredIssues,
-      metrics: {
-        tokenCost: totalTokenCost,
-        consistencyScore: Math.max(0, 1 - fileDuplicates.length * 0.1)
-      }
-    });
-  }
-  let groups;
-  let clusters;
-  if (groupByFilePair) {
-    groups = groupDuplicatesByFilePair(duplicates);
-  }
-  if (createClusters) {
-    const allClusters = createRefactorClusters(duplicates);
-    clusters = filterClustersByImpact(
-      allClusters,
-      minClusterTokenCost,
-      minClusterFiles
-    );
-  }
-  return { results, duplicates, files, groups, clusters, config: finalOptions };
+
+// src/summary.ts
+var import_core9 = require("@aiready/core");
+function getRefactoringSuggestion(patternType, similarity) {
+  const baseMessages = {
+    "api-handler": "Extract common middleware or create a base handler class",
+    validator: "Consolidate validation logic into shared schema validators (Zod/Yup)",
+    utility: "Move to a shared utilities file and reuse across modules",
+    "class-method": "Consider inheritance or composition to share behavior",
+    component: "Extract shared logic into a custom hook or HOC",
+    function: "Extract into a shared helper function",
+    unknown: "Extract common logic into a reusable module"
+  };
+  const urgency = similarity > 0.95 ? " (CRITICAL: Nearly identical code)" : similarity > 0.9 ? " (HIGH: Very similar, refactor soon)" : "";
+  return baseMessages[patternType] + urgency;
 }
 function generateSummary(results) {
   const allIssues = results.flatMap((r) => r.issues || []);
@@ -675,7 +776,7 @@ function generateSummary(results) {
   allIssues.forEach((issue) => {
     const match = issue.message.match(/^(\S+(?:-\S+)*) pattern/);
     if (match) {
-      const type = match[1];
+      const type = match[1] || "unknown";
       patternsByType[type] = (patternsByType[type] || 0) + 1;
     }
   });
@@ -698,8 +799,6 @@ function generateSummary(results) {
         }
       ],
       similarity: similarityMatch ? parseInt(similarityMatch[1]) / 100 : 0,
-      confidence: similarityMatch ? parseInt(similarityMatch[1]) / 100 : 0,
-      // Fallback for summary
       patternType: typeMatch?.[1] || "unknown",
       tokenCost: tokenMatch ? parseInt(tokenMatch[1]) : 0
     };
@@ -711,18 +810,55 @@ function generateSummary(results) {
     topDuplicates
   };
 }
+function filterBySeverity2(issues, severity) {
+  if (severity === "all") return issues;
+  const severityMap = {
+    critical: [import_core9.Severity.Critical],
+    high: [import_core9.Severity.Critical, import_core9.Severity.Major],
+    medium: [import_core9.Severity.Critical, import_core9.Severity.Major, import_core9.Severity.Minor]
+  };
+  const allowed = severityMap[severity] || [
+    import_core9.Severity.Critical,
+    import_core9.Severity.Major,
+    import_core9.Severity.Minor
+  ];
+  return issues.filter((issue) => allowed.includes(issue.severity));
+}
+function getSeverityLabel2(severity) {
+  switch (severity) {
+    case import_core9.Severity.Critical:
+      return "CRITICAL";
+    case import_core9.Severity.Major:
+      return "HIGH";
+    case import_core9.Severity.Minor:
+      return "MEDIUM";
+    case import_core9.Severity.Info:
+      return "LOW";
+    default:
+      return "UNKNOWN";
+  }
+}
+function calculateSeverity2(similarity) {
+  if (similarity > 0.95) return import_core9.Severity.Critical;
+  if (similarity > 0.9) return import_core9.Severity.Major;
+  return import_core9.Severity.Minor;
+}
 
 // src/scoring.ts
-var import_core5 = require("@aiready/core");
+var import_core10 = 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(
+  const actionableDuplicates = duplicates.filter((d) => d.severity !== "info");
+  const totalDuplicates = actionableDuplicates.length;
+  const totalTokenCost = actionableDuplicates.reduce(
+    (sum, d) => sum + d.tokenCost,
+    0
+  );
+  const highImpactDuplicates = actionableDuplicates.filter(
     (d) => d.tokenCost > 1e3 || d.similarity > 0.7
   ).length;
   if (totalFilesAnalyzed === 0) {
     return {
-      toolName: import_core5.ToolName.PatternDetect,
+      toolName: import_core10.ToolName.PatternDetect,
       score: 100,
       rawMetrics: {
         totalDuplicates: 0,
@@ -791,12 +927,12 @@ function calculatePatternScore(duplicates, totalFilesAnalyzed, costConfig) {
       priority: totalTokenCost > 1e4 ? "high" : "medium"
     });
   }
-  const cfg = { ...import_core5.DEFAULT_COST_CONFIG, ...costConfig };
-  const estimatedMonthlyCost = (0, import_core5.calculateMonthlyCost)(totalTokenCost, cfg);
+  const cfg = { ...import_core10.DEFAULT_COST_CONFIG, ...costConfig };
+  const estimatedMonthlyCost = (0, import_core10.calculateMonthlyCost)(totalTokenCost, cfg);
   const issues = duplicates.map((d) => ({
     severity: d.severity === "critical" ? "critical" : d.severity === "major" ? "major" : "minor"
   }));
-  const productivityImpact = (0, import_core5.calculateProductivityImpact)(issues);
+  const productivityImpact = (0, import_core10.calculateProductivityImpact)(issues);
   return {
     toolName: "pattern-detect",
     score: finalScore,
@@ -816,13 +952,118 @@ function calculatePatternScore(duplicates, totalFilesAnalyzed, costConfig) {
   };
 }
 
+// src/analyzer.ts
+async function analyzePatterns(options) {
+  const smartDefaults = await getSmartDefaults(options.rootDir || ".", options);
+  const finalOptions = { ...smartDefaults, ...options };
+  const {
+    minSimilarity = 0.4,
+    minLines = 5,
+    batchSize = 100,
+    approx = true,
+    minSharedTokens = 8,
+    maxCandidatesPerBlock = 100,
+    streamResults = false,
+    severity = "all",
+    groupByFilePair = true,
+    createClusters = true,
+    minClusterTokenCost = 1e3,
+    minClusterFiles = 3,
+    excludePatterns = [],
+    confidenceThreshold = 0,
+    ignoreWhitelist = [],
+    ...scanOptions
+  } = finalOptions;
+  const files = await (0, import_core11.scanFiles)(scanOptions);
+  const estimatedBlocks = files.length * 3;
+  logConfiguration(finalOptions, estimatedBlocks);
+  const results = [];
+  const READ_BATCH_SIZE = 50;
+  const fileContents = [];
+  for (let i = 0; i < files.length; i += READ_BATCH_SIZE) {
+    const batch = files.slice(i, i + READ_BATCH_SIZE);
+    const batchContents = await Promise.all(
+      batch.map(async (file) => ({
+        file,
+        content: await (0, import_core11.readFileContent)(file)
+      }))
+    );
+    fileContents.push(...batchContents);
+  }
+  const duplicates = await detectDuplicatePatterns(fileContents, {
+    minSimilarity,
+    minLines,
+    batchSize,
+    approx,
+    minSharedTokens,
+    maxCandidatesPerBlock,
+    streamResults,
+    excludePatterns,
+    confidenceThreshold,
+    ignoreWhitelist,
+    onProgress: options.onProgress
+  });
+  filterBrandSpecificVariants(duplicates);
+  for (const file of files) {
+    const fileDuplicates = duplicates.filter(
+      (dup) => dup.file1 === file || dup.file2 === file
+    );
+    const issues = fileDuplicates.map((dup) => {
+      const otherFile = dup.file1 === file ? dup.file2 : dup.file1;
+      let severityLevel;
+      if (dup.severity === "info" || dup.severity === "Info") {
+        severityLevel = import_core11.Severity.Info;
+      } else {
+        severityLevel = calculateSeverity2(dup.similarity);
+      }
+      return {
+        type: import_core11.IssueType.DuplicatePattern,
+        severity: severityLevel,
+        message: `${dup.patternType} pattern ${Math.round(dup.similarity * 100)}% similar to ${otherFile} (${dup.tokenCost} tokens wasted)`,
+        location: {
+          file,
+          line: dup.file1 === file ? dup.line1 : dup.line2
+        },
+        suggestion: getRefactoringSuggestion(dup.patternType, dup.similarity)
+      };
+    });
+    const filteredIssues = filterBySeverity2(issues, severity || "all");
+    const totalTokenCost = fileDuplicates.reduce(
+      (sum, dup) => sum + dup.tokenCost,
+      0
+    );
+    results.push({
+      fileName: file,
+      issues: filteredIssues,
+      metrics: {
+        tokenCost: totalTokenCost,
+        consistencyScore: Math.max(0, 1 - fileDuplicates.length * 0.1)
+      }
+    });
+  }
+  let groups;
+  let clusters;
+  if (groupByFilePair) {
+    groups = groupDuplicatesByFilePair(duplicates);
+  }
+  if (createClusters) {
+    const allClusters = createRefactorClusters(duplicates);
+    clusters = filterClustersByImpact(
+      allClusters,
+      minClusterTokenCost,
+      minClusterFiles
+    );
+  }
+  return { results, duplicates, files, groups, clusters, config: finalOptions };
+}
+
 // src/provider.ts
-var PatternDetectProvider = {
-  id: import_core6.ToolName.PatternDetect,
+var PATTERN_DETECT_PROVIDER = {
+  id: import_core12.ToolName.PatternDetect,
   alias: ["patterns", "duplicates", "duplication"],
   async analyze(options) {
     const results = await analyzePatterns(options);
-    return import_core6.SpokeOutputSchema.parse({
+    return import_core12.SpokeOutputSchema.parse({
       results: results.results,
       summary: {
         totalFiles: results.files.length,
@@ -835,12 +1076,12 @@ var PatternDetectProvider = {
         clusters: results.clusters,
         config: Object.fromEntries(
           Object.entries(results.config).filter(
-            ([key]) => !import_core6.GLOBAL_SCAN_OPTIONS.includes(key) || key === "rootDir"
+            ([key]) => !import_core12.GLOBAL_SCAN_OPTIONS.includes(key) || key === "rootDir"
           )
         )
       },
       metadata: {
-        toolName: import_core6.ToolName.PatternDetect,
+        toolName: import_core12.ToolName.PatternDetect,
         version: "0.12.5",
         timestamp: (/* @__PURE__ */ new Date()).toISOString()
       }
@@ -848,31 +1089,43 @@ var PatternDetectProvider = {
   },
   score(output, options) {
     const duplicates = output.summary.duplicates || [];
-    const scoreData = duplicates;
     const totalFiles = output.summary.totalFiles || output.results.length;
+    let scoreData = duplicates;
+    const patternOptions = options;
+    if (patternOptions.severity && patternOptions.severity !== "all") {
+      const severityMap = {
+        critical: import_core12.Severity.Critical,
+        high: import_core12.Severity.Major,
+        // 'high' maps to Major and above
+        medium: import_core12.Severity.Minor,
+        all: import_core12.Severity.Info
+      };
+      const minSeverity = severityMap[patternOptions.severity] || import_core12.Severity.Info;
+      scoreData = (0, import_core5.filterBySeverity)(duplicates, minSeverity);
+    }
     return calculatePatternScore(scoreData, totalFiles, options.costConfig);
   },
   defaultWeight: 22
 };
 
 // src/index.ts
-import_core7.ToolRegistry.register(PatternDetectProvider);
+import_core13.ToolRegistry.register(PATTERN_DETECT_PROVIDER);
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
-  CONTEXT_RULES,
-  IssueType,
-  PatternDetectProvider,
+  PATTERN_DETECT_PROVIDER,
   Severity,
   analyzePatterns,
+  areBrandSpecificVariants,
   calculatePatternScore,
   calculateSeverity,
   createRefactorClusters,
   detectDuplicatePatterns,
+  filterBrandSpecificVariants,
   filterBySeverity,
   filterClustersByImpact,
   generateSummary,
   getSeverityLabel,
-  getSeverityThreshold,
   getSmartDefaults,
-  groupDuplicatesByFilePair
+  groupDuplicatesByFilePair,
+  logConfiguration
 });