@cleocode/worktree 2026.4.117

package/dist/worktree-create.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Worktree creation operation for @cleocode/worktree.
+ *
+ * Creates a git worktree at the canonical XDG path per D029:
+ *   `~/.local/share/cleo/worktrees/<projectHash>/<taskId>/`
+ *
+ * Also:
+ *   - Applies git worktree lock to prevent accidental pruning.
+ *   - Runs declarative `post-create` hooks (D030 native lift).
+ *   - Applies `.cleo/worktree-include` patterns (D030 native lift).
+ *   - Constructs the agent env-var block and prompt preamble.
+ *
+ * @task T1161
+ */
+import type { CreateWorktreeOptions, CreateWorktreeResult } from '@cleocode/contracts';
+/**
+ * Create a git worktree for an agent task.
+ *
+ * Steps:
+ * 1. Resolve paths and project hash from the project root.
+ * 2. Remove stale worktree at the same path if it exists.
+ * 3. Run `git worktree add <path> -b <branch> <baseRef>`.
+ * 4. Optionally apply `git worktree lock` to prevent pruning.
+ * 5. Run declarative `post-create` hooks.
+ * 6. Apply `.cleo/worktree-include` glob patterns (symlinks).
+ * 7. Build and return the {@link CreateWorktreeResult}.
+ *
+ * @param projectRoot - Absolute path to the project root directory.
+ * @param options - Options controlling the worktree creation.
+ * @returns The created worktree result with env vars and preamble.
+ * @throws Error if git worktree add fails.
+ *
+ * @task T1161
+ */
+export declare function createWorktree(projectRoot: string, options: CreateWorktreeOptions): Promise<CreateWorktreeResult>;
+//# sourceMappingURL=worktree-create.d.ts.map

package/dist/worktree-create.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"worktree-create.d.ts","sourceRoot":"","sources":["../src/worktree-create.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAIH,OAAO,KAAK,EAAE,qBAAqB,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAUvF;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAsB,cAAc,CAClC,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,qBAAqB,GAC7B,OAAO,CAAC,oBAAoB,CAAC,CAkG/B"}

package/dist/worktree-create.js

@@ -0,0 +1,127 @@
+/**
+ * Worktree creation operation for @cleocode/worktree.
+ *
+ * Creates a git worktree at the canonical XDG path per D029:
+ *   `~/.local/share/cleo/worktrees/<projectHash>/<taskId>/`
+ *
+ * Also:
+ *   - Applies git worktree lock to prevent accidental pruning.
+ *   - Runs declarative `post-create` hooks (D030 native lift).
+ *   - Applies `.cleo/worktree-include` patterns (D030 native lift).
+ *   - Constructs the agent env-var block and prompt preamble.
+ *
+ * @task T1161
+ */
+import { existsSync, mkdirSync, rmSync } from 'node:fs';
+import { join } from 'node:path';
+import { getGitRoot, gitSilent, gitSync, resolveHeadRef } from './git.js';
+import { computeProjectHash, resolveTaskWorktreePath, resolveWorktreeRootForHash, } from './paths.js';
+import { runWorktreeHooks } from './worktree-hooks.js';
+import { applyIncludePatterns, loadWorktreeIncludePatterns } from './worktree-include.js';
+/**
+ * Create a git worktree for an agent task.
+ *
+ * Steps:
+ * 1. Resolve paths and project hash from the project root.
+ * 2. Remove stale worktree at the same path if it exists.
+ * 3. Run `git worktree add <path> -b <branch> <baseRef>`.
+ * 4. Optionally apply `git worktree lock` to prevent pruning.
+ * 5. Run declarative `post-create` hooks.
+ * 6. Apply `.cleo/worktree-include` glob patterns (symlinks).
+ * 7. Build and return the {@link CreateWorktreeResult}.
+ *
+ * @param projectRoot - Absolute path to the project root directory.
+ * @param options - Options controlling the worktree creation.
+ * @returns The created worktree result with env vars and preamble.
+ * @throws Error if git worktree add fails.
+ *
+ * @task T1161
+ */
+export async function createWorktree(projectRoot, options) {
+    const { taskId, hooks = [], lockWorktree = true } = options;
+    const applyInclude = options.applyIncludePatterns !== false;
+    const gitRoot = getGitRoot(projectRoot);
+    const projectHash = computeProjectHash(projectRoot);
+    const worktreeRoot = resolveWorktreeRootForHash(projectHash);
+    mkdirSync(worktreeRoot, { recursive: true });
+    const branch = options.branchName ?? `task/${taskId}`;
+    const baseRef = options.baseRef ?? resolveHeadRef(gitRoot);
+    const worktreePath = resolveTaskWorktreePath(projectHash, taskId);
+    // Remove stale worktree at this path if it exists (left from a prior run).
+    if (existsSync(worktreePath)) {
+        gitSilent(['worktree', 'unlock', worktreePath], gitRoot);
+        if (!gitSilent(['worktree', 'remove', '--force', worktreePath], gitRoot)) {
+            rmSync(worktreePath, { recursive: true, force: true });
+        }
+        // Best-effort: delete the stale branch.
+        gitSilent(['branch', '-D', branch], gitRoot);
+    }
+    // Create the worktree with a new branch.
+    gitSync(['worktree', 'add', worktreePath, '-b', branch, baseRef], gitRoot);
+    // Apply git worktree lock to prevent accidental pruning.
+    let locked = false;
+    if (lockWorktree) {
+        // Try with --reason (git >= 2.37), fall back without.
+        if (gitSilent(['worktree', 'lock', '--reason', `cleo-agent-${taskId}`, worktreePath], gitRoot)) {
+            locked = true;
+        }
+        else if (gitSilent(['worktree', 'lock', worktreePath], gitRoot)) {
+            locked = true;
+        }
+    }
+    const createdAt = new Date().toISOString();
+    // Run post-create hooks before returning the handle.
+    const hookResults = await runWorktreeHooks(hooks, 'post-create', worktreePath);
+    // Apply .cleo/worktree-include patterns.
+    let appliedPatterns = [];
+    if (applyInclude) {
+        const patterns = loadWorktreeIncludePatterns(projectRoot);
+        appliedPatterns = applyIncludePatterns(patterns, projectRoot, worktreePath);
+    }
+    // Build env vars for agent spawn.
+    const currentPath = process.env['PATH'] ?? '';
+    const shimDir = join(projectRoot, '.cleo', 'bin', 'git-shim');
+    const envVars = {
+        CLEO_AGENT_ROLE: 'worker',
+        CLEO_AGENT_CWD: worktreePath,
+        CLEO_WORKTREE_ROOT: worktreePath,
+        CLEO_WORKTREE_BRANCH: branch,
+        CLEO_PROJECT_HASH: projectHash,
+        CLEO_BRANCH_PROTECTION: 'strict',
+        CLEO_SHIM_MARKER: '.cleo/bin/git-shim',
+        PATH: `${shimDir}:${currentPath}`,
+    };
+    // Build the preamble text for agent context isolation (per acceptance criterion).
+    const preamble = [
+        '## BRANCH ISOLATION PROTOCOL (MANDATORY)',
+        '',
+        `CLEO_AGENT_CWD=${worktreePath}`,
+        '',
+        `FIRST ACTION: cd ${worktreePath}`,
+        '',
+        `You are working on branch: ${branch}`,
+        'You MUST NOT run any of these git commands:',
+        '  git checkout, git switch, git branch -b/-D, git reset --hard,',
+        '  git worktree add/remove, git rebase, git stash pop, git push --force',
+        '',
+        'A git shim is active on your PATH that will exit 77 if you attempt these.',
+        `Your working directory is: ${worktreePath}`,
+        `You are authorized only within \`${worktreePath}\``,
+        'All your commits must land on YOUR branch only.',
+        '',
+    ].join('\n');
+    return {
+        path: worktreePath,
+        branch,
+        baseRef,
+        taskId,
+        projectHash,
+        createdAt,
+        locked,
+        envVars,
+        preamble,
+        hookResults,
+        appliedPatterns,
+    };
+}
+//# sourceMappingURL=worktree-create.js.map

package/dist/worktree-create.js.map

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

package/dist/worktree-destroy.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Worktree destroy operation for @cleocode/worktree.
+ *
+ * Removes the git worktree for a completed task. Optionally cherry-picks
+ * commits from the task branch back to the orchestrator's current branch
+ * before destroying.
+ *
+ * @task T1161
+ */
+import type { DestroyWorktreeOptions, DestroyWorktreeResult } from '@cleocode/contracts';
+/**
+ * Destroy the git worktree for a task.
+ *
+ * Steps:
+ * 1. Optionally cherry-pick commits from the task branch to the base ref.
+ * 2. Unlock the worktree (`git worktree unlock`).
+ * 3. Remove the worktree directory (`git worktree remove --force`).
+ * 4. Optionally delete the task branch.
+ *
+ * Non-fatal errors are captured in the result's `error` field. The caller
+ * decides whether to propagate them.
+ *
+ * @param projectRoot - Absolute path to the project root directory.
+ * @param options - Destroy options including task ID and optional cherry-pick.
+ * @returns Structured result of the destroy operation.
+ *
+ * @task T1161
+ */
+export declare function destroyWorktree(projectRoot: string, options: DestroyWorktreeOptions): DestroyWorktreeResult;
+//# sourceMappingURL=worktree-destroy.d.ts.map

package/dist/worktree-destroy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"worktree-destroy.d.ts","sourceRoot":"","sources":["../src/worktree-destroy.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,KAAK,EAAE,sBAAsB,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAIzF;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,eAAe,CAC7B,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,sBAAsB,GAC9B,qBAAqB,CA8EvB"}

package/dist/worktree-destroy.js

@@ -0,0 +1,110 @@
+/**
+ * Worktree destroy operation for @cleocode/worktree.
+ *
+ * Removes the git worktree for a completed task. Optionally cherry-picks
+ * commits from the task branch back to the orchestrator's current branch
+ * before destroying.
+ *
+ * @task T1161
+ */
+import { existsSync, rmSync } from 'node:fs';
+import { getGitRoot, gitSilent, gitSync, resolveHeadRef } from './git.js';
+import { computeProjectHash, resolveTaskWorktreePath } from './paths.js';
+/**
+ * Destroy the git worktree for a task.
+ *
+ * Steps:
+ * 1. Optionally cherry-pick commits from the task branch to the base ref.
+ * 2. Unlock the worktree (`git worktree unlock`).
+ * 3. Remove the worktree directory (`git worktree remove --force`).
+ * 4. Optionally delete the task branch.
+ *
+ * Non-fatal errors are captured in the result's `error` field. The caller
+ * decides whether to propagate them.
+ *
+ * @param projectRoot - Absolute path to the project root directory.
+ * @param options - Destroy options including task ID and optional cherry-pick.
+ * @returns Structured result of the destroy operation.
+ *
+ * @task T1161
+ */
+export function destroyWorktree(projectRoot, options) {
+    const { taskId, deleteBranch = true, cherryPickFirst = false } = options;
+    const gitRoot = getGitRoot(projectRoot);
+    const projectHash = computeProjectHash(projectRoot);
+    const worktreePath = resolveTaskWorktreePath(projectHash, taskId);
+    const branch = `task/${taskId}`;
+    const baseRef = resolveHeadRef(gitRoot);
+    let cherryPicked = false;
+    let commitCount = 0;
+    let worktreeRemoved = false;
+    let branchDeleted = false;
+    let error;
+    // Step 1: Cherry-pick if requested.
+    if (cherryPickFirst) {
+        try {
+            const branchExists = gitSync(['branch', '--list', branch], gitRoot);
+            if (branchExists) {
+                const log = gitSync(['log', '--reverse', '--format=%H', `${baseRef}..${branch}`], gitRoot);
+                const commits = log
+                    .split('\n')
+                    .map((s) => s.trim())
+                    .filter(Boolean);
+                if (commits.length > 0) {
+                    gitSync(['cherry-pick', ...commits], gitRoot);
+                    cherryPicked = true;
+                    commitCount = commits.length;
+                }
+                else {
+                    cherryPicked = true;
+                    commitCount = 0;
+                }
+            }
+        }
+        catch (err) {
+            gitSilent(['cherry-pick', '--abort'], gitRoot);
+            error = `Cherry-pick failed: ${err instanceof Error ? err.message : String(err)}`;
+        }
+    }
+    // Step 2: Unlock + remove the worktree (even if cherry-pick failed — caller decided).
+    if (existsSync(worktreePath)) {
+        gitSilent(['worktree', 'unlock', worktreePath], gitRoot);
+        if (gitSilent(['worktree', 'remove', '--force', worktreePath], gitRoot)) {
+            worktreeRemoved = true;
+        }
+        else {
+            try {
+                rmSync(worktreePath, { recursive: true, force: true });
+                worktreeRemoved = true;
+            }
+            catch (err2) {
+                if (!error) {
+                    error = `Failed to remove worktree: ${err2 instanceof Error ? err2.message : String(err2)}`;
+                }
+            }
+        }
+    }
+    else {
+        worktreeRemoved = true; // already gone
+    }
+    // Step 3: Optionally delete the branch.
+    if (deleteBranch) {
+        try {
+            const branchExists = gitSync(['branch', '--list', branch], gitRoot);
+            if (branchExists) {
+                gitSync(['branch', '-D', branch], gitRoot);
+            }
+            branchDeleted = true;
+        }
+        catch (err) {
+            if (!error) {
+                error = `Failed to delete branch: ${err instanceof Error ? err.message : String(err)}`;
+            }
+        }
+    }
+    else {
+        branchDeleted = false;
+    }
+    return { taskId, cherryPicked, commitCount, worktreeRemoved, branchDeleted, error };
+}
+//# sourceMappingURL=worktree-destroy.js.map

package/dist/worktree-destroy.js.map

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

package/dist/worktree-hooks.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Declarative worktree hooks framework — native lift of worktrunk's hooks
+ * feature per D030.
+ *
+ * Executes `post-create` and `post-start` hooks in the worktree directory.
+ * Each hook runs via `sh -c <command>` with the worktree path as CWD.
+ *
+ * @task T1161
+ */
+import type { WorktreeHook, WorktreeHookResult } from '@cleocode/contracts';
+/**
+ * Execute a single declarative hook in the given worktree directory.
+ *
+ * @param hook - The hook definition to execute.
+ * @param worktreePath - Absolute path to the worktree directory (CWD for hook).
+ * @returns Hook execution result.
+ */
+export declare function runSingleHook(hook: WorktreeHook, worktreePath: string): Promise<WorktreeHookResult>;
+/**
+ * Run all hooks matching a given lifecycle event in order.
+ *
+ * Hooks are run sequentially. If a hook has `failOnError: true` and exits
+ * non-zero, execution stops immediately and the error is propagated.
+ *
+ * @param hooks - All hook definitions (may include hooks for other events).
+ * @param event - The lifecycle event to filter and run.
+ * @param worktreePath - Absolute path to the worktree directory.
+ * @returns Array of results for hooks that were executed.
+ * @throws Error if a `failOnError` hook fails.
+ */
+export declare function runWorktreeHooks(hooks: readonly WorktreeHook[], event: WorktreeHook['event'], worktreePath: string): Promise<WorktreeHookResult[]>;
+//# sourceMappingURL=worktree-hooks.d.ts.map

package/dist/worktree-hooks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"worktree-hooks.d.ts","sourceRoot":"","sources":["../src/worktree-hooks.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,KAAK,EAAE,YAAY,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAI5E;;;;;;GAMG;AACH,wBAAsB,aAAa,CACjC,IAAI,EAAE,YAAY,EAClB,YAAY,EAAE,MAAM,GACnB,OAAO,CAAC,kBAAkB,CAAC,CA6B7B;AAED;;;;;;;;;;;GAWG;AACH,wBAAsB,gBAAgB,CACpC,KAAK,EAAE,SAAS,YAAY,EAAE,EAC9B,KAAK,EAAE,YAAY,CAAC,OAAO,CAAC,EAC5B,YAAY,EAAE,MAAM,GACnB,OAAO,CAAC,kBAAkB,EAAE,CAAC,CAiB/B"}

package/dist/worktree-hooks.js

@@ -0,0 +1,67 @@
+/**
+ * Declarative worktree hooks framework — native lift of worktrunk's hooks
+ * feature per D030.
+ *
+ * Executes `post-create` and `post-start` hooks in the worktree directory.
+ * Each hook runs via `sh -c <command>` with the worktree path as CWD.
+ *
+ * @task T1161
+ */
+import { execFile } from 'node:child_process';
+const DEFAULT_HOOK_TIMEOUT_MS = 30_000;
+/**
+ * Execute a single declarative hook in the given worktree directory.
+ *
+ * @param hook - The hook definition to execute.
+ * @param worktreePath - Absolute path to the worktree directory (CWD for hook).
+ * @returns Hook execution result.
+ */
+export async function runSingleHook(hook, worktreePath) {
+    const timeoutMs = hook.timeoutMs ?? DEFAULT_HOOK_TIMEOUT_MS;
+    const start = Date.now();
+    return new Promise((resolve) => {
+        const child = execFile('sh', ['-c', hook.command], {
+            cwd: worktreePath,
+            timeout: timeoutMs,
+            encoding: 'utf-8',
+        }, (_err, stdout, stderr) => {
+            const durationMs = Date.now() - start;
+            const exitCode = child.exitCode;
+            const timedOut = exitCode === null && durationMs >= timeoutMs;
+            resolve({
+                hook,
+                success: exitCode === 0,
+                stdout: (typeof stdout === 'string' ? stdout : '').trim(),
+                stderr: (typeof stderr === 'string' ? stderr : '').trim(),
+                exitCode: timedOut ? null : (exitCode ?? 0),
+                durationMs,
+            });
+        });
+    });
+}
+/**
+ * Run all hooks matching a given lifecycle event in order.
+ *
+ * Hooks are run sequentially. If a hook has `failOnError: true` and exits
+ * non-zero, execution stops immediately and the error is propagated.
+ *
+ * @param hooks - All hook definitions (may include hooks for other events).
+ * @param event - The lifecycle event to filter and run.
+ * @param worktreePath - Absolute path to the worktree directory.
+ * @returns Array of results for hooks that were executed.
+ * @throws Error if a `failOnError` hook fails.
+ */
+export async function runWorktreeHooks(hooks, event, worktreePath) {
+    const results = [];
+    const filtered = hooks.filter((h) => h.event === event);
+    for (const hook of filtered) {
+        const result = await runSingleHook(hook, worktreePath);
+        results.push(result);
+        if (!result.success && hook.failOnError) {
+            throw new Error(`Worktree hook failed (failOnError=true): ${hook.command}\n` +
+                `exit: ${result.exitCode}\nstderr: ${result.stderr}`);
+        }
+    }
+    return results;
+}
+//# sourceMappingURL=worktree-hooks.js.map

package/dist/worktree-hooks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"worktree-hooks.js","sourceRoot":"","sources":["../src/worktree-hooks.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAG9C,MAAM,uBAAuB,GAAG,MAAM,CAAC;AAEvC;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,IAAkB,EAClB,YAAoB;IAEpB,MAAM,SAAS,GAAG,IAAI,CAAC,SAAS,IAAI,uBAAuB,CAAC;IAC5D,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IAEzB,OAAO,IAAI,OAAO,CAAqB,CAAC,OAAO,EAAE,EAAE;QACjD,MAAM,KAAK,GAAG,QAAQ,CACpB,IAAI,EACJ,CAAC,IAAI,EAAE,IAAI,CAAC,OAAO,CAAC,EACpB;YACE,GAAG,EAAE,YAAY;YACjB,OAAO,EAAE,SAAS;YAClB,QAAQ,EAAE,OAAO;SAClB,EACD,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,EAAE;YACvB,MAAM,UAAU,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK,CAAC;YACtC,MAAM,QAAQ,GAAG,KAAK,CAAC,QAAQ,CAAC;YAChC,MAAM,QAAQ,GAAG,QAAQ,KAAK,IAAI,IAAI,UAAU,IAAI,SAAS,CAAC;YAE9D,OAAO,CAAC;gBACN,IAAI;gBACJ,OAAO,EAAE,QAAQ,KAAK,CAAC;gBACvB,MAAM,EAAE,CAAC,OAAO,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,EAAE;gBACzD,MAAM,EAAE,CAAC,OAAO,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,EAAE;gBACzD,QAAQ,EAAE,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,QAAQ,IAAI,CAAC,CAAC;gBAC3C,UAAU;aACX,CAAC,CAAC;QACL,CAAC,CACF,CAAC;IACJ,CAAC,CAAC,CAAC;AACL,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,KAA8B,EAC9B,KAA4B,EAC5B,YAAoB;IAEpB,MAAM,OAAO,GAAyB,EAAE,CAAC;IACzC,MAAM,QAAQ,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,KAAK,KAAK,CAAC,CAAC;IAExD,KAAK,MAAM,IAAI,IAAI,QAAQ,EAAE,CAAC;QAC5B,MAAM,MAAM,GAAG,MAAM,aAAa,CAAC,IAAI,EAAE,YAAY,CAAC,CAAC;QACvD,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAErB,IAAI,CAAC,MAAM,CAAC,OAAO,IAAI,IAAI,CAAC,WAAW,EAAE,CAAC;YACxC,MAAM,IAAI,KAAK,CACb,4CAA4C,IAAI,CAAC,OAAO,IAAI;gBAC1D,SAAS,MAAM,CAAC,QAAQ,aAAa,MAAM,CAAC,MAAM,EAAE,CACvD,CAAC;QACJ,CAAC;IACH,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/worktree-include.d.ts

@@ -0,0 +1,54 @@
+/**
+ * `.cleo/worktree-include` glob pattern support — native lift of worktrunk's
+ * worktree-include feature per D030.
+ *
+ * The file `.cleo/worktree-include` in the project root contains glob patterns
+ * (one per line, `#`-prefixed comments stripped, blank lines ignored) that
+ * control which files/directories from the main project tree are symlinked
+ * into a newly created worktree.
+ *
+ * Lines prefixed with `!` are negated patterns (exclusions).
+ *
+ * Example `.cleo/worktree-include`:
+ * ```
+ * # Include pnpm store to avoid re-downloading in each worktree
+ * node_modules/.pnpm
+ * # Include shared config
+ * .env.local
+ * # Exclude secrets
+ * !.env.production
+ * ```
+ *
+ * @task T1161
+ */
+import type { WorktreeIncludePattern } from '@cleocode/contracts';
+/**
+ * Load and parse the `.cleo/worktree-include` file from the project root.
+ *
+ * Returns an empty array if the file does not exist. Comments (lines starting
+ * with `#`) and blank lines are ignored. Lines starting with `!` are parsed
+ * as negated patterns.
+ *
+ * @param projectRoot - Absolute path to the project root.
+ * @returns Parsed include patterns, or empty array if file is absent.
+ */
+export declare function loadWorktreeIncludePatterns(projectRoot: string): WorktreeIncludePattern[];
+/**
+ * Apply include patterns to a newly created worktree by creating symlinks
+ * from the worktree directory back to the main project tree.
+ *
+ * Only non-negated patterns are symlinked. Negated patterns are recorded for
+ * audit purposes but do not cause any filesystem action.
+ *
+ * Symlinks are created as: `<worktreePath>/<pattern>` → `<projectRoot>/<pattern>`
+ *
+ * Already-existing paths in the worktree are skipped (not overwritten) — git
+ * worktree add may have already created them.
+ *
+ * @param patterns - Parsed include patterns from {@link loadWorktreeIncludePatterns}.
+ * @param projectRoot - Absolute path to the project root (symlink target base).
+ * @param worktreePath - Absolute path to the worktree directory.
+ * @returns Array of patterns that were successfully symlinked.
+ */
+export declare function applyIncludePatterns(patterns: readonly WorktreeIncludePattern[], projectRoot: string, worktreePath: string): WorktreeIncludePattern[];
+//# sourceMappingURL=worktree-include.d.ts.map

package/dist/worktree-include.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"worktree-include.d.ts","sourceRoot":"","sources":["../src/worktree-include.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAIH,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,qBAAqB,CAAC;AAIlE;;;;;;;;;GASG;AACH,wBAAgB,2BAA2B,CAAC,WAAW,EAAE,MAAM,GAAG,sBAAsB,EAAE,CAoBzF;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,oBAAoB,CAClC,QAAQ,EAAE,SAAS,sBAAsB,EAAE,EAC3C,WAAW,EAAE,MAAM,EACnB,YAAY,EAAE,MAAM,GACnB,sBAAsB,EAAE,CA2B1B"}

package/dist/worktree-include.js

@@ -0,0 +1,99 @@
+/**
+ * `.cleo/worktree-include` glob pattern support — native lift of worktrunk's
+ * worktree-include feature per D030.
+ *
+ * The file `.cleo/worktree-include` in the project root contains glob patterns
+ * (one per line, `#`-prefixed comments stripped, blank lines ignored) that
+ * control which files/directories from the main project tree are symlinked
+ * into a newly created worktree.
+ *
+ * Lines prefixed with `!` are negated patterns (exclusions).
+ *
+ * Example `.cleo/worktree-include`:
+ * ```
+ * # Include pnpm store to avoid re-downloading in each worktree
+ * node_modules/.pnpm
+ * # Include shared config
+ * .env.local
+ * # Exclude secrets
+ * !.env.production
+ * ```
+ *
+ * @task T1161
+ */
+import { existsSync, readFileSync, symlinkSync } from 'node:fs';
+import { join, resolve } from 'node:path';
+const INCLUDE_FILE_NAME = 'worktree-include';
+/**
+ * Load and parse the `.cleo/worktree-include` file from the project root.
+ *
+ * Returns an empty array if the file does not exist. Comments (lines starting
+ * with `#`) and blank lines are ignored. Lines starting with `!` are parsed
+ * as negated patterns.
+ *
+ * @param projectRoot - Absolute path to the project root.
+ * @returns Parsed include patterns, or empty array if file is absent.
+ */
+export function loadWorktreeIncludePatterns(projectRoot) {
+    const filePath = join(projectRoot, '.cleo', INCLUDE_FILE_NAME);
+    if (!existsSync(filePath))
+        return [];
+    const raw = readFileSync(filePath, 'utf-8');
+    const patterns = [];
+    for (const line of raw.split('\n')) {
+        const trimmed = line.trim();
+        // Skip blank lines and comments
+        if (!trimmed || trimmed.startsWith('#'))
+            continue;
+        const negated = trimmed.startsWith('!');
+        const pattern = negated ? trimmed.slice(1).trim() : trimmed;
+        if (pattern) {
+            patterns.push({ pattern, negated });
+        }
+    }
+    return patterns;
+}
+/**
+ * Apply include patterns to a newly created worktree by creating symlinks
+ * from the worktree directory back to the main project tree.
+ *
+ * Only non-negated patterns are symlinked. Negated patterns are recorded for
+ * audit purposes but do not cause any filesystem action.
+ *
+ * Symlinks are created as: `<worktreePath>/<pattern>` → `<projectRoot>/<pattern>`
+ *
+ * Already-existing paths in the worktree are skipped (not overwritten) — git
+ * worktree add may have already created them.
+ *
+ * @param patterns - Parsed include patterns from {@link loadWorktreeIncludePatterns}.
+ * @param projectRoot - Absolute path to the project root (symlink target base).
+ * @param worktreePath - Absolute path to the worktree directory.
+ * @returns Array of patterns that were successfully symlinked.
+ */
+export function applyIncludePatterns(patterns, projectRoot, worktreePath) {
+    const applied = [];
+    for (const entry of patterns) {
+        // Negated patterns are exclusions — no filesystem action needed.
+        if (entry.negated)
+            continue;
+        const sourcePath = resolve(projectRoot, entry.pattern);
+        const targetPath = resolve(worktreePath, entry.pattern);
+        // Skip if the source does not exist in the project tree.
+        if (!existsSync(sourcePath))
+            continue;
+        // Skip if a file/dir/symlink already exists at this path in the worktree.
+        if (existsSync(targetPath))
+            continue;
+        try {
+            symlinkSync(sourcePath, targetPath);
+            applied.push(entry);
+        }
+        catch {
+            // Non-fatal: log and continue. Callers can inspect applied[] to see
+            // which patterns succeeded.
+            process.stderr.write(`[worktree] include-pattern symlink failed: ${entry.pattern}\n`);
+        }
+    }
+    return applied;
+}
+//# sourceMappingURL=worktree-include.js.map

package/dist/worktree-include.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"worktree-include.js","sourceRoot":"","sources":["../src/worktree-include.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAChE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAG1C,MAAM,iBAAiB,GAAG,kBAAkB,CAAC;AAE7C;;;;;;;;;GASG;AACH,MAAM,UAAU,2BAA2B,CAAC,WAAmB;IAC7D,MAAM,QAAQ,GAAG,IAAI,CAAC,WAAW,EAAE,OAAO,EAAE,iBAAiB,CAAC,CAAC;IAC/D,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC;QAAE,OAAO,EAAE,CAAC;IAErC,MAAM,GAAG,GAAG,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IAC5C,MAAM,QAAQ,GAA6B,EAAE,CAAC;IAE9C,KAAK,MAAM,IAAI,IAAI,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;QACnC,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;QAC5B,gCAAgC;QAChC,IAAI,CAAC,OAAO,IAAI,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC;YAAE,SAAS;QAElD,MAAM,OAAO,GAAG,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC;QACxC,MAAM,OAAO,GAAG,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC;QAC5D,IAAI,OAAO,EAAE,CAAC;YACZ,QAAQ,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC,CAAC;QACtC,CAAC;IACH,CAAC;IAED,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,UAAU,oBAAoB,CAClC,QAA2C,EAC3C,WAAmB,EACnB,YAAoB;IAEpB,MAAM,OAAO,GAA6B,EAAE,CAAC;IAE7C,KAAK,MAAM,KAAK,IAAI,QAAQ,EAAE,CAAC;QAC7B,iEAAiE;QACjE,IAAI,KAAK,CAAC,OAAO;YAAE,SAAS;QAE5B,MAAM,UAAU,GAAG,OAAO,CAAC,WAAW,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC;QACvD,MAAM,UAAU,GAAG,OAAO,CAAC,YAAY,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC;QAExD,yDAAyD;QACzD,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC;YAAE,SAAS;QAEtC,0EAA0E;QAC1E,IAAI,UAAU,CAAC,UAAU,CAAC;YAAE,SAAS;QAErC,IAAI,CAAC;YACH,WAAW,CAAC,UAAU,EAAE,UAAU,CAAC,CAAC;YACpC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACtB,CAAC;QAAC,MAAM,CAAC;YACP,oEAAoE;YACpE,4BAA4B;YAC5B,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,8CAA8C,KAAK,CAAC,OAAO,IAAI,CAAC,CAAC;QACxF,CAAC;IACH,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/worktree-list.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Worktree listing operations for @cleocode/worktree.
+ *
+ * `listWorktrees` and `listWorktreesByProjectRoot` scan the CLEO XDG worktrees
+ * directory to return structured entries.
+ *
+ * @task T1161
+ */
+import type { ListWorktreesOptions, WorktreeListEntry } from '@cleocode/contracts';
+/**
+ * Resolve the worktree root directory for a given project hash.
+ *
+ * Exported so callers can inspect the canonical path without creating a worktree.
+ *
+ * @param projectHash - 16-char project hash.
+ * @param worktreeRoot - Optional explicit override for the root path.
+ * @returns Absolute path to the worktrees root directory for this project.
+ */
+export declare function resolveWorktreeRoot(projectHash: string, worktreeRoot?: string): string;
+/**
+ * List all active CLEO worktrees scoped to a specific project hash.
+ *
+ * Scans the XDG worktrees filesystem directory. Entries without a valid
+ * worktree path on disk are omitted.
+ *
+ * @param options - Listing options including optional project hash filter.
+ * @returns Array of worktree entries.
+ */
+export declare function listWorktrees(options?: ListWorktreesOptions): WorktreeListEntry[];
+/**
+ * List all active CLEO worktrees for a specific project root.
+ *
+ * Computes the project hash from the project root, then delegates to
+ * {@link listWorktrees} with the computed hash as filter.
+ *
+ * @param projectRoot - Absolute path to the project root directory.
+ * @returns Array of worktree list entries for this project.
+ */
+export declare function listWorktreesByProjectRoot(projectRoot: string): WorktreeListEntry[];
+//# sourceMappingURL=worktree-list.d.ts.map

package/dist/worktree-list.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"worktree-list.d.ts","sourceRoot":"","sources":["../src/worktree-list.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAKH,OAAO,KAAK,EAAE,oBAAoB,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAMnF;;;;;;;;GAQG;AACH,wBAAgB,mBAAmB,CAAC,WAAW,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,MAAM,GAAG,MAAM,CAEtF;AAED;;;;;;;;GAQG;AACH,wBAAgB,aAAa,CAAC,OAAO,GAAE,oBAAyB,GAAG,iBAAiB,EAAE,CA2CrF;AAED;;;;;;;;GAQG;AACH,wBAAgB,0BAA0B,CAAC,WAAW,EAAE,MAAM,GAAG,iBAAiB,EAAE,CAGnF"}