@yoavsh/treekeeper 0.0.0-stage → 0.1.0

package/CHANGELOG.md

@@ -0,0 +1,14 @@
+# Changelog
+
+## 0.1.0
+
+First release.
+
+- `treekeeper gc` — plan and apply worktree and branch cleanup, dry run by default
+- Detects finished work from git ancestry and from merged or closed pull requests (via `gh`), so squash merges are caught
+- Holds back worktrees with live agent sessions (Claude Code, Codex, Aider), live processes, recent changes, or uncommitted work
+- Archives unmerged commits, uncommitted diffs and untracked files before any removal, with a `RESTORE.md`
+- `treekeeper daemon install` — launchd (macOS) and systemd user timers (Linux)
+- `status`, `watch`, `archive`, `config` and `doctor` commands
+- `--json` output for any harness to read
+- Credential scrubbing for all output and cached data

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Yoav Shmariahu
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,238 @@
-# Temporary Holding Version
+# treekeeper
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+[![ci](https://github.com/yoavshmariahu/treekeeper/actions/workflows/ci.yml/badge.svg)](https://github.com/yoavshmariahu/treekeeper/actions/workflows/ci.yml)
+[![npm](https://img.shields.io/npm/v/%40yoavsh%2Ftreekeeper?color=0b7)](https://www.npmjs.com/package/@yoavsh/treekeeper)
+[![node](https://img.shields.io/node/v/%40yoavsh%2Ftreekeeper)](https://nodejs.org)
+[![license](https://img.shields.io/badge/license-MIT-blue)](LICENSE)
+[![dependencies](https://img.shields.io/badge/dependencies-none-0b7)](package.json)
+
+**Agents leave worktrees behind. treekeeper takes them away — once the work is actually finished, and never before.**
+
+A coding agent that works in a git worktree per task is wonderful right up to the point where your disk is 40 abandoned checkouts deep, each with its own `node_modules`. The branches pile up too, until `git branch` is a wall of `agent/fix-the-thing-a3f91c`.
+
+treekeeper watches your worktrees, your git history, your pull requests and your agent sessions, and reclaims the ones whose work is already merged. It archives anything unique first, so running it unattended is a reasonable thing to do.
+
+```console
+$ treekeeper gc --all
+thinker (main)
+  RECLAIM  ~/src/thinker/.worktrees/sh-links    [agent/sh-links]     59M  PR #747 merged
+  keep     ~/src/thinker/.worktrees/bedrock     [agent/bedrock]           claude-code activity 3m ago
+  keep     ~/src/thinker/.worktrees/retry-wip   [agent/retry-wip]         PR #751 is still open
+  DELETE   156 merged branches: agent/approve-by-offer agent/astra-compression +154 more
+
+would reclaim 1 worktree (59M) and delete 156 branches · 2 kept
+re-run with --apply to do it
+```
+
+## Install
+
+```bash
+npm install -g @yoavsh/treekeeper      # or: npx @yoavsh/treekeeper gc --all
+```
+
+Needs Node 20+ and `git`. Install [`gh`](https://cli.github.com) too — without it treekeeper cannot see squash merges, which is how most agent branches land.
+
+## Quick start
+
+```bash
+treekeeper gc --all                 # dry run: what could go, and why
+treekeeper gc --all --apply         # do it (asks first)
+treekeeper daemon install           # ...or never think about it again
+```
+
+`treekeeper gc` is always a dry run until you pass `--apply`. The daemon sweeps every 15 minutes in the background.
+
+## What counts as "finished"
+
+This is the whole design, so it is worth being precise. A worktree is removable only when **one** of these is true:
+
+| Signal | How it is detected | Default |
+|---|---|---|
+| Branch is merged into the default branch | `git merge-base --is-ancestor` | reclaim |
+| Pull request was **merged** (incl. squash/rebase) | `gh pr list`, head SHA matched to the local tip | reclaim |
+| Pull request was **closed** without merging | `gh pr list` | reclaim after a 7-day grace, commits archived first |
+| PR merged, but the local branch has extra commits | PR head SHA ≠ local tip | **keep** (opt in with `onExtraCommits`) |
+| Pull request still open | `gh pr list` | keep |
+| Nothing says the work landed | — | keep |
+
+**treekeeper never removes a worktree whose commits are not either on the default branch or attached to a merged or closed pull request.** `--force` does not relax that. It is the one invariant everything else is built on.
+
+Then, even for finished work, it holds back if anyone is still there:
+
+- an agent session touched the worktree in the last 20 minutes (`sessions.grace`)
+- a running process has its working directory inside it
+- the worktree was touched more recently than `minAge` (30 minutes)
+- it is your current directory, the repo's main worktree, `git worktree lock`ed, on a protected branch, or matched by `protectPaths`
+
+Uncommitted changes do **not** save a worktree whose work is merged — they get archived and the worktree goes. Set `onDirty: "keep"` if you would rather it stayed.
+
+## Nothing is unrecoverable
+
+Before anything is removed, treekeeper writes an archive to `~/.treekeeper/archive/<repo>/<branch>-<timestamp>/`:
+
+```
+commits.bundle      git bundle of commits not on the default branch
+uncommitted.patch   git diff HEAD --binary
+untracked.tar.gz    untracked, non-ignored files
+meta.json           what was removed, when, and why
+RESTORE.md          the exact commands to bring it back
+```
+
+A cleanly merged worktree has nothing unique in it, so it only gets `meta.json` — an audit record. Anything with real work in it gets the full set.
+
+```bash
+treekeeper archive list      # what has been removed lately
+treekeeper archive prune     # drop archives past the retention window (14d)
+```
+
+## It works with any agent harness
+
+treekeeper decides from **state, not hooks**: git, your forge, and whatever the agents left on disk. So it works with harnesses it has never heard of, and it keeps working when a harness changes its hook API.
+
+**1. Run the daemon and forget it.** Nothing to integrate.
+
+```bash
+treekeeper daemon install     # launchd on macOS, systemd --user on Linux
+treekeeper daemon status
+```
+
+**2. Or call it from a harness hook** — any harness that can run a shell command:
+
+```bash
+npx -y treekeeper gc --all --apply --yes --quiet
+```
+
+**3. Or read the plan as JSON** and decide for yourself:
+
+```bash
+treekeeper gc --all --json | jq '.summary'
+treekeeper gc --all --json | jq -r '.repos[].worktrees[] | select(.verdict.action=="reclaim") | .path'
+```
+
+See [docs/integrations.md](docs/integrations.md) for ready-made snippets (Claude Code, Codex CLI, Cursor, Aider, CI).
+
+### Knowing when an agent is still working
+
+| Detector | Signal |
+|---|---|
+| `claude-code` | transcript mtime in `~/.claude/projects/<slug>/` |
+| `codex` | rollout transcript in `~/.codex/sessions/` whose `cwd` is the worktree |
+| `aider` | `.aider.chat.history.md` in the worktree |
+| `process` | `lsof` — a live process whose cwd is inside the worktree |
+| `mtime` | any recently modified file in the worktree |
+
+The last two are the catch-all that covers every other harness: an agent that is working is a process in a directory, writing files. Add your own with a shell command:
+
+```json
+{
+  "sessions": {
+    "commands": [
+      { "name": "my-harness", "command": "pgrep -f \"my-agent --cwd $TREEKEEPER_WORKTREE\"" }
+    ]
+  }
+}
+```
+
+Exit code 0 means "still working".
+
+## Configuration
+
+`~/.treekeeper/config.json` (run `treekeeper config init` for a starter, `treekeeper config show` for the effective values). JSON with `//` comments and trailing commas allowed.
+
+```jsonc
+{
+  "roots": ["~/src"],            // where to look for repos
+  "maxDepth": 3,
+  "minAge": "30m",               // untouched this long before it can go
+  "closedPrGrace": "7d",         // extra hold for closed-unmerged PRs
+  "onDirty": "archive",          // archive | keep
+  "onClosedPr": "archive",       // archive | keep
+  "onExtraCommits": "keep",      // archive | keep
+  "protectBranches": ["main", "master", "trunk", "develop", "dev", "release/*"],
+  "protectPaths": [],            // paths or globs that are never touched
+  "pruneBranches": true,         // also delete merged branches with no worktree
+  "pruneRemotes": false,         // git remote prune origin after a sweep
+  "forge": "github",             // github | none (none = git ancestry only)
+  "forgeCacheTtl": "10m",
+  "interval": "15m",             // daemon sweep interval
+  "sessions": {
+    "grace": "20m",
+    "detectors": ["claude-code", "codex", "aider", "process", "mtime"],
+    "extraPaths": [],            // mtime of these counts as activity; {worktree} is substituted
+    "commands": []
+  },
+  "archive": {
+    "enabled": true,
+    "dir": "~/.treekeeper/archive",
+    "retention": "14d",
+    "maxUntrackedBytes": 67108864
+  },
+  "logFile": "~/.treekeeper/treekeeper.log",
+  "logLevel": "info"
+}
+```
+
+A repo can override any of it, or opt out entirely, with its own `.treekeeper.json`:
+
+```json
+{ "enabled": false }
+```
+
+## Commands
+
+```
+treekeeper gc [path...]     Plan a sweep (default command). --apply to carry it out.
+treekeeper status           What is reclaimable right now, plus daemon state.
+treekeeper watch            Sweep on an interval in the foreground.
+treekeeper daemon <sub>     install | uninstall | start | stop | status | logs
+treekeeper archive <sub>    list | prune | path
+treekeeper config <sub>     show | path | init
+treekeeper doctor           Check git, gh, lsof, config and detectors.
+```
+
+Useful flags: `--all`, `--apply`, `-y/--yes`, `--json`, `-v/--verbose` (show what was kept and why), `--force`, `--min-age 2h`, `--branches-only`, `--worktrees-only`, `--forge none`, `--refresh`, `--root <dir>`.
+
+Every removal is appended as JSON to `~/.treekeeper/treekeeper.log`, so there is always an answer to "what happened to that directory".
+
+## Why not just `git worktree prune`?
+
+`git worktree prune` only clears records for directories you already deleted — it never frees a byte. `git branch --merged` misses squash merges, which is how most agent branches land, and neither knows whether an agent is still working in a checkout. treekeeper answers the question those commands cannot: *is this work done, and is anyone still in there?*
+
+## Programmatic use
+
+```ts
+import { loadConfig, createForge, discoverRepos, buildPlan, applyPlan, Logger } from "@yoavsh/treekeeper";
+
+const { config } = await loadConfig();
+const logger = new Logger({ level: "info" });
+const repos = await discoverRepos({ roots: config.roots, maxDepth: config.maxDepth });
+const forge = createForge({ kind: config.forge, cacheTtl: config.forgeCacheTtl, logger });
+
+const plan = await buildPlan({ config, repos, forge, logger });
+if (plan.summary.worktreesReclaimable > 0) {
+  await applyPlan({ plan, config, logger });
+}
+```
+
+`decideWorktree(facts, policy)` is a pure function if you only want the ruleset.
+
+## Safety notes
+
+- One sweep at a time per machine, enforced by a lock file, so a scheduled sweep and a manual one cannot race.
+- Every candidate is re-verified immediately before removal; if the branch, HEAD or contents moved since the plan was built, it is left alone.
+- Credentials are scrubbed from all output — remotes with embedded tokens are common, and the log is persistent.
+- Removals go through `git worktree remove`, never a blind `rm -rf`.
+
+The full threat model, the archive format and the recovery procedure are in
+[docs/safety.md](docs/safety.md).
+
+## Contributing
+
+Issues and pull requests are welcome — see [CONTRIBUTING.md](CONTRIBUTING.md).
+Security problems go through [private reporting](SECURITY.md), not a public issue.
+`npm test` runs the suite against real git repositories, so it needs `git` on
+your PATH and takes about 30 seconds.
+
+## License
+
+[MIT](LICENSE) © Yoav Shmariahu

package/dist/cli.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export declare function main(argv: string[]): Promise<number>;
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AA0DA,wBAAsB,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CA2F1D"}

package/dist/cli.js

@@ -0,0 +1,165 @@
+#!/usr/bin/env node
+import { readFile } from "node:fs/promises";
+import { parseArgs } from "node:util";
+import { archiveCommand } from "./commands/archive.js";
+import { configCommand } from "./commands/config.js";
+import { daemonCommand } from "./commands/daemon.js";
+import { doctorCommand } from "./commands/doctor.js";
+import { gcCommand } from "./commands/gc.js";
+import { statusCommand } from "./commands/status.js";
+import { watchCommand } from "./commands/watch.js";
+import { color } from "./util/color.js";
+const HELP = `${color.bold("treekeeper")} — reclaim disk from finished agent worktrees
+
+${color.bold("USAGE")}
+  treekeeper <command> [options] [path...]
+
+${color.bold("COMMANDS")}
+  gc [path...]        Plan a sweep (default). Add --apply to carry it out.
+  status              What is reclaimable right now, plus daemon state.
+  watch               Sweep on an interval in the foreground.
+  daemon <sub>        install | uninstall | start | stop | status | logs
+  archive <sub>       list | prune | path
+  config <sub>        show | path | init
+  doctor              Check git, gh, lsof, config and detectors.
+
+${color.bold("OPTIONS")}
+  --apply             Actually remove things (default is a dry run)
+  -y, --yes           Skip the confirmation prompt
+  --all               Every repo under the configured roots
+  --json              Machine-readable output on stdout
+  -q, --quiet         Summary only
+  -v, --verbose       Show kept worktrees and debug logging
+  --force             Bypass the age gate and the dirty / closed-PR holds
+  --min-age <dur>     Override minAge, e.g. 2h
+  --session-grace <d> Override how long after agent activity a worktree is held
+  --forge <kind>      github | none  (none = git ancestry only)
+  --refresh           Ignore the cached pull-request data
+  --branches-only     Prune branches, leave every worktree alone
+  --worktrees-only    Remove worktrees, do not prune other branches
+  --sizes             Measure every worktree, not just the removable ones
+  --root <dir>        Override roots (repeatable)
+  --interval <dur>    Interval for watch / daemon install
+  --config <file>     Use a specific config file
+  -h, --help          This text
+  --version           Version
+
+${color.bold("EXAMPLES")}
+  treekeeper gc --all                   # what could go, across every repo
+  treekeeper gc --all --apply --yes     # the sweep a harness hook should run
+  treekeeper gc --json | jq .summary    # read the plan from a script
+  treekeeper daemon install             # sweep on a schedule, forever
+
+${color.gray("A worktree is only ever removed when its work is merged, or its pull request")}
+${color.gray("was merged or closed — and anything unique is archived before it goes.")}
+`;
+export async function main(argv) {
+    let parsed;
+    try {
+        parsed = parseArgs({
+            args: argv,
+            allowPositionals: true,
+            strict: true,
+            options: {
+                apply: { type: "boolean" },
+                yes: { type: "boolean", short: "y" },
+                all: { type: "boolean" },
+                json: { type: "boolean" },
+                quiet: { type: "boolean", short: "q" },
+                verbose: { type: "boolean", short: "v" },
+                force: { type: "boolean" },
+                refresh: { type: "boolean" },
+                sizes: { type: "boolean" },
+                "branches-only": { type: "boolean" },
+                "worktrees-only": { type: "boolean" },
+                "min-age": { type: "string" },
+                "session-grace": { type: "string" },
+                forge: { type: "string" },
+                root: { type: "string", multiple: true },
+                interval: { type: "string" },
+                config: { type: "string" },
+                help: { type: "boolean", short: "h" },
+                version: { type: "boolean" },
+            },
+        });
+    }
+    catch (err) {
+        process.stderr.write(`${err.message}\nTry \`treekeeper --help\`.\n`);
+        return 2;
+    }
+    const { values, positionals } = parsed;
+    if (values.version) {
+        process.stdout.write((await version()) + "\n");
+        return 0;
+    }
+    const [command = "gc", ...rest] = positionals;
+    if (values.help) {
+        process.stdout.write(HELP);
+        return 0;
+    }
+    const flags = {
+        apply: values.apply,
+        yes: values.yes,
+        json: values.json,
+        quiet: values.quiet,
+        verbose: values.verbose,
+        all: values.all,
+        force: values.force,
+        refresh: values.refresh,
+        sizes: values.sizes,
+        branchesOnly: values["branches-only"],
+        worktreesOnly: values["worktrees-only"],
+        minAge: values["min-age"],
+        sessionGrace: values["session-grace"],
+        forge: values.forge,
+        interval: values.interval,
+        config: values.config,
+        roots: values.root,
+    };
+    switch (command) {
+        case "gc":
+        case "clean":
+            return gcCommand(rest, flags);
+        case "status":
+            return statusCommand(flags);
+        case "watch":
+            return watchCommand(flags);
+        case "daemon":
+            return daemonCommand(rest, flags);
+        case "archive":
+            return archiveCommand(rest, flags);
+        case "config":
+            return configCommand(rest);
+        case "doctor":
+            return doctorCommand(values.json === true);
+        case "help":
+            process.stdout.write(HELP);
+            return 0;
+        default:
+            process.stderr.write(`unknown command "${command}". Try \`treekeeper --help\`.\n`);
+            return 2;
+    }
+}
+async function version() {
+    try {
+        const text = await readFile(new URL("../package.json", import.meta.url), "utf8");
+        const pkg = JSON.parse(text);
+        return String(pkg.version ?? "0.0.0");
+    }
+    catch {
+        return "0.0.0";
+    }
+}
+const isDirectRun = process.argv[1] !== undefined &&
+    (import.meta.url.endsWith("/cli.js") || import.meta.url.endsWith("/cli.ts"));
+if (isDirectRun) {
+    main(process.argv.slice(2))
+        .then((code) => {
+        process.exitCode = code;
+    })
+        .catch((err) => {
+        process.stderr.write(`treekeeper: ${err.stack ?? String(err)}\n`);
+        process.exitCode = 1;
+    });
+}
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

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

package/dist/commands/archive.d.ts

@@ -0,0 +1,3 @@
+import type { CliFlags } from "./context.js";
+export declare function archiveCommand(args: string[], flags: CliFlags): Promise<number>;
+//# sourceMappingURL=archive.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"archive.d.ts","sourceRoot":"","sources":["../../src/commands/archive.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AAI7C,wBAAsB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,KAAK,EAAE,QAAQ,GAAG,OAAO,CAAC,MAAM,CAAC,CA4DrF"}

package/dist/commands/archive.js

@@ -0,0 +1,55 @@
+import { listArchives, pruneArchives } from "../core/archive.js";
+import { loadConfig } from "../core/config.js";
+import { dirSizeKb } from "../core/size.js";
+import { formatBytes, formatKb } from "../util/bytes.js";
+import { color } from "../util/color.js";
+import { shortenPath } from "../util/paths.js";
+import { formatAgo, parseDuration } from "../util/time.js";
+const USAGE = `usage: treekeeper archive <list|prune|path>`;
+export async function archiveCommand(args, flags) {
+    const { config } = await loadConfig();
+    const sub = args[0] ?? "list";
+    if (sub === "path") {
+        process.stdout.write(config.archive.dir + "\n");
+        return 0;
+    }
+    if (sub === "prune") {
+        const retention = parseDuration(config.archive.retention);
+        const result = await pruneArchives(config.archive.dir, retention);
+        process.stdout.write(result.removed.length === 0
+            ? `nothing older than ${config.archive.retention}\n`
+            : `pruned ${result.removed.length} archive(s), freed ${formatKb(result.freedKb)}\n`);
+        return 0;
+    }
+    if (sub !== "list") {
+        process.stderr.write(USAGE + "\n");
+        return 2;
+    }
+    const records = await listArchives(config.archive.dir);
+    if (flags.json) {
+        process.stdout.write(JSON.stringify(records, null, 2) + "\n");
+        return 0;
+    }
+    if (records.length === 0) {
+        process.stdout.write(`no archives in ${shortenPath(config.archive.dir)}\n`);
+        return 0;
+    }
+    const total = (await dirSizeKb(config.archive.dir)) ?? 0;
+    process.stdout.write(`${color.bold(String(records.length))} archive(s) in ${shortenPath(config.archive.dir)} ` +
+        color.gray(`(${formatKb(total)}, retention ${config.archive.retention})\n\n`));
+    for (const r of records) {
+        const bits = [
+            r.bundle ? `${r.bundle.commits} unmerged commit${r.bundle.commits === 1 ? "" : "s"}` : null,
+            r.patch ? `diff ${formatBytes(r.patch.bytes)}` : null,
+            r.untracked
+                ? `${r.untracked.count} untracked${r.untracked.truncated ? " (list only)" : ""}`
+                : null,
+        ].filter(Boolean);
+        process.stdout.write(`${color.cyan(r.id)}  ${color.gray(formatAgo(Date.parse(r.createdAt)))}\n` +
+            `  ${color.gray(r.reason)}${bits.length > 0 ? `  ${color.yellow(bits.join(", "))}` : color.gray("  (nothing unique)")}\n` +
+            `  ${color.gray(shortenPath(r.dir))}\n`);
+    }
+    process.stdout.write(color.gray("\neach archive has a RESTORE.md with the exact commands to bring it back\n"));
+    return 0;
+}
+//# sourceMappingURL=archive.js.map

package/dist/commands/archive.js.map

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

package/dist/commands/config.d.ts

@@ -0,0 +1,2 @@
+export declare function configCommand(args: string[]): Promise<number>;
+//# sourceMappingURL=config.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/commands/config.ts"],"names":[],"mappings":"AAQA,wBAAsB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAgDnE"}

package/dist/commands/config.js

@@ -0,0 +1,54 @@
+import { mkdir, writeFile } from "node:fs/promises";
+import { dirname } from "node:path";
+import { defaultConfig, globalConfigPath, loadConfig } from "../core/config.js";
+import { color } from "../util/color.js";
+import { shortenPath } from "../util/paths.js";
+const USAGE = `usage: treekeeper config <show|path|init>`;
+export async function configCommand(args) {
+    const sub = args[0] ?? "show";
+    if (sub === "path") {
+        process.stdout.write(globalConfigPath() + "\n");
+        return 0;
+    }
+    if (sub === "show") {
+        const { config, sources, warnings } = await loadConfig();
+        process.stdout.write(JSON.stringify(config, null, 2) + "\n");
+        if (sources.length === 0) {
+            process.stderr.write(color.gray(`(defaults — no file at ${shortenPath(globalConfigPath())})\n`));
+        }
+        for (const w of warnings)
+            process.stderr.write(color.yellow(`warn ${w}\n`));
+        return 0;
+    }
+    if (sub === "init") {
+        const path = globalConfigPath();
+        const starter = {
+            $schema: "https://github.com/yoavshmariahu/treekeeper",
+            roots: defaultConfig().roots,
+            minAge: "30m",
+            interval: "15m",
+            onDirty: "archive",
+            onClosedPr: "archive",
+            protectBranches: defaultConfig().protectBranches,
+            protectPaths: [],
+            sessions: { grace: "20m" },
+        };
+        try {
+            await mkdir(dirname(path), { recursive: true });
+            await writeFile(path, JSON.stringify(starter, null, 2) + "\n", { flag: "wx" });
+            process.stdout.write(`wrote ${shortenPath(path)}\n`);
+            return 0;
+        }
+        catch (err) {
+            if (err.code === "EEXIST") {
+                process.stderr.write(`${shortenPath(path)} already exists\n`);
+                return 1;
+            }
+            process.stderr.write(`could not write ${path}: ${err.message}\n`);
+            return 1;
+        }
+    }
+    process.stderr.write(USAGE + "\n");
+    return 2;
+}
+//# sourceMappingURL=config.js.map

package/dist/commands/config.js.map

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

package/dist/commands/context.d.ts

@@ -0,0 +1,34 @@
+import type { Config } from "../core/config.js";
+import type { Forge } from "../core/forge.js";
+import { Logger } from "../util/log.js";
+export interface CliFlags {
+    apply?: boolean;
+    yes?: boolean;
+    json?: boolean;
+    quiet?: boolean;
+    verbose?: boolean;
+    all?: boolean;
+    force?: boolean;
+    minAge?: string;
+    sessionGrace?: string;
+    forge?: string;
+    refresh?: boolean;
+    branchesOnly?: boolean;
+    worktreesOnly?: boolean;
+    sizes?: boolean;
+    interval?: string;
+    config?: string;
+    roots?: string[];
+}
+export interface Context {
+    config: Config;
+    logger: Logger;
+    forge: Forge;
+    warnings: string[];
+    configSources: string[];
+}
+/** Load config, apply CLI overrides, and build the shared logger and forge. */
+export declare function createContext(flags: CliFlags): Promise<Context>;
+/** Which repos a command should operate on, from positionals, `--all`, or cwd. */
+export declare function resolveRepos(ctx: Context, positionals: string[], flags: CliFlags): Promise<string[]>;
+//# sourceMappingURL=context.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../src/commands/context.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAEhD,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AAG9C,OAAO,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAC;AAGxC,MAAM,WAAW,QAAQ;IACvB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;CAClB;AAED,MAAM,WAAW,OAAO;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,KAAK,CAAC;IACb,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,aAAa,EAAE,MAAM,EAAE,CAAC;CACzB;AAED,+EAA+E;AAC/E,wBAAsB,aAAa,CAAC,KAAK,EAAE,QAAQ,GAAG,OAAO,CAAC,OAAO,CAAC,CA2BrE;AAED,kFAAkF;AAClF,wBAAsB,YAAY,CAChC,GAAG,EAAE,OAAO,EACZ,WAAW,EAAE,MAAM,EAAE,EACrB,KAAK,EAAE,QAAQ,GACd,OAAO,CAAC,MAAM,EAAE,CAAC,CAcnB"}