@ferueda/grove 0.1.2 → 0.3.0

package/dist/errors.d.ts

@@ -1,4 +1,4 @@
-export type GroveErrorCode = "GROVE_EXHAUSTED" | "WORKTREE_DESTROYING" | "WORKTREE_NOT_MANAGED" | "WORKTREE_IN_USE" | "GIT_NOT_FOUND" | "GIT_COMMAND_FAILED" | "INVALID_GROVE_STATE" | "LOCK_FAILED";
+export type GroveErrorCode = "GROVE_EXHAUSTED" | "WORKTREE_DESTROYING" | "WORKTREE_NOT_MANAGED" | "WORKTREE_IN_USE" | "GIT_NOT_FOUND" | "GIT_COMMAND_FAILED" | "INVALID_GROVE_STATE" | "LOCK_FAILED" | "LEASE_NOT_FOUND" | "LEASE_CONFLICT" | "LEASE_ALREADY_EXISTS" | "LEASE_QUARANTINED" | "UNSAFE_CLEANUP" | "BRANCH_EXISTS" | "BRANCH_NOT_FOUND" | "REF_NOT_FOUND" | "PATH_OUTSIDE_POOL" | "BRANCH_DELETE_FAILED" | "HOOK_FAILED";
 export declare class GroveError extends Error {
     readonly code: GroveErrorCode;
     constructor(message: string, code: GroveErrorCode);
@@ -28,4 +28,37 @@ export declare class InvalidGroveStateError extends GroveError {
 export declare class LockFailedError extends GroveError {
     constructor(message?: string);
 }
+export declare class LeaseNotFoundError extends GroveError {
+    constructor(message?: string);
+}
+export declare class LeaseConflictError extends GroveError {
+    constructor(message?: string);
+}
+export declare class LeaseAlreadyExistsError extends GroveError {
+    constructor(message?: string);
+}
+export declare class LeaseQuarantinedError extends GroveError {
+    constructor(message?: string);
+}
+export declare class UnsafeCleanupError extends GroveError {
+    constructor(message?: string);
+}
+export declare class BranchExistsError extends GroveError {
+    constructor(message?: string);
+}
+export declare class BranchNotFoundError extends GroveError {
+    constructor(message?: string);
+}
+export declare class RefNotFoundError extends GroveError {
+    constructor(message?: string);
+}
+export declare class PathOutsidePoolError extends GroveError {
+    constructor(message?: string);
+}
+export declare class BranchDeleteFailedError extends GroveError {
+    constructor(message: string);
+}
+export declare class HookFailedError extends GroveError {
+    constructor(message: string);
+}
 //# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,cAAc,GACtB,iBAAiB,GACjB,qBAAqB,GACrB,sBAAsB,GACtB,iBAAiB,GACjB,eAAe,GACf,oBAAoB,GACpB,qBAAqB,GACrB,aAAa,CAAC;AAElB,qBAAa,UAAW,SAAQ,KAAK;IACnC,QAAQ,CAAC,IAAI,EAAE,cAAc,CAAC;IAC9B,YAAY,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,cAAc,EAIhD;CACF;AAED,qBAAa,mBAAoB,SAAQ,UAAU;IACjD,YAAY,OAAO,GAAE,MAA0B,EAE9C;CACF;AAED,qBAAa,uBAAwB,SAAQ,UAAU;IACrD,YAAY,OAAO,GAAE,MAAiC,EAErD;CACF;AAED,qBAAa,uBAAwB,SAAQ,UAAU;IACrD,YAAY,OAAO,GAAE,MAA+B,EAEnD;CACF;AAED,qBAAa,kBAAmB,SAAQ,UAAU;IAChD,YAAY,OAAO,GAAE,MAA6B,EAEjD;CACF;AAED,qBAAa,gBAAiB,SAAQ,UAAU;IAC9C,YAAY,OAAO,GAAE,MAAwB,EAE5C;CACF;AAED,qBAAa,eAAgB,SAAQ,UAAU;IAC7C,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,OAAO,EAAE,MAAM,EAAE,MAAM,GAAE,MAAW,EAG/C;CACF;AAED,qBAAa,sBAAuB,SAAQ,UAAU;IACpD,YAAY,OAAO,GAAE,MAA8B,EAElD;CACF;AAED,qBAAa,eAAgB,SAAQ,UAAU;IAC7C,YAAY,OAAO,GAAE,MAAiC,EAErD;CACF"}
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,cAAc,GACtB,iBAAiB,GACjB,qBAAqB,GACrB,sBAAsB,GACtB,iBAAiB,GACjB,eAAe,GACf,oBAAoB,GACpB,qBAAqB,GACrB,aAAa,GACb,iBAAiB,GACjB,gBAAgB,GAChB,sBAAsB,GACtB,mBAAmB,GACnB,gBAAgB,GAChB,eAAe,GACf,kBAAkB,GAClB,eAAe,GACf,mBAAmB,GACnB,sBAAsB,GACtB,aAAa,CAAC;AAElB,qBAAa,UAAW,SAAQ,KAAK;IACnC,QAAQ,CAAC,IAAI,EAAE,cAAc,CAAC;IAC9B,YAAY,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,cAAc,EAIhD;CACF;AAED,qBAAa,mBAAoB,SAAQ,UAAU;IACjD,YAAY,OAAO,GAAE,MAA0B,EAE9C;CACF;AAED,qBAAa,uBAAwB,SAAQ,UAAU;IACrD,YAAY,OAAO,GAAE,MAAiC,EAErD;CACF;AAED,qBAAa,uBAAwB,SAAQ,UAAU;IACrD,YAAY,OAAO,GAAE,MAA+B,EAEnD;CACF;AAED,qBAAa,kBAAmB,SAAQ,UAAU;IAChD,YAAY,OAAO,GAAE,MAA6B,EAEjD;CACF;AAED,qBAAa,gBAAiB,SAAQ,UAAU;IAC9C,YAAY,OAAO,GAAE,MAAwB,EAE5C;CACF;AAED,qBAAa,eAAgB,SAAQ,UAAU;IAC7C,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,OAAO,EAAE,MAAM,EAAE,MAAM,GAAE,MAAW,EAG/C;CACF;AAED,qBAAa,sBAAuB,SAAQ,UAAU;IACpD,YAAY,OAAO,GAAE,MAA8B,EAElD;CACF;AAED,qBAAa,eAAgB,SAAQ,UAAU;IAC7C,YAAY,OAAO,GAAE,MAAiC,EAErD;CACF;AAED,qBAAa,kBAAmB,SAAQ,UAAU;IAChD,YAAY,OAAO,GAAE,MAA0B,EAE9C;CACF;AAED,qBAAa,kBAAmB,SAAQ,UAAU;IAChD,YAAY,OAAO,GAAE,MAAyB,EAE7C;CACF;AAED,qBAAa,uBAAwB,SAAQ,UAAU;IACrD,YAAY,OAAO,GAAE,MAA+B,EAEnD;CACF;AAED,qBAAa,qBAAsB,SAAQ,UAAU;IACnD,YAAY,OAAO,GAAE,MAA4B,EAEhD;CACF;AAED,qBAAa,kBAAmB,SAAQ,UAAU;IAChD,YAAY,OAAO,GAAE,MAAyB,EAE7C;CACF;AAED,qBAAa,iBAAkB,SAAQ,UAAU;IAC/C,YAAY,OAAO,GAAE,MAAwB,EAE5C;CACF;AAED,qBAAa,mBAAoB,SAAQ,UAAU;IACjD,YAAY,OAAO,GAAE,MAA2B,EAE/C;CACF;AAED,qBAAa,gBAAiB,SAAQ,UAAU;IAC9C,YAAY,OAAO,GAAE,MAAwB,EAE5C;CACF;AAED,qBAAa,oBAAqB,SAAQ,UAAU;IAClD,YAAY,OAAO,GAAE,MAAqC,EAEzD;CACF;AAED,qBAAa,uBAAwB,SAAQ,UAAU;IACrD,YAAY,OAAO,EAAE,MAAM,EAE1B;CACF;AAED,qBAAa,eAAgB,SAAQ,UAAU;IAC7C,YAAY,OAAO,EAAE,MAAM,EAE1B;CACF"}

package/dist/errors.js

@@ -48,3 +48,58 @@ export class LockFailedError extends GroveError {
         super(message, "LOCK_FAILED");
     }
 }
+export class LeaseNotFoundError extends GroveError {
+    constructor(message = "Lease not found") {
+        super(message, "LEASE_NOT_FOUND");
+    }
+}
+export class LeaseConflictError extends GroveError {
+    constructor(message = "Lease conflict") {
+        super(message, "LEASE_CONFLICT");
+    }
+}
+export class LeaseAlreadyExistsError extends GroveError {
+    constructor(message = "Lease already exists") {
+        super(message, "LEASE_ALREADY_EXISTS");
+    }
+}
+export class LeaseQuarantinedError extends GroveError {
+    constructor(message = "Lease quarantined") {
+        super(message, "LEASE_QUARANTINED");
+    }
+}
+export class UnsafeCleanupError extends GroveError {
+    constructor(message = "Unsafe cleanup") {
+        super(message, "UNSAFE_CLEANUP");
+    }
+}
+export class BranchExistsError extends GroveError {
+    constructor(message = "Branch exists") {
+        super(message, "BRANCH_EXISTS");
+    }
+}
+export class BranchNotFoundError extends GroveError {
+    constructor(message = "Branch not found") {
+        super(message, "BRANCH_NOT_FOUND");
+    }
+}
+export class RefNotFoundError extends GroveError {
+    constructor(message = "Ref not found") {
+        super(message, "REF_NOT_FOUND");
+    }
+}
+export class PathOutsidePoolError extends GroveError {
+    constructor(message = "Path outside pool boundary") {
+        super(message, "PATH_OUTSIDE_POOL");
+    }
+}
+export class BranchDeleteFailedError extends GroveError {
+    constructor(message) {
+        super(message, "BRANCH_DELETE_FAILED");
+    }
+}
+export class HookFailedError extends GroveError {
+    constructor(message) {
+        super(message, "HOOK_FAILED");
+    }
+}

package/dist/git/branch.d.ts

@@ -6,4 +6,12 @@ export declare function getRemoteUrl(repoRoot: string): Promise<string>;
 export declare function shortHash(input: string): string;
 export declare function isAncestor(repoRoot: string, a: string, b: string): Promise<boolean>;
 export declare function branchRef(repoRoot: string, branch: string): Promise<string>;
+export declare function getHeadSha(wtPath: string): Promise<string>;
+export declare function resolveRef(repoRoot: string, ref: string): Promise<string>;
+export declare function checkoutBranch(wtPath: string, branch: string, createOpts?: {
+    from: string;
+    ifExists?: "reuse" | "fail";
+}): Promise<void>;
+export declare function checkoutDetached(wtPath: string, ref: string): Promise<void>;
+export declare function deleteBranch(repoRoot: string, branch: string, force?: boolean): Promise<void>;
 //# sourceMappingURL=branch.d.ts.map

package/dist/git/branch.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"branch.d.ts","sourceRoot":"","sources":["../../src/git/branch.ts"],"names":[],"mappings":"AAGA,wBAAsB,YAAY,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAEhE;AAED,wBAAsB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAEnE;AAED,wBAAsB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAwCxE;AAED,wBAAsB,SAAS,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAUhF;AAED,wBAAsB,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAEpE;AAED,wBAAgB,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAE/C;AAED,wBAAsB,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAOzF;AAED,wBAAsB,SAAS,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CA8BjF"}
+{"version":3,"file":"branch.d.ts","sourceRoot":"","sources":["../../src/git/branch.ts"],"names":[],"mappings":"AAIA,wBAAsB,YAAY,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAEhE;AAED,wBAAsB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAEnE;AAED,wBAAsB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAwCxE;AAED,wBAAsB,SAAS,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAUhF;AAED,wBAAsB,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAEpE;AAED,wBAAgB,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAE/C;AAED,wBAAsB,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAOzF;AAED,wBAAsB,SAAS,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CA8BjF;AAED,wBAAsB,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAEhE;AAED,wBAAsB,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAM/E;AAED,wBAAsB,cAAc,CAClC,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,EACd,UAAU,CAAC,EAAE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,OAAO,GAAG,MAAM,CAAA;CAAE,GACzD,OAAO,CAAC,IAAI,CAAC,CAuBf;AAED,wBAAsB,gBAAgB,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAMjF;AAED,wBAAsB,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAOnG"}

package/dist/git/branch.js

@@ -1,5 +1,6 @@
 import { createHash } from "node:crypto";
 import { runGit } from "./run.js";
+import { BranchExistsError, BranchNotFoundError, RefNotFoundError, GitCommandError } from "../errors.js";
 export async function findRepoRoot(cwd) {
     return runGit(cwd, ["rev-parse", "--show-toplevel"]);
 }
@@ -104,3 +105,59 @@ export async function branchRef(repoRoot, branch) {
         return remote;
     return branch; // fallback
 }
+export async function getHeadSha(wtPath) {
+    return (await runGit(wtPath, ["rev-parse", "HEAD"])).trim();
+}
+export async function resolveRef(repoRoot, ref) {
+    try {
+        return (await runGit(repoRoot, ["rev-parse", ref])).trim();
+    }
+    catch {
+        throw new RefNotFoundError(`Ref not found: ${ref}`);
+    }
+}
+export async function checkoutBranch(wtPath, branch, createOpts) {
+    if (createOpts) {
+        const localBranches = await runGit(wtPath, ["branch", "--list", branch]);
+        if (localBranches.trim()) {
+            if (createOpts.ifExists === "fail") {
+                throw new BranchExistsError(`Branch exists: ${branch}`);
+            }
+            // reuse
+            await runGit(wtPath, ["checkout", branch]);
+        }
+        else {
+            try {
+                await runGit(wtPath, ["checkout", "-b", branch, createOpts.from]);
+            }
+            catch (err) {
+                throw new GitCommandError(`Failed to create branch ${branch} from ${createOpts.from}`, err.message);
+            }
+        }
+    }
+    else {
+        try {
+            await runGit(wtPath, ["checkout", branch]);
+        }
+        catch {
+            throw new BranchNotFoundError(`Branch not found: ${branch}`);
+        }
+    }
+}
+export async function checkoutDetached(wtPath, ref) {
+    try {
+        await runGit(wtPath, ["checkout", "--detach", ref]);
+    }
+    catch {
+        throw new RefNotFoundError(`Ref not found: ${ref}`);
+    }
+}
+export async function deleteBranch(repoRoot, branch, force) {
+    try {
+        const args = force ? ["branch", "-D", branch] : ["branch", "-d", branch];
+        await runGit(repoRoot, args);
+    }
+    catch (err) {
+        throw new GitCommandError(`Failed to delete branch ${branch}`, err.message);
+    }
+}

package/dist/hooks.d.ts

@@ -2,6 +2,9 @@ import type { Writable } from "node:stream";
 export interface RunHooksOptions {
     stdout?: Writable;
     stderr?: Writable;
+    timeoutMs?: number | undefined;
+    env?: Record<string, string> | undefined;
+    onFailure?: "ignore" | "fail" | undefined;
 }
 export declare function runHooks(commands: string[], workDir: string, opts?: RunHooksOptions): Promise<void>;
 //# sourceMappingURL=hooks.d.ts.map

package/dist/hooks.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"hooks.d.ts","sourceRoot":"","sources":["../src/hooks.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAE5C,MAAM,WAAW,eAAe;IAC9B,MAAM,CAAC,EAAE,QAAQ,CAAC;IAClB,MAAM,CAAC,EAAE,QAAQ,CAAC;CACnB;AAED,wBAAsB,QAAQ,CAC5B,QAAQ,EAAE,MAAM,EAAE,EAClB,OAAO,EAAE,MAAM,EACf,IAAI,GAAE,eAAoB,GACzB,OAAO,CAAC,IAAI,CAAC,CAgCf"}
+{"version":3,"file":"hooks.d.ts","sourceRoot":"","sources":["../src/hooks.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAE5C,MAAM,WAAW,eAAe;IAC9B,MAAM,CAAC,EAAE,QAAQ,CAAC;IAClB,MAAM,CAAC,EAAE,QAAQ,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC/B,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,SAAS,CAAC;IACzC,SAAS,CAAC,EAAE,QAAQ,GAAG,MAAM,GAAG,SAAS,CAAC;CAC3C;AAED,wBAAsB,QAAQ,CAC5B,QAAQ,EAAE,MAAM,EAAE,EAClB,OAAO,EAAE,MAAM,EACf,IAAI,GAAE,eAAoB,GACzB,OAAO,CAAC,IAAI,CAAC,CAwCf"}

package/dist/hooks.js

@@ -5,12 +5,17 @@ export async function runHooks(commands, workDir, opts = {}) {
             const isWin = process.platform === "win32";
             const shell = isWin ? process.env.COMSPEC || "cmd.exe" : "/bin/sh";
             const args = isWin ? ["/d", "/s", "/c", command] : ["-c", command];
-            const child = execa(shell, args, {
+            const execOpts = {
                 cwd: workDir,
                 stdout: opts.stdout ? "pipe" : "ignore",
                 stderr: opts.stderr ? "pipe" : "ignore",
                 windowsVerbatimArguments: isWin,
-            });
+            };
+            if (opts.timeoutMs !== undefined)
+                execOpts.timeout = opts.timeoutMs;
+            if (opts.env !== undefined)
+                execOpts.env = opts.env;
+            const child = execa(shell, args, execOpts);
             if (opts.stdout) {
                 child.stdout?.pipe(opts.stdout, { end: false });
             }
@@ -28,6 +33,10 @@ export async function runHooks(commands, workDir, opts = {}) {
             else {
                 process.stderr.write(msg);
             }
+            if (opts.onFailure === "fail") {
+                const { HookFailedError } = await import("./errors.js");
+                throw new HookFailedError(`Hook failed: ${command}`);
+            }
         }
     }
 }

package/dist/index.d.ts

@@ -1,10 +1,10 @@
 import { Grove } from "./pool.js";
 import type { GroveConfig } from "./schemas.js";
 export { Grove } from "./pool.js";
-export type { AcquiredSlot, WorktreeStatus, WorktreeStatusInfo } from "./pool.js";
+export type { AcquiredSlot, AcquireLeaseOptions, ReleaseLeaseOptions, DestroyLeaseOptions, RepairLeaseOptions, GroveLease, WorktreeStatus, WorktreeStatusInfo, } from "./types.js";
 export { GroveConfigSchema } from "./schemas.js";
-export type { GroveConfig, WorktreeEntry, GroveState } from "./schemas.js";
-export { GroveError, GroveExhaustedError, WorktreeDestroyingError, WorktreeNotManagedError, WorktreeInUseError, GitNotFoundError, GitCommandError, InvalidGroveStateError, LockFailedError, } from "./errors.js";
+export type { GroveConfig, WorktreeEntry, GroveState, GroveCleanupIntent } from "./schemas.js";
+export { GroveError, GroveExhaustedError, WorktreeDestroyingError, WorktreeNotManagedError, WorktreeInUseError, GitNotFoundError, GitCommandError, InvalidGroveStateError, LockFailedError, LeaseNotFoundError, LeaseConflictError, LeaseAlreadyExistsError, LeaseQuarantinedError, UnsafeCleanupError, BranchExistsError, BranchNotFoundError, RefNotFoundError, PathOutsidePoolError, BranchDeleteFailedError, HookFailedError, } from "./errors.js";
 export type { GroveErrorCode } from "./errors.js";
 export declare function createGrove(configInput: GroveConfig): Promise<Grove>;
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,EAAE,MAAM,WAAW,CAAC;AAElC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAEhD,OAAO,EAAE,KAAK,EAAE,MAAM,WAAW,CAAC;AAClC,YAAY,EAAE,YAAY,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,WAAW,CAAC;AAClF,OAAO,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AACjD,YAAY,EAAE,WAAW,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAE3E,OAAO,EACL,UAAU,EACV,mBAAmB,EACnB,uBAAuB,EACvB,uBAAuB,EACvB,kBAAkB,EAClB,gBAAgB,EAChB,eAAe,EACf,sBAAsB,EACtB,eAAe,GAChB,MAAM,aAAa,CAAC;AACrB,YAAY,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAElD,wBAAsB,WAAW,CAAC,WAAW,EAAE,WAAW,GAAG,OAAO,CAAC,KAAK,CAAC,CAK1E"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,EAAE,MAAM,WAAW,CAAC;AAElC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAEhD,OAAO,EAAE,KAAK,EAAE,MAAM,WAAW,CAAC;AAClC,YAAY,EACV,YAAY,EACZ,mBAAmB,EACnB,mBAAmB,EACnB,mBAAmB,EACnB,kBAAkB,EAClB,UAAU,EACV,cAAc,EACd,kBAAkB,GACnB,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AACjD,YAAY,EAAE,WAAW,EAAE,aAAa,EAAE,UAAU,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAE/F,OAAO,EACL,UAAU,EACV,mBAAmB,EACnB,uBAAuB,EACvB,uBAAuB,EACvB,kBAAkB,EAClB,gBAAgB,EAChB,eAAe,EACf,sBAAsB,EACtB,eAAe,EACf,kBAAkB,EAClB,kBAAkB,EAClB,uBAAuB,EACvB,qBAAqB,EACrB,kBAAkB,EAClB,iBAAiB,EACjB,mBAAmB,EACnB,gBAAgB,EAChB,oBAAoB,EACpB,uBAAuB,EACvB,eAAe,GAChB,MAAM,aAAa,CAAC;AACrB,YAAY,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAElD,wBAAsB,WAAW,CAAC,WAAW,EAAE,WAAW,GAAG,OAAO,CAAC,KAAK,CAAC,CAK1E"}

package/dist/index.js

@@ -3,7 +3,7 @@ import { Grove } from "./pool.js";
 import { GroveConfigSchema } from "./schemas.js";
 export { Grove } from "./pool.js";
 export { GroveConfigSchema } from "./schemas.js";
-export { GroveError, GroveExhaustedError, WorktreeDestroyingError, WorktreeNotManagedError, WorktreeInUseError, GitNotFoundError, GitCommandError, InvalidGroveStateError, LockFailedError, } from "./errors.js";
+export { GroveError, GroveExhaustedError, WorktreeDestroyingError, WorktreeNotManagedError, WorktreeInUseError, GitNotFoundError, GitCommandError, InvalidGroveStateError, LockFailedError, LeaseNotFoundError, LeaseConflictError, LeaseAlreadyExistsError, LeaseQuarantinedError, UnsafeCleanupError, BranchExistsError, BranchNotFoundError, RefNotFoundError, PathOutsidePoolError, BranchDeleteFailedError, HookFailedError, } from "./errors.js";
 export async function createGrove(configInput) {
     const config = GroveConfigSchema.parse(configInput);
     const groveDir = config.groveDir || (await resolveGroveDir(config.repoRoot, config.groveRoot || ""));

package/dist/pool.d.ts

@@ -1,33 +1,33 @@
 import type { GroveConfig } from "./index.js";
 import type { WorktreeEntry } from "./schemas.js";
-export type WorktreeStatusInfo = "available" | "dirty" | "in-use" | "you're here";
-export interface AcquiredSlot {
-    readonly path: string;
-    readonly name: string;
-}
-export interface WorktreeStatus {
-    name: string;
-    path: string;
-    status: WorktreeStatusInfo;
-    processes: {
-        PID: number;
-        Name?: string;
-    }[];
-}
+import type { AcquiredSlot, AcquireLeaseOptions, ReleaseLeaseOptions, DestroyLeaseOptions, RepairLeaseOptions, GroveLease, WorktreeStatus } from "./types.js";
 export declare class Grove {
     readonly poolDir: string;
     private config;
     constructor(poolDir: string, config: GroveConfig);
+    private runHook;
+    private findOrAllocateSlot;
     acquire(): Promise<AcquiredSlot>;
-    release(worktreePath: string): Promise<void>;
-    private nextName;
-    list(): Promise<WorktreeStatus[]>;
-    destroy(worktreePath: string, options?: {
-        force?: boolean;
-    }): Promise<void>;
+    acquire(options: AcquireLeaseOptions): Promise<GroveLease>;
+    release(path: string): Promise<void>;
+    release(leaseIdOrPath: string, options: ReleaseLeaseOptions): Promise<GroveLease>;
+    destroy(leaseIdOrPath: string, options?: DestroyLeaseOptions): Promise<void>;
+    private executeDestroy;
     destroyAll(options?: {
         force?: boolean;
     }): Promise<void>;
+    repair(options: RepairLeaseOptions): Promise<GroveLease | void>;
+    inspect(leaseIdOrPath: string): Promise<GroveLease | null>;
+    list(_options?: {
+        includeProcesses?: boolean;
+    }): Promise<WorktreeStatus[]>;
+    listLeases(_options?: {
+        includeProcesses?: boolean;
+    }): Promise<GroveLease[]>;
     findByPath(worktreePath: string): Promise<WorktreeEntry | null>;
+    private nextName;
+    private cwdInWorktree;
+    private assertPathWithinPool;
+    private leaseEnv;
 }
 //# sourceMappingURL=pool.d.ts.map

package/dist/pool.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"pool.d.ts","sourceRoot":"","sources":["../src/pool.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAC9C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAQlD,MAAM,MAAM,kBAAkB,GAAG,WAAW,GAAG,OAAO,GAAG,QAAQ,GAAG,aAAa,CAAC;AAElF,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,kBAAkB,CAAC;IAC3B,SAAS,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;CAC7C;AAED,qBAAa,KAAK;aAEE,OAAO,EAAE,MAAM;IAC/B,OAAO,CAAC,MAAM;IAFhB,YACkB,OAAO,EAAE,MAAM,EACvB,MAAM,EAAE,WAAW,EACzB;IAEE,OAAO,IAAI,OAAO,CAAC,YAAY,CAAC,CA4ErC;IAEK,OAAO,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CA6BjD;IAED,OAAO,CAAC,QAAQ;IAWV,IAAI,IAAI,OAAO,CAAC,cAAc,EAAE,CAAC,CAuCtC;IAEK,OAAO,CAAC,YAAY,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAyDhF;IAEK,UAAU,CAAC,OAAO,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CA6D7D;IAEK,UAAU,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC,CAQpE;CACF"}
+{"version":3,"file":"pool.d.ts","sourceRoot":"","sources":["../src/pool.ts"],"names":[],"mappings":"AAoBA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAC9C,OAAO,KAAK,EAAE,aAAa,EAAc,MAAM,cAAc,CAAC;AAc9D,OAAO,KAAK,EACV,YAAY,EACZ,mBAAmB,EACnB,mBAAmB,EACnB,mBAAmB,EACnB,kBAAkB,EAClB,UAAU,EACV,cAAc,EACf,MAAM,YAAY,CAAC;AAGpB,qBAAa,KAAK;aAEE,OAAO,EAAE,MAAM;IAC/B,OAAO,CAAC,MAAM;IAFhB,YACkB,OAAO,EAAE,MAAM,EACvB,MAAM,EAAE,WAAW,EACzB;YAEU,OAAO;YAiBP,kBAAkB;IA0C1B,OAAO,IAAI,OAAO,CAAC,YAAY,CAAC,CAAC;IACjC,OAAO,CAAC,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;IA4J3D,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACrC,OAAO,CAAC,aAAa,EAAE,MAAM,EAAE,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;IA2GlF,OAAO,CAAC,aAAa,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,mBAAmB,GAAG,OAAO,CAAC,IAAI,CAAC,CA4CjF;YAEa,cAAc;IA0CtB,UAAU,CAAC,OAAO,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAgD7D;IAEK,MAAM,CAAC,OAAO,EAAE,kBAAkB,GAAG,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC,CAiDpE;IAEK,OAAO,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC,CAE/D;IAEK,IAAI,CAAC,QAAQ,CAAC,EAAE;QAAE,gBAAgB,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC,CAE/E;IAEK,UAAU,CAAC,QAAQ,CAAC,EAAE;QAAE,gBAAgB,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC,CAEjF;IAEK,UAAU,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC,CAQpE;IAED,OAAO,CAAC,QAAQ;IAWhB,OAAO,CAAC,aAAa;IAKrB,OAAO,CAAC,oBAAoB;IAO5B,OAAO,CAAC,QAAQ;CAUjB"}