fix: Fastify false positive + add E2E ground truth files

- Add framework-specific guard to FastifyRouteDetector (requires 'fastify'
  import/require before detecting routes, same pattern as Quarkus/Micronaut fix)
- Add E2E ground truth JSON files for spring-petclinic and realworld-express
  (sourced from Context7 and RealWorld API spec)

E2E results: petclinic 100% (65/65), realworld-express 96% (24/25)
Tests: 1310 pass, 0 failures

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

Author: aksOps

src/main/java/io/github/randomcodespace/iq/detector/typescript/FastifyRouteDetector.java

@@ -32,6 +32,16 @@
 @Component
 public class FastifyRouteDetector extends AbstractAntlrDetector {
 
+    /**
+     * Guard pattern: file must contain a Fastify import/require to be considered.
+     * Matches: import fastify from 'fastify', import Fastify from 'fastify',
+     * require('fastify'), import { ... } from 'fastify', etc.
+     */
+    private static final Pattern FASTIFY_IMPORT_PATTERN = Pattern.compile(
+            "(?:import\\s+.*?from\\s+['\"]fastify['\"]|require\\s*\\(\\s*['\"]fastify['\"]\\s*\\))",
+            Pattern.DOTALL
+    );
+
     private static final Pattern SHORTHAND_PATTERN = Pattern.compile(
             "(\\w+)\\.(get|post|put|delete|patch)\\(\\s*['\"`]([^'\"`]+)['\"`]"
     );
@@ -72,9 +82,16 @@ public DetectorResult detect(DetectorContext ctx) {
 
     @Override
     protected DetectorResult detectWithRegex(DetectorContext ctx) {
+        String text = ctx.content();
+
+        // Guard: only proceed if the file imports/requires 'fastify'.
+        // Without this, generic patterns like router.get() match Express and other frameworks.
+        if (!FASTIFY_IMPORT_PATTERN.matcher(text).find()) {
+            return DetectorResult.empty();
+        }
+
         List<CodeNode> nodes = new ArrayList<>();
         List<CodeEdge> edges = new ArrayList<>();
-        String text = ctx.content();
         String filePath = ctx.filePath();
         String moduleName = ctx.moduleName();
         Set<String> seenIds = new HashSet<>();

src/test/java/io/github/randomcodespace/iq/detector/typescript/FastifyRouteDetectorTest.java

@@ -15,6 +15,8 @@ class FastifyRouteDetectorTest {
     @Test
     void detectsShorthandRoutes() {
         String code = """
+                import Fastify from 'fastify';
+                const fastify = Fastify();
                 fastify.get('/api/users', async (request, reply) => {});
                 fastify.post('/api/users', async (request, reply) => {});
                 """;
@@ -30,6 +32,7 @@ void detectsShorthandRoutes() {
     @Test
     void detectsHooks() {
         String code = """
+                import Fastify from 'fastify';
                 fastify.addHook('onRequest', async (request, reply) => {});
                 """;
         DetectorContext ctx = DetectorTestUtils.contextFor("src/app.ts", "typescript", code);
@@ -49,9 +52,38 @@ void noMatchOnNonFastifyCode() {
         assertTrue(result.edges().isEmpty());
     }
 
+    @Test
+    void noMatchOnExpressCode() {
+        String code = """
+                const express = require('express');
+                const router = express.Router();
+                router.get('/api/users', (req, res) => {});
+                router.post('/api/users', (req, res) => {});
+                """;
+        DetectorContext ctx = DetectorTestUtils.contextFor("src/routes.js", "javascript", code);
+        DetectorResult result = detector.detect(ctx);
+        assertTrue(result.nodes().isEmpty(), "Fastify detector should not match Express routes");
+        assertTrue(result.edges().isEmpty());
+    }
+
+    @Test
+    void matchesWithRequireFastify() {
+        String code = """
+                const fastify = require('fastify')();
+                fastify.get('/health', async () => ({ status: 'ok' }));
+                """;
+        DetectorContext ctx = DetectorTestUtils.contextFor("src/server.js", "javascript", code);
+        DetectorResult result = detector.detect(ctx);
+        assertEquals(1, result.nodes().size());
+        assertEquals("fastify", result.nodes().get(0).getProperties().get("framework"));
+    }
+
     @Test
     void deterministic() {
-        String code = "fastify.get('/test', handler);";
+        String code = """
+                import Fastify from 'fastify';
+                fastify.get('/test', handler);
+                """;
         DetectorContext ctx = DetectorTestUtils.contextFor("typescript", code);
         DetectorTestUtils.assertDeterministic(detector, ctx);
     }

src/test/java/io/github/randomcodespace/iq/detector/typescript/TypeScriptDetectorsExtendedTest.java

@@ -18,6 +18,8 @@ class FastifyExtended {
         @Test
         void detectsFastifyRoutes() {
             String code = """
+                    import Fastify from 'fastify';
+                    const fastify = Fastify();
                     fastify.get('/items', async (request, reply) => {
                       return db.items.findAll();
                     });
@@ -38,6 +40,7 @@ void detectsFastifyRoutes() {
         @Test
         void detectsRouteMethod() {
             String code = """
+                    import Fastify from 'fastify';
                     fastify.route({
                       method: 'GET',
                       url: '/api/health',

src/test/resources/e2e/ground-truth-petclinic.json

@@ -0,0 +1,44 @@
+{
+  "source": "Context7 /spring-projects/spring-petclinic + spring-petclinic source code",
+  "repo": "https://github.com/spring-projects/spring-petclinic",
+  "language": "java",
+  "framework": "spring-boot",
+  "entities": {
+    "Owner": {"table": "owners", "layer": "backend"},
+    "Pet": {"table": "pets", "layer": "backend"},
+    "Visit": {"table": "visits", "layer": "backend"},
+    "Vet": {"table": "vets", "layer": "backend"},
+    "Specialty": {"table": "specialties", "layer": "backend"},
+    "PetType": {"table": "types", "layer": "backend"}
+  },
+  "endpoints": [
+    {"method": "GET", "path": "/owners/new", "controller": "OwnerController"},
+    {"method": "POST", "path": "/owners/new", "controller": "OwnerController"},
+    {"method": "GET", "path": "/owners/find", "controller": "OwnerController"},
+    {"method": "GET", "path": "/owners", "controller": "OwnerController"},
+    {"method": "GET", "path": "/owners/{ownerId}/edit", "controller": "OwnerController"},
+    {"method": "POST", "path": "/owners/{ownerId}/edit", "controller": "OwnerController"},
+    {"method": "GET", "path": "/owners/{ownerId}", "controller": "OwnerController"},
+    {"method": "GET", "path": "/owners/{ownerId}/pets/new", "controller": "PetController"},
+    {"method": "POST", "path": "/owners/{ownerId}/pets/new", "controller": "PetController"},
+    {"method": "GET", "path": "/owners/{ownerId}/pets/{petId}/edit", "controller": "PetController"},
+    {"method": "POST", "path": "/owners/{ownerId}/pets/{petId}/edit", "controller": "PetController"},
+    {"method": "GET", "path": "/owners/{ownerId}/pets/{petId}/visits/new", "controller": "VisitController"},
+    {"method": "POST", "path": "/owners/{ownerId}/pets/{petId}/visits/new", "controller": "VisitController"},
+    {"method": "GET", "path": "/vets.html", "controller": "VetController"},
+    {"method": "GET", "path": "/vets", "controller": "VetController"},
+    {"method": "GET", "path": "/oups", "controller": "CrashController"}
+  ],
+  "controllers": ["OwnerController", "PetController", "VisitController", "VetController", "CrashController", "WelcomeController"],
+  "repositories": ["OwnerRepository"],
+  "expected_stats": {
+    "min_nodes": 500,
+    "min_edges": 1000,
+    "min_files": 50,
+    "min_endpoints": 16,
+    "min_classes": 30,
+    "min_methods": 30,
+    "primary_language": "java",
+    "no_false_frameworks": ["quarkus", "micronaut", "fastify"]
+  }
+}

src/test/resources/e2e/ground-truth-realworld-express.json

@@ -0,0 +1,17 @@
+{
+  "source": "RealWorld API spec + source code inspection",
+  "repo": "https://github.com/gothinkster/node-express-realworld-example-app",
+  "language": "typescript",
+  "framework": "express",
+  "entities": ["User", "Article", "Comment", "Tag"],
+  "endpoints_partial": ["/articles", "/users", "/users/login", "/user", "/tags", "/profiles"],
+  "expected_frameworks": ["express", "prisma"],
+  "expected_stats": {
+    "min_nodes": 100,
+    "min_edges": 50,
+    "min_endpoints": 15,
+    "primary_language": "typescript",
+    "has_auth": true,
+    "no_false_frameworks": ["quarkus", "micronaut", "spring"]
+  }
+}