devchain-cli 0.25.0 → 0.26.1

package/dist/server/modules/worktrees/worktrees.service.d.ts

@@ -0,0 +1,50 @@
+import { type AgentStorage, type EpicStorage, type ProjectStorage, type WorktreeStorage } from '../storage/interfaces/storage.interface';
+import { ProjectWriteGate } from '../storage/write-gate/project-write-gate';
+import { TeamsStore } from '../teams/storage/teams.store';
+import { ProjectGitMutex } from './project-git-mutex';
+import { WorktreeGitRunner } from './worktree-git-runner';
+import { WorktreeAdmissionService } from './worktree-admission.service';
+import type { CreateLaneOptions, CreatedLane, LaneList, RemovedLane, CommittedLane, MergedLane } from './worktrees.types';
+export declare class WorktreesService {
+    private readonly storage;
+    private readonly teams;
+    private readonly gate;
+    private readonly git;
+    private readonly mutex;
+    private readonly admission;
+    constructor(storage: WorktreeStorage & ProjectStorage & EpicStorage & AgentStorage, teams: TeamsStore, gate: ProjectWriteGate, git: WorktreeGitRunner, mutex: ProjectGitMutex, admission: WorktreeAdmissionService);
+    create(projectId: string, leadAgentId: string, options?: CreateLaneOptions): Promise<CreatedLane>;
+    listOnHost(projectId: string): Promise<{
+        lanes: {
+            name: string;
+            path: string;
+            branch: string;
+            dirty: boolean;
+        }[];
+    }>;
+    list(projectId: string, leadAgentId: string, name?: string): Promise<LaneList>;
+    remove(projectId: string, leadAgentId: string, name: string): Promise<RemovedLane>;
+    commit(projectId: string, leadAgentId: string, name: string, message: string): Promise<CommittedLane>;
+    merge(projectId: string, leadAgentId: string, name: string, expectedHead: string): Promise<MergedLane>;
+    private mutate;
+    private requireLaneDirectory;
+    private unmergedFiles;
+    private assertCommitSucceeded;
+    private checkCommitIndex;
+    private authorize;
+    private defaultName;
+    private lanePath;
+    private assertLanePath;
+    private requireLane;
+    private resolveBase;
+    private headSha;
+    private assertClean;
+    private rootBranchRef;
+    private dirtyFiles;
+    private readLane;
+    private preview;
+    private pathExists;
+    private directoryExists;
+    private envMatchesRoot;
+    private removed;
+}

package/dist/server/modules/worktrees/worktrees.service.js

@@ -0,0 +1,586 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+var __param = (this && this.__param) || function (paramIndex, decorator) {
+    return function (target, key) { decorator(target, key, paramIndex); }
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.WorktreesService = void 0;
+const common_1 = require("@nestjs/common");
+const node_crypto_1 = require("node:crypto");
+const promises_1 = require("node:fs/promises");
+const node_os_1 = require("node:os");
+const node_path_1 = require("node:path");
+const error_types_1 = require("../../common/errors/error-types");
+const path_validation_1 = require("../../common/validation/path-validation");
+const storage_interface_1 = require("../storage/interfaces/storage.interface");
+const project_write_gate_1 = require("../storage/write-gate/project-write-gate");
+const teams_store_1 = require("../teams/storage/teams.store");
+const quote_shell_arg_1 = require("../terminal/services/terminal-io/quote-shell-arg");
+const git_output_1 = require("./git-output");
+const project_git_mutex_1 = require("./project-git-mutex");
+const worktree_git_runner_1 = require("./worktree-git-runner");
+const worktree_admission_service_1 = require("./worktree-admission.service");
+const worktrees_errors_1 = require("./worktrees.errors");
+const LANE_LIMIT = 5;
+const IGNORED_PATH_LIMIT = 50;
+let WorktreesService = class WorktreesService {
+    storage;
+    teams;
+    gate;
+    git;
+    mutex;
+    admission;
+    constructor(storage, teams, gate, git, mutex, admission) {
+        this.storage = storage;
+        this.teams = teams;
+        this.gate = gate;
+        this.git = git;
+        this.mutex = mutex;
+        this.admission = admission;
+    }
+    async create(projectId, leadAgentId, options = {}) {
+        return this.mutate(projectId, leadAgentId, 'create', async (project) => {
+            const epic = options.epicId ? await this.storage.getEpic(options.epicId) : null;
+            if (epic && epic.projectId !== projectId) {
+                throw new worktrees_errors_1.WorktreeError('WORKTREE_INVALID_EPIC', 'Epic must belong to this project.', 400);
+            }
+            const rows = await this.storage.listWorktrees(projectId);
+            const name = options.name ?? this.defaultName(rows, epic);
+            if (!/^[a-z0-9-]{1,40}$/.test(name)) {
+                throw new worktrees_errors_1.WorktreeError('WORKTREE_INVALID_NAME', 'Lane name must be a lowercase slug of at most 40 characters.', 400);
+            }
+            if (rows.some((row) => row.name.toLowerCase() === name.toLowerCase())) {
+                throw new worktrees_errors_1.WorktreeError('WORKTREE_NAME_EXISTS', 'Lane name already exists.', 409, { name });
+            }
+            const { baseBranch, baseSha } = await this.resolveBase(project.rootPath, options.baseRef);
+            const id = (0, node_crypto_1.randomUUID)();
+            const branch = `devchain/${name}-${id.slice(0, 6)}`;
+            await this.git.require(project.rootPath, ['check-ref-format', '--branch', branch]);
+            const path = this.lanePath(projectId, name);
+            if (await this.pathExists(path)) {
+                throw new worktrees_errors_1.WorktreeError('WORKTREE_PATH_EXISTS', 'Lane path already exists.', 409, { path });
+            }
+            let row;
+            try {
+                row = await this.storage.createWorktreeAtomicCapped({
+                    id,
+                    projectId,
+                    name,
+                    path,
+                    branch,
+                    baseBranch,
+                    baseSha,
+                    epicId: epic?.id ?? null,
+                    createdByType: 'agent',
+                    createdByAgentId: leadAgentId,
+                }, LANE_LIMIT);
+            }
+            catch (error) {
+                if (error instanceof error_types_1.WorktreeCapReachedError) {
+                    throw new worktrees_errors_1.WorktreeError('WORKTREE_LIMIT_REACHED', 'Project has reached its five-lane limit.', 409, error.details);
+                }
+                if (error instanceof error_types_1.ConflictError) {
+                    throw new worktrees_errors_1.WorktreeError('WORKTREE_NAME_EXISTS', 'Lane name already exists.', 409, {
+                        name,
+                    });
+                }
+                throw error;
+            }
+            try {
+                await (0, promises_1.mkdir)((0, node_path_1.dirname)(path), { recursive: true });
+                await this.git.require(project.rootPath, [
+                    'worktree',
+                    'add',
+                    '-b',
+                    branch,
+                    '--',
+                    path,
+                    baseSha,
+                ]);
+            }
+            catch (error) {
+                const worktrees = await this.git.require(project.rootPath, [
+                    'worktree',
+                    'list',
+                    '--porcelain',
+                ]);
+                if (worktrees.split('\n').includes(`worktree ${path}`)) {
+                    throw new worktrees_errors_1.WorktreeError('WORKTREE_SETUP_FAILED', 'Git created the lane, but a checkout hook failed. Inspect the lane, or remove it with devchain_worktrees_remove.', 409, {
+                        name,
+                        path,
+                        branch,
+                        stderr: error instanceof worktrees_errors_1.WorktreeError ? error.details?.stderr : undefined,
+                    });
+                }
+                await this.storage.deleteWorktree(row.id);
+                throw error;
+            }
+            return { ...row, projectRootPath: project.rootPath };
+        });
+    }
+    async listOnHost(projectId) {
+        await this.storage.getProject(projectId);
+        return this.mutex.runExclusive(projectId, async () => {
+            const lanes = [];
+            for (const row of await this.storage.listWorktrees(projectId)) {
+                let dirty = true;
+                try {
+                    this.assertLanePath(row);
+                    dirty =
+                        (await this.directoryExists(row.path)) && (await this.dirtyFiles(row.path)).length > 0;
+                }
+                catch {
+                }
+                lanes.push({ name: row.name, path: row.path, branch: row.branch, dirty });
+            }
+            return { lanes };
+        });
+    }
+    async list(projectId, leadAgentId, name) {
+        const project = await this.authorize(projectId, leadAgentId);
+        return this.mutex.runExclusive(projectId, async () => {
+            this.gate.assertWritable(projectId);
+            const rows = name === undefined
+                ? await this.storage.listWorktrees(projectId)
+                : [await this.requireLane(projectId, name)];
+            const lanes = [];
+            for (const row of rows)
+                lanes.push(await this.readLane(project.rootPath, row));
+            const result = {
+                projectRootPath: project.rootPath,
+                lanes,
+                rootDirtyFiles: await this.dirtyFiles(project.rootPath),
+            };
+            if (name !== undefined)
+                result.preview = await this.preview(project.rootPath, lanes[0]);
+            return result;
+        });
+    }
+    async remove(projectId, leadAgentId, name) {
+        return this.mutate(projectId, leadAgentId, 'change', async (project) => {
+            const row = await this.requireLane(projectId, name);
+            this.assertLanePath(row);
+            if (!(await this.directoryExists(row.path))) {
+                await this.git.require(project.rootPath, ['worktree', 'prune', '--expire=now']);
+                await this.storage.deleteWorktree(row.id);
+                return this.removed(row, 'pruned', []);
+            }
+            await this.assertClean(row.path);
+            const ignored = (await this.git.require(row.path, [
+                'ls-files',
+                '--others',
+                '--ignored',
+                '--exclude-standard',
+                '-z',
+            ]))
+                .split('\0')
+                .filter(Boolean);
+            const localEnv = [];
+            for (const file of ignored) {
+                if ((0, node_path_1.basename)(file).startsWith('.env') &&
+                    !(await this.envMatchesRoot(row.path, project.rootPath, file)))
+                    localEnv.push(file);
+            }
+            if (localEnv.length > 0) {
+                throw new worktrees_errors_1.WorktreeError('WORKTREE_LOCAL_ENV', 'Lane has environment files without identical root copies.', 409, { files: localEnv });
+            }
+            await this.git.require(project.rootPath, ['worktree', 'remove', '--force', '--', row.path]);
+            await this.storage.deleteWorktree(row.id);
+            return this.removed(row, 'removed', ignored);
+        });
+    }
+    async commit(projectId, leadAgentId, name, message) {
+        return this.mutate(projectId, leadAgentId, 'change', async () => {
+            const row = await this.requireLane(projectId, name);
+            await this.requireLaneDirectory(row);
+            const unmerged = await this.unmergedFiles(row.path);
+            if (unmerged.length > 0) {
+                throw new worktrees_errors_1.WorktreeError('UNMERGED_PATHS', 'Lane has unresolved merge paths.', 409, {
+                    files: unmerged,
+                });
+            }
+            const gitDir = (await this.git.require(row.path, ['rev-parse', '--absolute-git-dir'])).trim();
+            const hasChanges = await this.checkCommitIndex(row.path, gitDir);
+            if (!hasChanges && !(await this.pathExists((0, node_path_1.join)(gitDir, 'MERGE_HEAD')))) {
+                throw new worktrees_errors_1.WorktreeError('NOTHING_TO_COMMIT', 'Lane has nothing to commit.');
+            }
+            const staged = await this.git.run(row.path, ['add', '-A']);
+            this.assertCommitSucceeded(staged);
+            const committed = await this.git.run(row.path, ['commit', '-m', message]);
+            this.assertCommitSucceeded(committed);
+            const sha = await this.headSha(row.path);
+            const files = (await this.git.require(row.path, [
+                'diff-tree',
+                '--no-commit-id',
+                '--name-only',
+                '-r',
+                '-z',
+                `${sha}^1`,
+                sha,
+            ]))
+                .split('\0')
+                .filter(Boolean);
+            return { sha, files };
+        });
+    }
+    async merge(projectId, leadAgentId, name, expectedHead) {
+        return this.mutate(projectId, leadAgentId, 'change', async (project) => {
+            const row = await this.requireLane(projectId, name);
+            await this.requireLaneDirectory(row);
+            await this.assertClean(row.path);
+            const gitDir = (await this.git.require(row.path, ['rev-parse', '--absolute-git-dir'])).trim();
+            const unmerged = await this.unmergedFiles(row.path);
+            if ((await this.pathExists((0, node_path_1.join)(gitDir, 'MERGE_HEAD'))) || unmerged.length > 0) {
+                throw new worktrees_errors_1.WorktreeError('MERGE_IN_PROGRESS', 'Finish the lane merge before landing it.', 409, { files: unmerged });
+            }
+            const head = await this.headSha(row.path);
+            if (head !== expectedHead) {
+                throw new worktrees_errors_1.WorktreeError('HEAD_MISMATCH', 'Lane head differs from the reviewed commit.', 409, { currentHead: head, expectedHead });
+            }
+            const rootRef = await this.rootBranchRef(project.rootPath);
+            const rootBranch = rootRef?.replace(/^refs\/heads\//, '') ?? null;
+            if (rootBranch !== row.baseBranch) {
+                throw new worktrees_errors_1.WorktreeError('TARGET_NOT_CHECKED_OUT', 'Lane base branch must be checked out in the root.', 409, { baseBranch: row.baseBranch, rootBranch });
+            }
+            const oldSha = await this.headSha(project.rootPath);
+            const ancestor = await this.git.run(project.rootPath, [
+                'merge-base',
+                '--is-ancestor',
+                oldSha,
+                expectedHead,
+            ]);
+            if ((0, worktree_git_runner_1.gitFailed)(ancestor, [0, 1])) {
+                throw new worktrees_errors_1.WorktreeError('WORKTREE_GIT_FAILED', 'Cannot check lane ancestry.', 500, {
+                    stderr: ancestor.stderr,
+                });
+            }
+            if (ancestor.exitCode === 1) {
+                const state = await this.readLane(project.rootPath, row);
+                const preview = await this.preview(project.rootPath, state);
+                const recovery = `Ask the lane's agent to run git -C ${(0, quote_shell_arg_1.quoteShellArg)(row.path)} merge ${(0, quote_shell_arg_1.quoteShellArg)(row.baseBranch)}, resolve any conflicts, and run the tests. Then commit with devchain_worktrees_commit and merge with the new head.`;
+                throw new worktrees_errors_1.WorktreeError('BEHIND', recovery, 409, {
+                    ahead: state.ahead,
+                    behind: state.behind,
+                    preview,
+                    recovery,
+                });
+            }
+            const merged = await this.git.run(project.rootPath, [
+                'merge',
+                '--ff-only',
+                '--no-autostash',
+                expectedHead,
+            ]);
+            if ((0, worktree_git_runner_1.gitFailed)(merged)) {
+                throw new worktrees_errors_1.WorktreeError('ROOT_REFUSED', 'Root refused the fast-forward.', 409, {
+                    stderr: merged.stderr,
+                    exitCode: merged.exitCode,
+                });
+            }
+            const newSha = await this.headSha(project.rootPath);
+            return { baseBranch: row.baseBranch, oldSha, newSha };
+        });
+    }
+    async mutate(projectId, leadAgentId, admission, work) {
+        this.admission.assertUnfrozen(projectId);
+        const project = await this.authorize(projectId, leadAgentId);
+        return this.admission.withPermit(projectId, () => this.mutex.runExclusive(projectId, async () => {
+            this.gate.assertWritable(projectId);
+            await this.admission.assertOwned(projectId, admission === 'create');
+            return work(project);
+        }));
+    }
+    async requireLaneDirectory(row) {
+        this.assertLanePath(row);
+        if (!(await this.directoryExists(row.path))) {
+            throw new worktrees_errors_1.WorktreeError('WORKTREE_NOT_FOUND', 'Lane directory is missing.', 404, {
+                path: row.path,
+            });
+        }
+    }
+    async unmergedFiles(path) {
+        return (0, git_output_1.parseUnmergedFiles)(await this.git.require(path, ['ls-files', '-u', '-z']));
+    }
+    assertCommitSucceeded(result) {
+        if ((0, worktree_git_runner_1.gitFailed)(result)) {
+            throw new worktrees_errors_1.WorktreeError('COMMIT_FAILED', 'Lane commit failed.', 500, {
+                stderr: result.stderr,
+                exitCode: result.exitCode,
+                timedOut: result.timedOut,
+                truncated: result.truncated,
+            });
+        }
+    }
+    async checkCommitIndex(path, gitDir) {
+        const folder = await (0, promises_1.mkdtemp)((0, node_path_1.join)((0, node_os_1.tmpdir)(), 'devchain-worktree-index-'));
+        const index = (0, node_path_1.join)(folder, 'index');
+        const options = { env: { GIT_INDEX_FILE: index, LC_ALL: 'C' } };
+        try {
+            await (0, promises_1.copyFile)((0, node_path_1.join)(gitDir, 'index'), index);
+            await this.git.require(path, ['add', '-A'], options);
+            const files = (await this.git.require(path, ['diff', '--cached', '--name-only', '-z'], options))
+                .split('\0')
+                .filter(Boolean);
+            const check = await this.git.run(path, ['diff', '--cached', '--check', '--no-color', '--no-ext-diff'], options);
+            if ((0, worktree_git_runner_1.gitFailed)(check, [0, 2])) {
+                throw new worktrees_errors_1.WorktreeError('WORKTREE_GIT_FAILED', 'Cannot check the lane index.', 500, {
+                    stderr: check.stderr,
+                });
+            }
+            const markers = (0, git_output_1.conflictMarkerFiles)(check.stdout, files);
+            if (markers.length > 0) {
+                throw new worktrees_errors_1.WorktreeError('CONFLICT_MARKERS', 'Lane has leftover conflict markers.', 409, {
+                    files: markers,
+                });
+            }
+            return files.length > 0;
+        }
+        finally {
+            await (0, promises_1.rm)(folder, { recursive: true, force: true });
+        }
+    }
+    async authorize(projectId, leadAgentId) {
+        this.gate.assertWritable(projectId);
+        const ledTeams = await this.teams.getTeamLeadTeams(leadAgentId);
+        if (!ledTeams.some((team) => team.projectId === projectId)) {
+            throw new worktrees_errors_1.WorktreeError('FORBIDDEN_NOT_TEAM_LEAD', 'You do not lead any teams in this project.', 403);
+        }
+        return this.storage.getProject(projectId);
+    }
+    defaultName(rows, epic) {
+        const slug = epic?.title
+            .normalize('NFKD')
+            .toLowerCase()
+            .replace(/[\u0300-\u036f]/g, '')
+            .replace(/[^a-z0-9-]+/g, '-')
+            .replace(/^-+|-+$/g, '')
+            .slice(0, 40)
+            .replace(/-+$/g, '');
+        if (slug)
+            return slug;
+        const names = new Set(rows.map((row) => row.name.toLowerCase()));
+        let n = 1;
+        while (names.has(`lane-${n}`))
+            n++;
+        return `lane-${n}`;
+    }
+    lanePath(projectId, name) {
+        return (0, path_validation_1.validatePathWithinRoot)((0, node_path_1.join)((0, node_os_1.homedir)(), '.devchain', 'worktrees'), `${projectId}/${name}`)
+            .absolutePath;
+    }
+    assertLanePath(row) {
+        if ((0, node_path_1.resolve)(row.path) !== this.lanePath(row.projectId, row.name)) {
+            throw new error_types_1.ValidationError('Lane path does not match its managed location.');
+        }
+    }
+    async requireLane(projectId, name) {
+        const row = await this.storage.getWorktreeByName(projectId, name);
+        if (!row)
+            throw new worktrees_errors_1.WorktreeError('WORKTREE_NOT_FOUND', 'Lane does not exist.', 404, { name });
+        return row;
+    }
+    async resolveBase(root, baseRef) {
+        let ref;
+        if (baseRef === undefined) {
+            const rootRef = await this.rootBranchRef(root);
+            if (rootRef === null) {
+                throw new worktrees_errors_1.WorktreeError('BASE_REF_REQUIRED', 'Detached HEAD requires an explicit base branch.', 400);
+            }
+            ref = rootRef;
+        }
+        else {
+            const result = await this.git.run(root, [
+                'rev-parse',
+                '--verify',
+                '--symbolic-full-name',
+                '--end-of-options',
+                baseRef,
+            ]);
+            if ((0, worktree_git_runner_1.gitFailed)(result)) {
+                throw new worktrees_errors_1.WorktreeError('BASE_MUST_BE_BRANCH', 'Base must resolve to a branch.', 400, {
+                    stderr: result.stderr,
+                });
+            }
+            ref = result.stdout.trim();
+        }
+        if (!ref.startsWith('refs/heads/') && !ref.startsWith('refs/remotes/')) {
+            throw new worktrees_errors_1.WorktreeError('BASE_MUST_BE_BRANCH', 'Base must be a branch rather than a tag or commit.', 400);
+        }
+        const baseSha = (await this.git.require(root, ['rev-parse', '--verify', '--end-of-options', `${ref}^{commit}`])).trim();
+        return { baseBranch: ref.replace(/^refs\/(?:heads|remotes)\//, ''), baseSha };
+    }
+    async headSha(path) {
+        return (await this.git.require(path, ['rev-parse', '--verify', 'HEAD'])).trim();
+    }
+    async assertClean(path) {
+        const dirtyFiles = await this.dirtyFiles(path);
+        if (dirtyFiles.length > 0) {
+            throw new worktrees_errors_1.WorktreeError('WORKTREE_DIRTY', 'Lane has uncommitted files.', 409, {
+                files: dirtyFiles,
+            });
+        }
+    }
+    async rootBranchRef(root) {
+        const result = await this.git.run(root, ['symbolic-ref', '--quiet', 'HEAD']);
+        if ((0, worktree_git_runner_1.gitFailed)(result, [0, 1])) {
+            throw new worktrees_errors_1.WorktreeError('WORKTREE_GIT_FAILED', 'Cannot read the root branch.', 500, {
+                stderr: result.stderr,
+            });
+        }
+        return result.exitCode === 0 ? result.stdout.trim() : null;
+    }
+    async dirtyFiles(path) {
+        return (0, git_output_1.parsePorcelain)(await this.git.require(path, ['status', '--porcelain=v1', '-z', '--untracked-files=all'], {
+            env: { GIT_OPTIONAL_LOCKS: '0' },
+        }));
+    }
+    async readLane(root, row) {
+        this.assertLanePath(row);
+        let epic = null;
+        if (row.epicId) {
+            try {
+                const linked = await this.storage.getEpic(row.epicId);
+                const assignee = linked.agentId ? await this.storage.getAgent(linked.agentId) : null;
+                epic = { id: linked.id, title: linked.title, agentName: assignee?.name ?? null };
+            }
+            catch (error) {
+                if (!(error instanceof error_types_1.NotFoundError))
+                    throw error;
+            }
+        }
+        const state = {
+            ...row,
+            status: 'missing',
+            headSha: null,
+            ahead: null,
+            behind: null,
+            dirtyFiles: [],
+            epic,
+        };
+        if (!(await this.directoryExists(row.path)))
+            return state;
+        state.status = 'present';
+        try {
+            state.headSha = await this.headSha(row.path);
+            state.dirtyFiles = await this.dirtyFiles(row.path);
+            const counts = await this.git.require(root, [
+                'rev-list',
+                '--left-right',
+                '--count',
+                `${row.baseBranch}...${state.headSha}`,
+            ]);
+            const [behind, ahead] = counts.trim().split(/\s+/).map(Number);
+            if (!Number.isSafeInteger(behind) || !Number.isSafeInteger(ahead))
+                throw new error_types_1.ValidationError('Invalid Git ahead/behind result.');
+            state.behind = behind;
+            state.ahead = ahead;
+        }
+        catch (error) {
+            if (!(error instanceof worktrees_errors_1.WorktreeError))
+                throw error;
+            state.status = 'unavailable';
+            state.stateError = String(error.details?.stderr ?? error.message);
+        }
+        return state;
+    }
+    async preview(root, lane) {
+        if (!lane.headSha)
+            return {
+                status: 'unavailable',
+                files: [],
+                stderr: lane.stateError ?? 'Lane directory is missing.',
+            };
+        const result = await this.git.run(root, [
+            'merge-tree',
+            '--write-tree',
+            '--name-only',
+            '-z',
+            lane.baseBranch,
+            lane.headSha,
+        ]);
+        const treeOid = result.stdout.split('\0', 1)[0];
+        if (result.timedOut ||
+            result.truncated ||
+            (result.exitCode !== 0 && result.exitCode !== 1) ||
+            !/^(?:[a-f0-9]{40}|[a-f0-9]{64})$/.test(treeOid)) {
+            return {
+                status: 'unavailable',
+                files: [],
+                stderr: result.stderr || 'Git preview did not complete.',
+            };
+        }
+        return {
+            status: result.exitCode === 0 ? 'clean' : 'conflicts',
+            files: result.exitCode === 1 ? (0, git_output_1.parseMergeTreeConflicts)(result.stdout) : [],
+        };
+    }
+    async pathExists(path) {
+        try {
+            await (0, promises_1.lstat)(path);
+            return true;
+        }
+        catch (error) {
+            if (error.code === 'ENOENT')
+                return false;
+            throw error;
+        }
+    }
+    async directoryExists(path) {
+        try {
+            const stat = await (0, promises_1.lstat)(path);
+            if (!stat.isDirectory() || stat.isSymbolicLink())
+                throw new error_types_1.ValidationError('Lane path must be a directory, not a symlink.');
+            return true;
+        }
+        catch (error) {
+            if (error.code === 'ENOENT')
+                return false;
+            throw error;
+        }
+    }
+    async envMatchesRoot(lane, root, file) {
+        try {
+            const laneRoot = await (0, promises_1.realpath)(lane);
+            const projectRoot = await (0, promises_1.realpath)(root);
+            const safeLane = (0, path_validation_1.validatePathWithinRoot)(laneRoot, file).absolutePath;
+            const safeRoot = (0, path_validation_1.validatePathWithinRoot)(projectRoot, file).absolutePath;
+            const laneFile = await (0, path_validation_1.validateResolvedPathWithinRoot)(safeLane, laneRoot);
+            const rootFile = await (0, path_validation_1.validateResolvedPathWithinRoot)(safeRoot, projectRoot);
+            const [laneBytes, rootBytes] = await Promise.all([(0, promises_1.readFile)(laneFile), (0, promises_1.readFile)(rootFile)]);
+            return laneBytes.equals(rootBytes);
+        }
+        catch {
+            return false;
+        }
+    }
+    removed(row, status, ignored) {
+        const paths = [...new Set(ignored.map((file) => file.split('/')[0]))].sort();
+        return {
+            status,
+            path: row.path,
+            branch: row.branch,
+            deletedIgnoredPaths: paths.slice(0, IGNORED_PATH_LIMIT),
+            deletedIgnoredPathCount: paths.length,
+            ignoredPathsTruncated: paths.length > IGNORED_PATH_LIMIT,
+        };
+    }
+};
+exports.WorktreesService = WorktreesService;
+exports.WorktreesService = WorktreesService = __decorate([
+    (0, common_1.Injectable)(),
+    __param(0, (0, common_1.Inject)(storage_interface_1.STORAGE_SERVICE)),
+    __metadata("design:paramtypes", [Object, teams_store_1.TeamsStore,
+        project_write_gate_1.ProjectWriteGate,
+        worktree_git_runner_1.WorktreeGitRunner,
+        project_git_mutex_1.ProjectGitMutex,
+        worktree_admission_service_1.WorktreeAdmissionService])
+], WorktreesService);
+//# sourceMappingURL=worktrees.service.js.map