@ferueda/grove 0.2.0 → 0.3.0

package/dist/process/detect.d.ts

@@ -3,9 +3,16 @@ export interface ProcessInfo {
     PID: number;
     Name?: string;
 }
+export interface ProcessScanResult {
+    processes: ProcessInfo[];
+    unverified: boolean;
+}
 export declare function startedAt(pid: number): Promise<number | null>;
 export declare function reserveOwner(entry: WorktreeEntry): Promise<void>;
 export declare function ownerAlive(entry: WorktreeEntry): Promise<boolean>;
-export declare function findInWorktree(worktreePath: string): Promise<ProcessInfo[]>;
-export declare function isWorktreeInUse(worktreePath: string): Promise<boolean>;
+export declare function findInWorktree(worktreePath: string): Promise<ProcessScanResult>;
+export declare function isWorktreeInUse(worktreePath: string): Promise<{
+    inUse: boolean;
+    unverified: boolean;
+}>;
 //# sourceMappingURL=detect.d.ts.map

package/dist/process/detect.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"detect.d.ts","sourceRoot":"","sources":["../../src/process/detect.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAEnD,MAAM,WAAW,WAAW;IAC1B,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAkBD,wBAAsB,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CA+BnE;AAED,wBAAsB,YAAY,CAAC,KAAK,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CAMtE;AAED,wBAAsB,UAAU,CAAC,KAAK,EAAE,aAAa,GAAG,OAAO,CAAC,OAAO,CAAC,CAsBvE;AAUD,wBAAsB,cAAc,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC,CAgDjF;AAED,wBAAsB,eAAe,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAG5E"}
+{"version":3,"file":"detect.d.ts","sourceRoot":"","sources":["../../src/process/detect.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAEnD,MAAM,WAAW,WAAW;IAC1B,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,iBAAiB;IAChC,SAAS,EAAE,WAAW,EAAE,CAAC;IACzB,UAAU,EAAE,OAAO,CAAC;CACrB;AAkBD,wBAAsB,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CA+BnE;AAED,wBAAsB,YAAY,CAAC,KAAK,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CAMtE;AAED,wBAAsB,UAAU,CAAC,KAAK,EAAE,aAAa,GAAG,OAAO,CAAC,OAAO,CAAC,CAsBvE;AAUD,wBAAsB,cAAc,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAkDrF;AAED,wBAAsB,eAAe,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC;IAAE,KAAK,EAAE,OAAO,CAAC;IAAC,UAAU,EAAE,OAAO,CAAA;CAAE,CAAC,CAG5G"}

package/dist/process/detect.js

@@ -98,7 +98,7 @@ export async function findInWorktree(worktreePath) {
             procs = await readdir("/proc");
         }
         catch {
-            return [];
+            return { processes: [], unverified: true };
         }
         for (const p of procs) {
             if (!/^\d+$/.test(p))
@@ -115,6 +115,7 @@ export async function findInWorktree(worktreePath) {
                 continue;
             }
         }
+        return { processes: result, unverified: false };
     }
     else if (process.platform === "darwin") {
         try {
@@ -134,14 +135,15 @@ export async function findInWorktree(worktreePath) {
                     }
                 }
             }
+            return { processes: result, unverified: false };
         }
         catch {
-            // lsof returns error code if it finds no files or encounters permission errors.
+            return { processes: [], unverified: true };
         }
     }
-    return result;
+    return { processes: [], unverified: true };
 }
 export async function isWorktreeInUse(worktreePath) {
-    const procs = await findInWorktree(worktreePath);
-    return procs.length > 0;
+    const scan = await findInWorktree(worktreePath);
+    return { inUse: scan.processes.length > 0, unverified: scan.unverified };
 }

package/dist/process/terminate.js

@@ -85,8 +85,8 @@ export async function filterProtectedProcesses(procs, currentPID) {
     return procs.filter((p) => !protectedPids.has(p.PID));
 }
 export async function terminateWorktreeProcesses(worktreePath, gracePeriodMs) {
-    const procs = await findInWorktree(worktreePath);
-    const targetProcs = await filterProtectedProcesses(procs, process.pid);
+    const { processes } = await findInWorktree(worktreePath);
+    const targetProcs = await filterProtectedProcesses(processes, process.pid);
     if (targetProcs.length === 0) {
         return [];
     }

package/dist/queries.d.ts

@@ -0,0 +1,8 @@
+import type { WorktreeEntry } from "./schemas.js";
+import type { WorktreeStatus, GroveLease } from "./types.js";
+import type { GroveConfig } from "./index.js";
+export declare function entryToLease(wt: WorktreeEntry, processSafety: "verified" | "unverified", repoRoot: string): GroveLease;
+export declare function listWorktrees(poolDir: string): Promise<WorktreeStatus[]>;
+export declare function listLeases(poolDir: string, config: GroveConfig): Promise<GroveLease[]>;
+export declare function inspectLease(leaseIdOrPath: string, poolDir: string, config: GroveConfig): Promise<GroveLease | null>;
+//# sourceMappingURL=queries.d.ts.map

package/dist/queries.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"queries.d.ts","sourceRoot":"","sources":["../src/queries.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAClD,OAAO,KAAK,EAAE,cAAc,EAAE,UAAU,EAAsB,MAAM,YAAY,CAAC;AACjF,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAO9C,wBAAgB,YAAY,CAAC,EAAE,EAAE,aAAa,EAAE,aAAa,EAAE,UAAU,GAAG,YAAY,EAAE,QAAQ,EAAE,MAAM,GAAG,UAAU,CAkBtH;AAED,wBAAsB,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC,CAsC9E;AAED,wBAAsB,UAAU,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC,CAqB5F;AAED,wBAAsB,YAAY,CAAC,aAAa,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC,CAkB1H"}

package/dist/queries.js

@@ -0,0 +1,97 @@
+import { relative, isAbsolute } from "node:path";
+import { isDirty, getHeadSha } from "./git/index.js";
+import { readState, healState, writeState } from "./state.js";
+import { ownerAlive, findInWorktree } from "./process/detect.js";
+import { withStateLock } from "./lock.js";
+function cwdInWorktree(cwd, worktreePath) {
+    const rel = relative(worktreePath, cwd);
+    return !rel.startsWith("..") && !isAbsolute(rel);
+}
+export function entryToLease(wt, processSafety, repoRoot) {
+    return {
+        leaseId: wt.leaseId,
+        ownerId: wt.ownerId,
+        slotName: wt.name,
+        path: wt.path,
+        repoRoot,
+        branch: wt.branch,
+        baseRef: wt.baseRef,
+        baseSha: wt.baseSha,
+        acquiredHeadSha: wt.acquiredHeadSha || "",
+        currentHeadSha: wt.currentHeadSha || "",
+        state: wt.state || "available",
+        pendingCleanup: wt.pendingCleanup,
+        processSafety,
+        createdAt: wt.createdAt || wt.created_at || "",
+        updatedAt: wt.updatedAt || wt.created_at || "",
+    };
+}
+export async function listWorktrees(poolDir) {
+    const result = [];
+    await withStateLock(poolDir, async () => {
+        let state = await readState(poolDir);
+        state = await healState(state);
+        await writeState(poolDir, state);
+        const cwd = process.cwd();
+        for (const wt of state.worktrees) {
+            if (wt.destroying || wt.state === "destroying" || wt.leaseId)
+                continue;
+            let status = "available";
+            const { processes } = await findInWorktree(wt.path);
+            const alive = await ownerAlive(wt);
+            if (alive) {
+                status = "in-use";
+            }
+            else if (processes.length > 0) {
+                status = "in-use";
+                if (cwdInWorktree(cwd, wt.path)) {
+                    status = "you're here";
+                }
+            }
+            else if (await isDirty(wt.path)) {
+                status = "dirty";
+            }
+            result.push({
+                name: wt.name,
+                path: wt.path,
+                status,
+                processes,
+            });
+        }
+    });
+    return result;
+}
+export async function listLeases(poolDir, config) {
+    const result = [];
+    await withStateLock(poolDir, async () => {
+        let state = await readState(poolDir);
+        state = await healState(state);
+        for (const wt of state.worktrees) {
+            if (!wt.leaseId)
+                continue;
+            const { unverified } = await findInWorktree(wt.path);
+            try {
+                wt.currentHeadSha = await getHeadSha(wt.path);
+            }
+            catch { }
+            result.push(entryToLease(wt, unverified ? "unverified" : "verified", config.repoRoot));
+        }
+    });
+    return result;
+}
+export async function inspectLease(leaseIdOrPath, poolDir, config) {
+    let wt;
+    await withStateLock(poolDir, async () => {
+        let state = await readState(poolDir);
+        state = await healState(state);
+        wt = state.worktrees.find(w => w.leaseId === leaseIdOrPath || w.path === leaseIdOrPath);
+    });
+    if (!wt || !wt.leaseId)
+        return null;
+    const { unverified } = await findInWorktree(wt.path);
+    try {
+        wt.currentHeadSha = await getHeadSha(wt.path);
+    }
+    catch { }
+    return entryToLease(wt, unverified ? "unverified" : "verified", config.repoRoot);
+}

package/dist/schemas.d.ts

@@ -1,4 +1,16 @@
 import { z } from "zod";
+export declare const GroveCleanupIntentSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    cleanup: z.ZodLiteral<"preserve">;
+}, z.core.$strip>, z.ZodObject<{
+    cleanup: z.ZodLiteral<"reset">;
+    resetTo: z.ZodOptional<z.ZodString>;
+    force: z.ZodOptional<z.ZodBoolean>;
+    cleanIgnored: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strip>, z.ZodObject<{
+    cleanup: z.ZodLiteral<"quarantine">;
+}, z.core.$strip>], "cleanup">;
+export type GroveCleanupIntent = z.infer<typeof GroveCleanupIntentSchema>;
+export declare const LeaseIdSchema: z.ZodString;
 export declare const WorktreeEntrySchema: z.ZodObject<{
     name: z.ZodString;
     path: z.ZodString;
@@ -6,6 +18,35 @@ export declare const WorktreeEntrySchema: z.ZodObject<{
     destroying: z.ZodOptional<z.ZodBoolean>;
     owner_pid: z.ZodOptional<z.ZodNumber>;
     owner_started_at: z.ZodOptional<z.ZodNumber>;
+    leaseId: z.ZodOptional<z.ZodString>;
+    ownerId: z.ZodOptional<z.ZodString>;
+    baseRef: z.ZodOptional<z.ZodString>;
+    baseSha: z.ZodOptional<z.ZodString>;
+    acquiredHeadSha: z.ZodOptional<z.ZodString>;
+    currentHeadSha: z.ZodOptional<z.ZodString>;
+    branch: z.ZodOptional<z.ZodString>;
+    state: z.ZodOptional<z.ZodEnum<{
+        available: "available";
+        destroying: "destroying";
+        leased: "leased";
+        quarantined: "quarantined";
+        releasing: "releasing";
+    }>>;
+    pendingCleanup: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
+        cleanup: z.ZodLiteral<"preserve">;
+    }, z.core.$strip>, z.ZodObject<{
+        cleanup: z.ZodLiteral<"reset">;
+        resetTo: z.ZodOptional<z.ZodString>;
+        force: z.ZodOptional<z.ZodBoolean>;
+        cleanIgnored: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$strip>, z.ZodObject<{
+        cleanup: z.ZodLiteral<"quarantine">;
+    }, z.core.$strip>], "cleanup">>;
+    processSafety: z.ZodOptional<z.ZodEnum<{
+        unverified: "unverified";
+        verified: "verified";
+    }>>;
+    updatedAt: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>;
 export type WorktreeEntry = z.infer<typeof WorktreeEntrySchema>;
 export declare const GroveStateSchema: z.ZodObject<{
@@ -16,6 +57,35 @@ export declare const GroveStateSchema: z.ZodObject<{
         destroying: z.ZodOptional<z.ZodBoolean>;
         owner_pid: z.ZodOptional<z.ZodNumber>;
         owner_started_at: z.ZodOptional<z.ZodNumber>;
+        leaseId: z.ZodOptional<z.ZodString>;
+        ownerId: z.ZodOptional<z.ZodString>;
+        baseRef: z.ZodOptional<z.ZodString>;
+        baseSha: z.ZodOptional<z.ZodString>;
+        acquiredHeadSha: z.ZodOptional<z.ZodString>;
+        currentHeadSha: z.ZodOptional<z.ZodString>;
+        branch: z.ZodOptional<z.ZodString>;
+        state: z.ZodOptional<z.ZodEnum<{
+            available: "available";
+            destroying: "destroying";
+            leased: "leased";
+            quarantined: "quarantined";
+            releasing: "releasing";
+        }>>;
+        pendingCleanup: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
+            cleanup: z.ZodLiteral<"preserve">;
+        }, z.core.$strip>, z.ZodObject<{
+            cleanup: z.ZodLiteral<"reset">;
+            resetTo: z.ZodOptional<z.ZodString>;
+            force: z.ZodOptional<z.ZodBoolean>;
+            cleanIgnored: z.ZodOptional<z.ZodBoolean>;
+        }, z.core.$strip>, z.ZodObject<{
+            cleanup: z.ZodLiteral<"quarantine">;
+        }, z.core.$strip>], "cleanup">>;
+        processSafety: z.ZodOptional<z.ZodEnum<{
+            unverified: "unverified";
+            verified: "verified";
+        }>>;
+        updatedAt: z.ZodOptional<z.ZodString>;
     }, z.core.$strip>>;
 }, z.core.$strip>;
 export type GroveState = z.infer<typeof GroveStateSchema>;
@@ -24,10 +94,19 @@ export declare const GroveConfigSchema: z.ZodObject<{
     groveDir: z.ZodOptional<z.ZodString>;
     groveRoot: z.ZodOptional<z.ZodString>;
     maxTrees: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    safeDeleteBranchPrefixes: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    hookTimeoutMs: z.ZodOptional<z.ZodNumber>;
     hooks: z.ZodOptional<z.ZodObject<{
         postCreate: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        postAcquire: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        preRelease: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        postRelease: z.ZodOptional<z.ZodArray<z.ZodString>>;
         preDestroy: z.ZodOptional<z.ZodArray<z.ZodString>>;
     }, z.core.$strip>>;
+    onHookFailure: z.ZodDefault<z.ZodOptional<z.ZodEnum<{
+        fail: "fail";
+        ignore: "ignore";
+    }>>>;
     fetchOnAcquire: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
 }, z.core.$strip>;
 export type GroveConfig = z.input<typeof GroveConfigSchema>;

package/dist/schemas.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"schemas.d.ts","sourceRoot":"","sources":["../src/schemas.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,eAAO,MAAM,mBAAmB;;;;;;;iBAO9B,CAAC;AAEH,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAEhE,eAAO,MAAM,gBAAgB;;;;;;;;;iBAE3B,CAAC;AAEH,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAE1D,eAAO,MAAM,iBAAiB;;;;;;;;;;iBAY5B,CAAC;AAEH,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC"}
+{"version":3,"file":"schemas.d.ts","sourceRoot":"","sources":["../src/schemas.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,eAAO,MAAM,wBAAwB;;;;;;;;;8BASnC,CAAC;AAEH,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAE1E,eAAO,MAAM,aAAa,aAAoF,CAAC;AAE/G,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAoB9B,CAAC;AAEH,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAEhE,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAE3B,CAAC;AAEH,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAE1D,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;iBAkB5B,CAAC;AAEH,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC"}

package/dist/schemas.js

@@ -1,4 +1,15 @@
 import { z } from "zod";
+export const GroveCleanupIntentSchema = z.discriminatedUnion("cleanup", [
+    z.object({ cleanup: z.literal("preserve") }),
+    z.object({
+        cleanup: z.literal("reset"),
+        resetTo: z.string().optional(),
+        force: z.boolean().optional(),
+        cleanIgnored: z.boolean().optional(),
+    }),
+    z.object({ cleanup: z.literal("quarantine") }),
+]);
+export const LeaseIdSchema = z.string().regex(/^[a-zA-Z0-9][a-zA-Z0-9._-]{0,127}$/, "Invalid lease ID format");
 export const WorktreeEntrySchema = z.object({
     name: z.string(),
     path: z.string(),
@@ -6,6 +17,18 @@ export const WorktreeEntrySchema = z.object({
     destroying: z.boolean().optional(),
     owner_pid: z.number().optional(),
     owner_started_at: z.number().optional(),
+    // Lease Mode fields
+    leaseId: LeaseIdSchema.optional(),
+    ownerId: z.string().optional(),
+    baseRef: z.string().optional(),
+    baseSha: z.string().optional(),
+    acquiredHeadSha: z.string().optional(),
+    currentHeadSha: z.string().optional(),
+    branch: z.string().optional(),
+    state: z.enum(["leased", "available", "releasing", "destroying", "quarantined"]).optional(),
+    pendingCleanup: GroveCleanupIntentSchema.optional(),
+    processSafety: z.enum(["verified", "unverified"]).optional(),
+    updatedAt: z.string().optional(),
 });
 export const GroveStateSchema = z.object({
     worktrees: z.array(WorktreeEntrySchema),
@@ -15,11 +38,17 @@ export const GroveConfigSchema = z.object({
     groveDir: z.string().optional(),
     groveRoot: z.string().optional(),
     maxTrees: z.number().optional().default(16),
+    safeDeleteBranchPrefixes: z.array(z.string()).optional(),
+    hookTimeoutMs: z.number().optional(),
     hooks: z
         .object({
         postCreate: z.array(z.string()).optional(),
+        postAcquire: z.array(z.string()).optional(),
+        preRelease: z.array(z.string()).optional(),
+        postRelease: z.array(z.string()).optional(),
         preDestroy: z.array(z.string()).optional(),
     })
         .optional(),
+    onHookFailure: z.enum(["ignore", "fail"]).optional().default("ignore"),
     fetchOnAcquire: z.boolean().optional().default(true),
 });

package/dist/state.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"state.d.ts","sourceRoot":"","sources":["../src/state.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAK/C,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAEtD;AAED,wBAAsB,SAAS,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,CAwBrE;AAED,wBAAsB,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAMnF;AAED,wBAAsB,SAAS,CAAC,KAAK,EAAE,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC,CAqBtE"}
+{"version":3,"file":"state.d.ts","sourceRoot":"","sources":["../src/state.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAK/C,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAEtD;AAED,wBAAsB,SAAS,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,CAwBrE;AAED,wBAAsB,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAMnF;AAED,wBAAsB,SAAS,CAAC,KAAK,EAAE,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC,CA2BtE"}

package/dist/state.js

@@ -54,5 +54,10 @@ export async function healState(state) {
         }
         healed.worktrees.push(entry);
     }
+    for (const entry of healed.worktrees) {
+        if (!entry.state) {
+            entry.state = "available";
+        }
+    }
     return healed;
 }

package/dist/types.d.ts

@@ -0,0 +1,62 @@
+import type { GroveCleanupIntent } 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;
+    }[];
+}
+type AcquireMode = {
+    mode: "branch";
+    branch: string;
+    createBranch?: {
+        from: string;
+        ifExists?: "reuse" | "fail";
+    };
+} | {
+    mode: "detached";
+    ref: string;
+};
+export type AcquireLeaseOptions = AcquireMode & {
+    leaseId: string;
+    ownerId?: string;
+    ifLeased?: "return-existing" | "fail";
+    fetchOnAcquire?: boolean;
+    metadata?: Record<string, string>;
+};
+export type ReleaseLeaseOptions = GroveCleanupIntent;
+export interface DestroyLeaseOptions {
+    force?: boolean;
+    deleteBranch?: boolean;
+}
+export interface RepairLeaseOptions {
+    leaseId: string;
+    action: "quarantine" | "resume-cleanup" | "force-destroy";
+    force?: boolean;
+}
+export interface GroveLease {
+    leaseId: string;
+    ownerId?: string | undefined;
+    slotName: string;
+    path: string;
+    repoRoot: string;
+    branch?: string | undefined;
+    baseRef?: string | undefined;
+    baseSha?: string | undefined;
+    acquiredHeadSha: string;
+    currentHeadSha: string;
+    state: "leased" | "available" | "releasing" | "destroying" | "quarantined";
+    pendingCleanup?: GroveCleanupIntent | undefined;
+    processSafety?: "verified" | "unverified" | undefined;
+    createdAt: string;
+    updatedAt: string;
+}
+export {};
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAEvD,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,KAAK,WAAW,GACZ;IACE,IAAI,EAAE,QAAQ,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,CAAC,EAAE;QACb,IAAI,EAAE,MAAM,CAAC;QACb,QAAQ,CAAC,EAAE,OAAO,GAAG,MAAM,CAAC;KAC7B,CAAC;CACH,GACD;IACE,IAAI,EAAE,UAAU,CAAC;IACjB,GAAG,EAAE,MAAM,CAAC;CACb,CAAC;AAEN,MAAM,MAAM,mBAAmB,GAAG,WAAW,GAAG;IAC9C,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,iBAAiB,GAAG,MAAM,CAAC;IACtC,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACnC,CAAC;AAEF,MAAM,MAAM,mBAAmB,GAAG,kBAAkB,CAAC;AAErD,MAAM,WAAW,mBAAmB;IAClC,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,YAAY,GAAG,gBAAgB,GAAG,eAAe,CAAC;IAC1D,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC7B,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5B,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC7B,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC7B,eAAe,EAAE,MAAM,CAAC;IACxB,cAAc,EAAE,MAAM,CAAC;IACvB,KAAK,EAAE,QAAQ,GAAG,WAAW,GAAG,WAAW,GAAG,YAAY,GAAG,aAAa,CAAC;IAC3E,cAAc,CAAC,EAAE,kBAAkB,GAAG,SAAS,CAAC;IAChD,aAAa,CAAC,EAAE,UAAU,GAAG,YAAY,GAAG,SAAS,CAAC;IACtD,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB"}

package/dist/types.js

@@ -0,0 +1 @@
+export {};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ferueda/grove",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "repository": {
     "type": "git",
     "url": "https://github.com/ferueda/grove.git"