debtlens 0.1.0

package/dist/config/mergeConfig.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mergeConfig.js","sourceRoot":"","sources":["../../src/config/mergeConfig.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAG9C,MAAM,UAAU,WAAW,CAAC,MAAc,EAAE,UAA0B,EAAE,UAAsB;IAC5F,MAAM,GAAG,GAAG,OAAO,CAAC,UAAU,CAAC,GAAG,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC;IAErD,OAAO;QACL,GAAG;QACH,MAAM,EAAE,OAAO,CAAC,GAAG,EAAE,MAAM,CAAC;QAC5B,OAAO,EAAE,UAAU,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC,UAAU,CAAC,OAAO,IAAI,aAAa,CAAC,OAAO;QACtG,OAAO,EAAE;YACP,GAAG,aAAa,CAAC,OAAO;YACxB,GAAG,CAAC,UAAU,CAAC,OAAO,IAAI,EAAE,CAAC;YAC7B,GAAG,CAAC,UAAU,CAAC,OAAO,IAAI,EAAE,CAAC;SAC9B;QACD,WAAW,EAAE,UAAU,CAAC,WAAW,IAAI,UAAU,CAAC,WAAW,IAAI,aAAa,CAAC,WAAW;QAC1F,KAAK,EAAE,UAAU,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC,UAAU,CAAC,KAAK;QACrE,UAAU,EAAE;YACV,GAAG,aAAa,CAAC,UAAU;YAC3B,GAAG,CAAC,UAAU,CAAC,UAAU,IAAI,EAAE,CAAC;YAChC,GAAG,CAAC,UAAU,CAAC,UAAU,IAAI,EAAE,CAAC;SACjC;QACD,QAAQ,EAAE,UAAU,CAAC,QAAQ,IAAI,UAAU,CAAC,QAAQ,IAAI,aAAa,CAAC,QAAQ;QAC9E,UAAU,EAAE,EAAE,GAAG,aAAa,CAAC,UAAU,EAAE,GAAG,CAAC,UAAU,CAAC,UAAU,IAAI,EAAE,CAAC,EAAE;QAC7E,YAAY,EAAE,UAAU,CAAC,YAAY;KACtC,CAAC;AACJ,CAAC"}

package/dist/config/schema.d.ts

@@ -0,0 +1,7 @@
+export declare const SCHEMA_ID = "https://raw.githubusercontent.com/ColumbusLabs/debtlens/main/schema/debtlens.config.schema.json";
+/**
+ * Build the JSON Schema for `debtlens.config.json`. Generated from the live rule list,
+ * severity set, and default threshold keys so it cannot drift from the code. A test
+ * asserts the committed schema file matches this output.
+ */
+export declare function buildConfigSchema(): Record<string, unknown>;

package/dist/config/schema.js

@@ -0,0 +1,63 @@
+import { severities } from "../core/severity.js";
+import { detectorIds } from "../detectors/index.js";
+import { defaultConfig } from "./defaults.js";
+export const SCHEMA_ID = "https://raw.githubusercontent.com/ColumbusLabs/debtlens/main/schema/debtlens.config.schema.json";
+/**
+ * Build the JSON Schema for `debtlens.config.json`. Generated from the live rule list,
+ * severity set, and default threshold keys so it cannot drift from the code. A test
+ * asserts the committed schema file matches this output.
+ */
+export function buildConfigSchema() {
+    const knownThresholds = Object.fromEntries(Object.keys(defaultConfig.thresholds).map((key) => [key, { type: "number" }]));
+    return {
+        $schema: "http://json-schema.org/draft-07/schema#",
+        $id: SCHEMA_ID,
+        title: "DebtLens configuration",
+        description: "Configuration for the DebtLens static-analysis CLI.",
+        type: "object",
+        additionalProperties: false,
+        properties: {
+            $schema: { type: "string" },
+            include: {
+                type: "array",
+                items: { type: "string" },
+                description: "Glob patterns to scan.",
+            },
+            exclude: {
+                type: "array",
+                items: { type: "string" },
+                description: "Glob patterns to skip.",
+            },
+            minSeverity: {
+                enum: [...severities],
+                description: "Lowest severity to report.",
+            },
+            rules: {
+                type: "array",
+                uniqueItems: true,
+                items: { enum: [...detectorIds] },
+                description: "Rule ids to run. Omit to run all rules.",
+            },
+            maxFiles: {
+                type: "integer",
+                minimum: 1,
+                description: "Maximum number of files to scan.",
+            },
+            thresholds: {
+                type: "object",
+                description: "Per-rule numeric threshold overrides.",
+                properties: knownThresholds,
+                additionalProperties: { type: "number" },
+            },
+            vocabulary: {
+                type: "object",
+                description: "Naming-drift concept groups (concept id -> competing terms).",
+                additionalProperties: {
+                    type: "array",
+                    items: { type: "string" },
+                },
+            },
+        },
+    };
+}
+//# sourceMappingURL=schema.js.map

package/dist/config/schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.js","sourceRoot":"","sources":["../../src/config/schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AACjD,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACpD,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAE9C,MAAM,CAAC,MAAM,SAAS,GACpB,iGAAiG,CAAC;AAEpG;;;;GAIG;AACH,MAAM,UAAU,iBAAiB;IAC/B,MAAM,eAAe,GAAG,MAAM,CAAC,WAAW,CACxC,MAAM,CAAC,IAAI,CAAC,aAAa,CAAC,UAAU,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,GAAG,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC,CAAC,CAC9E,CAAC;IAEF,OAAO;QACL,OAAO,EAAE,yCAAyC;QAClD,GAAG,EAAE,SAAS;QACd,KAAK,EAAE,wBAAwB;QAC/B,WAAW,EAAE,qDAAqD;QAClE,IAAI,EAAE,QAAQ;QACd,oBAAoB,EAAE,KAAK;QAC3B,UAAU,EAAE;YACV,OAAO,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;YAC3B,OAAO,EAAE;gBACP,IAAI,EAAE,OAAO;gBACb,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;gBACzB,WAAW,EAAE,wBAAwB;aACtC;YACD,OAAO,EAAE;gBACP,IAAI,EAAE,OAAO;gBACb,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;gBACzB,WAAW,EAAE,wBAAwB;aACtC;YACD,WAAW,EAAE;gBACX,IAAI,EAAE,CAAC,GAAG,UAAU,CAAC;gBACrB,WAAW,EAAE,4BAA4B;aAC1C;YACD,KAAK,EAAE;gBACL,IAAI,EAAE,OAAO;gBACb,WAAW,EAAE,IAAI;gBACjB,KAAK,EAAE,EAAE,IAAI,EAAE,CAAC,GAAG,WAAW,CAAC,EAAE;gBACjC,WAAW,EAAE,yCAAyC;aACvD;YACD,QAAQ,EAAE;gBACR,IAAI,EAAE,SAAS;gBACf,OAAO,EAAE,CAAC;gBACV,WAAW,EAAE,kCAAkC;aAChD;YACD,UAAU,EAAE;gBACV,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,uCAAuC;gBACpD,UAAU,EAAE,eAAe;gBAC3B,oBAAoB,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;aACzC;YACD,UAAU,EAAE;gBACV,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,8DAA8D;gBAC3E,oBAAoB,EAAE;oBACpB,IAAI,EAAE,OAAO;oBACb,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;iBAC1B;aACF;SACF;KACF,CAAC;AACJ,CAAC"}

package/dist/config/template.d.ts

@@ -0,0 +1,10 @@
+import type { DebtLensConfig } from "../core/types.js";
+/**
+ * Canonical starter config written by `debtlens init`. Kept in code (not read from
+ * the repo's example file) so it works when DebtLens is installed from npm, where
+ * only `dist/`, `README`, `LICENSE`, and `docs/` are published.
+ */
+export declare const configTemplate: DebtLensConfig & {
+    $schema: string;
+};
+export declare function renderConfigFile(): string;

package/dist/config/template.js

@@ -0,0 +1,32 @@
+/**
+ * Canonical starter config written by `debtlens init`. Kept in code (not read from
+ * the repo's example file) so it works when DebtLens is installed from npm, where
+ * only `dist/`, `README`, `LICENSE`, and `docs/` are published.
+ */
+export const configTemplate = {
+    $schema: "https://raw.githubusercontent.com/ColumbusLabs/debtlens/main/schema/debtlens.config.schema.json",
+    include: ["src/**/*.{ts,tsx,js,jsx}"],
+    exclude: ["node_modules/**", "dist/**", "build/**", ".next/**", "coverage/**"],
+    minSeverity: "low",
+    rules: [
+        "large-component",
+        "state-sprawl",
+        "effect-complexity",
+        "duplicate-logic",
+        "dead-abstraction",
+        "prop-drilling",
+        "todo-comment",
+        "naming-drift",
+    ],
+    thresholds: {
+        "large-component.maxLines": 250,
+        "state-sprawl.maxStatefulHooks": 6,
+        "effect-complexity.maxLines": 30,
+        "duplicate-logic.minSimilarity": 0.86,
+        "duplicate-logic.minLines": 8,
+    },
+};
+export function renderConfigFile() {
+    return `${JSON.stringify(configTemplate, null, 2)}\n`;
+}
+//# sourceMappingURL=template.js.map

package/dist/config/template.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"template.js","sourceRoot":"","sources":["../../src/config/template.ts"],"names":[],"mappings":"AAEA;;;;GAIG;AACH,MAAM,CAAC,MAAM,cAAc,GAAyC;IAClE,OAAO,EAAE,iGAAiG;IAC1G,OAAO,EAAE,CAAC,0BAA0B,CAAC;IACrC,OAAO,EAAE,CAAC,iBAAiB,EAAE,SAAS,EAAE,UAAU,EAAE,UAAU,EAAE,aAAa,CAAC;IAC9E,WAAW,EAAE,KAAK;IAClB,KAAK,EAAE;QACL,iBAAiB;QACjB,cAAc;QACd,mBAAmB;QACnB,iBAAiB;QACjB,kBAAkB;QAClB,eAAe;QACf,cAAc;QACd,cAAc;KACf;IACD,UAAU,EAAE;QACV,0BAA0B,EAAE,GAAG;QAC/B,+BAA+B,EAAE,CAAC;QAClC,4BAA4B,EAAE,EAAE;QAChC,+BAA+B,EAAE,IAAI;QACrC,0BAA0B,EAAE,CAAC;KAC9B;CACF,CAAC;AAEF,MAAM,UAAU,gBAAgB;IAC9B,OAAO,GAAG,IAAI,CAAC,SAAS,CAAC,cAAc,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC;AACxD,CAAC"}

package/dist/core/baseline.d.ts

@@ -0,0 +1,23 @@
+import type { DebtIssue, ScanResult } from "./types.js";
+export declare const DEFAULT_BASELINE_FILENAME = "debtlens-baseline.json";
+export interface Baseline {
+    version: number;
+    generatedAt: string;
+    /** Map of issue fingerprint -> number of occurrences captured. */
+    fingerprints: Record<string, number>;
+}
+/**
+ * Stable fingerprint for an issue. Deliberately excludes the raw line number so a
+ * pre-existing finding stays suppressed when surrounding code moves it up or down.
+ */
+export declare function computeFingerprint(issue: DebtIssue): string;
+export declare function createBaseline(issues: DebtIssue[]): Baseline;
+export declare function writeBaseline(cwd: string, path: string, baseline: Baseline): string;
+export declare function loadBaseline(cwd: string, path: string): Baseline;
+/**
+ * Drop issues already captured in the baseline. Occurrence counts are respected, so
+ * adding a new instance of an already-baselined pattern still surfaces the new one.
+ */
+export declare function filterIssues(issues: DebtIssue[], baseline: Baseline): DebtIssue[];
+/** Apply a baseline to a scan result, returning a new result with a recomputed summary. */
+export declare function applyBaseline(result: ScanResult, baseline: Baseline): ScanResult;

package/dist/core/baseline.js

@@ -0,0 +1,118 @@
+import { existsSync, readFileSync, writeFileSync } from "node:fs";
+import { resolve } from "node:path";
+export const DEFAULT_BASELINE_FILENAME = "debtlens-baseline.json";
+const BASELINE_VERSION = 1;
+// Field delimiter for the fingerprint. normalizeText() collapses all whitespace to a
+// single space, so a newline never appears inside a field, making it a delimiter no
+// field value can span across.
+const FIELD_SEPARATOR = "\n";
+/**
+ * Normalize a textual part of an issue so the fingerprint survives line shifts and
+ * count drift. Digit runs (line numbers AND counts) collapse to `#` and whitespace is
+ * squashed — what's left is the structural shape of the finding.
+ *
+ * Intentional tradeoff: because counts are normalized too, a finding that merely gets
+ * "worse" (e.g. a component growing from 250 to 900 lines) keeps the same fingerprint
+ * and stays suppressed. A baseline is for not re-nagging about known debt, not for
+ * tracking its magnitude, so this is the behavior we want.
+ */
+function normalizeText(value) {
+    return value.replace(/\d+/g, "#").replace(/\s+/g, " ").trim();
+}
+/**
+ * Stable fingerprint for an issue. Deliberately excludes the raw line number so a
+ * pre-existing finding stays suppressed when surrounding code moves it up or down.
+ */
+export function computeFingerprint(issue) {
+    const parts = [
+        issue.ruleId,
+        issue.file,
+        normalizeText(issue.message),
+        normalizeText((issue.evidence ?? []).join("\n")),
+    ].join(FIELD_SEPARATOR);
+    return fnv1a(parts);
+}
+export function createBaseline(issues) {
+    const fingerprints = {};
+    for (const issue of issues) {
+        const fp = computeFingerprint(issue);
+        fingerprints[fp] = (fingerprints[fp] ?? 0) + 1;
+    }
+    return {
+        version: BASELINE_VERSION,
+        generatedAt: new Date().toISOString(),
+        fingerprints,
+    };
+}
+export function writeBaseline(cwd, path, baseline) {
+    const target = resolve(cwd, path);
+    writeFileSync(target, `${JSON.stringify(baseline, null, 2)}\n`, "utf8");
+    return target;
+}
+export function loadBaseline(cwd, path) {
+    const target = resolve(cwd, path);
+    if (!existsSync(target)) {
+        throw new Error(`Baseline file not found at ${target}. Run with --write-baseline first.`);
+    }
+    let parsed;
+    try {
+        parsed = JSON.parse(readFileSync(target, "utf8"));
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        throw new Error(`Could not parse baseline at ${target}: ${message}`);
+    }
+    if (typeof parsed !== "object" ||
+        parsed === null ||
+        typeof parsed.fingerprints !== "object") {
+        throw new Error(`Invalid baseline file at ${target}: missing "fingerprints".`);
+    }
+    return parsed;
+}
+/**
+ * Drop issues already captured in the baseline. Occurrence counts are respected, so
+ * adding a new instance of an already-baselined pattern still surfaces the new one.
+ */
+export function filterIssues(issues, baseline) {
+    const remaining = new Map(Object.entries(baseline.fingerprints));
+    const kept = [];
+    for (const issue of issues) {
+        const fp = computeFingerprint(issue);
+        const budget = remaining.get(fp) ?? 0;
+        if (budget > 0) {
+            remaining.set(fp, budget - 1);
+            continue;
+        }
+        kept.push(issue);
+    }
+    return kept;
+}
+/** Apply a baseline to a scan result, returning a new result with a recomputed summary. */
+export function applyBaseline(result, baseline) {
+    const issues = filterIssues(result.issues, baseline);
+    const bySeverity = { info: 0, low: 0, medium: 0, high: 0 };
+    const byRule = {};
+    for (const issue of issues) {
+        bySeverity[issue.severity] += 1;
+        byRule[issue.ruleId] = (byRule[issue.ruleId] ?? 0) + 1;
+    }
+    return {
+        ...result,
+        issues,
+        summary: {
+            ...result.summary,
+            totalIssues: issues.length,
+            bySeverity,
+            byRule,
+        },
+    };
+}
+function fnv1a(value) {
+    let hash = 2166136261;
+    for (let i = 0; i < value.length; i += 1) {
+        hash ^= value.charCodeAt(i);
+        hash += (hash << 1) + (hash << 4) + (hash << 7) + (hash << 8) + (hash << 24);
+    }
+    return `dl_${(hash >>> 0).toString(16)}`;
+}
+//# sourceMappingURL=baseline.js.map

package/dist/core/baseline.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"baseline.js","sourceRoot":"","sources":["../../src/core/baseline.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAClE,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAGpC,MAAM,CAAC,MAAM,yBAAyB,GAAG,wBAAwB,CAAC;AAClE,MAAM,gBAAgB,GAAG,CAAC,CAAC;AAE3B,qFAAqF;AACrF,oFAAoF;AACpF,+BAA+B;AAC/B,MAAM,eAAe,GAAG,IAAI,CAAC;AAS7B;;;;;;;;;GASG;AACH,SAAS,aAAa,CAAC,KAAa;IAClC,OAAO,KAAK,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;AAChE,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,kBAAkB,CAAC,KAAgB;IACjD,MAAM,KAAK,GAAG;QACZ,KAAK,CAAC,MAAM;QACZ,KAAK,CAAC,IAAI;QACV,aAAa,CAAC,KAAK,CAAC,OAAO,CAAC;QAC5B,aAAa,CAAC,CAAC,KAAK,CAAC,QAAQ,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;KACjD,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;IACxB,OAAO,KAAK,CAAC,KAAK,CAAC,CAAC;AACtB,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,MAAmB;IAChD,MAAM,YAAY,GAA2B,EAAE,CAAC;IAChD,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,MAAM,EAAE,GAAG,kBAAkB,CAAC,KAAK,CAAC,CAAC;QACrC,YAAY,CAAC,EAAE,CAAC,GAAG,CAAC,YAAY,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC;IACjD,CAAC;IACD,OAAO;QACL,OAAO,EAAE,gBAAgB;QACzB,WAAW,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;QACrC,YAAY;KACb,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,GAAW,EAAE,IAAY,EAAE,QAAkB;IACzE,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;IAClC,aAAa,CAAC,MAAM,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IACxE,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,GAAW,EAAE,IAAY;IACpD,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;IAClC,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC;QACxB,MAAM,IAAI,KAAK,CAAC,8BAA8B,MAAM,oCAAoC,CAAC,CAAC;IAC5F,CAAC;IACD,IAAI,MAAe,CAAC;IACpB,IAAI,CAAC;QACH,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IACpD,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QACvE,MAAM,IAAI,KAAK,CAAC,+BAA+B,MAAM,KAAK,OAAO,EAAE,CAAC,CAAC;IACvE,CAAC;IACD,IACE,OAAO,MAAM,KAAK,QAAQ;QAC1B,MAAM,KAAK,IAAI;QACf,OAAQ,MAAmB,CAAC,YAAY,KAAK,QAAQ,EACrD,CAAC;QACD,MAAM,IAAI,KAAK,CAAC,4BAA4B,MAAM,2BAA2B,CAAC,CAAC;IACjF,CAAC;IACD,OAAO,MAAkB,CAAC;AAC5B,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,YAAY,CAAC,MAAmB,EAAE,QAAkB;IAClE,MAAM,SAAS,GAAG,IAAI,GAAG,CAAiB,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAC,CAAC;IACjF,MAAM,IAAI,GAAgB,EAAE,CAAC;IAC7B,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,MAAM,EAAE,GAAG,kBAAkB,CAAC,KAAK,CAAC,CAAC;QACrC,MAAM,MAAM,GAAG,SAAS,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC;QACtC,IAAI,MAAM,GAAG,CAAC,EAAE,CAAC;YACf,SAAS,CAAC,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,CAAC,CAAC,CAAC;YAC9B,SAAS;QACX,CAAC;QACD,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACnB,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,2FAA2F;AAC3F,MAAM,UAAU,aAAa,CAAC,MAAkB,EAAE,QAAkB;IAClE,MAAM,MAAM,GAAG,YAAY,CAAC,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;IACrD,MAAM,UAAU,GAA6B,EAAE,IAAI,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC;IACrF,MAAM,MAAM,GAA2B,EAAE,CAAC;IAC1C,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,UAAU,CAAC,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;QAChC,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC;IACzD,CAAC;IACD,OAAO;QACL,GAAG,MAAM;QACT,MAAM;QACN,OAAO,EAAE;YACP,GAAG,MAAM,CAAC,OAAO;YACjB,WAAW,EAAE,MAAM,CAAC,MAAM;YAC1B,UAAU;YACV,MAAM;SACP;KACF,CAAC;AACJ,CAAC;AAED,SAAS,KAAK,CAAC,KAAa;IAC1B,IAAI,IAAI,GAAG,UAAU,CAAC;IACtB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC;QACzC,IAAI,IAAI,KAAK,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;QAC5B,IAAI,IAAI,CAAC,IAAI,IAAI,CAAC,CAAC,GAAG,CAAC,IAAI,IAAI,CAAC,CAAC,GAAG,CAAC,IAAI,IAAI,CAAC,CAAC,GAAG,CAAC,IAAI,IAAI,CAAC,CAAC,GAAG,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC;IAC/E,CAAC;IACD,OAAO,MAAM,CAAC,IAAI,KAAK,CAAC,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC,EAAE,CAAC;AAC3C,CAAC"}

package/dist/core/scan.d.ts

@@ -0,0 +1,2 @@
+import type { ScanOptions, ScanResult } from "./types.js";
+export declare function scan(options: ScanOptions): Promise<ScanResult>;

package/dist/core/scan.js

@@ -0,0 +1,129 @@
+import { readFileSync, realpathSync, statSync } from "node:fs";
+import { relative } from "node:path";
+import fg from "fast-glob";
+import { Project, ScriptTarget, ts } from "ts-morph";
+import { allDetectors } from "../detectors/index.js";
+import { compareSeverityDesc, meetsMinSeverity } from "./severity.js";
+export async function scan(options) {
+    const startedAt = Date.now();
+    const filePaths = await resolveFilePaths(options);
+    const project = new Project({
+        compilerOptions: {
+            allowJs: true,
+            checkJs: false,
+            jsx: ts.JsxEmit.ReactJSX,
+            target: ScriptTarget.ES2022,
+            skipLibCheck: true,
+        },
+        skipAddingFilesFromTsConfig: true,
+    });
+    const files = [];
+    for (const absolutePath of filePaths) {
+        const sourceFile = project.addSourceFileAtPathIfExists(absolutePath);
+        if (!sourceFile)
+            continue;
+        files.push({
+            absolutePath,
+            relativePath: relative(options.target, absolutePath).replaceAll("\\", "/"),
+            content: readFileSync(absolutePath, "utf8"),
+            sourceFile,
+        });
+    }
+    const detectors = selectDetectors(options.rules);
+    const issues = [];
+    for (const detector of detectors) {
+        const detectorIssues = await detector.detect({
+            project,
+            files,
+            options,
+            getThreshold: (key, fallback) => getThreshold(options, key, fallback),
+        });
+        issues.push(...detectorIssues.filter((issue) => meetsMinSeverity(issue.severity, options.minSeverity)));
+    }
+    issues.sort((a, b) => {
+        const severity = compareSeverityDesc(a.severity, b.severity);
+        if (severity !== 0)
+            return severity;
+        const byFile = a.file.localeCompare(b.file);
+        if (byFile !== 0)
+            return byFile;
+        return (a.location?.startLine ?? 0) - (b.location?.startLine ?? 0);
+    });
+    return {
+        issues,
+        summary: {
+            totalIssues: issues.length,
+            bySeverity: {
+                info: issues.filter((issue) => issue.severity === "info").length,
+                low: issues.filter((issue) => issue.severity === "low").length,
+                medium: issues.filter((issue) => issue.severity === "medium").length,
+                high: issues.filter((issue) => issue.severity === "high").length,
+            },
+            byRule: issues.reduce((accumulator, issue) => {
+                accumulator[issue.ruleId] = (accumulator[issue.ruleId] ?? 0) + 1;
+                return accumulator;
+            }, {}),
+            filesScanned: files.length,
+            rulesRun: detectors.length,
+            elapsedMs: Date.now() - startedAt,
+        },
+        options: {
+            target: options.target,
+            include: options.include,
+            exclude: options.exclude,
+            minSeverity: options.minSeverity,
+            rules: options.rules,
+        },
+    };
+}
+async function resolveFilePaths(options) {
+    const stats = statSync(options.target);
+    const isFile = stats.isFile();
+    // Canonicalize so the --changed set (paths from git, which resolves symlinks like
+    // macOS /var -> /private/var) matches fast-glob's output, which does not.
+    const changed = options.changedFiles
+        ? new Set(options.changedFiles.map(canonicalize))
+        : undefined;
+    if (isFile) {
+        if (changed && !changed.has(canonicalize(options.target)))
+            return [];
+        return [options.target];
+    }
+    let paths = await fg(options.include, {
+        cwd: options.target,
+        absolute: true,
+        onlyFiles: true,
+        ignore: options.exclude,
+        dot: false,
+        unique: true,
+    });
+    if (changed) {
+        paths = paths.filter((path) => changed.has(canonicalize(path)));
+    }
+    return paths.slice(0, options.maxFiles ?? paths.length);
+}
+function canonicalize(path) {
+    try {
+        return realpathSync.native(path);
+    }
+    catch {
+        return path;
+    }
+}
+function selectDetectors(ruleIds) {
+    if (!ruleIds || ruleIds.length === 0) {
+        return allDetectors;
+    }
+    const requested = new Set(ruleIds);
+    const selected = allDetectors.filter((detector) => requested.has(detector.id));
+    const missing = [...requested].filter((ruleId) => !allDetectors.some((detector) => detector.id === ruleId));
+    if (missing.length > 0) {
+        throw new Error(`Unknown DebtLens rule(s): ${missing.join(", ")}`);
+    }
+    return selected;
+}
+function getThreshold(options, key, fallback) {
+    const value = options.thresholds[key];
+    return Number.isFinite(value) ? value : fallback;
+}
+//# sourceMappingURL=scan.js.map

package/dist/core/scan.js.map

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

package/dist/core/severity.d.ts

@@ -0,0 +1,7 @@
+import type { Severity } from "./types.js";
+export declare const severityRank: Record<Severity, number>;
+export declare const severities: Severity[];
+export declare function isSeverity(value: string | undefined): value is Severity;
+export declare function parseSeverity(value: string | undefined, fallback: Severity): Severity;
+export declare function meetsMinSeverity(severity: Severity, minSeverity: Severity): boolean;
+export declare function compareSeverityDesc(a: Severity, b: Severity): number;

package/dist/core/severity.js

@@ -0,0 +1,26 @@
+export const severityRank = {
+    info: 0,
+    low: 1,
+    medium: 2,
+    high: 3,
+};
+export const severities = ["info", "low", "medium", "high"];
+export function isSeverity(value) {
+    return value === "info" || value === "low" || value === "medium" || value === "high";
+}
+export function parseSeverity(value, fallback) {
+    if (!value)
+        return fallback;
+    const normalized = value.toLowerCase();
+    if (!isSeverity(normalized)) {
+        throw new Error(`Invalid severity "${value}". Expected one of: ${severities.join(", ")}`);
+    }
+    return normalized;
+}
+export function meetsMinSeverity(severity, minSeverity) {
+    return severityRank[severity] >= severityRank[minSeverity];
+}
+export function compareSeverityDesc(a, b) {
+    return severityRank[b] - severityRank[a];
+}
+//# sourceMappingURL=severity.js.map

package/dist/core/severity.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"severity.js","sourceRoot":"","sources":["../../src/core/severity.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,YAAY,GAA6B;IACpD,IAAI,EAAE,CAAC;IACP,GAAG,EAAE,CAAC;IACN,MAAM,EAAE,CAAC;IACT,IAAI,EAAE,CAAC;CACR,CAAC;AAEF,MAAM,CAAC,MAAM,UAAU,GAAe,CAAC,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,CAAC,CAAC;AAExE,MAAM,UAAU,UAAU,CAAC,KAAyB;IAClD,OAAO,KAAK,KAAK,MAAM,IAAI,KAAK,KAAK,KAAK,IAAI,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,MAAM,CAAC;AACvF,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,KAAyB,EAAE,QAAkB;IACzE,IAAI,CAAC,KAAK;QAAE,OAAO,QAAQ,CAAC;IAC5B,MAAM,UAAU,GAAG,KAAK,CAAC,WAAW,EAAE,CAAC;IACvC,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;QAC5B,MAAM,IAAI,KAAK,CAAC,qBAAqB,KAAK,uBAAuB,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAC5F,CAAC;IACD,OAAO,UAAU,CAAC;AACpB,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,QAAkB,EAAE,WAAqB;IACxE,OAAO,YAAY,CAAC,QAAQ,CAAC,IAAI,YAAY,CAAC,WAAW,CAAC,CAAC;AAC7D,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,CAAW,EAAE,CAAW;IAC1D,OAAO,YAAY,CAAC,CAAC,CAAC,GAAG,YAAY,CAAC,CAAC,CAAC,CAAC;AAC3C,CAAC"}

package/dist/core/types.d.ts

@@ -0,0 +1,96 @@
+import type { Project, SourceFile } from "ts-morph";
+export type Severity = "info" | "low" | "medium" | "high";
+export type OutputFormat = "terminal" | "json" | "markdown" | "sarif";
+export interface IssueLocation {
+    startLine: number;
+    startColumn?: number;
+    endLine?: number;
+    endColumn?: number;
+}
+export interface DebtIssue {
+    id: string;
+    ruleId: string;
+    ruleName: string;
+    severity: Severity;
+    confidence: number;
+    message: string;
+    file: string;
+    location?: IssueLocation;
+    evidence?: string[];
+    suggestion?: string;
+    tags: string[];
+}
+export interface SourceFileInfo {
+    absolutePath: string;
+    relativePath: string;
+    content: string;
+    sourceFile: SourceFile;
+}
+export interface ScanThresholds {
+    [key: string]: number;
+}
+export interface DebtLensConfig {
+    include?: string[];
+    exclude?: string[];
+    minSeverity?: Severity;
+    rules?: string[];
+    thresholds?: ScanThresholds;
+    maxFiles?: number;
+    /** Concept id -> competing term variants, used by the naming-drift rule. */
+    vocabulary?: Record<string, string[]>;
+}
+export interface ScanOptions {
+    cwd: string;
+    target: string;
+    include: string[];
+    exclude: string[];
+    minSeverity: Severity;
+    rules?: string[];
+    thresholds: ScanThresholds;
+    maxFiles?: number;
+    vocabulary?: Record<string, string[]>;
+    /** When set, only scan files whose absolute path is in this list (--changed mode). */
+    changedFiles?: string[];
+}
+export interface CliOptions {
+    cwd?: string;
+    include?: string[];
+    exclude?: string[];
+    minSeverity?: Severity;
+    rules?: string[];
+    thresholds?: ScanThresholds;
+    maxFiles?: number;
+    format?: OutputFormat;
+    output?: string;
+    failOn?: Severity;
+    configPath?: string;
+    noColor?: boolean;
+    changedFiles?: string[];
+}
+export interface DetectorContext {
+    project: Project;
+    files: SourceFileInfo[];
+    options: ScanOptions;
+    getThreshold: (key: string, fallback: number) => number;
+}
+export interface Detector {
+    id: string;
+    name: string;
+    description: string;
+    defaultSeverity: Severity;
+    tags: string[];
+    detect: (context: DetectorContext) => Promise<DebtIssue[]> | DebtIssue[];
+}
+export interface ScanSummary {
+    totalIssues: number;
+    bySeverity: Record<Severity, number>;
+    byRule: Record<string, number>;
+    filesScanned: number;
+    rulesRun: number;
+    elapsedMs: number;
+}
+export interface ScanResult {
+    issues: DebtIssue[];
+    summary: ScanSummary;
+    options: Pick<ScanOptions, "target" | "include" | "exclude" | "minSeverity" | "rules">;
+}

package/dist/core/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/core/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/core/types.ts"],"names":[],"mappings":""}

package/dist/detectors/deadAbstraction.d.ts

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