@yoavsh/treekeeper 0.0.0-stage → 0.1.0

package/dist/core/plan.js

@@ -0,0 +1,288 @@
+import { stat } from "node:fs/promises";
+import { basename } from "node:path";
+import { loadRepoConfig } from "./config.js";
+import { decideBranch, decideWorktree } from "./decide.js";
+import { selectPr } from "./forge.js";
+import * as git from "./git.js";
+import { dirSizeKb } from "./size.js";
+import { createActivityContext, detectActivity, isActive } from "./sessions.js";
+import { isInside, matchGlob } from "../util/paths.js";
+import { parseDuration } from "../util/time.js";
+export function policyFromConfig(cfg, force = false) {
+    return {
+        minAgeMs: parseDuration(cfg.minAge),
+        closedPrGraceMs: parseDuration(cfg.closedPrGrace),
+        onDirty: cfg.onDirty,
+        onClosedPr: cfg.onClosedPr,
+        onExtraCommits: cfg.onExtraCommits,
+        force,
+    };
+}
+export async function buildPlan(opts) {
+    const now = opts.now ?? Date.now();
+    const cwd = opts.cwd ?? process.cwd();
+    const warnings = [];
+    const activity = await createActivityContext(opts.config, opts.logger, now);
+    const repos = [];
+    for (const repo of opts.repos) {
+        const repoPlan = await planRepo(repo, { ...opts, now, cwd }, activity, warnings);
+        repos.push(repoPlan);
+    }
+    if (opts.forge.unavailableReason)
+        warnings.push(opts.forge.unavailableReason);
+    return {
+        version: 1,
+        generatedAt: new Date(now).toISOString(),
+        now,
+        roots: opts.config.roots,
+        repos,
+        summary: summarize(repos),
+        warnings,
+    };
+}
+async function planRepo(repo, opts, activity, warnings) {
+    const name = basename(repo);
+    const { config: cfg, warnings: cfgWarnings } = await loadRepoConfig(repo, opts.config);
+    for (const w of cfgWarnings)
+        warnings.push(w);
+    const empty = {
+        repo, name, defaultBranch: "", forgeAvailable: false,
+        worktrees: [], branches: [], skipped: null,
+    };
+    if (!cfg.enabled)
+        return { ...empty, skipped: "disabled in .treekeeper.json" };
+    const policy = policyFromConfig(cfg, opts.force ?? false);
+    const defaultBranch = await git.defaultBranch(repo);
+    const prIndex = await opts.forge.lookup(repo);
+    const bases = await resolveBases(repo, defaultBranch);
+    const worktrees = await git.listWorktrees(repo);
+    if (worktrees.length === 0) {
+        return { ...empty, defaultBranch, skipped: "not a readable git repo" };
+    }
+    const wtCandidates = [];
+    for (const wt of worktrees) {
+        if (wt.bare)
+            continue;
+        if (opts.skipWorktrees) {
+            wtCandidates.push(skippedWorktree(repo, name, wt));
+            continue;
+        }
+        wtCandidates.push(await planWorktree(repo, name, wt, {
+            cfg, policy, bases, prIndex, activity, now: opts.now, cwd: opts.cwd,
+            allSizes: opts.allSizes ?? false, logger: opts.logger,
+        }));
+    }
+    const branches = cfg.pruneBranches
+        ? await planBranches(repo, name, {
+            cfg, policy, bases, prIndex, defaultBranch, worktrees, wtCandidates, now: opts.now,
+        })
+        : [];
+    return {
+        repo,
+        name,
+        defaultBranch,
+        forgeAvailable: prIndex !== null,
+        worktrees: wtCandidates,
+        branches,
+        skipped: null,
+    };
+}
+function skippedWorktree(repo, repoName, wt) {
+    return {
+        repo,
+        repoName,
+        path: wt.path,
+        branch: wt.branch,
+        head: wt.head,
+        sizeKb: null,
+        verdict: wt.isMain
+            ? { action: "keep", reason: "the repo's main worktree", code: "main-worktree", risks: [] }
+            : { action: "keep", reason: "worktrees not considered (--branches-only)", code: "branches-only", risks: [] },
+        merge: { kind: "no-branch" },
+        activity: null,
+        lastTouched: 0,
+        dirty: false,
+        dirtyCount: 0,
+    };
+}
+async function planWorktree(repo, repoName, wt, ctx) {
+    const merge = wt.isMain || wt.detached || !wt.branch
+        ? { kind: "no-branch" }
+        : await mergeStatus(repo, wt.branch, wt.head, ctx.bases, ctx.prIndex);
+    // Only pay for the expensive probes when the worktree could actually go.
+    const cheapKeep = wt.isMain || isProtectedPath(ctx.cfg, wt.path) || wt.locked;
+    const finished = isFinished(merge);
+    let dirty = false;
+    let dirtyCount = 0;
+    let hit = null;
+    let lastTouched = 0;
+    if (!cheapKeep) {
+        try {
+            const st = await stat(wt.path);
+            lastTouched = st.mtimeMs;
+        }
+        catch {
+            lastTouched = 0;
+        }
+        if (finished) {
+            const d = await git.dirtyState(wt.path);
+            dirty = d.dirty;
+            dirtyCount = d.count;
+            hit = await detectActivity(ctx.activity, wt.path);
+            if (hit)
+                lastTouched = Math.max(lastTouched, hit.lastActivity);
+        }
+    }
+    const facts = {
+        now: ctx.now,
+        isMain: wt.isMain,
+        detached: wt.detached,
+        locked: wt.locked,
+        lockReason: wt.lockReason,
+        branch: wt.branch,
+        protectedBranch: wt.branch !== null && isProtectedBranch(ctx.cfg, wt.branch),
+        protectedPath: isProtectedPath(ctx.cfg, wt.path),
+        isCwd: isInside(wt.path, ctx.cwd),
+        merge,
+        dirty,
+        dirtyCount,
+        activity: hit,
+        activityIsRecent: isActive(ctx.activity, hit),
+        lastTouched,
+        inUse: hit?.detector === "process" ||
+            (ctx.activity.processCwds?.some((p) => isInside(wt.path, p)) ?? false),
+    };
+    const verdict = decideWorktree(facts, ctx.policy);
+    const sizeKb = verdict.action === "reclaim" || ctx.allSizes ? await dirSizeKb(wt.path) : null;
+    return {
+        repo,
+        repoName,
+        path: wt.path,
+        branch: wt.branch,
+        head: wt.head,
+        sizeKb,
+        verdict,
+        merge,
+        activity: hit,
+        lastTouched,
+        dirty,
+        dirtyCount,
+    };
+}
+async function planBranches(repo, repoName, ctx) {
+    // Branches whose worktree survives this sweep must survive with it. Branches
+    // whose worktree is being reclaimed are deleted as part of that removal, so
+    // they are not listed here twice.
+    const keptByWorktree = new Set();
+    const removedWithWorktree = new Set();
+    for (const c of ctx.wtCandidates) {
+        if (!c.branch)
+            continue;
+        if (c.verdict.action === "reclaim")
+            removedWithWorktree.add(c.branch);
+        else
+            keptByWorktree.add(c.branch);
+    }
+    const mainWt = ctx.worktrees.find((w) => w.isMain);
+    const currentBranch = mainWt?.branch ?? null;
+    const out = [];
+    for (const branch of await git.localBranches(repo)) {
+        if (removedWithWorktree.has(branch.name))
+            continue;
+        const merge = await mergeStatus(repo, branch.name, branch.head, ctx.bases, ctx.prIndex);
+        const facts = {
+            now: ctx.now,
+            name: branch.name,
+            isDefault: branch.name === ctx.defaultBranch,
+            protectedBranch: isProtectedBranch(ctx.cfg, branch.name),
+            hasWorktree: keptByWorktree.has(branch.name),
+            isCurrent: branch.name === currentBranch,
+            merge,
+            lastCommit: null,
+        };
+        const verdict = decideBranch(facts, ctx.policy);
+        if (verdict.action === "reclaim") {
+            out.push({ repo, repoName, name: branch.name, head: branch.head, verdict, merge });
+        }
+    }
+    return out;
+}
+/** Candidate base refs for ancestry checks, remote first. */
+async function resolveBases(repo, defaultBranch) {
+    const bases = [];
+    for (const ref of [`refs/remotes/origin/${defaultBranch}`, `refs/heads/${defaultBranch}`]) {
+        if (await git.refExists(repo, ref))
+            bases.push(ref);
+    }
+    return bases;
+}
+export async function mergeStatus(repo, branch, tip, bases, prIndex) {
+    const head = tip ?? (await git.revParse(repo, `refs/heads/${branch}`));
+    if (!head)
+        return { kind: "unmerged", forgeAvailable: prIndex !== null };
+    for (const base of bases) {
+        if (await git.isAncestor(repo, head, base)) {
+            return { kind: "merged-ancestor", base: base.replace(/^refs\/(remotes|heads)\//, "") };
+        }
+    }
+    const pr = selectPr(prIndex?.get(branch), head);
+    if (!pr)
+        return { kind: "unmerged", forgeAvailable: prIndex !== null };
+    if (pr.state === "MERGED") {
+        if (pr.headRefOid === head)
+            return { kind: "merged-pr", pr };
+        const base = bases[0];
+        const extra = base ? (await git.commitsNotIn(repo, base, branch)).length : 0;
+        return extra > 0 ? { kind: "merged-pr-extra", pr, extra } : { kind: "merged-pr", pr };
+    }
+    if (pr.state === "CLOSED")
+        return { kind: "closed-pr", pr };
+    return { kind: "open-pr", pr };
+}
+function isFinished(merge) {
+    return (merge.kind === "merged-ancestor" ||
+        merge.kind === "merged-pr" ||
+        merge.kind === "merged-pr-extra" ||
+        merge.kind === "closed-pr");
+}
+export function isProtectedBranch(cfg, branch) {
+    return cfg.protectBranches.some((p) => (p.includes("*") || p.includes("?") ? matchGlob(p, branch) : p === branch));
+}
+export function isProtectedPath(cfg, path) {
+    return cfg.protectPaths.some((p) => p.includes("*") || p.includes("?") ? matchGlob(p, path) : isInside(p, path));
+}
+function summarize(repos) {
+    let worktreesScanned = 0;
+    let worktreesReclaimable = 0;
+    let worktreesKept = 0;
+    let branchesDeletable = 0;
+    let reclaimKb = 0;
+    for (const r of repos) {
+        for (const w of r.worktrees) {
+            if (w.verdict.code === "main-worktree")
+                continue;
+            worktreesScanned += 1;
+            if (w.verdict.action === "reclaim") {
+                worktreesReclaimable += 1;
+                reclaimKb += w.sizeKb ?? 0;
+            }
+            else {
+                worktreesKept += 1;
+            }
+        }
+        branchesDeletable += r.branches.length;
+    }
+    return {
+        repos: repos.filter((r) => r.skipped === null).length,
+        worktreesScanned,
+        worktreesReclaimable,
+        worktreesKept,
+        branchesDeletable,
+        reclaimKb,
+    };
+}
+/** Every worktree the plan would remove, flattened. */
+export function reclaimable(plan) {
+    return plan.repos.flatMap((r) => r.worktrees.filter((w) => w.verdict.action === "reclaim"));
+}
+//# sourceMappingURL=plan.js.map

package/dist/core/plan.js.map

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

package/dist/core/render.d.ts

@@ -0,0 +1,14 @@
+import type { ApplyResult } from "./apply.js";
+import type { Plan } from "./plan.js";
+export interface RenderOptions {
+    /** Show kept worktrees too (default: only when there are few). */
+    verbose?: boolean;
+    /** Only the summary line. */
+    quiet?: boolean;
+}
+/** The human-readable plan. */
+export declare function renderPlan(plan: Plan, opts?: RenderOptions): string;
+export declare function summaryLine(plan: Plan): string;
+/** What actually happened, after `--apply`. */
+export declare function renderApply(result: ApplyResult, plan: Plan): string;
+//# sourceMappingURL=render.d.ts.map

package/dist/core/render.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"render.d.ts","sourceRoot":"","sources":["../../src/core/render.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAC9C,OAAO,KAAK,EAAE,IAAI,EAA+B,MAAM,WAAW,CAAC;AAKnE,MAAM,WAAW,aAAa;IAC5B,kEAAkE;IAClE,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,6BAA6B;IAC7B,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,+BAA+B;AAC/B,wBAAgB,UAAU,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,GAAE,aAAkB,GAAG,MAAM,CAkBvE;AAgED,wBAAgB,WAAW,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM,CAa9C;AAED,+CAA+C;AAC/C,wBAAgB,WAAW,CAAC,MAAM,EAAE,WAAW,EAAE,IAAI,EAAE,IAAI,GAAG,MAAM,CAuDnE"}

package/dist/core/render.js

@@ -0,0 +1,128 @@
+import { formatKb } from "../util/bytes.js";
+import { color, padEndVisible, visibleWidth } from "../util/color.js";
+import { shortenPath } from "../util/paths.js";
+/** The human-readable plan. */
+export function renderPlan(plan, opts = {}) {
+    const out = [];
+    if (opts.quiet)
+        return summaryLine(plan);
+    for (const repo of plan.repos) {
+        const block = renderRepo(repo, opts);
+        if (block.length > 0) {
+            out.push(...block, "");
+        }
+    }
+    for (const warning of plan.warnings) {
+        out.push(color.yellow(`note  ${warning}`));
+    }
+    if (plan.warnings.length > 0)
+        out.push("");
+    out.push(summaryLine(plan));
+    return out.join("\n");
+}
+function renderRepo(repo, opts) {
+    if (repo.skipped) {
+        return opts.verbose ? [`${color.bold(repo.name)}  ${color.gray(`skipped — ${repo.skipped}`)}`] : [];
+    }
+    const reclaim = repo.worktrees.filter((w) => w.verdict.action === "reclaim");
+    const kept = repo.worktrees.filter((w) => w.verdict.action === "keep" && w.verdict.code !== "main-worktree");
+    const showKept = opts.verbose ? kept : [];
+    if (reclaim.length === 0 && showKept.length === 0 && repo.branches.length === 0)
+        return [];
+    const rows = [];
+    for (const w of reclaim)
+        rows.push(row(w, true));
+    for (const w of showKept)
+        rows.push(row(w, false));
+    const widths = [0, 0, 0, 0];
+    for (const r of rows) {
+        for (let i = 0; i < 4; i += 1) {
+            widths[i] = Math.max(widths[i], visibleWidth(r[i]));
+        }
+    }
+    const head = `${color.bold(repo.name)} ${color.gray(`(${repo.defaultBranch})`)}${repo.forgeAvailable ? "" : color.gray(" [no PR data]")}`;
+    const lines = [head];
+    for (const r of rows) {
+        const cells = [
+            padEndVisible(r[0], widths[0]),
+            padEndVisible(r[1], widths[1]),
+            padEndVisible(r[2], widths[2]),
+            padEndVisible(r[3], widths[3]),
+            r[4],
+        ];
+        lines.push(`  ${cells.join("  ").trimEnd()}`);
+    }
+    if (repo.branches.length > 0) {
+        const names = repo.branches.map((b) => b.name);
+        const shown = names.slice(0, 6).join(" ");
+        const more = names.length > 6 ? color.gray(` +${names.length - 6} more`) : "";
+        lines.push(`  ${color.red("DELETE")}  ${names.length} merged branch${names.length === 1 ? "" : "es"}: ${color.gray(shown)}${more}`);
+    }
+    return lines;
+}
+function row(w, reclaim) {
+    const action = reclaim ? color.red("RECLAIM") : color.gray("keep   ");
+    const path = reclaim ? shortenPath(w.path) : color.gray(shortenPath(w.path));
+    const branch = w.branch ? color.cyan(`[${w.branch}]`) : color.gray("[detached]");
+    const size = w.sizeKb === null ? "" : (reclaim ? color.yellow(formatKb(w.sizeKb)) : color.gray(formatKb(w.sizeKb)));
+    const risks = w.verdict.risks.length > 0 ? color.yellow(` (${w.verdict.risks.join(", ")})`) : "";
+    const reason = (reclaim ? color.gray(w.verdict.reason) : color.gray(w.verdict.reason)) + risks;
+    return [action, path, branch, size, reason];
+}
+export function summaryLine(plan) {
+    const s = plan.summary;
+    if (s.worktreesReclaimable === 0 && s.branchesDeletable === 0) {
+        return color.green(`nothing to clean — ${s.worktreesScanned} worktree${s.worktreesScanned === 1 ? "" : "s"} across ${s.repos} repo${s.repos === 1 ? "" : "s"} all still in play`);
+    }
+    return [
+        `would reclaim ${color.bold(String(s.worktreesReclaimable))} worktree${s.worktreesReclaimable === 1 ? "" : "s"}`,
+        `(${color.bold(formatKb(s.reclaimKb))})`,
+        `and delete ${color.bold(String(s.branchesDeletable))} branch${s.branchesDeletable === 1 ? "" : "es"}`,
+        color.gray(`· ${s.worktreesKept} kept`),
+    ].join(" ");
+}
+/** What actually happened, after `--apply`. */
+export function renderApply(result, plan) {
+    const out = [];
+    for (const r of result.removedWorktrees) {
+        const parts = [
+            color.green("reclaimed"),
+            shortenPath(r.path),
+            r.branch ? color.cyan(`[${r.branch}]`) : "",
+            color.yellow(formatKb(r.sizeKb)),
+            color.gray(`— ${r.reason}`),
+        ].filter((p) => p !== "");
+        out.push(parts.join("  "));
+    }
+    const branchOnly = result.deletedBranches.filter((b) => !result.removedWorktrees.some((w) => w.branch === b.name && w.repo === b.repo));
+    if (branchOnly.length > 0) {
+        out.push(`${color.green("deleted")}  ${branchOnly.length} branch${branchOnly.length === 1 ? "" : "es"} ${color.gray(branchOnly.slice(0, 8).map((b) => b.name).join(" "))}`);
+    }
+    const archived = result.archives.filter((a) => a.bundle || a.patch || a.untracked);
+    if (archived.length > 0) {
+        out.push("");
+        out.push(color.gray(`archived unique work from ${archived.length} of them:`));
+        for (const a of archived.slice(0, 10)) {
+            const bits = [
+                a.bundle ? `${a.bundle.commits} commit${a.bundle.commits === 1 ? "" : "s"}` : null,
+                a.patch ? "uncommitted diff" : null,
+                a.untracked ? `${a.untracked.count} untracked` : null,
+            ].filter(Boolean);
+            out.push(color.gray(`  ${shortenPath(a.dir)}  (${bits.join(", ")})`));
+        }
+    }
+    for (const f of result.failures) {
+        out.push(color.yellow(`kept  ${shortenPath(f.target)} — ${f.message}`));
+    }
+    if (out.length > 0)
+        out.push("");
+    const nothing = result.removedWorktrees.length === 0 && result.deletedBranches.length === 0;
+    out.push(nothing
+        ? color.green("nothing to clean")
+        : `${color.bold("reclaimed")} ${formatKb(result.reclaimedKb)} · ` +
+            `${result.removedWorktrees.length} worktree${result.removedWorktrees.length === 1 ? "" : "s"}, ` +
+            `${result.deletedBranches.length} branch${result.deletedBranches.length === 1 ? "" : "es"} · ` +
+            color.gray(`${plan.summary.worktreesKept} kept`));
+    return out.join("\n");
+}
+//# sourceMappingURL=render.js.map

package/dist/core/render.js.map

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

package/dist/core/scan.d.ts

@@ -0,0 +1,22 @@
+import type { Logger } from "../util/log.js";
+export interface ScanOptions {
+    roots: string[];
+    maxDepth: number;
+    protectPaths?: string[];
+    logger?: Logger;
+}
+/**
+ * Find the main worktree of every git repo under `roots`.
+ *
+ * A linked worktree found during the walk resolves to its parent clone, so a
+ * repo is discovered whether the root holds the clone, the worktrees, or both.
+ */
+export declare function discoverRepos(opts: ScanOptions): Promise<string[]>;
+/**
+ * Resolve the repos implied by explicit CLI paths. A path inside a repo or
+ * worktree resolves to that repo; a plain directory is scanned shallowly.
+ */
+export declare function reposFromPaths(paths: string[], opts: Omit<ScanOptions, "roots">): Promise<string[]>;
+/** True when any root contains the given path — used to sanity-check config. */
+export declare function underAnyRoot(roots: string[], path: string): boolean;
+//# sourceMappingURL=scan.d.ts.map

package/dist/core/scan.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scan.d.ts","sourceRoot":"","sources":["../../src/core/scan.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAC;AAS7C,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;;;;GAKG;AACH,wBAAsB,aAAa,CAAC,IAAI,EAAE,WAAW,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAsDxE;AAED;;;GAGG;AACH,wBAAsB,cAAc,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,IAAI,CAAC,WAAW,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAazG;AAED,gFAAgF;AAChF,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAEnE"}

package/dist/core/scan.js

@@ -0,0 +1,99 @@
+import { readdir, stat } from "node:fs/promises";
+import { join } from "node:path";
+import { isGitRepo, mainRepoPath } from "./git.js";
+import { isInside, matchAnyGlob } from "../util/paths.js";
+/** Directories never worth descending into when hunting for repos. */
+const SKIP_DIRS = new Set([
+    "node_modules", ".git", ".svn", ".hg", "vendor", "target", "dist", "build",
+    ".next", ".nuxt", ".venv", "venv", "__pycache__", ".cache", ".pnpm-store",
+    "Library", "Applications", ".Trash", ".cargo", ".rustup", ".gradle", ".m2",
+]);
+/**
+ * Find the main worktree of every git repo under `roots`.
+ *
+ * A linked worktree found during the walk resolves to its parent clone, so a
+ * repo is discovered whether the root holds the clone, the worktrees, or both.
+ */
+export async function discoverRepos(opts) {
+    const found = new Set();
+    const seen = new Set();
+    const walk = async (dir, depth) => {
+        if (seen.has(dir))
+            return;
+        seen.add(dir);
+        if (opts.protectPaths && matchAnyGlob(opts.protectPaths, dir))
+            return;
+        let entries;
+        try {
+            entries = await readdir(dir, { withFileTypes: true });
+        }
+        catch (err) {
+            const code = err.code;
+            if (code !== "ENOENT" && code !== "EACCES" && code !== "ENOTDIR" && code !== "EPERM") {
+                opts.logger?.debug(`scan: cannot read ${dir}: ${err.message}`);
+            }
+            return;
+        }
+        const hasGit = entries.some((e) => e.name === ".git");
+        if (hasGit) {
+            const main = await mainRepoPath(dir);
+            if (main) {
+                found.add(main);
+                // Stop here: `git worktree list` from the main repo enumerates the rest,
+                // and nested repos inside a checkout are not ours to garbage-collect.
+                return;
+            }
+        }
+        if (depth >= opts.maxDepth)
+            return;
+        for (const entry of entries) {
+            if (!entry.isDirectory() && !entry.isSymbolicLink())
+                continue;
+            if (entry.name.startsWith(".") && entry.name !== ".worktrees")
+                continue;
+            if (SKIP_DIRS.has(entry.name))
+                continue;
+            const child = join(dir, entry.name);
+            if (entry.isSymbolicLink()) {
+                // Follow a symlinked root one level, but never let a loop trap the walk.
+                try {
+                    const st = await stat(child);
+                    if (!st.isDirectory())
+                        continue;
+                }
+                catch {
+                    continue;
+                }
+            }
+            await walk(child, depth + 1);
+        }
+    };
+    for (const root of opts.roots) {
+        await walk(root, 0);
+    }
+    return [...found].sort();
+}
+/**
+ * Resolve the repos implied by explicit CLI paths. A path inside a repo or
+ * worktree resolves to that repo; a plain directory is scanned shallowly.
+ */
+export async function reposFromPaths(paths, opts) {
+    const out = new Set();
+    for (const p of paths) {
+        if (await isGitRepo(p)) {
+            const main = await mainRepoPath(p);
+            if (main) {
+                out.add(main);
+                continue;
+            }
+        }
+        for (const repo of await discoverRepos({ ...opts, roots: [p] }))
+            out.add(repo);
+    }
+    return [...out].sort();
+}
+/** True when any root contains the given path — used to sanity-check config. */
+export function underAnyRoot(roots, path) {
+    return roots.some((r) => isInside(r, path));
+}
+//# sourceMappingURL=scan.js.map

package/dist/core/scan.js.map

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

package/dist/core/sessions.d.ts

@@ -0,0 +1,37 @@
+import type { Config, SessionCommand } from "./config.js";
+import type { Logger } from "../util/log.js";
+export interface ActivityHit {
+    /** Which detector saw it: "claude-code", "process", "mtime", … */
+    detector: string;
+    /** Epoch ms of the most recent activity. */
+    lastActivity: number;
+    detail: string;
+}
+export interface ActivityContext {
+    now: number;
+    graceMs: number;
+    detectors: Set<string>;
+    extraPaths: string[];
+    commands: SessionCommand[];
+    logger?: Logger;
+    /** Absolute paths that are the cwd of some live process; null when unknown. */
+    processCwds: string[] | null;
+}
+export declare function createActivityContext(cfg: Config, logger?: Logger, now?: number): Promise<ActivityContext>;
+/**
+ * Is an agent (or a human) still working in this worktree?
+ *
+ * Detectors are deliberately layered: the harness-specific ones give a precise
+ * answer with a timestamp, while `process` and `mtime` are the catch-all that
+ * makes this work with harnesses treekeeper has never heard of.
+ */
+export declare function detectActivity(ctx: ActivityContext, worktreePath: string): Promise<ActivityHit | null>;
+/** `true` when the hit falls inside the session grace window. */
+export declare function isActive(ctx: ActivityContext, hit: ActivityHit | null): boolean;
+/**
+ * Claude Code stores one JSONL transcript per session under
+ * `~/.claude/projects/<slugified-cwd>/`, so the newest transcript mtime is the
+ * last time an agent did anything in that worktree.
+ */
+export declare function claudeProjectSlugs(worktreePath: string): string[];
+//# sourceMappingURL=sessions.d.ts.map

package/dist/core/sessions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sessions.d.ts","sourceRoot":"","sources":["../../src/core/sessions.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAE1D,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAC;AAI7C,MAAM,WAAW,WAAW;IAC1B,kEAAkE;IAClE,QAAQ,EAAE,MAAM,CAAC;IACjB,4CAA4C;IAC5C,YAAY,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,eAAe;IAC9B,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IACvB,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,QAAQ,EAAE,cAAc,EAAE,CAAC;IAC3B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,+EAA+E;IAC/E,WAAW,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC;CAC9B;AAYD,wBAAsB,qBAAqB,CACzC,GAAG,EAAE,MAAM,EACX,MAAM,CAAC,EAAE,MAAM,EACf,GAAG,SAAa,GACf,OAAO,CAAC,eAAe,CAAC,CAe1B;AAED;;;;;;GAMG;AACH,wBAAsB,cAAc,CAClC,GAAG,EAAE,eAAe,EACpB,YAAY,EAAE,MAAM,GACnB,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC,CA8D7B;AAED,iEAAiE;AACjE,wBAAgB,QAAQ,CAAC,GAAG,EAAE,eAAe,EAAE,GAAG,EAAE,WAAW,GAAG,IAAI,GAAG,OAAO,CAG/E;AAID;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,EAAE,CAIjE"}