Method createWorkspace

src/node/worktree/WorktreeManager.ts:69–221

(params: {
    projectPath: string;
    branchName: string;
    directoryName?: string;
    trunkBranch: string;
    startPoint?: string;
    skipRemoteSync?: boolean;
    workspacePathOverride?: string;
    initLogger: InitLogger;
    abortSignal?: AbortSignal;
    env?: Record<string, string>;
    trusted?: boolean;
  })

  }

  async createWorkspace(params: {
    projectPath: string;
    branchName: string;
    directoryName?: string;
    trunkBranch: string;
    startPoint?: string;
    skipRemoteSync?: boolean;
    workspacePathOverride?: string;
    initLogger: InitLogger;
    abortSignal?: AbortSignal;
    env?: Record<string, string>;
    trusted?: boolean;
  }): Promise<WorkspaceCreationResult> {
    const { projectPath, branchName, trunkBranch, initLogger } = params;
    // Disable git hooks for untrusted projects (prevents post-checkout execution)
    const noHooksEnv = this.getGitExecOptions(params.trusted, params.abortSignal);
    const workspaceName = params.directoryName ?? branchName;
    const workspacePath =
      params.workspacePathOverride ?? this.getWorkspacePath(projectPath, workspaceName);
    const skipRemoteSync = params.skipRemoteSync === true;
    const trimmedStartPoint = params.startPoint?.trim();
    const startPoint =
      trimmedStartPoint && trimmedStartPoint.length > 0 ? trimmedStartPoint : undefined;
    let worktreeCreated = false;
    let createdBranch = false;

    // Clean up stale lock before git operations on main repo
    cleanStaleLock(projectPath);

    try {
      initLogger.logStep("Creating git worktree...");

      // Create parent directory if needed
      const parentDir = path.dirname(workspacePath);
      try {
        await fsPromises.access(parentDir);
      } catch {
        await fsPromises.mkdir(parentDir, { recursive: true });
      }

      // Check if workspace already exists
      try {
        await fsPromises.access(workspacePath);
        return {
          success: false,
          error: `Workspace already exists at ${workspacePath}`,
        };
      } catch {
        // Workspace doesn't exist, proceed with creation
      }

      // Check if branch exists locally
      const localBranches = await listLocalBranches(projectPath);
      const branchExists = localBranches.includes(branchName);

      // Fetch origin before creating worktree (best-effort)
      // This ensures new branches start from the latest origin state
      const fetchedOrigin = skipRemoteSync