Eliminate all code duplication + add 150 tests for 20 dark detectors

Utils migration:
- 63 detector files now import from detectors/utils.py
- 0 remaining ctx.content.decode duplicates (was 63)
- 0 remaining private _find_line_number copies (was 9)

Test coverage:
- 150 new tests across 20 previously untested detectors
- Covers: Spring REST/JPA/Kafka/Events/gRPC, Flask/Django/FastAPI/
  SQLAlchemy/Celery, Express/NestJS/GraphQL/TypeORM, C++, PowerShell
- 565 total tests, all passing in 0.92s

Benchmark: contoso-real-estate 488 files, 2,313 nodes, 2,905 edges,
3.7s — no performance regression, +56 files from new extensions

Updated CLAUDE.md with benchmark requirements.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

Author: aksOps

CLAUDE.md

@@ -59,9 +59,32 @@ FileDiscovery → Parsers → Detectors → GraphBuilder (buffered) → Linkers
 
 ## Testing
 
-- `pytest tests/ -x -q` — must always pass (currently 361 tests)
+- `pytest tests/ -x -q` — must always pass (currently 565 tests)
 - Every detector needs: positive match test, negative match test, determinism test
-- Benchmark on spring-boot (10K files) for performance regression checks
+- All detectors use shared `detectors/utils.py` — decode_text, find_line_number, etc.
+
+## Benchmark Requirements
+
+**After every change**, run a clean benchmark on a small project to verify:
+1. No performance regression (time should not increase significantly)
+2. 100% determinism (2 runs produce identical node/edge counts)
+3. Coverage doesn't decrease (file/node/edge counts should not drop)
+
+**Benchmark procedure:**
+```bash
+rm -rf ~/projects/testDir/contoso-real-estate/.code-intelligence/
+find ~/projects/testDir/contoso-real-estate -name ".code_intelligence_cache*" -delete
+# Run twice
+time code-intelligence analyze ~/projects/testDir/contoso-real-estate --full -j 8
+time code-intelligence analyze ~/projects/testDir/contoso-real-estate --full -j 8
+```
+
+If `testDir/contoso-real-estate` is not available, clone an official secure project:
+```bash
+git clone --depth 1 https://github.com/Azure-Samples/contoso-real-estate.git ~/projects/testDir/contoso-real-estate
+```
+
+**Baseline (contoso-real-estate, 488 files):** 2,313 nodes, 2,905 edges, ~3.7s
 - Cross-backend parity test on contoso-real-estate for data quality
 
 ## Key Files

README.md

@@ -22,9 +22,9 @@
   <!-- DYNAMIC:vulnerabilities --><a href="https://github.com/RandomCodeSpace/code-iq/security/dependabot"><img src="https://img.shields.io/badge/vulnerabilities-0-brightgreen?style=flat-square&logo=hackthebox&logoColor=white" alt="0 Vulnerabilities"></a><!-- /DYNAMIC:vulnerabilities -->
   <!-- DYNAMIC:detectors --><a href="https://github.com/RandomCodeSpace/code-iq"><img src="https://img.shields.io/badge/detectors-75-brightgreen?style=flat-square&logo=codefactor&logoColor=white" alt="75 Detectors"></a><!-- /DYNAMIC:detectors -->
   <!-- DYNAMIC:languages --><a href="https://github.com/RandomCodeSpace/code-iq"><img src="https://img.shields.io/badge/languages-35-blue?style=flat-square&logo=stackblitz&logoColor=white" alt="35 Languages"></a><!-- /DYNAMIC:languages -->
-  <!-- DYNAMIC:tests --><a href="https://github.com/RandomCodeSpace/code-iq"><img src="https://img.shields.io/badge/tests-415%20passed-brightgreen?style=flat-square&logo=pytest&logoColor=white" alt="415 passed Tests"></a><!-- /DYNAMIC:tests -->
-  <!-- DYNAMIC:files --><a href="https://github.com/RandomCodeSpace/code-iq"><img src="https://img.shields.io/badge/files-204-informational?style=flat-square&logo=files&logoColor=white" alt="204 Files"></a><!-- /DYNAMIC:files -->
-  <!-- DYNAMIC:loc --><a href="https://github.com/RandomCodeSpace/code-iq"><img src="https://img.shields.io/badge/LOC-23%2C370-informational?style=flat-square&logo=codacy&logoColor=white" alt="23,370 Loc"></a><!-- /DYNAMIC:loc -->
+  <!-- DYNAMIC:tests --><a href="https://github.com/RandomCodeSpace/code-iq"><img src="https://img.shields.io/badge/tests-565%20passed-brightgreen?style=flat-square&logo=pytest&logoColor=white" alt="565 passed Tests"></a><!-- /DYNAMIC:tests -->
+  <!-- DYNAMIC:files --><a href="https://github.com/RandomCodeSpace/code-iq"><img src="https://img.shields.io/badge/files-226-informational?style=flat-square&logo=files&logoColor=white" alt="226 Files"></a><!-- /DYNAMIC:files -->
+  <!-- DYNAMIC:loc --><a href="https://github.com/RandomCodeSpace/code-iq"><img src="https://img.shields.io/badge/LOC-25%2C736-informational?style=flat-square&logo=codacy&logoColor=white" alt="25,736 Loc"></a><!-- /DYNAMIC:loc -->
 </p>
 
 ---

src/code_intelligence/detectors/auth/certificate_auth.py

@@ -6,6 +6,7 @@
 from dataclasses import dataclass
 
 from code_intelligence.detectors.base import DetectorContext, DetectorResult
+from code_intelligence.detectors.utils import decode_text
 from code_intelligence.models.graph import GraphNode, NodeKind, SourceLocation
 
 
@@ -83,7 +84,7 @@ class CertificateAuthDetector:
 
     def detect(self, ctx: DetectorContext) -> DetectorResult:
         result = DetectorResult()
-        text = ctx.content.decode("utf-8", errors="replace")
+        text = decode_text(ctx)
         lines = text.split("\n")
 
         # Track which lines already produced a node (first match wins per line).

src/code_intelligence/detectors/auth/ldap_auth.py

@@ -5,6 +5,7 @@
 import re
 
 from code_intelligence.detectors.base import DetectorContext, DetectorResult
+from code_intelligence.detectors.utils import decode_text
 from code_intelligence.models.graph import GraphNode, NodeKind, SourceLocation
 
 # -- Java patterns --
@@ -56,7 +57,7 @@ def detect(self, ctx: DetectorContext) -> DetectorResult:
         if ctx.language not in _LANGUAGE_PATTERNS:
             return result
 
-        text = ctx.content.decode("utf-8", errors="replace")
+        text = decode_text(ctx)
         lines = text.split("\n")
         patterns = _LANGUAGE_PATTERNS[ctx.language]
         seen_lines: set[int] = set()

src/code_intelligence/detectors/auth/session_header_auth.py

@@ -6,6 +6,7 @@
 from dataclasses import dataclass
 
 from code_intelligence.detectors.base import DetectorContext, DetectorResult
+from code_intelligence.detectors.utils import decode_text
 from code_intelligence.models.graph import GraphNode, NodeKind, SourceLocation
 
 
@@ -84,7 +85,7 @@ def detect(self, ctx: DetectorContext) -> DetectorResult:
         if ctx.language not in self.supported_languages:
             return result
 
-        text = ctx.content.decode("utf-8", errors="replace")
+        text = decode_text(ctx)
         lines = text.split("\n")
         seen_lines: set[int] = set()
 

src/code_intelligence/detectors/config/batch_structure.py

@@ -5,6 +5,7 @@
 import re
 
 from code_intelligence.detectors.base import DetectorContext, DetectorResult
+from code_intelligence.detectors.utils import decode_text
 from code_intelligence.models.graph import (
     EdgeKind,
     GraphEdge,
@@ -28,7 +29,7 @@ def detect(self, ctx: DetectorContext) -> DetectorResult:
         result = DetectorResult()
 
         try:
-            text = ctx.content.decode("utf-8", errors="replace")
+            text = decode_text(ctx)
         except Exception:
             return result
 

src/code_intelligence/detectors/config/ini_structure.py

@@ -5,6 +5,7 @@
 import configparser
 
 from code_intelligence.detectors.base import DetectorContext, DetectorResult
+from code_intelligence.detectors.utils import decode_text
 from code_intelligence.models.graph import (
     EdgeKind,
     GraphEdge,
@@ -41,7 +42,7 @@ def detect(self, ctx: DetectorContext) -> DetectorResult:
 
         # Parse INI from raw content
         try:
-            text = ctx.content.decode("utf-8", errors="replace")
+            text = decode_text(ctx)
             parser = configparser.ConfigParser()
             parser.read_string(text)
         except Exception:

src/code_intelligence/detectors/config/pyproject_toml.py

@@ -6,6 +6,7 @@
 import sys
 
 from code_intelligence.detectors.base import DetectorContext, DetectorResult
+from code_intelligence.detectors.utils import decode_text
 from code_intelligence.models.graph import (
     EdgeKind,
     GraphEdge,
@@ -40,7 +41,7 @@ def detect(self, ctx: DetectorContext) -> DetectorResult:
             return result
 
         try:
-            data = tomllib.loads(ctx.content.decode("utf-8", errors="replace"))
+            data = tomllib.loads(decode_text(ctx))
         except Exception:
             return result
 

src/code_intelligence/detectors/config/sql_structure.py

@@ -5,6 +5,7 @@
 import re
 
 from code_intelligence.detectors.base import DetectorContext, DetectorResult
+from code_intelligence.detectors.utils import decode_text
 from code_intelligence.models.graph import (
     EdgeKind,
     GraphEdge,
@@ -45,7 +46,7 @@ def detect(self, ctx: DetectorContext) -> DetectorResult:
         result = DetectorResult()
 
         try:
-            text = ctx.content.decode("utf-8", errors="replace")
+            text = decode_text(ctx)
         except Exception:
             return result
 

src/code_intelligence/detectors/config/toml_structure.py

@@ -5,6 +5,7 @@
 import sys
 
 from code_intelligence.detectors.base import DetectorContext, DetectorResult
+from code_intelligence.detectors.utils import decode_text
 from code_intelligence.models.graph import (
     EdgeKind,
     GraphEdge,
@@ -52,7 +53,7 @@ def detect(self, ctx: DetectorContext) -> DetectorResult:
 
         # Parse TOML from raw content
         try:
-            data = tomllib.loads(ctx.content.decode("utf-8", errors="replace"))
+            data = tomllib.loads(decode_text(ctx))
         except Exception:
             return result