Method forkWorkspace

src/node/worktree/WorktreeManager.ts:888–952

(
    params: WorkspaceForkParams,
    options?: {
      /**
       * Explicit source checkout path. Overrides the name-derived path for sources whose
       * persisted path diverges from their name (e.g. isolation: "none" tasks sharing a parent
       * checkout). See WorktreeRuntime.forkWorkspace.
       */
      sourceWorkspacePath?: string;
    }
  )

  }

  async forkWorkspace(
    params: WorkspaceForkParams,
    options?: {
      /**
       * Explicit source checkout path. Overrides the name-derived path for sources whose
       * persisted path diverges from their name (e.g. isolation: "none" tasks sharing a parent
       * checkout). See WorktreeRuntime.forkWorkspace.
       */
      sourceWorkspacePath?: string;
    }
  ): Promise<WorkspaceForkResult> {
    const { projectPath, sourceWorkspaceName, newWorkspaceName, initLogger } = params;

    // Get source workspace path
    const sourceWorkspacePath =
      options?.sourceWorkspacePath ?? this.getWorkspacePath(projectPath, sourceWorkspaceName);

    // Get current branch from source workspace
    try {
      using proc = execFileAsync(
        "git",
        ["-C", sourceWorkspacePath, "branch", "--show-current"],
        params.abortSignal ? { signal: params.abortSignal } : undefined
      );
      const { stdout } = await proc.result;
      const sourceBranch = stdout.trim();

      if (!sourceBranch) {
        return {
          success: false,
          error: "Failed to detect branch in source workspace",
        };
      }

      // Use createWorkspace with sourceBranch as trunk to fork from source branch
      const createResult = await this.createWorkspace({
        projectPath,
        branchName: newWorkspaceName,
        directoryName: newWorkspaceName,
        trunkBranch: sourceBranch, // Fork from source branch instead of main/master
        initLogger,
        abortSignal: params.abortSignal,
        env: params.env,
        trusted: params.trusted,
      });

      if (!createResult.success || !createResult.workspacePath) {
        return {
          success: false,
          error: createResult.error ?? "Failed to create workspace",
        };
      }

      return {
        success: true,
        workspacePath: createResult.workspacePath,
        sourceBranch,
      };