@yoavsh/treekeeper 0.0.0-stage → 0.1.0

package/dist/core/config.js

@@ -0,0 +1,261 @@
+import { readFile } from "node:fs/promises";
+import { join } from "node:path";
+import { expandPath, treekeeperHome } from "../util/paths.js";
+import { parseDuration } from "../util/time.js";
+export const CONFIG_FILENAME = "config.json";
+export const REPO_CONFIG_FILENAME = ".treekeeper.json";
+export function defaultConfig() {
+    const home = treekeeperHome();
+    return {
+        roots: ["~/src"],
+        maxDepth: 3,
+        minAge: "30m",
+        closedPrGrace: "7d",
+        onDirty: "archive",
+        onClosedPr: "archive",
+        onExtraCommits: "keep",
+        protectBranches: ["main", "master", "trunk", "develop", "dev", "release/*"],
+        protectPaths: [],
+        pruneBranches: true,
+        pruneRemotes: false,
+        forge: "github",
+        forgeCacheTtl: "10m",
+        interval: "15m",
+        sessions: {
+            grace: "20m",
+            detectors: ["claude-code", "codex", "aider", "process", "mtime"],
+            extraPaths: [],
+            commands: [],
+        },
+        archive: {
+            enabled: true,
+            dir: join(home, "archive"),
+            retention: "14d",
+            maxUntrackedBytes: 64 * 1024 * 1024,
+        },
+        logFile: join(home, "treekeeper.log"),
+        logLevel: "info",
+        enabled: true,
+    };
+}
+export function globalConfigPath() {
+    const override = process.env.TREEKEEPER_CONFIG;
+    if (override && override.trim() !== "")
+        return expandPath(override);
+    return join(treekeeperHome(), CONFIG_FILENAME);
+}
+/** Load the user-level config, falling back to defaults when absent. */
+export async function loadConfig(path = globalConfigPath()) {
+    const base = defaultConfig();
+    const warnings = [];
+    const sources = [];
+    const raw = await readJsonIfPresent(path, warnings);
+    if (raw !== null) {
+        sources.push(path);
+        mergeInto(base, raw, warnings, path);
+    }
+    normalize(base, warnings);
+    return { config: base, sources, warnings };
+}
+/** Layer a repo-local `.treekeeper.json` on top of an already-loaded config. */
+export async function loadRepoConfig(repoPath, parent) {
+    const path = join(repoPath, REPO_CONFIG_FILENAME);
+    const warnings = [];
+    const raw = await readJsonIfPresent(path, warnings);
+    if (raw === null)
+        return { config: parent, sources: [], warnings };
+    const merged = structuredClone(parent);
+    mergeInto(merged, raw, warnings, path);
+    normalize(merged, warnings);
+    return { config: merged, sources: [path], warnings };
+}
+async function readJsonIfPresent(path, warnings) {
+    let text;
+    try {
+        text = await readFile(path, "utf8");
+    }
+    catch (err) {
+        const code = err.code;
+        if (code !== "ENOENT" && code !== "ENOTDIR") {
+            warnings.push(`could not read ${path}: ${err.message}`);
+        }
+        return null;
+    }
+    // Tolerate `//` and `/* */` comments and trailing commas — these files get
+    // hand-edited, and a strict parser turns a comment into a crashed daemon.
+    const stripped = text
+        .replace(/\/\*[\s\S]*?\*\//g, "")
+        .replace(/(^|[^:"'\\])\/\/.*$/gm, "$1")
+        .replace(/,(\s*[}\]])/g, "$1");
+    try {
+        const parsed = JSON.parse(stripped);
+        if (parsed === null || typeof parsed !== "object" || Array.isArray(parsed)) {
+            warnings.push(`${path}: expected a JSON object, ignoring`);
+            return null;
+        }
+        return parsed;
+    }
+    catch (err) {
+        warnings.push(`${path}: invalid JSON (${err.message}), ignoring`);
+        return null;
+    }
+}
+const KNOWN_KEYS = new Set([
+    "roots", "maxDepth", "minAge", "closedPrGrace", "onDirty", "onClosedPr",
+    "onExtraCommits", "protectBranches", "protectPaths", "pruneBranches",
+    "pruneRemotes", "forge", "forgeCacheTtl", "interval", "sessions", "archive",
+    "logFile", "logLevel", "enabled", "$schema",
+]);
+function mergeInto(target, raw, warnings, source) {
+    for (const key of Object.keys(raw)) {
+        if (!KNOWN_KEYS.has(key))
+            warnings.push(`${source}: unknown option "${key}"`);
+    }
+    strArray(raw, "roots", warnings, source, (v) => (target.roots = v));
+    num(raw, "maxDepth", warnings, source, (v) => (target.maxDepth = v));
+    dur(raw, "minAge", warnings, source, (v) => (target.minAge = v));
+    dur(raw, "closedPrGrace", warnings, source, (v) => (target.closedPrGrace = v));
+    enumOf(raw, "onDirty", ["archive", "keep"], warnings, source, (v) => (target.onDirty = v));
+    enumOf(raw, "onClosedPr", ["archive", "keep"], warnings, source, (v) => (target.onClosedPr = v));
+    enumOf(raw, "onExtraCommits", ["archive", "keep"], warnings, source, (v) => (target.onExtraCommits = v));
+    strArray(raw, "protectBranches", warnings, source, (v) => (target.protectBranches = v));
+    strArray(raw, "protectPaths", warnings, source, (v) => (target.protectPaths = v));
+    bool(raw, "pruneBranches", warnings, source, (v) => (target.pruneBranches = v));
+    bool(raw, "pruneRemotes", warnings, source, (v) => (target.pruneRemotes = v));
+    enumOf(raw, "forge", ["github", "none"], warnings, source, (v) => (target.forge = v));
+    dur(raw, "forgeCacheTtl", warnings, source, (v) => (target.forgeCacheTtl = v));
+    dur(raw, "interval", warnings, source, (v) => (target.interval = v));
+    str(raw, "logFile", warnings, source, (v) => (target.logFile = v));
+    enumOf(raw, "logLevel", ["debug", "info", "warn", "error"], warnings, source, (v) => (target.logLevel = v));
+    bool(raw, "enabled", warnings, source, (v) => (target.enabled = v));
+    const sessions = raw["sessions"];
+    if (sessions !== undefined) {
+        if (isObject(sessions)) {
+            dur(sessions, "grace", warnings, source, (v) => (target.sessions.grace = v));
+            strArray(sessions, "detectors", warnings, source, (v) => (target.sessions.detectors = v));
+            strArray(sessions, "extraPaths", warnings, source, (v) => (target.sessions.extraPaths = v));
+            const cmds = sessions["commands"];
+            if (cmds !== undefined) {
+                if (Array.isArray(cmds)) {
+                    const out = [];
+                    for (const c of cmds) {
+                        if (isObject(c) && typeof c["command"] === "string") {
+                            out.push({
+                                name: typeof c["name"] === "string" ? c["name"] : "custom",
+                                command: c["command"],
+                            });
+                        }
+                        else {
+                            warnings.push(`${source}: sessions.commands entries need a "command" string`);
+                        }
+                    }
+                    target.sessions.commands = out;
+                }
+                else {
+                    warnings.push(`${source}: sessions.commands must be an array`);
+                }
+            }
+        }
+        else {
+            warnings.push(`${source}: sessions must be an object`);
+        }
+    }
+    const archive = raw["archive"];
+    if (archive !== undefined) {
+        if (isObject(archive)) {
+            bool(archive, "enabled", warnings, source, (v) => (target.archive.enabled = v));
+            str(archive, "dir", warnings, source, (v) => (target.archive.dir = v));
+            dur(archive, "retention", warnings, source, (v) => (target.archive.retention = v));
+            num(archive, "maxUntrackedBytes", warnings, source, (v) => (target.archive.maxUntrackedBytes = v));
+        }
+        else {
+            warnings.push(`${source}: archive must be an object`);
+        }
+    }
+}
+function normalize(cfg, warnings) {
+    cfg.roots = cfg.roots.map((r) => expandPath(r));
+    cfg.protectPaths = cfg.protectPaths.map((p) => (p.includes("*") ? expandPath0(p) : expandPath(p)));
+    cfg.archive.dir = expandPath(cfg.archive.dir);
+    cfg.logFile = expandPath(cfg.logFile);
+    if (cfg.maxDepth < 1) {
+        warnings.push("maxDepth must be at least 1, using 1");
+        cfg.maxDepth = 1;
+    }
+    const unknownDetectors = cfg.sessions.detectors.filter((d) => !["claude-code", "codex", "aider", "process", "mtime"].includes(d));
+    for (const d of unknownDetectors)
+        warnings.push(`unknown session detector "${d}"`);
+}
+/** Expand `~` in a glob without resolving the wildcards away. */
+function expandPath0(pattern) {
+    if (pattern === "~" || pattern.startsWith("~/")) {
+        const home = expandPath("~");
+        return pattern === "~" ? home : `${home}/${pattern.slice(2)}`;
+    }
+    return pattern;
+}
+function isObject(v) {
+    return v !== null && typeof v === "object" && !Array.isArray(v);
+}
+function str(raw, key, w, src, set) {
+    const v = raw[key];
+    if (v === undefined)
+        return;
+    if (typeof v === "string")
+        set(v);
+    else
+        w.push(`${src}: ${key} must be a string`);
+}
+function num(raw, key, w, src, set) {
+    const v = raw[key];
+    if (v === undefined)
+        return;
+    if (typeof v === "number" && Number.isFinite(v))
+        set(v);
+    else
+        w.push(`${src}: ${key} must be a number`);
+}
+function bool(raw, key, w, src, set) {
+    const v = raw[key];
+    if (v === undefined)
+        return;
+    if (typeof v === "boolean")
+        set(v);
+    else
+        w.push(`${src}: ${key} must be true or false`);
+}
+function strArray(raw, key, w, src, set) {
+    const v = raw[key];
+    if (v === undefined)
+        return;
+    if (Array.isArray(v) && v.every((x) => typeof x === "string"))
+        set(v);
+    else
+        w.push(`${src}: ${key} must be an array of strings`);
+}
+function dur(raw, key, w, src, set) {
+    const v = raw[key];
+    if (v === undefined)
+        return;
+    if (typeof v !== "string" && typeof v !== "number") {
+        w.push(`${src}: ${key} must be a duration like "30m"`);
+        return;
+    }
+    try {
+        parseDuration(v);
+        set(String(v));
+    }
+    catch (err) {
+        w.push(`${src}: ${key} — ${err.message}`);
+    }
+}
+function enumOf(raw, key, allowed, w, src, set) {
+    const v = raw[key];
+    if (v === undefined)
+        return;
+    if (typeof v === "string" && allowed.includes(v))
+        set(v);
+    else
+        w.push(`${src}: ${key} must be one of ${allowed.join(", ")}`);
+}
+//# sourceMappingURL=config.js.map

package/dist/core/config.js.map

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

package/dist/core/decide.d.ts

@@ -0,0 +1,102 @@
+import type { DirtyPolicy } from "./config.js";
+import type { PrRef } from "./forge.js";
+/** How the work on a branch relates to the default branch and its pull request. */
+export type MergeStatus = {
+    kind: "merged-ancestor";
+    base: string;
+} | {
+    kind: "merged-pr";
+    pr: PrRef;
+} | {
+    kind: "merged-pr-extra";
+    pr: PrRef;
+    extra: number;
+} | {
+    kind: "closed-pr";
+    pr: PrRef;
+} | {
+    kind: "open-pr";
+    pr: PrRef;
+} | {
+    kind: "unmerged";
+    forgeAvailable: boolean;
+} | {
+    kind: "no-branch";
+};
+export type Risk = "dirty" | "closed-pr" | "extra-commits";
+export interface Verdict {
+    action: "reclaim" | "keep";
+    /** Human sentence shown in the plan and written to the log. */
+    reason: string;
+    /** Stable identifier for scripts reading `--json`. */
+    code: string;
+    /** Why this removal needs an archive first. Empty when the work is safely merged. */
+    risks: Risk[];
+}
+export interface Policy {
+    minAgeMs: number;
+    closedPrGraceMs: number;
+    onDirty: DirtyPolicy;
+    onClosedPr: DirtyPolicy;
+    onExtraCommits: DirtyPolicy;
+    /** Bypasses the age gate and the dirty / extra-commits / closed-PR holds. */
+    force: boolean;
+}
+export interface WorktreeFacts {
+    now: number;
+    isMain: boolean;
+    detached: boolean;
+    locked: boolean;
+    lockReason: string | null;
+    branch: string | null;
+    protectedBranch: boolean;
+    protectedPath: boolean;
+    /** The worktree contains the caller's working directory. */
+    isCwd: boolean;
+    merge: MergeStatus;
+    dirty: boolean;
+    dirtyCount: number;
+    /** Most recent agent/human activity, or null when nothing was detected. */
+    activity: {
+        detector: string;
+        lastActivity: number;
+        detail: string;
+    } | null;
+    activityIsRecent: boolean;
+    /** Newest mtime seen for this worktree, used for the age gate. */
+    lastTouched: number;
+    inUse: boolean;
+}
+/**
+ * Decide the fate of one worktree.
+ *
+ * Pure on purpose: every signal is gathered elsewhere, so the rules that decide
+ * whether a developer's directory gets deleted are a single readable function
+ * with a truth table in the tests.
+ *
+ * Invariant: a worktree is only ever reclaimed when its commits are reachable
+ * from the default branch, or its pull request was merged or closed. `force`
+ * does not relax that.
+ */
+export declare function decideWorktree(f: WorktreeFacts, policy: Policy): Verdict;
+export interface BranchFacts {
+    now: number;
+    name: string;
+    isDefault: boolean;
+    protectedBranch: boolean;
+    /** A worktree still has this branch checked out. */
+    hasWorktree: boolean;
+    /** This branch is the current HEAD of the main worktree. */
+    isCurrent: boolean;
+    merge: MergeStatus;
+    lastCommit: number | null;
+}
+/**
+ * Decide whether a local branch with no worktree should be deleted.
+ *
+ * Deleting a branch only drops a pointer, so this is cheaper to get wrong than
+ * a worktree — but it can still orphan commits, so unmerged branches are never
+ * touched and closed-PR branches get archived like worktrees do.
+ */
+export declare function decideBranch(f: BranchFacts, policy: Policy): Verdict;
+//# sourceMappingURL=decide.d.ts.map

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

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

package/dist/core/decide.js

@@ -0,0 +1,148 @@
+import { formatAgo, formatDuration } from "../util/time.js";
+const keep = (code, reason) => ({ action: "keep", reason, code, risks: [] });
+/**
+ * Decide the fate of one worktree.
+ *
+ * Pure on purpose: every signal is gathered elsewhere, so the rules that decide
+ * whether a developer's directory gets deleted are a single readable function
+ * with a truth table in the tests.
+ *
+ * Invariant: a worktree is only ever reclaimed when its commits are reachable
+ * from the default branch, or its pull request was merged or closed. `force`
+ * does not relax that.
+ */
+export function decideWorktree(f, policy) {
+    if (f.isMain)
+        return keep("main-worktree", "the repo's main worktree");
+    if (f.protectedPath)
+        return keep("protected-path", "matches protectPaths");
+    if (f.isCwd)
+        return keep("cwd", "your current working directory");
+    if (f.locked) {
+        return keep("locked", `locked${f.lockReason ? `: ${f.lockReason}` : ""}`);
+    }
+    if (f.detached || !f.branch)
+        return keep("detached", "detached HEAD — no branch to check");
+    if (f.protectedBranch)
+        return keep("protected-branch", `${f.branch} matches protectBranches`);
+    const risks = [];
+    let mergedReason;
+    switch (f.merge.kind) {
+        case "merged-ancestor":
+            mergedReason = `merged into ${f.merge.base}`;
+            break;
+        case "merged-pr":
+            mergedReason = `PR #${f.merge.pr.number} merged`;
+            break;
+        case "merged-pr-extra": {
+            const n = f.merge.extra;
+            const detail = `PR #${f.merge.pr.number} merged, but the local branch has ${n} commit${n === 1 ? "" : "s"} the PR never had`;
+            if (policy.onExtraCommits === "keep" && !policy.force) {
+                return keep("extra-commits", detail);
+            }
+            risks.push("extra-commits");
+            mergedReason = detail;
+            break;
+        }
+        case "closed-pr": {
+            const detail = `PR #${f.merge.pr.number} closed without merging`;
+            if (policy.onClosedPr === "keep" && !policy.force) {
+                return keep("closed-pr", `${detail} — onClosedPr is "keep"`);
+            }
+            const closedAt = f.merge.pr.closedAt;
+            if (!policy.force && closedAt !== null) {
+                const waited = f.now - closedAt;
+                if (waited < policy.closedPrGraceMs) {
+                    return keep("closed-pr-grace", `${detail} ${formatAgo(closedAt, f.now)} — holding for ${formatDuration(policy.closedPrGraceMs - waited)} more`);
+                }
+            }
+            risks.push("closed-pr");
+            mergedReason = detail;
+            break;
+        }
+        case "open-pr":
+            return keep("open-pr", `PR #${f.merge.pr.number} is still open`);
+        case "unmerged":
+            return keep("unmerged", f.merge.forgeAvailable
+                ? "not merged and has no merged pull request"
+                : "not merged (no pull-request data available)");
+        case "no-branch":
+            return keep("no-branch", "no branch to check");
+    }
+    // Work is finished. Now the "is anyone still using it" gates.
+    // A live process is checked first because it is the least ambiguous signal
+    // and deserves the clearest message.
+    if (f.inUse) {
+        return keep("in-use", `${mergedReason}, but a running process is still in it`);
+    }
+    if (f.activityIsRecent && f.activity) {
+        return keep("session-active", `${mergedReason}, but ${f.activity.detector} activity ${formatAgo(f.activity.lastActivity, f.now)}`);
+    }
+    if (!policy.force) {
+        // Clamped: file mtimes carry sub-millisecond fractions while Date.now()
+        // truncates, so a worktree touched this instant can otherwise look like it
+        // was touched in the future.
+        const age = Math.max(0, f.now - f.lastTouched);
+        if (age < policy.minAgeMs) {
+            return keep("too-young", `${mergedReason}, but touched ${formatAgo(f.lastTouched, f.now)} (minAge ${formatDuration(policy.minAgeMs)})`);
+        }
+    }
+    if (f.dirty) {
+        if (policy.onDirty === "keep" && !policy.force) {
+            return keep("dirty", `${mergedReason}, but has ${f.dirtyCount} uncommitted change${f.dirtyCount === 1 ? "" : "s"}`);
+        }
+        risks.push("dirty");
+    }
+    return {
+        action: "reclaim",
+        reason: mergedReason,
+        code: f.merge.kind,
+        risks,
+    };
+}
+/**
+ * Decide whether a local branch with no worktree should be deleted.
+ *
+ * Deleting a branch only drops a pointer, so this is cheaper to get wrong than
+ * a worktree — but it can still orphan commits, so unmerged branches are never
+ * touched and closed-PR branches get archived like worktrees do.
+ */
+export function decideBranch(f, policy) {
+    if (f.isDefault)
+        return keep("default-branch", "the default branch");
+    if (f.isCurrent)
+        return keep("current-branch", "currently checked out");
+    if (f.protectedBranch)
+        return keep("protected-branch", "matches protectBranches");
+    if (f.hasWorktree)
+        return keep("has-worktree", "still checked out in a worktree");
+    switch (f.merge.kind) {
+        case "merged-ancestor":
+            return { action: "reclaim", reason: `merged into ${f.merge.base}`, code: f.merge.kind, risks: [] };
+        case "merged-pr":
+            return { action: "reclaim", reason: `PR #${f.merge.pr.number} merged`, code: f.merge.kind, risks: [] };
+        case "merged-pr-extra": {
+            const detail = `PR #${f.merge.pr.number} merged, local tip has ${f.merge.extra} extra commit(s)`;
+            if (policy.onExtraCommits === "keep" && !policy.force)
+                return keep("extra-commits", detail);
+            return { action: "reclaim", reason: detail, code: f.merge.kind, risks: ["extra-commits"] };
+        }
+        case "closed-pr": {
+            const detail = `PR #${f.merge.pr.number} closed without merging`;
+            if (policy.onClosedPr === "keep" && !policy.force)
+                return keep("closed-pr", detail);
+            const closedAt = f.merge.pr.closedAt;
+            if (!policy.force && closedAt !== null && f.now - closedAt < policy.closedPrGraceMs) {
+                return keep("closed-pr-grace", `${detail} ${formatAgo(closedAt, f.now)} — still in the grace window`);
+            }
+            return { action: "reclaim", reason: detail, code: f.merge.kind, risks: ["closed-pr"] };
+        }
+        case "open-pr":
+            return keep("open-pr", `PR #${f.merge.pr.number} is still open`);
+        case "unmerged":
+            return keep("unmerged", "not merged");
+        case "no-branch":
+            return keep("no-branch", "no branch");
+    }
+}
+//# sourceMappingURL=decide.js.map

package/dist/core/decide.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"decide.js","sourceRoot":"","sources":["../../src/core/decide.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,SAAS,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAwD5D,MAAM,IAAI,GAAG,CAAC,IAAY,EAAE,MAAc,EAAW,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC,CAAC;AAEtG;;;;;;;;;;GAUG;AACH,MAAM,UAAU,cAAc,CAAC,CAAgB,EAAE,MAAc;IAC7D,IAAI,CAAC,CAAC,MAAM;QAAE,OAAO,IAAI,CAAC,eAAe,EAAE,0BAA0B,CAAC,CAAC;IACvE,IAAI,CAAC,CAAC,aAAa;QAAE,OAAO,IAAI,CAAC,gBAAgB,EAAE,sBAAsB,CAAC,CAAC;IAC3E,IAAI,CAAC,CAAC,KAAK;QAAE,OAAO,IAAI,CAAC,KAAK,EAAE,gCAAgC,CAAC,CAAC;IAClE,IAAI,CAAC,CAAC,MAAM,EAAE,CAAC;QACb,OAAO,IAAI,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IAC5E,CAAC;IACD,IAAI,CAAC,CAAC,QAAQ,IAAI,CAAC,CAAC,CAAC,MAAM;QAAE,OAAO,IAAI,CAAC,UAAU,EAAE,oCAAoC,CAAC,CAAC;IAC3F,IAAI,CAAC,CAAC,eAAe;QAAE,OAAO,IAAI,CAAC,kBAAkB,EAAE,GAAG,CAAC,CAAC,MAAM,0BAA0B,CAAC,CAAC;IAE9F,MAAM,KAAK,GAAW,EAAE,CAAC;IACzB,IAAI,YAAoB,CAAC;IAEzB,QAAQ,CAAC,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC;QACrB,KAAK,iBAAiB;YACpB,YAAY,GAAG,eAAe,CAAC,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC;YAC7C,MAAM;QACR,KAAK,WAAW;YACd,YAAY,GAAG,OAAO,CAAC,CAAC,KAAK,CAAC,EAAE,CAAC,MAAM,SAAS,CAAC;YACjD,MAAM;QACR,KAAK,iBAAiB,CAAC,CAAC,CAAC;YACvB,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC;YACxB,MAAM,MAAM,GAAG,OAAO,CAAC,CAAC,KAAK,CAAC,EAAE,CAAC,MAAM,qCAAqC,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,mBAAmB,CAAC;YAC7H,IAAI,MAAM,CAAC,cAAc,KAAK,MAAM,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;gBACtD,OAAO,IAAI,CAAC,eAAe,EAAE,MAAM,CAAC,CAAC;YACvC,CAAC;YACD,KAAK,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;YAC5B,YAAY,GAAG,MAAM,CAAC;YACtB,MAAM;QACR,CAAC;QACD,KAAK,WAAW,CAAC,CAAC,CAAC;YACjB,MAAM,MAAM,GAAG,OAAO,CAAC,CAAC,KAAK,CAAC,EAAE,CAAC,MAAM,yBAAyB,CAAC;YACjE,IAAI,MAAM,CAAC,UAAU,KAAK,MAAM,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;gBAClD,OAAO,IAAI,CAAC,WAAW,EAAE,GAAG,MAAM,yBAAyB,CAAC,CAAC;YAC/D,CAAC;YACD,MAAM,QAAQ,GAAG,CAAC,CAAC,KAAK,CAAC,EAAE,CAAC,QAAQ,CAAC;YACrC,IAAI,CAAC,MAAM,CAAC,KAAK,IAAI,QAAQ,KAAK,IAAI,EAAE,CAAC;gBACvC,MAAM,MAAM,GAAG,CAAC,CAAC,GAAG,GAAG,QAAQ,CAAC;gBAChC,IAAI,MAAM,GAAG,MAAM,CAAC,eAAe,EAAE,CAAC;oBACpC,OAAO,IAAI,CACT,iBAAiB,EACjB,GAAG,MAAM,IAAI,SAAS,CAAC,QAAQ,EAAE,CAAC,CAAC,GAAG,CAAC,kBAAkB,cAAc,CAAC,MAAM,CAAC,eAAe,GAAG,MAAM,CAAC,OAAO,CAChH,CAAC;gBACJ,CAAC;YACH,CAAC;YACD,KAAK,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;YACxB,YAAY,GAAG,MAAM,CAAC;YACtB,MAAM;QACR,CAAC;QACD,KAAK,SAAS;YACZ,OAAO,IAAI,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC,KAAK,CAAC,EAAE,CAAC,MAAM,gBAAgB,CAAC,CAAC;QACnE,KAAK,UAAU;YACb,OAAO,IAAI,CACT,UAAU,EACV,CAAC,CAAC,KAAK,CAAC,cAAc;gBACpB,CAAC,CAAC,2CAA2C;gBAC7C,CAAC,CAAC,6CAA6C,CAClD,CAAC;QACJ,KAAK,WAAW;YACd,OAAO,IAAI,CAAC,WAAW,EAAE,oBAAoB,CAAC,CAAC;IACnD,CAAC;IAED,8DAA8D;IAC9D,2EAA2E;IAC3E,qCAAqC;IACrC,IAAI,CAAC,CAAC,KAAK,EAAE,CAAC;QACZ,OAAO,IAAI,CAAC,QAAQ,EAAE,GAAG,YAAY,wCAAwC,CAAC,CAAC;IACjF,CAAC;IACD,IAAI,CAAC,CAAC,gBAAgB,IAAI,CAAC,CAAC,QAAQ,EAAE,CAAC;QACrC,OAAO,IAAI,CACT,gBAAgB,EAChB,GAAG,YAAY,SAAS,CAAC,CAAC,QAAQ,CAAC,QAAQ,aAAa,SAAS,CAAC,CAAC,CAAC,QAAQ,CAAC,YAAY,EAAE,CAAC,CAAC,GAAG,CAAC,EAAE,CACpG,CAAC;IACJ,CAAC;IAED,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;QAClB,wEAAwE;QACxE,2EAA2E;QAC3E,6BAA6B;QAC7B,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC,WAAW,CAAC,CAAC;QAC/C,IAAI,GAAG,GAAG,MAAM,CAAC,QAAQ,EAAE,CAAC;YAC1B,OAAO,IAAI,CACT,WAAW,EACX,GAAG,YAAY,iBAAiB,SAAS,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC,GAAG,CAAC,YAAY,cAAc,CAAC,MAAM,CAAC,QAAQ,CAAC,GAAG,CAC9G,CAAC;QACJ,CAAC;IACH,CAAC;IAED,IAAI,CAAC,CAAC,KAAK,EAAE,CAAC;QACZ,IAAI,MAAM,CAAC,OAAO,KAAK,MAAM,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;YAC/C,OAAO,IAAI,CACT,OAAO,EACP,GAAG,YAAY,aAAa,CAAC,CAAC,UAAU,sBAAsB,CAAC,CAAC,UAAU,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,EAAE,CAC9F,CAAC;QACJ,CAAC;QACD,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACtB,CAAC;IAED,OAAO;QACL,MAAM,EAAE,SAAS;QACjB,MAAM,EAAE,YAAY;QACpB,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,IAAI;QAClB,KAAK;KACN,CAAC;AACJ,CAAC;AAeD;;;;;;GAMG;AACH,MAAM,UAAU,YAAY,CAAC,CAAc,EAAE,MAAc;IACzD,IAAI,CAAC,CAAC,SAAS;QAAE,OAAO,IAAI,CAAC,gBAAgB,EAAE,oBAAoB,CAAC,CAAC;IACrE,IAAI,CAAC,CAAC,SAAS;QAAE,OAAO,IAAI,CAAC,gBAAgB,EAAE,uBAAuB,CAAC,CAAC;IACxE,IAAI,CAAC,CAAC,eAAe;QAAE,OAAO,IAAI,CAAC,kBAAkB,EAAE,yBAAyB,CAAC,CAAC;IAClF,IAAI,CAAC,CAAC,WAAW;QAAE,OAAO,IAAI,CAAC,cAAc,EAAE,iCAAiC,CAAC,CAAC;IAElF,QAAQ,CAAC,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC;QACrB,KAAK,iBAAiB;YACpB,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,eAAe,CAAC,CAAC,KAAK,CAAC,IAAI,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC;QACrG,KAAK,WAAW;YACd,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC,KAAK,CAAC,EAAE,CAAC,MAAM,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC;QACzG,KAAK,iBAAiB,CAAC,CAAC,CAAC;YACvB,MAAM,MAAM,GAAG,OAAO,CAAC,CAAC,KAAK,CAAC,EAAE,CAAC,MAAM,0BAA0B,CAAC,CAAC,KAAK,CAAC,KAAK,kBAAkB,CAAC;YACjG,IAAI,MAAM,CAAC,cAAc,KAAK,MAAM,IAAI,CAAC,MAAM,CAAC,KAAK;gBAAE,OAAO,IAAI,CAAC,eAAe,EAAE,MAAM,CAAC,CAAC;YAC5F,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,EAAE,CAAC,eAAe,CAAC,EAAE,CAAC;QAC7F,CAAC;QACD,KAAK,WAAW,CAAC,CAAC,CAAC;YACjB,MAAM,MAAM,GAAG,OAAO,CAAC,CAAC,KAAK,CAAC,EAAE,CAAC,MAAM,yBAAyB,CAAC;YACjE,IAAI,MAAM,CAAC,UAAU,KAAK,MAAM,IAAI,CAAC,MAAM,CAAC,KAAK;gBAAE,OAAO,IAAI,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC;YACpF,MAAM,QAAQ,GAAG,CAAC,CAAC,KAAK,CAAC,EAAE,CAAC,QAAQ,CAAC;YACrC,IAAI,CAAC,MAAM,CAAC,KAAK,IAAI,QAAQ,KAAK,IAAI,IAAI,CAAC,CAAC,GAAG,GAAG,QAAQ,GAAG,MAAM,CAAC,eAAe,EAAE,CAAC;gBACpF,OAAO,IAAI,CAAC,iBAAiB,EAAE,GAAG,MAAM,IAAI,SAAS,CAAC,QAAQ,EAAE,CAAC,CAAC,GAAG,CAAC,8BAA8B,CAAC,CAAC;YACxG,CAAC;YACD,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,EAAE,CAAC,WAAW,CAAC,EAAE,CAAC;QACzF,CAAC;QACD,KAAK,SAAS;YACZ,OAAO,IAAI,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC,KAAK,CAAC,EAAE,CAAC,MAAM,gBAAgB,CAAC,CAAC;QACnE,KAAK,UAAU;YACb,OAAO,IAAI,CAAC,UAAU,EAAE,YAAY,CAAC,CAAC;QACxC,KAAK,WAAW;YACd,OAAO,IAAI,CAAC,WAAW,EAAE,WAAW,CAAC,CAAC;IAC1C,CAAC;AACH,CAAC"}

package/dist/core/forge.d.ts

@@ -0,0 +1,39 @@
+import type { Logger } from "../util/log.js";
+export type PrState = "OPEN" | "MERGED" | "CLOSED";
+export interface PrRef {
+    number: number;
+    state: PrState;
+    headRefName: string;
+    headRefOid: string;
+    mergedAt: number | null;
+    closedAt: number | null;
+    url: string;
+    title: string;
+}
+/** Pull requests for a repo, keyed by head branch name. */
+export type PrIndex = Map<string, PrRef[]>;
+export interface Forge {
+    readonly kind: string;
+    /**
+     * `null` means "no information available" (no remote, no CLI, offline) which
+     * callers must treat as "unknown", never as "no PR exists".
+     */
+    lookup(repo: string): Promise<PrIndex | null>;
+    readonly unavailableReason: string | null;
+}
+export interface ForgeOptions {
+    kind: "github" | "none";
+    cacheTtl: string;
+    logger?: Logger;
+    /** Ignore cached answers (used by `--refresh`). */
+    refresh?: boolean;
+    limit?: number;
+}
+export declare function createForge(opts: ForgeOptions): Forge;
+/**
+ * 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 declare function selectPr(prs: readonly PrRef[] | undefined, localTip: string | null): PrRef | null;
+//# sourceMappingURL=forge.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"forge.d.ts","sourceRoot":"","sources":["../../src/core/forge.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAC;AAM7C,MAAM,MAAM,OAAO,GAAG,MAAM,GAAG,QAAQ,GAAG,QAAQ,CAAC;AAEnD,MAAM,WAAW,KAAK;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,OAAO,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;CACf;AAED,2DAA2D;AAC3D,MAAM,MAAM,OAAO,GAAG,GAAG,CAAC,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC;AAE3C,MAAM,WAAW,KAAK;IACpB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB;;;OAGG;IACH,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC,CAAC;IAC9C,QAAQ,CAAC,iBAAiB,EAAE,MAAM,GAAG,IAAI,CAAC;CAC3C;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,QAAQ,GAAG,MAAM,CAAC;IACxB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,mDAAmD;IACnD,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,wBAAgB,WAAW,CAAC,IAAI,EAAE,YAAY,GAAG,KAAK,CAKrD;AAuHD;;;;GAIG;AACH,wBAAgB,QAAQ,CAAC,GAAG,EAAE,SAAS,KAAK,EAAE,GAAG,SAAS,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI,GAAG,KAAK,GAAG,IAAI,CAWjG"}