@loose-ends/core 0.0.0-stage → 1.1.1

package/README.md

@@ -1,3 +1,16 @@
-# Temporary Holding Version
+# @loose-ends/core
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+The Liveness Graph engine behind [Loose Ends](https://github.com/sid732/loose-ends).
+
+```ts
+import { check, scan, analyze, explain, loadConfig, formatReport } from "@loose-ends/core";
+
+const result = check({ root: process.cwd(), base: "origin/main" });
+console.log(formatReport(result, "text"));
+process.exitCode = result.passed ? 0 : 1;
+
+const analysis = analyze(loadConfig(process.cwd()));
+console.log(explain(analysis, "src/lib/format.ts#formatUser"));
+```
+
+See [docs/architecture.md](https://github.com/sid732/loose-ends/blob/main/docs/architecture.md).

package/dist/check.d.ts

@@ -0,0 +1,65 @@
+import type { ChangedFile } from "./git.js";
+import { type Finding } from "./findings.js";
+import { type Analysis, type AnalyzeOptions, type LivenessSummary } from "./liveness.js";
+import type { FindingKind, LooseEndsConfig } from "./types.js";
+export interface CheckOptions {
+    /** Project root (working tree). */
+    root: string;
+    /** Base revision. Defaults to the merge base with origin/HEAD, main, or master. */
+    base?: string;
+    /** Head revision. Defaults to the working tree, including uncommitted changes. */
+    head?: string;
+    config?: Partial<LooseEndsConfig>;
+    /** Extra hooks applied to both analyses. */
+    analyze?: AnalyzeOptions;
+    /** Post-process findings, e.g. to add superseded or dependency findings. */
+    extend?: (ctx: CheckContext) => Finding[];
+}
+export interface CheckContext {
+    config: LooseEndsConfig;
+    base: Analysis;
+    head: Analysis;
+    changed: ChangedFile[];
+    findings: Finding[];
+}
+export interface RevisionInfo {
+    ref: string;
+    commit?: string;
+}
+export interface CheckResult {
+    mode: "check" | "scan";
+    config: LooseEndsConfig;
+    base?: RevisionInfo;
+    head: RevisionInfo;
+    changed: ChangedFile[];
+    findings: Finding[];
+    /** Findings that count toward failure (unsuppressed and in `failOn`). */
+    failing: Finding[];
+    summary: {
+        before?: LivenessSummary;
+        after: LivenessSummary;
+        byKind: Partial<Record<FindingKind, number>>;
+        suppressed: number;
+    };
+    passed: boolean;
+    /** Present when the caller asked to keep analyses for further inspection. */
+    analyses?: {
+        base?: Analysis;
+        head: Analysis;
+    };
+}
+/** Compare a change against its base and report new loose ends. */
+export declare function check(options: CheckOptions & {
+    keepAnalyses?: boolean;
+}): CheckResult;
+export interface ScanOptions {
+    root: string;
+    config?: Partial<LooseEndsConfig>;
+    analyze?: AnalyzeOptions;
+    extend?: (analysis: Analysis, findings: Finding[]) => Finding[];
+}
+/** Whole-project report of unreachable code, independent of any change. */
+export declare function scan(options: ScanOptions & {
+    keepAnalyses?: boolean;
+}): CheckResult;
+//# sourceMappingURL=check.d.ts.map

package/dist/check.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"check.d.ts","sourceRoot":"","sources":["../src/check.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAY,MAAM,UAAU,CAAC;AAKtD,OAAO,EAA+D,KAAK,OAAO,EAAE,MAAM,eAAe,CAAC;AAE1G,OAAO,EAAsB,KAAK,QAAQ,EAAE,KAAK,cAAc,EAAE,KAAK,eAAe,EAAE,MAAM,eAAe,CAAC;AAC7G,OAAO,KAAK,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAE/D,MAAM,WAAW,YAAY;IAC3B,mCAAmC;IACnC,IAAI,EAAE,MAAM,CAAC;IACb,mFAAmF;IACnF,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,kFAAkF;IAClF,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,OAAO,CAAC,eAAe,CAAC,CAAC;IAClC,4CAA4C;IAC5C,OAAO,CAAC,EAAE,cAAc,CAAC;IACzB,4EAA4E;IAC5E,MAAM,CAAC,EAAE,CAAC,GAAG,EAAE,YAAY,KAAK,OAAO,EAAE,CAAC;CAC3C;AAED,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,eAAe,CAAC;IACxB,IAAI,EAAE,QAAQ,CAAC;IACf,IAAI,EAAE,QAAQ,CAAC;IACf,OAAO,EAAE,WAAW,EAAE,CAAC;IACvB,QAAQ,EAAE,OAAO,EAAE,CAAC;CACrB;AAED,MAAM,WAAW,YAAY;IAC3B,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,OAAO,GAAG,MAAM,CAAC;IACvB,MAAM,EAAE,eAAe,CAAC;IACxB,IAAI,CAAC,EAAE,YAAY,CAAC;IACpB,IAAI,EAAE,YAAY,CAAC;IACnB,OAAO,EAAE,WAAW,EAAE,CAAC;IACvB,QAAQ,EAAE,OAAO,EAAE,CAAC;IACpB,yEAAyE;IACzE,OAAO,EAAE,OAAO,EAAE,CAAC;IACnB,OAAO,EAAE;QACP,MAAM,CAAC,EAAE,eAAe,CAAC;QACzB,KAAK,EAAE,eAAe,CAAC;QACvB,MAAM,EAAE,OAAO,CAAC,MAAM,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC,CAAC;QAC7C,UAAU,EAAE,MAAM,CAAC;KACpB,CAAC;IACF,MAAM,EAAE,OAAO,CAAC;IAChB,6EAA6E;IAC7E,QAAQ,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,QAAQ,CAAC;QAAC,IAAI,EAAE,QAAQ,CAAA;KAAE,CAAC;CAChD;AAED,mEAAmE;AACnE,wBAAgB,KAAK,CAAC,OAAO,EAAE,YAAY,GAAG;IAAE,YAAY,CAAC,EAAE,OAAO,CAAA;CAAE,GAAG,WAAW,CA6CrF;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,OAAO,CAAC,eAAe,CAAC,CAAC;IAClC,OAAO,CAAC,EAAE,cAAc,CAAC;IACzB,MAAM,CAAC,EAAE,CAAC,QAAQ,EAAE,QAAQ,EAAE,QAAQ,EAAE,OAAO,EAAE,KAAK,OAAO,EAAE,CAAC;CACjE;AAED,2EAA2E;AAC3E,wBAAgB,IAAI,CAAC,OAAO,EAAE,WAAW,GAAG;IAAE,YAAY,CAAC,EAAE,OAAO,CAAA;CAAE,GAAG,WAAW,CAiBnF"}

package/dist/check.js

@@ -0,0 +1,102 @@
+import { changedFiles, defaultBase, isGitRepo, mergeBase, revParse, snapshot } from "./git.js";
+import { loadConfig } from "./config.js";
+import { annotateCoverage, loadCoverage } from "./coverage.js";
+import { dependencyFindings, scanDependencyFindings } from "./dependencies.js";
+import { applySuppressions, compareAnalyses, renameMap, scanFindings } from "./findings.js";
+import { detectSuperseded } from "./superseded.js";
+import { analyze, summarize } from "./liveness.js";
+/** Compare a change against its base and report new loose ends. */
+export function check(options) {
+    const config = loadConfig(options.root, options.config);
+    if (!isGitRepo(config.root))
+        throw new Error(`${config.root} is not inside a git repository; use scan for a whole-project report`);
+    const baseRef = options.base ?? defaultBase(config.root);
+    if (!baseRef)
+        throw new Error("could not find a base branch (tried origin/HEAD, main, master); pass --base");
+    const headRef = options.head;
+    const headCommit = headRef ? revParse(config.root, headRef) : revParse(config.root, "HEAD");
+    if (headRef && !headCommit)
+        throw new Error(`unknown head revision "${headRef}"`);
+    const baseCommit = mergeBase(config.root, baseRef, headCommit ?? "HEAD");
+    const snapshots = [];
+    try {
+        const baseSnap = snapshot(config.root, baseCommit);
+        snapshots.push(baseSnap);
+        let headRoot = config.root;
+        if (headRef) {
+            const headSnap = snapshot(config.root, headRef);
+            snapshots.push(headSnap);
+            headRoot = headSnap.root;
+        }
+        const base = analyze({ ...config, root: baseSnap.root }, options.analyze);
+        const head = analyze({ ...config, root: headRoot }, options.analyze);
+        const changed = changedFiles(config.root, baseCommit, headRef);
+        let findings = compareAnalyses(base, head, { changed });
+        findings = detectSuperseded(base, head, changed, findings, renameMap(changed));
+        findings = [...findings, ...dependencyFindings(base, head)];
+        if (options.extend)
+            findings = [...findings, ...options.extend({ config, base, head, changed, findings })];
+        const { invalid } = applySuppressions(head, findings);
+        findings = [...findings, ...invalid];
+        if (config.coverage)
+            annotateCoverage(findings, loadCoverage(config.root, config.coverage), config.coverage);
+        return finish({
+            mode: "check",
+            config,
+            base: { ref: baseRef, commit: baseCommit },
+            head: { ref: headRef ?? "working tree", commit: headCommit },
+            changed,
+            findings,
+            before: summarize(base),
+            after: summarize(head),
+            analyses: options.keepAnalyses ? { base, head } : undefined,
+        });
+    }
+    finally {
+        for (const snap of snapshots)
+            snap.dispose();
+    }
+}
+/** Whole-project report of unreachable code, independent of any change. */
+export function scan(options) {
+    const config = loadConfig(options.root, options.config);
+    const head = analyze(config, options.analyze);
+    let findings = [...scanFindings(head), ...scanDependencyFindings(head)];
+    if (options.extend)
+        findings = [...findings, ...options.extend(head, findings)];
+    const { invalid } = applySuppressions(head, findings);
+    findings = [...findings, ...invalid];
+    if (config.coverage)
+        annotateCoverage(findings, loadCoverage(config.root, config.coverage), config.coverage);
+    return finish({
+        mode: "scan",
+        config,
+        head: { ref: "working tree", commit: isGitRepo(config.root) ? revParse(config.root, "HEAD") : undefined },
+        changed: [],
+        findings,
+        after: summarize(head),
+        analyses: options.keepAnalyses ? { head } : undefined,
+    });
+}
+function finish(input) {
+    const order = { error: 0, warning: 1, info: 2 };
+    const findings = input.findings.sort((a, b) => order[a.severity] - order[b.severity] || (a.file ?? "").localeCompare(b.file ?? "") || (a.line ?? 0) - (b.line ?? 0) || a.kind.localeCompare(b.kind));
+    const failing = findings.filter((f) => !f.suppressed && input.config.failOn.includes(f.kind));
+    const byKind = {};
+    for (const f of findings)
+        if (!f.suppressed)
+            byKind[f.kind] = (byKind[f.kind] ?? 0) + 1;
+    return {
+        mode: input.mode,
+        config: input.config,
+        base: input.base,
+        head: input.head,
+        changed: input.changed,
+        findings,
+        failing,
+        summary: { before: input.before, after: input.after, byKind, suppressed: findings.filter((f) => f.suppressed).length },
+        passed: failing.length === 0,
+        analyses: input.analyses,
+    };
+}
+//# sourceMappingURL=check.js.map

package/dist/check.js.map

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

package/dist/cleanup.d.ts

@@ -0,0 +1,57 @@
+import type { Finding } from "./findings.js";
+import type { Analysis } from "./liveness.js";
+export type CleanupAction = {
+    type: "delete-file";
+    path: string;
+    finding: string;
+} | {
+    type: "remove-declaration";
+    path: string;
+    symbol: string;
+    start: number;
+    end: number;
+    line: number;
+    finding: string;
+};
+export interface CleanupPlan {
+    actions: CleanupAction[];
+    skipped: Array<{
+        target: string;
+        reason: string;
+    }>;
+}
+/**
+ * Turn findings into deletions. Only unsuppressed, deterministic findings are
+ * used. Anything that would leave a dangling import or a partial statement is
+ * skipped with a reason, not guessed at.
+ */
+export declare function planCleanup(analysis: Analysis, findings: Finding[]): CleanupPlan;
+/** Apply a plan to a directory. Returns the files that were touched. */
+export declare function applyCleanup(root: string, plan: CleanupPlan): string[];
+export interface CheckRun {
+    command: string;
+    exitCode: number;
+    durationMs: number;
+    /** Last lines of combined output. */
+    output: string;
+}
+export interface Verification {
+    passed: boolean;
+    checks: CheckRun[];
+    /** Unified diff of the cleanup, relative to the project root. */
+    patch: string;
+    touched: string[];
+}
+/**
+ * Apply the plan to a scratch copy of the project, run the configured checks
+ * there, and return a patch. The working tree is never modified.
+ */
+export declare function verifyCleanup(root: string, plan: CleanupPlan, checks: string[], options?: {
+    timeoutMs?: number;
+}): Verification;
+/** Produce the cleanup patch without running checks. */
+export declare function cleanupPatch(root: string, plan: CleanupPlan): {
+    patch: string;
+    touched: string[];
+};
+//# sourceMappingURL=cleanup.d.ts.map

package/dist/cleanup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cleanup.d.ts","sourceRoot":"","sources":["../src/cleanup.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAE7C,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAE9C,MAAM,MAAM,aAAa,GACrB;IAAE,IAAI,EAAE,aAAa,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GACtD;IAAE,IAAI,EAAE,oBAAoB,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC;AAE5H,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,aAAa,EAAE,CAAC;IACzB,OAAO,EAAE,KAAK,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACpD;AAID;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,QAAQ,EAAE,QAAQ,EAAE,QAAQ,EAAE,OAAO,EAAE,GAAG,WAAW,CA6ChF;AAoBD,wEAAwE;AACxE,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,WAAW,GAAG,MAAM,EAAE,CAiCtE;AAkCD,MAAM,WAAW,QAAQ;IACvB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,qCAAqC;IACrC,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,OAAO,CAAC;IAChB,MAAM,EAAE,QAAQ,EAAE,CAAC;IACnB,iEAAiE;IACjE,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB;AAID;;;GAGG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,EAAE,EAAE,OAAO,GAAE;IAAE,SAAS,CAAC,EAAE,MAAM,CAAA;CAAO,GAAG,YAAY,CAoBnI;AAED,wDAAwD;AACxD,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,WAAW,GAAG;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,EAAE,CAAA;CAAE,CAGlG"}

package/dist/cleanup.js

@@ -0,0 +1,226 @@
+import { spawnSync } from "node:child_process";
+import { cpSync, existsSync, mkdtempSync, readdirSync, readFileSync, rmSync, symlinkSync, unlinkSync, writeFileSync } from "node:fs";
+import { tmpdir } from "node:os";
+import { basename, dirname, join } from "node:path";
+import { fileId, symbolId } from "./graph.js";
+const REMOVABLE = new Set(["orphaned-addition", "newly-orphaned", "superseded", "orphaned"]);
+/**
+ * Turn findings into deletions. Only unsuppressed, deterministic findings are
+ * used. Anything that would leave a dangling import or a partial statement is
+ * skipped with a reason, not guessed at.
+ */
+export function planCleanup(analysis, findings) {
+    const plan = { actions: [], skipped: [] };
+    const candidates = findings.filter((f) => REMOVABLE.has(f.kind) && !f.suppressed && f.file);
+    const deletedFiles = new Set(candidates.filter((f) => !f.symbol).map((f) => f.file));
+    for (const f of candidates) {
+        const file = f.file;
+        if (!analysis.graph.modules.has(file)) {
+            plan.skipped.push({ target: f.target, reason: "file is not part of the analyzed tree" });
+            continue;
+        }
+        if (!f.symbol) {
+            const importers = importersOf(analysis, file, undefined).filter((p) => !deletedFiles.has(p));
+            if (importers.length) {
+                plan.skipped.push({ target: f.target, reason: `still imported (without being used) by ${importers.join(", ")}` });
+                deletedFiles.delete(file);
+                continue;
+            }
+            plan.actions.push({ type: "delete-file", path: file, finding: f.id });
+            continue;
+        }
+        if (deletedFiles.has(file))
+            continue;
+        const node = analysis.graph.nodes.get(symbolId(file, f.symbol));
+        const decl = node?.declaration;
+        if (!decl) {
+            plan.skipped.push({ target: f.target, reason: "re-export alias; edit the export list by hand" });
+            continue;
+        }
+        if (decl.statementSize > 1) {
+            plan.skipped.push({ target: f.target, reason: "declared together with other names in one statement" });
+            continue;
+        }
+        const info = analysis.graph.modules.get(file);
+        if (info.localExports.some((e) => e.local === decl.name)) {
+            plan.skipped.push({ target: f.target, reason: "also listed in an `export { }` clause" });
+            continue;
+        }
+        const importers = decl.exportedAs.flatMap((name) => importersOf(analysis, file, name)).filter((p) => !deletedFiles.has(p));
+        if (importers.length) {
+            plan.skipped.push({ target: f.target, reason: `still imported (without being used) by ${[...new Set(importers)].join(", ")}` });
+            continue;
+        }
+        plan.actions.push({ type: "remove-declaration", path: file, symbol: decl.name, start: decl.start, end: decl.end, line: decl.line, finding: f.id });
+    }
+    return plan;
+}
+/** Files with an import of `file` (or of `name` from it). */
+function importersOf(analysis, file, name) {
+    const out = new Set();
+    for (const edge of analysis.graph.in(fileId(file))) {
+        if (edge.kind === "contains")
+            continue;
+        const from = analysis.graph.nodes.get(edge.from)?.file;
+        if (!from || from === file)
+            continue;
+        if (name === undefined) {
+            out.add(from);
+            continue;
+        }
+        const info = analysis.graph.modules.get(from);
+        const imports = info?.imports.some((r) => r.bindings.some((b) => b.imported === name)) ?? false;
+        if (imports)
+            out.add(from);
+    }
+    return [...out].sort();
+}
+/** Apply a plan to a directory. Returns the files that were touched. */
+export function applyCleanup(root, plan) {
+    const touched = new Set();
+    const removals = new Map();
+    for (const action of plan.actions) {
+        if (action.type === "delete-file") {
+            const abs = join(root, action.path);
+            if (existsSync(abs))
+                unlinkSync(abs);
+            touched.add(action.path);
+        }
+        else {
+            const list = removals.get(action.path) ?? [];
+            list.push({ start: action.start, end: action.end });
+            removals.set(action.path, list);
+        }
+    }
+    for (const [path, ranges] of removals) {
+        const abs = join(root, path);
+        if (!existsSync(abs))
+            continue;
+        let text = readFileSync(abs, "utf8");
+        for (const { start, end } of ranges.sort((a, b) => b.start - a.start)) {
+            const lineStart = removeLeadingComments(text, start, path.endsWith(".py"));
+            let stop = end;
+            while (stop < text.length && (text[stop] === " " || text[stop] === "\t"))
+                stop++;
+            if (text[stop] === "\r")
+                stop++;
+            if (text[stop] === "\n")
+                stop++;
+            if (text[stop] === "\n" && (lineStart === 0 || text[lineStart - 1] === "\n") && (lineStart < 2 || text[lineStart - 2] === "\n"))
+                stop++;
+            text = text.slice(0, lineStart) + text.slice(stop);
+        }
+        // Removing a declaration can leave stacked or trailing blank lines behind. Python style keeps two between definitions.
+        text = text.replace(path.endsWith(".py") ? /\n{4,}/g : /\n{3,}/g, path.endsWith(".py") ? "\n\n\n" : "\n\n").replace(/\s+$/, "") + "\n";
+        writeFileSync(abs, text);
+        touched.add(path);
+    }
+    return [...touched].sort();
+}
+/** Extend a removal back over JSDoc/line comments (or Python `#` comments) attached to the declaration. */
+function removeLeadingComments(text, start, python = false) {
+    let pos = start;
+    for (;;) {
+        let lineStart = text.lastIndexOf("\n", pos - 1) + 1;
+        if (text.slice(lineStart, pos).trim() !== "")
+            return pos;
+        if (lineStart === 0)
+            return 0;
+        const prevEnd = lineStart - 1;
+        const prevStart = text.lastIndexOf("\n", prevEnd - 1) + 1;
+        const prev = text.slice(prevStart, prevEnd).trim();
+        if (python) {
+            if (prev.startsWith("#") && !prev.startsWith("#!")) {
+                pos = prevStart;
+                continue;
+            }
+            return lineStart;
+        }
+        if (prev.startsWith("//") || prev.endsWith("*/") || prev.startsWith("*")) {
+            if (prev.endsWith("*/") && !prev.startsWith("/*")) {
+                const open = text.lastIndexOf("/*", prevEnd);
+                if (open === -1)
+                    return lineStart;
+                lineStart = text.lastIndexOf("\n", open - 1) + 1;
+                pos = lineStart;
+                continue;
+            }
+            pos = prevStart;
+            continue;
+        }
+        return lineStart;
+    }
+}
+const SKIP_COPY = new Set(["node_modules", ".git", ".next", ".turbo", "coverage", ".cache"]);
+/**
+ * Apply the plan to a scratch copy of the project, run the configured checks
+ * there, and return a patch. The working tree is never modified.
+ */
+export function verifyCleanup(root, plan, checks, options = {}) {
+    const sandbox = mkdtempSync(join(tmpdir(), "loose-ends-verify-"));
+    const copy = join(sandbox, basename(root));
+    try {
+        cpSync(root, copy, { recursive: true, filter: (src) => !SKIP_COPY.has(basename(src)) || src === root });
+        linkNodeModules(root, copy);
+        const touched = applyCleanup(copy, plan);
+        const patch = diff(root, copy, touched);
+        const runs = [];
+        for (const command of checks) {
+            const started = Date.now();
+            const result = spawnSync(command, { cwd: copy, shell: true, encoding: "utf8", timeout: options.timeoutMs ?? 10 * 60_000, env: { ...process.env, CI: "1" } });
+            const output = `${result.stdout ?? ""}${result.stderr ?? ""}`.trimEnd().split("\n").slice(-40).join("\n");
+            runs.push({ command, exitCode: result.status ?? 1, durationMs: Date.now() - started, output });
+            if (result.status !== 0)
+                break;
+        }
+        return { passed: runs.every((r) => r.exitCode === 0), checks: runs, patch, touched };
+    }
+    finally {
+        rmSync(sandbox, { recursive: true, force: true });
+    }
+}
+/** Produce the cleanup patch without running checks. */
+export function cleanupPatch(root, plan) {
+    const result = verifyCleanup(root, plan, []);
+    return { patch: result.patch, touched: result.touched };
+}
+/** Symlink every node_modules directory (root and workspace packages) into the copy. */
+function linkNodeModules(root, copy, rel = "", depth = 0) {
+    const dir = join(root, rel);
+    if (depth > 4 || !existsSync(dir))
+        return;
+    for (const entry of readdirSync(dir, { withFileTypes: true })) {
+        if (!entry.isDirectory())
+            continue;
+        const child = rel ? `${rel}/${entry.name}` : entry.name;
+        if (entry.name === "node_modules") {
+            if (existsSync(join(copy, dirname(child))))
+                symlinkSync(join(root, child), join(copy, child), "dir");
+            continue;
+        }
+        if (SKIP_COPY.has(entry.name) || entry.name.startsWith("."))
+            continue;
+        linkNodeModules(root, copy, child, depth + 1);
+    }
+}
+function diff(root, copy, touched) {
+    const parts = [];
+    for (const path of touched) {
+        const before = join(root, path);
+        const after = join(copy, path);
+        const result = spawnSync("git", ["diff", "--no-index", "--no-color", "--", before, existsSync(after) ? after : "/dev/null"], { encoding: "utf8" });
+        const text = (result.stdout ?? "")
+            .split(before)
+            .join(`/${path}`)
+            .split(after)
+            .join(`/${path}`)
+            .replace(/^diff --git a\/+(\S+) b\/+\S+$/m, `diff --git a/${path} b/${path}`)
+            .replace(/^--- a\/+.*$/m, `--- a/${path}`)
+            .replace(/^\+\+\+ b\/+.*$/m, `+++ b/${path}`)
+            .replace(/^diff --git a\/(.+) b\/dev\/null$/m, `diff --git a/${path} b/${path}`);
+        if (text)
+            parts.push(text.endsWith("\n") ? text : text + "\n");
+    }
+    return parts.join("");
+}
+//# sourceMappingURL=cleanup.js.map

package/dist/cleanup.js.map

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

package/dist/config.d.ts

@@ -0,0 +1,30 @@
+import type { FindingKind, Language, LooseEndsConfig } from "./types.js";
+export declare const CONFIG_FILES: readonly ["loose-ends.config.json", ".loose-endsrc.json"];
+export declare const SOURCE_EXTENSIONS: readonly [".ts", ".tsx", ".mts", ".cts", ".js", ".jsx", ".mjs", ".cjs"];
+export declare const DEFAULT_INCLUDE: string[];
+export declare const LANGUAGES: readonly ["javascript", "python", "java"];
+/** File extensions of each language. */
+export declare const LANGUAGE_EXTENSIONS: Record<Language, RegExp>;
+export declare const DEFAULT_EXCLUDE: string[];
+export declare const DEFAULT_TEST_PATTERNS: string[];
+export declare const DEFAULT_FAIL_ON: FindingKind[];
+export declare const FINDING_KINDS: readonly FindingKind[];
+export declare class ConfigError extends Error {
+    readonly source?: string | undefined;
+    constructor(message: string, source?: string | undefined);
+}
+export declare function defaultConfig(root: string): LooseEndsConfig;
+/**
+ * Load configuration for a project root. Looks for `loose-ends.config.json`,
+ * `.loose-endsrc.json`, then a `looseEnds` key in package.json.
+ */
+export declare function loadConfig(root: string, overrides?: Partial<LooseEndsConfig>): LooseEndsConfig;
+type RawConfig = Partial<Omit<LooseEndsConfig, "root" | "source">> & {
+    extendInclude?: string[];
+    extendExclude?: string[];
+    extendTestPatterns?: string[];
+};
+/** Validate an untyped config object. Throws ConfigError with a precise message. */
+export declare function parseConfig(raw: unknown, source?: string): RawConfig;
+export {};
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAe,WAAW,EAAiB,QAAQ,EAAE,eAAe,EAAe,MAAM,YAAY,CAAC;AAElH,eAAO,MAAM,YAAY,2DAA4D,CAAC;AAEtF,eAAO,MAAM,iBAAiB,yEAA0E,CAAC;AAEzG,eAAO,MAAM,eAAe,UAAiF,CAAC;AAE9G,eAAO,MAAM,SAAS,2CAA4C,CAAC;AAEnE,wCAAwC;AACxC,eAAO,MAAM,mBAAmB,EAAE,MAAM,CAAC,QAAQ,EAAE,MAAM,CAIxD,CAAC;AAEF,eAAO,MAAM,eAAe,UAkC3B,CAAC;AAEF,eAAO,MAAM,qBAAqB,UAsBjC,CAAC;AAEF,eAAO,MAAM,eAAe,EAAE,WAAW,EAKxC,CAAC;AAEF,eAAO,MAAM,aAAa,EAAE,SAAS,WAAW,EAY/C,CAAC;AAIF,qBAAa,WAAY,SAAQ,KAAK;IACP,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM;gBAAzC,OAAO,EAAE,MAAM,EAAW,MAAM,CAAC,EAAE,MAAM,YAAA;CAItD;AAED,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,eAAe,CAgB3D;AAED;;;GAGG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,GAAE,OAAO,CAAC,eAAe,CAAM,GAAG,eAAe,CAMlG;AAyBD,KAAK,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC,eAAe,EAAE,MAAM,GAAG,QAAQ,CAAC,CAAC,GAAG;IACnE,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;IACzB,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;IACzB,kBAAkB,CAAC,EAAE,MAAM,EAAE,CAAC;CAC/B,CAAC;AAEF,oFAAoF;AACpF,wBAAgB,WAAW,CAAC,GAAG,EAAE,OAAO,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAoFpE"}