@flaid/devmap 0.3.0 → 0.3.2

package/dist/analyzers/analysis/extractors/fallbackExtractor.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"fallbackExtractor.d.ts","sourceRoot":"","sources":["../../../../src/analyzers/analysis/extractors/fallbackExtractor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAC;AAC1D,OAAO,KAAK,EAAE,UAAU,EAAE,uBAAuB,EAAE,MAAM,YAAY,CAAC;AAsCtE;;;;;;;;;;;GAWG;AACH,qBAAa,sBAAuB,YAAW,uBAAuB;IACpE,QAAQ,CAAC,IAAI,oBAAoB;IAEjC,OAAO,CAAC,MAAM,EAAE,SAAS,EAAE,GAAG,UAAU,EAAE;CAyB3C;AAMD;;;;;;;;;GASG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CA4BhD"}
+{"version":3,"file":"fallbackExtractor.d.ts","sourceRoot":"","sources":["../../../../src/analyzers/analysis/extractors/fallbackExtractor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAC;AAC1D,OAAO,KAAK,EAAE,UAAU,EAAE,uBAAuB,EAAE,MAAM,YAAY,CAAC;AAsCtE;;;;;;;;;;;GAWG;AACH,qBAAa,sBAAuB,YAAW,uBAAuB;IACpE,QAAQ,CAAC,IAAI,oBAAoB;IAEjC,OAAO,CAAC,MAAM,EAAE,SAAS,EAAE,GAAG,UAAU,EAAE;CAoC3C;AAMD;;;;;;;;;GASG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CA4BhD"}

package/dist/analyzers/analysis/extractors/fallbackExtractor.js

@@ -48,10 +48,19 @@ export class RouteFallbackExtractor {
         const entityNames = new Set();
         for (const route of routes.filter((r) => r.kind === "api")) {
             const segments = route.path.split("/").filter(Boolean);
+            let prevWasDynamic = false;
             for (const segment of segments) {
                 // Skip dynamic segments: [id], [slug], [...catchall]
-                if (segment.startsWith("["))
+                if (segment.startsWith("[")) {
+                    prevWasDynamic = true;
                     continue;
+                }
+                // Segments immediately after a dynamic parameter are sub-resources
+                // (e.g. /api/workspaces/[id]/members → "members" is a sub-resource of "workspaces")
+                if (prevWasDynamic) {
+                    prevWasDynamic = false;
+                    continue;
+                }
                 // Skip short segments: "v1", "id", dll
                 if (segment.length <= 2)
                     continue;
@@ -59,6 +68,7 @@ export class RouteFallbackExtractor {
                 if (ROUTE_NON_ENTITY_SEGMENTS.has(segment.toLowerCase()))
                     continue;
                 entityNames.add(singularize(segment));
+                prevWasDynamic = false;
             }
         }
         return [...entityNames].map((name) => ({

package/dist/analyzers/analysis/extractors/fallbackExtractor.js.map

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

package/dist/analyzers/features/featureCandidates.d.ts

@@ -0,0 +1,59 @@
+import type { FeatureInfo } from "./featureDetector.js";
+export type FeatureCandidateSource = "registry" | "capability" | "entity" | "frontend-page" | "client-route" | "ai";
+export type ObservationReliability = "high" | "medium" | "low";
+export interface FeatureEvidence {
+    ruleId: string;
+    source: FeatureCandidateSource;
+    files: string[];
+    routePaths?: string[];
+    entityNames?: string[];
+    detail: string;
+    reliability: ObservationReliability;
+}
+export interface FeatureCandidate {
+    id: string;
+    label: string;
+    source: FeatureCandidateSource;
+    evidence: FeatureEvidence[];
+    files: string[];
+    routePaths: string[];
+    entityNames: string[];
+    conclusionConfidence: "high" | "medium" | "low";
+    /** Internal compatibility payload used while the public snapshot remains V1. */
+    projection?: FeatureInfo;
+}
+export type AnchorType = "entity" | "file" | "route-resource" | "alias";
+export interface MergeDecision {
+    candidateIds: [string, string];
+    outcome: "merged" | "rejected" | "retained";
+    anchors: Array<{
+        type: AnchorType;
+        value: string;
+    }>;
+    similarity?: number;
+    reason: string;
+}
+export type FeatureCluster = {
+    id: string;
+    canonicalCandidateId: string;
+    canonicalLabel: string;
+    aliases: string[];
+    candidates: FeatureCandidate[];
+    memberIds: string[];
+    anchors: string[];
+    decisionRationale: string;
+};
+export type FeatureReconciliation = {
+    clusters: FeatureCluster[];
+    rejectedCandidateIds: string[];
+    mergeDecisions?: MergeDecision[];
+};
+/**
+ * Reconcile complete candidate sets using hard evidence anchors only. Names
+ * only influence the deterministic canonical-label tie break after candidates
+ * are already in the same connected component.
+ */
+export declare function reconcileFeatureCandidates(candidates: FeatureCandidate[]): FeatureReconciliation;
+/** Project only deterministic clusters to the established public snapshot shape. */
+export declare function projectFeatureCandidates(clusters: FeatureCluster[]): FeatureInfo[];
+//# sourceMappingURL=featureCandidates.d.ts.map

package/dist/analyzers/features/featureCandidates.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"featureCandidates.d.ts","sourceRoot":"","sources":["../../../src/analyzers/features/featureCandidates.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAExD,MAAM,MAAM,sBAAsB,GAC9B,UAAU,GACV,YAAY,GACZ,QAAQ,GACR,eAAe,GACf,cAAc,GACd,IAAI,CAAC;AAET,MAAM,MAAM,sBAAsB,GAAG,MAAM,GAAG,QAAQ,GAAG,KAAK,CAAC;AAE/D,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,sBAAsB,CAAC;IAC/B,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,sBAAsB,CAAC;CACrC;AAED,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,sBAAsB,CAAC;IAC/B,QAAQ,EAAE,eAAe,EAAE,CAAC;IAC5B,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,oBAAoB,EAAE,MAAM,GAAG,QAAQ,GAAG,KAAK,CAAC;IAChD,gFAAgF;IAChF,UAAU,CAAC,EAAE,WAAW,CAAC;CAC1B;AAED,MAAM,MAAM,UAAU,GAAG,QAAQ,GAAG,MAAM,GAAG,gBAAgB,GAAG,OAAO,CAAC;AAExE,MAAM,WAAW,aAAa;IAC5B,YAAY,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC/B,OAAO,EAAE,QAAQ,GAAG,UAAU,GAAG,UAAU,CAAC;IAC5C,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,UAAU,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACpD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,MAAM,cAAc,GAAG;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,oBAAoB,EAAE,MAAM,CAAC;IAC7B,cAAc,EAAE,MAAM,CAAC;IACvB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,UAAU,EAAE,gBAAgB,EAAE,CAAC;IAC/B,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,iBAAiB,EAAE,MAAM,CAAC;CAC3B,CAAC;AAEF,MAAM,MAAM,qBAAqB,GAAG;IAClC,QAAQ,EAAE,cAAc,EAAE,CAAC;IAC3B,oBAAoB,EAAE,MAAM,EAAE,CAAC;IAC/B,cAAc,CAAC,EAAE,aAAa,EAAE,CAAC;CAClC,CAAC;AAuBF;;;;GAIG;AACH,wBAAgB,0BAA0B,CAAC,UAAU,EAAE,gBAAgB,EAAE,GAAG,qBAAqB,CAgEhG;AAED,oFAAoF;AACpF,wBAAgB,wBAAwB,CAAC,QAAQ,EAAE,cAAc,EAAE,GAAG,WAAW,EAAE,CA4BlF"}

package/dist/analyzers/features/featureCandidates.js

@@ -0,0 +1,238 @@
+const SOURCE_PRIORITY = {
+    "frontend-page": 6,
+    "client-route": 5,
+    entity: 4,
+    capability: 3,
+    registry: 2,
+    ai: 0,
+};
+const RELIABILITY_PRIORITY = {
+    high: 3,
+    medium: 2,
+    low: 1,
+};
+const CONFIDENCE_PRIORITY = {
+    high: 3,
+    medium: 2,
+    low: 1,
+};
+/**
+ * Reconcile complete candidate sets using hard evidence anchors only. Names
+ * only influence the deterministic canonical-label tie break after candidates
+ * are already in the same connected component.
+ */
+export function reconcileFeatureCandidates(candidates) {
+    const deterministicCandidates = candidates
+        .filter((candidate) => candidate.source !== "ai")
+        .map(normalizeCandidate)
+        .sort((left, right) => left.id.localeCompare(right.id));
+    const rejectedCandidateIds = candidates
+        .filter((candidate) => candidate.source === "ai")
+        .map((candidate) => candidate.id)
+        .sort();
+    const unionFind = new UnionFind(deterministicCandidates.length);
+    const anchorsByPair = new Map();
+    const structuredAnchorsByPair = new Map();
+    const mergeDecisions = [];
+    for (const rejectedId of rejectedCandidateIds) {
+        mergeDecisions.push({
+            candidateIds: [rejectedId, ""],
+            outcome: "rejected",
+            anchors: [],
+            reason: "AI-sourced candidate rejected from deterministic reconciliation.",
+        });
+    }
+    for (let left = 0; left < deterministicCandidates.length; left += 1) {
+        for (let right = left + 1; right < deterministicCandidates.length; right += 1) {
+            const leftCandidate = deterministicCandidates[left];
+            const rightCandidate = deterministicCandidates[right];
+            const structured = findStructuredAnchors(leftCandidate, rightCandidate);
+            if (structured.length === 0) {
+                mergeDecisions.push({
+                    candidateIds: [leftCandidate.id, rightCandidate.id],
+                    outcome: "retained",
+                    anchors: [],
+                    reason: "No hard anchor found; candidates remain separate.",
+                });
+                continue;
+            }
+            const anchorStrings = structured.map((a) => `${a.type}:${a.value}`);
+            unionFind.union(left, right);
+            anchorsByPair.set(`${left}:${right}`, anchorStrings);
+            structuredAnchorsByPair.set(`${left}:${right}`, structured);
+            mergeDecisions.push({
+                candidateIds: [leftCandidate.id, rightCandidate.id],
+                outcome: "merged",
+                anchors: structured,
+                reason: `Merged by hard anchors: ${anchorStrings.join(", ")}.`,
+            });
+        }
+    }
+    const componentIndexes = new Map();
+    deterministicCandidates.forEach((_, index) => {
+        const root = unionFind.find(index);
+        const indexes = componentIndexes.get(root) ?? [];
+        indexes.push(index);
+        componentIndexes.set(root, indexes);
+    });
+    const clusters = [...componentIndexes.values()]
+        .map((indexes) => createCluster(indexes, deterministicCandidates, anchorsByPair))
+        .sort((left, right) => left.id.localeCompare(right.id));
+    return { clusters, rejectedCandidateIds, mergeDecisions };
+}
+/** Project only deterministic clusters to the established public snapshot shape. */
+export function projectFeatureCandidates(clusters) {
+    return clusters
+        .filter((cluster) => cluster.candidates.some((candidate) => candidate.source !== "ai"))
+        .map((cluster) => {
+        const projection = projectCompatibilityFeature(cluster);
+        if (projection)
+            return projection;
+        const files = uniqueSorted(cluster.candidates.flatMap((candidate) => candidate.files));
+        const searchTerms = uniqueSorted(cluster.candidates.flatMap((candidate) => [
+            ...candidate.entityNames,
+            ...candidate.routePaths.map(routeResource),
+        ]).filter(Boolean));
+        const evidence = uniqueSorted(cluster.candidates.flatMap((candidate) => candidate.evidence.flatMap((item) => item.files)));
+        return {
+            name: cluster.canonicalLabel,
+            purpose: `Deterministic ${cluster.canonicalLabel} feature cluster.`,
+            files,
+            entryPoints: [],
+            businessFlow: [],
+            searchTerms,
+            confidence: clusterConfidence(cluster.candidates),
+            evidence,
+        };
+    })
+        .sort((left, right) => left.name.localeCompare(right.name));
+}
+function projectCompatibilityFeature(cluster) {
+    const canonical = cluster.candidates.find((candidate) => candidate.id === cluster.canonicalCandidateId)?.projection;
+    if (!canonical)
+        return undefined;
+    const projections = cluster.candidates
+        .map((candidate) => candidate.projection)
+        .filter((candidate) => Boolean(candidate));
+    const files = uniqueSorted(projections.flatMap((feature) => feature.files));
+    const evidence = uniqueSorted(projections.flatMap((feature) => feature.evidence));
+    const entryPoints = uniqueSorted(projections.flatMap((feature) => feature.entryPoints));
+    const searchTerms = uniqueSorted(projections.flatMap((feature) => feature.searchTerms)).slice(0, 8);
+    return {
+        ...canonical,
+        files,
+        evidence,
+        entryPoints,
+        ...(entryPoints[0] ? { entryPoint: entryPoints[0] } : {}),
+        searchTerms,
+        confidence: clusterConfidence(cluster.candidates),
+    };
+}
+function createCluster(indexes, candidates, anchorsByPair) {
+    const members = indexes.map((index) => candidates[index]).sort((left, right) => left.id.localeCompare(right.id));
+    const canonical = [...members].sort(compareCanonicalCandidates)[0];
+    const anchors = uniqueSorted(indexes.flatMap((left) => indexes.flatMap((right) => left < right ? anchorsByPair.get(`${left}:${right}`) ?? [] : [])));
+    return {
+        id: `cluster:${members.map((candidate) => candidate.id).join("|")}`,
+        canonicalCandidateId: canonical.id,
+        canonicalLabel: canonical.label,
+        aliases: uniqueSorted(members.map((candidate) => candidate.label).filter((label) => label !== canonical.label)),
+        candidates: members,
+        memberIds: members.map((candidate) => candidate.id),
+        anchors,
+        decisionRationale: anchors.length === 0
+            ? "Single candidate retained because no hard anchor connected it to another candidate."
+            : `Merged by hard anchors: ${anchors.join(", ")}. Canonical label selected by source priority, evidence reliability, and candidate ID.`,
+    };
+}
+function compareCanonicalCandidates(left, right) {
+    const source = SOURCE_PRIORITY[right.source] - SOURCE_PRIORITY[left.source];
+    if (source !== 0)
+        return source;
+    const reliability = highestReliability(right.evidence) - highestReliability(left.evidence);
+    if (reliability !== 0)
+        return reliability;
+    const evidence = right.evidence.length - left.evidence.length;
+    if (evidence !== 0)
+        return evidence;
+    return left.id.localeCompare(right.id);
+}
+function findHardAnchors(left, right) {
+    return findStructuredAnchors(left, right).map((a) => `${a.type}:${a.value}`);
+}
+function findStructuredAnchors(left, right) {
+    const entityAnchors = intersection(left.entityNames, right.entityNames)
+        .map((entity) => ({ type: "entity", value: entity }));
+    const fileAnchors = intersection(left.files, right.files)
+        .map((file) => ({ type: "file", value: file }));
+    const routeAnchors = intersection(left.routePaths.map(routeResource).filter(Boolean), right.routePaths.map(routeResource).filter(Boolean)).map((resource) => ({ type: "route-resource", value: resource }));
+    return [...entityAnchors, ...fileAnchors, ...routeAnchors];
+}
+function routeResource(routePath) {
+    const parts = routePath
+        .split("/")
+        .filter(Boolean)
+        .filter((part) => part !== "api" && !part.startsWith("[") && !part.startsWith(":"));
+    return parts[0]?.toLowerCase() ?? "";
+}
+function normalizeCandidate(candidate) {
+    return {
+        ...candidate,
+        evidence: candidate.evidence.map((item) => ({
+            ...item,
+            files: uniqueSorted(item.files),
+            ...(item.routePaths ? { routePaths: uniqueSorted(item.routePaths) } : {}),
+            ...(item.entityNames ? { entityNames: uniqueSorted(item.entityNames) } : {}),
+        })).sort((left, right) => left.ruleId.localeCompare(right.ruleId)),
+        files: uniqueSorted(candidate.files),
+        routePaths: uniqueSorted(candidate.routePaths),
+        entityNames: uniqueSorted(candidate.entityNames),
+    };
+}
+function clusterConfidence(candidates) {
+    const corroboratedSources = new Set(candidates.map((candidate) => candidate.source));
+    const hasHighConclusion = candidates.some((candidate) => candidate.conclusionConfidence === "high");
+    if (hasHighConclusion && corroboratedSources.size >= 2)
+        return "high";
+    return candidates
+        .map((candidate) => candidate.conclusionConfidence)
+        .sort((left, right) => CONFIDENCE_PRIORITY[right] - CONFIDENCE_PRIORITY[left])[0] ?? "low";
+}
+function highestReliability(evidence) {
+    return Math.max(0, ...evidence.map((item) => RELIABILITY_PRIORITY[item.reliability]));
+}
+function intersection(left, right) {
+    const rightSet = new Set(right.map(normalizeAnchor));
+    return left.filter((value) => rightSet.has(normalizeAnchor(value)));
+}
+function normalizeAnchor(value) {
+    return value.trim().toLowerCase();
+}
+function uniqueSorted(values) {
+    return [...new Set(values)].sort((left, right) => left.localeCompare(right));
+}
+class UnionFind {
+    parent;
+    constructor(size) {
+        this.parent = Array.from({ length: size }, (_, index) => index);
+    }
+    find(index) {
+        if (this.parent[index] !== index) {
+            this.parent[index] = this.find(this.parent[index]);
+        }
+        return this.parent[index];
+    }
+    union(left, right) {
+        const leftRoot = this.find(left);
+        const rightRoot = this.find(right);
+        if (leftRoot === rightRoot)
+            return;
+        if (leftRoot < rightRoot) {
+            this.parent[rightRoot] = leftRoot;
+        }
+        else {
+            this.parent[leftRoot] = rightRoot;
+        }
+    }
+}
+//# sourceMappingURL=featureCandidates.js.map

package/dist/analyzers/features/featureCandidates.js.map

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

package/dist/analyzers/features/featureDetector.d.ts

@@ -17,6 +17,7 @@ export type FileTier = "primary" | "supporting" | "reference" | "excluded";
 export declare function classifyFileTier(path: string): FileTier;
 export declare function detectFeatures(files: ScannedFile[], analyses: Record<string, FileAnalysis>, routes: RouteInfo[], database?: DatabaseInfo, entityGraph?: EntityGraph, capabilities?: CapabilityInfo[], fileGraph?: FileGraph): FeatureInfo[];
 export declare function detectAuthenticationSemanticRole(path: string, symbols: string[], imports: string[], content?: string): AuthSemanticRole | null;
+export declare function featureFilePriority(featureName: string, path: string): number;
 export declare function orderAuthenticationFiles(files: string[]): string[];
 export declare function authenticationFilePriority(path: string): number;
 //# sourceMappingURL=featureDetector.d.ts.map

package/dist/analyzers/features/featureDetector.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"featureDetector.d.ts","sourceRoot":"","sources":["../../../src/analyzers/features/featureDetector.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,YAAY,EACZ,WAAW,EACX,WAAW,EAEZ,MAAM,sBAAsB,CAAC;AAE9B,OAAO,KAAK,EACV,YAAY,EACZ,SAAS,EACT,cAAc,EACf,MAAM,uBAAuB,CAAC;AAE/B,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,6BAA6B,CAAC;AAK7D,MAAM,MAAM,WAAW,GAAG;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,UAAU,EAAE,MAAM,GAAG,QAAQ,GAAG,KAAK,CAAC;IACtC,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB,CAAC;AAEF,MAAM,MAAM,gBAAgB,GAAG,aAAa,GAAG,OAAO,GAAG,UAAU,GAAG,UAAU,CAAC;AAuOjF,MAAM,MAAM,QAAQ,GAAG,SAAS,GAAG,YAAY,GAAG,WAAW,GAAG,UAAU,CAAC;AAE3E,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,QAAQ,CAkBvD;AA6BD,wBAAgB,cAAc,CAC5B,KAAK,EAAE,WAAW,EAAE,EACpB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,EACtC,MAAM,EAAE,SAAS,EAAE,EACnB,QAAQ,CAAC,EAAE,YAAY,EACvB,WAAW,CAAC,EAAE,WAAW,EACzB,YAAY,CAAC,EAAE,cAAc,EAAE,EAC/B,SAAS,CAAC,EAAE,SAAS,GACpB,WAAW,EAAE,CAkGf;AA8cD,wBAAgB,gCAAgC,CAC9C,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,EAAE,EACjB,OAAO,EAAE,MAAM,EAAE,EACjB,OAAO,SAAK,GACX,gBAAgB,GAAG,IAAI,CAwCzB;AAsBD,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE,CAKlE;AAED,wBAAgB,0BAA0B,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAY/D"}
+{"version":3,"file":"featureDetector.d.ts","sourceRoot":"","sources":["../../../src/analyzers/features/featureDetector.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,YAAY,EACZ,WAAW,EACX,WAAW,EAEZ,MAAM,sBAAsB,CAAC;AAE9B,OAAO,KAAK,EACV,YAAY,EACZ,SAAS,EACT,cAAc,EACf,MAAM,uBAAuB,CAAC;AAE/B,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,6BAA6B,CAAC;AAU7D,MAAM,MAAM,WAAW,GAAG;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,UAAU,EAAE,MAAM,GAAG,QAAQ,GAAG,KAAK,CAAC;IACtC,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB,CAAC;AAEF,MAAM,MAAM,gBAAgB,GAAG,aAAa,GAAG,OAAO,GAAG,UAAU,GAAG,UAAU,CAAC;AAuOjF,MAAM,MAAM,QAAQ,GAAG,SAAS,GAAG,YAAY,GAAG,WAAW,GAAG,UAAU,CAAC;AAE3E,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,QAAQ,CAkBvD;AA6BD,wBAAgB,cAAc,CAC5B,KAAK,EAAE,WAAW,EAAE,EACpB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,EACtC,MAAM,EAAE,SAAS,EAAE,EACnB,QAAQ,CAAC,EAAE,YAAY,EACvB,WAAW,CAAC,EAAE,WAAW,EACzB,YAAY,CAAC,EAAE,cAAc,EAAE,EAC/B,SAAS,CAAC,EAAE,SAAS,GACpB,WAAW,EAAE,CAyGf;AAmhBD,wBAAgB,gCAAgC,CAC9C,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,EAAE,EACjB,OAAO,EAAE,MAAM,EAAE,EACjB,OAAO,SAAK,GACX,gBAAgB,GAAG,IAAI,CAwCzB;AAKD,wBAAgB,mBAAmB,CAAC,WAAW,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAe7E;AAED,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE,CAKlE;AAED,wBAAgB,0BAA0B,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAY/D"}

package/dist/analyzers/features/featureDetector.js

@@ -1,7 +1,7 @@
 import { classifyFileRole, isTechnicalFeatureSource, isDocumentationMeta } from "../analysis/index.js";
 import { detectFrontendPageFeatures, detectClientRouteFeatures } from "../detectors/index.js";
 import { isArchitectureSource } from "../graph/index.js";
-import { mergeIntoFeatureList } from "./featureMerge.js";
+import { projectFeatureCandidates, reconcileFeatureCandidates, } from "./featureCandidates.js";
 import { FEATURE_SIGNALS, hasAiProviderUrl, isAiProviderImport } from "../registry/index.js";
 // ---------------------------------------------------------------------------
 // ROLE_FEATURES — only user-visible features, not architectural layers.
@@ -266,7 +266,7 @@ function scoreEntryPointRelevance(file, _context) {
 // Main entry
 // ---------------------------------------------------------------------------
 export function detectFeatures(files, analyses, routes, database, entityGraph, capabilities, fileGraph) {
-    const features = [];
+    const candidates = [];
     const scopedFiles = files.filter((file) => isArchitectureSource(file.path));
     // --- ROLE_FEATURES ---
     for (const definition of ROLE_FEATURES) {
@@ -281,7 +281,7 @@ export function detectFeatures(files, analyses, routes, database, entityGraph, c
             || left.localeCompare(right))
             .slice(0, 12);
         if (evidence.length > 0) {
-            features.push(createFeatureInfo(definition.name, evidence, definition.terms, definition.purpose, analyses));
+            candidates.push(toFeatureCandidate("registry", `role-${definition.role}`, createFeatureInfo(definition.name, evidence, definition.terms, definition.purpose, analyses)));
         }
     }
     // --- FEATURE_SIGNALS ---
@@ -304,33 +304,66 @@ export function detectFeatures(files, analyses, routes, database, entityGraph, c
             continue;
         }
         if (evidence.length > 0) {
-            mergeFeature(features, createFeatureInfo(signal.name, evidence, signal.terms, signal.purpose, analyses));
+            candidates.push(toFeatureCandidate("registry", `signal-${signal.name}`, createFeatureInfo(signal.name, evidence, signal.terms, signal.purpose, analyses)));
         }
     }
     // Database and API Routes are architectural concerns, not domain features.
     // Database info lives in snapshot.database, routes in snapshot.routes.
     if (capabilities && capabilities.length > 0) {
         for (const feature of capabilitiesToFeatures(capabilities)) {
-            if (feature !== null)
-                mergeFeature(features, feature);
+            if (feature !== null) {
+                candidates.push(toFeatureCandidate("capability", "route-capability", feature, routes));
+            }
         }
     }
     if (entityGraph && entityGraph.entityNames.length > 0) {
         for (const feature of entityGraphToFeatures(entityGraph, scopedFiles)) {
-            mergeFeature(features, feature);
+            candidates.push(toFeatureCandidate("entity", `entity-${feature.name}`, feature, routes));
         }
     }
     if (fileGraph) {
         for (const feature of detectFrontendPageFeatures(routes, fileGraph)) {
-            mergeFeature(features, feature);
+            candidates.push(toFeatureCandidate("frontend-page", "file-page", feature, routes));
         }
         for (const feature of detectClientRouteFeatures(scopedFiles, fileGraph)) {
-            mergeFeature(features, feature);
+            candidates.push(toFeatureCandidate("client-route", "client-route", feature, routes));
         }
     }
+    const features = projectFeatureCandidates(reconcileFeatureCandidates(candidates).clusters);
     return enrichAuthenticationFeature(features, scopedFiles, analyses)
         .sort((left, right) => left.name.localeCompare(right.name));
 }
+function toFeatureCandidate(source, ruleId, feature, routes = []) {
+    const entityNames = feature.name.endsWith(" Management")
+        ? [feature.name.slice(0, -" Management".length)]
+        : [];
+    const routePaths = routes
+        .filter((route) => feature.files.includes(route.file))
+        .map((route) => route.path)
+        .sort();
+    return {
+        id: `${source}:${ruleId}:${normalizeCandidateSubject(feature.name)}`,
+        label: feature.name,
+        source,
+        evidence: [{
+                ruleId,
+                source,
+                files: [...feature.evidence].sort(),
+                routePaths,
+                entityNames,
+                detail: feature.purpose,
+                reliability: source === "entity" ? "high" : "medium",
+            }],
+        files: [...feature.files].sort(),
+        routePaths,
+        entityNames,
+        conclusionConfidence: feature.confidence,
+        projection: feature,
+    };
+}
+function normalizeCandidateSubject(value) {
+    return value.toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-|-$/g, "");
+}
 // ---------------------------------------------------------------------------
 // capabilitiesToFeatures
 //
@@ -456,6 +489,8 @@ function findEntityFiles(entityName, files) {
             const fileStem = segment.replace(/\.[^/.]+$/, "");
             if (fileStem === lowerName)
                 return true;
+            if (fileStem.includes(lowerName) && fileStem.length >= lowerName.length + 1)
+                return true;
             const segParts = splitNameToSegments(fileStem);
             return nameSegments.some((ns) => segParts.includes(ns));
         });
@@ -612,9 +647,6 @@ function createFeatureInfo(name, evidence, terms, purpose = `Identifies ${name.t
  * Alasan tidak hapus function ini: masih dipanggil di beberapa tempat di file ini.
  * mergeIntoFeatureList menggantikan logika lama yang pakai normalizeFeatureName.
  */
-function mergeFeature(features, addition) {
-    mergeIntoFeatureList(features, addition);
-}
 // ---------------------------------------------------------------------------
 // matchesSignal
 //
@@ -635,10 +667,40 @@ function matchesSignal(file, analysis, terms, importOnly) {
     if (terms.some((term) => matchesPathTerm(path, term)))
         return true;
     if (analysis) {
-        return terms.some((term) => analysis.imports.some((specifier) => specifier.toLowerCase().includes(term)));
+        return terms.some((term) => analysis.imports.some((specifier) => matchesImportTerm(specifier, term)));
     }
     return false;
 }
+/**
+ * matchesImportTerm — segment-aware import specifier matching.
+ *
+ * Prevents false positives like "author" matching the "auth" signal.
+ *
+ * Rules:
+ *   - Scoped packages: exact match on package name after @org/
+ *     e.g. "@auth/core" matches "auth", "@prisma/client" matches "prisma"
+ *   - Unscoped packages: exact match on first segment
+ *     e.g. "next-auth" matches "auth" (via segment boundary), "author" does NOT
+ *   - Local imports: use the same segment-boundary regex as path matching
+ *     e.g. "./author" does NOT match "auth", "./auth/config" DOES match "auth"
+ */
+function matchesImportTerm(specifier, term) {
+    const lower = specifier.toLowerCase();
+    // Scoped package: @org/name — match against the name segment
+    const scopedMatch = lower.match(/^@[^/]+\/(.+)$/);
+    if (scopedMatch) {
+        const packageName = scopedMatch[1];
+        // Exact segment match: "auth" matches "next-auth" (contains "-auth")
+        // but "auth" does NOT match "author" (different segment)
+        return getOrCompilePattern(term).test(packageName)
+            || packageName === term
+            || packageName.split("-").includes(term);
+    }
+    // Unscoped package or local path: use segment-boundary matching
+    // This reuses the same regex that protects path matching
+    return getOrCompilePattern(term).test(lower)
+        || lower.split("/").some((segment) => segment === term);
+}
 const regexCache = new Map();
 function getOrCompilePattern(term) {
     if (regexCache.has(term))
@@ -716,10 +778,10 @@ export function detectAuthenticationSemanticRole(path, symbols, imports, content
     const hasAuthImport = normalizedImports.some((s) => /(^|[/@-])(auth|next-auth|auth0|clerk|lucia|better-auth|passport|kinde)([/.-]|$)/.test(s)
         || /supabase.*auth/.test(s)
         || /firebase\/auth/.test(s));
-    const hasAuthSymbol = symbols.some((s) => /(auth|session|login|register|signin|signout|jwt|token|credential)/i.test(s));
+    const hasAuthSymbol = symbols.some((s) => /\b(auth|session|login|register|signin|signout|jwt|token|credential)\b/i.test(s));
     const hasAuthPath = /(^|[/._-])(auth|session|login|register|signin|signout)([/._-]|$)/.test(normalizedPath);
     const hasGuardPath = /(^|[/._-])(guard|middleware|proxy|protected)([/._-]|$)/.test(normalizedPath);
-    const hasGuardSymbol = symbols.some((s) => /(guard|middleware|proxy|protected)/i.test(s));
+    const hasGuardSymbol = symbols.some((s) => /\b(guard|middleware|proxy|protected)\b/i.test(s));
     if (/(^|\/)src\/auth\.[cm]?[jt]sx?$/.test(normalizedPath)
         || /(^|\/)auth\.[cm]?[jt]sx?$/.test(normalizedPath)
         || (hasSymbol(symbols, "auth") && hasSymbol(symbols, "handlers"))
@@ -740,7 +802,7 @@ export function detectAuthenticationSemanticRole(path, symbols, imports, content
 // ---------------------------------------------------------------------------
 // File priority helpers
 // ---------------------------------------------------------------------------
-function featureFilePriority(featureName, path) {
+export function featureFilePriority(featureName, path) {
     const normalized = path.toLowerCase();
     if (featureName === "Documentation") {
         if (normalized === "readme.md")