@lcv-ideas-software/cross-review 4.0.7 → 4.1.0

package/dist/src/core/cache-manifest.d.ts

@@ -11,7 +11,7 @@ export declare function readCacheManifest(dataDir: string, sessionId: string): C
  * by tests; production callers should append entries via
  * appendCacheManifestEntry.
  */
-export declare function writeCacheManifest(dataDir: string, sessionId: string, manifest: CacheManifest): void;
+export declare function writeCacheManifest(dataDir: string, sessionId: string, manifest: CacheManifest): Promise<void>;
 /**
  * Append a single entry to the session manifest. Lazily creates the
  * manifest if it does not exist. Each call performs (a) read-current,
@@ -19,4 +19,4 @@ export declare function writeCacheManifest(dataDir: string, sessionId: string, m
  * process; concurrent calls in the same process must be awaited in
  * order by the caller.
  */
-export declare function appendCacheManifestEntry(dataDir: string, sessionId: string, entry: CacheManifestEntry, cacheSchemaVersion?: string): void;
+export declare function appendCacheManifestEntry(dataDir: string, sessionId: string, entry: CacheManifestEntry, cacheSchemaVersion?: string): Promise<void>;

package/dist/src/core/cache-manifest.js

@@ -23,7 +23,7 @@ const TMP_NONCE_BYTES = 2;
 function manifestPath(dataDir, sessionId) {
     return path.resolve(dataDir, "sessions", sessionId, MANIFEST_FILENAME);
 }
-function writeJsonAtomic(file, data) {
+async function writeJsonAtomic(file, data) {
     fs.mkdirSync(path.dirname(file), { recursive: true });
     const nonce = crypto.randomBytes(TMP_NONCE_BYTES).toString("hex");
     const tmp = `${file}.${process.pid}.${Date.now()}.${nonce}.tmp`;
@@ -39,11 +39,17 @@ function writeJsonAtomic(file, data) {
             const code = err.code;
             if (!code || !ATOMIC_WRITE_RETRY_CODES.has(code))
                 break;
+            // v4.1.0 hardening (Codex R1 catch on the broader F3 grep): this
+            // second atomic-write helper had the SAME CPU-burning busy-wait
+            // as session-store.ts writeJson (now fixed). The single Node
+            // event loop was being blocked for up to 310 ms (10+20+40+80+160)
+            // per cache_manifest append under Windows-AV-induced
+            // EPERM/EBUSY contention. Promise + setTimeout: event loop
+            // remains fully responsive.
             const wait = 10 * 2 ** attempt;
-            const start = Date.now();
-            while (Date.now() - start < wait) {
-                /* spin */
-            }
+            await new Promise((resolve) => {
+                setTimeout(resolve, wait);
+            });
         }
     }
     try {
@@ -77,8 +83,8 @@ export function readCacheManifest(dataDir, sessionId) {
  * by tests; production callers should append entries via
  * appendCacheManifestEntry.
  */
-export function writeCacheManifest(dataDir, sessionId, manifest) {
-    writeJsonAtomic(manifestPath(dataDir, sessionId), manifest);
+export async function writeCacheManifest(dataDir, sessionId, manifest) {
+    await writeJsonAtomic(manifestPath(dataDir, sessionId), manifest);
 }
 /**
  * Append a single entry to the session manifest. Lazily creates the
@@ -87,7 +93,7 @@ export function writeCacheManifest(dataDir, sessionId, manifest) {
  * process; concurrent calls in the same process must be awaited in
  * order by the caller.
  */
-export function appendCacheManifestEntry(dataDir, sessionId, entry, cacheSchemaVersion = CACHE_SCHEMA_VERSION_DEFAULT) {
+export async function appendCacheManifestEntry(dataDir, sessionId, entry, cacheSchemaVersion = CACHE_SCHEMA_VERSION_DEFAULT) {
     const file = manifestPath(dataDir, sessionId);
     const nowIso = new Date().toISOString();
     let current;
@@ -128,6 +134,6 @@ export function appendCacheManifestEntry(dataDir, sessionId, entry, cacheSchemaV
     }
     current.entries.push(entry);
     current.updated_at = nowIso;
-    writeJsonAtomic(file, current);
+    await writeJsonAtomic(file, current);
 }
 //# sourceMappingURL=cache-manifest.js.map

package/dist/src/core/cache-manifest.js.map

@@ -1 +1 @@
-{"version":3,"file":"cache-manifest.js","sourceRoot":"","sources":["../../../src/core/cache-manifest.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"cache-manifest.js","sourceRoot":"","sources":["../../../src/core/cache-manifest.ts"],"names":[],"mappings":"AAAA,6DAA6D;AAC7D,EAAE;AACF,+DAA+D;AAC/D,EAAE;AACF,wEAAwE;AACxE,mEAAmE;AACnE,wEAAwE;AACxE,mEAAmE;AACnE,sCAAsC;AACtC,EAAE;AACF,oEAAoE;AACpE,iEAAiE;AACjE,oEAAoE;AACpE,sDAAsD;AAEtD,OAAO,MAAM,MAAM,aAAa,CAAC;AACjC,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAG7B,MAAM,CAAC,MAAM,4BAA4B,GAAG,IAAI,CAAC;AACjD,MAAM,iBAAiB,GAAG,qBAAqB,CAAC;AAChD,MAAM,wBAAwB,GAAG,IAAI,GAAG,CAAC,CAAC,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,QAAQ,CAAC,CAAC,CAAC;AACjF,MAAM,yBAAyB,GAAG,CAAC,CAAC;AACpC,MAAM,eAAe,GAAG,CAAC,CAAC;AAE1B,SAAS,YAAY,CAAC,OAAe,EAAE,SAAiB;IACtD,OAAO,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,iBAAiB,CAAC,CAAC;AACzE,CAAC;AAED,KAAK,UAAU,eAAe,CAAC,IAAY,EAAE,IAAa;IACxD,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACtD,MAAM,KAAK,GAAG,MAAM,CAAC,WAAW,CAAC,eAAe,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;IAClE,MAAM,GAAG,GAAG,GAAG,IAAI,IAAI,OAAO,CAAC,GAAG,IAAI,IAAI,CAAC,GAAG,EAAE,IAAI,KAAK,MAAM,CAAC;IAChE,EAAE,CAAC,aAAa,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IACpE,IAAI,OAAO,GAAY,IAAI,CAAC;IAC5B,KAAK,IAAI,OAAO,GAAG,CAAC,EAAE,OAAO,GAAG,yBAAyB,EAAE,OAAO,IAAI,CAAC,EAAE,CAAC;QACxE,IAAI,CAAC;YACH,EAAE,CAAC,UAAU,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;YACzB,OAAO;QACT,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO,GAAG,GAAG,CAAC;YACd,MAAM,IAAI,GAAI,GAA6B,CAAC,IAAI,CAAC;YACjD,IAAI,CAAC,IAAI,IAAI,CAAC,wBAAwB,CAAC,GAAG,CAAC,IAAI,CAAC;gBAAE,MAAM;YACxD,iEAAiE;YACjE,gEAAgE;YAChE,6DAA6D;YAC7D,kEAAkE;YAClE,qDAAqD;YACrD,2DAA2D;YAC3D,4BAA4B;YAC5B,MAAM,IAAI,GAAG,EAAE,GAAG,CAAC,IAAI,OAAO,CAAC;YAC/B,MAAM,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE;gBAClC,UAAU,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;YAC5B,CAAC,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IACD,IAAI,CAAC;QACH,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC;IACrB,CAAC;IAAC,MAAM,CAAC;QACP,YAAY;IACd,CAAC;IACD,MAAM,OAAO,CAAC;AAChB,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,iBAAiB,CAAC,OAAe,EAAE,SAAiB;IAClE,MAAM,IAAI,GAAG,YAAY,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC;IAC9C,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC;QAAE,OAAO,IAAI,CAAC;IACtC,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,EAAE,CAAC,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;QAC1C,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAkB,CAAC;QAChD,OAAO,MAAM,CAAC;IAChB,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,OAAe,EACf,SAAiB,EACjB,QAAuB;IAEvB,MAAM,eAAe,CAAC,YAAY,CAAC,OAAO,EAAE,SAAS,CAAC,EAAE,QAAQ,CAAC,CAAC;AACpE,CAAC;AAED;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,wBAAwB,CAC5C,OAAe,EACf,SAAiB,EACjB,KAAyB,EACzB,qBAA6B,4BAA4B;IAEzD,MAAM,IAAI,GAAG,YAAY,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC;IAC9C,MAAM,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IACxC,IAAI,OAAsB,CAAC;IAC3B,IAAI,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;QACxB,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,EAAE,CAAC,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;YAC1C,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAkB,CAAC;QAC7C,CAAC;QAAC,MAAM,CAAC;YACP,8DAA8D;YAC9D,+DAA+D;YAC/D,4DAA4D;YAC5D,wBAAwB;YACxB,MAAM,OAAO,GAAG,GAAG,IAAI,YAAY,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC;YAChD,IAAI,CAAC;gBACH,EAAE,CAAC,UAAU,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;YAC/B,CAAC;YAAC,MAAM,CAAC;gBACP,YAAY;YACd,CAAC;YACD,OAAO,GAAG;gBACR,UAAU,EAAE,SAAS;gBACrB,oBAAoB,EAAE,kBAAkB;gBACxC,UAAU,EAAE,MAAM;gBAClB,UAAU,EAAE,MAAM;gBAClB,OAAO,EAAE,EAAE;aACZ,CAAC;QACJ,CAAC;IACH,CAAC;SAAM,CAAC;QACN,OAAO,GAAG;YACR,UAAU,EAAE,SAAS;YACrB,oBAAoB,EAAE,kBAAkB;YACxC,UAAU,EAAE,MAAM;YAClB,UAAU,EAAE,MAAM;YAClB,OAAO,EAAE,EAAE;SACZ,CAAC;IACJ,CAAC;IACD,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC5B,OAAO,CAAC,UAAU,GAAG,MAAM,CAAC;IAC5B,MAAM,eAAe,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;AACvC,CAAC"}

package/dist/src/core/config.d.ts

@@ -1,6 +1,6 @@
 import type { AppConfig, PeerId } from "./types.js";
-export declare const VERSION = "4.0.7";
-export declare const RELEASE_DATE = "2026-05-16";
+export declare const VERSION = "4.1.0";
+export declare const RELEASE_DATE = "2026-05-17";
 export declare const DEFAULT_MAX_OUTPUT_TOKENS = 20000;
 export declare function getLastFileConfigResult(): import("./file-config.js").ApplyFileConfigResult | undefined;
 export declare function loadConfig(): AppConfig;

package/dist/src/core/config.js

@@ -17,8 +17,8 @@ function expandHome(rawPath) {
     }
     return rawPath;
 }
-export const VERSION = "4.0.7";
-export const RELEASE_DATE = "2026-05-16";
+export const VERSION = "4.1.0";
+export const RELEASE_DATE = "2026-05-17";
 export const DEFAULT_MAX_OUTPUT_TOKENS = 20_000;
 const COST_RATE_ENV_PREFIX = {
     codex: "CROSS_REVIEW_OPENAI",

package/dist/src/core/orchestrator.js

@@ -1005,7 +1005,7 @@ export class CrossReviewOrchestrator {
                 per_peer_verdict: perPeerVerdict,
             });
             if (unanimousVerifiedSatisfied && mode === "active") {
-                const result = this.store.markEvidenceItemAddressedByJudge(params.session_id, item.id, {
+                const result = await this.store.markEvidenceItemAddressedByJudge(params.session_id, item.id, {
                     round: judgmentRound,
                     rationale: Object.values(rationales).join(" || "),
                     judge_peer: params.judge_peers[0],
@@ -1231,7 +1231,7 @@ export class CrossReviewOrchestrator {
                         });
                     }
                     else {
-                        const result = this.store.markEvidenceItemAddressedByJudge(params.session_id, item.id, {
+                        const result = await this.store.markEvidenceItemAddressedByJudge(params.session_id, item.id, {
                             round: judgmentRound,
                             rationale: judgment.rationale,
                             judge_peer: params.judge_peer,
@@ -1375,7 +1375,7 @@ export class CrossReviewOrchestrator {
     async initSession(task, caller = "operator", reviewFocus) {
         const snapshot = await this.probeAll();
         const normalizedReviewFocus = normalizeReviewFocus(reviewFocus, this.config);
-        const meta = this.store.init(task, caller, snapshot, normalizedReviewFocus);
+        const meta = await this.store.init(task, caller, snapshot, normalizedReviewFocus);
         this.emit({
             type: "session.created",
             session_id: meta.session_id,
@@ -1393,7 +1393,7 @@ export class CrossReviewOrchestrator {
             .filter((model) => model && model !== adapter.model)
             .map((model) => createAdapters(this.config, { [adapter.id]: model })[adapter.id]);
     }
-    recordFallback(sessionId, adapter, fallback, reason) {
+    async recordFallback(sessionId, adapter, fallback, reason) {
         const event = {
             peer: adapter.id,
             provider: adapter.provider,
@@ -1402,7 +1402,7 @@ export class CrossReviewOrchestrator {
             reason,
             ts: now(),
         };
-        this.store.appendFallbackEvent(sessionId, event);
+        await this.store.appendFallbackEvent(sessionId, event);
         this.emit({
             type: "peer.fallback.started",
             session_id: sessionId,
@@ -1416,7 +1416,7 @@ export class CrossReviewOrchestrator {
     // peer call surfaced cache telemetry, and append a row to the
     // session cache manifest. Best-effort; never throws — manifest
     // failures should not break the review loop.
-    recordCacheTelemetry(sessionId, round, peerResult) {
+    async recordCacheTelemetry(sessionId, round, peerResult) {
         try {
             if (!this.config.cache.enabled)
                 return;
@@ -1449,7 +1449,7 @@ export class CrossReviewOrchestrator {
                     savings_unknown: savings.unknown,
                 },
             });
-            appendCacheManifestEntry(this.config.data_dir, sessionId, {
+            await appendCacheManifestEntry(this.config.data_dir, sessionId, {
                 ts: new Date().toISOString(),
                 round,
                 peer: peerResult.peer,
@@ -1478,7 +1478,7 @@ export class CrossReviewOrchestrator {
     // session has no ceiling, when cumulative cost is below threshold, or
     // when the warning has already fired. Best-effort writeback — manifest
     // failures should not break the review loop.
-    checkBudgetWarning(sessionId, round) {
+    async checkBudgetWarning(sessionId, round) {
         try {
             const meta = this.store.read(sessionId);
             const ceiling = meta.cost_ceiling_usd;
@@ -1493,7 +1493,7 @@ export class CrossReviewOrchestrator {
             // Persist the one-shot guard FIRST so an emit-throw cannot cause
             // re-emission on a retry; we accept "warning persisted but emit
             // observably failed" as the safer drift mode.
-            this.store.markBudgetWarningEmitted(sessionId);
+            await this.store.markBudgetWarningEmitted(sessionId);
             this.emit({
                 type: "session.budget_warning",
                 session_id: sessionId,
@@ -1529,7 +1529,7 @@ export class CrossReviewOrchestrator {
                     let lastFallbackFailure;
                     for (const fallback of this.fallbackAdapters(adapter)) {
                         fallbackWasTried = true;
-                        const fallbackEvent = this.recordFallback(context.session_id, adapter, fallback, failure.failure_class);
+                        const fallbackEvent = await this.recordFallback(context.session_id, adapter, fallback, failure.failure_class);
                         // v2.5.0 fix (Codex audit P3, 2026-05-03): every paid retry path
                         // must emit a cost_alert so FinOps consumers can preregister
                         // unexpected spend. Pre-v2.5.0 only `peer.format_recovery`
@@ -1802,7 +1802,7 @@ export class CrossReviewOrchestrator {
         const session = existingSession
             ? existingSession
             : missingFinancialVars.length
-                ? this.store.init(input.task, effectivePetitioner, [], normalizeReviewFocus(input.review_focus, this.config))
+                ? await this.store.init(input.task, effectivePetitioner, [], normalizeReviewFocus(input.review_focus, this.config))
                 : await this.initSession(input.task, effectivePetitioner, input.review_focus);
         const petitioner = effectivePetitioner;
         const roundNumber = session.rounds.length + 1;
@@ -1845,7 +1845,7 @@ export class CrossReviewOrchestrator {
         const prompt = buildReviewPrompt(session, input.draft, this.config, input.review_focus, attachments);
         const moderationSafePrompt = buildModerationSafeReviewPrompt(session, input.draft, this.config, input.review_focus);
         const promptFile = this.store.savePrompt(session.session_id, roundNumber, prompt);
-        this.store.markInFlight(session.session_id, {
+        await this.store.markInFlight(session.session_id, {
             round: roundNumber,
             peers: selectedPeers,
             started_at: startedAt,
@@ -1862,10 +1862,10 @@ export class CrossReviewOrchestrator {
             const message = financialControlsMissingMessage(missingFinancialVars);
             const rejected = selectAdapters(adapters, selectedPeers).map((adapter) => budgetPreflightFailure(adapter.id, adapter.provider, adapter.model, message));
             for (const failure of rejected) {
-                this.store.savePeerFailure(session.session_id, roundNumber, failure);
+                await this.store.savePeerFailure(session.session_id, roundNumber, failure);
             }
             const convergence = checkConvergence(selectedPeers, callerStatus, [], rejected);
-            const round = this.store.appendRound(session.session_id, {
+            const round = await this.store.appendRound(session.session_id, {
                 caller_status: callerStatus,
                 draft_file: draftFile,
                 prompt_file: promptFile,
@@ -1875,7 +1875,7 @@ export class CrossReviewOrchestrator {
                 convergence_scope: convergenceScope,
                 started_at: startedAt,
             });
-            const updated = this.store.finalize(session.session_id, "max-rounds", "financial_controls_missing");
+            const updated = await this.store.finalize(session.session_id, "max-rounds", "financial_controls_missing");
             this.emit({
                 type: "round.blocked.financial_controls_missing",
                 session_id: session.session_id,
@@ -1904,10 +1904,10 @@ export class CrossReviewOrchestrator {
         if (message) {
             const rejected = selectAdapters(adapters, selectedPeers).map((adapter) => budgetPreflightFailure(adapter.id, adapter.provider, adapter.model, message));
             for (const failure of rejected) {
-                this.store.savePeerFailure(session.session_id, roundNumber, failure);
+                await this.store.savePeerFailure(session.session_id, roundNumber, failure);
             }
             const convergence = checkConvergence(selectedPeers, callerStatus, [], rejected);
-            const round = this.store.appendRound(session.session_id, {
+            const round = await this.store.appendRound(session.session_id, {
                 caller_status: callerStatus,
                 draft_file: draftFile,
                 prompt_file: promptFile,
@@ -1917,7 +1917,7 @@ export class CrossReviewOrchestrator {
                 convergence_scope: convergenceScope,
                 started_at: startedAt,
             });
-            const updated = this.store.finalize(session.session_id, "max-rounds", "budget_preflight");
+            const updated = await this.store.finalize(session.session_id, "max-rounds", "budget_preflight");
             this.emit({
                 type: "round.blocked.budget_preflight",
                 session_id: session.session_id,
@@ -1935,7 +1935,7 @@ export class CrossReviewOrchestrator {
         }
         if (this.isCancelled(session.session_id, input.signal)) {
             const rejected = selectAdapters(adapters, selectedPeers).map((adapter) => cancellationFailure(adapter.id, adapter.provider, adapter.model, "Session cancellation was requested before this round started."));
-            const round = this.store.appendRound(session.session_id, {
+            const round = await this.store.appendRound(session.session_id, {
                 caller_status: callerStatus,
                 draft_file: draftFile,
                 prompt_file: promptFile,
@@ -1945,7 +1945,7 @@ export class CrossReviewOrchestrator {
                 convergence_scope: convergenceScope,
                 started_at: startedAt,
             });
-            const updated = this.store.markCancelled(session.session_id, "session_cancelled");
+            const updated = await this.store.markCancelled(session.session_id, "session_cancelled");
             return { session: updated, round, converged: false };
         }
         const settled = await Promise.all(selectAdapters(adapters, selectedPeers).map((adapter) => this.callPeerForReview(adapter, prompt, moderationSafePrompt, {
@@ -2027,14 +2027,14 @@ export class CrossReviewOrchestrator {
                             latency_ms: peerResult.latency_ms,
                         };
                         rejected.push(failure);
-                        this.store.savePeerFailure(session.session_id, roundNumber, failure);
+                        await this.store.savePeerFailure(session.session_id, roundNumber, failure);
                         peers.push(peerResult);
-                        this.store.savePeerResult(session.session_id, roundNumber, peerResult);
+                        await this.store.savePeerResult(session.session_id, roundNumber, peerResult);
                         continue;
                     }
                     recoveriesUsedThisCall += 1;
                     const decisionRetry = !containsReviewDecisionLexeme(peerResult.text);
-                    this.store.savePeerResult(session.session_id, roundNumber, peerResult, "unparsed-response");
+                    await this.store.savePeerResult(session.session_id, roundNumber, peerResult, "unparsed-response");
                     this.emit({
                         type: "peer.format_recovery.started",
                         session_id: session.session_id,
@@ -2093,7 +2093,7 @@ export class CrossReviewOrchestrator {
                                 latency_ms: peerResult.latency_ms,
                             };
                             rejected.push(failure);
-                            this.store.savePeerFailure(session.session_id, roundNumber, failure);
+                            await this.store.savePeerFailure(session.session_id, roundNumber, failure);
                             this.emit({
                                 type: "peer.format_recovery.budget_blocked",
                                 session_id: session.session_id,
@@ -2107,7 +2107,7 @@ export class CrossReviewOrchestrator {
                                 },
                             });
                             peers.push(peerResult);
-                            this.store.savePeerResult(session.session_id, roundNumber, peerResult);
+                            await this.store.savePeerResult(session.session_id, roundNumber, peerResult);
                             continue;
                         }
                         const recovered = await adapter.call(recoveryPrompt, {
@@ -2140,25 +2140,25 @@ export class CrossReviewOrchestrator {
                         if (peerResult.status == null) {
                             const failure = unparseableAfterRecoveryFailure(peerResult);
                             rejected.push(failure);
-                            this.store.savePeerFailure(session.session_id, roundNumber, failure);
+                            await this.store.savePeerFailure(session.session_id, roundNumber, failure);
                         }
                     }
                     catch (error) {
                         const failure = classifyProviderError(adapter.id, adapter.provider, adapter.model, error, this.config.retry.max_attempts, Date.parse(startedAt));
                         rejected.push(failure);
-                        this.store.savePeerFailure(session.session_id, roundNumber, failure);
+                        await this.store.savePeerFailure(session.session_id, roundNumber, failure);
                     }
                 }
                 peers.push(peerResult);
-                this.store.savePeerResult(session.session_id, roundNumber, peerResult);
+                await this.store.savePeerResult(session.session_id, roundNumber, peerResult);
                 // v2.21.0 (caching): emit telemetry + persist manifest entry
                 // when the peer call surfaced any cache activity. Best-effort —
                 // failures here must not break the orchestrator critical path.
-                this.recordCacheTelemetry(session.session_id, roundNumber, peerResult);
+                await this.recordCacheTelemetry(session.session_id, roundNumber, peerResult);
                 if (peerResult.model_match === false) {
                     const failure = silentModelDowngradeFailure(peerResult);
                     rejected.push(failure);
-                    this.store.savePeerFailure(session.session_id, roundNumber, failure);
+                    await this.store.savePeerFailure(session.session_id, roundNumber, failure);
                 }
             }
             else if (item.failure) {
@@ -2170,7 +2170,7 @@ export class CrossReviewOrchestrator {
                 // badly, or a policy/budget/content stop, stays in `rejected`.
                 if (isSkippableFailure(failure)) {
                     skipped.push(failure);
-                    this.store.savePeerFailure(session.session_id, roundNumber, failure);
+                    await this.store.savePeerFailure(session.session_id, roundNumber, failure);
                     this.emit({
                         type: "session.peer_skipped_unavailable",
                         session_id: session.session_id,
@@ -2187,7 +2187,7 @@ export class CrossReviewOrchestrator {
                 }
                 else {
                     rejected.push(failure);
-                    this.store.savePeerFailure(session.session_id, roundNumber, failure);
+                    await this.store.savePeerFailure(session.session_id, roundNumber, failure);
                 }
             }
         }
@@ -2208,7 +2208,7 @@ export class CrossReviewOrchestrator {
             recovery_converged: isRecoveryRound && quorumConvergence.converged,
             quorum_peers: quorumPeers,
         };
-        const round = this.store.appendRound(session.session_id, {
+        const round = await this.store.appendRound(session.session_id, {
             caller_status: callerStatus,
             draft_file: draftFile,
             prompt_file: promptFile,
@@ -2227,7 +2227,7 @@ export class CrossReviewOrchestrator {
         // v2.22.0 (B.P3): emit `session.budget_warning` if cumulative cost
         // crossed 75% of the session ceiling on this round. One-shot;
         // subsequent rounds in the same session won't re-emit.
-        this.checkBudgetWarning(session.session_id, round.round);
+        await this.checkBudgetWarning(session.session_id, round.round);
         // v2.7.0 Evidence Broker: aggregate NEEDS_EVIDENCE asks from this
         // round into the session-level checklist. Each peer that returned
         // NEEDS_EVIDENCE with `caller_requests` contributes its asks; the
@@ -2244,7 +2244,7 @@ export class CrossReviewOrchestrator {
             }
         }
         if (evidenceAsks.length > 0) {
-            const checklist = this.store.appendEvidenceChecklistItems(session.session_id, round.round, evidenceAsks);
+            const checklist = await this.store.appendEvidenceChecklistItems(session.session_id, round.round, evidenceAsks);
             this.emit({
                 type: "session.evidence_checklist_updated",
                 session_id: session.session_id,
@@ -2266,7 +2266,7 @@ export class CrossReviewOrchestrator {
         // to addressed. Skipping the call when evidenceAsks is empty would
         // miss exactly the case the inference is designed for.
         if ((this.store.read(session.session_id).evidence_checklist ?? []).length > 0) {
-            const addressDetection = this.store.runEvidenceChecklistAddressDetection(session.session_id, round.round);
+            const addressDetection = await this.store.runEvidenceChecklistAddressDetection(session.session_id, round.round);
             if (addressDetection.not_resurfaced.length > 0) {
                 // v3.5.0 (CRV2-2): event renamed + message corrected. The prior
                 // `session.evidence_checklist_addressed` falsely implied the
@@ -2442,7 +2442,7 @@ export class CrossReviewOrchestrator {
         let updated = this.store.read(session.session_id);
         if (convergence.converged) {
             this.store.saveFinal(session.session_id, input.draft);
-            updated = this.store.finalize(session.session_id, "converged", convergence.recovery_converged ? "recovered_unanimity" : "unanimous_ready");
+            updated = await this.store.finalize(session.session_id, "converged", convergence.recovery_converged ? "recovered_unanimity" : "unanimous_ready");
         }
         this.store.saveReport(session.session_id, sessionReportMarkdown(this.store.read(session.session_id), this.store.readEvents(session.session_id)));
         this.emit({
@@ -2482,7 +2482,7 @@ export class CrossReviewOrchestrator {
         // no-self-immediate-output invariant: between any peer's turn and
         // their next turn, at least one different peer must hold custody.
         if (sessionPeers.length < 2) {
-            this.store.finalize(session.session_id, "aborted", "circular_rotation_too_small");
+            await this.store.finalize(session.session_id, "aborted", "circular_rotation_too_small");
             this.emit({
                 type: "session.circular_rotation_too_small",
                 session_id: session.session_id,
@@ -2512,7 +2512,7 @@ export class CrossReviewOrchestrator {
         let consecutiveNoChangeCount = 0;
         let lastRevisionRound = null;
         let cursor = 0;
-        this.store.setCircularState(session.session_id, {
+        await this.store.setCircularState(session.session_id, {
             rotation_order: rotationOrder,
             consecutive_no_change_count: 0,
             last_revision_round: null,
@@ -2534,7 +2534,7 @@ export class CrossReviewOrchestrator {
         // no-self-immediate-output across the initial-draft → round 1 hop.
         if (!draft) {
             if (this.isCancelled(session.session_id, input.signal)) {
-                this.store.markCancelled(session.session_id, "session_cancelled");
+                await this.store.markCancelled(session.session_id, "session_cancelled");
                 return {
                     session: this.store.read(session.session_id),
                     final_text: draft,
@@ -2554,7 +2554,7 @@ export class CrossReviewOrchestrator {
                 reasoning_effort_override: input.reasoning_effort_overrides?.[initRotator],
                 caller: callerForLottery,
             });
-            this.store.saveGeneration(session.session_id, 0, initGeneration, "initial-draft");
+            await this.store.saveGeneration(session.session_id, 0, initGeneration, "initial-draft");
             if (detectLeadDrift(initGeneration.text) || initGeneration.text.trim() === "") {
                 this.emit({
                     type: "session.lead_drift_detected",
@@ -2569,7 +2569,7 @@ export class CrossReviewOrchestrator {
                         first_chars: initGeneration.text.slice(0, 100),
                     },
                 });
-                this.store.finalize(session.session_id, "aborted", "lead_meta_review_drift");
+                await this.store.finalize(session.session_id, "aborted", "lead_meta_review_drift");
                 return {
                     session: this.store.read(session.session_id),
                     final_text: undefined,
@@ -2591,7 +2591,7 @@ export class CrossReviewOrchestrator {
             : circularMaxRotations * rotationOrder.length;
         for (let round = 1; round <= maxCircularRounds; round++) {
             if (this.isCancelled(session.session_id, input.signal)) {
-                this.store.markCancelled(session.session_id, "session_cancelled");
+                await this.store.markCancelled(session.session_id, "session_cancelled");
                 return {
                     session: this.store.read(session.session_id),
                     final_text: draft,
@@ -2600,7 +2600,7 @@ export class CrossReviewOrchestrator {
                 };
             }
             if (budgetExceeded(session, costLimit)) {
-                this.store.finalize(session.session_id, "max-rounds", "budget_exceeded");
+                await this.store.finalize(session.session_id, "max-rounds", "budget_exceeded");
                 this.emit({
                     type: "session.budget_exceeded",
                     session_id: session.session_id,
@@ -2630,7 +2630,7 @@ export class CrossReviewOrchestrator {
                 reasoning_effort_override: input.reasoning_effort_overrides?.[rotator],
                 caller: callerForLottery,
             });
-            this.store.saveGeneration(session.session_id, round, generation, "rotation");
+            await this.store.saveGeneration(session.session_id, round, generation, "rotation");
             // Drift / empty / fabrication detection — identical contract to
             // ship mode's relator-revision branch. Two consecutive trips abort.
             const emptyText = generation.text.trim() === "";
@@ -2692,7 +2692,7 @@ export class CrossReviewOrchestrator {
                         : fabricationDetected
                             ? "lead_fabrication_repeated"
                             : "lead_meta_review_drift";
-                    this.store.finalize(session.session_id, "aborted", finalizeReason);
+                    await this.store.finalize(session.session_id, "aborted", finalizeReason);
                     return {
                         session: this.store.read(session.session_id),
                         final_text: draft,
@@ -2777,7 +2777,7 @@ export class CrossReviewOrchestrator {
                 reviewer_peers: rotationOrder,
                 lead_peer: rotator,
             };
-            this.store.appendRound(session.session_id, {
+            await this.store.appendRound(session.session_id, {
                 caller_status: "READY",
                 prompt_file: promptFile,
                 peers: [peerResult],
@@ -2786,7 +2786,7 @@ export class CrossReviewOrchestrator {
                 convergence_scope: convergenceScope,
                 started_at: startedAt,
             });
-            this.store.setCircularState(session.session_id, {
+            await this.store.setCircularState(session.session_id, {
                 rotation_order: rotationOrder,
                 consecutive_no_change_count: consecutiveNoChangeCount,
                 last_revision_round: lastRevisionRound,
@@ -2820,7 +2820,7 @@ export class CrossReviewOrchestrator {
                         last_revision_round: lastRevisionRound,
                     },
                 });
-                this.store.finalize(session.session_id, "converged", "circular_full_rotation_no_change");
+                await this.store.finalize(session.session_id, "converged", "circular_full_rotation_no_change");
                 return {
                     session: this.store.read(session.session_id),
                     final_text: draft,
@@ -2831,7 +2831,7 @@ export class CrossReviewOrchestrator {
             cursor = (cursor + 1) % rotationOrder.length;
         }
         // Exhausted max rotations without convergence.
-        this.store.finalize(session.session_id, "max-rounds", "circular_max_rotations_exceeded");
+        await this.store.finalize(session.session_id, "max-rounds", "circular_max_rotations_exceeded");
         this.emit({
             type: "session.circular_max_rotations_exceeded",
             session_id: session.session_id,
@@ -2998,8 +2998,8 @@ export class CrossReviewOrchestrator {
         });
         if (missingFinancialVars.length) {
             const blockedSession = existingSession ??
-                this.store.init(input.task, callerForLottery, [], normalizeReviewFocus(input.review_focus, this.config));
-            this.store.finalize(blockedSession.session_id, "max-rounds", "financial_controls_missing");
+                (await this.store.init(input.task, callerForLottery, [], normalizeReviewFocus(input.review_focus, this.config)));
+            await this.store.finalize(blockedSession.session_id, "max-rounds", "financial_controls_missing");
             this.emit({
                 type: "session.blocked.financial_controls_missing",
                 session_id: blockedSession.session_id,
@@ -3019,7 +3019,7 @@ export class CrossReviewOrchestrator {
         let draft = input.initial_draft;
         // v3.5.0 (CRV2-1 + CRV2-6): persist requested-vs-effective budget +
         // max_rounds traceability once, before any round runs.
-        this.store.setSessionTraceability(session.session_id, {
+        await this.store.setSessionTraceability(session.session_id, {
             requested_max_rounds: input.max_rounds ?? null,
             effective_max_rounds: input.until_stopped ? null : effectiveMaxRounds,
             requested_max_cost_usd: input.max_cost_usd ?? null,
@@ -3041,7 +3041,7 @@ export class CrossReviewOrchestrator {
                 attachmentsPresent,
             });
             if (!preflight.pass) {
-                this.store.finalize(session.session_id, "aborted", "needs_evidence_preflight");
+                await this.store.finalize(session.session_id, "aborted", "needs_evidence_preflight");
                 this.emit({
                     type: "session.evidence_preflight_failed",
                     session_id: session.session_id,
@@ -3065,7 +3065,7 @@ export class CrossReviewOrchestrator {
         if (this.config.budget.require_rates_for_budget && costLimit != null) {
             const missingRates = selectedPeers.filter((peer) => !this.config.cost_rates[peer]);
             if (missingRates.length) {
-                this.store.finalize(session.session_id, "max-rounds", "budget_requires_rates");
+                await this.store.finalize(session.session_id, "max-rounds", "budget_requires_rates");
                 this.emit({
                     type: "session.blocked.budget_requires_rates",
                     session_id: session.session_id,
@@ -3102,7 +3102,7 @@ export class CrossReviewOrchestrator {
         let consecutiveLeadDrifts = 0;
         if (!draft) {
             if (this.isCancelled(session.session_id, input.signal)) {
-                this.store.markCancelled(session.session_id, "session_cancelled");
+                await this.store.markCancelled(session.session_id, "session_cancelled");
                 return {
                     session: this.store.read(session.session_id),
                     converged: false,
@@ -3120,7 +3120,7 @@ export class CrossReviewOrchestrator {
                 reasoning_effort_override: input.reasoning_effort_overrides?.[leadPeer],
                 caller: callerForLottery,
             });
-            this.store.saveGeneration(session.session_id, 0, generation, "initial-draft");
+            await this.store.saveGeneration(session.session_id, 0, generation, "initial-draft");
             // v2.13.0: drift detection on initial-draft path. There is no
             // prior draft to fall back to here, so a drifted initial generation
             // aborts immediately. Only fires in `ship` mode — in `review` mode
@@ -3138,7 +3138,7 @@ export class CrossReviewOrchestrator {
                         first_chars: generation.text.slice(0, 100),
                     },
                 });
-                this.store.finalize(session.session_id, "aborted", "lead_meta_review_drift");
+                await this.store.finalize(session.session_id, "aborted", "lead_meta_review_drift");
                 return {
                     session: this.store.read(session.session_id),
                     final_text: undefined,
@@ -3150,7 +3150,7 @@ export class CrossReviewOrchestrator {
         }
         for (let round = 1; round <= effectiveMaxRounds; round++) {
             if (this.isCancelled(session.session_id, input.signal)) {
-                this.store.markCancelled(session.session_id, "session_cancelled");
+                await this.store.markCancelled(session.session_id, "session_cancelled");
                 return {
                     session: this.store.read(session.session_id),
                     final_text: draft,
@@ -3181,7 +3181,7 @@ export class CrossReviewOrchestrator {
                 };
             }
             if (budgetExceeded(session, costLimit)) {
-                this.store.finalize(session.session_id, "max-rounds", "budget_exceeded");
+                await this.store.finalize(session.session_id, "max-rounds", "budget_exceeded");
                 return {
                     session: this.store.read(session.session_id),
                     final_text: draft,
@@ -3247,7 +3247,7 @@ export class CrossReviewOrchestrator {
                     reasoning_effort_override: input.reasoning_effort_overrides?.[leadPeer],
                     caller: callerForLottery,
                 });
-                this.store.saveGeneration(session.session_id, round, generation, "revision");
+                await this.store.saveGeneration(session.session_id, round, generation, "revision");
                 // v2.23.0: empty-text degeneracy detection. Provider-side parser
                 // diagnostics (e.g. Anthropic extended-thinking returning only
                 // `thinking`/`redacted_thinking` blocks with no final `text` block,
@@ -3402,7 +3402,7 @@ export class CrossReviewOrchestrator {
                             finalizeReason = "lead_meta_audit_repeated";
                         else
                             finalizeReason = "lead_meta_review_drift";
-                        this.store.finalize(session.session_id, "aborted", finalizeReason);
+                        await this.store.finalize(session.session_id, "aborted", finalizeReason);
                         return {
                             session: this.store.read(session.session_id),
                             final_text: draft,
@@ -3418,7 +3418,7 @@ export class CrossReviewOrchestrator {
                 }
             }
         }
-        this.store.finalize(session.session_id, "max-rounds", "max_rounds_without_unanimity");
+        await this.store.finalize(session.session_id, "max-rounds", "max_rounds_without_unanimity");
         return {
             session: this.store.read(session.session_id),
             final_text: draft,