Method doRefresh

src/web-ui/src/tools/git/state/GitStateManager.ts:371–514

* Execute an actual refresh.

(
    repositoryPath: string,
    layers: GitStateLayer[],
    force: boolean,
    reason: RefreshReason,
    silent: boolean,
    source?: string
  )

   * Execute an actual refresh.
   */
  private async doRefresh(
    repositoryPath: string,
    layers: GitStateLayer[],
    force: boolean,
    reason: RefreshReason,
    silent: boolean,
    source?: string
  ): Promise<void> {
    const existingLock = this.refreshLocks.get(repositoryPath);
    if (existingLock) {
      if (!force) {
        await existingLock;
        return;
      }
      try {
        await existingLock;
      } catch {
        // A force refresh after a failed in-flight refresh should still get a
        // chance to rebuild fresh state.
      }
    }

    const startedAt = nowMs();
    const shouldProbeReason =
      reason === 'window-focus' || reason === 'visibility' || reason === 'mount';
    let probeError: string | null = null;
    let probeOutcome = 'completed';

    let state = this.getOrCreateState(repositoryPath);
    const prevState = { ...state };


    const now = Date.now();
    const layersToRefresh = force
      ? layers
      : layers.filter((layer) => this.isCacheExpired(state, layer, now));

    if (layersToRefresh.length === 0) {
      if (shouldProbeReason) {
        sendDebugProbe('GitStateManager.ts:doRefresh', 'Git refresh skipped by cache', {
          repositoryPath,
          reason,
          force,
          silent,
          requestedLayers: layers,
        });
      }
      return;
    }

    log.debug('Starting refresh', { repositoryPath, layersToRefresh, reason });

    const refreshPromise = (async () => {
      try {

        if (!silent) {
          state = this.updateState(repositoryPath, {
            isRefreshing: true,