Function createWorktree

src/node/git.ts:108–215

(
  config: Config,
  projectPath: string,
  branchName: string,
  options: CreateWorktreeOptions
)

}

export async function createWorktree(
  config: Config,
  projectPath: string,
  branchName: string,
  options: CreateWorktreeOptions
): Promise<WorktreeResult> {
  // Clean up stale lock before git operations on main repo
  cleanStaleLock(projectPath);

  try {
    // Use directoryName if provided, otherwise fall back to branchName (legacy)
    const dirName = options.directoryName ?? branchName;
    // Compute workspace path using Runtime (single source of truth)
    const runtime = createRuntime(
      options.runtimeConfig ?? { type: "local", srcBaseDir: config.srcDir },
      { projectPath }
    );
    const workspacePath = runtime.getWorkspacePath(projectPath, dirName);
    const { trunkBranch } = options;
    const normalizedTrunkBranch = typeof trunkBranch === "string" ? trunkBranch.trim() : "";

    if (!normalizedTrunkBranch) {
      return {
        success: false,
        error: "Trunk branch is required to create a workspace",
      };
    }

    console.assert(
      normalizedTrunkBranch.length > 0,
      "Expected trunk branch to be validated before calling createWorktree"
    );

    // Create workspace directory if it doesn't exist
    if (!fs.existsSync(path.dirname(workspacePath))) {
      fs.mkdirSync(path.dirname(workspacePath), { recursive: true });
    }

    // Check if workspace already exists
    if (fs.existsSync(workspacePath)) {
      return {
        success: false,
        error: `Workspace already exists at ${workspacePath}`,
      };
    }

    const localBranches = await listLocalBranches(projectPath);

    // If branch already exists locally, reuse it instead of creating a new one
    if (localBranches.includes(branchName)) {
      using proc = execFileAsync("git", [
        "-C",
        projectPath,
        "worktree",
        "add",
        workspacePath,
        branchName,
      ]);