Method syncProjectToRemoteOnce

src/node/runtime/SSHRuntime.ts:2320–2452

(
    projectPath: string,
    layout: RemoteProjectLayout,
    initLogger: InitLogger,
    abortSignal?: AbortSignal,
    options: { forceNoThin?: boolean } = {}
  )

  }

  protected async syncProjectToRemoteOnce(
    projectPath: string,
    layout: RemoteProjectLayout,
    initLogger: InitLogger,
    abortSignal?: AbortSignal,
    options: { forceNoThin?: boolean } = {}
  ): Promise<void> {
    if (abortSignal?.aborted) {
      throw new Error(OPERATION_ABORTED_ERROR);
    }

    const currentSnapshotPath = layout.currentSnapshotPath;
    const useNativeGitPush = this.transport instanceof OpenSSHTransport;
    const snapshotDigest = await this.computeSnapshotDigest(projectPath);
    const { baseRepoPathArg, freshlyCreated } = await this.ensureBaseRepo(
      projectPath,
      initLogger,
      abortSignal
    );

    // Treat the shared bare repo as a managed cache: verify its health before
    // we ask Git to negotiate another sync against a fragmented object store.
    //
    // STARTUP-PERF: When ensureBaseRepo just created the bare repo, we know
    // it has zero packs — there is nothing to be fragmented yet. Skip the
    // remote `count-objects -v` probe (~80-100ms SSH round-trip) on the cold
    // path; the next sync against a populated repo will run it normally.
    if (!freshlyCreated) {
      await this.ensureHealthyBaseRepoForSync(baseRepoPathArg, initLogger, abortSignal);
    }

    const snapshotStatusCheck = await execBuffered(
      this,
      [
        'current_snapshot=""',
        `if test -f ${this.quoteForRemote(currentSnapshotPath)}; then`,
        `  current_snapshot=$(tr -d '\n' < ${this.quoteForRemote(currentSnapshotPath)})`,
        "fi",
        `if test "$current_snapshot" = ${shescape.quote(snapshotDigest)}; then`,
        `  staged_ref=$(git -C ${baseRepoPathArg} for-each-ref --count=1 --format='%(refname)' ${shescape.quote(BUNDLE_REF_PREFIX)})`,
        '  if test -n "$staged_ref"; then',
        "    echo reusable",
        "  else",
        "    echo stale-current",
        "  fi",
        "else",
        "  echo missing",
        "fi",
      ].join("\n"),
      { cwd: "/tmp", timeout: 10, abortSignal }
    );
    const snapshotStatus = snapshotStatusCheck.stdout.trim();
    if (snapshotStatus === "reusable") {
      const localRefManifest = await this.resolveLocalSyncRefManifest(projectPath);
      const remoteRefManifest =
        localRefManifest == null
          ? null
          : await this.resolveRemoteSyncRefManifest(baseRepoPathArg, abortSignal);