@flaid/devmap 0.2.0

package/dist/analyzers/detectors/capabilityDetector.js

@@ -0,0 +1,288 @@
+// ---------------------------------------------------------------------------
+// Main entry
+// ---------------------------------------------------------------------------
+/**
+ * detectCapabilities — derive capabilities dari route patterns + entity graph.
+ *
+ * Berbeda dari featureDetector yang detect *library* yang dipakai (Stripe, Redis, dll),
+ * capabilityDetector detect *perilaku* yang di-expose project via routes.
+ *
+ * Contoh:
+ *   GET+POST+PUT+DELETE /snippets → crud capability pada entity "Snippet"
+ *   POST /snippets/[id]/share     → sharing capability
+ *   POST /workspaces/[id]/members → collaboration capability
+ *
+ * Input: RouteInfo[] + EntityGraph (untuk entity name mapping)
+ * Output: CapabilityInfo[]
+ */
+export function detectCapabilities(routes, entityGraph) {
+    if (routes.length === 0)
+        return [];
+    const capabilities = [];
+    const apiRoutes = routes.filter((r) => r.kind === "api");
+    const pageRoutes = routes.filter((r) => r.kind === "page");
+    // --- CRUD detection ---
+    const crudCapabilities = detectCrudCapabilities(apiRoutes, entityGraph);
+    capabilities.push(...crudCapabilities);
+    // --- Behavioral capabilities dari route patterns ---
+    // Only use API routes for behavioral detection — page routes produce too many
+    // false positives because page paths often contain domain keywords that
+    // don't represent actual capabilities (e.g. /search page = UI, not search infra)
+    const behavioral = detectBehavioralCapabilities(apiRoutes, entityGraph);
+    capabilities.push(...behavioral);
+    return deduplicateCapabilities(capabilities);
+}
+// ---------------------------------------------------------------------------
+// CRUD detection
+// ---------------------------------------------------------------------------
+function detectCrudCapabilities(apiRoutes, entityGraph) {
+    const resourceMap = new Map();
+    for (const route of apiRoutes) {
+        const resource = extractResourceName(route.path);
+        if (!resource)
+            continue;
+        const existing = resourceMap.get(resource) ?? {
+            methods: new Set(),
+            files: new Set()
+        };
+        for (const method of route.methods ?? []) {
+            existing.methods.add(method);
+        }
+        existing.files.add(route.file);
+        resourceMap.set(resource, existing);
+    }
+    const capabilities = [];
+    for (const [resource, { methods, files }] of resourceMap) {
+        const hasRead = methods.has("GET");
+        const hasWrite = methods.has("POST") || methods.has("PUT") || methods.has("PATCH");
+        const hasDelete = methods.has("DELETE");
+        if (!hasRead && !hasWrite)
+            continue;
+        const entityName = resolveEntityName(resource, entityGraph);
+        const isFull = hasRead && hasWrite && hasDelete;
+        capabilities.push({
+            kind: "crud",
+            name: `${entityName} Management`,
+            entities: [entityName],
+            evidence: [...files],
+            confidence: isFull ? "high" : "medium"
+        });
+    }
+    return capabilities;
+}
+// ---------------------------------------------------------------------------
+// Behavioral capabilities
+//
+// Threshold design rationale:
+//
+//   highConfidenceAt = 1 was too aggressive — a single route match on a
+//   generic path like /search or /stats was enough to create a "high"
+//   confidence feature, even when that route was just a UI page.
+//
+//   New thresholds:
+//   - Search: 2 — one /search page is a UI pattern, not a search infrastructure
+//   - Reporting: 2 — one /stats or /dashboard page doesn't mean reporting infra
+//   - Social: 3 — needs multiple social signals (likes AND comments, etc.)
+//   - All others: 1 or 2 depending on signal specificity
+//
+//   Additionally: behavioral detection now only runs on API routes (not page
+//   routes) to avoid UI pages being confused with backend capabilities.
+// ---------------------------------------------------------------------------
+const BEHAVIORAL_SIGNALS = [
+    // Sharing — specific enough that 1 match is fine
+    {
+        kind: "sharing",
+        name: "Content Sharing",
+        pathPatterns: [/\/(share|shares|shareId|shared)(\/|$)/i],
+        highConfidenceAt: 2,
+        minimumMatches: 1,
+    },
+    // Publishing
+    {
+        kind: "publishing",
+        name: "Content Publishing",
+        pathPatterns: [/\/(publish|unpublish|draft|drafts)(\/|$)/i],
+        highConfidenceAt: 1,
+        minimumMatches: 1,
+    },
+    // Collaboration — workspace/member/invite are strong signals
+    {
+        kind: "collaboration",
+        name: "Team Collaboration",
+        pathPatterns: [
+            /\/(workspace|workspaces)(\/|$)/i,
+            /\/(member|members|membership)(\/|$)/i,
+            /\/(invite|invites?|join)(\/|$)/i,
+            /\/(team|teams)(\/|$)/i,
+        ],
+        highConfidenceAt: 2,
+        minimumMatches: 1,
+    },
+    // Discovery
+    {
+        kind: "discovery",
+        name: "Public Discovery",
+        pathPatterns: [
+            /\/(explore|discover|browse)(\/|$)/i,
+            /\/(feed|trending|featured)(\/|$)/i,
+        ],
+        highConfidenceAt: 1,
+        minimumMatches: 1,
+    },
+    // Social — needs multiple signals to avoid false positives
+    // e.g. a single /comments route could be anything
+    {
+        kind: "social",
+        name: "Social Interactions",
+        pathPatterns: [
+            /\/(like|likes|favorite|favorites)(\/|$)/i,
+            /\/(reaction|reactions|upvote|downvote)(\/|$)/i,
+            /\/(comment|comments|reply|replies)(\/|$)/i,
+            /\/(follow|followers|following)(\/|$)/i,
+        ],
+        highConfidenceAt: 3,
+        minimumMatches: 2, // needs at least 2 distinct social routes to surface
+    },
+    // File management
+    {
+        kind: "file-management",
+        name: "File Management",
+        pathPatterns: [
+            /\/(upload|uploads)(\/|$)/i,
+            /\/(attachment|attachments)(\/|$)/i,
+            /\/(media|asset|assets)(\/|$)/i,
+        ],
+        highConfidenceAt: 1,
+        minimumMatches: 1,
+    },
+    // Real-time — transport-level signals only, very specific
+    {
+        kind: "real-time",
+        name: "Real-time Features",
+        pathPatterns: [
+            /\/(ws|websocket|socket)(\/|$)/i,
+            /\/(live|stream|streaming)(\/|$)/i,
+            /\/(sse|server-sent)(\/|$)/i,
+        ],
+        highConfidenceAt: 1,
+        minimumMatches: 1,
+    },
+    // Search — needs at least 2 API routes to surface
+    // A single /api/search could be a simple filter, not search infrastructure
+    {
+        kind: "search",
+        name: "Search",
+        pathPatterns: [/\/(search|find|query|lookup)(\/|$)/i],
+        highConfidenceAt: 2,
+        minimumMatches: 2, // must have at least 2 distinct search API routes
+    },
+    // Reporting — dashboard alone is not enough (many apps have a /dashboard page)
+    {
+        kind: "reporting",
+        name: "Statistics & Reporting",
+        pathPatterns: [
+            /\/(stats?|analytics?|metric|metrics)(\/|$)/i,
+            /\/(report|reports)(\/|$)/i,
+        ],
+        highConfidenceAt: 2,
+        minimumMatches: 1,
+    },
+];
+function detectBehavioralCapabilities(
+// Only API routes now — page routes removed to cut false positives
+apiRoutes, entityGraph) {
+    const capabilities = [];
+    for (const signal of BEHAVIORAL_SIGNALS) {
+        const matched = apiRoutes.filter((route) => signal.pathPatterns.some((pattern) => pattern.test(route.path)));
+        const minimum = signal.minimumMatches ?? 1;
+        if (matched.length < minimum)
+            continue;
+        const entities = [...new Set(matched
+                .map((r) => extractResourceName(r.path))
+                .filter((r) => r !== null)
+                .map((r) => resolveEntityName(r, entityGraph)))];
+        const threshold = signal.highConfidenceAt ?? 1;
+        const confidence = matched.length >= threshold ? "high" : "medium";
+        capabilities.push({
+            kind: signal.kind,
+            name: signal.name,
+            entities,
+            evidence: [...new Set(matched.map((r) => r.file))].slice(0, 5),
+            confidence
+        });
+    }
+    return capabilities;
+}
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+function extractResourceName(path) {
+    const segments = path
+        .split("/")
+        .filter(Boolean)
+        .filter((s) => !s.startsWith("["))
+        .filter((s) => !["api", "v1", "v2", "v3"].includes(s.toLowerCase()));
+    if (segments.length === 0)
+        return null;
+    const segment = segments[0].toLowerCase();
+    if (segment.length <= 2)
+        return null;
+    if (NON_RESOURCE_SEGMENTS.has(segment))
+        return null;
+    return segment;
+}
+function resolveEntityName(resource, entityGraph) {
+    const lower = resource.toLowerCase();
+    const direct = entityGraph.entityNames.find((name) => name.toLowerCase() === lower);
+    if (direct)
+        return direct;
+    const singular = singularize(lower);
+    const singularMatch = entityGraph.entityNames.find((name) => name.toLowerCase() === singular.toLowerCase());
+    if (singularMatch)
+        return singularMatch;
+    return singular.length === 0 ? singular : singular[0].toUpperCase() + singular.slice(1);
+}
+function singularize(word) {
+    if (word.endsWith("ies"))
+        return word.slice(0, -3) + "y";
+    if (word.endsWith("sses") ||
+        word.endsWith("xes") ||
+        word.endsWith("ches") ||
+        word.endsWith("ses")) {
+        return word.slice(0, -2);
+    }
+    if (word.endsWith("s") && !word.endsWith("ss"))
+        return word.slice(0, -1);
+    return word;
+}
+function deduplicateCapabilities(capabilities) {
+    const seen = new Map();
+    for (const cap of capabilities) {
+        const existing = seen.get(cap.kind);
+        if (!existing) {
+            seen.set(cap.kind, cap);
+            continue;
+        }
+        seen.set(cap.kind, {
+            ...existing,
+            entities: [...new Set([...existing.entities, ...cap.entities])],
+            evidence: [...new Set([...existing.evidence, ...cap.evidence])].slice(0, 5),
+            confidence: higherConfidence(existing.confidence, cap.confidence)
+        });
+    }
+    return [...seen.values()];
+}
+function higherConfidence(a, b) {
+    const rank = { high: 2, medium: 1, low: 0 };
+    return rank[a] >= rank[b] ? a : b;
+}
+// NON_RESOURCE_SEGMENTS — path segments yang bukan nama resource.
+const NON_RESOURCE_SEGMENTS = new Set([
+    "auth", "oauth", "callback", "health",
+    "ping", "status", "public", "internal",
+    "static", "assets", "files", "me", "self",
+    "history", "session", "sessions",
+    // tambahan: common Next.js/UI page paths yang bukan API resource
+    "dashboard", "settings", "profile", "search",
+]);
+//# sourceMappingURL=capabilityDetector.js.map

package/dist/analyzers/detectors/capabilityDetector.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"capabilityDetector.js","sourceRoot":"","sources":["../../../src/analyzers/detectors/capabilityDetector.ts"],"names":[],"mappings":"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"}

package/dist/analyzers/detectors/databaseDetector.d.ts

@@ -0,0 +1,7 @@
+import type { ScannedFile } from "../analysis/index.js";
+export type DatabaseInfo = {
+    provider: string;
+    files: string[];
+};
+export declare function detectDatabase(files: ScannedFile[]): DatabaseInfo | undefined;
+//# sourceMappingURL=databaseDetector.d.ts.map

package/dist/analyzers/detectors/databaseDetector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"databaseDetector.d.ts","sourceRoot":"","sources":["../../../src/analyzers/detectors/databaseDetector.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAGxD,MAAM,MAAM,YAAY,GAAG;IACzB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,EAAE,CAAC;CACjB,CAAC;AA4CF,wBAAgB,cAAc,CAAC,KAAK,EAAE,WAAW,EAAE,GAAG,YAAY,GAAG,SAAS,CAoB7E"}

package/dist/analyzers/detectors/databaseDetector.js

@@ -0,0 +1,71 @@
+import { isArchitectureSource } from "../graph/index.js";
+const DATABASE_SIGNALS = [
+    {
+        provider: "Prisma",
+        dependencies: ["@prisma/client", "prisma"],
+        paths: [/(^|\/)schema\.prisma$/, /(^|\/)prisma\//]
+    },
+    {
+        provider: "Drizzle",
+        dependencies: ["drizzle-orm"],
+        paths: [/(^|\/)drizzle\.config\.[cm]?[jt]s$/, /(^|\/)drizzle\//]
+    },
+    {
+        provider: "Mongoose",
+        dependencies: ["mongoose"],
+        paths: [/(^|\/)(models?|schemas?)\//]
+    },
+    {
+        provider: "Supabase",
+        dependencies: ["@supabase/supabase-js"],
+        paths: [/(^|\/)supabase\//]
+    },
+    {
+        provider: "PostgreSQL (raw SQL)",
+        dependencies: ["pg", "pg-promise"],
+        paths: []
+    },
+    {
+        provider: "MySQL (raw SQL)",
+        dependencies: ["mysql2", "mysql"],
+        paths: []
+    },
+    {
+        provider: "SQLite (raw SQL)",
+        dependencies: ["better-sqlite3", "sqlite3"],
+        paths: []
+    }
+];
+export function detectDatabase(files) {
+    const scopedFiles = files.filter((file) => isArchitectureSource(file.path));
+    const dependencies = readDependencies(scopedFiles);
+    for (const signal of DATABASE_SIGNALS) {
+        const matchedFiles = scopedFiles
+            .filter((file) => signal.paths.some((pattern) => pattern.test(file.path)))
+            .map((file) => file.path)
+            .sort();
+        const dependencyMatch = signal.dependencies.some((dependency) => dependencies.has(dependency));
+        if (dependencyMatch || matchedFiles.length > 0) {
+            return {
+                provider: signal.provider,
+                files: matchedFiles
+            };
+        }
+    }
+    return undefined;
+}
+function readDependencies(files) {
+    const dependencies = new Set();
+    for (const file of files.filter((item) => item.path.endsWith("package.json"))) {
+        try {
+            const parsed = JSON.parse(file.content);
+            Object.keys(parsed.dependencies ?? {}).forEach((name) => dependencies.add(name.toLowerCase()));
+            Object.keys(parsed.devDependencies ?? {}).forEach((name) => dependencies.add(name.toLowerCase()));
+        }
+        catch {
+            continue;
+        }
+    }
+    return dependencies;
+}
+//# sourceMappingURL=databaseDetector.js.map

package/dist/analyzers/detectors/databaseDetector.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"databaseDetector.js","sourceRoot":"","sources":["../../../src/analyzers/detectors/databaseDetector.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AAOzD,MAAM,gBAAgB,GAIjB;IACH;QACE,QAAQ,EAAE,QAAQ;QAClB,YAAY,EAAE,CAAC,gBAAgB,EAAE,QAAQ,CAAC;QAC1C,KAAK,EAAE,CAAC,uBAAuB,EAAE,gBAAgB,CAAC;KACnD;IACD;QACE,QAAQ,EAAE,SAAS;QACnB,YAAY,EAAE,CAAC,aAAa,CAAC;QAC7B,KAAK,EAAE,CAAC,oCAAoC,EAAE,iBAAiB,CAAC;KACjE;IACD;QACE,QAAQ,EAAE,UAAU;QACpB,YAAY,EAAE,CAAC,UAAU,CAAC;QAC1B,KAAK,EAAE,CAAC,4BAA4B,CAAC;KACtC;IACD;QACE,QAAQ,EAAE,UAAU;QACpB,YAAY,EAAE,CAAC,uBAAuB,CAAC;QACvC,KAAK,EAAE,CAAC,kBAAkB,CAAC;KAC5B;IACD;QACE,QAAQ,EAAE,sBAAsB;QAChC,YAAY,EAAE,CAAC,IAAI,EAAE,YAAY,CAAC;QAClC,KAAK,EAAE,EAAE;KACV;IACD;QACE,QAAQ,EAAE,iBAAiB;QAC3B,YAAY,EAAE,CAAC,QAAQ,EAAE,OAAO,CAAC;QACjC,KAAK,EAAE,EAAE;KACV;IACD;QACE,QAAQ,EAAE,kBAAkB;QAC5B,YAAY,EAAE,CAAC,gBAAgB,EAAE,SAAS,CAAC;QAC3C,KAAK,EAAE,EAAE;KACV;CACF,CAAC;AAEF,MAAM,UAAU,cAAc,CAAC,KAAoB;IACjD,MAAM,WAAW,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,oBAAoB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;IAC5E,MAAM,YAAY,GAAG,gBAAgB,CAAC,WAAW,CAAC,CAAC;IAEnD,KAAK,MAAM,MAAM,IAAI,gBAAgB,EAAE,CAAC;QACtC,MAAM,YAAY,GAAG,WAAW;aAC7B,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;aACzE,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC;aACxB,IAAI,EAAE,CAAC;QACV,MAAM,eAAe,GAAG,MAAM,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC,UAAU,EAAE,EAAE,CAAC,YAAY,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC;QAE/F,IAAI,eAAe,IAAI,YAAY,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC/C,OAAO;gBACL,QAAQ,EAAE,MAAM,CAAC,QAAQ;gBACzB,KAAK,EAAE,YAAY;aACpB,CAAC;QACJ,CAAC;IACH,CAAC;IAED,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,SAAS,gBAAgB,CAAC,KAAoB;IAC5C,MAAM,YAAY,GAAG,IAAI,GAAG,EAAU,CAAC;IAEvC,KAAK,MAAM,IAAI,IAAI,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,cAAc,CAAC,CAAC,EAAE,CAAC;QAC9E,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAGrC,CAAC;YAEF,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,YAAY,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,YAAY,CAAC,GAAG,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC;YAC/F,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,eAAe,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,YAAY,CAAC,GAAG,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC;QACpG,CAAC;QAAC,MAAM,CAAC;YACP,SAAS;QACX,CAAC;IACH,CAAC;IAED,OAAO,YAAY,CAAC;AACtB,CAAC"}

package/dist/analyzers/detectors/frameworkDetector.d.ts

@@ -0,0 +1,22 @@
+import type { ScannedFile } from "../analysis/index.js";
+export declare const FRONTEND_FRAMEWORKS: readonly ["nextjs", "nuxt", "sveltekit", "astro", "react", "vue", "svelte"];
+export declare const BACKEND_FRAMEWORKS: readonly ["nestjs", "fastify", "express", "koa"];
+export type FrontendFramework = typeof FRONTEND_FRAMEWORKS[number];
+export type BackendFramework = typeof BACKEND_FRAMEWORKS[number];
+export type Framework = FrontendFramework | BackendFramework | "unknown";
+export type DetectedFramework = Exclude<Framework, "unknown">;
+export declare const FRONTEND_FRAMEWORK_SET: Set<string>;
+export declare const BACKEND_FRAMEWORK_SET: Set<string>;
+export declare function detectFramework(files: ScannedFile[]): Framework;
+/**
+ * detectFrameworks — detect every framework signal, then return AT MOST one
+ * winner per category (frontend, backend). Frontend-first for display.
+ *
+ * A project with both a Next.js frontend and an Express backend (single
+ * package or monorepo scan) returns two entries instead of the single
+ * first-match-wins value the old flat order produced. `nextjs` still beats
+ * `astro` within the frontend category — the same first-match-wins rule is
+ * simply scoped per category now.
+ */
+export declare function detectFrameworks(files: ScannedFile[]): DetectedFramework[];
+//# sourceMappingURL=frameworkDetector.d.ts.map

package/dist/analyzers/detectors/frameworkDetector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"frameworkDetector.d.ts","sourceRoot":"","sources":["../../../src/analyzers/detectors/frameworkDetector.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAGxD,eAAO,MAAM,mBAAmB,6EAEtB,CAAC;AACX,eAAO,MAAM,kBAAkB,kDAErB,CAAC;AAEX,MAAM,MAAM,iBAAiB,GAAG,OAAO,mBAAmB,CAAC,MAAM,CAAC,CAAC;AACnE,MAAM,MAAM,gBAAgB,GAAG,OAAO,kBAAkB,CAAC,MAAM,CAAC,CAAC;AACjE,MAAM,MAAM,SAAS,GAAG,iBAAiB,GAAG,gBAAgB,GAAG,SAAS,CAAC;AACzE,MAAM,MAAM,iBAAiB,GAAG,OAAO,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC;AAE9D,eAAO,MAAM,sBAAsB,aAAuC,CAAC;AAC3E,eAAO,MAAM,qBAAqB,aAAsC,CAAC;AAEzE,wBAAgB,eAAe,CAAC,KAAK,EAAE,WAAW,EAAE,GAAG,SAAS,CAG/D;AAED;;;;;;;;;GASG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,WAAW,EAAE,GAAG,iBAAiB,EAAE,CA2H1E"}

package/dist/analyzers/detectors/frameworkDetector.js

@@ -0,0 +1,160 @@
+import { isArchitectureSource } from "../graph/index.js";
+export const FRONTEND_FRAMEWORKS = [
+    "nextjs", "nuxt", "sveltekit", "astro", "react", "vue", "svelte"
+];
+export const BACKEND_FRAMEWORKS = [
+    "nestjs", "fastify", "express", "koa"
+];
+export const FRONTEND_FRAMEWORK_SET = new Set(FRONTEND_FRAMEWORKS);
+export const BACKEND_FRAMEWORK_SET = new Set(BACKEND_FRAMEWORKS);
+export function detectFramework(files) {
+    const [frontendWinner, backendWinner] = detectFrameworks(files);
+    return frontendWinner ?? backendWinner ?? "unknown";
+}
+/**
+ * detectFrameworks — detect every framework signal, then return AT MOST one
+ * winner per category (frontend, backend). Frontend-first for display.
+ *
+ * A project with both a Next.js frontend and an Express backend (single
+ * package or monorepo scan) returns two entries instead of the single
+ * first-match-wins value the old flat order produced. `nextjs` still beats
+ * `astro` within the frontend category — the same first-match-wins rule is
+ * simply scoped per category now.
+ */
+export function detectFrameworks(files) {
+    const detected = new Set();
+    // Phase 1: dependency manifest — highest confidence signal.
+    // package.json is the canonical source of truth for what frameworks are installed.
+    for (const dependencies of readManifestDependencies(files)) {
+        if ("next" in dependencies)
+            detected.add("nextjs");
+        if ("express" in dependencies)
+            detected.add("express");
+        if ("astro" in dependencies)
+            detected.add("astro");
+        if ("nuxt" in dependencies)
+            detected.add("nuxt");
+        if ("fastify" in dependencies)
+            detected.add("fastify");
+        if ("@nestjs/core" in dependencies || "@nestjs/common" in dependencies) {
+            detected.add("nestjs");
+        }
+        if ("@sveltejs/kit" in dependencies)
+            detected.add("sveltekit");
+        const hasReactRuntime = "react-dom" in dependencies
+            || "react-scripts" in dependencies
+            || "@vitejs/plugin-react" in dependencies
+            || "@vitejs/plugin-react-swc" in dependencies;
+        if (!("next" in dependencies)
+            && !("astro" in dependencies)
+            && "react" in dependencies
+            && hasReactRuntime) {
+            detected.add("react");
+        }
+        // Nuxt apps ship App.vue too, so vue must exclude when nuxt is present —
+        // same mirror of the react-vs-next exclusion. The runtime gate prevents a
+        // Vue UI library (vue only in peerDependencies) from being labeled an app.
+        const hasVueRuntime = "@vitejs/plugin-vue" in dependencies
+            || "@vitejs/plugin-vue2" in dependencies
+            || "vue-cli-service" in dependencies;
+        if (!("nuxt" in dependencies) && "vue" in dependencies && hasVueRuntime) {
+            detected.add("vue");
+        }
+        const hasSvelteRuntime = "@sveltejs/vite-plugin-svelte" in dependencies;
+        if (!("@sveltejs/kit" in dependencies) && "svelte" in dependencies && hasSvelteRuntime) {
+            detected.add("svelte");
+        }
+    }
+    // Phase 2: file structure heuristics — secondary signal.
+    // Only used when package.json is absent or incomplete (e.g. monorepo root without deps).
+    const sourceFiles = files.filter((file) => isArchitectureSource(file.path));
+    // Next.js: next.config.* or App Router / Pages Router file conventions.
+    // _app and _document are Next.js-unique; a bare src/pages/api/ folder is NOT
+    // (Astro uses the same folder for endpoints), so it is deliberately excluded
+    // from the Pages Router signal here.
+    if (files.some((file) => /(^|\/)next\.config\.[cm]?[jt]s$/.test(file.path))
+        || sourceFiles.some((file) => /(^|\/)(?:src\/)?app\/(?:.+\/)?(?:page|layout|route)\.[jt]sx?$/.test(file.path)
+            || /(^|\/)(?:src\/)?pages\/(?:_app|_document)/.test(file.path))) {
+        detected.add("nextjs");
+    }
+    // Express: primarily via package.json dependency (see below for the file-only path).
+    const hasReliableManifest = files.some((file) => file.path.endsWith("package.json") && isArchitectureSource(file.path) && isParseableJson(file.content));
+    // Express: ONLY add via file heuristic if express was already confirmed in package.json,
+    // OR — narrow fallback — if package.json is missing/unparseable entirely.
+    //
+    // Rationale: `server.ts` and `app.ts` are common filenames in Next.js, NestJS, and vanilla
+    // Node projects. Without the dependency gate, a Next.js project with a custom `app.ts`
+    // utility file would be misclassified as Express. The dep check is the authoritative signal;
+    // the filename pattern alone is intentionally never used as a standalone trigger.
+    //
+    // When there's no reliable manifest to check at all, that filename ambiguity is still a
+    // real risk, so instead of trusting the filename we scan file *content* for an actual
+    // `express()` call or `require("express")`/`from "express"` — evidence specific enough
+    // that a Next.js app.ts utility file won't produce a false positive.
+    if (detected.has("express")
+        && sourceFiles.some((file) => /(^|\/)(?:src\/)?(?:server|app)\.[cm]?[jt]s$/.test(file.path))) {
+        // Already added via deps — this block intentionally left as documentation of the gate.
+        // The detected.add("express") already happened above; we don't re-add.
+    }
+    else if (!hasReliableManifest && sourceFiles.some((file) => hasExpressCallSite(file.content))) {
+        detected.add("express");
+    }
+    // Astro: src/pages/*.astro is specific enough to be safe as a standalone signal.
+    if (sourceFiles.some((file) => /(^|\/)src\/pages\/.+\.astro$/.test(file.path))) {
+        detected.add("astro");
+    }
+    // Nuxt: nuxt.config.* is as specific as next.config.* today.
+    if (files.some((file) => /(^|\/)nuxt\.config\.[cm]?[jt]s$/.test(file.path))) {
+        detected.add("nuxt");
+    }
+    // Vue: App.vue at the project root (or src/) is specific enough to stand alone.
+    if (sourceFiles.some((file) => /(^|\/)(?:src\/)?App\.vue$/.test(file.path))) {
+        detected.add("vue");
+    }
+    // SvelteKit: +page.svelte under src/routes/ is unique to SvelteKit — the "+"
+    // prefix is not used by any other framework. svelte.config.js is NOT used as a
+    // signal because non-SvelteKit Svelte projects have it too.
+    if (sourceFiles.some((file) => /(^|\/)src\/routes\/.+\+page\.svelte$/.test(file.path))) {
+        detected.add("sveltekit");
+    }
+    // NestJS: nest-cli.json is as specific as next.config.* / nuxt.config.*.
+    if (files.some((file) => /(^|\/)nest-cli\.json$/.test(file.path))) {
+        detected.add("nestjs");
+    }
+    return [
+        FRONTEND_FRAMEWORKS.find((framework) => detected.has(framework)),
+        BACKEND_FRAMEWORKS.find((framework) => detected.has(framework)),
+    ].filter((framework) => Boolean(framework));
+}
+function isParseableJson(content) {
+    try {
+        JSON.parse(content);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+function hasExpressCallSite(content) {
+    return /\bexpress\s*\(\s*\)/.test(content)
+        || /require\(\s*["']express["']\s*\)/.test(content)
+        || /from\s+["']express["']/.test(content);
+}
+function readManifestDependencies(files) {
+    return files
+        .filter((file) => file.path.endsWith("package.json") && isArchitectureSource(file.path))
+        .map((file) => readDependencies(file.content));
+}
+function readDependencies(content) {
+    try {
+        const parsed = JSON.parse(content);
+        return {
+            ...parsed.dependencies,
+            ...parsed.devDependencies
+        };
+    }
+    catch {
+        return {};
+    }
+}
+//# sourceMappingURL=frameworkDetector.js.map

package/dist/analyzers/detectors/frameworkDetector.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"frameworkDetector.js","sourceRoot":"","sources":["../../../src/analyzers/detectors/frameworkDetector.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AAEzD,MAAM,CAAC,MAAM,mBAAmB,GAAG;IACjC,QAAQ,EAAE,MAAM,EAAE,WAAW,EAAE,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,QAAQ;CACxD,CAAC;AACX,MAAM,CAAC,MAAM,kBAAkB,GAAG;IAChC,QAAQ,EAAE,SAAS,EAAE,SAAS,EAAE,KAAK;CAC7B,CAAC;AAOX,MAAM,CAAC,MAAM,sBAAsB,GAAG,IAAI,GAAG,CAAS,mBAAmB,CAAC,CAAC;AAC3E,MAAM,CAAC,MAAM,qBAAqB,GAAG,IAAI,GAAG,CAAS,kBAAkB,CAAC,CAAC;AAEzE,MAAM,UAAU,eAAe,CAAC,KAAoB;IAClD,MAAM,CAAC,cAAc,EAAE,aAAa,CAAC,GAAG,gBAAgB,CAAC,KAAK,CAAC,CAAC;IAChE,OAAO,cAAc,IAAI,aAAa,IAAI,SAAS,CAAC;AACtD,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,gBAAgB,CAAC,KAAoB;IACnD,MAAM,QAAQ,GAAG,IAAI,GAAG,EAAqB,CAAC;IAE9C,4DAA4D;IAC5D,mFAAmF;IACnF,KAAK,MAAM,YAAY,IAAI,wBAAwB,CAAC,KAAK,CAAC,EAAE,CAAC;QAC3D,IAAI,MAAM,IAAI,YAAY;YAAE,QAAQ,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QACnD,IAAI,SAAS,IAAI,YAAY;YAAE,QAAQ,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QACvD,IAAI,OAAO,IAAI,YAAY;YAAE,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QACnD,IAAI,MAAM,IAAI,YAAY;YAAE,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QACjD,IAAI,SAAS,IAAI,YAAY;YAAE,QAAQ,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QACvD,IAAI,cAAc,IAAI,YAAY,IAAI,gBAAgB,IAAI,YAAY,EAAE,CAAC;YACvE,QAAQ,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QACzB,CAAC;QACD,IAAI,eAAe,IAAI,YAAY;YAAE,QAAQ,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;QAE/D,MAAM,eAAe,GAAG,WAAW,IAAI,YAAY;eAC9C,eAAe,IAAI,YAAY;eAC/B,sBAAsB,IAAI,YAAY;eACtC,0BAA0B,IAAI,YAAY,CAAC;QAChD,IACE,CAAC,CAAC,MAAM,IAAI,YAAY,CAAC;eACtB,CAAC,CAAC,OAAO,IAAI,YAAY,CAAC;eAC1B,OAAO,IAAI,YAAY;eACvB,eAAe,EAClB,CAAC;YACD,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QACxB,CAAC;QAED,yEAAyE;QACzE,0EAA0E;QAC1E,2EAA2E;QAC3E,MAAM,aAAa,GAAG,oBAAoB,IAAI,YAAY;eACrD,qBAAqB,IAAI,YAAY;eACrC,iBAAiB,IAAI,YAAY,CAAC;QACvC,IAAI,CAAC,CAAC,MAAM,IAAI,YAAY,CAAC,IAAI,KAAK,IAAI,YAAY,IAAI,aAAa,EAAE,CAAC;YACxE,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QACtB,CAAC;QAED,MAAM,gBAAgB,GAAG,8BAA8B,IAAI,YAAY,CAAC;QACxE,IAAI,CAAC,CAAC,eAAe,IAAI,YAAY,CAAC,IAAI,QAAQ,IAAI,YAAY,IAAI,gBAAgB,EAAE,CAAC;YACvF,QAAQ,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QACzB,CAAC;IACH,CAAC;IAED,yDAAyD;IACzD,yFAAyF;IACzF,MAAM,WAAW,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,oBAAoB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;IAE5E,wEAAwE;IACxE,6EAA6E;IAC7E,6EAA6E;IAC7E,qCAAqC;IACrC,IACE,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,iCAAiC,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;WACpE,WAAW,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAC3B,+DAA+D,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC;eAC5E,2CAA2C,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAC/D,EACD,CAAC;QACD,QAAQ,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;IACzB,CAAC;IAED,qFAAqF;IACrF,MAAM,mBAAmB,GAAG,KAAK,CAAC,IAAI,CACpC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,cAAc,CAAC,IAAI,oBAAoB,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,eAAe,CAAC,IAAI,CAAC,OAAO,CAAC,CACjH,CAAC;IAEF,yFAAyF;IACzF,0EAA0E;IAC1E,EAAE;IACF,2FAA2F;IAC3F,uFAAuF;IACvF,6FAA6F;IAC7F,kFAAkF;IAClF,EAAE;IACF,wFAAwF;IACxF,sFAAsF;IACtF,uFAAuF;IACvF,qEAAqE;IACrE,IACE,QAAQ,CAAC,GAAG,CAAC,SAAS,CAAC;WACpB,WAAW,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAC3B,6CAA6C,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAC9D,EACD,CAAC;QACD,uFAAuF;QACvF,uEAAuE;IACzE,CAAC;SAAM,IAAI,CAAC,mBAAmB,IAAI,WAAW,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,kBAAkB,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,EAAE,CAAC;QAChG,QAAQ,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;IAC1B,CAAC;IAED,iFAAiF;IACjF,IAAI,WAAW,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,8BAA8B,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC;QAC/E,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;IACxB,CAAC;IAED,6DAA6D;IAC7D,IAAI,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,iCAAiC,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC;QAC5E,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IACvB,CAAC;IAED,gFAAgF;IAChF,IAAI,WAAW,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,2BAA2B,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC;QAC5E,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;IACtB,CAAC;IAED,6EAA6E;IAC7E,+EAA+E;IAC/E,4DAA4D;IAC5D,IAAI,WAAW,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,sCAAsC,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC;QACvF,QAAQ,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;IAC5B,CAAC;IAED,yEAAyE;IACzE,IAAI,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,uBAAuB,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC;QAClE,QAAQ,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;IACzB,CAAC;IAED,OAAO;QACL,mBAAmB,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,QAAQ,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QAChE,kBAAkB,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,QAAQ,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;KAChE,CAAC,MAAM,CAAC,CAAC,SAAS,EAAqD,EAAE,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC;AACjG,CAAC;AAED,SAAS,eAAe,CAAC,OAAe;IACtC,IAAI,CAAC;QACH,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QACpB,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED,SAAS,kBAAkB,CAAC,OAAe;IACzC,OAAO,qBAAqB,CAAC,IAAI,CAAC,OAAO,CAAC;WACrC,kCAAkC,CAAC,IAAI,CAAC,OAAO,CAAC;WAChD,wBAAwB,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;AAC9C,CAAC;AAED,SAAS,wBAAwB,CAAC,KAAoB;IACpD,OAAO,KAAK;SACT,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CACf,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,cAAc,CAAC,IAAI,oBAAoB,CAAC,IAAI,CAAC,IAAI,CAAC,CACtE;SACA,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,gBAAgB,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC;AACnD,CAAC;AAED,SAAS,gBAAgB,CAAC,OAAe;IACvC,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAGhC,CAAC;QAEF,OAAO;YACL,GAAG,MAAM,CAAC,YAAY;YACtB,GAAG,MAAM,CAAC,eAAe;SAC1B,CAAC;IACJ,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;AACH,CAAC"}

package/dist/analyzers/detectors/frontendFeatureDetector.d.ts

@@ -0,0 +1,26 @@
+import type { RouteInfo } from "./routeDetector.js";
+import type { ScannedFile } from "../analysis/index.js";
+import type { FileGraph } from "../graph/dependencyGraph.js";
+import type { FeatureInfo } from "../features/featureDetector.js";
+/**
+ * detectFrontendPageFeatures — turn Next.js App/Pages Router page routes into
+ * features, independent of whether any database entity was found.
+ *
+ * Why this needs to be independent: entity-derived features (Prisma/SQL/
+ * route-hint) only run as a fallback chain that stops at the first non-empty
+ * source. A project with even one Prisma model (e.g. a NextAuth Session
+ * table) never reaches route-hint fallback, so page-only features like
+ * "Quran" or "Dzikir" — which have zero database presence — never surfaced
+ * at all. This runs unconditionally and merges alongside whatever else was
+ * found, so a mostly-frontend project doesn't get its features dominated by
+ * whatever thin backend evidence happens to exist.
+ */
+export declare function detectFrontendPageFeatures(routes: RouteInfo[], fileGraph: FileGraph): FeatureInfo[];
+/**
+ * detectClientRouteFeatures — same purpose and output shape as
+ * detectFrontendPageFeatures, for SPAs with no file-based routing (Vite +
+ * React Router). Route paths come from parsing route definitions instead of
+ * folder conventions; ownership uses the exact same reverse-graph rule.
+ */
+export declare function detectClientRouteFeatures(files: ScannedFile[], fileGraph: FileGraph): FeatureInfo[];
+//# sourceMappingURL=frontendFeatureDetector.d.ts.map

package/dist/analyzers/detectors/frontendFeatureDetector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"frontendFeatureDetector.d.ts","sourceRoot":"","sources":["../../../src/analyzers/detectors/frontendFeatureDetector.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AACpD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AACxD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,6BAA6B,CAAC;AAG7D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gCAAgC,CAAC;AAuBlE;;;;;;;;;;;;GAYG;AACH,wBAAgB,0BAA0B,CACxC,MAAM,EAAE,SAAS,EAAE,EACnB,SAAS,EAAE,SAAS,GACnB,WAAW,EAAE,CA2Bf;AA+JD;;;;;GAKG;AACH,wBAAgB,yBAAyB,CACvC,KAAK,EAAE,WAAW,EAAE,EACpB,SAAS,EAAE,SAAS,GACnB,WAAW,EAAE,CA2Cf"}