@tech-debt/core 0.1.0

package/README.md

@@ -0,0 +1,3 @@
+# @tech-debt/core
+
+Comment scanner, git blame enrichment, and debt aggregations for Tech Debt.

package/dist/__fixtures__/sample.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Sample fixture used to verify tech-debt scanning.
+ *
+ * @deprecated Use the new scanner API instead.
+ */
+export declare function legacyHelper(): number;
+export declare const FLAG = true;
+//# sourceMappingURL=sample.d.ts.map

package/dist/__fixtures__/sample.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sample.d.ts","sourceRoot":"","sources":["../../src/__fixtures__/sample.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,wBAAgB,YAAY,WAI3B;AAGD,eAAO,MAAM,IAAI,OAAO,CAAC"}

package/dist/__fixtures__/sample.js

@@ -0,0 +1,13 @@
+/**
+ * Sample fixture used to verify tech-debt scanning.
+ *
+ * @deprecated Use the new scanner API instead.
+ */
+export function legacyHelper() {
+    // TODO: replace with async variant
+    // FIXME: handle empty input
+    return 42;
+}
+/* TODO: migrate callers off this module */
+export const FLAG = true;
+//# sourceMappingURL=sample.js.map

package/dist/__fixtures__/sample.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sample.js","sourceRoot":"","sources":["../../src/__fixtures__/sample.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,UAAU,YAAY;IAC1B,mCAAmC;IACnC,4BAA4B;IAC5B,OAAO,EAAE,CAAC;AACZ,CAAC;AAED,2CAA2C;AAC3C,MAAM,CAAC,MAAM,IAAI,GAAG,IAAI,CAAC"}

package/dist/aggregate.d.ts

@@ -0,0 +1,9 @@
+import type { AgeBucket, AuthorDebt, DebtItem, DebtKind, DebtStats, FileDebt, SearchEntry } from './types.js';
+export declare function ageBucketFromDays(days: number | null | undefined): AgeBucket;
+export declare function emptyKindCounts(): Record<DebtKind, number>;
+export declare function emptyAgeCounts(): Record<AgeBucket, number>;
+export declare function buildAuthors(items: DebtItem[]): AuthorDebt[];
+export declare function buildFiles(items: DebtItem[]): FileDebt[];
+export declare function buildSearchIndex(items: DebtItem[]): SearchEntry[];
+export declare function buildStats(items: DebtItem[], scannedFiles: number, scanDurationMs: number, blameEnabled: boolean): DebtStats;
+//# sourceMappingURL=aggregate.d.ts.map

package/dist/aggregate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"aggregate.d.ts","sourceRoot":"","sources":["../src/aggregate.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,SAAS,EACT,UAAU,EACV,QAAQ,EACR,QAAQ,EACR,SAAS,EACT,QAAQ,EACR,WAAW,EACZ,MAAM,YAAY,CAAC;AAEpB,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,SAAS,CAO5E;AAED,wBAAgB,eAAe,IAAI,MAAM,CAAC,QAAQ,EAAE,MAAM,CAAC,CAE1D;AAED,wBAAgB,cAAc,IAAI,MAAM,CAAC,SAAS,EAAE,MAAM,CAAC,CAS1D;AAED,wBAAgB,YAAY,CAAC,KAAK,EAAE,QAAQ,EAAE,GAAG,UAAU,EAAE,CA4C5D;AAED,wBAAgB,UAAU,CAAC,KAAK,EAAE,QAAQ,EAAE,GAAG,QAAQ,EAAE,CA6BxD;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,QAAQ,EAAE,GAAG,WAAW,EAAE,CAcjE;AAED,wBAAgB,UAAU,CACxB,KAAK,EAAE,QAAQ,EAAE,EACjB,YAAY,EAAE,MAAM,EACpB,cAAc,EAAE,MAAM,EACtB,YAAY,EAAE,OAAO,GACpB,SAAS,CAkCX"}

package/dist/aggregate.js

@@ -0,0 +1,139 @@
+export function ageBucketFromDays(days) {
+    if (days == null || Number.isNaN(days))
+        return 'unknown';
+    if (days < 30)
+        return 'fresh';
+    if (days < 90)
+        return 'recent';
+    if (days < 180)
+        return 'aging';
+    if (days < 365)
+        return 'stale';
+    return 'ancient';
+}
+export function emptyKindCounts() {
+    return { todo: 0, fixme: 0, deprecated: 0 };
+}
+export function emptyAgeCounts() {
+    return {
+        fresh: 0,
+        recent: 0,
+        aging: 0,
+        stale: 0,
+        ancient: 0,
+        unknown: 0,
+    };
+}
+export function buildAuthors(items) {
+    const map = new Map();
+    for (const item of items) {
+        const author = item.blame?.author ?? 'Unknown';
+        const email = item.blame?.authorEmail ?? '';
+        const key = `${author}|${email}`;
+        let entry = map.get(key);
+        if (!entry) {
+            entry = {
+                author,
+                authorEmail: email,
+                total: 0,
+                byKind: emptyKindCounts(),
+                oldestAgeDays: null,
+                averageAgeDays: null,
+                items: [],
+            };
+            map.set(key, entry);
+        }
+        entry.total++;
+        entry.byKind[item.kind]++;
+        entry.items.push(item.id);
+        const age = item.blame?.ageDays;
+        if (age != null) {
+            entry.oldestAgeDays =
+                entry.oldestAgeDays == null ? age : Math.max(entry.oldestAgeDays, age);
+        }
+    }
+    for (const entry of map.values()) {
+        const ages = entry.items
+            .map((id) => items.find((i) => i.id === id)?.blame?.ageDays)
+            .filter((d) => d != null);
+        entry.averageAgeDays =
+            ages.length === 0
+                ? null
+                : Math.round(ages.reduce((a, b) => a + b, 0) / ages.length);
+    }
+    return [...map.values()].sort((a, b) => b.total - a.total);
+}
+export function buildFiles(items) {
+    const map = new Map();
+    for (const item of items) {
+        let entry = map.get(item.filePath);
+        if (!entry) {
+            entry = {
+                path: item.filePath,
+                relativePath: item.relativePath,
+                total: 0,
+                byKind: emptyKindCounts(),
+                oldestAgeDays: null,
+                items: [],
+            };
+            map.set(item.filePath, entry);
+        }
+        entry.total++;
+        entry.byKind[item.kind]++;
+        entry.items.push(item.id);
+        const age = item.blame?.ageDays;
+        if (age != null) {
+            entry.oldestAgeDays =
+                entry.oldestAgeDays == null ? age : Math.max(entry.oldestAgeDays, age);
+        }
+    }
+    return [...map.values()].sort((a, b) => b.total - a.total);
+}
+export function buildSearchIndex(items) {
+    return items.map((item) => ({
+        id: item.id,
+        label: item.message,
+        kind: item.kind,
+        path: item.relativePath,
+        keywords: [
+            item.kind,
+            item.message,
+            item.relativePath,
+            item.blame?.author ?? '',
+            item.raw,
+        ].filter(Boolean),
+    }));
+}
+export function buildStats(items, scannedFiles, scanDurationMs, blameEnabled) {
+    const byKind = emptyKindCounts();
+    const byAge = emptyAgeCounts();
+    const authors = new Set();
+    const ages = [];
+    let blamed = 0;
+    for (const item of items) {
+        byKind[item.kind]++;
+        byAge[item.ageBucket]++;
+        if (item.blame) {
+            blamed++;
+            authors.add(`${item.blame.author}|${item.blame.authorEmail}`);
+            ages.push(item.blame.ageDays);
+        }
+    }
+    const fileSet = new Set(items.map((i) => i.filePath));
+    return {
+        totalItems: items.length,
+        totalFiles: fileSet.size,
+        scannedFiles,
+        byKind,
+        byAge,
+        authors: authors.size,
+        oldestAgeDays: ages.length ? Math.max(...ages) : null,
+        averageAgeDays: ages.length
+            ? Math.round(ages.reduce((a, b) => a + b, 0) / ages.length)
+            : null,
+        scanDurationMs,
+        blameEnabled,
+        blameCoverage: items.length === 0 ? 0 : blamed / items.length,
+    };
+}
+//# sourceMappingURL=aggregate.js.map

package/dist/aggregate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"aggregate.js","sourceRoot":"","sources":["../src/aggregate.ts"],"names":[],"mappings":"AAUA,MAAM,UAAU,iBAAiB,CAAC,IAA+B;IAC/D,IAAI,IAAI,IAAI,IAAI,IAAI,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC;QAAE,OAAO,SAAS,CAAC;IACzD,IAAI,IAAI,GAAG,EAAE;QAAE,OAAO,OAAO,CAAC;IAC9B,IAAI,IAAI,GAAG,EAAE;QAAE,OAAO,QAAQ,CAAC;IAC/B,IAAI,IAAI,GAAG,GAAG;QAAE,OAAO,OAAO,CAAC;IAC/B,IAAI,IAAI,GAAG,GAAG;QAAE,OAAO,OAAO,CAAC;IAC/B,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,MAAM,UAAU,eAAe;IAC7B,OAAO,EAAE,IAAI,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,UAAU,EAAE,CAAC,EAAE,CAAC;AAC9C,CAAC;AAED,MAAM,UAAU,cAAc;IAC5B,OAAO;QACL,KAAK,EAAE,CAAC;QACR,MAAM,EAAE,CAAC;QACT,KAAK,EAAE,CAAC;QACR,KAAK,EAAE,CAAC;QACR,OAAO,EAAE,CAAC;QACV,OAAO,EAAE,CAAC;KACX,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,KAAiB;IAC5C,MAAM,GAAG,GAAG,IAAI,GAAG,EAAsB,CAAC;IAE1C,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,EAAE,MAAM,IAAI,SAAS,CAAC;QAC/C,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,EAAE,WAAW,IAAI,EAAE,CAAC;QAC5C,MAAM,GAAG,GAAG,GAAG,MAAM,IAAI,KAAK,EAAE,CAAC;QAEjC,IAAI,KAAK,GAAG,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACzB,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,KAAK,GAAG;gBACN,MAAM;gBACN,WAAW,EAAE,KAAK;gBAClB,KAAK,EAAE,CAAC;gBACR,MAAM,EAAE,eAAe,EAAE;gBACzB,aAAa,EAAE,IAAI;gBACnB,cAAc,EAAE,IAAI;gBACpB,KAAK,EAAE,EAAE;aACV,CAAC;YACF,GAAG,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;QACtB,CAAC;QAED,KAAK,CAAC,KAAK,EAAE,CAAC;QACd,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;QAC1B,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAE1B,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,EAAE,OAAO,CAAC;QAChC,IAAI,GAAG,IAAI,IAAI,EAAE,CAAC;YAChB,KAAK,CAAC,aAAa;gBACjB,KAAK,CAAC,aAAa,IAAI,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,aAAa,EAAE,GAAG,CAAC,CAAC;QAC3E,CAAC;IACH,CAAC;IAED,KAAK,MAAM,KAAK,IAAI,GAAG,CAAC,MAAM,EAAE,EAAE,CAAC;QACjC,MAAM,IAAI,GAAG,KAAK,CAAC,KAAK;aACrB,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,KAAK,EAAE,OAAO,CAAC;aAC3D,MAAM,CAAC,CAAC,CAAC,EAAe,EAAE,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC;QACzC,KAAK,CAAC,cAAc;YAClB,IAAI,CAAC,MAAM,KAAK,CAAC;gBACf,CAAC,CAAC,IAAI;gBACN,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC;IAClE,CAAC;IAED,OAAO,CAAC,GAAG,GAAG,CAAC,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC;AAC7D,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,KAAiB;IAC1C,MAAM,GAAG,GAAG,IAAI,GAAG,EAAoB,CAAC;IAExC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,IAAI,KAAK,GAAG,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QACnC,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,KAAK,GAAG;gBACN,IAAI,EAAE,IAAI,CAAC,QAAQ;gBACnB,YAAY,EAAE,IAAI,CAAC,YAAY;gBAC/B,KAAK,EAAE,CAAC;gBACR,MAAM,EAAE,eAAe,EAAE;gBACzB,aAAa,EAAE,IAAI;gBACnB,KAAK,EAAE,EAAE;aACV,CAAC;YACF,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;QAChC,CAAC;QAED,KAAK,CAAC,KAAK,EAAE,CAAC;QACd,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;QAC1B,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAE1B,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,EAAE,OAAO,CAAC;QAChC,IAAI,GAAG,IAAI,IAAI,EAAE,CAAC;YAChB,KAAK,CAAC,aAAa;gBACjB,KAAK,CAAC,aAAa,IAAI,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,aAAa,EAAE,GAAG,CAAC,CAAC;QAC3E,CAAC;IACH,CAAC;IAED,OAAO,CAAC,GAAG,GAAG,CAAC,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC;AAC7D,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,KAAiB;IAChD,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;QAC1B,EAAE,EAAE,IAAI,CAAC,EAAE;QACX,KAAK,EAAE,IAAI,CAAC,OAAO;QACnB,IAAI,EAAE,IAAI,CAAC,IAAI;QACf,IAAI,EAAE,IAAI,CAAC,YAAY;QACvB,QAAQ,EAAE;YACR,IAAI,CAAC,IAAI;YACT,IAAI,CAAC,OAAO;YACZ,IAAI,CAAC,YAAY;YACjB,IAAI,CAAC,KAAK,EAAE,MAAM,IAAI,EAAE;YACxB,IAAI,CAAC,GAAG;SACT,CAAC,MAAM,CAAC,OAAO,CAAC;KAClB,CAAC,CAAC,CAAC;AACN,CAAC;AAED,MAAM,UAAU,UAAU,CACxB,KAAiB,EACjB,YAAoB,EACpB,cAAsB,EACtB,YAAqB;IAErB,MAAM,MAAM,GAAG,eAAe,EAAE,CAAC;IACjC,MAAM,KAAK,GAAG,cAAc,EAAE,CAAC;IAC/B,MAAM,OAAO,GAAG,IAAI,GAAG,EAAU,CAAC;IAClC,MAAM,IAAI,GAAa,EAAE,CAAC;IAC1B,IAAI,MAAM,GAAG,CAAC,CAAC;IAEf,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;QACpB,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC;QACxB,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;YACf,MAAM,EAAE,CAAC;YACT,OAAO,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,IAAI,IAAI,CAAC,KAAK,CAAC,WAAW,EAAE,CAAC,CAAC;YAC9D,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QAChC,CAAC;IACH,CAAC;IAED,MAAM,OAAO,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC;IAEtD,OAAO;QACL,UAAU,EAAE,KAAK,CAAC,MAAM;QACxB,UAAU,EAAE,OAAO,CAAC,IAAI;QACxB,YAAY;QACZ,MAAM;QACN,KAAK;QACL,OAAO,EAAE,OAAO,CAAC,IAAI;QACrB,aAAa,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI;QACrD,cAAc,EAAE,IAAI,CAAC,MAAM;YACzB,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC;YAC3D,CAAC,CAAC,IAAI;QACR,cAAc;QACd,YAAY;QACZ,aAAa,EAAE,KAAK,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,GAAG,KAAK,CAAC,MAAM;KAC9D,CAAC;AACJ,CAAC"}

package/dist/blame.d.ts

@@ -0,0 +1,7 @@
+import type { BlameInfo } from './types.js';
+/**
+ * Blame specific lines in a file using a single `git blame --line-porcelain` pass.
+ * Returns a map of line number → blame info.
+ */
+export declare function blameFileLines(root: string, filePath: string, lines: number[]): Promise<Map<number, BlameInfo>>;
+//# sourceMappingURL=blame.d.ts.map

package/dist/blame.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"blame.d.ts","sourceRoot":"","sources":["../src/blame.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAS5C;;;GAGG;AACH,wBAAsB,cAAc,CAClC,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,MAAM,EAAE,GACd,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC,CA8BjC"}

package/dist/blame.js

@@ -0,0 +1,86 @@
+import { execFile } from 'node:child_process';
+import { promisify } from 'node:util';
+const execFileAsync = promisify(execFile);
+/**
+ * Blame specific lines in a file using a single `git blame --line-porcelain` pass.
+ * Returns a map of line number → blame info.
+ */
+export async function blameFileLines(root, filePath, lines) {
+    const result = new Map();
+    if (lines.length === 0)
+        return result;
+    const unique = [...new Set(lines)].sort((a, b) => a - b);
+    try {
+        // Blame the whole file once — cheaper than N -L calls for dense debt files
+        const { stdout } = await execFileAsync('git', ['blame', '--line-porcelain', '--', filePath], {
+            cwd: root,
+            maxBuffer: 20 * 1024 * 1024,
+            encoding: 'utf-8',
+        });
+        const parsed = parsePorcelain(stdout);
+        const wanted = new Set(unique);
+        for (const entry of parsed) {
+            if (wanted.has(entry.line)) {
+                result.set(entry.line, entry.info);
+            }
+        }
+    }
+    catch {
+        // Not a git repo, untracked file, or git unavailable — leave empty
+    }
+    return result;
+}
+function parsePorcelain(stdout) {
+    const entries = [];
+    const blocks = stdout.split(/\n(?=[0-9a-f]{40} )/i);
+    for (const block of blocks) {
+        if (!block.trim())
+            continue;
+        const lines = block.split('\n');
+        const header = lines[0]?.match(/^([0-9a-f]{40})\s+(\d+)\s+(\d+)(?:\s+(\d+))?/i);
+        if (!header)
+            continue;
+        const commitHash = header[1];
+        const resultLine = parseInt(header[3], 10);
+        let author = 'Unknown';
+        let authorEmail = '';
+        let authorTime = 0;
+        let summary = '';
+        for (let i = 1; i < lines.length; i++) {
+            const line = lines[i];
+            if (line.startsWith('author '))
+                author = line.slice(7);
+            else if (line.startsWith('author-mail ')) {
+                authorEmail = line.slice(12).replace(/^<|>$/g, '');
+            }
+            else if (line.startsWith('author-time ')) {
+                authorTime = parseInt(line.slice(12), 10) * 1000;
+            }
+            else if (line.startsWith('summary ')) {
+                summary = line.slice(8);
+            }
+            else if (line.startsWith('\t')) {
+                break;
+            }
+        }
+        const committedAt = authorTime
+            ? new Date(authorTime).toISOString()
+            : new Date(0).toISOString();
+        const ageDays = authorTime
+            ? Math.max(0, Math.floor((Date.now() - authorTime) / (1000 * 60 * 60 * 24)))
+            : 0;
+        entries.push({
+            line: resultLine,
+            info: {
+                author,
+                authorEmail,
+                committedAt,
+                ageDays,
+                commitHash: commitHash.slice(0, 12),
+                summary: summary || undefined,
+            },
+        });
+    }
+    return entries;
+}
+//# sourceMappingURL=blame.js.map

package/dist/blame.js.map

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

package/dist/comment-parser.d.ts

@@ -0,0 +1,11 @@
+import type { DebtKind } from './types.js';
+export interface RawMatch {
+    kind: DebtKind;
+    message: string;
+    raw: string;
+    line: number;
+    column: number;
+    context?: string;
+}
+export declare function parseComments(content: string, filePath?: string): RawMatch[];
+//# sourceMappingURL=comment-parser.d.ts.map

package/dist/comment-parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"comment-parser.d.ts","sourceRoot":"","sources":["../src/comment-parser.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAE3C,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,QAAQ,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAmCD,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,SAAK,GAAG,QAAQ,EAAE,CAkExE"}

package/dist/comment-parser.js

@@ -0,0 +1,114 @@
+const LINE_PATTERNS = [
+    { kind: 'todo', hasPrefix: true, regex: /^(\s*\/\/\/?!?\s*)TODO\b\s*:?\s*(.*)$/i },
+    { kind: 'fixme', hasPrefix: true, regex: /^(\s*\/\/\/?!?\s*)FIXME\b\s*:?\s*(.*)$/i },
+    { kind: 'todo', hasPrefix: true, regex: /^(\s*#\s*)TODO\b\s*:?\s*(.*)$/i },
+    { kind: 'fixme', hasPrefix: true, regex: /^(\s*#\s*)FIXME\b\s*:?\s*(.*)$/i },
+    { kind: 'todo', hasPrefix: true, regex: /^(\s*\*\s*)TODO\b\s*:?\s*(.*)$/i },
+    { kind: 'fixme', hasPrefix: true, regex: /^(\s*\*\s*)FIXME\b\s*:?\s*(.*)$/i },
+    { kind: 'deprecated', hasPrefix: true, regex: /^(\s*\*\s*)@deprecated\b\s*:?\s*(.*)$/i },
+    { kind: 'deprecated', hasPrefix: true, regex: /^(\s*\/\/\/?!?\s*)@deprecated\b\s*:?\s*(.*)$/i },
+    { kind: 'deprecated', hasPrefix: true, regex: /^(\s*#\s*)@deprecated\b\s*:?\s*(.*)$/i },
+];
+const MARKDOWN_LINE_PATTERNS = [
+    { kind: 'todo', hasPrefix: true, regex: /^(\s*[-*]\s+(?:\[[ xX]\]\s*)?)TODO\b\s*:?\s*(.*)$/i },
+    { kind: 'fixme', hasPrefix: true, regex: /^(\s*[-*]\s+(?:\[[ xX]\]\s*)?)FIXME\b\s*:?\s*(.*)$/i },
+];
+const INLINE_PATTERNS = [
+    { kind: 'todo', regex: /<!--\s*TODO\b\s*:?\s*(.*?)-->/gi },
+    { kind: 'fixme', regex: /<!--\s*FIXME\b\s*:?\s*(.*?)-->/gi },
+    { kind: 'todo', regex: /\/\*+\s*TODO\b\s*:?\s*(.*?)(?:\*\/|$)/gi },
+    { kind: 'fixme', regex: /\/\*+\s*FIXME\b\s*:?\s*(.*?)(?:\*\/|$)/gi },
+    { kind: 'deprecated', regex: /\/\*+\s*@deprecated\b\s*:?\s*(.*?)(?:\*\/|$)/gi },
+];
+export function parseComments(content, filePath = '') {
+    const lines = content.split(/\r?\n/);
+    const matches = [];
+    const seen = new Set();
+    const isMarkdown = /\.(md|mdx)$/i.test(filePath);
+    const linePatterns = isMarkdown ? MARKDOWN_LINE_PATTERNS : LINE_PATTERNS;
+    const inlinePatterns = isMarkdown
+        ? INLINE_PATTERNS.filter((p) => p.regex.source.includes('<!--'))
+        : INLINE_PATTERNS;
+    for (let i = 0; i < lines.length; i++) {
+        const lineText = lines[i];
+        for (const pattern of linePatterns) {
+            const match = pattern.regex.exec(lineText);
+            // Reset sticky state for non-/g patterns reused across lines
+            pattern.regex.lastIndex = 0;
+            if (!match)
+                continue;
+            const message = cleanMessage(pattern.hasPrefix ? (match[2] ?? '') : (match[1] ?? ''));
+            const raw = match[0].trim();
+            const line = i + 1;
+            const column = (match.index ?? 0) + 1;
+            const key = `${pattern.kind}:${line}:${column}:${raw.slice(0, 80)}`;
+            if (seen.has(key))
+                continue;
+            seen.add(key);
+            matches.push({
+                kind: pattern.kind,
+                message: message || defaultMessage(pattern.kind),
+                raw,
+                line,
+                column,
+                context: buildContext(lines, line),
+            });
+        }
+    }
+    for (const pattern of inlinePatterns) {
+        pattern.regex.lastIndex = 0;
+        let match;
+        while ((match = pattern.regex.exec(content)) !== null) {
+            const index = match.index;
+            const line = offsetToLine(content, index);
+            const column = index - lineStartOffset(content, index) + 1;
+            const message = cleanMessage(match[1] ?? '');
+            const raw = match[0].trim();
+            const key = `${pattern.kind}:${line}:${column}:${raw.slice(0, 80)}`;
+            if (seen.has(key))
+                continue;
+            seen.add(key);
+            matches.push({
+                kind: pattern.kind,
+                message: message || defaultMessage(pattern.kind),
+                raw,
+                line,
+                column,
+                context: buildContext(lines, line),
+            });
+        }
+    }
+    matches.sort((a, b) => a.line - b.line || a.column - b.column);
+    return matches;
+}
+function cleanMessage(text) {
+    return text
+        .replace(/\*+\/?\s*$/, '')
+        .replace(/-->$/, '')
+        .replace(/\s+/g, ' ')
+        .trim();
+}
+function defaultMessage(kind) {
+    if (kind === 'deprecated')
+        return 'Deprecated';
+    return '(no message)';
+}
+function offsetToLine(content, offset) {
+    let line = 1;
+    for (let i = 0; i < offset && i < content.length; i++) {
+        if (content[i] === '\n')
+            line++;
+    }
+    return line;
+}
+function lineStartOffset(content, offset) {
+    const before = content.lastIndexOf('\n', offset - 1);
+    return before === -1 ? 0 : before + 1;
+}
+function buildContext(lines, line) {
+    const idx = line - 1;
+    const start = Math.max(0, idx - 1);
+    const end = Math.min(lines.length, idx + 2);
+    return lines.slice(start, end).join('\n');
+}
+//# sourceMappingURL=comment-parser.js.map

package/dist/comment-parser.js.map

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

package/dist/discovery.d.ts

@@ -0,0 +1,7 @@
+import type { ProjectConfig } from './types.js';
+declare const SOURCE_EXTENSIONS: Set<string>;
+declare const IGNORE_DIRS: Set<string>;
+export declare function discoverProject(root: string): ProjectConfig;
+export declare function collectSourceFiles(root: string): string[];
+export { SOURCE_EXTENSIONS, IGNORE_DIRS };
+//# sourceMappingURL=discovery.d.ts.map

package/dist/discovery.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"discovery.d.ts","sourceRoot":"","sources":["../src/discovery.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAEhD,QAAA,MAAM,iBAAiB,aAQrB,CAAC;AAEH,QAAA,MAAM,WAAW,aA+Bf,CAAC;AAEH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,aAAa,CAY3D;AAED,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAIzD;AA0DD,OAAO,EAAE,iBAAiB,EAAE,WAAW,EAAE,CAAC"}

package/dist/discovery.js

@@ -0,0 +1,119 @@
+import fs from 'node:fs';
+import path from 'node:path';
+import { execFileSync } from 'node:child_process';
+const SOURCE_EXTENSIONS = new Set([
+    '.ts', '.tsx', '.js', '.jsx', '.mjs', '.cjs',
+    '.py', '.go', '.rs', '.java', '.kt', '.kts',
+    '.swift', '.rb', '.php', '.cs', '.scala',
+    '.vue', '.svelte', '.css', '.scss', '.sass', '.less',
+    '.html', '.htm',
+    '.sh', '.bash', '.zsh', '.yml', '.yaml',
+    '.sql', '.graphql', '.gql',
+]);
+const IGNORE_DIRS = new Set([
+    'node_modules',
+    '.git',
+    'dist',
+    'build',
+    'out',
+    '.expo',
+    'android',
+    'ios',
+    'coverage',
+    '.next',
+    '.nuxt',
+    '.output',
+    '__tests__',
+    '__mocks__',
+    '.venv',
+    'venv',
+    '.idea',
+    '.turbo',
+    '.cache',
+    'vendor',
+    'Pods',
+    '.gradle',
+    'DerivedData',
+    '.svelte-kit',
+    'target',
+    'bin',
+    'obj',
+    '.parcel-cache',
+    '.yarn',
+    'storybook-static',
+]);
+export function discoverProject(root) {
+    const resolved = path.resolve(root);
+    const pkgPath = findNearestFile(resolved, 'package.json');
+    const pkg = pkgPath ? readJson(pkgPath) : null;
+    const name = pkg?.name ?? path.basename(resolved);
+    const isGitRepo = isInsideGitRepo(resolved);
+    return {
+        root: resolved,
+        name,
+        isGitRepo,
+    };
+}
+export function collectSourceFiles(root) {
+    const files = [];
+    walk(root, root, files);
+    return files;
+}
+function walk(root, dir, out) {
+    let entries;
+    try {
+        entries = fs.readdirSync(dir, { withFileTypes: true });
+    }
+    catch {
+        return;
+    }
+    for (const entry of entries) {
+        if (entry.name.startsWith('.'))
+            continue;
+        const full = path.join(dir, entry.name);
+        if (entry.isDirectory()) {
+            if (IGNORE_DIRS.has(entry.name))
+                continue;
+            walk(root, full, out);
+            continue;
+        }
+        if (!entry.isFile())
+            continue;
+        const ext = path.extname(entry.name).toLowerCase();
+        if (!SOURCE_EXTENSIONS.has(ext))
+            continue;
+        out.push(full);
+    }
+}
+function findNearestFile(root, filename) {
+    let current = root;
+    while (current !== path.dirname(current)) {
+        const candidate = path.join(current, filename);
+        if (fs.existsSync(candidate))
+            return candidate;
+        current = path.dirname(current);
+    }
+    return null;
+}
+function readJson(filePath) {
+    try {
+        return JSON.parse(fs.readFileSync(filePath, 'utf-8'));
+    }
+    catch {
+        return null;
+    }
+}
+function isInsideGitRepo(root) {
+    try {
+        execFileSync('git', ['rev-parse', '--is-inside-work-tree'], {
+            cwd: root,
+            stdio: ['ignore', 'pipe', 'ignore'],
+        });
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+export { SOURCE_EXTENSIONS, IGNORE_DIRS };
+//# sourceMappingURL=discovery.js.map

package/dist/discovery.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,7 @@
+export type { DebtKind, AgeBucket, BlameInfo, DebtItem, AuthorDebt, FileDebt, DebtStats, ProjectConfig, SearchEntry, DebtReport, ScanOptions, ScanProgress, } from './types.js';
+export { discoverProject, collectSourceFiles } from './discovery.js';
+export { parseComments } from './comment-parser.js';
+export { blameFileLines } from './blame.js';
+export { ageBucketFromDays, buildAuthors, buildFiles, buildSearchIndex, buildStats, emptyKindCounts, emptyAgeCounts, } from './aggregate.js';
+export { scanProject, getItemDetail, getFileDebt, getAuthorDebt, type ProgressCallback, } from './scanner.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,QAAQ,EACR,SAAS,EACT,SAAS,EACT,QAAQ,EACR,UAAU,EACV,QAAQ,EACR,SAAS,EACT,aAAa,EACb,WAAW,EACX,UAAU,EACV,WAAW,EACX,YAAY,GACb,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,eAAe,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AACrE,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAC5C,OAAO,EACL,iBAAiB,EACjB,YAAY,EACZ,UAAU,EACV,gBAAgB,EAChB,UAAU,EACV,eAAe,EACf,cAAc,GACf,MAAM,gBAAgB,CAAC;AACxB,OAAO,EACL,WAAW,EACX,aAAa,EACb,WAAW,EACX,aAAa,EACb,KAAK,gBAAgB,GACtB,MAAM,cAAc,CAAC"}

package/dist/index.js

@@ -0,0 +1,6 @@
+export { discoverProject, collectSourceFiles } from './discovery.js';
+export { parseComments } from './comment-parser.js';
+export { blameFileLines } from './blame.js';
+export { ageBucketFromDays, buildAuthors, buildFiles, buildSearchIndex, buildStats, emptyKindCounts, emptyAgeCounts, } from './aggregate.js';
+export { scanProject, getItemDetail, getFileDebt, getAuthorDebt, } from './scanner.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAeA,OAAO,EAAE,eAAe,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AACrE,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAC5C,OAAO,EACL,iBAAiB,EACjB,YAAY,EACZ,UAAU,EACV,gBAAgB,EAChB,UAAU,EACV,eAAe,EACf,cAAc,GACf,MAAM,gBAAgB,CAAC;AACxB,OAAO,EACL,WAAW,EACX,aAAa,EACb,WAAW,EACX,aAAa,GAEd,MAAM,cAAc,CAAC"}

package/dist/scanner.d.ts

@@ -0,0 +1,13 @@
+import type { DebtItem, DebtReport, ScanOptions, ScanProgress } from './types.js';
+export type ProgressCallback = (progress: ScanProgress) => void;
+export declare function scanProject(options: ScanOptions, onProgress?: ProgressCallback): Promise<DebtReport>;
+export declare function getItemDetail(report: DebtReport, itemId: string): DebtItem | null;
+export declare function getFileDebt(report: DebtReport, filePath: string): {
+    file: DebtReport['files'][number];
+    items: DebtItem[];
+} | null;
+export declare function getAuthorDebt(report: DebtReport, author: string): {
+    author: DebtReport['authors'][number];
+    items: DebtItem[];
+} | null;
+//# sourceMappingURL=scanner.d.ts.map

package/dist/scanner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scanner.d.ts","sourceRoot":"","sources":["../src/scanner.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EACV,QAAQ,EACR,UAAU,EACV,WAAW,EACX,YAAY,EACb,MAAM,YAAY,CAAC;AAEpB,MAAM,MAAM,gBAAgB,GAAG,CAAC,QAAQ,EAAE,YAAY,KAAK,IAAI,CAAC;AAEhE,wBAAsB,WAAW,CAC/B,OAAO,EAAE,WAAW,EACpB,UAAU,CAAC,EAAE,gBAAgB,GAC5B,OAAO,CAAC,UAAU,CAAC,CA+KrB;AAED,wBAAgB,aAAa,CAC3B,MAAM,EAAE,UAAU,EAClB,MAAM,EAAE,MAAM,GACb,QAAQ,GAAG,IAAI,CAEjB;AAED,wBAAgB,WAAW,CACzB,MAAM,EAAE,UAAU,EAClB,QAAQ,EAAE,MAAM,GACf;IAAE,IAAI,EAAE,UAAU,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,CAAC;IAAC,KAAK,EAAE,QAAQ,EAAE,CAAA;CAAE,GAAG,IAAI,CAYjE;AAED,wBAAgB,aAAa,CAC3B,MAAM,EAAE,UAAU,EAClB,MAAM,EAAE,MAAM,GACb;IAAE,MAAM,EAAE,UAAU,CAAC,SAAS,CAAC,CAAC,MAAM,CAAC,CAAC;IAAC,KAAK,EAAE,QAAQ,EAAE,CAAA;CAAE,GAAG,IAAI,CAQrE"}

package/dist/scanner.js

@@ -0,0 +1,186 @@
+import fs from 'node:fs';
+import fsp from 'node:fs/promises';
+import path from 'node:path';
+import { discoverProject, collectSourceFiles } from './discovery.js';
+import { parseComments } from './comment-parser.js';
+import { blameFileLines } from './blame.js';
+import { ageBucketFromDays, buildAuthors, buildFiles, buildSearchIndex, buildStats, } from './aggregate.js';
+export async function scanProject(options, onProgress) {
+    const started = Date.now();
+    const blameEnabled = options.blame !== false;
+    onProgress?.({ phase: 'discover', message: 'Discovering project...' });
+    const config = discoverProject(options.root);
+    const shouldBlame = blameEnabled && config.isGitRepo;
+    let files;
+    if (options.incremental && options.changedFiles && options.cache) {
+        files = options.changedFiles.filter((f) => fs.existsSync(f));
+        for (const changed of options.changedFiles) {
+            if (!files.includes(changed)) {
+                options.cache.delete(changed);
+            }
+        }
+    }
+    else {
+        files = collectSourceFiles(config.root);
+        options.cache?.clear();
+    }
+    onProgress?.({
+        phase: 'scan',
+        message: `Scanning ${files.length} files...`,
+        current: 0,
+        total: files.length,
+    });
+    const fileItems = new Map();
+    let scanned = 0;
+    for (const filePath of files) {
+        scanned++;
+        if (scanned % 50 === 0 || scanned === files.length) {
+            onProgress?.({
+                phase: 'scan',
+                message: `Scanning files (${scanned}/${files.length})...`,
+                current: scanned,
+                total: files.length,
+            });
+        }
+        try {
+            const content = await fsp.readFile(filePath, 'utf-8');
+            // Skip huge / binary-looking files
+            if (content.length > 1_500_000 || content.includes('\0'))
+                continue;
+            const relativePath = path.relative(config.root, filePath);
+            const matches = parseComments(content, relativePath);
+            if (matches.length === 0) {
+                fileItems.set(filePath, []);
+                continue;
+            }
+            const items = matches.map((m, idx) => ({
+                id: `debt:${relativePath}:${m.line}:${m.kind}:${idx}`,
+                kind: m.kind,
+                message: m.message,
+                raw: m.raw,
+                filePath,
+                relativePath,
+                line: m.line,
+                column: m.column,
+                context: m.context,
+                ageBucket: 'unknown',
+            }));
+            fileItems.set(filePath, items);
+        }
+        catch {
+            // Unreadable file — skip
+        }
+    }
+    // Merge with cache for incremental scans
+    if (options.incremental && options.cache) {
+        for (const [filePath, items] of fileItems) {
+            options.cache.set(filePath, items);
+        }
+    }
+    else if (options.cache) {
+        for (const [filePath, items] of fileItems) {
+            options.cache.set(filePath, items);
+        }
+    }
+    const cacheSource = options.cache ?? fileItems;
+    const allBeforeBlame = [];
+    for (const items of cacheSource.values()) {
+        allBeforeBlame.push(...items);
+    }
+    // Group by file for blame
+    if (shouldBlame) {
+        const byFile = new Map();
+        for (const item of allBeforeBlame) {
+            const list = byFile.get(item.filePath) ?? [];
+            list.push(item);
+            byFile.set(item.filePath, list);
+        }
+        const filePaths = [...byFile.keys()];
+        onProgress?.({
+            phase: 'blame',
+            message: `Running git blame on ${filePaths.length} files...`,
+            current: 0,
+            total: filePaths.length,
+        });
+        let blamed = 0;
+        // Concurrency limit to avoid spawning too many git processes
+        const concurrency = 8;
+        for (let i = 0; i < filePaths.length; i += concurrency) {
+            const batch = filePaths.slice(i, i + concurrency);
+            await Promise.all(batch.map(async (filePath) => {
+                const items = byFile.get(filePath);
+                const lines = items.map((it) => it.line);
+                const blameMap = await blameFileLines(config.root, filePath, lines);
+                for (const item of items) {
+                    const blame = blameMap.get(item.line);
+                    if (blame) {
+                        item.blame = blame;
+                        item.ageBucket = ageBucketFromDays(blame.ageDays);
+                    }
+                }
+            }));
+            blamed += batch.length;
+            onProgress?.({
+                phase: 'blame',
+                message: `Git blame (${blamed}/${filePaths.length})...`,
+                current: blamed,
+                total: filePaths.length,
+            });
+        }
+    }
+    onProgress?.({ phase: 'aggregate', message: 'Building report...' });
+    const items = allBeforeBlame.sort((a, b) => {
+        const ageA = a.blame?.ageDays ?? -1;
+        const ageB = b.blame?.ageDays ?? -1;
+        if (ageA !== ageB)
+            return ageB - ageA;
+        return a.relativePath.localeCompare(b.relativePath) || a.line - b.line;
+    });
+    // Re-sync cache with blamed items
+    if (options.cache) {
+        const regrouped = new Map();
+        for (const item of items) {
+            const list = regrouped.get(item.filePath) ?? [];
+            list.push(item);
+            regrouped.set(item.filePath, list);
+        }
+        for (const [filePath, list] of regrouped) {
+            options.cache.set(filePath, list);
+        }
+    }
+    const scannedFiles = options.incremental && options.cache
+        ? options.cache.size
+        : files.length;
+    const report = {
+        config,
+        items,
+        authors: buildAuthors(items),
+        files: buildFiles(items),
+        searchIndex: buildSearchIndex(items),
+        stats: buildStats(items, scannedFiles, Date.now() - started, shouldBlame),
+        scannedAt: new Date().toISOString(),
+    };
+    onProgress?.({ phase: 'done', message: `Found ${items.length} debt items` });
+    return report;
+}
+export function getItemDetail(report, itemId) {
+    return report.items.find((i) => i.id === itemId) ?? null;
+}
+export function getFileDebt(report, filePath) {
+    const normalized = filePath.replace(/^file:/, '');
+    const file = report.files.find((f) => f.path === normalized ||
+        f.relativePath === normalized ||
+        f.path.endsWith(normalized)) ?? null;
+    if (!file)
+        return null;
+    const items = report.items.filter((i) => file.items.includes(i.id));
+    return { file, items };
+}
+export function getAuthorDebt(report, author) {
+    const entry = report.authors.find((a) => a.author === author || a.authorEmail === author) ?? null;
+    if (!entry)
+        return null;
+    const items = report.items.filter((i) => entry.items.includes(i.id));
+    return { author: entry, items };
+}
+//# sourceMappingURL=scanner.js.map

package/dist/scanner.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,89 @@
+export type DebtKind = 'todo' | 'fixme' | 'deprecated';
+export type AgeBucket = 'fresh' | 'recent' | 'aging' | 'stale' | 'ancient' | 'unknown';
+export interface BlameInfo {
+    author: string;
+    authorEmail: string;
+    committedAt: string;
+    ageDays: number;
+    commitHash: string;
+    summary?: string;
+}
+export interface DebtItem {
+    id: string;
+    kind: DebtKind;
+    message: string;
+    raw: string;
+    filePath: string;
+    relativePath: string;
+    line: number;
+    column: number;
+    context?: string;
+    blame?: BlameInfo;
+    ageBucket: AgeBucket;
+}
+export interface AuthorDebt {
+    author: string;
+    authorEmail: string;
+    total: number;
+    byKind: Record<DebtKind, number>;
+    oldestAgeDays: number | null;
+    averageAgeDays: number | null;
+    items: string[];
+}
+export interface FileDebt {
+    path: string;
+    relativePath: string;
+    total: number;
+    byKind: Record<DebtKind, number>;
+    oldestAgeDays: number | null;
+    items: string[];
+}
+export interface DebtStats {
+    totalItems: number;
+    totalFiles: number;
+    scannedFiles: number;
+    byKind: Record<DebtKind, number>;
+    byAge: Record<AgeBucket, number>;
+    authors: number;
+    oldestAgeDays: number | null;
+    averageAgeDays: number | null;
+    scanDurationMs: number;
+    blameEnabled: boolean;
+    blameCoverage: number;
+}
+export interface ProjectConfig {
+    root: string;
+    name: string;
+    isGitRepo: boolean;
+}
+export interface SearchEntry {
+    id: string;
+    label: string;
+    kind: DebtKind;
+    path: string;
+    keywords: string[];
+}
+export interface DebtReport {
+    config: ProjectConfig;
+    items: DebtItem[];
+    authors: AuthorDebt[];
+    files: FileDebt[];
+    searchIndex: SearchEntry[];
+    stats: DebtStats;
+    scannedAt: string;
+}
+export interface ScanOptions {
+    root: string;
+    blame?: boolean;
+    incremental?: boolean;
+    changedFiles?: string[];
+    /** Cache of previous items keyed by absolute file path */
+    cache?: Map<string, DebtItem[]>;
+}
+export interface ScanProgress {
+    phase: 'discover' | 'scan' | 'blame' | 'aggregate' | 'done';
+    message: string;
+    current?: number;
+    total?: number;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/dist/types.js

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

package/dist/types.js.map

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

package/package.json

@@ -0,0 +1,28 @@
+{
+  "name": "@tech-debt/core",
+  "version": "0.1.0",
+  "description": "Comment scanner and technical debt aggregation engine",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": ["dist", "README.md"],
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "dev": "tsc -p tsconfig.json --watch",
+    "prepublishOnly": "npm run build"
+  },
+  "devDependencies": {
+    "@types/node": "^22.10.2",
+    "typescript": "^5.7.2"
+  },
+  "license": "MIT",
+  "engines": {
+    "node": ">=18"
+  }
+}