debtlens 0.1.0

package/dist/detectors/deadAbstraction.js

@@ -0,0 +1,115 @@
+import { Node, SyntaxKind } from "ts-morph";
+import { collectFunctionLikes, getFunctionBody } from "../utils/ast.js";
+import { createIssue } from "../utils/createIssue.js";
+import { isHookName } from "../utils/identifiers.js";
+import { nodeLineSpan } from "../utils/lines.js";
+export const deadAbstractionDetector = {
+    id: "dead-abstraction",
+    name: "Dead abstraction",
+    description: "Flags wrappers that add naming but very little behavior.",
+    defaultSeverity: "low",
+    tags: ["abstraction", "cleanup", "maintainability"],
+    detect(context) {
+        const issues = [];
+        const maxWrapperLines = context.getThreshold("dead-abstraction.maxWrapperLines", 8);
+        for (const file of context.files) {
+            // Route modules (Expo Router / Next.js app & pages dirs) are thin wrappers by
+            // convention — a route that renders its screen is not a dead abstraction.
+            if (isRouteFile(file.relativePath))
+                continue;
+            for (const fn of collectFunctionLikes(file)) {
+                const body = getFunctionBody(fn.node);
+                if (!body)
+                    continue;
+                const span = nodeLineSpan(body);
+                if (span.lines > maxWrapperLines)
+                    continue;
+                const wrapper = describeWrapper(body, extractParamNames(fn.node));
+                if (!wrapper)
+                    continue;
+                issues.push(createIssue({
+                    detector: deadAbstractionDetector,
+                    severity: fn.classification === "hook" ? "medium" : "low",
+                    confidence: wrapper.confidence,
+                    file: file.relativePath,
+                    location: { startLine: span.startLine, endLine: span.endLine },
+                    message: `${fn.name} looks like a thin wrapper: ${wrapper.description}.`,
+                    evidence: [body.getText().replace(/\s+/g, " ").slice(0, 180)],
+                    suggestion: "Keep the wrapper only if it creates a stable domain boundary. Otherwise inline it or add the missing behavior where this abstraction belongs.",
+                }));
+            }
+        }
+        return issues;
+    },
+};
+function describeWrapper(body, paramNames) {
+    if (Node.isBlock(body)) {
+        const statements = body.getStatements();
+        if (statements.length !== 1)
+            return undefined;
+        const only = statements[0];
+        if (!only)
+            return undefined;
+        if (Node.isReturnStatement(only)) {
+            const expression = only.getExpression();
+            if (!expression)
+                return undefined;
+            return describeExpression(expression, paramNames);
+        }
+        if (Node.isExpressionStatement(only)) {
+            return describeExpression(only.getExpression(), paramNames);
+        }
+    }
+    return describeExpression(body, paramNames);
+}
+function isRouteFile(relativePath) {
+    return /(^|\/)(app|pages)\//.test(relativePath);
+}
+/** Param identifier names in order, or null if any param is destructured/non-trivial. */
+function extractParamNames(node) {
+    const names = [];
+    for (const param of node.getParameters()) {
+        const nameNode = param.getNameNode();
+        if (!Node.isIdentifier(nameNode))
+            return null;
+        names.push(nameNode.getText());
+    }
+    return names;
+}
+/** True if a call forwards exactly the wrapper's params, in order, unchanged. */
+function isPassThrough(call, paramNames) {
+    const args = call.getArguments();
+    if (args.length !== paramNames.length)
+        return false;
+    return args.every((arg, index) => Node.isIdentifier(arg) && arg.getText() === paramNames[index]);
+}
+function describeExpression(expression, paramNames) {
+    if (Node.isCallExpression(expression)) {
+        const callee = expression.getExpression();
+        const calleeName = Node.isIdentifier(callee)
+            ? callee.getText()
+            : Node.isPropertyAccessExpression(callee)
+                ? callee.getName()
+                : "";
+        // A hook that just composes another hook (useCallback, a store selector, etc.) is
+        // idiomatic composition, not a dead abstraction.
+        if (isHookName(calleeName))
+            return undefined;
+        // Only flag a delegation when it adds nothing: a pure pass-through of the params.
+        // `f(a, b) => g(a, b)` is dead; `f(a) => g(transform(a))` or `g(a, CONST)` is not.
+        if (!paramNames || !isPassThrough(expression, paramNames))
+            return undefined;
+        return { description: `it only delegates to ${callee.getText()}(...)`, confidence: 0.8 };
+    }
+    if (Node.isIdentifier(expression)) {
+        return { description: `it only returns ${expression.getText()}`, confidence: 0.76 };
+    }
+    if (Node.isPropertyAccessExpression(expression)) {
+        return { description: `it only returns ${expression.getText()}`, confidence: 0.72 };
+    }
+    if (expression.getKind() === SyntaxKind.JsxElement || expression.getKind() === SyntaxKind.JsxSelfClosingElement) {
+        return { description: "it only forwards to a single JSX element", confidence: 0.68 };
+    }
+    return undefined;
+}
+//# sourceMappingURL=deadAbstraction.js.map

package/dist/detectors/deadAbstraction.js.map

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

package/dist/detectors/duplicateLogic.d.ts

@@ -0,0 +1,2 @@
+import type { Detector } from "../core/types.js";
+export declare const duplicateLogicDetector: Detector;

package/dist/detectors/duplicateLogic.js

@@ -0,0 +1,81 @@
+import { collectFunctionLikes, getFunctionBody, structuralFingerprint } from "../utils/ast.js";
+import { createIssue } from "../utils/createIssue.js";
+import { nodeLineSpan } from "../utils/lines.js";
+import { cosineSimilarity, jaccard, normalizeSnippet, shingle } from "../utils/similarity.js";
+export const duplicateLogicDetector = {
+    id: "duplicate-logic",
+    name: "Duplicate logic",
+    description: "Finds near-duplicate functions/components after comments, identifiers, strings, and literals are normalized.",
+    defaultSeverity: "medium",
+    tags: ["duplication", "maintainability", "review"],
+    detect(context) {
+        const issues = [];
+        const minSimilarity = context.getThreshold("duplicate-logic.minSimilarity", 0.86);
+        const minStructural = context.getThreshold("duplicate-logic.minStructuralSimilarity", 0.6);
+        const minLines = context.getThreshold("duplicate-logic.minLines", 8);
+        const maxSnippets = context.getThreshold("duplicate-logic.maxSnippets", 450);
+        const snippets = [];
+        for (const file of context.files) {
+            for (const fn of collectFunctionLikes(file)) {
+                const body = getFunctionBody(fn.node) ?? fn.node;
+                const span = nodeLineSpan(body);
+                if (span.lines < minLines || span.lines > 220)
+                    continue;
+                const text = body.getText();
+                const normalized = normalizeSnippet(text);
+                if (normalized.length < 80)
+                    continue;
+                snippets.push({
+                    name: fn.name,
+                    file: file.relativePath,
+                    startLine: span.startLine,
+                    endLine: span.endLine,
+                    lines: span.lines,
+                    normalized,
+                    shingles: shingle(normalized),
+                    fingerprint: structuralFingerprint(body),
+                });
+            }
+        }
+        const limited = snippets.slice(0, maxSnippets);
+        const seenPairs = new Set();
+        for (let i = 0; i < limited.length; i += 1) {
+            for (let j = i + 1; j < limited.length; j += 1) {
+                const a = limited[i];
+                const b = limited[j];
+                if (!a || !b)
+                    continue;
+                if (a.file === b.file && Math.abs(a.startLine - b.startLine) < 4)
+                    continue;
+                // Cheap structural pre-filter: reject pairs whose control-flow/call shape
+                // differs before doing the more expensive text-shingle comparison.
+                if (cosineSimilarity(a.fingerprint, b.fingerprint) < minStructural)
+                    continue;
+                const similarity = jaccard(a.shingles, b.shingles);
+                if (similarity < minSimilarity)
+                    continue;
+                const key = [a.file, a.startLine, b.file, b.startLine].sort().join("|");
+                if (seenPairs.has(key))
+                    continue;
+                seenPairs.add(key);
+                issues.push(createIssue({
+                    detector: duplicateLogicDetector,
+                    severity: similarity > 0.93 ? "high" : "medium",
+                    confidence: similarity,
+                    file: a.file,
+                    location: { startLine: a.startLine, endLine: a.endLine },
+                    message: `${a.name} is ${Math.round(similarity * 100)}% structurally similar to ${b.name}.`,
+                    evidence: [
+                        `${a.file}:${a.startLine}-${a.endLine} (${a.lines} lines)`,
+                        `${b.file}:${b.startLine}-${b.endLine} (${b.lines} lines)`,
+                    ],
+                    suggestion: "Compare the two implementations. Extract shared behavior only if the variation is intentional and stable; otherwise delete the weaker duplicate.",
+                }));
+                if (issues.length >= 50)
+                    return issues;
+            }
+        }
+        return issues;
+    },
+};
+//# sourceMappingURL=duplicateLogic.js.map

package/dist/detectors/duplicateLogic.js.map

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

package/dist/detectors/effectComplexity.d.ts

@@ -0,0 +1,2 @@
+import type { Detector } from "../core/types.js";
+export declare const effectComplexityDetector: Detector;

package/dist/detectors/effectComplexity.js

@@ -0,0 +1,64 @@
+import { Node, SyntaxKind } from "ts-morph";
+import { createIssue } from "../utils/createIssue.js";
+import { nodeLineSpan } from "../utils/lines.js";
+export const effectComplexityDetector = {
+    id: "effect-complexity",
+    name: "Effect complexity",
+    description: "Flags useEffect blocks that are long, branchy, or overloaded with dependencies.",
+    defaultSeverity: "medium",
+    tags: ["react", "effects", "complexity"],
+    detect(context) {
+        const issues = [];
+        const maxLines = context.getThreshold("effect-complexity.maxLines", 30);
+        const maxDependencies = context.getThreshold("effect-complexity.maxDependencies", 8);
+        for (const file of context.files) {
+            for (const call of file.sourceFile.getDescendantsOfKind(SyntaxKind.CallExpression)) {
+                const expression = call.getExpression();
+                const expressionName = Node.isIdentifier(expression)
+                    ? expression.getText()
+                    : Node.isPropertyAccessExpression(expression)
+                        ? expression.getName()
+                        : undefined;
+                if (expressionName !== "useEffect")
+                    continue;
+                const [callback, dependencies] = call.getArguments();
+                if (!callback)
+                    continue;
+                const span = nodeLineSpan(callback);
+                const branchCount = callback.getDescendants().filter((node) => {
+                    const kind = node.getKind();
+                    return kind === SyntaxKind.IfStatement
+                        || kind === SyntaxKind.ConditionalExpression
+                        || kind === SyntaxKind.ForStatement
+                        || kind === SyntaxKind.ForOfStatement
+                        || kind === SyntaxKind.WhileStatement
+                        || kind === SyntaxKind.SwitchStatement;
+                }).length;
+                const dependencyCount = dependencies && Node.isArrayLiteralExpression(dependencies)
+                    ? dependencies.getElements().length
+                    : 0;
+                const hasAsyncWork = callback.getDescendantsOfKind(SyntaxKind.AwaitExpression).length > 0;
+                const callCount = callback.getDescendantsOfKind(SyntaxKind.CallExpression).length;
+                if (span.lines < maxLines && dependencyCount < maxDependencies && branchCount < 4 && callCount < 8)
+                    continue;
+                issues.push(createIssue({
+                    detector: effectComplexityDetector,
+                    severity: span.lines >= maxLines * 1.5 || branchCount >= 6 ? "high" : "medium",
+                    confidence: 0.8,
+                    file: file.relativePath,
+                    location: { startLine: span.startLine, endLine: span.endLine },
+                    message: `This useEffect spans ${span.lines} lines, has ${dependencyCount} dependencies, ${branchCount} branches, and ${callCount} nested calls.`,
+                    evidence: [
+                        `Lines: ${span.lines} / ${maxLines}`,
+                        `Dependencies: ${dependencyCount} / ${maxDependencies}`,
+                        `Branches: ${branchCount}`,
+                        hasAsyncWork ? "Contains async work" : "No await detected",
+                    ],
+                    suggestion: "Split unrelated effects, move imperative workflows into named functions, or replace derived state effects with memoized values.",
+                }));
+            }
+        }
+        return issues;
+    },
+};
+//# sourceMappingURL=effectComplexity.js.map

package/dist/detectors/effectComplexity.js.map

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

package/dist/detectors/index.d.ts

@@ -0,0 +1,3 @@
+import type { Detector } from "../core/types.js";
+export declare const allDetectors: Detector[];
+export declare const detectorIds: string[];

package/dist/detectors/index.js

@@ -0,0 +1,20 @@
+import { deadAbstractionDetector } from "./deadAbstraction.js";
+import { duplicateLogicDetector } from "./duplicateLogic.js";
+import { effectComplexityDetector } from "./effectComplexity.js";
+import { largeComponentDetector } from "./largeComponent.js";
+import { namingDriftDetector } from "./namingDrift.js";
+import { propDrillingDetector } from "./propDrilling.js";
+import { stateSprawlDetector } from "./stateSprawl.js";
+import { todoCommentDetector } from "./todoComment.js";
+export const allDetectors = [
+    largeComponentDetector,
+    stateSprawlDetector,
+    effectComplexityDetector,
+    duplicateLogicDetector,
+    deadAbstractionDetector,
+    propDrillingDetector,
+    todoCommentDetector,
+    namingDriftDetector,
+];
+export const detectorIds = allDetectors.map((detector) => detector.id);
+//# sourceMappingURL=index.js.map

package/dist/detectors/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/detectors/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,uBAAuB,EAAE,MAAM,sBAAsB,CAAC;AAC/D,OAAO,EAAE,sBAAsB,EAAE,MAAM,qBAAqB,CAAC;AAC7D,OAAO,EAAE,wBAAwB,EAAE,MAAM,uBAAuB,CAAC;AACjE,OAAO,EAAE,sBAAsB,EAAE,MAAM,qBAAqB,CAAC;AAC7D,OAAO,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AACzD,OAAO,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAEvD,MAAM,CAAC,MAAM,YAAY,GAAe;IACtC,sBAAsB;IACtB,mBAAmB;IACnB,wBAAwB;IACxB,sBAAsB;IACtB,uBAAuB;IACvB,oBAAoB;IACpB,mBAAmB;IACnB,mBAAmB;CACpB,CAAC;AAEF,MAAM,CAAC,MAAM,WAAW,GAAG,YAAY,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC"}

package/dist/detectors/largeComponent.d.ts

@@ -0,0 +1,2 @@
+import type { Detector } from "../core/types.js";
+export declare const largeComponentDetector: Detector;

package/dist/detectors/largeComponent.js

@@ -0,0 +1,46 @@
+import { collectFunctionLikes, countBranches, countHookCalls, getFunctionBody } from "../utils/ast.js";
+import { createIssue } from "../utils/createIssue.js";
+import { nodeLineSpan } from "../utils/lines.js";
+export const largeComponentDetector = {
+    id: "large-component",
+    name: "Large component",
+    description: "Flags React-style components that have grown large enough to hide unrelated responsibilities.",
+    defaultSeverity: "medium",
+    tags: ["react", "maintainability", "component-design"],
+    detect(context) {
+        const issues = [];
+        const maxLines = context.getThreshold("large-component.maxLines", 250);
+        const maxBranches = context.getThreshold("large-component.maxBranches", 16);
+        const maxHooks = context.getThreshold("large-component.maxHooks", 10);
+        for (const file of context.files) {
+            for (const fn of collectFunctionLikes(file)) {
+                if (fn.classification !== "component")
+                    continue;
+                const body = getFunctionBody(fn.node) ?? fn.node;
+                const span = nodeLineSpan(body);
+                const branchCount = countBranches(body);
+                const hookCount = countHookCalls(body);
+                const isOverLineBudget = span.lines >= maxLines;
+                const isOverComplexityBudget = branchCount >= maxBranches || hookCount >= maxHooks;
+                if (!isOverLineBudget && !isOverComplexityBudget)
+                    continue;
+                issues.push(createIssue({
+                    detector: largeComponentDetector,
+                    severity: isOverLineBudget && isOverComplexityBudget ? "high" : "medium",
+                    confidence: isOverLineBudget ? 0.86 : 0.74,
+                    file: file.relativePath,
+                    location: { startLine: span.startLine, endLine: span.endLine },
+                    message: `${fn.name} appears to own too many responsibilities. It spans ${span.lines} lines, uses ${hookCount} hooks, and contains ${branchCount} branch points.`,
+                    evidence: [
+                        `Lines: ${span.lines} / ${maxLines}`,
+                        `Hook calls: ${hookCount} / ${maxHooks}`,
+                        `Branch points: ${branchCount} / ${maxBranches}`,
+                    ],
+                    suggestion: "Extract data loading, derived state, or rendering sections into focused hooks/components before adding more behavior.",
+                }));
+            }
+        }
+        return issues;
+    },
+};
+//# sourceMappingURL=largeComponent.js.map

package/dist/detectors/largeComponent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"largeComponent.js","sourceRoot":"","sources":["../../src/detectors/largeComponent.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,oBAAoB,EAAE,aAAa,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AACvG,OAAO,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AACtD,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEjD,MAAM,CAAC,MAAM,sBAAsB,GAAa;IAC9C,EAAE,EAAE,iBAAiB;IACrB,IAAI,EAAE,iBAAiB;IACvB,WAAW,EAAE,+FAA+F;IAC5G,eAAe,EAAE,QAAQ;IACzB,IAAI,EAAE,CAAC,OAAO,EAAE,iBAAiB,EAAE,kBAAkB,CAAC;IACtD,MAAM,CAAC,OAAwB;QAC7B,MAAM,MAAM,GAAgB,EAAE,CAAC;QAC/B,MAAM,QAAQ,GAAG,OAAO,CAAC,YAAY,CAAC,0BAA0B,EAAE,GAAG,CAAC,CAAC;QACvE,MAAM,WAAW,GAAG,OAAO,CAAC,YAAY,CAAC,6BAA6B,EAAE,EAAE,CAAC,CAAC;QAC5E,MAAM,QAAQ,GAAG,OAAO,CAAC,YAAY,CAAC,0BAA0B,EAAE,EAAE,CAAC,CAAC;QAEtE,KAAK,MAAM,IAAI,IAAI,OAAO,CAAC,KAAK,EAAE,CAAC;YACjC,KAAK,MAAM,EAAE,IAAI,oBAAoB,CAAC,IAAI,CAAC,EAAE,CAAC;gBAC5C,IAAI,EAAE,CAAC,cAAc,KAAK,WAAW;oBAAE,SAAS;gBAChD,MAAM,IAAI,GAAG,eAAe,CAAC,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,IAAI,CAAC;gBACjD,MAAM,IAAI,GAAG,YAAY,CAAC,IAAI,CAAC,CAAC;gBAChC,MAAM,WAAW,GAAG,aAAa,CAAC,IAAI,CAAC,CAAC;gBACxC,MAAM,SAAS,GAAG,cAAc,CAAC,IAAI,CAAC,CAAC;gBACvC,MAAM,gBAAgB,GAAG,IAAI,CAAC,KAAK,IAAI,QAAQ,CAAC;gBAChD,MAAM,sBAAsB,GAAG,WAAW,IAAI,WAAW,IAAI,SAAS,IAAI,QAAQ,CAAC;gBAEnF,IAAI,CAAC,gBAAgB,IAAI,CAAC,sBAAsB;oBAAE,SAAS;gBAE3D,MAAM,CAAC,IAAI,CAAC,WAAW,CAAC;oBACtB,QAAQ,EAAE,sBAAsB;oBAChC,QAAQ,EAAE,gBAAgB,IAAI,sBAAsB,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,QAAQ;oBACxE,UAAU,EAAE,gBAAgB,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI;oBAC1C,IAAI,EAAE,IAAI,CAAC,YAAY;oBACvB,QAAQ,EAAE,EAAE,SAAS,EAAE,IAAI,CAAC,SAAS,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE;oBAC9D,OAAO,EAAE,GAAG,EAAE,CAAC,IAAI,uDAAuD,IAAI,CAAC,KAAK,gBAAgB,SAAS,wBAAwB,WAAW,iBAAiB;oBACjK,QAAQ,EAAE;wBACR,UAAU,IAAI,CAAC,KAAK,MAAM,QAAQ,EAAE;wBACpC,eAAe,SAAS,MAAM,QAAQ,EAAE;wBACxC,kBAAkB,WAAW,MAAM,WAAW,EAAE;qBACjD;oBACD,UAAU,EAAE,uHAAuH;iBACpI,CAAC,CAAC,CAAC;YACN,CAAC;QACH,CAAC;QAED,OAAO,MAAM,CAAC;IAChB,CAAC;CACF,CAAC"}

package/dist/detectors/namingDrift.d.ts

@@ -0,0 +1,10 @@
+import type { Detector } from "../core/types.js";
+interface ConceptGroup {
+    id: string;
+    label: string;
+    variants: string[];
+}
+/** Merge the built-in pack with user-supplied vocabulary; config groups win on id. */
+export declare function resolveConceptGroups(vocabulary?: Record<string, string[]>): ConceptGroup[];
+export declare const namingDriftDetector: Detector;
+export {};

package/dist/detectors/namingDrift.js

@@ -0,0 +1,82 @@
+import { SyntaxKind } from "ts-morph";
+import { createIssue } from "../utils/createIssue.js";
+import { splitIdentifier } from "../utils/identifiers.js";
+// Built-in "media/release" vocabulary pack. Projects in other domains can add their
+// own concept groups via the `vocabulary` config (config groups override built-ins
+// that share an id).
+const defaultConceptGroups = [
+    {
+        id: "media-entity",
+        label: "media entity",
+        variants: ["movie", "film", "show", "series", "title", "release", "media", "content", "game", "episode"],
+    },
+    {
+        id: "time-of-release",
+        label: "release timing",
+        variants: ["date", "air", "premiere", "launch", "drop", "release", "available", "calendar", "upcoming"],
+    },
+    {
+        id: "saved-user-item",
+        label: "saved user item",
+        variants: ["saved", "favorite", "favourite", "watchlist", "tracked", "bookmark", "following", "library"],
+    },
+    {
+        id: "data-source",
+        label: "data source",
+        variants: ["api", "client", "service", "provider", "adapter", "source", "repository", "store"],
+    },
+];
+function humanizeId(id) {
+    return id.replace(/[-_]+/g, " ").trim();
+}
+/** Merge the built-in pack with user-supplied vocabulary; config groups win on id. */
+export function resolveConceptGroups(vocabulary) {
+    const groups = new Map();
+    for (const group of defaultConceptGroups)
+        groups.set(group.id, group);
+    if (vocabulary) {
+        for (const [id, variants] of Object.entries(vocabulary)) {
+            groups.set(id, {
+                id,
+                label: humanizeId(id),
+                variants: variants.map((variant) => variant.toLowerCase()),
+            });
+        }
+    }
+    return [...groups.values()];
+}
+export const namingDriftDetector = {
+    id: "naming-drift",
+    name: "Naming drift",
+    description: "Finds files where similar concepts are represented by many competing names.",
+    defaultSeverity: "info",
+    tags: ["naming", "architecture", "domain-modeling"],
+    detect(context) {
+        const issues = [];
+        const minVariants = context.getThreshold("naming-drift.minVariants", 4);
+        const conceptGroups = resolveConceptGroups(context.options.vocabulary);
+        for (const file of context.files) {
+            const identifiers = file.sourceFile
+                .getDescendantsOfKind(SyntaxKind.Identifier)
+                .flatMap((identifier) => splitIdentifier(identifier.getText()));
+            const tokenSet = new Set(identifiers);
+            for (const group of conceptGroups) {
+                const found = group.variants.filter((variant) => tokenSet.has(variant));
+                if (found.length < minVariants)
+                    continue;
+                issues.push(createIssue({
+                    detector: namingDriftDetector,
+                    severity: found.length >= minVariants + 2 ? "low" : "info",
+                    confidence: 0.62,
+                    file: file.relativePath,
+                    location: { startLine: 1 },
+                    message: `This file uses ${found.length} competing terms for ${group.label}: ${found.join(", ")}.`,
+                    evidence: [`Concept group: ${group.id}`, `Variants found: ${found.join(", ")}`],
+                    suggestion: "Pick a canonical domain name and rename adapters at system boundaries instead of mixing boundary names throughout the feature.",
+                }));
+            }
+        }
+        return issues;
+    },
+};
+//# sourceMappingURL=namingDrift.js.map

package/dist/detectors/namingDrift.js.map

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

package/dist/detectors/propDrilling.d.ts

@@ -0,0 +1,2 @@
+import type { Detector } from "../core/types.js";
+export declare const propDrillingDetector: Detector;

package/dist/detectors/propDrilling.js

@@ -0,0 +1,97 @@
+import { Node, SyntaxKind } from "ts-morph";
+import { collectFunctionLikes, getFunctionBody } from "../utils/ast.js";
+import { createIssue } from "../utils/createIssue.js";
+import { isHostComponent } from "../utils/hostComponents.js";
+import { nodeLineSpan } from "../utils/lines.js";
+export const propDrillingDetector = {
+    id: "prop-drilling",
+    name: "Prop drilling",
+    description: "Flags components that mostly forward props to child components.",
+    defaultSeverity: "medium",
+    tags: ["react", "props", "component-design"],
+    detect(context) {
+        const issues = [];
+        const maxForwardedProps = context.getThreshold("prop-drilling.maxForwardedProps", 4);
+        for (const file of context.files) {
+            for (const fn of collectFunctionLikes(file)) {
+                if (fn.classification !== "component")
+                    continue;
+                const propNames = inferPropNames(fn.node);
+                if (propNames.size === 0)
+                    continue;
+                const body = getFunctionBody(fn.node) ?? fn.node;
+                const forwarded = new Map();
+                const jsxNodes = [
+                    ...body.getDescendantsOfKind(SyntaxKind.JsxOpeningElement),
+                    ...body.getDescendantsOfKind(SyntaxKind.JsxSelfClosingElement),
+                ];
+                for (const jsx of jsxNodes) {
+                    const tagName = jsx.getTagNameNode().getText();
+                    // Skip host elements (lowercase DOM tags) and UI primitives (RN/icon
+                    // components are PascalCase but aren't user-defined children).
+                    if (/^[a-z]/.test(tagName) || isHostComponent(tagName))
+                        continue;
+                    const childForwarded = new Set();
+                    for (const attribute of jsx.getAttributes()) {
+                        if (!Node.isJsxAttribute(attribute))
+                            continue;
+                        const initializer = attribute.getInitializer()?.getText() ?? "";
+                        for (const propName of propNames) {
+                            if (new RegExp(`\\b${escapeRegExp(propName)}\\b`).test(initializer)) {
+                                childForwarded.add(propName);
+                            }
+                        }
+                    }
+                    if (childForwarded.size > 0) {
+                        forwarded.set(tagName, childForwarded);
+                    }
+                }
+                const uniqueForwarded = new Set([...forwarded.values()].flatMap((value) => [...value]));
+                if (uniqueForwarded.size < maxForwardedProps && forwarded.size < 3)
+                    continue;
+                const span = nodeLineSpan(body);
+                issues.push(createIssue({
+                    detector: propDrillingDetector,
+                    severity: uniqueForwarded.size >= maxForwardedProps + 3 ? "high" : "medium",
+                    confidence: 0.73,
+                    file: file.relativePath,
+                    location: { startLine: span.startLine, endLine: span.endLine },
+                    message: `${fn.name} forwards ${uniqueForwarded.size} props across ${forwarded.size} child components.`,
+                    evidence: [...forwarded.entries()].slice(0, 5).map(([child, props]) => `${child}: ${[...props].join(", ")}`),
+                    suggestion: "Consider colocating the data owner closer to consumers, using a composition slot, or extracting a focused context for stable cross-cutting values.",
+                }));
+            }
+        }
+        return issues;
+    },
+};
+function inferPropNames(node) {
+    const names = new Set();
+    const [firstParam] = node.getParameters();
+    if (!firstParam)
+        return names;
+    const text = firstParam.getText();
+    if (text.startsWith("{")) {
+        const withoutType = text.split(":").slice(0, -1).join(":") || text;
+        for (const match of withoutType.matchAll(/\b([A-Za-z_$][\w$]*)\b/g)) {
+            const name = match[1];
+            if (name && !["readonly", "string", "number", "boolean", "React", "Props"].includes(name)) {
+                names.add(name);
+            }
+        }
+        return names;
+    }
+    const paramName = text.split(/[\s:=>,]/)[0];
+    if (!paramName)
+        return names;
+    if (paramName === "props") {
+        names.add("props");
+        return names;
+    }
+    names.add(paramName);
+    return names;
+}
+function escapeRegExp(value) {
+    return value.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+}
+//# sourceMappingURL=propDrilling.js.map

package/dist/detectors/propDrilling.js.map

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

package/dist/detectors/stateSprawl.d.ts

@@ -0,0 +1,2 @@
+import type { Detector } from "../core/types.js";
+export declare const stateSprawlDetector: Detector;