@yoavsh/treekeeper 0.0.0-stage → 0.1.0

package/dist/core/apply.js

@@ -0,0 +1,223 @@
+import { stat } from "node:fs/promises";
+import { loadRepoConfig } from "./config.js";
+import { archiveWork, pruneArchives } from "./archive.js";
+import * as git from "./git.js";
+import { parseDuration } from "../util/time.js";
+/**
+ * Carry out a plan.
+ *
+ * Each worktree is re-checked immediately before removal, because a plan is a
+ * snapshot: with a daemon, minutes can pass between deciding and acting, and in
+ * that time an agent may have started working in the directory again.
+ */
+export async function applyPlan(opts) {
+    const { plan, logger } = opts;
+    const result = {
+        removedWorktrees: [],
+        deletedBranches: [],
+        reclaimedKb: 0,
+        archives: [],
+        failures: [],
+        prunedArchives: [],
+    };
+    for (const repoPlan of plan.repos) {
+        if (repoPlan.skipped)
+            continue;
+        const { config: cfg } = await loadRepoConfig(repoPlan.repo, opts.config);
+        const base = await preferredBase(repoPlan.repo, repoPlan.defaultBranch);
+        for (const candidate of repoPlan.worktrees) {
+            if (candidate.verdict.action !== "reclaim")
+                continue;
+            await removeWorktree(candidate, { cfg, base, result, logger, opts });
+        }
+        for (const branch of repoPlan.branches) {
+            await deleteBranch(branch, { cfg, base, result, logger });
+        }
+        await git.pruneWorktrees(repoPlan.repo);
+        if (cfg.pruneRemotes)
+            await git.remotePrune(repoPlan.repo);
+    }
+    if (opts.config.archive.enabled) {
+        const pruned = await pruneArchives(opts.config.archive.dir, parseDuration(opts.config.archive.retention), plan.now);
+        result.prunedArchives = pruned.removed;
+        if (pruned.removed.length > 0) {
+            logger.event("archive-pruned", { count: pruned.removed.length, freedKb: pruned.freedKb });
+        }
+    }
+    return result;
+}
+async function removeWorktree(c, ctx) {
+    const { logger, result } = ctx;
+    if (!(ctx.opts?.skipReverify ?? false)) {
+        const problem = await reverify(c);
+        if (problem) {
+            logger.warn(`skipping ${c.path}: ${problem}`);
+            logger.event("skip", { path: c.path, branch: c.branch, stage: "reverify", reason: problem });
+            result.failures.push({ target: c.path, stage: "reverify", message: problem });
+            return;
+        }
+    }
+    let archive = null;
+    try {
+        archive = await archiveWork({
+            repo: c.repo,
+            worktreePath: c.path,
+            branch: c.branch,
+            head: c.head,
+            reason: c.verdict.reason,
+            risks: c.verdict.risks,
+            merge: c.merge,
+            base: ctx.base,
+            config: ctx.cfg.archive,
+            logger,
+        });
+    }
+    catch (err) {
+        const message = err.message;
+        // Never remove work we failed to back up.
+        logger.error(`archive failed for ${c.path}, keeping it: ${message}`);
+        result.failures.push({ target: c.path, stage: "archive", message });
+        return;
+    }
+    if (archive)
+        result.archives.push(archive);
+    const archived = archive !== null;
+    let removal = await git.removeWorktree(c.repo, c.path, false);
+    if (!removal.ok && (archived || ctx.opts?.force)) {
+        removal = await git.removeWorktree(c.repo, c.path, true);
+    }
+    if (!removal.ok) {
+        const message = removal.error ?? "git worktree remove failed";
+        logger.error(`could not remove ${c.path}: ${message}`);
+        result.failures.push({ target: c.path, stage: "remove", message });
+        return;
+    }
+    const sizeKb = c.sizeKb ?? 0;
+    result.removedWorktrees.push({
+        path: c.path,
+        branch: c.branch,
+        repo: c.repo,
+        sizeKb,
+        reason: c.verdict.reason,
+        archive: archive?.dir ?? null,
+    });
+    result.reclaimedKb += sizeKb;
+    logger.event("reclaim", {
+        path: c.path,
+        repo: c.repo,
+        branch: c.branch,
+        sizeKb,
+        reason: c.verdict.reason,
+        risks: c.verdict.risks,
+        archive: archive?.dir ?? null,
+    });
+    if (c.branch) {
+        const ok = await git.deleteBranch(c.repo, c.branch, true);
+        if (ok) {
+            result.deletedBranches.push({
+                repo: c.repo,
+                name: c.branch,
+                reason: c.verdict.reason,
+                archive: archive?.dir ?? null,
+            });
+        }
+        else {
+            logger.warn(`removed ${c.path} but could not delete branch ${c.branch}`);
+            result.failures.push({
+                target: `${c.repo}#${c.branch}`,
+                stage: "branch",
+                message: "git branch -D failed",
+            });
+        }
+    }
+}
+async function deleteBranch(b, ctx) {
+    const { logger, result } = ctx;
+    // The tip may have moved since the plan was built.
+    const tip = await git.revParse(b.repo, `refs/heads/${b.name}`);
+    if (tip !== b.head) {
+        const message = "branch tip moved since the plan was built";
+        logger.warn(`skipping branch ${b.name}: ${message}`);
+        result.failures.push({ target: `${b.repo}#${b.name}`, stage: "reverify", message });
+        return;
+    }
+    let archive = null;
+    if (b.verdict.risks.length > 0) {
+        archive = await archiveWork({
+            repo: b.repo,
+            worktreePath: null,
+            branch: b.name,
+            head: b.head,
+            reason: b.verdict.reason,
+            risks: b.verdict.risks,
+            merge: b.merge,
+            base: ctx.base,
+            config: ctx.cfg.archive,
+            logger,
+        });
+        if (archive)
+            result.archives.push(archive);
+    }
+    if (await git.deleteBranch(b.repo, b.name, true)) {
+        result.deletedBranches.push({
+            repo: b.repo,
+            name: b.name,
+            reason: b.verdict.reason,
+            archive: archive?.dir ?? null,
+        });
+        logger.event("branch-delete", {
+            repo: b.repo,
+            branch: b.name,
+            reason: b.verdict.reason,
+            archive: archive?.dir ?? null,
+        });
+    }
+    else {
+        result.failures.push({
+            target: `${b.repo}#${b.name}`,
+            stage: "branch",
+            message: "git branch -D failed",
+        });
+    }
+}
+/**
+ * Confirm the worktree is still exactly what the plan described. Anything that
+ * moved — a new commit, a switched branch, a fresh file — means the snapshot is
+ * stale and the worktree is left alone until the next sweep.
+ */
+async function reverify(c) {
+    try {
+        const st = await stat(c.path);
+        if (!st.isDirectory())
+            return "no longer a directory";
+        if (st.mtimeMs > c.lastTouched + 1_000)
+            return "directory changed since the plan was built";
+    }
+    catch {
+        return "directory no longer exists";
+    }
+    const worktrees = await git.listWorktrees(c.repo);
+    const current = worktrees.find((w) => w.path === c.path);
+    if (!current)
+        return "no longer a registered worktree";
+    if (current.branch !== c.branch)
+        return `branch changed to ${current.branch ?? "(detached)"}`;
+    if (current.head !== c.head)
+        return "new commits since the plan was built";
+    if (current.locked)
+        return "worktree was locked";
+    if (!c.dirty) {
+        const dirty = await git.dirtyState(c.path);
+        if (dirty.dirty)
+            return "uncommitted changes appeared since the plan was built";
+    }
+    return null;
+}
+async function preferredBase(repo, defaultBranch) {
+    for (const ref of [`refs/remotes/origin/${defaultBranch}`, `refs/heads/${defaultBranch}`]) {
+        if (await git.refExists(repo, ref))
+            return ref;
+    }
+    return null;
+}
+//# sourceMappingURL=apply.js.map

package/dist/core/apply.js.map

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

package/dist/core/archive.d.ts

@@ -0,0 +1,69 @@
+import type { ArchiveConfig } from "./config.js";
+import type { MergeStatus, Risk } from "./decide.js";
+import type { Logger } from "../util/log.js";
+export interface ArchiveRecord {
+    version: 1;
+    id: string;
+    dir: string;
+    createdAt: string;
+    repo: string;
+    repoName: string;
+    worktree: string | null;
+    branch: string | null;
+    head: string | null;
+    reason: string;
+    risks: Risk[];
+    pr: {
+        number: number;
+        url: string;
+        state: string;
+    } | null;
+    /** Commits that were not reachable from the default branch. */
+    bundle: {
+        file: string;
+        commits: number;
+        revRange: string;
+    } | null;
+    /** Uncommitted tracked changes. */
+    patch: {
+        file: string;
+        bytes: number;
+    } | null;
+    untracked: {
+        count: number;
+        bytes: number;
+        file: string | null;
+        truncated: boolean;
+    } | null;
+}
+export interface ArchiveInput {
+    repo: string;
+    worktreePath: string | null;
+    branch: string | null;
+    head: string | null;
+    reason: string;
+    risks: Risk[];
+    merge: MergeStatus;
+    /** Base ref to diff history against, e.g. `refs/remotes/origin/main`. */
+    base: string | null;
+    config: ArchiveConfig;
+    logger?: Logger;
+    now?: number;
+}
+/**
+ * Save everything that would be lost, *before* anything is removed.
+ *
+ * A cleanly merged worktree has nothing unique in it, so only a small metadata
+ * record is written. Anything with unmerged commits, uncommitted changes or
+ * untracked files gets a bundle, a patch and a tarball — which is what makes
+ * an unattended daemon a reasonable thing to run.
+ */
+export declare function archiveWork(input: ArchiveInput): Promise<ArchiveRecord | null>;
+export declare function listArchives(dir: string): Promise<ArchiveRecord[]>;
+export interface PruneResult {
+    removed: string[];
+    freedKb: number;
+}
+/** Delete archives older than the retention window. */
+export declare function pruneArchives(dir: string, retentionMs: number, now?: number): Promise<PruneResult>;
+//# sourceMappingURL=archive.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"archive.d.ts","sourceRoot":"","sources":["../../src/core/archive.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AACjD,OAAO,KAAK,EAAE,WAAW,EAAE,IAAI,EAAE,MAAM,aAAa,CAAC;AAIrD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAC;AAI7C,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,CAAC,CAAC;IACX,EAAE,EAAE,MAAM,CAAC;IACX,GAAG,EAAE,MAAM,CAAC;IACZ,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,IAAI,EAAE,CAAC;IACd,EAAE,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;IAC1D,+DAA+D;IAC/D,MAAM,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;IACnE,mCAAmC;IACnC,KAAK,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;IAC9C,SAAS,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;QAAC,SAAS,EAAE,OAAO,CAAA;KAAE,GAAG,IAAI,CAAC;CAC7F;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,IAAI,EAAE,CAAC;IACd,KAAK,EAAE,WAAW,CAAC;IACnB,yEAAyE;IACzE,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,MAAM,EAAE,aAAa,CAAC;IACtB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAID;;;;;;;GAOG;AACH,wBAAsB,WAAW,CAAC,KAAK,EAAE,YAAY,GAAG,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC,CAoEpF;AAwFD,wBAAsB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC,CA6BxE;AAED,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,uDAAuD;AACvD,wBAAsB,aAAa,CACjC,GAAG,EAAE,MAAM,EACX,WAAW,EAAE,MAAM,EACnB,GAAG,SAAa,GACf,OAAO,CAAC,WAAW,CAAC,CAetB"}

package/dist/core/archive.js

@@ -0,0 +1,202 @@
+import { mkdir, readdir, readFile, rm, stat, writeFile } from "node:fs/promises";
+import { basename, join } from "node:path";
+import * as git from "./git.js";
+import { dirSizeKb } from "./size.js";
+import { run } from "../util/exec.js";
+import { formatBytes } from "../util/bytes.js";
+import { formatStamp } from "../util/time.js";
+const META = "meta.json";
+/**
+ * Save everything that would be lost, *before* anything is removed.
+ *
+ * A cleanly merged worktree has nothing unique in it, so only a small metadata
+ * record is written. Anything with unmerged commits, uncommitted changes or
+ * untracked files gets a bundle, a patch and a tarball — which is what makes
+ * an unattended daemon a reasonable thing to run.
+ */
+export async function archiveWork(input) {
+    if (!input.config.enabled)
+        return null;
+    const now = input.now ?? Date.now();
+    const repoName = basename(input.repo);
+    const slug = (input.branch ?? "detached").replace(/[^a-zA-Z0-9._-]/g, "-");
+    const id = join(repoName, `${slug}-${formatStamp(now)}`);
+    const dir = join(input.config.dir, id);
+    await mkdir(dir, { recursive: true });
+    const record = {
+        version: 1,
+        id,
+        dir,
+        createdAt: new Date(now).toISOString(),
+        repo: input.repo,
+        repoName,
+        worktree: input.worktreePath,
+        branch: input.branch,
+        head: input.head,
+        reason: input.reason,
+        risks: input.risks,
+        pr: prOf(input.merge),
+        bundle: null,
+        patch: null,
+        untracked: null,
+    };
+    // 1. Commits that exist nowhere else.
+    if (input.branch) {
+        const revRange = input.base ? `${input.base}..${input.branch}` : input.branch;
+        const commits = input.base
+            ? await git.commitsNotIn(input.repo, input.base, input.branch)
+            : [];
+        if (!input.base || commits.length > 0) {
+            const file = join(dir, "commits.bundle");
+            const ok = await git.createBundle(input.repo, file, [revRange]);
+            if (ok) {
+                record.bundle = { file, commits: commits.length, revRange };
+            }
+            else {
+                input.logger?.warn(`archive: could not bundle ${revRange} for ${input.branch}`);
+            }
+        }
+    }
+    // 2. Uncommitted tracked changes.
+    if (input.worktreePath) {
+        const diff = await git.diffAgainstHead(input.worktreePath);
+        if (diff) {
+            const file = join(dir, "uncommitted.patch");
+            await writeFile(file, diff);
+            record.patch = { file, bytes: Buffer.byteLength(diff) };
+        }
+        // 3. Untracked (but not ignored) files.
+        const untracked = await git.untrackedFiles(input.worktreePath);
+        if (untracked.length > 0) {
+            record.untracked = await saveUntracked(input.worktreePath, untracked, dir, input.config, input.logger);
+        }
+    }
+    await writeFile(join(dir, META), JSON.stringify(record, null, 2) + "\n");
+    await writeFile(join(dir, "RESTORE.md"), restoreDoc(record));
+    input.logger?.debug(`archive: wrote ${dir}`);
+    return record;
+}
+async function saveUntracked(worktree, files, dir, cfg, logger) {
+    let bytes = 0;
+    for (const f of files) {
+        try {
+            const st = await stat(join(worktree, f));
+            bytes += st.size;
+        }
+        catch {
+            /* raced away */
+        }
+        if (bytes > cfg.maxUntrackedBytes)
+            break;
+    }
+    const listFile = join(dir, "untracked.txt");
+    await writeFile(listFile, files.join("\n") + "\n");
+    if (bytes > cfg.maxUntrackedBytes) {
+        logger?.warn(`archive: ${files.length} untracked files total ${formatBytes(bytes)}, over the ` +
+            `${formatBytes(cfg.maxUntrackedBytes)} limit — saved the file list only`);
+        return { count: files.length, bytes, file: listFile, truncated: true };
+    }
+    const tarball = join(dir, "untracked.tar.gz");
+    const r = await run("tar", ["-czf", tarball, "-C", worktree, "-T", listFile], {
+        timeoutMs: 300_000,
+    });
+    if (r.code !== 0) {
+        logger?.warn(`archive: tar failed (${(r.stderr || "").trim().split("\n")[0] ?? ""}) — kept the list`);
+        return { count: files.length, bytes, file: listFile, truncated: true };
+    }
+    return { count: files.length, bytes, file: tarball, truncated: false };
+}
+function prOf(merge) {
+    if ("pr" in merge && merge.pr) {
+        return { number: merge.pr.number, url: merge.pr.url, state: merge.pr.state };
+    }
+    return null;
+}
+function restoreDoc(r) {
+    const lines = [
+        `# Archive: ${r.branch ?? "(detached)"}`,
+        "",
+        `Removed from \`${r.worktree ?? r.repo}\` on ${r.createdAt}.`,
+        `Reason: ${r.reason}.`,
+        r.risks.length > 0 ? `Flagged: ${r.risks.join(", ")}.` : "Nothing unique was at risk.",
+        "",
+        "## Restore",
+        "",
+        "```bash",
+        `cd ${r.repo}`,
+    ];
+    if (r.bundle) {
+        lines.push(`# ${r.bundle.commits} commit(s) that were not on the default branch`, `git fetch ${r.bundle.file} '*:*'`, `git branch ${r.branch ?? "restored"} ${r.head ?? "FETCH_HEAD"}`);
+    }
+    else {
+        lines.push(`# all commits were already on the default branch`, `git branch ${r.branch ?? "restored"} ${r.head ?? ""}`);
+    }
+    lines.push(`git worktree add ../${basename(r.worktree ?? r.repo)} ${r.branch ?? "restored"}`);
+    if (r.patch) {
+        lines.push("", "# uncommitted changes", `git apply ${r.patch.file}`);
+    }
+    if (r.untracked && !r.untracked.truncated && r.untracked.file) {
+        lines.push("", "# untracked files", `tar -xzf ${r.untracked.file} -C .`);
+    }
+    else if (r.untracked) {
+        lines.push("", `# ${r.untracked.count} untracked files were too large to copy; see untracked.txt`);
+    }
+    lines.push("```", "");
+    return lines.join("\n");
+}
+export async function listArchives(dir) {
+    const out = [];
+    let repoDirs;
+    try {
+        repoDirs = await readdir(dir, { withFileTypes: true });
+    }
+    catch {
+        return out;
+    }
+    for (const repoDir of repoDirs) {
+        if (!repoDir.isDirectory())
+            continue;
+        let entries;
+        try {
+            entries = await readdir(join(dir, repoDir.name), { withFileTypes: true });
+        }
+        catch {
+            continue;
+        }
+        for (const e of entries) {
+            if (!e.isDirectory())
+                continue;
+            const metaPath = join(dir, repoDir.name, e.name, META);
+            try {
+                const parsed = JSON.parse(await readFile(metaPath, "utf8"));
+                if (parsed && typeof parsed === "object")
+                    out.push(parsed);
+            }
+            catch {
+                /* an archive without readable metadata is not listed */
+            }
+        }
+    }
+    out.sort((a, b) => Date.parse(b.createdAt) - Date.parse(a.createdAt));
+    return out;
+}
+/** Delete archives older than the retention window. */
+export async function pruneArchives(dir, retentionMs, now = Date.now()) {
+    const result = { removed: [], freedKb: 0 };
+    for (const record of await listArchives(dir)) {
+        const age = now - Date.parse(record.createdAt);
+        if (!Number.isFinite(age) || age < retentionMs)
+            continue;
+        const kb = (await dirSizeKb(record.dir)) ?? 0;
+        try {
+            await rm(record.dir, { recursive: true, force: true });
+            result.removed.push(record.id);
+            result.freedKb += kb;
+        }
+        catch {
+            /* leave it for next time */
+        }
+    }
+    return result;
+}
+//# sourceMappingURL=archive.js.map

package/dist/core/archive.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"archive.js","sourceRoot":"","sources":["../../src/core/archive.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AACjF,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAG3C,OAAO,KAAK,GAAG,MAAM,UAAU,CAAC;AAChC,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AACtC,OAAO,EAAE,GAAG,EAAE,MAAM,iBAAiB,CAAC;AAEtC,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,OAAO,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAqC9C,MAAM,IAAI,GAAG,WAAW,CAAC;AAEzB;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,KAAmB;IACnD,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,OAAO;QAAE,OAAO,IAAI,CAAC;IAEvC,MAAM,GAAG,GAAG,KAAK,CAAC,GAAG,IAAI,IAAI,CAAC,GAAG,EAAE,CAAC;IACpC,MAAM,QAAQ,GAAG,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IACtC,MAAM,IAAI,GAAG,CAAC,KAAK,CAAC,MAAM,IAAI,UAAU,CAAC,CAAC,OAAO,CAAC,kBAAkB,EAAE,GAAG,CAAC,CAAC;IAC3E,MAAM,EAAE,GAAG,IAAI,CAAC,QAAQ,EAAE,GAAG,IAAI,IAAI,WAAW,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IACzD,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;IAEvC,MAAM,KAAK,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAEtC,MAAM,MAAM,GAAkB;QAC5B,OAAO,EAAE,CAAC;QACV,EAAE;QACF,GAAG;QACH,SAAS,EAAE,IAAI,IAAI,CAAC,GAAG,CAAC,CAAC,WAAW,EAAE;QACtC,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,QAAQ;QACR,QAAQ,EAAE,KAAK,CAAC,YAAY;QAC5B,MAAM,EAAE,KAAK,CAAC,MAAM;QACpB,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,MAAM,EAAE,KAAK,CAAC,MAAM;QACpB,KAAK,EAAE,KAAK,CAAC,KAAK;QAClB,EAAE,EAAE,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC;QACrB,MAAM,EAAE,IAAI;QACZ,KAAK,EAAE,IAAI;QACX,SAAS,EAAE,IAAI;KAChB,CAAC;IAEF,sCAAsC;IACtC,IAAI,KAAK,CAAC,MAAM,EAAE,CAAC;QACjB,MAAM,QAAQ,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,IAAI,KAAK,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC;QAC9E,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI;YACxB,CAAC,CAAC,MAAM,GAAG,CAAC,YAAY,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,MAAM,CAAC;YAC9D,CAAC,CAAC,EAAE,CAAC;QACP,IAAI,CAAC,KAAK,CAAC,IAAI,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACtC,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,EAAE,gBAAgB,CAAC,CAAC;YACzC,MAAM,EAAE,GAAG,MAAM,GAAG,CAAC,YAAY,CAAC,KAAK,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC;YAChE,IAAI,EAAE,EAAE,CAAC;gBACP,MAAM,CAAC,MAAM,GAAG,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,CAAC,MAAM,EAAE,QAAQ,EAAE,CAAC;YAC9D,CAAC;iBAAM,CAAC;gBACN,KAAK,CAAC,MAAM,EAAE,IAAI,CAAC,6BAA6B,QAAQ,QAAQ,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC;YAClF,CAAC;QACH,CAAC;IACH,CAAC;IAED,kCAAkC;IAClC,IAAI,KAAK,CAAC,YAAY,EAAE,CAAC;QACvB,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,eAAe,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC;QAC3D,IAAI,IAAI,EAAE,CAAC;YACT,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,EAAE,mBAAmB,CAAC,CAAC;YAC5C,MAAM,SAAS,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;YAC5B,MAAM,CAAC,KAAK,GAAG,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;QAC1D,CAAC;QAED,wCAAwC;QACxC,MAAM,SAAS,GAAG,MAAM,GAAG,CAAC,cAAc,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC;QAC/D,IAAI,SAAS,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACzB,MAAM,CAAC,SAAS,GAAG,MAAM,aAAa,CACpC,KAAK,CAAC,YAAY,EAAE,SAAS,EAAE,GAAG,EAAE,KAAK,CAAC,MAAM,EAAE,KAAK,CAAC,MAAM,CAC/D,CAAC;QACJ,CAAC;IACH,CAAC;IAED,MAAM,SAAS,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;IACzE,MAAM,SAAS,CAAC,IAAI,CAAC,GAAG,EAAE,YAAY,CAAC,EAAE,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC;IAC7D,KAAK,CAAC,MAAM,EAAE,KAAK,CAAC,kBAAkB,GAAG,EAAE,CAAC,CAAC;IAC7C,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,KAAK,UAAU,aAAa,CAC1B,QAAgB,EAChB,KAAe,EACf,GAAW,EACX,GAAkB,EAClB,MAAe;IAEf,IAAI,KAAK,GAAG,CAAC,CAAC;IACd,KAAK,MAAM,CAAC,IAAI,KAAK,EAAE,CAAC;QACtB,IAAI,CAAC;YACH,MAAM,EAAE,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,CAAC;YACzC,KAAK,IAAI,EAAE,CAAC,IAAI,CAAC;QACnB,CAAC;QAAC,MAAM,CAAC;YACP,gBAAgB;QAClB,CAAC;QACD,IAAI,KAAK,GAAG,GAAG,CAAC,iBAAiB;YAAE,MAAM;IAC3C,CAAC;IAED,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,eAAe,CAAC,CAAC;IAC5C,MAAM,SAAS,CAAC,QAAQ,EAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,CAAC;IAEnD,IAAI,KAAK,GAAG,GAAG,CAAC,iBAAiB,EAAE,CAAC;QAClC,MAAM,EAAE,IAAI,CACV,YAAY,KAAK,CAAC,MAAM,0BAA0B,WAAW,CAAC,KAAK,CAAC,aAAa;YACjF,GAAG,WAAW,CAAC,GAAG,CAAC,iBAAiB,CAAC,mCAAmC,CACzE,CAAC;QACF,OAAO,EAAE,KAAK,EAAE,KAAK,CAAC,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,QAAQ,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC;IACzE,CAAC;IAED,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,EAAE,kBAAkB,CAAC,CAAC;IAC9C,MAAM,CAAC,GAAG,MAAM,GAAG,CAAC,KAAK,EAAE,CAAC,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,QAAQ,CAAC,EAAE;QAC5E,SAAS,EAAE,OAAO;KACnB,CAAC,CAAC;IACH,IAAI,CAAC,CAAC,IAAI,KAAK,CAAC,EAAE,CAAC;QACjB,MAAM,EAAE,IAAI,CAAC,wBAAwB,CAAC,CAAC,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,mBAAmB,CAAC,CAAC;QACtG,OAAO,EAAE,KAAK,EAAE,KAAK,CAAC,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,QAAQ,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC;IACzE,CAAC;IACD,OAAO,EAAE,KAAK,EAAE,KAAK,CAAC,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC;AACzE,CAAC;AAED,SAAS,IAAI,CAAC,KAAkB;IAC9B,IAAI,IAAI,IAAI,KAAK,IAAI,KAAK,CAAC,EAAE,EAAE,CAAC;QAC9B,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,CAAC,MAAM,EAAE,GAAG,EAAE,KAAK,CAAC,EAAE,CAAC,GAAG,EAAE,KAAK,EAAE,KAAK,CAAC,EAAE,CAAC,KAAK,EAAE,CAAC;IAC/E,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,SAAS,UAAU,CAAC,CAAgB;IAClC,MAAM,KAAK,GAAa;QACtB,cAAc,CAAC,CAAC,MAAM,IAAI,YAAY,EAAE;QACxC,EAAE;QACF,kBAAkB,CAAC,CAAC,QAAQ,IAAI,CAAC,CAAC,IAAI,SAAS,CAAC,CAAC,SAAS,GAAG;QAC7D,WAAW,CAAC,CAAC,MAAM,GAAG;QACtB,CAAC,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,6BAA6B;QACtF,EAAE;QACF,YAAY;QACZ,EAAE;QACF,SAAS;QACT,MAAM,CAAC,CAAC,IAAI,EAAE;KACf,CAAC;IAEF,IAAI,CAAC,CAAC,MAAM,EAAE,CAAC;QACb,KAAK,CAAC,IAAI,CACR,KAAK,CAAC,CAAC,MAAM,CAAC,OAAO,gDAAgD,EACrE,aAAa,CAAC,CAAC,MAAM,CAAC,IAAI,QAAQ,EAClC,cAAc,CAAC,CAAC,MAAM,IAAI,UAAU,IAAI,CAAC,CAAC,IAAI,IAAI,YAAY,EAAE,CACjE,CAAC;IACJ,CAAC;SAAM,CAAC;QACN,KAAK,CAAC,IAAI,CAAC,kDAAkD,EAAE,cAAc,CAAC,CAAC,MAAM,IAAI,UAAU,IAAI,CAAC,CAAC,IAAI,IAAI,EAAE,EAAE,CAAC,CAAC;IACzH,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,uBAAuB,QAAQ,CAAC,CAAC,CAAC,QAAQ,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,MAAM,IAAI,UAAU,EAAE,CAAC,CAAC;IAE9F,IAAI,CAAC,CAAC,KAAK,EAAE,CAAC;QACZ,KAAK,CAAC,IAAI,CAAC,EAAE,EAAE,uBAAuB,EAAE,aAAa,CAAC,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC;IACvE,CAAC;IACD,IAAI,CAAC,CAAC,SAAS,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,SAAS,IAAI,CAAC,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC;QAC9D,KAAK,CAAC,IAAI,CAAC,EAAE,EAAE,mBAAmB,EAAE,YAAY,CAAC,CAAC,SAAS,CAAC,IAAI,OAAO,CAAC,CAAC;IAC3E,CAAC;SAAM,IAAI,CAAC,CAAC,SAAS,EAAE,CAAC;QACvB,KAAK,CAAC,IAAI,CAAC,EAAE,EAAE,KAAK,CAAC,CAAC,SAAS,CAAC,KAAK,4DAA4D,CAAC,CAAC;IACrG,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;IACtB,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,GAAW;IAC5C,MAAM,GAAG,GAAoB,EAAE,CAAC;IAChC,IAAI,QAAQ,CAAC;IACb,IAAI,CAAC;QACH,QAAQ,GAAG,MAAM,OAAO,CAAC,GAAG,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC;IACzD,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,GAAG,CAAC;IACb,CAAC;IACD,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;QAC/B,IAAI,CAAC,OAAO,CAAC,WAAW,EAAE;YAAE,SAAS;QACrC,IAAI,OAAO,CAAC;QACZ,IAAI,CAAC;YACH,OAAO,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC,GAAG,EAAE,OAAO,CAAC,IAAI,CAAC,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC;QAC5E,CAAC;QAAC,MAAM,CAAC;YACP,SAAS;QACX,CAAC;QACD,KAAK,MAAM,CAAC,IAAI,OAAO,EAAE,CAAC;YACxB,IAAI,CAAC,CAAC,CAAC,WAAW,EAAE;gBAAE,SAAS;YAC/B,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;YACvD,IAAI,CAAC;gBACH,MAAM,MAAM,GAAY,IAAI,CAAC,KAAK,CAAC,MAAM,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC,CAAC;gBACrE,IAAI,MAAM,IAAI,OAAO,MAAM,KAAK,QAAQ;oBAAE,GAAG,CAAC,IAAI,CAAC,MAAuB,CAAC,CAAC;YAC9E,CAAC;YAAC,MAAM,CAAC;gBACP,wDAAwD;YAC1D,CAAC;QACH,CAAC;IACH,CAAC;IACD,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC;IACtE,OAAO,GAAG,CAAC;AACb,CAAC;AAOD,uDAAuD;AACvD,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,GAAW,EACX,WAAmB,EACnB,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE;IAEhB,MAAM,MAAM,GAAgB,EAAE,OAAO,EAAE,EAAE,EAAE,OAAO,EAAE,CAAC,EAAE,CAAC;IACxD,KAAK,MAAM,MAAM,IAAI,MAAM,YAAY,CAAC,GAAG,CAAC,EAAE,CAAC;QAC7C,MAAM,GAAG,GAAG,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;QAC/C,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,GAAG,GAAG,WAAW;YAAE,SAAS;QACzD,MAAM,EAAE,GAAG,CAAC,MAAM,SAAS,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC;QAC9C,IAAI,CAAC;YACH,MAAM,EAAE,CAAC,MAAM,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;YACvD,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;YAC/B,MAAM,CAAC,OAAO,IAAI,EAAE,CAAC;QACvB,CAAC;QAAC,MAAM,CAAC;YACP,4BAA4B;QAC9B,CAAC;IACH,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/core/config.d.ts

@@ -0,0 +1,69 @@
+export type DirtyPolicy = "archive" | "keep";
+export type ForgeKind = "github" | "none";
+export type LogLevel = "debug" | "info" | "warn" | "error";
+export interface SessionCommand {
+    name: string;
+    /** Shell command; exit code 0 means "an agent is still working here". */
+    command: string;
+}
+export interface SessionConfig {
+    /** A worktree touched by any detector inside this window is left alone. */
+    grace: string;
+    detectors: string[];
+    /**
+     * Extra files/dirs whose mtime counts as agent activity.
+     * `{worktree}` is substituted with the worktree path.
+     */
+    extraPaths: string[];
+    commands: SessionCommand[];
+}
+export interface ArchiveConfig {
+    enabled: boolean;
+    dir: string;
+    retention: string;
+    /** Untracked files above this total are listed instead of copied. */
+    maxUntrackedBytes: number;
+}
+export interface Config {
+    /** Directories scanned for git repos (and therefore for their worktrees). */
+    roots: string[];
+    maxDepth: number;
+    /** A worktree must be untouched this long before it can be reclaimed. */
+    minAge: string;
+    /** A worktree whose PR was closed unmerged waits this long on top of minAge. */
+    closedPrGrace: string;
+    onDirty: DirtyPolicy;
+    onClosedPr: DirtyPolicy;
+    /** PR merged but the local branch tip has commits the PR never had. */
+    onExtraCommits: DirtyPolicy;
+    protectBranches: string[];
+    protectPaths: string[];
+    /** Also delete merged local branches that have no worktree. */
+    pruneBranches: boolean;
+    pruneRemotes: boolean;
+    forge: ForgeKind;
+    forgeCacheTtl: string;
+    /** Daemon sweep interval. */
+    interval: string;
+    sessions: SessionConfig;
+    archive: ArchiveConfig;
+    logFile: string;
+    logLevel: LogLevel;
+    /** Set to false in a repo's .treekeeper.json to opt that repo out entirely. */
+    enabled: boolean;
+}
+export declare const CONFIG_FILENAME = "config.json";
+export declare const REPO_CONFIG_FILENAME = ".treekeeper.json";
+export declare function defaultConfig(): Config;
+export interface LoadedConfig {
+    config: Config;
+    /** Files that contributed, in precedence order. */
+    sources: string[];
+    warnings: string[];
+}
+export declare function globalConfigPath(): string;
+/** Load the user-level config, falling back to defaults when absent. */
+export declare function loadConfig(path?: string): Promise<LoadedConfig>;
+/** Layer a repo-local `.treekeeper.json` on top of an already-loaded config. */
+export declare function loadRepoConfig(repoPath: string, parent: Config): Promise<LoadedConfig>;
+//# sourceMappingURL=config.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/core/config.ts"],"names":[],"mappings":"AAKA,MAAM,MAAM,WAAW,GAAG,SAAS,GAAG,MAAM,CAAC;AAC7C,MAAM,MAAM,SAAS,GAAG,QAAQ,GAAG,MAAM,CAAC;AAC1C,MAAM,MAAM,QAAQ,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;AAE3D,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,yEAAyE;IACzE,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,aAAa;IAC5B,2EAA2E;IAC3E,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB;;;OAGG;IACH,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,QAAQ,EAAE,cAAc,EAAE,CAAC;CAC5B;AAED,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,OAAO,CAAC;IACjB,GAAG,EAAE,MAAM,CAAC;IACZ,SAAS,EAAE,MAAM,CAAC;IAClB,qEAAqE;IACrE,iBAAiB,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,MAAM;IACrB,6EAA6E;IAC7E,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,yEAAyE;IACzE,MAAM,EAAE,MAAM,CAAC;IACf,gFAAgF;IAChF,aAAa,EAAE,MAAM,CAAC;IACtB,OAAO,EAAE,WAAW,CAAC;IACrB,UAAU,EAAE,WAAW,CAAC;IACxB,uEAAuE;IACvE,cAAc,EAAE,WAAW,CAAC;IAC5B,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,+DAA+D;IAC/D,aAAa,EAAE,OAAO,CAAC;IACvB,YAAY,EAAE,OAAO,CAAC;IACtB,KAAK,EAAE,SAAS,CAAC;IACjB,aAAa,EAAE,MAAM,CAAC;IACtB,6BAA6B;IAC7B,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,aAAa,CAAC;IACxB,OAAO,EAAE,aAAa,CAAC;IACvB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,QAAQ,CAAC;IACnB,+EAA+E;IAC/E,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,eAAO,MAAM,eAAe,gBAAgB,CAAC;AAC7C,eAAO,MAAM,oBAAoB,qBAAqB,CAAC;AAEvD,wBAAgB,aAAa,IAAI,MAAM,CAiCtC;AAED,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,MAAM,CAAC;IACf,mDAAmD;IACnD,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,wBAAgB,gBAAgB,IAAI,MAAM,CAIzC;AAED,wEAAwE;AACxE,wBAAsB,UAAU,CAAC,IAAI,SAAqB,GAAG,OAAO,CAAC,YAAY,CAAC,CAYjF;AAED,gFAAgF;AAChF,wBAAsB,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,CAS5F"}