Method createWorkspace

src/node/runtime/DockerRuntime.ts:419–450

(params: WorkspaceCreationParams)

  }

  async createWorkspace(params: WorkspaceCreationParams): Promise<WorkspaceCreationResult> {
    const { projectPath, directoryName } = params;

    // Container identity should follow the workspace entry name rather than the git branch.
    // The two are usually equal today, but the runtime contract keeps them distinct.
    const containerName = getContainerName(projectPath, directoryName);

    // Check if container already exists (collision detection)
    const checkResult = await runDockerCommand(`docker inspect ${containerName}`, 10000);
    if (checkResult.exitCode === 0) {
      return {
        success: false,
        error: `Workspace already exists: container ${containerName}`,
      };
    }
    // Distinguish "container doesn't exist" from actual Docker errors
    if (!checkResult.stderr.toLowerCase().includes("no such object")) {
      return {
        success: false,
        error: `Docker error: ${checkResult.stderr || checkResult.stdout || "unknown error"}`,
      };
    }

    // Store container name - actual container creation happens in postCreateSetup
    // so that image pull progress is visible in the init section
    this.containerName = containerName;

    return {
      success: true,
      workspacePath: CONTAINER_SRC_DIR,
    };
  }

  /**
   * Post-create setup: provision container OR detect fork and setup credentials.