@chances-ai/engine 24.0.0

package/dist/core/worktree/create.js

@@ -0,0 +1,121 @@
+import { mkdir, stat } from "node:fs/promises";
+import { ensureChancesExcludeEntry, findCanonicalRoot, gitBranchDelete, gitWorktreeAdd, gitWorktreeRemove, } from "./git.js";
+import { branchNameFor, isAgentSlug, newAgentSlug } from "./slug.js";
+import { writeActiveMarker } from "./active-marker.js";
+import { worktreePathFor, worktreesDir } from "./paths.js";
+import { WorktreeError } from "./errors.js";
+/**
+ * Creates a fresh `.chances/worktrees/<slug>` worktree for an isolated
+ * subagent. Per Round-1:
+ *
+ *  - AbortSignal-aware: cancellation kills the in-flight `git worktree add`
+ *    and runs idempotent cleanup before rethrowing (MUST-FIX #3).
+ *  - Slug-collision retry up to `maxSlugAttempts` (NICE #2).
+ *  - Canonical-root resolution so `chances`-from-inside-a-user-worktree
+ *    doesn't nest a new worktree under the user's (SHOULD-FIX #3).
+ *  - `.git/info/exclude` ensured for `.chances/worktrees/` so the parent's
+ *    `git status` stays clean (SHOULD-FIX #1).
+ *  - Writes the `.chances-active` heartbeat marker so cross-process GC can
+ *    detect a live owner (MUST-FIX #4 + SHOULD-FIX #5).
+ */
+export async function createAgentWorktree(cwd, opts = {}) {
+    const { signal } = opts;
+    const maxAttempts = Math.max(1, opts.maxSlugAttempts ?? 5);
+    if (signal?.aborted) {
+        throw new WorktreeError("CREATE_FAILED", "cancelled before start");
+    }
+    const canonicalRoot = await findCanonicalRoot(cwd, signal);
+    await ensureChancesExcludeEntry(canonicalRoot);
+    await mkdir(worktreesDir(canonicalRoot), { recursive: true });
+    let lastErr;
+    for (let attempt = 0; attempt < maxAttempts; attempt++) {
+        if (signal?.aborted) {
+            throw new WorktreeError("CREATE_FAILED", "cancelled mid-create");
+        }
+        const slug = newAgentSlug();
+        if (!isAgentSlug(slug)) {
+            // Defensive: random hex generation should always satisfy the regex,
+            // but if a future change loosens entropy we want to fail loud rather
+            // than push a malformed branch into git.
+            throw new WorktreeError("CREATE_FAILED", `generated slug rejected: ${slug}`);
+        }
+        const branch = branchNameFor(slug);
+        const path = worktreePathFor(canonicalRoot, slug);
+        // Slug-collision pre-check: if the path already exists, regenerate.
+        if (await pathExists(path)) {
+            lastErr = new WorktreeError("CREATE_FAILED", `path collision: ${path}`);
+            continue;
+        }
+        try {
+            await gitWorktreeAdd(canonicalRoot, path, branch, signal);
+            await writeActiveMarker(path);
+            return {
+                canonicalRoot,
+                path,
+                branch,
+                slug,
+                cleanup: makeCleanup(canonicalRoot, path, branch),
+            };
+        }
+        catch (e) {
+            lastErr = e;
+            // Best-effort cleanup in case `git worktree add` left a partial
+            // directory or branch behind. Errors here are swallowed — we're
+            // already on the failure path and the next stale-GC pass will mop
+            // up. We do NOT re-check `signal` here because cleanup is the
+            // promise we made to the caller; honouring it dominates the abort.
+            try {
+                await gitWorktreeRemove(canonicalRoot, path);
+            }
+            catch {
+                /* ignore */
+            }
+            try {
+                await gitBranchDelete(canonicalRoot, branch);
+            }
+            catch {
+                /* ignore */
+            }
+            // If the error looks like a transient collision, retry. Otherwise
+            // propagate immediately to avoid masking real failures (e.g.
+            // permission denied on `.chances/`).
+            if (e instanceof WorktreeError && /collision|already exists/i.test(e.message)) {
+                continue;
+            }
+            throw e;
+        }
+    }
+    throw new WorktreeError("SLUG_EXHAUSTED", `could not create a unique worktree slug after ${maxAttempts} attempts`, lastErr);
+}
+function makeCleanup(canonicalRoot, path, branch) {
+    let done = false;
+    return async () => {
+        if (done)
+            return;
+        done = true;
+        try {
+            await gitWorktreeRemove(canonicalRoot, path);
+        }
+        catch {
+            /* best-effort; stale-GC handles the rest */
+        }
+        try {
+            await gitBranchDelete(canonicalRoot, branch);
+        }
+        catch {
+            /* best-effort */
+        }
+    };
+}
+async function pathExists(p) {
+    try {
+        await stat(p);
+        return true;
+    }
+    catch (e) {
+        if (e.code === "ENOENT")
+            return false;
+        return true;
+    }
+}
+//# sourceMappingURL=create.js.map

package/dist/core/worktree/create.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create.js","sourceRoot":"","sources":["../../../src/core/worktree/create.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AAC/C,OAAO,EACL,yBAAyB,EACzB,iBAAiB,EACjB,eAAe,EACf,cAAc,EACd,iBAAiB,GAClB,MAAM,UAAU,CAAC;AAClB,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AACrE,OAAO,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AACvD,OAAO,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC3D,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AA4B5C;;;;;;;;;;;;;GAaG;AACH,MAAM,CAAC,KAAK,UAAU,mBAAmB,CACvC,GAAW,EACX,OAAmC,EAAE;IAErC,MAAM,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC;IACxB,MAAM,WAAW,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,eAAe,IAAI,CAAC,CAAC,CAAC;IAE3D,IAAI,MAAM,EAAE,OAAO,EAAE,CAAC;QACpB,MAAM,IAAI,aAAa,CAAC,eAAe,EAAE,wBAAwB,CAAC,CAAC;IACrE,CAAC;IAED,MAAM,aAAa,GAAG,MAAM,iBAAiB,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;IAC3D,MAAM,yBAAyB,CAAC,aAAa,CAAC,CAAC;IAC/C,MAAM,KAAK,CAAC,YAAY,CAAC,aAAa,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAE9D,IAAI,OAAgB,CAAC;IACrB,KAAK,IAAI,OAAO,GAAG,CAAC,EAAE,OAAO,GAAG,WAAW,EAAE,OAAO,EAAE,EAAE,CAAC;QACvD,IAAI,MAAM,EAAE,OAAO,EAAE,CAAC;YACpB,MAAM,IAAI,aAAa,CAAC,eAAe,EAAE,sBAAsB,CAAC,CAAC;QACnE,CAAC;QACD,MAAM,IAAI,GAAG,YAAY,EAAE,CAAC;QAC5B,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,EAAE,CAAC;YACvB,oEAAoE;YACpE,qEAAqE;YACrE,yCAAyC;YACzC,MAAM,IAAI,aAAa,CAAC,eAAe,EAAE,4BAA4B,IAAI,EAAE,CAAC,CAAC;QAC/E,CAAC;QACD,MAAM,MAAM,GAAG,aAAa,CAAC,IAAI,CAAC,CAAC;QACnC,MAAM,IAAI,GAAG,eAAe,CAAC,aAAa,EAAE,IAAI,CAAC,CAAC;QAElD,oEAAoE;QACpE,IAAI,MAAM,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;YAC3B,OAAO,GAAG,IAAI,aAAa,CAAC,eAAe,EAAE,mBAAmB,IAAI,EAAE,CAAC,CAAC;YACxE,SAAS;QACX,CAAC;QAED,IAAI,CAAC;YACH,MAAM,cAAc,CAAC,aAAa,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;YAC1D,MAAM,iBAAiB,CAAC,IAAI,CAAC,CAAC;YAC9B,OAAO;gBACL,aAAa;gBACb,IAAI;gBACJ,MAAM;gBACN,IAAI;gBACJ,OAAO,EAAE,WAAW,CAAC,aAAa,EAAE,IAAI,EAAE,MAAM,CAAC;aAClD,CAAC;QACJ,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,OAAO,GAAG,CAAC,CAAC;YACZ,gEAAgE;YAChE,gEAAgE;YAChE,kEAAkE;YAClE,8DAA8D;YAC9D,mEAAmE;YACnE,IAAI,CAAC;gBACH,MAAM,iBAAiB,CAAC,aAAa,EAAE,IAAI,CAAC,CAAC;YAC/C,CAAC;YAAC,MAAM,CAAC;gBACP,YAAY;YACd,CAAC;YACD,IAAI,CAAC;gBACH,MAAM,eAAe,CAAC,aAAa,EAAE,MAAM,CAAC,CAAC;YAC/C,CAAC;YAAC,MAAM,CAAC;gBACP,YAAY;YACd,CAAC;YACD,kEAAkE;YAClE,6DAA6D;YAC7D,qCAAqC;YACrC,IAAI,CAAC,YAAY,aAAa,IAAI,2BAA2B,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC;gBAC9E,SAAS;YACX,CAAC;YACD,MAAM,CAAC,CAAC;QACV,CAAC;IACH,CAAC;IAED,MAAM,IAAI,aAAa,CACrB,gBAAgB,EAChB,iDAAiD,WAAW,WAAW,EACvE,OAAO,CACR,CAAC;AACJ,CAAC;AAED,SAAS,WAAW,CAClB,aAAqB,EACrB,IAAY,EACZ,MAAc;IAEd,IAAI,IAAI,GAAG,KAAK,CAAC;IACjB,OAAO,KAAK,IAAI,EAAE;QAChB,IAAI,IAAI;YAAE,OAAO;QACjB,IAAI,GAAG,IAAI,CAAC;QACZ,IAAI,CAAC;YACH,MAAM,iBAAiB,CAAC,aAAa,EAAE,IAAI,CAAC,CAAC;QAC/C,CAAC;QAAC,MAAM,CAAC;YACP,4CAA4C;QAC9C,CAAC;QACD,IAAI,CAAC;YACH,MAAM,eAAe,CAAC,aAAa,EAAE,MAAM,CAAC,CAAC;QAC/C,CAAC;QAAC,MAAM,CAAC;YACP,iBAAiB;QACnB,CAAC;IACH,CAAC,CAAC;AACJ,CAAC;AAED,KAAK,UAAU,UAAU,CAAC,CAAS;IACjC,IAAI,CAAC;QACH,MAAM,IAAI,CAAC,CAAC,CAAC,CAAC;QACd,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,IAAK,CAA2B,CAAC,IAAI,KAAK,QAAQ;YAAE,OAAO,KAAK,CAAC;QACjE,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC"}

package/dist/core/worktree/errors.d.ts

@@ -0,0 +1,7 @@
+export type WorktreeErrorCode = "NOT_A_GIT_REPO" | "GIT_CLI_MISSING" | "CREATE_FAILED" | "REMOVE_FAILED" | "GC_FAILED" | "SLUG_EXHAUSTED" | "NESTED_RESOLVE_FAILED";
+export declare class WorktreeError extends Error {
+    readonly code: WorktreeErrorCode;
+    readonly cause?: unknown | undefined;
+    constructor(code: WorktreeErrorCode, message: string, cause?: unknown | undefined);
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/core/worktree/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../../src/core/worktree/errors.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,iBAAiB,GACzB,gBAAgB,GAChB,iBAAiB,GACjB,eAAe,GACf,eAAe,GACf,WAAW,GACX,gBAAgB,GAChB,uBAAuB,CAAC;AAE5B,qBAAa,aAAc,SAAQ,KAAK;IAEpC,QAAQ,CAAC,IAAI,EAAE,iBAAiB;aAEd,KAAK,CAAC,EAAE,OAAO;gBAFxB,IAAI,EAAE,iBAAiB,EAChC,OAAO,EAAE,MAAM,EACG,KAAK,CAAC,EAAE,OAAO,YAAA;CAKpC"}

package/dist/core/worktree/errors.js

@@ -0,0 +1,11 @@
+export class WorktreeError extends Error {
+    code;
+    cause;
+    constructor(code, message, cause) {
+        super(`${code}: ${message}`);
+        this.code = code;
+        this.cause = cause;
+        this.name = "WorktreeError";
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/core/worktree/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../../src/core/worktree/errors.ts"],"names":[],"mappings":"AASA,MAAM,OAAO,aAAc,SAAQ,KAAK;IAE3B;IAES;IAHpB,YACW,IAAuB,EAChC,OAAe,EACG,KAAe;QAEjC,KAAK,CAAC,GAAG,IAAI,KAAK,OAAO,EAAE,CAAC,CAAC;QAJpB,SAAI,GAAJ,IAAI,CAAmB;QAEd,UAAK,GAAL,KAAK,CAAU;QAGjC,IAAI,CAAC,IAAI,GAAG,eAAe,CAAC;IAC9B,CAAC;CACF"}

package/dist/core/worktree/gc.d.ts

@@ -0,0 +1,39 @@
+export interface GcOptions {
+    /** Worktrees older than this are eligible. Default 30, matches
+     * claude-code. */
+    cutoffDays?: number;
+    /** Heartbeat freshness window. If the active marker's `lastHeartbeat`
+     * is within this window (and the PID is alive), the worktree is
+     * conservatively retained. Default 600 s = 10 min. */
+    heartbeatStaleSeconds?: number;
+    /** Upper bound on the number of entries the GC scans in one pass.
+     * Matches 3.3's catalog cap pattern — bounds the cost so a pathological
+     * `.chances/worktrees/` (thousands of leaked dirs) can't blow the
+     * cold-start budget. Default 256. */
+    maxEntries?: number;
+    /** Cap on the wallclock the GC pass may spend before giving up the
+     * rest of the entries (the remaining cleanup falls to the next boot).
+     * Default 2 000 ms. */
+    maxWallclockMs?: number;
+    /** Injected `now` for tests. */
+    now?: () => number;
+}
+export interface GcResult {
+    scanned: number;
+    removed: string[];
+    skipped: {
+        path: string;
+        reason: string;
+    }[];
+}
+/** Best-effort sweep of stale agent worktrees under
+ * `<canonicalRoot>/.chances/worktrees/`. Fail-closed: any error on a
+ * single entry skips that entry rather than deleting on uncertainty.
+ * Returns a summary so the boot path can log a one-line "removed N
+ * stale worktrees" without spamming. */
+export declare function cleanupStaleWorktrees(canonicalRoot: string, opts?: GcOptions): Promise<GcResult>;
+/** Active-marker path expose for tests/diagnostics — kept here so the
+ * gc module's surface stays self-contained without re-exporting from
+ * `paths.ts`. */
+export { activeMarkerPathFor } from "./paths.js";
+//# sourceMappingURL=gc.d.ts.map

package/dist/core/worktree/gc.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gc.d.ts","sourceRoot":"","sources":["../../../src/core/worktree/gc.ts"],"names":[],"mappings":"AAaA,MAAM,WAAW,SAAS;IACxB;sBACkB;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;;0DAEsD;IACtD,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B;;;yCAGqC;IACrC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;;2BAEuB;IACvB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,gCAAgC;IAChC,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,QAAQ;IACvB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,OAAO,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;CAC7C;AAED;;;;wCAIwC;AACxC,wBAAsB,qBAAqB,CACzC,aAAa,EAAE,MAAM,EACrB,IAAI,GAAE,SAAc,GACnB,OAAO,CAAC,QAAQ,CAAC,CA0EnB;AA+ED;;iBAEiB;AACjB,OAAO,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC"}

package/dist/core/worktree/gc.js

@@ -0,0 +1,146 @@
+import { readdir, stat } from "node:fs/promises";
+import { join } from "node:path";
+import { gitBranchDelete, gitDiffShortstat, gitStatusEmpty, gitUnmergedCommitCount, gitWorktreeRemove, } from "./git.js";
+import { branchNameFor, isAgentSlug } from "./slug.js";
+import { worktreesDir } from "./paths.js";
+import { isProcessAlive, readActiveMarker } from "./active-marker.js";
+/** Best-effort sweep of stale agent worktrees under
+ * `<canonicalRoot>/.chances/worktrees/`. Fail-closed: any error on a
+ * single entry skips that entry rather than deleting on uncertainty.
+ * Returns a summary so the boot path can log a one-line "removed N
+ * stale worktrees" without spamming. */
+export async function cleanupStaleWorktrees(canonicalRoot, opts = {}) {
+    const cutoffDays = opts.cutoffDays ?? 30;
+    const heartbeatStaleSeconds = opts.heartbeatStaleSeconds ?? 600;
+    const maxEntries = Math.max(1, opts.maxEntries ?? 256);
+    const maxWallclockMs = Math.max(100, opts.maxWallclockMs ?? 2_000);
+    const now = opts.now ?? Date.now;
+    const startedAt = now();
+    const cutoffMs = cutoffDays * 24 * 60 * 60 * 1000;
+    const heartbeatStaleMs = heartbeatStaleSeconds * 1000;
+    const dir = worktreesDir(canonicalRoot);
+    let entries;
+    try {
+        entries = await readdir(dir);
+    }
+    catch (e) {
+        if (e.code === "ENOENT") {
+            return { scanned: 0, removed: [], skipped: [] };
+        }
+        return { scanned: 0, removed: [], skipped: [{ path: dir, reason: "readdir failed" }] };
+    }
+    const result = { scanned: 0, removed: [], skipped: [] };
+    for (const name of entries.sort()) {
+        if (result.scanned >= maxEntries) {
+            result.skipped.push({ path: name, reason: "max-entries cap reached" });
+            continue;
+        }
+        if (now() - startedAt > maxWallclockMs) {
+            result.skipped.push({ path: name, reason: "wallclock cap reached" });
+            break;
+        }
+        result.scanned++;
+        if (!isAgentSlug(name)) {
+            result.skipped.push({ path: name, reason: "slug shape mismatch" });
+            continue;
+        }
+        const worktreePath = join(dir, name);
+        try {
+            const verdict = await evaluateEntry(canonicalRoot, worktreePath, name, {
+                now: now(),
+                cutoffMs,
+                heartbeatStaleMs,
+            });
+            if (verdict === "delete") {
+                try {
+                    await gitWorktreeRemove(canonicalRoot, worktreePath);
+                }
+                catch (e) {
+                    // (Round-2 SHOULD-FIX #1) Real removal failures must NOT be
+                    // reported as successful removal. Skip this entry; the user
+                    // can investigate / next pass will retry.
+                    result.skipped.push({
+                        path: name,
+                        reason: `remove failed: ${e.message || String(e)}`,
+                    });
+                    continue;
+                }
+                // Branch deletion is best-effort — the worktree directory is
+                // already gone so leaving an orphan branch is benign.
+                await gitBranchDelete(canonicalRoot, branchNameFor(name));
+                result.removed.push(name);
+            }
+            else {
+                result.skipped.push({ path: name, reason: verdict });
+            }
+        }
+        catch (e) {
+            // Fail-closed: ANY git error on a probe skips this entry.
+            result.skipped.push({
+                path: name,
+                reason: `error: ${e.message || String(e)}`,
+            });
+        }
+    }
+    return result;
+}
+async function evaluateEntry(canonicalRoot, worktreePath, slug, ctx) {
+    // (1) `.git` pointer file exists — if not, this is a stale leftover
+    // dir that git no longer tracks; let regular FS cleanup handle it
+    // (deleted via `git worktree remove --force` against the path is
+    // typically a no-op, but we keep that path off the happy path so the
+    // operator can investigate orphans).
+    const dotGitPath = join(worktreePath, ".git");
+    let dotGitStat;
+    try {
+        dotGitStat = await stat(dotGitPath);
+    }
+    catch {
+        return "missing-dotgit-pointer";
+    }
+    // (2) Age gate: created < cutoffDays ago → kept. Use the `.git`
+    // pointer's mtime (claude-code pattern) since the worktree dir itself
+    // can be touched by tools.
+    const ageMs = ctx.now - dotGitStat.mtimeMs;
+    if (ageMs < ctx.cutoffMs)
+        return "too-recent";
+    // (3) Active marker liveness check. Marker missing → eligible
+    // (continues to dirty/unmerged probes). Marker present + fresh
+    // heartbeat + alive PID → conservatively retained.
+    const marker = await readActiveMarker(worktreePath);
+    if (marker) {
+        const heartbeatAge = ctx.now - marker.lastHeartbeat;
+        if (heartbeatAge < ctx.heartbeatStaleMs) {
+            // Marker is fresh — owner is almost certainly alive, hands off.
+            return "active-marker-fresh";
+        }
+        if (isProcessAlive(marker.pid, marker.hostname)) {
+            // Heartbeat is stale but the PID is alive (or remote-host); the
+            // owner may be paused (debugger, SIGSTOP) or just slow. Stay
+            // conservative.
+            return "active-marker-live-pid";
+        }
+        // Marker is stale AND owner is dead → fall through to git probes.
+    }
+    // (4) Worktree must be clean (no untracked, no staged, no modified).
+    const clean = await gitStatusEmpty(worktreePath);
+    if (!clean)
+        return "git-dirty";
+    // (5) Branch must have no commits unreachable from HEAD.
+    const unmerged = await gitUnmergedCommitCount(canonicalRoot, branchNameFor(slug));
+    if (unmerged > 0)
+        return "unmerged-commits";
+    // (6) Extra defensive belt: a `--shortstat` diff against HEAD that's
+    // non-empty also keeps it. `gitStatusEmpty` already covers this, but
+    // catching the second observable is cheap and matches claude-code's
+    // belt-and-suspenders pattern.
+    const shortstat = await gitDiffShortstat(worktreePath);
+    if (shortstat.length > 0)
+        return "git-dirty";
+    return "delete";
+}
+/** Active-marker path expose for tests/diagnostics — kept here so the
+ * gc module's surface stays self-contained without re-exporting from
+ * `paths.ts`. */
+export { activeMarkerPathFor } from "./paths.js";
+//# sourceMappingURL=gc.js.map

package/dist/core/worktree/gc.js.map

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

package/dist/core/worktree/git.d.ts

@@ -0,0 +1,53 @@
+export interface GitRunOptions {
+    cwd?: string;
+    signal?: AbortSignal;
+    /** When true, a non-zero exit is returned as `{ ok: false, ... }`
+     * instead of throwing. Callers that care about specific codes (e.g.
+     * `git status` returning 0/non-zero meaningfully) opt into this. */
+    allowNonZero?: boolean;
+}
+export interface GitResult {
+    ok: boolean;
+    stdout: string;
+    stderr: string;
+    code: number | null;
+}
+/** Spawn `git ARGS...` with stdout/stderr captured. Resolves with the result;
+ * throws WorktreeError on signal failures or when the git binary is missing.
+ * Cancellation via AbortSignal kills the child with SIGTERM. */
+export declare function runGit(args: string[], opts?: GitRunOptions): Promise<GitResult>;
+/** Resolves the canonical git repo root for `cwd`. When inside a nested
+ * worktree, `--show-superproject-working-tree` returns the parent superproject;
+ * we fall back to `--show-toplevel` for regular repos. (Round-1 SHOULD-FIX #3.) */
+export declare function findCanonicalRoot(cwd: string, signal?: AbortSignal): Promise<string>;
+/** `git worktree add -b <branch> <path> HEAD` against `canonicalRoot`. */
+export declare function gitWorktreeAdd(canonicalRoot: string, path: string, branch: string, signal?: AbortSignal): Promise<void>;
+/** `git worktree remove --force <path>` then `git worktree prune`.
+ *
+ * Idempotency: "worktree is not registered" / "no such directory"
+ * exits are treated as success (the post-condition "the path is not
+ * registered as a worktree" already holds). REAL failures (permission
+ * denied, locked, FS error) throw `REMOVE_FAILED` so callers can
+ * distinguish "removed" from "could not remove" — Round-2 SHOULD-FIX
+ * #1.
+ */
+export declare function gitWorktreeRemove(canonicalRoot: string, path: string, signal?: AbortSignal): Promise<void>;
+/** `git branch -D <branch>`. Best-effort; returns silently if the branch
+ * doesn't exist. */
+export declare function gitBranchDelete(canonicalRoot: string, branch: string, signal?: AbortSignal): Promise<void>;
+/** `git status --porcelain` parser: returns true when the worktree has no
+ * untracked, modified, or staged files. */
+export declare function gitStatusEmpty(worktreePath: string, signal?: AbortSignal): Promise<boolean>;
+/** `git rev-list <branch> ^HEAD --count`. Number of commits on `branch` not
+ * reachable from `HEAD`. Used by GC to detect worktrees holding unmerged
+ * work. */
+export declare function gitUnmergedCommitCount(canonicalRoot: string, branch: string, signal?: AbortSignal): Promise<number>;
+/** `git diff --shortstat HEAD` invoked inside the worktree. Returns the
+ * trimmed shortstat ("3 files changed, 47 insertions(+), 12 deletions(-)")
+ * or the empty string when the worktree matches HEAD. */
+export declare function gitDiffShortstat(worktreePath: string, signal?: AbortSignal): Promise<string>;
+/** Ensures `.git/info/exclude` contains `.chances/worktrees/`. Idempotent. We
+ * append a labelled section so a re-run doesn't duplicate the entry, and we
+ * never touch the user's tracked `.gitignore`. (Round-1 SHOULD-FIX #1.) */
+export declare function ensureChancesExcludeEntry(canonicalRoot: string): Promise<void>;
+//# sourceMappingURL=git.d.ts.map

package/dist/core/worktree/git.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"git.d.ts","sourceRoot":"","sources":["../../../src/core/worktree/git.ts"],"names":[],"mappings":"AAKA,MAAM,WAAW,aAAa;IAC5B,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB;;wEAEoE;IACpE,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,SAAS;IACxB,EAAE,EAAE,OAAO,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;CACrB;AAED;;gEAEgE;AAChE,wBAAsB,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,IAAI,GAAE,aAAkB,GAAG,OAAO,CAAC,SAAS,CAAC,CA+BzF;AAED;;mFAEmF;AACnF,wBAAsB,iBAAiB,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,MAAM,CAAC,CAsB1F;AAED,0EAA0E;AAC1E,wBAAsB,cAAc,CAClC,aAAa,EAAE,MAAM,EACrB,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM,EACd,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,IAAI,CAAC,CAYf;AAED;;;;;;;;GAQG;AACH,wBAAsB,iBAAiB,CACrC,aAAa,EAAE,MAAM,EACrB,IAAI,EAAE,MAAM,EACZ,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,IAAI,CAAC,CAqBf;AAED;oBACoB;AACpB,wBAAsB,eAAe,CACnC,aAAa,EAAE,MAAM,EACrB,MAAM,EAAE,MAAM,EACd,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,IAAI,CAAC,CAEf;AAED;2CAC2C;AAC3C,wBAAsB,cAAc,CAAC,YAAY,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,OAAO,CAAC,CASjG;AAED;;WAEW;AACX,wBAAsB,sBAAsB,CAC1C,aAAa,EAAE,MAAM,EACrB,MAAM,EAAE,MAAM,EACd,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,MAAM,CAAC,CAcjB;AAED;;yDAEyD;AACzD,wBAAsB,gBAAgB,CAAC,YAAY,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,MAAM,CAAC,CAQlG;AAED;;2EAE2E;AAC3E,wBAAsB,yBAAyB,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAgBpF"}

package/dist/core/worktree/git.js

@@ -0,0 +1,166 @@
+import { spawn } from "node:child_process";
+import { mkdir, readFile, writeFile } from "node:fs/promises";
+import { dirname, join } from "node:path";
+import { WorktreeError } from "./errors.js";
+/** Spawn `git ARGS...` with stdout/stderr captured. Resolves with the result;
+ * throws WorktreeError on signal failures or when the git binary is missing.
+ * Cancellation via AbortSignal kills the child with SIGTERM. */
+export async function runGit(args, opts = {}) {
+    return new Promise((resolve, reject) => {
+        const child = spawn("git", args, {
+            cwd: opts.cwd,
+            signal: opts.signal,
+            stdio: ["ignore", "pipe", "pipe"],
+        });
+        let stdout = "";
+        let stderr = "";
+        child.stdout?.on("data", (b) => (stdout += b.toString("utf8")));
+        child.stderr?.on("data", (b) => (stderr += b.toString("utf8")));
+        child.on("error", (e) => {
+            if (e.code === "ENOENT") {
+                reject(new WorktreeError("GIT_CLI_MISSING", "git binary not found on PATH", e));
+                return;
+            }
+            if (e.name === "AbortError") {
+                reject(new WorktreeError("CREATE_FAILED", `git ${args[0]} aborted`, e));
+                return;
+            }
+            reject(new WorktreeError("CREATE_FAILED", `git ${args[0]} spawn failed: ${e.message}`, e));
+        });
+        child.on("close", (code) => {
+            const ok = code === 0;
+            if (!ok && !opts.allowNonZero) {
+                resolve({ ok, stdout, stderr, code });
+                return;
+            }
+            resolve({ ok, stdout, stderr, code });
+        });
+    });
+}
+/** Resolves the canonical git repo root for `cwd`. When inside a nested
+ * worktree, `--show-superproject-working-tree` returns the parent superproject;
+ * we fall back to `--show-toplevel` for regular repos. (Round-1 SHOULD-FIX #3.) */
+export async function findCanonicalRoot(cwd, signal) {
+    const superRes = await runGit(["rev-parse", "--show-superproject-working-tree"], {
+        cwd,
+        signal,
+        allowNonZero: true,
+    });
+    if (superRes.ok) {
+        const trimmed = superRes.stdout.trim();
+        if (trimmed.length > 0)
+            return trimmed;
+    }
+    const topRes = await runGit(["rev-parse", "--show-toplevel"], {
+        cwd,
+        signal,
+        allowNonZero: true,
+    });
+    if (!topRes.ok) {
+        throw new WorktreeError("NOT_A_GIT_REPO", `not a git repository (or any parent): ${cwd}${topRes.stderr.trim() ? " — " + topRes.stderr.trim() : ""}`);
+    }
+    return topRes.stdout.trim();
+}
+/** `git worktree add -b <branch> <path> HEAD` against `canonicalRoot`. */
+export async function gitWorktreeAdd(canonicalRoot, path, branch, signal) {
+    const res = await runGit(["worktree", "add", "-b", branch, path, "HEAD"], {
+        cwd: canonicalRoot,
+        signal,
+        allowNonZero: true,
+    });
+    if (!res.ok) {
+        throw new WorktreeError("CREATE_FAILED", `git worktree add failed${res.stderr.trim() ? ": " + res.stderr.trim() : ""}`);
+    }
+}
+/** `git worktree remove --force <path>` then `git worktree prune`.
+ *
+ * Idempotency: "worktree is not registered" / "no such directory"
+ * exits are treated as success (the post-condition "the path is not
+ * registered as a worktree" already holds). REAL failures (permission
+ * denied, locked, FS error) throw `REMOVE_FAILED` so callers can
+ * distinguish "removed" from "could not remove" — Round-2 SHOULD-FIX
+ * #1.
+ */
+export async function gitWorktreeRemove(canonicalRoot, path, signal) {
+    const res = await runGit(["worktree", "remove", "--force", path], {
+        cwd: canonicalRoot,
+        signal,
+        allowNonZero: true,
+    });
+    if (!res.ok) {
+        const err = res.stderr.toLowerCase();
+        const idempotentMiss = /is not a working tree/.test(err) ||
+            /no such (file or directory|working tree)/.test(err) ||
+            /is not a working tree/.test(err) ||
+            /not a working tree/.test(err);
+        if (!idempotentMiss) {
+            throw new WorktreeError("REMOVE_FAILED", `git worktree remove failed${res.stderr.trim() ? ": " + res.stderr.trim() : ""}`);
+        }
+    }
+    await runGit(["worktree", "prune"], { cwd: canonicalRoot, signal, allowNonZero: true });
+}
+/** `git branch -D <branch>`. Best-effort; returns silently if the branch
+ * doesn't exist. */
+export async function gitBranchDelete(canonicalRoot, branch, signal) {
+    await runGit(["branch", "-D", branch], { cwd: canonicalRoot, signal, allowNonZero: true });
+}
+/** `git status --porcelain` parser: returns true when the worktree has no
+ * untracked, modified, or staged files. */
+export async function gitStatusEmpty(worktreePath, signal) {
+    const res = await runGit(["status", "--porcelain"], { cwd: worktreePath, signal });
+    if (!res.ok) {
+        throw new WorktreeError("GC_FAILED", `git status failed at ${worktreePath}${res.stderr.trim() ? ": " + res.stderr.trim() : ""}`);
+    }
+    return res.stdout.trim().length === 0;
+}
+/** `git rev-list <branch> ^HEAD --count`. Number of commits on `branch` not
+ * reachable from `HEAD`. Used by GC to detect worktrees holding unmerged
+ * work. */
+export async function gitUnmergedCommitCount(canonicalRoot, branch, signal) {
+    const res = await runGit(["rev-list", "--count", branch, "^HEAD"], {
+        cwd: canonicalRoot,
+        signal,
+        allowNonZero: true,
+    });
+    if (!res.ok) {
+        throw new WorktreeError("GC_FAILED", `git rev-list failed for ${branch}${res.stderr.trim() ? ": " + res.stderr.trim() : ""}`);
+    }
+    const n = parseInt(res.stdout.trim(), 10);
+    return Number.isFinite(n) ? n : 0;
+}
+/** `git diff --shortstat HEAD` invoked inside the worktree. Returns the
+ * trimmed shortstat ("3 files changed, 47 insertions(+), 12 deletions(-)")
+ * or the empty string when the worktree matches HEAD. */
+export async function gitDiffShortstat(worktreePath, signal) {
+    const res = await runGit(["diff", "--shortstat", "HEAD"], {
+        cwd: worktreePath,
+        signal,
+        allowNonZero: true,
+    });
+    if (!res.ok)
+        return "";
+    return res.stdout.trim();
+}
+/** Ensures `.git/info/exclude` contains `.chances/worktrees/`. Idempotent. We
+ * append a labelled section so a re-run doesn't duplicate the entry, and we
+ * never touch the user's tracked `.gitignore`. (Round-1 SHOULD-FIX #1.) */
+export async function ensureChancesExcludeEntry(canonicalRoot) {
+    const excludePath = join(canonicalRoot, ".git", "info", "exclude");
+    let existing = "";
+    try {
+        existing = await readFile(excludePath, "utf8");
+    }
+    catch (e) {
+        const err = e;
+        if (err.code !== "ENOENT")
+            throw err;
+    }
+    if (existing.includes(".chances/worktrees/"))
+        return;
+    await mkdir(dirname(excludePath), { recursive: true });
+    const block = (existing.endsWith("\n") || existing.length === 0 ? "" : "\n") +
+        "# chances-cli — agent worktrees (auto-managed, see docs/4.1-design.md)\n" +
+        ".chances/worktrees/\n";
+    await writeFile(excludePath, existing + block, "utf8");
+}
+//# sourceMappingURL=git.js.map

package/dist/core/worktree/git.js.map

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

package/dist/core/worktree/index.d.ts

@@ -0,0 +1,8 @@
+export { createAgentWorktree, type AgentWorktreeHandle, type CreateAgentWorktreeOptions, } from "./create.js";
+export { cleanupStaleWorktrees, type GcOptions, type GcResult, } from "./gc.js";
+export { WorktreeError, type WorktreeErrorCode } from "./errors.js";
+export { refreshActiveMarker } from "./active-marker.js";
+export { gitDiffShortstat, findCanonicalRoot } from "./git.js";
+export { worktreePathFor, worktreesDir, activeMarkerPathFor } from "./paths.js";
+export { branchNameFor, isAgentSlug, newAgentSlug } from "./slug.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/core/worktree/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/worktree/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,mBAAmB,EACnB,KAAK,mBAAmB,EACxB,KAAK,0BAA0B,GAChC,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,qBAAqB,EACrB,KAAK,SAAS,EACd,KAAK,QAAQ,GACd,MAAM,SAAS,CAAC;AACjB,OAAO,EAAE,aAAa,EAAE,KAAK,iBAAiB,EAAE,MAAM,aAAa,CAAC;AACpE,OAAO,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AACzD,OAAO,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAC/D,OAAO,EAAE,eAAe,EAAE,YAAY,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAChF,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC"}

package/dist/core/worktree/index.js

@@ -0,0 +1,8 @@
+export { createAgentWorktree, } from "./create.js";
+export { cleanupStaleWorktrees, } from "./gc.js";
+export { WorktreeError } from "./errors.js";
+export { refreshActiveMarker } from "./active-marker.js";
+export { gitDiffShortstat, findCanonicalRoot } from "./git.js";
+export { worktreePathFor, worktreesDir, activeMarkerPathFor } from "./paths.js";
+export { branchNameFor, isAgentSlug, newAgentSlug } from "./slug.js";
+//# sourceMappingURL=index.js.map

package/dist/core/worktree/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/core/worktree/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,mBAAmB,GAGpB,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,qBAAqB,GAGtB,MAAM,SAAS,CAAC;AACjB,OAAO,EAAE,aAAa,EAA0B,MAAM,aAAa,CAAC;AACpE,OAAO,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AACzD,OAAO,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAC/D,OAAO,EAAE,eAAe,EAAE,YAAY,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAChF,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC"}