@verevoir/review 0.2.0 → 0.3.0

package/src/warm-first.ts

@@ -0,0 +1,27 @@
+// Cache warm-up for the fan. runPanel dispatches every lens at once, so with a
+// provider prompt cache each lens writes the same shared prefix and none reads
+// it. `warmFirst` wraps a Reviewer so the FIRST call made runs alone, and every
+// later call waits for it to settle (success or failure) before starting: the
+// rest then read the prefix the first one wrote.
+//
+// The seam is the Reviewer itself, so runPanel is untouched. The first caller
+// is whichever lens runPanel invokes first (the first lens in the set); the
+// check-and-set below runs synchronously within that first call, before any
+// await, so no later call can also believe it is first.
+
+import type { Reviewer } from './panel.js';
+
+export function warmFirst(reviewer: Reviewer): Reviewer {
+  let first: Promise<void> | undefined;
+  return (lensId, prompt) => {
+    if (first === undefined) {
+      const call = reviewer(lensId, prompt);
+      first = call.then(
+        () => undefined,
+        () => undefined,
+      );
+      return call;
+    }
+    return first.then(() => reviewer(lensId, prompt));
+  };
+}