@yoavsh/treekeeper 0.0.0-stage → 0.1.0

package/dist/core/forge.js

@@ -0,0 +1,190 @@
+import { createHash } from "node:crypto";
+import { mkdir, readFile, writeFile } from "node:fs/promises";
+import { join } from "node:path";
+import { have, run } from "../util/exec.js";
+import { treekeeperHome } from "../util/paths.js";
+import { redactRemote } from "../util/redact.js";
+import { parseDuration } from "../util/time.js";
+import { originUrl } from "./git.js";
+export function createForge(opts) {
+    // Not a problem worth warning about: the repo header already shows that a
+    // sweep ran without pull-request data.
+    if (opts.kind === "none")
+        return new NullForge(null);
+    return new GitHubForge(opts);
+}
+class NullForge {
+    kind = "none";
+    unavailableReason;
+    constructor(reason) {
+        this.unavailableReason = reason;
+    }
+    async lookup() {
+        return null;
+    }
+}
+class GitHubForge {
+    opts;
+    kind = "github";
+    unavailableReason = null;
+    ttlMs;
+    memo = new Map();
+    ghChecked = false;
+    constructor(opts) {
+        this.opts = opts;
+        this.ttlMs = parseDuration(opts.cacheTtl);
+    }
+    async lookup(repo) {
+        if (this.memo.has(repo))
+            return this.memo.get(repo);
+        const result = await this.fetch(repo);
+        this.memo.set(repo, result);
+        return result;
+    }
+    async fetch(repo) {
+        const remote = await originUrl(repo);
+        if (!remote) {
+            this.opts.logger?.debug(`forge: ${repo} has no origin remote`);
+            return null;
+        }
+        if (!isGitHubRemote(remote)) {
+            this.opts.logger?.debug(`forge: ${redactRemote(remote)} is not a github remote`);
+            return null;
+        }
+        const cachePath = join(treekeeperHome(), "cache", `gh-${hash(remote)}.json`);
+        if (!this.opts.refresh) {
+            const cached = await readCache(cachePath);
+            if (cached && Date.now() - cached.fetchedAt < this.ttlMs) {
+                this.opts.logger?.debug(`forge: cache hit for ${redactRemote(remote)}`);
+                return index(cached.prs);
+            }
+        }
+        if (!this.ghChecked) {
+            this.ghChecked = true;
+            if (!(await have("gh"))) {
+                this.unavailableReason =
+                    "the GitHub CLI (gh) is not installed, so squash-merged branches cannot be detected";
+                this.opts.logger?.warn(this.unavailableReason);
+            }
+        }
+        if (this.unavailableReason) {
+            const cached = await readCache(cachePath);
+            return cached ? index(cached.prs) : null;
+        }
+        const r = await run("gh", [
+            "pr", "list",
+            "--repo", remote,
+            "--state", "all",
+            "--limit", String(this.opts.limit ?? 300),
+            "--json", "number,state,headRefName,headRefOid,mergedAt,closedAt,url,title",
+        ], { timeoutMs: 60_000 });
+        if (r.code !== 0) {
+            const detail = (r.stderr || r.stdout).trim().split("\n")[0] ?? "unknown error";
+            this.opts.logger?.warn(`forge: gh pr list failed for ${redactRemote(remote)}: ${detail}`);
+            // Stale data beats no data: ancestry alone misses squash merges, and a
+            // missing PR record can only ever make treekeeper *more* conservative.
+            const cached = await readCache(cachePath);
+            return cached ? index(cached.prs) : null;
+        }
+        let parsed;
+        try {
+            parsed = JSON.parse(r.stdout);
+        }
+        catch {
+            this.opts.logger?.warn(`forge: could not parse gh output for ${redactRemote(remote)}`);
+            return null;
+        }
+        if (!Array.isArray(parsed))
+            return null;
+        const prs = parsed.flatMap((item) => (isPrLike(item) ? [toPrRef(item)] : []));
+        await writeCache(cachePath, { version: 1, fetchedAt: Date.now(), remote: redactRemote(remote), prs });
+        this.opts.logger?.debug(`forge: fetched ${prs.length} PRs for ${redactRemote(remote)}`);
+        return index(prs);
+    }
+}
+function index(prs) {
+    const map = new Map();
+    for (const pr of prs) {
+        const list = map.get(pr.headRefName);
+        if (list)
+            list.push(pr);
+        else
+            map.set(pr.headRefName, [pr]);
+    }
+    for (const list of map.values())
+        list.sort((a, b) => b.number - a.number);
+    return map;
+}
+/**
+ * Pick the PR that decides a branch's fate. A branch name can be reused across
+ * several PRs, so prefer a merged PR whose head sha still matches the local tip,
+ * then any merged PR, then the newest.
+ */
+export function selectPr(prs, localTip) {
+    if (!prs || prs.length === 0)
+        return null;
+    if (localTip) {
+        const exact = prs.find((p) => p.headRefOid === localTip && p.state === "MERGED");
+        if (exact)
+            return exact;
+    }
+    const merged = prs.find((p) => p.state === "MERGED");
+    if (merged)
+        return merged;
+    const open = prs.find((p) => p.state === "OPEN");
+    if (open)
+        return open;
+    return prs[0] ?? null;
+}
+function isGitHubRemote(remote) {
+    return /github\.com/i.test(remote) || /^git@github\.com/i.test(remote);
+}
+function hash(s) {
+    return createHash("sha1").update(s).digest("hex").slice(0, 16);
+}
+async function readCache(path) {
+    try {
+        const parsed = JSON.parse(await readFile(path, "utf8"));
+        if (parsed !== null && typeof parsed === "object" &&
+            parsed.version === 1 && Array.isArray(parsed.prs)) {
+            return parsed;
+        }
+    }
+    catch {
+        /* no usable cache */
+    }
+    return null;
+}
+async function writeCache(path, data) {
+    try {
+        await mkdir(join(path, ".."), { recursive: true });
+        await writeFile(path, JSON.stringify(data));
+    }
+    catch {
+        /* a cache that cannot be written is not an error */
+    }
+}
+function isPrLike(v) {
+    return v !== null && typeof v === "object" && typeof v["number"] === "number";
+}
+function toPrRef(item) {
+    const stateRaw = String(item["state"] ?? "").toUpperCase();
+    const state = stateRaw === "MERGED" || stateRaw === "CLOSED" ? stateRaw : "OPEN";
+    return {
+        number: Number(item["number"]),
+        state,
+        headRefName: String(item["headRefName"] ?? ""),
+        headRefOid: String(item["headRefOid"] ?? ""),
+        mergedAt: toEpoch(item["mergedAt"]),
+        closedAt: toEpoch(item["closedAt"]),
+        url: String(item["url"] ?? ""),
+        title: String(item["title"] ?? ""),
+    };
+}
+function toEpoch(v) {
+    if (typeof v !== "string" || v === "")
+        return null;
+    const t = Date.parse(v);
+    return Number.isFinite(t) ? t : null;
+}
+//# sourceMappingURL=forge.js.map

package/dist/core/forge.js.map

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

package/dist/core/git.d.ts

@@ -0,0 +1,63 @@
+export interface Worktree {
+    path: string;
+    /** Short branch name, or null when detached/bare. */
+    branch: string | null;
+    head: string | null;
+    isMain: boolean;
+    detached: boolean;
+    bare: boolean;
+    locked: boolean;
+    lockReason: string | null;
+    prunable: boolean;
+}
+export interface LocalBranch {
+    name: string;
+    head: string;
+    upstream: string | null;
+}
+/** Top-level directory of the worktree containing `dir`, or null. */
+export declare function repoToplevel(dir: string): Promise<string | null>;
+/**
+ * The *main* worktree of the repo containing `dir`. Given a linked worktree this
+ * returns the original clone, which is where worktree and branch operations have
+ * to run.
+ */
+export declare function mainRepoPath(dir: string): Promise<string | null>;
+export declare function isGitRepo(dir: string): Promise<boolean>;
+/** Parse `git worktree list --porcelain`. The first record is the main worktree. */
+export declare function parseWorktreeList(porcelain: string): Worktree[];
+export declare function listWorktrees(repo: string): Promise<Worktree[]>;
+export declare function pruneWorktrees(repo: string): Promise<void>;
+/** origin/HEAD if known, else the first of main/master/trunk that exists. */
+export declare function defaultBranch(repo: string): Promise<string>;
+export declare function refExists(repo: string, ref: string): Promise<boolean>;
+export declare function revParse(repo: string, ref: string): Promise<string | null>;
+export declare function originUrl(repo: string): Promise<string | null>;
+export declare function isAncestor(repo: string, maybeAncestor: string, descendant: string): Promise<boolean>;
+/** Commits on `branch` that are not reachable from `base`. */
+export declare function commitsNotIn(repo: string, base: string, branch: string): Promise<string[]>;
+export declare function localBranches(repo: string): Promise<LocalBranch[]>;
+export interface DirtyState {
+    dirty: boolean;
+    /** Up to a few entries, for the explanation shown to the user. */
+    sample: string[];
+    count: number;
+}
+/** Uncommitted changes, including untracked files but not ignored ones. */
+export declare function dirtyState(worktreePath: string): Promise<DirtyState>;
+export declare function untrackedFiles(worktreePath: string): Promise<string[]>;
+/** Seconds-precision commit time of a ref, as epoch ms. */
+export declare function commitTime(repo: string, ref: string): Promise<number | null>;
+export interface RemoveResult {
+    ok: boolean;
+    method: "git" | "none";
+    error?: string;
+}
+export declare function removeWorktree(repo: string, worktreePath: string, force: boolean): Promise<RemoveResult>;
+export declare function deleteBranch(repo: string, branch: string, force?: boolean): Promise<boolean>;
+export declare function remotePrune(repo: string, remote?: string): Promise<boolean>;
+export declare function createBundle(repo: string, destFile: string, revs: string[]): Promise<boolean>;
+/** `git diff HEAD --binary` for a worktree, or null when there is nothing to save. */
+export declare function diffAgainstHead(worktreePath: string): Promise<string | null>;
+export declare function gitVersion(): Promise<string | null>;
+//# sourceMappingURL=git.d.ts.map

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

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

package/dist/core/git.js

@@ -0,0 +1,194 @@
+import { run, runLines, runOk } from "../util/exec.js";
+import { dirname, resolve } from "node:path";
+const GIT_TIMEOUT = 30_000;
+async function git(cwd, args) {
+    return runOk("git", ["-C", cwd, ...args], { timeoutMs: GIT_TIMEOUT });
+}
+/** Top-level directory of the worktree containing `dir`, or null. */
+export async function repoToplevel(dir) {
+    const out = await git(dir, ["rev-parse", "--show-toplevel"]);
+    return out ? resolve(out) : null;
+}
+/**
+ * The *main* worktree of the repo containing `dir`. Given a linked worktree this
+ * returns the original clone, which is where worktree and branch operations have
+ * to run.
+ */
+export async function mainRepoPath(dir) {
+    const common = await git(dir, ["rev-parse", "--path-format=absolute", "--git-common-dir"]);
+    if (!common)
+        return null;
+    const abs = resolve(common);
+    // ".../repo/.git" -> ".../repo"; a bare repo's common dir is the repo itself.
+    const base = abs.endsWith("/.git") || abs.endsWith("\\.git") ? dirname(abs) : abs;
+    return base;
+}
+export async function isGitRepo(dir) {
+    const out = await git(dir, ["rev-parse", "--is-inside-work-tree"]);
+    return out === "true";
+}
+/** Parse `git worktree list --porcelain`. The first record is the main worktree. */
+export function parseWorktreeList(porcelain) {
+    const out = [];
+    let current = null;
+    const push = () => {
+        if (current)
+            out.push(current);
+    };
+    for (const rawLine of porcelain.split("\n")) {
+        const line = rawLine.replace(/\r$/, "");
+        if (line.startsWith("worktree ")) {
+            push();
+            current = {
+                path: resolve(line.slice("worktree ".length)),
+                branch: null,
+                head: null,
+                isMain: out.length === 0,
+                detached: false,
+                bare: false,
+                locked: false,
+                lockReason: null,
+                prunable: false,
+            };
+        }
+        else if (!current) {
+            continue;
+        }
+        else if (line.startsWith("HEAD ")) {
+            current.head = line.slice("HEAD ".length).trim();
+        }
+        else if (line.startsWith("branch ")) {
+            current.branch = line.slice("branch ".length).replace(/^refs\/heads\//, "").trim();
+        }
+        else if (line === "detached") {
+            current.detached = true;
+        }
+        else if (line === "bare") {
+            current.bare = true;
+        }
+        else if (line.startsWith("locked")) {
+            current.locked = true;
+            const reason = line.slice("locked".length).trim();
+            current.lockReason = reason === "" ? null : reason;
+        }
+        else if (line.startsWith("prunable")) {
+            current.prunable = true;
+        }
+    }
+    push();
+    return out;
+}
+export async function listWorktrees(repo) {
+    const out = await git(repo, ["worktree", "list", "--porcelain"]);
+    return out === null ? [] : parseWorktreeList(out);
+}
+export async function pruneWorktrees(repo) {
+    await git(repo, ["worktree", "prune"]);
+}
+/** origin/HEAD if known, else the first of main/master/trunk that exists. */
+export async function defaultBranch(repo) {
+    const symref = await git(repo, ["symbolic-ref", "--quiet", "refs/remotes/origin/HEAD"]);
+    if (symref)
+        return symref.replace(/^refs\/remotes\/origin\//, "");
+    const remoteShow = await git(repo, ["rev-parse", "--abbrev-ref", "origin/HEAD"]);
+    if (remoteShow && remoteShow !== "origin/HEAD")
+        return remoteShow.replace(/^origin\//, "");
+    for (const candidate of ["main", "master", "trunk"]) {
+        if (await refExists(repo, `refs/heads/${candidate}`))
+            return candidate;
+    }
+    const head = await git(repo, ["rev-parse", "--abbrev-ref", "HEAD"]);
+    return head && head !== "HEAD" ? head : "main";
+}
+export async function refExists(repo, ref) {
+    const r = await run("git", ["-C", repo, "show-ref", "--verify", "--quiet", ref], {
+        timeoutMs: GIT_TIMEOUT,
+    });
+    return r.code === 0;
+}
+export async function revParse(repo, ref) {
+    return git(repo, ["rev-parse", "--verify", "--quiet", ref]);
+}
+export async function originUrl(repo) {
+    return git(repo, ["remote", "get-url", "origin"]);
+}
+export async function isAncestor(repo, maybeAncestor, descendant) {
+    const r = await run("git", ["-C", repo, "merge-base", "--is-ancestor", maybeAncestor, descendant], { timeoutMs: GIT_TIMEOUT });
+    return r.code === 0;
+}
+/** Commits on `branch` that are not reachable from `base`. */
+export async function commitsNotIn(repo, base, branch) {
+    return runLines("git", ["-C", repo, "rev-list", `${base}..${branch}`], { timeoutMs: GIT_TIMEOUT });
+}
+export async function localBranches(repo) {
+    const lines = await runLines("git", ["-C", repo, "for-each-ref", "--format=%(refname:short)%09%(objectname)%09%(upstream:short)", "refs/heads/"], { timeoutMs: GIT_TIMEOUT });
+    const out = [];
+    for (const line of lines) {
+        const [name, head, upstream] = line.split("\t");
+        if (!name || !head)
+            continue;
+        out.push({ name, head, upstream: upstream && upstream !== "" ? upstream : null });
+    }
+    return out;
+}
+/** Uncommitted changes, including untracked files but not ignored ones. */
+export async function dirtyState(worktreePath) {
+    const out = await git(worktreePath, ["status", "--porcelain", "--untracked-files=normal"]);
+    if (out === null)
+        return { dirty: false, sample: [], count: 0 };
+    const lines = out.split("\n").filter((l) => l.trim() !== "");
+    return { dirty: lines.length > 0, sample: lines.slice(0, 5), count: lines.length };
+}
+export async function untrackedFiles(worktreePath) {
+    return runLines("git", ["-C", worktreePath, "ls-files", "--others", "--exclude-standard"], { timeoutMs: GIT_TIMEOUT });
+}
+/** Seconds-precision commit time of a ref, as epoch ms. */
+export async function commitTime(repo, ref) {
+    const out = await git(repo, ["log", "-1", "--format=%ct", ref]);
+    if (!out)
+        return null;
+    const n = Number(out);
+    return Number.isFinite(n) ? n * 1000 : null;
+}
+export async function removeWorktree(repo, worktreePath, force) {
+    const args = ["-C", repo, "worktree", "remove"];
+    if (force)
+        args.push("--force");
+    args.push(worktreePath);
+    const r = await run("git", args, { timeoutMs: 120_000 });
+    if (r.code === 0)
+        return { ok: true, method: "git" };
+    return { ok: false, method: "none", error: (r.stderr || r.stdout).trim() };
+}
+export async function deleteBranch(repo, branch, force = true) {
+    const r = await run("git", ["-C", repo, "branch", force ? "-D" : "-d", branch], {
+        timeoutMs: GIT_TIMEOUT,
+    });
+    return r.code === 0;
+}
+export async function remotePrune(repo, remote = "origin") {
+    const r = await run("git", ["-C", repo, "remote", "prune", remote], { timeoutMs: 60_000 });
+    return r.code === 0;
+}
+export async function createBundle(repo, destFile, revs) {
+    if (revs.length === 0)
+        return false;
+    const r = await run("git", ["-C", repo, "bundle", "create", destFile, ...revs], {
+        timeoutMs: 180_000,
+    });
+    return r.code === 0;
+}
+/** `git diff HEAD --binary` for a worktree, or null when there is nothing to save. */
+export async function diffAgainstHead(worktreePath) {
+    const r = await run("git", ["-C", worktreePath, "diff", "HEAD", "--binary"], {
+        timeoutMs: 120_000,
+    });
+    if (r.code !== 0)
+        return null;
+    return r.stdout.trim() === "" ? null : r.stdout;
+}
+export async function gitVersion() {
+    const out = await runOk("git", ["--version"], { timeoutMs: 10_000 });
+    return out ? out.replace(/^git version\s*/, "") : null;
+}
+//# sourceMappingURL=git.js.map

package/dist/core/git.js.map

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

package/dist/core/plan.d.ts

@@ -0,0 +1,75 @@
+import type { Config } from "./config.js";
+import type { MergeStatus, Policy, Verdict } from "./decide.js";
+import type { Forge, PrIndex } from "./forge.js";
+import type { ActivityHit } from "./sessions.js";
+import type { Logger } from "../util/log.js";
+export interface WorktreeCandidate {
+    repo: string;
+    repoName: string;
+    path: string;
+    branch: string | null;
+    head: string | null;
+    sizeKb: number | null;
+    verdict: Verdict;
+    merge: MergeStatus;
+    activity: ActivityHit | null;
+    lastTouched: number;
+    dirty: boolean;
+    dirtyCount: number;
+}
+export interface BranchCandidate {
+    repo: string;
+    repoName: string;
+    name: string;
+    head: string;
+    verdict: Verdict;
+    merge: MergeStatus;
+}
+export interface RepoPlan {
+    repo: string;
+    name: string;
+    defaultBranch: string;
+    forgeAvailable: boolean;
+    worktrees: WorktreeCandidate[];
+    branches: BranchCandidate[];
+    /** Set when the repo was skipped entirely (opted out, unreadable). */
+    skipped: string | null;
+}
+export interface PlanSummary {
+    repos: number;
+    worktreesScanned: number;
+    worktreesReclaimable: number;
+    worktreesKept: number;
+    branchesDeletable: number;
+    reclaimKb: number;
+}
+export interface Plan {
+    version: 1;
+    generatedAt: string;
+    now: number;
+    roots: string[];
+    repos: RepoPlan[];
+    summary: PlanSummary;
+    warnings: string[];
+}
+export interface PlanOptions {
+    config: Config;
+    repos: string[];
+    forge: Forge;
+    logger?: Logger;
+    now?: number;
+    cwd?: string;
+    force?: boolean;
+    /** Measure every worktree, not just the ones being reclaimed. */
+    allSizes?: boolean;
+    /** Plan branch deletions only, leaving every worktree in place. */
+    skipWorktrees?: boolean;
+}
+export declare function policyFromConfig(cfg: Config, force?: boolean): Policy;
+export declare function buildPlan(opts: PlanOptions): Promise<Plan>;
+export declare function mergeStatus(repo: string, branch: string, tip: string | null, bases: string[], prIndex: PrIndex | null): Promise<MergeStatus>;
+export declare function isProtectedBranch(cfg: Config, branch: string): boolean;
+export declare function isProtectedPath(cfg: Config, path: string): boolean;
+/** Every worktree the plan would remove, flattened. */
+export declare function reclaimable(plan: Plan): WorktreeCandidate[];
+//# sourceMappingURL=plan.d.ts.map

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

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