@elhu/pit 0.1.1

package/dist/beads.d.ts

@@ -0,0 +1,85 @@
+/**
+ * Beads (bd) CLI wrapper module.
+ *
+ * Provides a thin async layer over the `bd` CLI for ticket discovery, progress
+ * tracking, and epic management. All bd commands are invoked with `--json` for
+ * machine-readable output.
+ *
+ * ## Data Locality Finding
+ *
+ * `bd` resolves the `.beads/` database relative to the **git root**, not the
+ * working directory of the calling process. Verified by running `bd list --json`
+ * from both the main git worktree (/home/elhu/pit) and a linked worktree
+ * (/home/elhu/worktrees/pit-beads) — both returned the identical set of issues.
+ *
+ * Consequence: `execBd` can be called from any directory within the git tree
+ * and will always access the same beads database. The `cwd` option is provided
+ * for completeness and to allow callers to scope operations to a specific
+ * worktree if needed (e.g., for future bd features that are worktree-scoped),
+ * but it does NOT affect which `.beads/` database is used.
+ */
+export interface BeadTicket {
+    id: string;
+    title: string;
+    status: string;
+    priority: number;
+    issue_type: string;
+    owner: string;
+    created_at: string;
+    updated_at: string;
+}
+export interface EpicProgress {
+    done: number;
+    total: number;
+}
+/**
+ * Shell out to the `bd` CLI.
+ *
+ * Always appends `--json` to the provided args so output is machine-readable.
+ *
+ * @param args  - CLI arguments to pass to bd (without --json)
+ * @param options.cwd - Working directory for the subprocess (default: process.cwd())
+ * @returns Resolved stdout string on success
+ * @throws If bd is not installed (ENOENT) or exits with a non-zero code
+ */
+export declare function execBd(args: string[], options?: {
+    cwd?: string;
+}): Promise<string>;
+/**
+ * Return the next available (unblocked, open) ticket under an epic, or null if
+ * there is no work ready.
+ *
+ * @param epicId - The parent epic id (e.g. "pit-24s")
+ * @param options.cwd - Working directory for the subprocess
+ */
+export declare function ready(epicId: string, options?: {
+    cwd?: string;
+}): Promise<BeadTicket | null>;
+/**
+ * Return all tickets under an epic (open, in-progress, closed, etc.).
+ *
+ * @param epicId - The parent epic id
+ * @param options.cwd - Working directory for the subprocess
+ */
+export declare function list(epicId: string, options?: {
+    cwd?: string;
+}): Promise<BeadTicket[]>;
+/**
+ * Return a single ticket by ID, or null if not found / bd unavailable.
+ *
+ * @param ticketId - The ticket id (e.g. "pit-24s.3")
+ * @param options.cwd - Working directory for the subprocess
+ */
+export declare function show(ticketId: string, options?: {
+    cwd?: string;
+}): Promise<BeadTicket | null>;
+/**
+ * Compute completion progress for an epic.
+ *
+ * @param epicId - The parent epic id
+ * @param options.cwd - Working directory for the subprocess
+ */
+export declare function progress(epicId: string, options?: {
+    cwd?: string;
+}): Promise<EpicProgress>;
+//# sourceMappingURL=beads.d.ts.map

package/dist/beads.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"beads.d.ts","sourceRoot":"","sources":["../src/beads.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAWH,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;CACf;AAMD;;;;;;;;;GASG;AACH,wBAAsB,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,OAAO,CAAC,EAAE;IAAE,GAAG,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CA+BxF;AAMD;;;;;;GAMG;AACH,wBAAsB,KAAK,CACzB,MAAM,EAAE,MAAM,EACd,OAAO,CAAC,EAAE;IAAE,GAAG,CAAC,EAAE,MAAM,CAAA;CAAE,GACzB,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC,CAI5B;AAED;;;;;GAKG;AACH,wBAAsB,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;IAAE,GAAG,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC,CAG5F;AAED;;;;;GAKG;AACH,wBAAsB,IAAI,CACxB,QAAQ,EAAE,MAAM,EAChB,OAAO,CAAC,EAAE;IAAE,GAAG,CAAC,EAAE,MAAM,CAAA;CAAE,GACzB,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC,CAU5B;AAED;;;;;GAKG;AACH,wBAAsB,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;IAAE,GAAG,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,OAAO,CAAC,YAAY,CAAC,CAOhG"}

package/dist/beads.js

@@ -0,0 +1,120 @@
+/**
+ * Beads (bd) CLI wrapper module.
+ *
+ * Provides a thin async layer over the `bd` CLI for ticket discovery, progress
+ * tracking, and epic management. All bd commands are invoked with `--json` for
+ * machine-readable output.
+ *
+ * ## Data Locality Finding
+ *
+ * `bd` resolves the `.beads/` database relative to the **git root**, not the
+ * working directory of the calling process. Verified by running `bd list --json`
+ * from both the main git worktree (/home/elhu/pit) and a linked worktree
+ * (/home/elhu/worktrees/pit-beads) — both returned the identical set of issues.
+ *
+ * Consequence: `execBd` can be called from any directory within the git tree
+ * and will always access the same beads database. The `cwd` option is provided
+ * for completeness and to allow callers to scope operations to a specific
+ * worktree if needed (e.g., for future bd features that are worktree-scoped),
+ * but it does NOT affect which `.beads/` database is used.
+ */
+import { execFile } from "node:child_process";
+import { promisify } from "node:util";
+const execFileAsync = promisify(execFile);
+// ---------------------------------------------------------------------------
+// Internal helper
+// ---------------------------------------------------------------------------
+/**
+ * Shell out to the `bd` CLI.
+ *
+ * Always appends `--json` to the provided args so output is machine-readable.
+ *
+ * @param args  - CLI arguments to pass to bd (without --json)
+ * @param options.cwd - Working directory for the subprocess (default: process.cwd())
+ * @returns Resolved stdout string on success
+ * @throws If bd is not installed (ENOENT) or exits with a non-zero code
+ */
+export async function execBd(args, options) {
+    const cwd = options?.cwd ?? process.cwd();
+    try {
+        const { stdout } = await execFileAsync("bd", [...args, "--json"], { cwd });
+        return stdout;
+    }
+    catch (err) {
+        // bd is not installed or not in PATH
+        if (typeof err === "object" &&
+            err !== null &&
+            "code" in err &&
+            err.code === "ENOENT") {
+            throw new Error("bd (beads) is not installed or not in PATH", {
+                cause: err,
+            });
+        }
+        // Non-zero exit — surface stderr to caller
+        if (typeof err === "object" &&
+            err !== null &&
+            "stderr" in err &&
+            typeof err.stderr === "string") {
+            throw new Error(err.stderr, { cause: err });
+        }
+        throw err;
+    }
+}
+// ---------------------------------------------------------------------------
+// Public API
+// ---------------------------------------------------------------------------
+/**
+ * Return the next available (unblocked, open) ticket under an epic, or null if
+ * there is no work ready.
+ *
+ * @param epicId - The parent epic id (e.g. "pit-24s")
+ * @param options.cwd - Working directory for the subprocess
+ */
+export async function ready(epicId, options) {
+    const stdout = await execBd(["ready", "--parent", epicId, "--limit", "1"], options);
+    const tickets = JSON.parse(stdout);
+    return tickets.length > 0 ? tickets[0] : null;
+}
+/**
+ * Return all tickets under an epic (open, in-progress, closed, etc.).
+ *
+ * @param epicId - The parent epic id
+ * @param options.cwd - Working directory for the subprocess
+ */
+export async function list(epicId, options) {
+    const stdout = await execBd(["list", "--parent", epicId, "--limit", "0", "--all"], options);
+    return JSON.parse(stdout);
+}
+/**
+ * Return a single ticket by ID, or null if not found / bd unavailable.
+ *
+ * @param ticketId - The ticket id (e.g. "pit-24s.3")
+ * @param options.cwd - Working directory for the subprocess
+ */
+export async function show(ticketId, options) {
+    try {
+        const stdout = await execBd(["show", ticketId], options);
+        const parsed = JSON.parse(stdout);
+        // bd show --json may return an array with one element or a single object
+        const ticket = Array.isArray(parsed) ? parsed[0] : parsed;
+        return ticket ?? null;
+    }
+    catch {
+        return null; // ticket not found, bd not installed, etc.
+    }
+}
+/**
+ * Compute completion progress for an epic.
+ *
+ * @param epicId - The parent epic id
+ * @param options.cwd - Working directory for the subprocess
+ */
+export async function progress(epicId, options) {
+    const tickets = await list(epicId, options);
+    if (tickets.length === 0) {
+        return { done: 0, total: 0 };
+    }
+    const done = tickets.filter((t) => t.status === "closed").length;
+    return { done, total: tickets.length };
+}
+//# sourceMappingURL=beads.js.map

package/dist/beads.js.map

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

package/dist/cli.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# 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":""}

package/dist/cli.js

@@ -0,0 +1,39 @@
+#!/usr/bin/env node
+import { Command } from "commander";
+import { createRequire } from "node:module";
+import { registerStart } from "./commands/start.js";
+import { registerStatus } from "./commands/status.js";
+import { registerResume } from "./commands/resume.js";
+import { registerPause } from "./commands/pause.js";
+import { registerLog } from "./commands/log.js";
+import { registerStop } from "./commands/stop.js";
+import { registerTeardown } from "./commands/teardown.js";
+import { registerAdd } from "./commands/add.js";
+import { registerInit } from "./commands/init.js";
+import { registerDaemon } from "./commands/daemon.js";
+import { registerCleanup } from "./commands/cleanup.js";
+import { registerInstallKeybinding } from "./commands/install-keybinding.js";
+import { registerInstallStatus } from "./commands/install-status.js";
+const require = createRequire(import.meta.url);
+const pkg = require("../package.json");
+const program = new Command();
+program
+    .name("pit")
+    .description("tmux-based orchestrator for parallel AI coding agent sessions")
+    .version(pkg.version)
+    .option("--pretty", "Human-readable output instead of JSON");
+registerStart(program);
+registerStatus(program);
+registerResume(program);
+registerPause(program);
+registerLog(program);
+registerStop(program);
+registerTeardown(program);
+registerAdd(program);
+registerInit(program);
+registerDaemon(program);
+registerCleanup(program);
+registerInstallKeybinding(program);
+registerInstallStatus(program);
+program.parse();
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AAEA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC1D,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,EAAE,yBAAyB,EAAE,MAAM,kCAAkC,CAAC;AAC7E,OAAO,EAAE,qBAAqB,EAAE,MAAM,8BAA8B,CAAC;AAErE,MAAM,OAAO,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAC/C,MAAM,GAAG,GAAG,OAAO,CAAC,iBAAiB,CAAwB,CAAC;AAE9D,MAAM,OAAO,GAAG,IAAI,OAAO,EAAE,CAAC;AAE9B,OAAO;KACJ,IAAI,CAAC,KAAK,CAAC;KACX,WAAW,CAAC,+DAA+D,CAAC;KAC5E,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC;KACpB,MAAM,CAAC,UAAU,EAAE,uCAAuC,CAAC,CAAC;AAE/D,aAAa,CAAC,OAAO,CAAC,CAAC;AACvB,cAAc,CAAC,OAAO,CAAC,CAAC;AACxB,cAAc,CAAC,OAAO,CAAC,CAAC;AACxB,aAAa,CAAC,OAAO,CAAC,CAAC;AACvB,WAAW,CAAC,OAAO,CAAC,CAAC;AACrB,YAAY,CAAC,OAAO,CAAC,CAAC;AACtB,gBAAgB,CAAC,OAAO,CAAC,CAAC;AAC1B,WAAW,CAAC,OAAO,CAAC,CAAC;AACrB,YAAY,CAAC,OAAO,CAAC,CAAC;AACtB,cAAc,CAAC,OAAO,CAAC,CAAC;AACxB,eAAe,CAAC,OAAO,CAAC,CAAC;AACzB,yBAAyB,CAAC,OAAO,CAAC,CAAC;AACnC,qBAAqB,CAAC,OAAO,CAAC,CAAC;AAE/B,OAAO,CAAC,KAAK,EAAE,CAAC"}

package/dist/commands/add.d.ts

@@ -0,0 +1,10 @@
+import type { Command } from "commander";
+export interface AddResult {
+    success: boolean;
+    epic: string;
+    windowName: string;
+    worktreePath: string;
+    agent: string;
+}
+export declare function registerAdd(program: Command): void;
+//# sourceMappingURL=add.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"add.d.ts","sourceRoot":"","sources":["../../src/commands/add.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAMzC,MAAM,WAAW,SAAS;IACxB,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,KAAK,EAAE,MAAM,CAAC;CACf;AAED,wBAAgB,WAAW,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CA4DlD"}

package/dist/commands/add.js

@@ -0,0 +1,58 @@
+import * as crypto from "node:crypto";
+import { getClientOrFail } from "./shared.js";
+import { printError, printOutput } from "../output.js";
+export function registerAdd(program) {
+    program
+        .command("add <epic>")
+        .description("Add a new epic to an existing pit session")
+        .option("--agent <type>", "Agent type: auto, opencode, or claude-code")
+        .option("--model <value>", "Model to pass to the agent CLI")
+        .action(async (epic, opts, cmd) => {
+        const pretty = (cmd.parent?.opts()).pretty ?? false;
+        const client = await getClientOrFail({ tmuxSession: "pit" });
+        try {
+            const response = await client.send({
+                id: crypto.randomUUID(),
+                method: "add",
+                params: {
+                    epic,
+                    ...(opts.agent ? { agent: opts.agent } : {}),
+                    ...(opts.model ? { model: opts.model } : {}),
+                },
+            });
+            const result = response;
+            if (!result.success) {
+                printError({ error: result.error?.message || "Add command failed" }, pretty);
+                process.exit(1);
+                return;
+            }
+            const daemonResult = result.result;
+            if (!daemonResult) {
+                printError({ error: "No result returned from daemon" }, pretty);
+                process.exit(1);
+                return;
+            }
+            if (pretty) {
+                process.stdout.write(`Added epic ${daemonResult.epic}\n`);
+                process.stdout.write(`  Window: ${daemonResult.windowName}\n`);
+                process.stdout.write(`  Worktree: ${daemonResult.worktreePath}\n`);
+                process.stdout.write(`  Agent: ${daemonResult.agent}\n`);
+            }
+            else {
+                // Transform to legacy format
+                const legacyOutput = {
+                    success: true,
+                    epic: daemonResult.epic,
+                    windowName: daemonResult.windowName,
+                    worktreePath: daemonResult.worktreePath,
+                    agent: daemonResult.agent,
+                };
+                printOutput(legacyOutput, false);
+            }
+        }
+        finally {
+            client.close();
+        }
+    });
+}
+//# sourceMappingURL=add.js.map

package/dist/commands/add.js.map

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

package/dist/commands/cleanup.d.ts

@@ -0,0 +1,13 @@
+import type { Command } from "commander";
+export interface CleanupOutput {
+    cleaned: string[];
+    skipped: string[];
+    totalCleaned: number;
+    totalSkipped: number;
+}
+/**
+ * Core cleanup logic. Exported for testability.
+ */
+export declare function runCleanup(dryRun: boolean): Promise<CleanupOutput>;
+export declare function registerCleanup(program: Command): void;
+//# sourceMappingURL=cleanup.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"cleanup.d.ts","sourceRoot":"","sources":["../../src/commands/cleanup.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AASzC,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;CACtB;AA6ED;;GAEG;AACH,wBAAsB,UAAU,CAAC,MAAM,EAAE,OAAO,GAAG,OAAO,CAAC,aAAa,CAAC,CAmDxE;AAMD,wBAAgB,eAAe,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAuCtD"}

package/dist/commands/cleanup.js

@@ -0,0 +1,174 @@
+import * as fsp from "node:fs/promises";
+import * as path from "node:path";
+import { cleanup as rmDir } from "../signals.js";
+import { printOutput, printError } from "../output.js";
+// Base directory for all pit session dirs
+const PIT_BASE_DIR = "/tmp/pit";
+/**
+ * Checks if a PID corresponds to a running process.
+ * Returns:
+ *   "alive"  — process is alive (kill(0) succeeded, or EPERM)
+ *   "dead"   — process does not exist (ESRCH)
+ */
+function isPidAlive(pid) {
+    try {
+        process.kill(pid, 0);
+        return "alive";
+    }
+    catch (err) {
+        const code = err.code;
+        if (code === "ESRCH") {
+            return "dead";
+        }
+        // EPERM — process exists but we can't signal it → conservative: treat as alive
+        return "alive";
+    }
+}
+/**
+ * Determines whether a session directory under /tmp/pit/<sessionId> is dead.
+ *
+ * Decision tree (evaluated in order):
+ * 1. Directory is empty → DEAD
+ * 2. Has daemon.lock but no daemon.pid → ALIVE (mid-startup)
+ * 3. Has daemon.pid and PID is alive → ALIVE
+ * 4. Has daemon.pid but PID is dead → DEAD
+ * 5. No daemon.pid and no daemon.lock → DEAD
+ */
+async function isSessionDead(sessionPath) {
+    let entries;
+    try {
+        const dirents = await fsp.readdir(sessionPath);
+        entries = dirents;
+    }
+    catch {
+        // Can't read directory → skip conservatively
+        return false;
+    }
+    // 1. Empty directory → DEAD
+    if (entries.length === 0) {
+        return true;
+    }
+    const hasDaemonLock = entries.includes("daemon.lock");
+    const hasDaemonPid = entries.includes("daemon.pid");
+    // 2. Has daemon.lock but no daemon.pid → mid-startup → ALIVE
+    if (hasDaemonLock && !hasDaemonPid) {
+        return false;
+    }
+    // 3 & 4. Has daemon.pid → check PID liveness
+    if (hasDaemonPid) {
+        const pidPath = path.join(sessionPath, "daemon.pid");
+        let pidStr;
+        try {
+            pidStr = await fsp.readFile(pidPath, "utf8");
+        }
+        catch {
+            // Can't read PID file → conservative: treat as alive
+            return false;
+        }
+        const pid = parseInt(pidStr.trim(), 10);
+        if (isNaN(pid)) {
+            // Malformed PID file → conservative: treat as alive
+            return false;
+        }
+        return isPidAlive(pid) === "dead";
+    }
+    // 5. No daemon.pid and no daemon.lock → DEAD
+    return true;
+}
+/**
+ * Core cleanup logic. Exported for testability.
+ */
+export async function runCleanup(dryRun) {
+    const cleaned = [];
+    const skipped = [];
+    // If /tmp/pit/ doesn't exist, return 0 cleaned, 0 skipped
+    let entries;
+    try {
+        entries = await fsp.readdir(PIT_BASE_DIR);
+    }
+    catch (err) {
+        if (err.code === "ENOENT") {
+            return { cleaned: [], skipped: [], totalCleaned: 0, totalSkipped: 0 };
+        }
+        throw err;
+    }
+    for (const entry of entries) {
+        const sessionPath = path.join(PIT_BASE_DIR, entry);
+        // Verify it's a directory
+        let stat;
+        try {
+            stat = await fsp.stat(sessionPath);
+        }
+        catch {
+            // Can't stat → skip
+            skipped.push(entry);
+            continue;
+        }
+        if (!stat.isDirectory()) {
+            skipped.push(entry);
+            continue;
+        }
+        const dead = await isSessionDead(sessionPath);
+        if (dead) {
+            if (!dryRun) {
+                await rmDir(sessionPath);
+            }
+            cleaned.push(entry);
+        }
+        else {
+            skipped.push(entry);
+        }
+    }
+    return {
+        cleaned,
+        skipped,
+        totalCleaned: cleaned.length,
+        totalSkipped: skipped.length,
+    };
+}
+// ---------------------------------------------------------------------------
+// Command registration
+// ---------------------------------------------------------------------------
+export function registerCleanup(program) {
+    program
+        .command("cleanup")
+        .description("Garbage-collect stale pit session directories under /tmp/pit/")
+        .option("--dry-run", "List stale session directories without removing them")
+        .action(async (opts, cmd) => {
+        const pretty = cmd.parent?.opts().pretty;
+        const dryRun = opts.dryRun;
+        let result;
+        try {
+            result = await runCleanup(dryRun);
+        }
+        catch (err) {
+            printError({ error: `Cleanup failed: ${err.message}` }, pretty);
+            process.exit(1);
+            return;
+        }
+        if (pretty) {
+            if (result.totalCleaned === 0 && result.totalSkipped === 0) {
+                process.stdout.write("No pit session directories found.\n");
+            }
+            else {
+                if (result.cleaned.length > 0) {
+                    const verb = dryRun ? "Would remove" : "Removed";
+                    process.stdout.write(`${verb} ${result.totalCleaned} stale session(s):\n`);
+                    for (const id of result.cleaned) {
+                        process.stdout.write(`  - ${id}\n`);
+                    }
+                }
+                else {
+                    process.stdout.write("No stale sessions found.\n");
+                }
+                if (result.skipped.length > 0) {
+                    process.stdout.write(`Skipped ${result.totalSkipped} active session(s).\n`);
+                }
+            }
+        }
+        else {
+            printOutput(result, false);
+        }
+    });
+}
+//# sourceMappingURL=cleanup.js.map

package/dist/commands/cleanup.js.map

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

package/dist/commands/daemon.d.ts

@@ -0,0 +1,3 @@
+import type { Command } from "commander";
+export declare function registerDaemon(program: Command): void;
+//# sourceMappingURL=daemon.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"daemon.d.ts","sourceRoot":"","sources":["../../src/commands/daemon.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AA2GzC,wBAAgB,cAAc,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAmFrD"}