@aiready/pattern-detect 0.9.2 → 0.9.3

package/dist/cli.js

@@ -31,6 +31,144 @@ var import_core2 = require("@aiready/core");
 
 // src/detector.ts
 var import_core = require("@aiready/core");
+
+// src/context-rules.ts
+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: "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: "low",
+    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: "low",
+    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: "low",
+    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: "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: "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: "info",
+    reason: "Mock data duplication is expected for comprehensive test coverage",
+    suggestion: "Consider shared factories only for complex mock generation"
+  }
+];
+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: "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: "high",
+      reason: "Nearly identical code should be consolidated",
+      suggestion: "Move to shared utility file"
+    };
+  } else if (similarity >= 0.85) {
+    return {
+      severity: "high",
+      reason: "High similarity indicates significant duplication",
+      suggestion: "Extract common logic to shared function"
+    };
+  } else if (similarity >= 0.7) {
+    return {
+      severity: "medium",
+      reason: "Moderate similarity detected",
+      suggestion: "Consider extracting shared patterns if code evolves together"
+    };
+  } else {
+    return {
+      severity: "low",
+      reason: "Minor similarity detected",
+      suggestion: "Monitor but refactoring may not be worthwhile"
+    };
+  }
+}
+function filterBySeverity(duplicates, minSeverity) {
+  const severityOrder = ["info", "low", "medium", "high", "critical"];
+  const minIndex = severityOrder.indexOf(minSeverity);
+  if (minIndex === -1) return duplicates;
+  return duplicates.filter((dup) => {
+    const dupIndex = severityOrder.indexOf(dup.severity);
+    return dupIndex >= minIndex;
+  });
+}
+
+// src/detector.ts
 function categorizePattern(code) {
   const lower = code.toLowerCase();
   if (lower.includes("request") && lower.includes("response") || lower.includes("router.") || lower.includes("app.get") || lower.includes("app.post") || lower.includes("express") || lower.includes("ctx.body")) {
@@ -246,6 +384,13 @@ async function detectDuplicatePatterns(files, options) {
         const block2 = allBlocks[j];
         const similarity = jaccardSimilarity(blockTokens[i], blockTokens[j]);
         if (similarity >= minSimilarity) {
+          const { severity, reason, suggestion, matchedRule } = calculateSeverity(
+            block1.file,
+            block2.file,
+            block1.content,
+            similarity,
+            block1.linesOfCode
+          );
           const duplicate = {
             file1: block1.file,
             file2: block2.file,
@@ -257,7 +402,11 @@ async function detectDuplicatePatterns(files, options) {
             snippet: block1.content.split("\n").slice(0, 5).join("\n") + "\n...",
             patternType: block1.patternType,
             tokenCost: block1.tokenCost + block2.tokenCost,
-            linesOfCode: block1.linesOfCode
+            linesOfCode: block1.linesOfCode,
+            severity,
+            reason,
+            suggestion,
+            matchedRule
           };
           duplicates.push(duplicate);
           if (streamResults) {
@@ -276,6 +425,13 @@ async function detectDuplicatePatterns(files, options) {
         if (block1.file === block2.file) continue;
         const similarity = jaccardSimilarity(blockTokens[i], blockTokens[j]);
         if (similarity >= minSimilarity) {
+          const { severity, reason, suggestion, matchedRule } = calculateSeverity(
+            block1.file,
+            block2.file,
+            block1.content,
+            similarity,
+            block1.linesOfCode
+          );
           const duplicate = {
             file1: block1.file,
             file2: block2.file,
@@ -287,7 +443,11 @@ async function detectDuplicatePatterns(files, options) {
             snippet: block1.content.split("\n").slice(0, 5).join("\n") + "\n...",
             patternType: block1.patternType,
             tokenCost: block1.tokenCost + block2.tokenCost,
-            linesOfCode: block1.linesOfCode
+            linesOfCode: block1.linesOfCode,
+            severity,
+            reason,
+            suggestion,
+            matchedRule
           };
           duplicates.push(duplicate);
           if (streamResults) {
@@ -523,7 +683,7 @@ var import_fs = require("fs");
 var import_path = require("path");
 var import_core3 = require("@aiready/core");
 var program = new import_commander.Command();
-program.name("aiready-patterns").description("Detect duplicate patterns in your codebase").version("0.1.0").addHelpText("after", "\nCONFIGURATION:\n  Supports config files: aiready.json, aiready.config.json, .aiready.json, .aireadyrc.json, aiready.config.js, .aireadyrc.js\n  CLI options override config file settings\n\nPARAMETER TUNING:\n  If you get too few results: decrease --similarity, --min-lines, or --min-shared-tokens\n  If analysis is too slow: increase --min-lines, --min-shared-tokens, or decrease --max-candidates\n  If you get too many false positives: increase --similarity or --min-lines\n\nEXAMPLES:\n  aiready-patterns .                                    # Basic analysis with smart defaults\n  aiready-patterns . --similarity 0.3 --min-lines 3     # More sensitive detection\n  aiready-patterns . --max-candidates 50 --no-approx    # Slower but more thorough\n  aiready-patterns . --output json > report.json       # JSON export").argument("<directory>", "Directory to analyze").option("-s, --similarity <number>", "Minimum similarity score (0-1). Lower = more results, higher = fewer but more accurate. Default: 0.4").option("-l, --min-lines <number>", "Minimum lines to consider. Lower = more results, higher = faster analysis. Default: 5").option("--batch-size <number>", "Batch size for comparisons. Higher = faster but more memory. Default: 100").option("--no-approx", "Disable approximate candidate selection. Slower but more thorough on small repos").option("--min-shared-tokens <number>", "Minimum shared tokens to consider a candidate. Higher = faster, fewer results. Default: 8").option("--max-candidates <number>", "Maximum candidates per block. Higher = more thorough but slower. Default: 100").option("--no-stream-results", "Disable incremental output (default: enabled)").option("--include <patterns>", "File patterns to include (comma-separated)").option("--exclude <patterns>", "File patterns to exclude (comma-separated)").option("--severity <level>", "Filter by severity: critical|high|medium|all. Default: all").option("--include-tests", "Include test files in analysis (excluded by default)").option("--max-results <number>", "Maximum number of results to show in console output. Default: 10").option(
+program.name("aiready-patterns").description("Detect duplicate patterns in your codebase").version("0.1.0").addHelpText("after", "\nCONFIGURATION:\n  Supports config files: aiready.json, aiready.config.json, .aiready.json, .aireadyrc.json, aiready.config.js, .aireadyrc.js\n  CLI options override config file settings\n\nPARAMETER TUNING:\n  If you get too few results: decrease --similarity, --min-lines, or --min-shared-tokens\n  If analysis is too slow: increase --min-lines, --min-shared-tokens, or decrease --max-candidates\n  If you get too many false positives: increase --similarity or --min-lines\n\nEXAMPLES:\n  aiready-patterns .                                    # Basic analysis with smart defaults\n  aiready-patterns . --similarity 0.3 --min-lines 3     # More sensitive detection\n  aiready-patterns . --max-candidates 50 --no-approx    # Slower but more thorough\n  aiready-patterns . --output json > report.json       # JSON export").argument("<directory>", "Directory to analyze").option("-s, --similarity <number>", "Minimum similarity score (0-1). Lower = more results, higher = fewer but more accurate. Default: 0.4").option("-l, --min-lines <number>", "Minimum lines to consider. Lower = more results, higher = faster analysis. Default: 5").option("--batch-size <number>", "Batch size for comparisons. Higher = faster but more memory. Default: 100").option("--no-approx", "Disable approximate candidate selection. Slower but more thorough on small repos").option("--min-shared-tokens <number>", "Minimum shared tokens to consider a candidate. Higher = faster, fewer results. Default: 8").option("--max-candidates <number>", "Maximum candidates per block. Higher = more thorough but slower. Default: 100").option("--no-stream-results", "Disable incremental output (default: enabled)").option("--include <patterns>", "File patterns to include (comma-separated)").option("--exclude <patterns>", "File patterns to exclude (comma-separated)").option("--min-severity <level>", "Minimum severity to show: critical|high|medium|low|info. Default: medium").option("--exclude-test-fixtures", "Exclude test fixture duplication (beforeAll/afterAll)").option("--exclude-templates", "Exclude template file duplication").option("--include-tests", "Include test files in analysis (excluded by default)").option("--max-results <number>", "Maximum number of results to show in console output. Default: 10").option(
   "-o, --output <format>",
   "Output format: console, json, html",
   "console"
@@ -541,7 +701,9 @@ program.name("aiready-patterns").description("Detect duplicate patterns in your
     streamResults: true,
     include: void 0,
     exclude: void 0,
-    severity: "all",
+    minSeverity: "medium",
+    excludeTestFixtures: false,
+    excludeTemplates: false,
     includeTests: false,
     maxResults: 10
   };
@@ -558,7 +720,9 @@ program.name("aiready-patterns").description("Detect duplicate patterns in your
     streamResults: options.streamResults !== false && mergedConfig.streamResults,
     include: options.include?.split(",") || mergedConfig.include,
     exclude: options.exclude?.split(",") || mergedConfig.exclude,
-    severity: options.severity || mergedConfig.severity,
+    minSeverity: options.minSeverity || mergedConfig.minSeverity,
+    excludeTestFixtures: options.excludeTestFixtures || mergedConfig.excludeTestFixtures,
+    excludeTemplates: options.excludeTemplates || mergedConfig.excludeTemplates,
     includeTests: options.includeTests || mergedConfig.includeTests,
     maxResults: options.maxResults ? parseInt(options.maxResults) : mergedConfig.maxResults
   };
@@ -574,6 +738,16 @@ program.name("aiready-patterns").description("Detect duplicate patterns in your
     finalOptions.exclude = finalOptions.exclude ? [...finalOptions.exclude, ...testPatterns] : testPatterns;
   }
   const { results, duplicates: rawDuplicates, files } = await analyzePatterns(finalOptions);
+  let filteredDuplicates = rawDuplicates;
+  if (finalOptions.minSeverity) {
+    filteredDuplicates = filterBySeverity(filteredDuplicates, finalOptions.minSeverity);
+  }
+  if (finalOptions.excludeTestFixtures) {
+    filteredDuplicates = filteredDuplicates.filter((d) => d.matchedRule !== "test-fixtures");
+  }
+  if (finalOptions.excludeTemplates) {
+    filteredDuplicates = filteredDuplicates.filter((d) => d.matchedRule !== "templates");
+  }
   const elapsedTime = ((Date.now() - startTime) / 1e3).toFixed(2);
   const summary = generateSummary(results);
   const totalIssues = results.reduce((sum, r) => sum + r.issues.length, 0);
@@ -647,27 +821,37 @@ program.name("aiready-patterns").description("Detect duplicate patterns in your
     console.log(import_chalk.default.cyan("\n" + divider));
     console.log(import_chalk.default.bold.white("  TOP DUPLICATE PATTERNS"));
     console.log(import_chalk.default.cyan(divider) + "\n");
-    let filteredDuplicates = rawDuplicates;
-    if (finalOptions.severity !== "all") {
-      const severityThresholds = {
-        critical: 0.95,
-        high: 0.9,
-        medium: 0.4
-      };
-      const threshold = severityThresholds[finalOptions.severity] || 0.4;
-      filteredDuplicates = rawDuplicates.filter((dup) => dup.similarity >= threshold);
-    }
-    const topDuplicates = filteredDuplicates.sort((a, b) => b.similarity - a.similarity).slice(0, finalOptions.maxResults);
+    const severityOrder = {
+      critical: 5,
+      high: 4,
+      medium: 3,
+      low: 2,
+      info: 1
+    };
+    const topDuplicates = filteredDuplicates.sort((a, b) => {
+      const severityDiff = severityOrder[b.severity] - severityOrder[a.severity];
+      if (severityDiff !== 0) return severityDiff;
+      return b.similarity - a.similarity;
+    }).slice(0, finalOptions.maxResults);
     topDuplicates.forEach((dup, idx) => {
-      const severity = dup.similarity > 0.95 ? "CRITICAL" : dup.similarity > 0.9 ? "HIGH" : "MEDIUM";
-      const severityIcon = dup.similarity > 0.95 ? "\u{1F534}" : dup.similarity > 0.9 ? "\u{1F7E1}" : "\u{1F535}";
+      const severityBadge = getSeverityBadge(dup.severity);
       const file1Name = dup.file1.split("/").pop() || dup.file1;
       const file2Name = dup.file2.split("/").pop() || dup.file2;
-      console.log(`${severityIcon} ${severity}: ${import_chalk.default.bold(file1Name)} \u2194 ${import_chalk.default.bold(file2Name)}`);
-      console.log(`   Similarity: ${import_chalk.default.bold(Math.round(dup.similarity * 100) + "%")} | Wasted: ${import_chalk.default.bold(dup.tokenCost.toLocaleString())} tokens each`);
-      console.log(`   Location: lines ${import_chalk.default.cyan(dup.line1 + "-" + dup.endLine1)} \u2194 lines ${import_chalk.default.cyan(dup.line2 + "-" + dup.endLine2)}
-`);
+      console.log(`${severityBadge} ${import_chalk.default.bold(file1Name)} \u2194 ${import_chalk.default.bold(file2Name)}`);
+      console.log(`   Similarity: ${import_chalk.default.bold(Math.round(dup.similarity * 100) + "%")} | Pattern: ${dup.patternType} | Tokens: ${import_chalk.default.bold(dup.tokenCost.toLocaleString())}`);
+      console.log(`   ${import_chalk.default.gray(dup.file1)}:${import_chalk.default.cyan(dup.line1 + "-" + dup.endLine1)}`);
+      console.log(`   ${import_chalk.default.gray(dup.file2)}:${import_chalk.default.cyan(dup.line2 + "-" + dup.endLine2)}`);
+      if (dup.reason) {
+        console.log(`   ${import_chalk.default.italic.gray(dup.reason)}`);
+      }
+      if (dup.suggestion) {
+        console.log(`   ${import_chalk.default.cyan("\u2192")} ${import_chalk.default.italic(dup.suggestion)}`);
+      }
+      console.log();
     });
+    if (filteredDuplicates.length > topDuplicates.length) {
+      console.log(import_chalk.default.gray(`   ... and ${filteredDuplicates.length - topDuplicates.length} more duplicates`));
+    }
   }
   const allIssues = results.flatMap(
     (r) => r.issues.map((issue) => ({ ...issue, file: r.fileName }))
@@ -808,3 +992,13 @@ function generateHTMLReport(summary, results) {
 </html>`;
 }
 program.parse();
+function getSeverityBadge(severity) {
+  const badges = {
+    critical: import_chalk.default.bgRed.white.bold(" CRITICAL "),
+    high: import_chalk.default.bgYellow.black.bold(" HIGH "),
+    medium: import_chalk.default.bgBlue.white.bold(" MEDIUM "),
+    low: import_chalk.default.bgGray.white(" LOW "),
+    info: import_chalk.default.bgCyan.black(" INFO ")
+  };
+  return badges[severity] || badges.info;
+}

package/dist/cli.mjs

@@ -1,8 +1,9 @@
 #!/usr/bin/env node
 import {
   analyzePatterns,
+  filterBySeverity,
   generateSummary
-} from "./chunk-65G3HXLQ.mjs";
+} from "./chunk-H73HEG7M.mjs";
 
 // src/cli.ts
 import { Command } from "commander";
@@ -11,7 +12,7 @@ import { writeFileSync, mkdirSync, existsSync } from "fs";
 import { dirname } from "path";
 import { loadConfig, mergeConfigWithDefaults, resolveOutputPath } from "@aiready/core";
 var program = new Command();
-program.name("aiready-patterns").description("Detect duplicate patterns in your codebase").version("0.1.0").addHelpText("after", "\nCONFIGURATION:\n  Supports config files: aiready.json, aiready.config.json, .aiready.json, .aireadyrc.json, aiready.config.js, .aireadyrc.js\n  CLI options override config file settings\n\nPARAMETER TUNING:\n  If you get too few results: decrease --similarity, --min-lines, or --min-shared-tokens\n  If analysis is too slow: increase --min-lines, --min-shared-tokens, or decrease --max-candidates\n  If you get too many false positives: increase --similarity or --min-lines\n\nEXAMPLES:\n  aiready-patterns .                                    # Basic analysis with smart defaults\n  aiready-patterns . --similarity 0.3 --min-lines 3     # More sensitive detection\n  aiready-patterns . --max-candidates 50 --no-approx    # Slower but more thorough\n  aiready-patterns . --output json > report.json       # JSON export").argument("<directory>", "Directory to analyze").option("-s, --similarity <number>", "Minimum similarity score (0-1). Lower = more results, higher = fewer but more accurate. Default: 0.4").option("-l, --min-lines <number>", "Minimum lines to consider. Lower = more results, higher = faster analysis. Default: 5").option("--batch-size <number>", "Batch size for comparisons. Higher = faster but more memory. Default: 100").option("--no-approx", "Disable approximate candidate selection. Slower but more thorough on small repos").option("--min-shared-tokens <number>", "Minimum shared tokens to consider a candidate. Higher = faster, fewer results. Default: 8").option("--max-candidates <number>", "Maximum candidates per block. Higher = more thorough but slower. Default: 100").option("--no-stream-results", "Disable incremental output (default: enabled)").option("--include <patterns>", "File patterns to include (comma-separated)").option("--exclude <patterns>", "File patterns to exclude (comma-separated)").option("--severity <level>", "Filter by severity: critical|high|medium|all. Default: all").option("--include-tests", "Include test files in analysis (excluded by default)").option("--max-results <number>", "Maximum number of results to show in console output. Default: 10").option(
+program.name("aiready-patterns").description("Detect duplicate patterns in your codebase").version("0.1.0").addHelpText("after", "\nCONFIGURATION:\n  Supports config files: aiready.json, aiready.config.json, .aiready.json, .aireadyrc.json, aiready.config.js, .aireadyrc.js\n  CLI options override config file settings\n\nPARAMETER TUNING:\n  If you get too few results: decrease --similarity, --min-lines, or --min-shared-tokens\n  If analysis is too slow: increase --min-lines, --min-shared-tokens, or decrease --max-candidates\n  If you get too many false positives: increase --similarity or --min-lines\n\nEXAMPLES:\n  aiready-patterns .                                    # Basic analysis with smart defaults\n  aiready-patterns . --similarity 0.3 --min-lines 3     # More sensitive detection\n  aiready-patterns . --max-candidates 50 --no-approx    # Slower but more thorough\n  aiready-patterns . --output json > report.json       # JSON export").argument("<directory>", "Directory to analyze").option("-s, --similarity <number>", "Minimum similarity score (0-1). Lower = more results, higher = fewer but more accurate. Default: 0.4").option("-l, --min-lines <number>", "Minimum lines to consider. Lower = more results, higher = faster analysis. Default: 5").option("--batch-size <number>", "Batch size for comparisons. Higher = faster but more memory. Default: 100").option("--no-approx", "Disable approximate candidate selection. Slower but more thorough on small repos").option("--min-shared-tokens <number>", "Minimum shared tokens to consider a candidate. Higher = faster, fewer results. Default: 8").option("--max-candidates <number>", "Maximum candidates per block. Higher = more thorough but slower. Default: 100").option("--no-stream-results", "Disable incremental output (default: enabled)").option("--include <patterns>", "File patterns to include (comma-separated)").option("--exclude <patterns>", "File patterns to exclude (comma-separated)").option("--min-severity <level>", "Minimum severity to show: critical|high|medium|low|info. Default: medium").option("--exclude-test-fixtures", "Exclude test fixture duplication (beforeAll/afterAll)").option("--exclude-templates", "Exclude template file duplication").option("--include-tests", "Include test files in analysis (excluded by default)").option("--max-results <number>", "Maximum number of results to show in console output. Default: 10").option(
   "-o, --output <format>",
   "Output format: console, json, html",
   "console"
@@ -29,7 +30,9 @@ program.name("aiready-patterns").description("Detect duplicate patterns in your
     streamResults: true,
     include: void 0,
     exclude: void 0,
-    severity: "all",
+    minSeverity: "medium",
+    excludeTestFixtures: false,
+    excludeTemplates: false,
     includeTests: false,
     maxResults: 10
   };
@@ -46,7 +49,9 @@ program.name("aiready-patterns").description("Detect duplicate patterns in your
     streamResults: options.streamResults !== false && mergedConfig.streamResults,
     include: options.include?.split(",") || mergedConfig.include,
     exclude: options.exclude?.split(",") || mergedConfig.exclude,
-    severity: options.severity || mergedConfig.severity,
+    minSeverity: options.minSeverity || mergedConfig.minSeverity,
+    excludeTestFixtures: options.excludeTestFixtures || mergedConfig.excludeTestFixtures,
+    excludeTemplates: options.excludeTemplates || mergedConfig.excludeTemplates,
     includeTests: options.includeTests || mergedConfig.includeTests,
     maxResults: options.maxResults ? parseInt(options.maxResults) : mergedConfig.maxResults
   };
@@ -62,6 +67,16 @@ program.name("aiready-patterns").description("Detect duplicate patterns in your
     finalOptions.exclude = finalOptions.exclude ? [...finalOptions.exclude, ...testPatterns] : testPatterns;
   }
   const { results, duplicates: rawDuplicates, files } = await analyzePatterns(finalOptions);
+  let filteredDuplicates = rawDuplicates;
+  if (finalOptions.minSeverity) {
+    filteredDuplicates = filterBySeverity(filteredDuplicates, finalOptions.minSeverity);
+  }
+  if (finalOptions.excludeTestFixtures) {
+    filteredDuplicates = filteredDuplicates.filter((d) => d.matchedRule !== "test-fixtures");
+  }
+  if (finalOptions.excludeTemplates) {
+    filteredDuplicates = filteredDuplicates.filter((d) => d.matchedRule !== "templates");
+  }
   const elapsedTime = ((Date.now() - startTime) / 1e3).toFixed(2);
   const summary = generateSummary(results);
   const totalIssues = results.reduce((sum, r) => sum + r.issues.length, 0);
@@ -135,27 +150,37 @@ program.name("aiready-patterns").description("Detect duplicate patterns in your
     console.log(chalk.cyan("\n" + divider));
     console.log(chalk.bold.white("  TOP DUPLICATE PATTERNS"));
     console.log(chalk.cyan(divider) + "\n");
-    let filteredDuplicates = rawDuplicates;
-    if (finalOptions.severity !== "all") {
-      const severityThresholds = {
-        critical: 0.95,
-        high: 0.9,
-        medium: 0.4
-      };
-      const threshold = severityThresholds[finalOptions.severity] || 0.4;
-      filteredDuplicates = rawDuplicates.filter((dup) => dup.similarity >= threshold);
-    }
-    const topDuplicates = filteredDuplicates.sort((a, b) => b.similarity - a.similarity).slice(0, finalOptions.maxResults);
+    const severityOrder = {
+      critical: 5,
+      high: 4,
+      medium: 3,
+      low: 2,
+      info: 1
+    };
+    const topDuplicates = filteredDuplicates.sort((a, b) => {
+      const severityDiff = severityOrder[b.severity] - severityOrder[a.severity];
+      if (severityDiff !== 0) return severityDiff;
+      return b.similarity - a.similarity;
+    }).slice(0, finalOptions.maxResults);
     topDuplicates.forEach((dup, idx) => {
-      const severity = dup.similarity > 0.95 ? "CRITICAL" : dup.similarity > 0.9 ? "HIGH" : "MEDIUM";
-      const severityIcon = dup.similarity > 0.95 ? "\u{1F534}" : dup.similarity > 0.9 ? "\u{1F7E1}" : "\u{1F535}";
+      const severityBadge = getSeverityBadge(dup.severity);
       const file1Name = dup.file1.split("/").pop() || dup.file1;
       const file2Name = dup.file2.split("/").pop() || dup.file2;
-      console.log(`${severityIcon} ${severity}: ${chalk.bold(file1Name)} \u2194 ${chalk.bold(file2Name)}`);
-      console.log(`   Similarity: ${chalk.bold(Math.round(dup.similarity * 100) + "%")} | Wasted: ${chalk.bold(dup.tokenCost.toLocaleString())} tokens each`);
-      console.log(`   Location: lines ${chalk.cyan(dup.line1 + "-" + dup.endLine1)} \u2194 lines ${chalk.cyan(dup.line2 + "-" + dup.endLine2)}
-`);
+      console.log(`${severityBadge} ${chalk.bold(file1Name)} \u2194 ${chalk.bold(file2Name)}`);
+      console.log(`   Similarity: ${chalk.bold(Math.round(dup.similarity * 100) + "%")} | Pattern: ${dup.patternType} | Tokens: ${chalk.bold(dup.tokenCost.toLocaleString())}`);
+      console.log(`   ${chalk.gray(dup.file1)}:${chalk.cyan(dup.line1 + "-" + dup.endLine1)}`);
+      console.log(`   ${chalk.gray(dup.file2)}:${chalk.cyan(dup.line2 + "-" + dup.endLine2)}`);
+      if (dup.reason) {
+        console.log(`   ${chalk.italic.gray(dup.reason)}`);
+      }
+      if (dup.suggestion) {
+        console.log(`   ${chalk.cyan("\u2192")} ${chalk.italic(dup.suggestion)}`);
+      }
+      console.log();
     });
+    if (filteredDuplicates.length > topDuplicates.length) {
+      console.log(chalk.gray(`   ... and ${filteredDuplicates.length - topDuplicates.length} more duplicates`));
+    }
   }
   const allIssues = results.flatMap(
     (r) => r.issues.map((issue) => ({ ...issue, file: r.fileName }))
@@ -296,3 +321,13 @@ function generateHTMLReport(summary, results) {
 </html>`;
 }
 program.parse();
+function getSeverityBadge(severity) {
+  const badges = {
+    critical: chalk.bgRed.white.bold(" CRITICAL "),
+    high: chalk.bgYellow.black.bold(" HIGH "),
+    medium: chalk.bgBlue.white.bold(" MEDIUM "),
+    low: chalk.bgGray.white(" LOW "),
+    info: chalk.bgCyan.black(" INFO ")
+  };
+  return badges[severity] || badges.info;
+}

package/dist/index.d.mts

@@ -1,5 +1,30 @@
 import { ScanOptions, AnalysisResult } from '@aiready/core';
 
+/**
+ * Context-aware severity detection for duplicate patterns
+ * Identifies intentional duplication patterns and adjusts severity accordingly
+ */
+type Severity = 'critical' | 'high' | 'medium' | 'low' | 'info';
+/**
+ * Calculate severity based on context rules and code characteristics
+ */
+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
+ */
+declare function getSeverityLabel(severity: Severity): string;
+/**
+ * Filter duplicates by minimum severity threshold
+ */
+declare function filterBySeverity<T extends {
+    severity: Severity;
+}>(duplicates: T[], minSeverity: Severity): T[];
+
 interface DuplicatePattern {
     file1: string;
     file2: string;
@@ -12,6 +37,10 @@ interface DuplicatePattern {
     patternType: PatternType;
     tokenCost: number;
     linesOfCode: number;
+    severity: Severity;
+    reason?: string;
+    suggestion?: string;
+    matchedRule?: string;
 }
 type PatternType = 'function' | 'class-method' | 'api-handler' | 'validator' | 'utility' | 'component' | 'unknown';
 interface FileContent {
@@ -75,4 +104,4 @@ declare function analyzePatterns(options: PatternDetectOptions): Promise<{
  */
 declare function generateSummary(results: AnalysisResult[]): PatternSummary;
 
-export { type DuplicatePattern, type PatternDetectOptions, type PatternSummary, type PatternType, analyzePatterns, detectDuplicatePatterns, generateSummary, getSmartDefaults };
+export { type DuplicatePattern, type PatternDetectOptions, type PatternSummary, type PatternType, type Severity, analyzePatterns, calculateSeverity, detectDuplicatePatterns, filterBySeverity, generateSummary, getSeverityLabel, getSmartDefaults };

package/dist/index.d.ts

@@ -1,5 +1,30 @@
 import { ScanOptions, AnalysisResult } from '@aiready/core';
 
+/**
+ * Context-aware severity detection for duplicate patterns
+ * Identifies intentional duplication patterns and adjusts severity accordingly
+ */
+type Severity = 'critical' | 'high' | 'medium' | 'low' | 'info';
+/**
+ * Calculate severity based on context rules and code characteristics
+ */
+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
+ */
+declare function getSeverityLabel(severity: Severity): string;
+/**
+ * Filter duplicates by minimum severity threshold
+ */
+declare function filterBySeverity<T extends {
+    severity: Severity;
+}>(duplicates: T[], minSeverity: Severity): T[];
+
 interface DuplicatePattern {
     file1: string;
     file2: string;
@@ -12,6 +37,10 @@ interface DuplicatePattern {
     patternType: PatternType;
     tokenCost: number;
     linesOfCode: number;
+    severity: Severity;
+    reason?: string;
+    suggestion?: string;
+    matchedRule?: string;
 }
 type PatternType = 'function' | 'class-method' | 'api-handler' | 'validator' | 'utility' | 'component' | 'unknown';
 interface FileContent {
@@ -75,4 +104,4 @@ declare function analyzePatterns(options: PatternDetectOptions): Promise<{
  */
 declare function generateSummary(results: AnalysisResult[]): PatternSummary;
 
-export { type DuplicatePattern, type PatternDetectOptions, type PatternSummary, type PatternType, analyzePatterns, detectDuplicatePatterns, generateSummary, getSmartDefaults };
+export { type DuplicatePattern, type PatternDetectOptions, type PatternSummary, type PatternType, type Severity, analyzePatterns, calculateSeverity, detectDuplicatePatterns, filterBySeverity, generateSummary, getSeverityLabel, getSmartDefaults };