Method prepareWorkspaceCheckout

src/node/runtime/SSHRuntime.ts:2755–2968

(params: WorkspaceInitParams, nhp: string)

  }

  private async prepareWorkspaceCheckout(params: WorkspaceInitParams, nhp: string): Promise<void> {
    const { projectPath, branchName, trunkBranch, workspacePath, initLogger, abortSignal, env } =
      params;

    // STARTUP-PERF (warm fast-path): try to materialize the workspace in a
    // single fused SSH command. See `tryWarmWorktreeAdd()` for the contract
    // and miss reasons. When this succeeds, we skip the entire multi-call
    // slow path (test-d → git-check → ensureBaseRepo → snapshot check →
    // manifest check → refreshOrigin → fetchOrigin → resolveBundleTrunkRef →
    // resolveFreshWorkspaceSourceBase → worktree-add), collapsing ~9 sequential
    // SSH round-trips into one.
    const warmHit = await this.tryWarmWorktreeAdd(params, nhp);
    if (warmHit) {
      // STARTUP-PERF: The warm SSH command already reported whether
      // `.gitmodules` exists in the freshly-materialized worktree, so we can
      // skip the (otherwise unavoidable) probe-RTT inside
      // `hasRuntimeGitmodules()` when the answer is "missing". On a typical
      // single-package project this saves one full SSH round-trip on every
      // warm workspace create.
      if (warmHit.gitmodulesPresent) {
        await syncRuntimeGitSubmodules({
          runtime: this,
          workspacePath,
          initLogger,
          abortSignal,
          env,
          trusted: params.trusted,
        });
      }
      return;
    }

    // If the workspace directory already exists and contains a git repo (e.g. forked from
    // another SSH workspace via worktree add or legacy cp), skip the expensive sync step.
    const workspacePathArg = expandTildeForSSH(workspacePath);
    let needsWorktreeCheckout = true;
    let workspacePathExistedBeforeCheckout = false;

    try {
      const dirCheck = await execBuffered(this, `test -d ${workspacePathArg}`, {
        cwd: "/tmp",
        timeout: 10,
        abortSignal,
      });
      if (dirCheck.exitCode === 0) {
        workspacePathExistedBeforeCheckout = true;
        const gitCheck = await execBuffered(
          this,
          `git -C ${workspacePathArg} rev-parse --is-inside-work-tree`,
          {
            cwd: "/tmp",
            timeout: 20,
            abortSignal,
          }
        );
        needsWorktreeCheckout = gitCheck.exitCode !== 0;
      }
    } catch {