@cleocode/worktree 2026.5.120 → 2026.5.122

package/dist/index.d.ts

@@ -24,6 +24,8 @@ export type { CreateWorktreeOptions, CreateWorktreeResult, DestroyWorktreeOption
 export type { CopyPathsOptions } from './copy-on-write.js';
 export { copyPathsWithReflock } from './copy-on-write.js';
 export { type AddTransientWorktreeOptions, addTransientWorktree, DEFAULT_GIT_TIMEOUT_MS, removeTransientWorktree, } from './git.js';
+export type { PartialWorktreeSignals, RecoveryResult } from './recovery.js';
+export { detectPartialWorktree, recoverPartialWorktree } from './recovery.js';
 export type { WorktreeAuditPayload } from './worktree-audit.js';
 export { addWorktreeToSentinelIndex, appendWorktreeAuditLog, removeWorktreeFromSentinelIndex, resolveWorktreeIndexPath, WORKTREE_INDEX_RELATIVE_PATH, WORKTREE_LIFECYCLE_AUDIT_FILE, } from './worktree-audit.js';
 export { createWorktree } from './worktree-create.js';

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAGH,YAAY,EACV,qBAAqB,EACrB,oBAAoB,EACpB,sBAAsB,EACtB,qBAAqB,EACrB,oBAAoB,EACpB,qBAAqB,EACrB,oBAAoB,EACpB,YAAY,EACZ,kBAAkB,EAClB,sBAAsB,EACtB,iBAAiB,GAClB,MAAM,qBAAqB,CAAC;AAC7B,YAAY,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAC3D,OAAO,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAC1D,OAAO,EACL,KAAK,2BAA2B,EAChC,oBAAoB,EACpB,sBAAsB,EACtB,uBAAuB,GACxB,MAAM,UAAU,CAAC;AAClB,YAAY,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAChE,OAAO,EACL,0BAA0B,EAC1B,sBAAsB,EACtB,+BAA+B,EAC/B,wBAAwB,EACxB,4BAA4B,EAC5B,6BAA6B,GAC9B,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AACvD,OAAO,EAAE,oBAAoB,EAAE,2BAA2B,EAAE,MAAM,uBAAuB,CAAC;AAC1F,OAAO,EACL,aAAa,EACb,0BAA0B,EAC1B,mBAAmB,GACpB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAGH,YAAY,EACV,qBAAqB,EACrB,oBAAoB,EACpB,sBAAsB,EACtB,qBAAqB,EACrB,oBAAoB,EACpB,qBAAqB,EACrB,oBAAoB,EACpB,YAAY,EACZ,kBAAkB,EAClB,sBAAsB,EACtB,iBAAiB,GAClB,MAAM,qBAAqB,CAAC;AAC7B,YAAY,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAC3D,OAAO,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAC1D,OAAO,EACL,KAAK,2BAA2B,EAChC,oBAAoB,EACpB,sBAAsB,EACtB,uBAAuB,GACxB,MAAM,UAAU,CAAC;AAClB,YAAY,EAAE,sBAAsB,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAC5E,OAAO,EAAE,qBAAqB,EAAE,sBAAsB,EAAE,MAAM,eAAe,CAAC;AAC9E,YAAY,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAChE,OAAO,EACL,0BAA0B,EAC1B,sBAAsB,EACtB,+BAA+B,EAC/B,wBAAwB,EACxB,4BAA4B,EAC5B,6BAA6B,GAC9B,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AACvD,OAAO,EAAE,oBAAoB,EAAE,2BAA2B,EAAE,MAAM,uBAAuB,CAAC;AAC1F,OAAO,EACL,aAAa,EACb,0BAA0B,EAC1B,mBAAmB,GACpB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/index.js

@@ -22,6 +22,7 @@
  */
 export { copyPathsWithReflock } from './copy-on-write.js';
 export { addTransientWorktree, DEFAULT_GIT_TIMEOUT_MS, removeTransientWorktree, } from './git.js';
+export { detectPartialWorktree, recoverPartialWorktree } from './recovery.js';
 export { addWorktreeToSentinelIndex, appendWorktreeAuditLog, removeWorktreeFromSentinelIndex, resolveWorktreeIndexPath, WORKTREE_INDEX_RELATIVE_PATH, WORKTREE_LIFECYCLE_AUDIT_FILE, } from './worktree-audit.js';
 export { createWorktree } from './worktree-create.js';
 export { destroyWorktree } from './worktree-destroy.js';

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAiBH,OAAO,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAC1D,OAAO,EAEL,oBAAoB,EACpB,sBAAsB,EACtB,uBAAuB,GACxB,MAAM,UAAU,CAAC;AAElB,OAAO,EACL,0BAA0B,EAC1B,sBAAsB,EACtB,+BAA+B,EAC/B,wBAAwB,EACxB,4BAA4B,EAC5B,6BAA6B,GAC9B,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AACvD,OAAO,EAAE,oBAAoB,EAAE,2BAA2B,EAAE,MAAM,uBAAuB,CAAC;AAC1F,OAAO,EACL,aAAa,EACb,0BAA0B,EAC1B,mBAAmB,GACpB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAiBH,OAAO,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAC1D,OAAO,EAEL,oBAAoB,EACpB,sBAAsB,EACtB,uBAAuB,GACxB,MAAM,UAAU,CAAC;AAElB,OAAO,EAAE,qBAAqB,EAAE,sBAAsB,EAAE,MAAM,eAAe,CAAC;AAE9E,OAAO,EACL,0BAA0B,EAC1B,sBAAsB,EACtB,+BAA+B,EAC/B,wBAAwB,EACxB,4BAA4B,EAC5B,6BAA6B,GAC9B,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AACvD,OAAO,EAAE,oBAAoB,EAAE,2BAA2B,EAAE,MAAM,uBAAuB,CAAC;AAC1F,OAAO,EACL,aAAa,EACb,0BAA0B,EAC1B,mBAAmB,GACpB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/recovery.d.ts

@@ -0,0 +1,77 @@
+/**
+ * Worktree recovery operations for @cleocode/worktree.
+ *
+ * T10456 — Auto-adopt partial worktrees:
+ *   When a spawn hits ETIMEDOUT and leaves a worktree in a partial state,
+ *   the recovery function:
+ *     1. Detects partial state (git status, node_modules, index.lock)
+ *     2. Runs `pnpm install` to restore node_modules
+ *     3. Unlocks the git index if a stale index.lock is present
+ *     4. Resumes from the last checkpoint (if any)
+ *
+ * @task T10456
+ * @epic T10435
+ */
+/**
+ * Signals that indicate a worktree may be in a partial / wedged state.
+ *
+ * @task T10456
+ */
+export interface PartialWorktreeSignals {
+    /** True when `git status --porcelain` returns non-empty output. */
+    hasUncommittedChanges: boolean;
+    /** True when `node_modules` is missing from the worktree root. */
+    nodeModulesMissing: boolean;
+    /** True when `.git/index.lock` exists (wedged git index). */
+    indexLockPresent: boolean;
+    /** True when the worktree directory itself exists but looks incomplete. */
+    worktreeExists: boolean;
+}
+/**
+ * Result of a recovery attempt.
+ *
+ * @task T10456
+ */
+export interface RecoveryResult {
+    /** Whether the recovery succeeded overall. */
+    success: boolean;
+    /** What actions were taken. */
+    actions: string[];
+    /** Error message if recovery failed. */
+    error?: string;
+    /** The partial-state signals that were detected before recovery. */
+    signals: PartialWorktreeSignals;
+}
+/**
+ * Detect whether a worktree is in a partial state.
+ *
+ * Checks for:
+ *   1. Uncommitted changes (`git status --porcelain`)
+ *   2. Missing `node_modules`
+ *   3. Stale `.git/index.lock`
+ *
+ * @param worktreePath - Absolute path to the worktree directory.
+ * @returns Detection signals.
+ * @task T10456
+ */
+export declare function detectPartialWorktree(worktreePath: string): PartialWorktreeSignals;
+/**
+ * Auto-adopt a partial worktree by running recovery steps.
+ *
+ * Steps:
+ *   1. Detect partial state via {@link detectPartialWorktree}.
+ *   2. If `node_modules` is missing, run `pnpm install` (bounded by 120s).
+ *   3. If `.git/index.lock` is present, remove it and run `git worktree unlock`.
+ *   4. If a checkpoint file (`.cleo/checkpoint.json`) exists, read it and
+ *      return the checkpoint state so the caller can resume.
+ *
+ * All steps are best-effort: a failure in one step does not abort the others.
+ *
+ * @param projectRoot  - Absolute path to the project root.
+ * @param worktreePath - Absolute path to the partial worktree.
+ * @param taskId       - Task ID associated with the worktree.
+ * @returns Recovery result with actions taken and any error.
+ * @task T10456
+ */
+export declare function recoverPartialWorktree(projectRoot: string, worktreePath: string, taskId: string): RecoveryResult;
+//# sourceMappingURL=recovery.d.ts.map

package/dist/recovery.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"recovery.d.ts","sourceRoot":"","sources":["../src/recovery.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AA2BH;;;;GAIG;AACH,MAAM,WAAW,sBAAsB;IACrC,mEAAmE;IACnE,qBAAqB,EAAE,OAAO,CAAC;IAC/B,kEAAkE;IAClE,kBAAkB,EAAE,OAAO,CAAC;IAC5B,6DAA6D;IAC7D,gBAAgB,EAAE,OAAO,CAAC;IAC1B,2EAA2E;IAC3E,cAAc,EAAE,OAAO,CAAC;CACzB;AAED;;;;GAIG;AACH,MAAM,WAAW,cAAc;IAC7B,8CAA8C;IAC9C,OAAO,EAAE,OAAO,CAAC;IACjB,+BAA+B;IAC/B,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,wCAAwC;IACxC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,oEAAoE;IACpE,OAAO,EAAE,sBAAsB,CAAC;CACjC;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,qBAAqB,CAAC,YAAY,EAAE,MAAM,GAAG,sBAAsB,CAgClF;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,sBAAsB,CACpC,WAAW,EAAE,MAAM,EACnB,YAAY,EAAE,MAAM,EACpB,MAAM,EAAE,MAAM,GACb,cAAc,CA+EhB"}

package/dist/recovery.js

@@ -0,0 +1,172 @@
+/**
+ * Worktree recovery operations for @cleocode/worktree.
+ *
+ * T10456 — Auto-adopt partial worktrees:
+ *   When a spawn hits ETIMEDOUT and leaves a worktree in a partial state,
+ *   the recovery function:
+ *     1. Detects partial state (git status, node_modules, index.lock)
+ *     2. Runs `pnpm install` to restore node_modules
+ *     3. Unlocks the git index if a stale index.lock is present
+ *     4. Resumes from the last checkpoint (if any)
+ *
+ * @task T10456
+ * @epic T10435
+ */
+import { execFileSync } from 'node:child_process';
+import { existsSync, readFileSync, rmSync } from 'node:fs';
+import { join } from 'node:path';
+function resolveGitAdminDir(worktreePath) {
+    const gitPath = join(worktreePath, '.git');
+    if (!existsSync(gitPath))
+        return gitPath;
+    try {
+        const gitContent = readFileSync(gitPath, 'utf-8').trim();
+        if (gitContent.startsWith('gitdir: ')) {
+            const adminDir = gitContent.slice('gitdir: '.length).trim();
+            return adminDir.startsWith('/') ? adminDir : join(worktreePath, adminDir);
+        }
+    }
+    catch {
+        // `.git` is normally a directory for the primary checkout; fall through.
+    }
+    return gitPath;
+}
+function resolveIndexLockPath(worktreePath) {
+    return join(resolveGitAdminDir(worktreePath), 'index.lock');
+}
+/**
+ * Detect whether a worktree is in a partial state.
+ *
+ * Checks for:
+ *   1. Uncommitted changes (`git status --porcelain`)
+ *   2. Missing `node_modules`
+ *   3. Stale `.git/index.lock`
+ *
+ * @param worktreePath - Absolute path to the worktree directory.
+ * @returns Detection signals.
+ * @task T10456
+ */
+export function detectPartialWorktree(worktreePath) {
+    const signals = {
+        hasUncommittedChanges: false,
+        nodeModulesMissing: false,
+        indexLockPresent: false,
+        worktreeExists: existsSync(worktreePath),
+    };
+    if (!signals.worktreeExists) {
+        return signals;
+    }
+    // 1. Check for uncommitted changes
+    try {
+        const status = execFileSync('git', ['status', '--porcelain'], {
+            cwd: worktreePath,
+            encoding: 'utf-8',
+            timeout: 5_000,
+            stdio: ['pipe', 'pipe', 'pipe'],
+        });
+        signals.hasUncommittedChanges = status.trim().length > 0;
+    }
+    catch {
+        signals.hasUncommittedChanges = false;
+    }
+    // 2. Check for missing node_modules
+    signals.nodeModulesMissing = !existsSync(join(worktreePath, 'node_modules'));
+    // 3. Check for stale index.lock
+    signals.indexLockPresent = existsSync(resolveIndexLockPath(worktreePath));
+    return signals;
+}
+/**
+ * Auto-adopt a partial worktree by running recovery steps.
+ *
+ * Steps:
+ *   1. Detect partial state via {@link detectPartialWorktree}.
+ *   2. If `node_modules` is missing, run `pnpm install` (bounded by 120s).
+ *   3. If `.git/index.lock` is present, remove it and run `git worktree unlock`.
+ *   4. If a checkpoint file (`.cleo/checkpoint.json`) exists, read it and
+ *      return the checkpoint state so the caller can resume.
+ *
+ * All steps are best-effort: a failure in one step does not abort the others.
+ *
+ * @param projectRoot  - Absolute path to the project root.
+ * @param worktreePath - Absolute path to the partial worktree.
+ * @param taskId       - Task ID associated with the worktree.
+ * @returns Recovery result with actions taken and any error.
+ * @task T10456
+ */
+export function recoverPartialWorktree(projectRoot, worktreePath, taskId) {
+    const actions = [];
+    const signals = detectPartialWorktree(worktreePath);
+    if (!signals.worktreeExists) {
+        return {
+            success: false,
+            actions: ['detect-partial-state'],
+            error: `Worktree does not exist: ${worktreePath}`,
+            signals,
+        };
+    }
+    // Step 2: pnpm install when node_modules is missing
+    if (signals.nodeModulesMissing) {
+        try {
+            execFileSync('pnpm', ['install'], {
+                cwd: worktreePath,
+                encoding: 'utf-8',
+                timeout: 120_000,
+                stdio: ['pipe', 'pipe', 'pipe'],
+            });
+            actions.push('pnpm-install');
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : String(err);
+            actions.push(`pnpm-install-failed: ${message}`);
+        }
+    }
+    // Step 3: unlock git index when index.lock is present
+    if (signals.indexLockPresent) {
+        try {
+            const lockPath = resolveIndexLockPath(worktreePath);
+            if (existsSync(lockPath)) {
+                rmSync(lockPath, { force: true });
+            }
+            execFileSync('git', ['worktree', 'unlock', worktreePath], {
+                cwd: projectRoot,
+                encoding: 'utf-8',
+                timeout: 10_000,
+                stdio: ['pipe', 'pipe', 'pipe'],
+            });
+            actions.push('unlock-git-index');
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : String(err);
+            actions.push(`unlock-git-index-failed: ${message}`);
+        }
+    }
+    // Step 4: resume from checkpoint if present
+    const checkpointPath = join(worktreePath, '.cleo', 'checkpoint.json');
+    if (existsSync(checkpointPath)) {
+        try {
+            const raw = readFileSync(checkpointPath, 'utf-8');
+            const checkpoint = JSON.parse(raw);
+            actions.push('checkpoint-resumed');
+            // Return success but surface the checkpoint in the error field for
+            // upstream callers that want to act on it.
+            return {
+                success: true,
+                actions,
+                signals,
+                error: JSON.stringify({ checkpointResumed: true, checkpoint }),
+            };
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : String(err);
+            actions.push(`checkpoint-read-failed: ${message}`);
+        }
+    }
+    const success = actions.some((a) => a === 'pnpm-install' || a === 'unlock-git-index') ||
+        (!signals.nodeModulesMissing && !signals.indexLockPresent);
+    return {
+        success,
+        actions,
+        signals,
+    };
+}
+//# sourceMappingURL=recovery.js.map

package/dist/recovery.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cleocode/worktree",
-  "version": "2026.5.120",
+  "version": "2026.5.122",
   "private": false,
   "type": "module",
   "description": "Native CLEO worktree backend SDK — createWorktree, destroyWorktree, listWorktrees, pruneWorktrees with XDG path canon and declarative hooks (T1161)",
@@ -30,17 +30,17 @@
   "author": "CLEO Code <hello@cleocode.dev>",
   "license": "MIT",
   "dependencies": {
-    "@cleocode/paths": "2026.5.120",
-    "@cleocode/contracts": "2026.5.120"
+    "@cleocode/paths": "2026.5.122",
+    "@cleocode/contracts": "2026.5.122"
   },
   "optionalDependencies": {
-    "@cleocode/worktree-napi": "2026.5.120"
+    "@cleocode/worktree-napi": "2026.5.122"
   },
   "devDependencies": {
     "@types/node": "^24.3.0",
     "typescript": "^6.0.2",
     "vitest": "^4.1.4",
-    "@cleocode/core": "2026.5.120"
+    "@cleocode/core": "2026.5.122"
   },
   "repository": {
     "type": "git",