Method create

packages/server/src/git/worktree.manager.ts:237–271

* Create a new worktree with a new branch. * * - Validates branch name * - Checks branch does not already exist * - Creates the worktree base directory if needed

(branchName: string, startPoint?: string)

   * - Creates the worktree base directory if needed
   */
  async create(branchName: string, startPoint?: string): Promise<string> {
    // Validate branch name
    const validation = isValidBranchName(branchName);
    if (!validation.valid) {
      throw new InvalidBranchNameError(branchName, validation.reason);
    }

    // Check branch does not already exist
    const exists = await this.checkBranchExists(branchName);
    if (exists) {
      throw new BranchExistsError(branchName);
    }

    const worktreePath = path.join(this.worktreeBaseDir, branchName);
    await fs.mkdir(this.worktreeBaseDir, { recursive: true });

    try {
      const args = ['worktree', 'add', '-b', branchName, worktreePath];
      if (startPoint) {
        args.push(startPoint);
      }
      await execGit(this.repoPath, args);
    } catch (err) {
      // Wrap with more context
      if (err instanceof GitError) {
        throw new GitError(
          `Failed to create worktree for branch '${branchName}': ${err.message}`,
          'WORKTREE_CREATE_FAILED'
        );
      }
      throw err;
    }

    return worktreePath;
  }

  /**
   * Remove a worktree. If the worktree does not exist, this is a no-op.