Method resolveBatchYielding

src/resolution/index.ts:1323–1368

* Resolve one batch with a yield checkpoint between EVERY ref so the #850 * liveness heartbeat can fire on a slow/dense batch (#1091). The checkpoint * granularity is per-ref — not per-N-refs — because per-ref cost is unbounded * in the worst case (a collision-heavy method name whose candid

(
    batch: UnresolvedReference[],
    maybeYield: MaybeYield
  )

   * between refs changes only timing, never which edges get created.
   */
  private async resolveBatchYielding(
    batch: UnresolvedReference[],
    maybeYield: MaybeYield
  ): Promise<ResolutionResult> {
    this.warmCaches();
    this.advanceSupertypeGeneration();

    const resolved: ResolvedRef[] = [];
    const unresolved: UnresolvedRef[] = [];
    const byMethod: Record<string, number> = {};

    for (const raw of batch) {
      const ref: UnresolvedRef = {
        fromNodeId: raw.fromNodeId,
        referenceName: raw.referenceName,
        referenceKind: raw.referenceKind,
        line: raw.line,
        column: raw.column,
        filePath: raw.filePath || this.getFilePathFromNodeId(raw.fromNodeId),
        language: raw.language || this.getLanguageFromNodeId(raw.fromNodeId),
        rowId: raw.rowId,
      };
      const result = this.resolveOneTimed(ref);
      if (result) {
        resolved.push(result);
        byMethod[result.resolvedBy] = (byMethod[result.resolvedBy] || 0) + 1;
      } else {
        unresolved.push(ref);
      }
      // Fast-path the per-ref yield check: awaiting the async no-op costs a
      // microtask hop per ref, which dominates at ~10⁵ refs (see MaybeYield).
      const y = maybeYield();
      if (y) await y;
    }

    return {
      resolved,
      unresolved,
      stats: {
        total: batch.length,
        resolved: resolved.length,
        unresolved: unresolved.length,
        byMethod,
      },
    };
  }

  /**
   * Resolve a list of refs and return everything the ADMISSION side needs to