loose-ends 0.0.0-stage → 1.1.0

package/README.md

@@ -1,3 +1,14 @@
-# Temporary Holding Version
+# loose-ends
 
-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.
+Command-line interface for [Loose Ends](https://github.com/sid732/loose-ends), the graph-powered liveness checks for AI-written code.
+
+```bash
+npx loose-ends check     # report new loose ends in this change
+npx loose-ends scan      # report existing unreachable code
+npx loose-ends explain <path#symbol>
+npx loose-ends roots
+npx loose-ends fix --verify --patch cleanup.diff
+npx loose-ends init
+```
+
+See the [main README](https://github.com/sid732/loose-ends#readme) for details.

package/dist/bin.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=bin.d.ts.map

package/dist/bin.d.ts.map

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

package/dist/bin.js

@@ -0,0 +1,6 @@
+#!/usr/bin/env node
+import { run } from "./index.js";
+run(process.argv.slice(2)).then((code) => {
+    process.exitCode = code;
+});
+//# sourceMappingURL=bin.js.map

package/dist/bin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bin.js","sourceRoot":"","sources":["../src/bin.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,GAAG,EAAE,MAAM,YAAY,CAAC;AAEjC,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE;IACvC,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC;AAC1B,CAAC,CAAC,CAAC"}

package/dist/commands/check.d.ts

@@ -0,0 +1,21 @@
+import { type FindingKind, type LooseEndsConfig, type ReportFormat } from "@loose-ends/core";
+import type { Command } from "commander";
+import { type CliIO } from "../io.js";
+export interface ReportFlags {
+    format: string;
+    output?: string;
+    color?: boolean;
+    linkBase?: string;
+    pathPrefix?: string;
+    failOn?: string;
+}
+export declare class UsageError extends Error {
+}
+export declare function parseFormat(value: string): ReportFormat;
+export declare function parseKinds(value: string | undefined): FindingKind[] | undefined;
+export declare function overrides(flags: ReportFlags & {
+    coverage?: string;
+}): Partial<LooseEndsConfig>;
+export declare function addReportOptions(cmd: Command): Command;
+export declare function registerCheck(program: Command, io: CliIO, setExit: (code: number) => void): void;
+//# sourceMappingURL=check.d.ts.map

package/dist/commands/check.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"check.d.ts","sourceRoot":"","sources":["../../src/commands/check.ts"],"names":[],"mappings":"AACA,OAAO,EAA4D,KAAK,WAAW,EAAE,KAAK,eAAe,EAAE,KAAK,YAAY,EAAE,MAAM,kBAAkB,CAAC;AACvJ,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,EAAQ,KAAK,KAAK,EAAE,MAAM,UAAU,CAAC;AAE5C,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,qBAAa,UAAW,SAAQ,KAAK;CAAG;AAExC,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,YAAY,CAKvD;AAED,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,WAAW,EAAE,GAAG,SAAS,CAQ/E;AAED,wBAAgB,SAAS,CAAC,KAAK,EAAE,WAAW,GAAG;IAAE,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,OAAO,CAAC,eAAe,CAAC,CAM9F;AAED,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAStD;AAED,wBAAgB,aAAa,CAAC,OAAO,EAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,GAAG,IAAI,CAmChG"}

package/dist/commands/check.js

@@ -0,0 +1,75 @@
+import { resolve } from "node:path";
+import { FINDING_KINDS, REPORT_FORMATS, check, formatReport, scan } from "@loose-ends/core";
+import { emit } from "../io.js";
+export class UsageError extends Error {
+}
+export function parseFormat(value) {
+    if (!REPORT_FORMATS.includes(value)) {
+        throw new UsageError(`unknown format "${value}" (expected ${REPORT_FORMATS.join(", ")})`);
+    }
+    return value;
+}
+export function parseKinds(value) {
+    if (value === undefined)
+        return undefined;
+    const kinds = value
+        .split(",")
+        .map((k) => k.trim())
+        .filter(Boolean);
+    for (const k of kinds)
+        if (!FINDING_KINDS.includes(k))
+            throw new UsageError(`unknown finding kind "${k}"`);
+    return kinds;
+}
+export function overrides(flags) {
+    const out = {};
+    const failOn = parseKinds(flags.failOn);
+    if (failOn)
+        out.failOn = failOn;
+    if (flags.coverage)
+        out.coverage = flags.coverage;
+    return out;
+}
+export function addReportOptions(cmd) {
+    return cmd
+        .option("-f, --format <format>", `output format: ${REPORT_FORMATS.join(", ")}`, "text")
+        .option("-o, --output <file>", "write the report to a file instead of stdout")
+        .option("--color", "force colored text output")
+        .option("--no-color", "disable colored text output")
+        .option("--link-base <url>", "prefix for file links in markdown output")
+        .option("--path-prefix <path>", "prefix for file paths in SARIF output (project path inside the repo)")
+        .option("--fail-on <kinds>", "comma-separated finding kinds that fail the run");
+}
+export function registerCheck(program, io, setExit) {
+    addReportOptions(program
+        .command("check")
+        .description("compare a change against its base and report new loose ends")
+        .argument("[dir]", "project root", ".")
+        .option("-b, --base <ref>", "base revision (default: merge base with origin/HEAD, main, or master)")
+        .option("--head <ref>", "head revision (default: the working tree, including uncommitted changes)")
+        .option("--coverage <file>", "coverage report (istanbul JSON or lcov) used as supporting evidence")
+        .option("--no-fail", "always exit 0, even when blocking findings exist")).action((dir, flags) => {
+        const format = parseFormat(flags.format);
+        const result = check({ root: resolve(io.cwd, dir), base: flags.base, head: flags.head, config: overrides(flags) });
+        emit(io, formatReport(result, format, { color: flags.color ?? io.color, linkBase: flags.linkBase, pathPrefix: flags.pathPrefix }), flags.output);
+        if (flags.output) {
+            io.stderr(`${result.passed ? "pass" : "fail"}: ${result.failing.length} blocking of ${result.findings.length} findings → ${flags.output}\n`);
+        }
+        setExit(result.passed || !flags.fail ? 0 : 1);
+    });
+    addReportOptions(program
+        .command("scan")
+        .description("report every unreachable file, symbol, and dependency in the project")
+        .argument("[dir]", "project root", ".")
+        .option("--coverage <file>", "coverage report (istanbul JSON or lcov) used as supporting evidence")
+        .option("--fail", "exit 1 when findings in failOn exist (scan never fails by default)")).action((dir, flags) => {
+        const format = parseFormat(flags.format);
+        const config = overrides(flags);
+        if (flags.fail && !config.failOn)
+            config.failOn = ["orphaned", "invalid-suppression"];
+        const result = scan({ root: resolve(io.cwd, dir), config });
+        emit(io, formatReport(result, format, { color: flags.color ?? io.color, linkBase: flags.linkBase, pathPrefix: flags.pathPrefix }), flags.output);
+        setExit(flags.fail && !result.passed ? 1 : 0);
+    });
+}
+//# sourceMappingURL=check.js.map

package/dist/commands/check.js.map

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

package/dist/commands/fix.d.ts

@@ -0,0 +1,4 @@
+import type { Command } from "commander";
+import { type CliIO } from "../io.js";
+export declare function registerFix(program: Command, io: CliIO, setExit: (code: number) => void): void;
+//# sourceMappingURL=fix.d.ts.map

package/dist/commands/fix.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fix.d.ts","sourceRoot":"","sources":["../../src/commands/fix.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,EAAQ,KAAK,KAAK,EAAE,MAAM,UAAU,CAAC;AAW5C,wBAAgB,WAAW,CAAC,OAAO,EAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,GAAG,IAAI,CAgE9F"}

package/dist/commands/fix.js

@@ -0,0 +1,73 @@
+import { resolve } from "node:path";
+import { applyCleanup, check, planCleanup, scan, verifyCleanup } from "@loose-ends/core";
+import { emit } from "../io.js";
+export function registerFix(program, io, setExit) {
+    program
+        .command("fix")
+        .description("plan removal of loose ends, verify it with your checks, and optionally apply it")
+        .argument("[dir]", "project root", ".")
+        .option("-b, --base <ref>", "base revision for change mode")
+        .option("--scan", "plan cleanup for the whole project instead of just this change")
+        .option("--verify", "apply the plan in a scratch copy and run the configured checks")
+        .option("--apply", "write the cleanup to the working tree (runs --verify first when checks exist)")
+        .option("--patch <file>", "write the cleanup as a unified diff")
+        .option("-c, --check <command...>", "check commands to run instead of config `checks`")
+        .action((dir, flags) => {
+        const root = resolve(io.cwd, dir);
+        const result = flags.scan ? scan({ root, keepAnalyses: true }) : check({ root, base: flags.base, keepAnalyses: true });
+        const plan = planCleanup(result.analyses.head, result.findings);
+        const checks = flags.check ?? result.config.checks;
+        if (plan.actions.length === 0) {
+            io.stdout(result.findings.length ? "Nothing can be removed automatically.\n" : "No loose ends to clean up.\n");
+        }
+        else {
+            io.stdout(`Cleanup plan (${plan.actions.length} change${plan.actions.length === 1 ? "" : "s"}):\n`);
+            for (const a of plan.actions) {
+                io.stdout(a.type === "delete-file" ? `  delete  ${a.path}\n` : `  remove  ${a.path}#${a.symbol} (line ${a.line})\n`);
+            }
+        }
+        if (plan.skipped.length) {
+            io.stdout(`\nLeft for manual review (${plan.skipped.length}):\n`);
+            for (const s of plan.skipped)
+                io.stdout(`  ${s.target}: ${s.reason}\n`);
+        }
+        if (plan.actions.length === 0) {
+            setExit(0);
+            return;
+        }
+        const shouldVerify = flags.verify || (flags.apply && checks.length > 0);
+        const verification = verifyCleanup(root, plan, shouldVerify ? checks : []);
+        if (flags.patch) {
+            emit(io, verification.patch, flags.patch);
+            if (flags.patch !== "-")
+                io.stdout(`\nPatch written to ${flags.patch}\n`);
+        }
+        if (shouldVerify) {
+            if (checks.length === 0)
+                io.stdout("\nNo checks configured. Add `checks` to loose-ends.config.json or pass --check.\n");
+            for (const run of verification.checks) {
+                io.stdout(`\n${run.exitCode === 0 ? "✔" : "✖"} ${run.command} (${(run.durationMs / 1000).toFixed(1)}s)\n`);
+                if (run.exitCode !== 0 && run.output)
+                    io.stdout(run.output.replace(/^/gm, "    ") + "\n");
+            }
+            if (!verification.passed) {
+                io.stderr("\nVerification failed. The working tree was not changed.\n");
+                setExit(1);
+                return;
+            }
+            if (checks.length)
+                io.stdout("\nVerification passed.\n");
+        }
+        if (flags.apply) {
+            if (checks.length === 0)
+                io.stderr("warning: applying without verification; no checks are configured\n");
+            const touched = applyCleanup(root, plan);
+            io.stdout(`\nApplied cleanup to ${touched.length} file${touched.length === 1 ? "" : "s"}. Review with \`git diff\`.\n`);
+        }
+        else if (!flags.patch) {
+            io.stdout("\nDry run. Use --patch <file> to save the diff, --verify to run checks, or --apply to write it.\n");
+        }
+        setExit(0);
+    });
+}
+//# sourceMappingURL=fix.js.map

package/dist/commands/fix.js.map

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

package/dist/commands/inspect.d.ts

@@ -0,0 +1,4 @@
+import type { Command } from "commander";
+import { type CliIO } from "../io.js";
+export declare function registerInspect(program: Command, io: CliIO, setExit: (code: number) => void): void;
+//# sourceMappingURL=inspect.d.ts.map

package/dist/commands/inspect.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"inspect.d.ts","sourceRoot":"","sources":["../../src/commands/inspect.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,EAAQ,KAAK,KAAK,EAAE,MAAM,UAAU,CAAC;AAG5C,wBAAgB,eAAe,CAAC,OAAO,EAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,GAAG,IAAI,CAkElG"}

package/dist/commands/inspect.js

@@ -0,0 +1,100 @@
+import { existsSync, writeFileSync } from "node:fs";
+import { join, resolve } from "node:path";
+import { analyze, discoverPackages, detectFrameworks, explain, formatExplanation, label, loadConfig, CONFIG_FILES, } from "@loose-ends/core";
+import { emit } from "../io.js";
+import { UsageError } from "./check.js";
+export function registerInspect(program, io, setExit) {
+    program
+        .command("explain")
+        .description("show why a file, symbol, or dependency is live, test-only, or orphaned")
+        .argument("<target>", "path, path#symbol, or package name")
+        .argument("[dir]", "project root", ".")
+        .option("-f, --format <format>", "text or json", "text")
+        .option("--color", "force colored output")
+        .option("--no-color", "disable colored output")
+        .action((target, dir, flags) => {
+        const analysis = analyze(loadConfig(resolve(io.cwd, dir)));
+        const explanation = explain(analysis, target);
+        if (!explanation) {
+            io.stderr(`loose-ends: "${target}" is not a known file, symbol, or dependency\n`);
+            setExit(2);
+            return;
+        }
+        if (flags.format === "json")
+            emit(io, JSON.stringify(explanation, null, 2) + "\n");
+        else if (flags.format === "text")
+            emit(io, formatExplanation(explanation, { color: flags.color ?? io.color }));
+        else
+            throw new UsageError(`unknown format "${flags.format}" (expected text or json)`);
+        setExit(0);
+    });
+    program
+        .command("roots")
+        .description("list the entry points Loose Ends discovered")
+        .argument("[dir]", "project root", ".")
+        .option("-f, --format <format>", "text or json", "text")
+        .option("-k, --kind <kind>", "only production, tooling, or test roots")
+        .option("--symbols", "include exported symbols that are roots, not just files")
+        .action((dir, flags) => {
+        if (flags.kind && !["production", "tooling", "test"].includes(flags.kind))
+            throw new UsageError(`unknown root kind "${flags.kind}"`);
+        const analysis = analyze(loadConfig(resolve(io.cwd, dir)));
+        const roots = analysis.roots
+            .filter((r) => !flags.kind || r.kind === flags.kind)
+            .filter((r) => flags.symbols || r.node.startsWith("file:"))
+            .map((r) => ({ target: label(analysis.graph.nodes.get(r.node), r.node), kind: r.kind, source: r.source, reason: r.reason }));
+        if (flags.format === "json") {
+            emit(io, JSON.stringify(roots, null, 2) + "\n");
+        }
+        else if (flags.format === "text") {
+            if (roots.length === 0)
+                io.stdout("No roots found. Add `entries` to loose-ends.config.json.\n");
+            const width = Math.min(60, Math.max(0, ...roots.map((r) => r.target.length)));
+            for (const r of roots)
+                io.stdout(`${r.target.padEnd(width)}  ${r.kind.padEnd(10)}  ${r.reason}\n`);
+        }
+        else {
+            throw new UsageError(`unknown format "${flags.format}" (expected text or json)`);
+        }
+        setExit(0);
+    });
+    program
+        .command("init")
+        .description("write a starter loose-ends.config.json")
+        .argument("[dir]", "project root", ".")
+        .option("--force", "overwrite an existing config")
+        .action((dir, flags) => {
+        const root = resolve(io.cwd, dir);
+        const existing = CONFIG_FILES.map((f) => join(root, f)).find((f) => existsSync(f));
+        if (existing && !flags.force)
+            throw new UsageError(`${existing} already exists (use --force to overwrite)`);
+        const { frameworks, ...config } = starterConfig(root);
+        const path = join(root, "loose-ends.config.json");
+        writeFileSync(path, JSON.stringify(config, null, 2) + "\n");
+        io.stdout(`Wrote ${path}\n`);
+        io.stdout(`Detected frameworks: ${frameworks.join(", ") || "none (plain Node.js)"}\n`);
+        io.stdout("Next: run `loose-ends roots` to review entry points, then `loose-ends check` on a branch.\n");
+        setExit(0);
+    });
+}
+function starterConfig(root) {
+    const packages = discoverPackages(root);
+    const frameworks = new Set();
+    for (const pkg of packages)
+        for (const f of detectFrameworks(pkg))
+            if (f !== "node")
+                frameworks.add(f);
+    const scripts = packages.find((p) => p.dir === "")?.manifest.scripts ?? {};
+    const checks = ["typecheck", "build", "test"].filter((s) => s in scripts).map((s) => `npm run ${s}`);
+    const config = loadConfig(root);
+    return {
+        $schema: "https://raw.githubusercontent.com/sid732/loose-ends/main/schema/config.schema.json",
+        entries: [],
+        dormant: [],
+        suppressions: [],
+        checks,
+        failOn: config.failOn,
+        frameworks: [...frameworks].sort(),
+    };
+}
+//# sourceMappingURL=inspect.js.map

package/dist/commands/inspect.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"inspect.js","sourceRoot":"","sources":["../../src/commands/inspect.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AACpD,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EACL,OAAO,EACP,gBAAgB,EAChB,gBAAgB,EAChB,OAAO,EACP,iBAAiB,EACjB,KAAK,EACL,UAAU,EACV,YAAY,GAEb,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EAAE,IAAI,EAAc,MAAM,UAAU,CAAC;AAC5C,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAExC,MAAM,UAAU,eAAe,CAAC,OAAgB,EAAE,EAAS,EAAE,OAA+B;IAC1F,OAAO;SACJ,OAAO,CAAC,SAAS,CAAC;SAClB,WAAW,CAAC,wEAAwE,CAAC;SACrF,QAAQ,CAAC,UAAU,EAAE,oCAAoC,CAAC;SAC1D,QAAQ,CAAC,OAAO,EAAE,cAAc,EAAE,GAAG,CAAC;SACtC,MAAM,CAAC,uBAAuB,EAAE,cAAc,EAAE,MAAM,CAAC;SACvD,MAAM,CAAC,SAAS,EAAE,sBAAsB,CAAC;SACzC,MAAM,CAAC,YAAY,EAAE,wBAAwB,CAAC;SAC9C,MAAM,CAAC,CAAC,MAAc,EAAE,GAAW,EAAE,KAA0C,EAAE,EAAE;QAClF,MAAM,QAAQ,GAAG,OAAO,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC;QAC3D,MAAM,WAAW,GAAG,OAAO,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;QAC9C,IAAI,CAAC,WAAW,EAAE,CAAC;YACjB,EAAE,CAAC,MAAM,CAAC,gBAAgB,MAAM,gDAAgD,CAAC,CAAC;YAClF,OAAO,CAAC,CAAC,CAAC,CAAC;YACX,OAAO;QACT,CAAC;QACD,IAAI,KAAK,CAAC,MAAM,KAAK,MAAM;YAAE,IAAI,CAAC,EAAE,EAAE,IAAI,CAAC,SAAS,CAAC,WAAW,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;aAC9E,IAAI,KAAK,CAAC,MAAM,KAAK,MAAM;YAAE,IAAI,CAAC,EAAE,EAAE,iBAAiB,CAAC,WAAW,EAAE,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,IAAI,EAAE,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;;YAC1G,MAAM,IAAI,UAAU,CAAC,mBAAmB,KAAK,CAAC,MAAM,2BAA2B,CAAC,CAAC;QACtF,OAAO,CAAC,CAAC,CAAC,CAAC;IACb,CAAC,CAAC,CAAC;IAEL,OAAO;SACJ,OAAO,CAAC,OAAO,CAAC;SAChB,WAAW,CAAC,6CAA6C,CAAC;SAC1D,QAAQ,CAAC,OAAO,EAAE,cAAc,EAAE,GAAG,CAAC;SACtC,MAAM,CAAC,uBAAuB,EAAE,cAAc,EAAE,MAAM,CAAC;SACvD,MAAM,CAAC,mBAAmB,EAAE,yCAAyC,CAAC;SACtE,MAAM,CAAC,WAAW,EAAE,yDAAyD,CAAC;SAC9E,MAAM,CAAC,CAAC,GAAW,EAAE,KAA2D,EAAE,EAAE;QACnF,IAAI,KAAK,CAAC,IAAI,IAAI,CAAC,CAAC,YAAY,EAAE,SAAS,EAAE,MAAM,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC;YAAE,MAAM,IAAI,UAAU,CAAC,sBAAsB,KAAK,CAAC,IAAI,GAAG,CAAC,CAAC;QACrI,MAAM,QAAQ,GAAG,OAAO,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC;QAC3D,MAAM,KAAK,GAAG,QAAQ,CAAC,KAAK;aACzB,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,IAAI,IAAI,CAAC,CAAC,IAAI,KAAM,KAAK,CAAC,IAAiB,CAAC;aACjE,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,OAAO,IAAI,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC;aAC1D,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;QAC/H,IAAI,KAAK,CAAC,MAAM,KAAK,MAAM,EAAE,CAAC;YAC5B,IAAI,CAAC,EAAE,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;QAClD,CAAC;aAAM,IAAI,KAAK,CAAC,MAAM,KAAK,MAAM,EAAE,CAAC;YACnC,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;gBAAE,EAAE,CAAC,MAAM,CAAC,4DAA4D,CAAC,CAAC;YAChG,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;YAC9E,KAAK,MAAM,CAAC,IAAI,KAAK;gBAAE,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC,MAAM,IAAI,CAAC,CAAC;QACrG,CAAC;aAAM,CAAC;YACN,MAAM,IAAI,UAAU,CAAC,mBAAmB,KAAK,CAAC,MAAM,2BAA2B,CAAC,CAAC;QACnF,CAAC;QACD,OAAO,CAAC,CAAC,CAAC,CAAC;IACb,CAAC,CAAC,CAAC;IAEL,OAAO;SACJ,OAAO,CAAC,MAAM,CAAC;SACf,WAAW,CAAC,wCAAwC,CAAC;SACrD,QAAQ,CAAC,OAAO,EAAE,cAAc,EAAE,GAAG,CAAC;SACtC,MAAM,CAAC,SAAS,EAAE,8BAA8B,CAAC;SACjD,MAAM,CAAC,CAAC,GAAW,EAAE,KAA0B,EAAE,EAAE;QAClD,MAAM,IAAI,GAAG,OAAO,CAAC,EAAE,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;QAClC,MAAM,QAAQ,GAAG,YAAY,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC;QACnF,IAAI,QAAQ,IAAI,CAAC,KAAK,CAAC,KAAK;YAAE,MAAM,IAAI,UAAU,CAAC,GAAG,QAAQ,4CAA4C,CAAC,CAAC;QAC5G,MAAM,EAAE,UAAU,EAAE,GAAG,MAAM,EAAE,GAAG,aAAa,CAAC,IAAI,CAAC,CAAC;QACtD,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,EAAE,wBAAwB,CAAC,CAAC;QAClD,aAAa,CAAC,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;QAC5D,EAAE,CAAC,MAAM,CAAC,SAAS,IAAI,IAAI,CAAC,CAAC;QAC7B,EAAE,CAAC,MAAM,CAAC,wBAAwB,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,sBAAsB,IAAI,CAAC,CAAC;QACvF,EAAE,CAAC,MAAM,CAAC,6FAA6F,CAAC,CAAC;QACzG,OAAO,CAAC,CAAC,CAAC,CAAC;IACb,CAAC,CAAC,CAAC;AACP,CAAC;AAED,SAAS,aAAa,CAAC,IAAY;IACjC,MAAM,QAAQ,GAAG,gBAAgB,CAAC,IAAI,CAAC,CAAC;IACxC,MAAM,UAAU,GAAG,IAAI,GAAG,EAAU,CAAC;IACrC,KAAK,MAAM,GAAG,IAAI,QAAQ;QAAE,KAAK,MAAM,CAAC,IAAI,gBAAgB,CAAC,GAAG,CAAC;YAAE,IAAI,CAAC,KAAK,MAAM;gBAAE,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;IACvG,MAAM,OAAO,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,KAAK,EAAE,CAAC,EAAE,QAAQ,CAAC,OAAO,IAAI,EAAE,CAAC;IAC3E,MAAM,MAAM,GAAG,CAAC,WAAW,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,IAAI,OAAO,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,WAAW,CAAC,EAAE,CAAC,CAAC;IACrG,MAAM,MAAM,GAAG,UAAU,CAAC,IAAI,CAAC,CAAC;IAChC,OAAO;QACL,OAAO,EAAE,oFAAoF;QAC7F,OAAO,EAAE,EAAc;QACvB,OAAO,EAAE,EAA+C;QACxD,YAAY,EAAE,EAA+C;QAC7D,MAAM;QACN,MAAM,EAAE,MAAM,CAAC,MAAM;QACrB,UAAU,EAAE,CAAC,GAAG,UAAU,CAAC,CAAC,IAAI,EAAE;KACnC,CAAC;AACJ,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,8 @@
+import { Command } from "commander";
+import { type CliIO } from "./io.js";
+export type { CliIO } from "./io.js";
+/** Build the command tree. Exposed so tests can run commands without a process. */
+export declare function createProgram(io: CliIO, setExit: (code: number) => void): Command;
+/** Run the CLI and return its exit code: 0 pass, 1 blocking findings, 2 usage or runtime error. */
+export declare function run(argv: string[], io?: CliIO): Promise<number>;
+//# 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":"AACA,OAAO,EAAE,OAAO,EAAkB,MAAM,WAAW,CAAC;AAIpD,OAAO,EAAa,KAAK,KAAK,EAAE,MAAM,SAAS,CAAC;AAEhD,YAAY,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAErC,mFAAmF;AACnF,wBAAgB,aAAa,CAAC,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,GAAG,OAAO,CAWjF;AAED,mGAAmG;AACnG,wBAAsB,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,GAAE,KAAmB,GAAG,OAAO,CAAC,MAAM,CAAC,CAclF"}

package/dist/index.js

@@ -0,0 +1,39 @@
+import { ConfigError, CoverageError, GitError, VERSION } from "@loose-ends/core";
+import { Command, CommanderError } from "commander";
+import { registerCheck, UsageError } from "./commands/check.js";
+import { registerFix } from "./commands/fix.js";
+import { registerInspect } from "./commands/inspect.js";
+import { processIO } from "./io.js";
+/** Build the command tree. Exposed so tests can run commands without a process. */
+export function createProgram(io, setExit) {
+    const program = new Command("loose-ends")
+        .description("Graph-powered liveness checks for AI-written code. Every change should lead somewhere.")
+        .version(VERSION, "-v, --version")
+        .configureOutput({ writeOut: io.stdout, writeErr: io.stderr })
+        .exitOverride()
+        .showHelpAfterError();
+    registerCheck(program, io, setExit);
+    registerInspect(program, io, setExit);
+    registerFix(program, io, setExit);
+    return program;
+}
+/** Run the CLI and return its exit code: 0 pass, 1 blocking findings, 2 usage or runtime error. */
+export async function run(argv, io = processIO()) {
+    let code = 0;
+    const program = createProgram(io, (c) => (code = c));
+    try {
+        await program.parseAsync(argv, { from: "user" });
+        return code;
+    }
+    catch (error) {
+        if (error instanceof CommanderError)
+            return error.exitCode === 0 ? 0 : 2;
+        const known = error instanceof UsageError || error instanceof ConfigError || error instanceof GitError || error instanceof CoverageError;
+        const message = error instanceof Error ? error.message : String(error);
+        io.stderr(`loose-ends: ${message}\n`);
+        if (!known && io.env.LOOSE_ENDS_DEBUG && error instanceof Error)
+            io.stderr(`${error.stack}\n`);
+        return 2;
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AACjF,OAAO,EAAE,OAAO,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AACpD,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAChE,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,EAAE,SAAS,EAAc,MAAM,SAAS,CAAC;AAIhD,mFAAmF;AACnF,MAAM,UAAU,aAAa,CAAC,EAAS,EAAE,OAA+B;IACtE,MAAM,OAAO,GAAG,IAAI,OAAO,CAAC,YAAY,CAAC;SACtC,WAAW,CAAC,wFAAwF,CAAC;SACrG,OAAO,CAAC,OAAO,EAAE,eAAe,CAAC;SACjC,eAAe,CAAC,EAAE,QAAQ,EAAE,EAAE,CAAC,MAAM,EAAE,QAAQ,EAAE,EAAE,CAAC,MAAM,EAAE,CAAC;SAC7D,YAAY,EAAE;SACd,kBAAkB,EAAE,CAAC;IACxB,aAAa,CAAC,OAAO,EAAE,EAAE,EAAE,OAAO,CAAC,CAAC;IACpC,eAAe,CAAC,OAAO,EAAE,EAAE,EAAE,OAAO,CAAC,CAAC;IACtC,WAAW,CAAC,OAAO,EAAE,EAAE,EAAE,OAAO,CAAC,CAAC;IAClC,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,mGAAmG;AACnG,MAAM,CAAC,KAAK,UAAU,GAAG,CAAC,IAAc,EAAE,KAAY,SAAS,EAAE;IAC/D,IAAI,IAAI,GAAG,CAAC,CAAC;IACb,MAAM,OAAO,GAAG,aAAa,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC,CAAC,CAAC;IACrD,IAAI,CAAC;QACH,MAAM,OAAO,CAAC,UAAU,CAAC,IAAI,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC;QACjD,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,KAAK,YAAY,cAAc;YAAE,OAAO,KAAK,CAAC,QAAQ,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QACzE,MAAM,KAAK,GAAG,KAAK,YAAY,UAAU,IAAI,KAAK,YAAY,WAAW,IAAI,KAAK,YAAY,QAAQ,IAAI,KAAK,YAAY,aAAa,CAAC;QACzI,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QACvE,EAAE,CAAC,MAAM,CAAC,eAAe,OAAO,IAAI,CAAC,CAAC;QACtC,IAAI,CAAC,KAAK,IAAI,EAAE,CAAC,GAAG,CAAC,gBAAgB,IAAI,KAAK,YAAY,KAAK;YAAE,EAAE,CAAC,MAAM,CAAC,GAAG,KAAK,CAAC,KAAK,IAAI,CAAC,CAAC;QAC/F,OAAO,CAAC,CAAC;IACX,CAAC;AACH,CAAC"}

package/dist/io.d.ts

@@ -0,0 +1,12 @@
+export interface CliIO {
+    cwd: string;
+    stdout: (text: string) => void;
+    stderr: (text: string) => void;
+    /** Whether stdout is a terminal that supports color. */
+    color: boolean;
+    env: Record<string, string | undefined>;
+}
+export declare function processIO(): CliIO;
+/** Write to a file (creating directories) or to stdout when no path is given. */
+export declare function emit(io: CliIO, text: string, output?: string): void;
+//# sourceMappingURL=io.d.ts.map

package/dist/io.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"io.d.ts","sourceRoot":"","sources":["../src/io.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,KAAK;IACpB,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAC/B,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAC/B,wDAAwD;IACxD,KAAK,EAAE,OAAO,CAAC;IACf,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC;CACzC;AAED,wBAAgB,SAAS,IAAI,KAAK,CAQjC;AAED,iFAAiF;AACjF,wBAAgB,IAAI,CAAC,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAQnE"}

package/dist/io.js

@@ -0,0 +1,22 @@
+import { mkdirSync, writeFileSync } from "node:fs";
+import { dirname, resolve } from "node:path";
+export function processIO() {
+    return {
+        cwd: process.cwd(),
+        stdout: (t) => process.stdout.write(t),
+        stderr: (t) => process.stderr.write(t),
+        color: !!process.stdout.isTTY && !("NO_COLOR" in process.env) && process.env.TERM !== "dumb",
+        env: process.env,
+    };
+}
+/** Write to a file (creating directories) or to stdout when no path is given. */
+export function emit(io, text, output) {
+    if (!output || output === "-") {
+        io.stdout(text);
+        return;
+    }
+    const abs = resolve(io.cwd, output);
+    mkdirSync(dirname(abs), { recursive: true });
+    writeFileSync(abs, text);
+}
+//# sourceMappingURL=io.js.map

package/dist/io.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"io.js","sourceRoot":"","sources":["../src/io.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AACnD,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAW7C,MAAM,UAAU,SAAS;IACvB,OAAO;QACL,GAAG,EAAE,OAAO,CAAC,GAAG,EAAE;QAClB,MAAM,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;QACtC,MAAM,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;QACtC,KAAK,EAAE,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,IAAI,CAAC,CAAC,UAAU,IAAI,OAAO,CAAC,GAAG,CAAC,IAAI,OAAO,CAAC,GAAG,CAAC,IAAI,KAAK,MAAM;QAC5F,GAAG,EAAE,OAAO,CAAC,GAAG;KACjB,CAAC;AACJ,CAAC;AAED,iFAAiF;AACjF,MAAM,UAAU,IAAI,CAAC,EAAS,EAAE,IAAY,EAAE,MAAe;IAC3D,IAAI,CAAC,MAAM,IAAI,MAAM,KAAK,GAAG,EAAE,CAAC;QAC9B,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QAChB,OAAO;IACT,CAAC;IACD,MAAM,GAAG,GAAG,OAAO,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;IACpC,SAAS,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC7C,aAAa,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;AAC3B,CAAC"}

package/package.json

@@ -1,6 +1,48 @@
 {
   "name": "loose-ends",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "1.1.0",
+  "description": "Graph-powered liveness checks for AI-written code.",
+  "license": "MIT",
+  "type": "module",
+  "bin": {
+    "loose-ends": "dist/bin.js"
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "keywords": [
+    "dead-code",
+    "reachability",
+    "static-analysis",
+    "typescript",
+    "ai",
+    "code-review"
+  ],
+  "scripts": {
+    "build": "tsc -b"
+  },
+  "dependencies": {
+    "@loose-ends/core": "1.1.0",
+    "commander": "^14.0.0"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/sid732/loose-ends.git",
+    "directory": "packages/cli"
+  },
+  "engines": {
+    "node": ">=20"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}