@aiready/pattern-detect 0.17.8 → 0.17.12

package/dist/chunk-WYYSQX5M.mjs

@@ -0,0 +1,467 @@
+import {
+  detectDuplicatePatterns
+} from "./chunk-6VDL7TAS.mjs";
+import {
+  calculateSeverity
+} from "./chunk-PQXOORR4.mjs";
+
+// src/grouping.ts
+import { Severity, getSeverityLevel } from "@aiready/core";
+import path from "path";
+function groupDuplicatesByFilePair(duplicates) {
+  const groups = /* @__PURE__ */ new Map();
+  for (const dup of duplicates) {
+    const files = [dup.file1, dup.file2].sort();
+    const key = files.join("::");
+    if (!groups.has(key)) {
+      groups.set(key, {
+        filePair: key,
+        severity: dup.severity,
+        occurrences: 0,
+        totalTokenCost: 0,
+        averageSimilarity: 0,
+        patternTypes: /* @__PURE__ */ new Set(),
+        lineRanges: []
+      });
+    }
+    const group = groups.get(key);
+    group.occurrences++;
+    group.totalTokenCost += dup.tokenCost;
+    group.averageSimilarity += dup.similarity;
+    group.patternTypes.add(dup.patternType);
+    group.lineRanges.push({
+      file1: { start: dup.line1, end: dup.endLine1 },
+      file2: { start: dup.line2, end: dup.endLine2 }
+    });
+    const currentSev = dup.severity;
+    if (getSeverityLevel(currentSev) > getSeverityLevel(group.severity)) {
+      group.severity = currentSev;
+    }
+  }
+  return Array.from(groups.values()).map((g) => ({
+    ...g,
+    averageSimilarity: g.averageSimilarity / g.occurrences
+  }));
+}
+function createRefactorClusters(duplicates) {
+  const adjacency = /* @__PURE__ */ new Map();
+  const visited = /* @__PURE__ */ new Set();
+  const components = [];
+  for (const dup of duplicates) {
+    if (!adjacency.has(dup.file1)) adjacency.set(dup.file1, /* @__PURE__ */ new Set());
+    if (!adjacency.has(dup.file2)) adjacency.set(dup.file2, /* @__PURE__ */ new Set());
+    adjacency.get(dup.file1).add(dup.file2);
+    adjacency.get(dup.file2).add(dup.file1);
+  }
+  for (const file of adjacency.keys()) {
+    if (visited.has(file)) continue;
+    const component = [];
+    const queue = [file];
+    visited.add(file);
+    while (queue.length > 0) {
+      const curr = queue.shift();
+      component.push(curr);
+      for (const neighbor of adjacency.get(curr) || []) {
+        if (!visited.has(neighbor)) {
+          visited.add(neighbor);
+          queue.push(neighbor);
+        }
+      }
+    }
+    components.push(component);
+  }
+  const clusters = [];
+  for (const component of components) {
+    if (component.length < 2) continue;
+    const componentDups = duplicates.filter(
+      (d) => component.includes(d.file1) && component.includes(d.file2)
+    );
+    const totalTokenCost = componentDups.reduce(
+      (sum, d) => sum + d.tokenCost,
+      0
+    );
+    const avgSimilarity = componentDups.reduce((sum, d) => sum + d.similarity, 0) / Math.max(1, componentDups.length);
+    const name = determineClusterName(component);
+    const { severity, reason, suggestion } = calculateSeverity(
+      component[0],
+      component[1],
+      "",
+      // Code not available here
+      avgSimilarity,
+      30
+      // Assume substantial if clustered
+    );
+    clusters.push({
+      id: `cluster-${clusters.length}`,
+      name,
+      files: component,
+      severity,
+      duplicateCount: componentDups.length,
+      totalTokenCost,
+      averageSimilarity: avgSimilarity,
+      reason,
+      suggestion
+    });
+  }
+  return clusters;
+}
+function determineClusterName(files) {
+  if (files.length === 0) return "Unknown Cluster";
+  if (files.some((f) => f.includes("blog"))) return "Blog SEO Boilerplate";
+  if (files.some((f) => f.includes("buttons")))
+    return "Button Component Variants";
+  if (files.some((f) => f.includes("cards"))) return "Card Component Variants";
+  if (files.some((f) => f.includes("login.test"))) return "E2E Test Patterns";
+  const first = files[0];
+  const dirName = path.dirname(first).split(path.sep).pop();
+  if (dirName && dirName !== "." && dirName !== "..") {
+    return `${dirName.charAt(0).toUpperCase() + dirName.slice(1)} Domain Group`;
+  }
+  return "Shared Pattern Group";
+}
+function filterClustersByImpact(clusters, minTokenCost = 1e3, minFiles = 3) {
+  return clusters.filter(
+    (c) => c.totalTokenCost >= minTokenCost && c.files.length >= minFiles
+  );
+}
+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 = Severity.Info;
+      dup.suggestion = "Brand-specific themed component variant (intentional)";
+    }
+    const isInterfaceDef = isPureInterfaceDefinition(dup.code1) && isPureInterfaceDefinition(dup.code2);
+    if (isInterfaceDef) {
+      dup.severity = Severity.Info;
+      dup.suggestion = "Pure interface/type definition - intentional for module independence";
+    }
+    return true;
+  });
+}
+
+// src/analyzer.ts
+import { scanFiles, readFileContent, Severity as Severity2, IssueType as IssueType2 } from "@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;
+}
+async function getSmartDefaults(directory, userOptions) {
+  if (userOptions.useSmartDefaults === false) {
+    return {
+      rootDir: directory,
+      minSimilarity: 0.6,
+      minLines: 8,
+      batchSize: 100,
+      approx: true,
+      minSharedTokens: 12,
+      maxCandidatesPerBlock: 5,
+      streamResults: false,
+      severity: "all",
+      includeTests: false
+    };
+  }
+  const scanOptions = {
+    rootDir: directory,
+    include: userOptions.include || ["**/*.{ts,tsx,js,jsx,py,java}"],
+    exclude: userOptions.exclude
+  };
+  const files = await scanFiles(scanOptions);
+  const fileCount = files.length;
+  const estimatedBlocks = fileCount * 5;
+  const minLines = Math.max(
+    6,
+    Math.min(20, 6 + Math.floor(estimatedBlocks / 1e3) * 2)
+  );
+  const minSimilarity = Math.min(0.75, 0.45 + estimatedBlocks / 1e4 * 0.3);
+  const batchSize = estimatedBlocks > 1e3 ? 200 : 100;
+  const severity = estimatedBlocks > 3e3 ? "high" : "all";
+  const maxCandidatesPerBlock = Math.max(
+    5,
+    Math.min(100, Math.floor(1e6 / estimatedBlocks))
+  );
+  const defaults = {
+    rootDir: directory,
+    minSimilarity,
+    minLines,
+    batchSize,
+    approx: true,
+    minSharedTokens: 10,
+    maxCandidatesPerBlock,
+    streamResults: false,
+    severity,
+    includeTests: false
+  };
+  const result = { ...defaults };
+  for (const key of Object.keys(defaults)) {
+    if (key in userOptions && userOptions[key] !== void 0) {
+      result[key] = userOptions[key];
+    }
+  }
+  return result;
+}
+function logConfiguration(config, estimatedBlocks) {
+  if (config.suppressToolConfig) return;
+  console.log("\u{1F4CB} Configuration:");
+  console.log(`   Repository size: ~${estimatedBlocks} code blocks`);
+  console.log(`   Similarity threshold: ${config.minSimilarity}`);
+  console.log(`   Minimum lines: ${config.minLines}`);
+  console.log(`   Approximate mode: ${config.approx ? "enabled" : "disabled"}`);
+  console.log(`   Max candidates per block: ${config.maxCandidatesPerBlock}`);
+  console.log(`   Min shared tokens: ${config.minSharedTokens}`);
+  console.log(`   Severity filter: ${config.severity}`);
+  console.log(`   Include tests: ${config.includeTests}`);
+  if (config.excludePatterns && config.excludePatterns.length > 0) {
+    console.log(`   Exclude patterns: ${config.excludePatterns.length} active`);
+  }
+  if (config.confidenceThreshold && config.confidenceThreshold > 0) {
+    console.log(`   Confidence threshold: ${config.confidenceThreshold}`);
+  }
+  if (config.ignoreWhitelist && config.ignoreWhitelist.length > 0) {
+    console.log(
+      `   Ignore whitelist: ${config.ignoreWhitelist.length} entries`
+    );
+  }
+  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 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 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 severity2;
+      if (dup.severity === "info" || dup.severity === "Info") {
+        severity2 = Severity2.Info;
+      } else {
+        severity2 = dup.similarity > 0.95 ? Severity2.Critical : dup.similarity > 0.9 ? Severity2.Major : Severity2.Minor;
+      }
+      return {
+        type: IssueType2.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: [Severity2.Critical],
+        high: [Severity2.Critical, Severity2.Major],
+        medium: [Severity2.Critical, Severity2.Major, Severity2.Minor]
+      };
+      const allowedSeverities = severityMap[severity] || [Severity2.Critical, Severity2.Major, Severity2.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 };
+}
+function generateSummary(results) {
+  const allIssues = results.flatMap((r) => r.issues || []);
+  const totalTokenCost = results.reduce(
+    (sum, r) => sum + (r.metrics?.tokenCost || 0),
+    0
+  );
+  const patternsByType = {
+    "api-handler": 0,
+    validator: 0,
+    utility: 0,
+    "class-method": 0,
+    component: 0,
+    function: 0,
+    unknown: 0
+  };
+  allIssues.forEach((issue) => {
+    const match = issue.message.match(/^(\S+(?:-\S+)*) pattern/);
+    if (match) {
+      const type = match[1];
+      patternsByType[type] = (patternsByType[type] || 0) + 1;
+    }
+  });
+  const topDuplicates = allIssues.slice(0, 10).map((issue) => {
+    const similarityMatch = issue.message.match(/(\d+)% similar/);
+    const tokenMatch = issue.message.match(/\((\d+) tokens/);
+    const typeMatch = issue.message.match(/^(\S+(?:-\S+)*) pattern/);
+    const fileMatch = issue.message.match(/similar to (.+?) \(/);
+    return {
+      files: [
+        {
+          path: issue.location.file,
+          startLine: issue.location.line,
+          endLine: 0
+        },
+        {
+          path: fileMatch?.[1] || "unknown",
+          startLine: 0,
+          endLine: 0
+        }
+      ],
+      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
+    };
+  });
+  return {
+    totalPatterns: allIssues.length,
+    totalTokenCost,
+    patternsByType,
+    topDuplicates
+  };
+}
+
+export {
+  groupDuplicatesByFilePair,
+  createRefactorClusters,
+  filterClustersByImpact,
+  areBrandSpecificVariants,
+  filterBrandSpecificVariants,
+  getSmartDefaults,
+  analyzePatterns,
+  generateSummary
+};

package/dist/{chunk-I6ETJC7L.mjs → chunk-X553BOMI.mjs}

@@ -1,5 +1,10 @@
 // src/context-rules.ts
-import { Severity } from "@aiready/core";
+import {
+  IssueType,
+  getSeverityLabel,
+  filterBySeverity,
+  Severity
+} from "@aiready/core";
 var CONTEXT_RULES = [
   // Test Fixtures - Intentional duplication for test isolation
   {
@@ -92,6 +97,53 @@ var CONTEXT_RULES = [
     severity: Severity.Info,
     reason: "Tool implementations share structural boilerplate but have distinct business logic",
     suggestion: "Tool duplication is acceptable for boilerplate interface wrappers"
+  },
+  // Common UI Event Handlers - Boilerplate by nature
+  {
+    name: "common-ui-handlers",
+    detect: (file, code) => {
+      const isUIFile = file.includes("/components/") || file.includes(".tsx") || file.includes(".jsx") || file.includes("/hooks/");
+      const hasCommonHandler = code.includes("handleClickOutside") || code.includes("handleClickInside") || code.includes("handleEscape") || code.includes("handleKeyDown") || code.includes("handleKeyUp") || code.includes("handleMouseDown") || code.includes("handleMouseUp") || code.includes("handleFocus") || code.includes("handleBlur") || code.includes("handleResize") || code.includes("handleScroll") || code.includes("handleSubmit") || code.includes("handleCancel") || code.includes("handleClose") || code.includes("handleOpen") || code.includes("handleToggle");
+      return isUIFile && hasCommonHandler;
+    },
+    severity: Severity.Minor,
+    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"
+  },
+  // Utility Functions - Small helpers often intentionally similar
+  {
+    name: "utility-functions",
+    detect: (file, code) => {
+      const isUtilFile = file.includes("/utils/") || file.includes("/helpers/") || file.includes("/lib/") || file.endsWith(".util.ts") || file.endsWith(".helper.ts");
+      const hasUtilPattern = code.includes("function format") || code.includes("function parse") || code.includes("function validate") || code.includes("function sanitize") || code.includes("function normalize") || code.includes("function convert") || code.includes("function transform") || code.includes("function extract") || code.includes("function build") || code.includes("function create") || code.includes("function get") || code.includes("function set") || code.includes("function is") || code.includes("function has") || code.includes("function can");
+      return isUtilFile && hasUtilPattern;
+    },
+    severity: Severity.Minor,
+    reason: "Utility functions are often intentionally similar across modules for clarity",
+    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: Severity.Minor,
+    reason: "Hooks follow standard patterns and are often intentionally similar across components",
+    suggestion: "Consider extracting common hook logic only if hooks become complex"
+  },
+  // 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: Severity.Minor,
+    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"
   }
 ];
 function calculateSeverity(file1, file2, code, similarity, linesOfCode) {
@@ -137,29 +189,6 @@ function calculateSeverity(file1, file2, code, similarity, linesOfCode) {
     };
   }
 }
-function getSeverityLabel(severity) {
-  const labels = {
-    [Severity.Critical]: "\u{1F534} CRITICAL",
-    [Severity.Major]: "\u{1F7E1} MAJOR",
-    [Severity.Minor]: "\u{1F535} MINOR",
-    [Severity.Info]: "\u2139\uFE0F  INFO"
-  };
-  return labels[severity];
-}
-function filterBySeverity(duplicates, minSeverity) {
-  const severityOrder = [
-    Severity.Info,
-    Severity.Minor,
-    Severity.Major,
-    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 = {
     [Severity.Critical]: 0.95,
@@ -171,9 +200,10 @@ function getSeverityThreshold(severity) {
 }
 
 export {
-  CONTEXT_RULES,
-  calculateSeverity,
+  IssueType,
   getSeverityLabel,
   filterBySeverity,
+  CONTEXT_RULES,
+  calculateSeverity,
   getSeverityThreshold
 };

package/dist/{chunk-K7BO57OO.mjs → chunk-Y6OB7K34.mjs}

@@ -6,7 +6,7 @@ import {
 } from "./chunk-J2G742QF.mjs";
 
 // src/grouping.ts
-import { getSeverityLevel } from "@aiready/core";
+import { Severity, getSeverityLevel } from "@aiready/core";
 import path from "path";
 function groupDuplicatesByFilePair(duplicates) {
   const groups = /* @__PURE__ */ new Map();
@@ -124,9 +124,77 @@ function filterClustersByImpact(clusters, minTokenCost = 1e3, minFiles = 3) {
     (c) => c.totalTokenCost >= minTokenCost && c.files.length >= minFiles
   );
 }
+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 = Severity.Info;
+      dup.suggestion = "Brand-specific themed component variant (intentional)";
+    }
+    const isInterfaceDef = isPureInterfaceDefinition(dup.code1) && isPureInterfaceDefinition(dup.code2);
+    if (isInterfaceDef) {
+      dup.severity = Severity.Info;
+      dup.suggestion = "Pure interface/type definition - intentional for module independence";
+    }
+    return true;
+  });
+}
 
 // src/analyzer.ts
-import { scanFiles, readFileContent, Severity as Severity2, IssueType } from "@aiready/core";
+import { scanFiles, readFileContent, Severity as Severity2, IssueType as IssueType2 } from "@aiready/core";
 function getRefactoringSuggestion(patternType, similarity) {
   const baseMessages = {
     "api-handler": "Extract common middleware or create a base handler class",
@@ -268,15 +336,21 @@ async function analyzePatterns(options) {
     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;
-      const severity2 = dup.similarity > 0.95 ? Severity2.Critical : dup.similarity > 0.9 ? Severity2.Major : Severity2.Minor;
+      let severity2;
+      if (dup.severity === "info" || dup.severity === "Info") {
+        severity2 = Severity2.Info;
+      } else {
+        severity2 = dup.similarity > 0.95 ? Severity2.Critical : dup.similarity > 0.9 ? Severity2.Major : Severity2.Minor;
+      }
       return {
-        type: IssueType.DuplicatePattern,
+        type: IssueType2.DuplicatePattern,
         severity: severity2,
         message: `${dup.patternType} pattern ${Math.round(dup.similarity * 100)}% similar to ${otherFile} (${dup.tokenCost} tokens wasted)`,
         location: {
@@ -385,6 +459,8 @@ export {
   groupDuplicatesByFilePair,
   createRefactorClusters,
   filterClustersByImpact,
+  areBrandSpecificVariants,
+  filterBrandSpecificVariants,
   getSmartDefaults,
   analyzePatterns,
   generateSummary