waterplane 0.0.1 → 0.1.11

package/packages/host/dist/weekburn.js

@@ -0,0 +1,251 @@
+/**
+ * The week-end burn's plumbing: the weekly pick on disk, the observer that
+ * posts one small backlog package per picked repo while the week has budget
+ * left, and the once-a-week nudge.
+ *
+ * Every rule (when to start, when to stop, whether to nudge, what the agent is
+ * told) is `shared/weekburn.ts`, so the phone's sheet and this observer cannot
+ * word it two ways. This module only reads the reading, asks those functions,
+ * posts, remembers.
+ *
+ * - **The pick is the approval.** Nothing posts without `pickedFor(prefs,
+ *   weeklyResetAt)`: a pick bound to THIS week. `recurring` only re-asks.
+ * - **Lazily, one at a time.** At most ONE live (`queued`/`blocked`/
+ *   `starting`/`running`) row per picked repo carries a `weekburn:` origin; the
+ *   next is posted only after it settles, and never more than
+ *   `WATERPLANE_WEEKBURN_MAX_PER_REPO` (6) a week per repo. The count is
+ *   written BEFORE the post: a crash between the two loses a package, never
+ *   doubles one.
+ * - **Ordinary backlog rows** (`BacklogManager.add`): `auto`, serial per repo,
+ *   the slot cap and halt apply. Their own fresh session, closed when done, and
+ *   a weekly `budgetPass` up to the reset — the weekly ceiling is lifted for
+ *   these rows only (`shared/intent/budgetpass.ts`).
+ * - **No timers.** `UsageChecker`'s callback drives `observe` (like
+ *   `burnwatch.ts`), and `armed()` is what `main.ts`'s `syncUsagePolling` asks.
+ *   A missing or stale reading posts nothing (`weekBurnStopText`).
+ */
+import { join } from "node:path";
+import { cleanWeekBurnPrefs, envName, healthCapWords, pickedFor, weekBurnItemPrompt, weekBurnNudge, weekBurnPlan, weekBurnStopText, RESET_MATCH_MS, WEEKBURN_MEASURE_MS, } from "@waterplane/shared";
+import { readJsonGuarded, writeJsonAtomic } from "./jsonstore.js";
+/** Origin prefix every row this module posts carries: `weekburn:<weekOf>`. */
+export const WEEKBURN_ORIGIN = "weekburn:";
+export const WEEKBURN_DEFAULT_MAX_PER_REPO = 6;
+const LIVE = new Set(["queued", "blocked", "starting", "running"]);
+/** The plan's measurement looks back 14 days; a day of slack for the week's pace. */
+const SAMPLES_LOOKBACK_MS = WEEKBURN_MEASURE_MS + 24 * 3_600_000;
+function envInt(name, fallback) {
+    const raw = process.env[name];
+    if (raw == null || raw.trim() === "")
+        return fallback;
+    const n = Number(raw);
+    return Number.isInteger(n) && n >= 0 ? n : fallback;
+}
+/** Hand-editable file: anything off-shape falls back field by field. */
+export function cleanWeekBurnStore(x) {
+    const o = x && typeof x === "object" && !Array.isArray(x) ? x : {};
+    const posted = {};
+    if (o.posted && typeof o.posted === "object" && !Array.isArray(o.posted)) {
+        for (const [k, v] of Object.entries(o.posted)) {
+            const r = v;
+            if (r && typeof r.weekOf === "number" && Number.isFinite(r.weekOf) && typeof r.count === "number" && Number.isInteger(r.count) && r.count >= 0) {
+                posted[k] = { weekOf: r.weekOf, count: r.count };
+            }
+        }
+    }
+    const n = o.nudgedWeekOf;
+    return { prefs: cleanWeekBurnPrefs(o.prefs), nudgedWeekOf: typeof n === "number" && Number.isFinite(n) ? n : null, posted };
+}
+/** The repo-health summary as lines for the agent's prompt; null when there is none. */
+export function healthSummaryText(s) {
+    if (!s || !Number.isFinite(s.value))
+        return null;
+    const lines = [`Health index ${Math.round(s.value)}/100 (week of ${s.week}${s.deltaWeek != null ? `, ${s.deltaWeek >= 0 ? "+" : ""}${Math.round(s.deltaWeek)} on the week` : ""}).`];
+    if (s.mean != null && s.cappedBy !== undefined) {
+        const cap = healthCapWords({ value: s.value, mean: s.mean, cappedBy: s.cappedBy });
+        if (cap)
+            lines.push(cap);
+    }
+    if (s.alertText)
+        lines.push(s.alertText);
+    return lines.join("\n");
+}
+const sameWeek = (a, b) => a != null && b != null && Math.abs(a - b) <= RESET_MATCH_MS;
+export function createWeekBurn(deps) {
+    const now = deps.now ?? Date.now;
+    const maxPerRepo = deps.maxPerRepo ?? envInt(envName("WEEKBURN_MAX_PER_REPO"), WEEKBURN_DEFAULT_MAX_PER_REPO);
+    const file = join(deps.stateDir, "weekburn.json");
+    let store = cleanWeekBurnStore(readJsonGuarded(file, {}));
+    let inFlight = null;
+    const save = () => {
+        try {
+            writeJsonAtomic(file, store);
+        }
+        catch { /* an unwritable state dir keeps the in-memory copy */ }
+    };
+    /** Live burn rows by repo dir (any week's: a row still running after a cancel is still running). */
+    function liveByRepo() {
+        const out = new Map();
+        for (const r of deps.rows()) {
+            if (r.origin?.startsWith(WEEKBURN_ORIGIN) && LIVE.has(r.state) && !out.has(r.cwd))
+                out.set(r.cwd, r.id);
+        }
+        return out;
+    }
+    const countFor = (repo, weekOf) => {
+        const p = store.posted[repo];
+        return p && sameWeek(p.weekOf, weekOf) ? p.count : 0;
+    };
+    const readingAt = (u) => (u.ok && u.checkedAt > 0 ? u.checkedAt : null);
+    async function run(u) {
+        const t = now();
+        const subscription = deps.subscription();
+        const { prefs } = store;
+        const samples = deps.usageLog.read(SAMPLES_LOOKBACK_MS).samples;
+        const at = readingAt(u);
+        // The nudge: words only, once per week, never while a pick for this week exists.
+        if (deps.notifyOn()) {
+            const words = weekBurnNudge({
+                samples, prefs, weeklyPct: u.weeklyPct, weeklyResetAt: u.weeklyResetAt, readingAt: at, subscription, nudgedWeekOf: store.nudgedWeekOf, now: t,
+            });
+            if (words && u.weeklyResetAt != null) {
+                store.nudgedWeekOf = u.weeklyResetAt;
+                save(); // before the push: lose one, never repeat one
+                // No `open`: the phone maps the `weekburn` kind to its sheet (notifications `notifTarget`).
+                deps.notify("weekburn", { ...words, tag: "weekburn" });
+                deps.changed?.();
+            }
+        }
+        if (!subscription || !pickedFor(prefs, u.weeklyResetAt) || prefs.weekOf == null || u.weeklyResetAt == null)
+            return [];
+        const plan = weekBurnPlan({ samples, weeklyPct: u.weeklyPct, weeklyResetAt: u.weeklyResetAt, stopPct: prefs.stopPct, now: t });
+        if (!plan || t < plan.startAt)
+            return [];
+        if (weekBurnStopText({ weeklyPct: u.weeklyPct, weeklyResetAt: u.weeklyResetAt, stopPct: prefs.stopPct, now: t, readingAt: at }) !== null)
+            return [];
+        let known;
+        try {
+            known = await deps.repos();
+        }
+        catch {
+            return [];
+        }
+        const live = liveByRepo();
+        const weekOf = prefs.weekOf;
+        const posted = [];
+        for (const repo of prefs.repos) {
+            if (live.has(repo))
+                continue;
+            const count = countFor(repo, weekOf);
+            if (count >= maxPerRepo)
+                continue;
+            const target = known.find((k) => k.worktreePath === repo);
+            if (!target)
+                continue; // gone from the discovered list: never a cwd
+            store.posted[repo] = { weekOf, count: count + 1 };
+            save(); // before the post: at-most-once matters more than the count
+            const text = weekBurnItemPrompt({ repoName: target.repoName, healthSummary: healthSummaryText(deps.health?.(repo)) });
+            const item = deps.add(text, repo, "week-end burn", {
+                origin: `${WEEKBURN_ORIGIN}${weekOf}`, closeWhenDone: true,
+                budgetPass: { window: "weekly", from: t, until: u.weeklyResetAt },
+            });
+            if (item.status !== "failed")
+                posted.push(item.id);
+        }
+        return posted;
+    }
+    function status() {
+        const t = now();
+        const u = deps.usage();
+        const { prefs } = store;
+        const subscription = deps.subscription();
+        const hasReading = u.ok && u.weeklyPct != null && u.weeklyResetAt != null;
+        const available = subscription && hasReading;
+        const unavailableText = !subscription
+            ? "The week-end burn needs a subscription account: this account has no weekly window to spend."
+            : !hasReading ? "No weekly reading yet: the week-end burn waits for the /usage screen to name the week's percent and reset." : undefined;
+        const plan = available
+            ? weekBurnPlan({ samples: deps.usageLog.read(SAMPLES_LOOKBACK_MS).samples, weeklyPct: u.weeklyPct, weeklyResetAt: u.weeklyResetAt, stopPct: prefs.stopPct, now: t })
+            : null;
+        const picked = pickedFor(prefs, u.weeklyResetAt);
+        const live = liveByRepo();
+        const dirs = [...(picked ? prefs.repos : []), ...[...live.keys()].filter((d) => !(picked && prefs.repos.includes(d)))];
+        const running = dirs.map((repoDir) => {
+            const posted = prefs.weekOf != null ? countFor(repoDir, prefs.weekOf) : 0;
+            return {
+                repoDir, posted, live: live.get(repoDir) ?? null,
+                ...(posted >= maxPerRepo ? { stoppedText: `Done for the week: ${maxPerRepo} packages posted.` } : {}),
+            };
+        });
+        const stop = picked ? weekBurnStopText({ weeklyPct: u.weeklyPct, weeklyResetAt: u.weeklyResetAt, stopPct: prefs.stopPct, now: t, readingAt: readingAt(u) }) : null;
+        return {
+            prefs, available, ...(unavailableText ? { unavailableText } : {}),
+            weeklyPct: u.weeklyPct, weeklyResetAt: u.weeklyResetAt, plan, pickedThisWeek: picked, running,
+            ...(stop ? { stoppedText: stop } : {}),
+        };
+    }
+    async function update(body) {
+        const next = { ...store.prefs };
+        if (typeof body.recurring === "boolean")
+            next.recurring = body.recurring;
+        if (typeof body.stopPct === "number")
+            next.stopPct = body.stopPct;
+        const wanted = body.sameAsLast === true ? store.prefs.lastRepos : body.repos;
+        if (wanted !== undefined) {
+            if (!Array.isArray(wanted))
+                return { error: "repos must be a list of repo folders." };
+            const asked = wanted.filter((d) => typeof d === "string");
+            let known = [];
+            if (asked.length) {
+                try {
+                    known = await deps.repos();
+                }
+                catch {
+                    known = [];
+                }
+            }
+            const repos = [...new Set(asked)].filter((d) => known.some((k) => k.worktreePath === d)); // unknown dropped, never spawned
+            if (repos.length) {
+                const resetAt = deps.usage().weeklyResetAt;
+                if (resetAt == null)
+                    return { error: "No weekly reset reading yet, so there is no week to bind the pick to. Try again once /usage has been read." };
+                next.repos = repos;
+                next.weekOf = resetAt;
+                next.lastRepos = repos;
+            }
+            else {
+                // Cancel this week: live rows finish, nothing new is posted.
+                next.repos = [];
+                next.weekOf = null;
+            }
+        }
+        store = { ...store, prefs: cleanWeekBurnPrefs(next) };
+        save();
+        deps.changed?.();
+        await api.observe(deps.usage()); // a pick at or after the start acts now, not on the next poll
+        return { status: status() };
+    }
+    const api = {
+        observe(u) {
+            if (inFlight)
+                return inFlight.then(() => []);
+            inFlight = run(u).catch(() => []).finally(() => { inFlight = null; });
+            return inFlight;
+        },
+        armed() {
+            if (!deps.subscription())
+                return false;
+            const { prefs } = store;
+            if (prefs.recurring)
+                return true;
+            const resetAt = deps.usage().weeklyResetAt;
+            if (pickedFor(prefs, resetAt))
+                return true;
+            // A nudge could still be due: the kind is on and this week's has not gone out.
+            return deps.notifyOn() && !sameWeek(store.nudgedWeekOf, resetAt);
+        },
+        status,
+        update,
+    };
+    return api;
+}
+//# sourceMappingURL=weekburn.js.map

package/packages/host/dist/weekburn.js.map

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

package/packages/host/dist/wirerecord.d.ts

@@ -0,0 +1,5 @@
+export declare const WIRE: boolean;
+/** A frame as the host sent (`out`) or received (`in`) it. */
+export declare function recordWireFrame(dir: "out" | "in", msg: unknown): void;
+/** One `/api` JSON response (body parsed back so the file stays line-per-record). */
+export declare function recordWireHttp(method: string, path: string, status: number, body: Buffer): void;

package/packages/host/dist/wirerecord.js

@@ -0,0 +1,128 @@
+/**
+ * Record mode: `WATERPLANE_WIRE_RECORD=<file>` appends one JSON line per WebSocket
+ * frame (both directions) and per `/api` JSON response. It is the SOURCE of the
+ * demo scenarios (docs/analysis/demo-mode-plan.md §3): `tools/demo-scenario.mjs`
+ * turns a recording of the stub-driven host into a scenario skeleton.
+ *
+ * Zero-cost when unset: `WIRE` is a constant `false`, every call site is
+ * `if (WIRE) recordWire…`, and nothing here runs. A recording is RAW — real
+ * roots, prompts, numbers — and is never to be shipped; only the tool's
+ * fail-closed scrub makes it fit to.
+ *
+ * Because it is raw, how the file is WRITTEN is a security property, not a
+ * detail (adversarial review, 2026-10):
+ * - owner-only: created 0600 and an existing file tightened to 0600 before the
+ *   first append; opened `O_NOFOLLOW` and refused unless it is a regular file
+ *   this user owns — a path in a shared `/tmp` must not become a way to append
+ *   to someone's file through a planted symlink, or into a file another user
+ *   created to read;
+ * - secrets never reach disk even raw: a value under a secret-named key (an
+ *   `auth.set` password, a token in a response body) and a secret-named query
+ *   parameter are replaced with `[redacted]` here, at the source;
+ * - capped: recording stops at `CAP_BYTES` with one line on stderr — a knob
+ *   left on in a `.env` must not fill the disk;
+ * - loud: turning it on prints a line on stderr at start, because the knob can
+ *   come from any of the `.env` files `env.ts` reads, not only the shell.
+ */
+import { closeSync, constants, fchmodSync, fstatSync, openSync, writeSync } from "node:fs";
+import { envName, logTag } from "@waterplane/shared";
+import { env } from "./env.js";
+const FILE = env("WIRE_RECORD") ?? "";
+export const WIRE = FILE !== "";
+/** Recording stops here; a stub demo session is a few hundred KB. */
+const CAP_BYTES = 256 * 1024 * 1024;
+const SECRET_KEY = /^(token|password|passwd|passphrase|secret|clientSecret|cookie|authorization|apikey|api_key|accessToken|refreshToken|idToken|privateKey|credentials?)$/i;
+const SECRET_PARAM = /^(token|access_token|auth|key|apikey|api_key|sig|signature|password|pw|secret|code)$/i;
+const REDACTED = "[redacted]";
+if (WIRE)
+    console.warn(`${logTag} ${envName("WIRE_RECORD")} is ON: every frame and /api response is appended, raw, to ${FILE} — unset it unless you are recording a demo`);
+let fd; // undefined = not opened yet, null = refused or stopped
+let size = 0;
+function stop(why) {
+    console.warn(`${logTag} wire recording stopped: ${why}`);
+    if (typeof fd === "number") {
+        try {
+            closeSync(fd);
+        }
+        catch { /* already */ }
+    }
+    fd = null;
+    return null;
+}
+function open() {
+    try {
+        const f = openSync(FILE, constants.O_WRONLY | constants.O_APPEND | constants.O_CREAT | (constants.O_NOFOLLOW ?? 0), 0o600);
+        fd = f;
+        const st = fstatSync(f);
+        if (!st.isFile())
+            return stop(`${FILE} is not a regular file`);
+        if (typeof process.getuid === "function" && st.uid !== process.getuid())
+            return stop(`${FILE} belongs to another user`);
+        fchmodSync(f, 0o600);
+        size = st.size;
+        return f;
+    }
+    catch (e) {
+        return stop(`cannot open ${FILE} (${e.code ?? String(e)}; a symlink is refused)`);
+    }
+}
+/** A copy with every secret-named key's value replaced. */
+function redact(v, depth = 0) {
+    if (depth > 64 || v === null || typeof v !== "object")
+        return v;
+    if (Array.isArray(v))
+        return v.map((x) => redact(x, depth + 1));
+    const o = {};
+    for (const [k, x] of Object.entries(v)) {
+        o[k] = SECRET_KEY.test(k) && x !== null && x !== "" && x !== undefined && x !== false ? REDACTED : redact(x, depth + 1);
+    }
+    return o;
+}
+function redactPath(path) {
+    const q = path.indexOf("?");
+    if (q < 0)
+        return path;
+    const params = path.slice(q + 1).split("&").map((kv) => {
+        const eq = kv.indexOf("=");
+        if (eq < 0)
+            return kv;
+        let name = kv.slice(0, eq);
+        try {
+            name = decodeURIComponent(name);
+        }
+        catch { /* keep raw */ }
+        return SECRET_PARAM.test(name) ? `${kv.slice(0, eq)}=${REDACTED}` : kv;
+    });
+    return path.slice(0, q + 1) + params.join("&");
+}
+function write(line) {
+    try {
+        const f = fd === undefined ? open() : fd;
+        if (f === null)
+            return;
+        const buf = Buffer.from(JSON.stringify(line) + "\n", "utf8");
+        if (size + buf.length > CAP_BYTES) {
+            stop(`the ${CAP_BYTES / 1024 / 1024} MB cap on ${FILE} is reached`);
+            return;
+        }
+        writeSync(f, buf);
+        size += buf.length;
+    }
+    catch { /* a recording must never break the host */ }
+}
+/** A frame as the host sent (`out`) or received (`in`) it. */
+export function recordWireFrame(dir, msg) {
+    write({ at: Date.now(), dir, msg: redact(msg) });
+}
+/** One `/api` JSON response (body parsed back so the file stays line-per-record). */
+export function recordWireHttp(method, path, status, body) {
+    let parsed;
+    try {
+        parsed = JSON.parse(body.toString("utf8"));
+    }
+    catch {
+        parsed = null;
+    }
+    write({ at: Date.now(), dir: "http", method, path: redactPath(path), status, body: redact(parsed) });
+}
+//# sourceMappingURL=wirerecord.js.map

package/packages/host/dist/wirerecord.js.map

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

package/packages/host/dist/worktreeleftover.d.ts

@@ -0,0 +1,36 @@
+import type { SessionInfo, WorktreeLeftover } from "@waterplane/shared";
+/**
+ * How long a worktree must have sat untouched before it is offered for removal.
+ * A wave of agents gets its worktrees a moment before the agents start, and a
+ * fresh one is clean by definition — every other check passes on it. An hour of
+ * no git activity is what separates "about to be used" from "left behind".
+ */
+export declare const LEFTOVER_IDLE_MIN = 60;
+export interface LeftoverInput {
+    wt: string;
+    branch: string;
+    sessions: Pick<SessionInfo, "cwd">[];
+    /** `worktreeOwners()` names a live session for this worktree. */
+    ownerLive: boolean;
+}
+/**
+ * The worktree's folder no longer exists. Discovery drops such a worktree, but a
+ * scan can be a moment old: without this the first git call fails with
+ * `spawn git ENOENT` (Node's words for a missing cwd), which reads like git
+ * itself is missing. Nothing to measure in a folder that is gone, so no reading.
+ */
+export declare class WorktreeGone extends Error {
+    constructor(wt: string);
+}
+export declare function worktreeLeftover({ wt, branch, sessions, ownerLive }: LeftoverInput): Promise<WorktreeLeftover>;
+export type RemoveResult = {
+    ok: true;
+    leftover: WorktreeLeftover;
+    branchDeleted: boolean;
+    note?: string;
+} | {
+    ok: false;
+    leftover?: WorktreeLeftover;
+    error: string;
+};
+export declare function removeLeftover(input: LeftoverInput): Promise<RemoveResult>;

package/packages/host/dist/worktreeleftover.js

@@ -0,0 +1,169 @@
+import { existsSync, readdirSync, statSync } from "node:fs";
+import { join, sep } from "node:path";
+import { execFileP as pexec } from "./proc.js";
+/**
+ * A worktree nobody is using, and whether it can go.
+ *
+ * They pile up because the thing that made one is not around to remove it: an
+ * orchestrating session runs `git worktree add` for a wave of agents and then
+ * dies (a limit, a closed tab) before its cleanup step — measured here, five
+ * `fix-*` worktrees at main's own commit, made a minute before their session's
+ * last record. The launcher showed them as bare rows with no word on why.
+ *
+ * Removing one is only ever offered when NOTHING lives only there — see
+ * `WorktreeLeftover`. The remove re-derives the whole check rather than trusting
+ * the reading the phone looked at, and uses `git worktree remove` WITHOUT
+ * `--force` and `git branch -d` where it can, so git refuses too if this check
+ * is ever wrong.
+ */
+const TIMEOUT = 15_000;
+async function git(cwd, args) {
+    const { stdout } = await pexec("git", args, { cwd, timeout: TIMEOUT, maxBuffer: 8 * 1024 * 1024 });
+    return stdout;
+}
+/** The primary checkout's path and branch: `git worktree list`'s first entry. */
+async function primaryOf(wt) {
+    const out = await git(wt, ["worktree", "list", "--porcelain"]);
+    const first = out.split("\n\n")[0] ?? "";
+    const path = /^worktree (.+)$/m.exec(first)?.[1]?.trim() ?? "";
+    const branch = /^branch refs\/heads\/(.+)$/m.exec(first)?.[1]?.trim() ?? null;
+    return { path, branch };
+}
+/** Files under the gitignored transport dirs — nothing in git would save them. */
+function countTransport(wt) {
+    let n = 0;
+    const walk = (dir, depth) => {
+        if (depth > 6)
+            return;
+        let ents;
+        try {
+            ents = readdirSync(dir, { withFileTypes: true });
+        }
+        catch {
+            return;
+        }
+        for (const e of ents) {
+            if (e.isDirectory())
+                walk(join(dir, e.name), depth + 1);
+            // The read markers are bookkeeping, not anybody's file.
+            else if (!e.name.startsWith(".seen"))
+                n++;
+        }
+    };
+    walk(join(wt, ".claude", "outbox"), 0);
+    walk(join(wt, ".claude", "inbox"), 0);
+    return n;
+}
+/**
+ * How long a worktree must have sat untouched before it is offered for removal.
+ * A wave of agents gets its worktrees a moment before the agents start, and a
+ * fresh one is clean by definition — every other check passes on it. An hour of
+ * no git activity is what separates "about to be used" from "left behind".
+ */
+export const LEFTOVER_IDLE_MIN = 60;
+/** Minutes since git last wrote this worktree's HEAD, index or reflog. */
+async function idleMinutes(wt) {
+    try {
+        const admin = (await git(wt, ["rev-parse", "--absolute-git-dir"])).trim();
+        let newest = 0;
+        for (const f of ["HEAD", "index", join("logs", "HEAD")]) {
+            try {
+                newest = Math.max(newest, statSync(join(admin, f)).mtimeMs);
+            }
+            catch { /* absent is fine */ }
+        }
+        return newest ? Math.floor((Date.now() - newest) / 60_000) : null;
+    }
+    catch {
+        return null;
+    }
+}
+const plural = (n, one, many = `${one}s`) => `${n} ${n === 1 ? one : many}`;
+/**
+ * The worktree's folder no longer exists. Discovery drops such a worktree, but a
+ * scan can be a moment old: without this the first git call fails with
+ * `spawn git ENOENT` (Node's words for a missing cwd), which reads like git
+ * itself is missing. Nothing to measure in a folder that is gone, so no reading.
+ */
+export class WorktreeGone extends Error {
+    constructor(wt) {
+        super(`The worktree folder ${wt} is gone. git still lists it until \`git worktree prune\` runs in the main checkout.`);
+        this.name = "WorktreeGone";
+    }
+}
+export async function worktreeLeftover({ wt, branch, sessions, ownerLive }) {
+    if (!existsSync(wt))
+        throw new WorktreeGone(wt);
+    const blockers = [];
+    const primary = await primaryOf(wt);
+    const base = primary.branch ?? "";
+    if (!primary.path || primary.path === wt)
+        blockers.push("This is the repo's main checkout, not a worktree.");
+    if (!base)
+        blockers.push("The main checkout is on no branch, so there is nothing to check this worktree's commits against.");
+    let ahead = 0;
+    let unlanded = 0;
+    if (base) {
+        ahead = Number((await git(wt, ["rev-list", "--count", "HEAD", "--not", `refs/heads/${base}`])).trim()) || 0;
+        // `+` = a commit whose patch is not on base. A cherry-picked agent commit
+        // has a new SHA on main but the same patch, so it is `-` and counts as landed.
+        if (ahead > 0)
+            unlanded = (await git(wt, ["cherry", `refs/heads/${base}`, "HEAD"])).split("\n").filter((l) => l.startsWith("+")).length;
+    }
+    if (unlanded > 0)
+        blockers.push(`${plural(unlanded, "commit")} on ${branch} ${unlanded === 1 ? "is" : "are"} not on ${base}.`);
+    // --no-optional-locks: a read must not refresh the index, which would reset
+    // the idle clock below to "just now".
+    const uncommitted = (await git(wt, ["--no-optional-locks", "status", "--porcelain"])).split("\n").filter(Boolean).length;
+    if (uncommitted > 0)
+        blockers.push(`${plural(uncommitted, "file")} changed or new and not committed.`);
+    const transport = countTransport(wt);
+    if (transport > 0)
+        blockers.push(`${plural(transport, "file")} in its .claude/outbox or .claude/inbox, which git does not keep.`);
+    const inside = (cwd) => cwd === wt || cwd.startsWith(wt + sep);
+    const live = sessions.filter((s) => s.cwd && inside(s.cwd)).length;
+    if (live > 0)
+        blockers.push(`${plural(live, "session")} running in it.`);
+    if (ownerLive)
+        blockers.push("The session whose agent made it is still open.");
+    const idle = await idleMinutes(wt);
+    if (idle === null)
+        blockers.push("Could not tell when it was last used.");
+    else if (idle < LEFTOVER_IDLE_MIN)
+        blockers.push(`Used ${idle === 0 ? "just now" : `${plural(idle, "minute")} ago`} — something may be about to work in it. Ask again after ${LEFTOVER_IDLE_MIN} minutes untouched.`);
+    return { branch, base, ahead, unlanded, uncommitted, transport, sessions: live, ownerLive, idleMinutes: idle, blockers };
+}
+export async function removeLeftover(input) {
+    const { wt, branch } = input;
+    let leftover;
+    try {
+        leftover = await worktreeLeftover(input);
+    }
+    catch (err) {
+        if (err instanceof WorktreeGone)
+            return { ok: false, error: err.message };
+        return { ok: false, error: `Could not check the worktree: ${err.message}` };
+    }
+    if (leftover.blockers.length)
+        return { ok: false, leftover, error: leftover.blockers.join(" ") };
+    const primary = await primaryOf(wt);
+    try {
+        // No --force: git refuses a dirty or locked worktree on its own.
+        await git(primary.path, ["worktree", "remove", wt]);
+    }
+    catch (err) {
+        return { ok: false, leftover, error: `git refused: ${err.message.split("\n").slice(-3).join(" ").trim()}` };
+    }
+    if (branch === "(detached)" || !branch)
+        return { ok: true, leftover, branchDeleted: false };
+    try {
+        // -d when git can see it is merged; -D only when every commit was
+        // just shown to be on base by patch (cherry-picked).
+        await git(primary.path, ["branch", leftover.ahead > 0 ? "-D" : "-d", branch]);
+        return { ok: true, leftover, branchDeleted: true };
+    }
+    catch (err) {
+        return { ok: true, leftover, branchDeleted: false, note: `The worktree is gone; its branch ${branch} stayed: ${err.message.trim().split("\n")[0]}` };
+    }
+}
+//# sourceMappingURL=worktreeleftover.js.map

package/packages/host/dist/worktreeleftover.js.map

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