@replayci/replay 0.1.13 → 0.1.14

package/dist/index.cjs

@@ -3778,7 +3778,7 @@ function createInitialState(sessionId, options) {
     checkpointCount: 0
   };
 }
-function finalizeExecutedStep(state, step, contracts, compiledSession) {
+function finalizeExecutedStep(state, step, contracts, compiledSession, options) {
   const newSteps = [...state.steps, step];
   const newToolCallCounts = updateToolCallCounts(state.toolCallCounts, step);
   const resolvedContracts = compiledSession ? Array.from(compiledSession.perToolContracts.values()) : contracts;
@@ -3788,7 +3788,7 @@ function finalizeExecutedStep(state, step, contracts, compiledSession) {
     step
   );
   const costDelta = computeStepCost(step);
-  const newPhase = compiledSession ? recomputePhaseFromCommitted(step.toolCalls, state, compiledSession) : state.currentPhase;
+  const newPhase = options?.deferPhase ? state.currentPhase : compiledSession ? recomputePhaseFromCommitted(step.toolCalls, state, compiledSession) : state.currentPhase;
   return {
     ...state,
     steps: newSteps,
@@ -5659,6 +5659,7 @@ function replay(client, opts = {}) {
   let shadowEvaluationCount = 0;
   let manualFilter = null;
   const deferredReceipts = /* @__PURE__ */ new Map();
+  let deferredPhase = null;
   const contractLimits = resolveSessionLimits(contracts);
   const compiledLimits = compiledSession?.sessionLimits;
   const mergedLimits = { ...contractLimits ?? {}, ...compiledLimits ?? {} };
@@ -5795,6 +5796,7 @@ function replay(client, opts = {}) {
       total_ms: 0,
       enforcement_ms: 0
     };
+    deferredPhase = null;
     const trace = createTrace(sessionState.totalStepCount);
     const traceCtx = { trace };
     let currentTraceStage = "narrow";
@@ -6709,11 +6711,31 @@ function replay(client, opts = {}) {
               }
             }
           }
+          const hasPhaseTransition = phaseResult?.legal && phaseResult.newPhase !== sessionState.currentPhase;
+          const shouldDeferPhase = isActiveGovern && !attemptDegraded && hasPhaseTransition;
           const prevVersionAllow = sessionState.stateVersion;
-          sessionState = finalizeExecutedStep(sessionState, completedStep, contracts, compiledSession);
+          sessionState = finalizeExecutedStep(
+            sessionState,
+            completedStep,
+            contracts,
+            compiledSession,
+            shouldDeferPhase ? { deferPhase: true } : void 0
+          );
           sessionState = recordDecisionOutcome(sessionState, "allowed");
           syncStateToStore(prevVersionAllow, sessionState);
           timing.finalize_ms += Date.now() - enforceFinalizeStart;
+          if (shouldDeferPhase && compiledSession) {
+            const advancingTools = /* @__PURE__ */ new Set();
+            for (const tc of toolCalls) {
+              const contract = compiledSession.perToolContracts.get(tc.name);
+              if (contract?.transitions?.advances_to === phaseResult.newPhase) {
+                advancingTools.add(tc.name);
+              }
+            }
+            if (advancingTools.size > 0 && phaseResult.newPhase != null) {
+              deferredPhase = { newPhase: phaseResult.newPhase, toolNames: advancingTools };
+            }
+          }
           if (isActiveGovern && !attemptDegraded && attemptPendingCalls && attemptPendingCalls.size > 0) {
             for (const [toolCallId, pending] of attemptPendingCalls) {
               deferredReceipts.set(toolCallId, {
@@ -6731,8 +6753,8 @@ function replay(client, opts = {}) {
             checked: { gate_mode: gateMode },
             found: { blocked_count: 0, action: "allow" }
           });
-          const allowNewPhase = phaseResult && phaseResult.legal && phaseResult.newPhase !== sessionState.currentPhase ? phaseResult.newPhase : sessionState.currentPhase;
-          trace.push({ stage: "finalize", tool: null, verdict: "info", reason: "cycle_complete", checked: {}, found: { state_version: sessionState.stateVersion, phase_before: completedStep.phase, phase_after: allowNewPhase, tools_committed: toolCalls.map((tc) => tc.name), tools_blocked: [], killed: false, step_index: sessionState.totalStepCount } });
+          const allowNewPhase = phaseResult && phaseResult.legal && phaseResult.newPhase !== (completedStep.phase ?? sessionState.currentPhase) ? phaseResult.newPhase : sessionState.currentPhase;
+          trace.push({ stage: "finalize", tool: null, verdict: "info", reason: "cycle_complete", checked: {}, found: { state_version: sessionState.stateVersion, phase_before: completedStep.phase, phase_after: allowNewPhase, ...shouldDeferPhase ? { phase_deferred: true } : {}, tools_committed: toolCalls.map((tc) => tc.name), tools_blocked: [], killed: false, step_index: sessionState.totalStepCount } });
           trace.complete = true;
           lastTrace = trace;
           emitDiagnostic2(diagnostics, { type: "replay_trace", session_id: sessionId, trace });
@@ -7079,6 +7101,10 @@ function replay(client, opts = {}) {
           throw new ReplayKillError(sessionId, killedAt);
         }
         const result = await executor(args);
+        if (deferredPhase && deferredPhase.toolNames.has(toolName)) {
+          sessionState = { ...sessionState, currentPhase: deferredPhase.newPhase };
+          deferredPhase = null;
+        }
         if (runtimeClient && leaseFence && !runtimeDegraded) {
           for (const [callId, deferred] of deferredReceipts) {
             if (deferred.toolName === toolName) {

package/dist/index.js

@@ -3767,7 +3767,7 @@ function createInitialState(sessionId, options) {
     checkpointCount: 0
   };
 }
-function finalizeExecutedStep(state, step, contracts, compiledSession) {
+function finalizeExecutedStep(state, step, contracts, compiledSession, options) {
   const newSteps = [...state.steps, step];
   const newToolCallCounts = updateToolCallCounts(state.toolCallCounts, step);
   const resolvedContracts = compiledSession ? Array.from(compiledSession.perToolContracts.values()) : contracts;
@@ -3777,7 +3777,7 @@ function finalizeExecutedStep(state, step, contracts, compiledSession) {
     step
   );
   const costDelta = computeStepCost(step);
-  const newPhase = compiledSession ? recomputePhaseFromCommitted(step.toolCalls, state, compiledSession) : state.currentPhase;
+  const newPhase = options?.deferPhase ? state.currentPhase : compiledSession ? recomputePhaseFromCommitted(step.toolCalls, state, compiledSession) : state.currentPhase;
   return {
     ...state,
     steps: newSteps,
@@ -5650,6 +5650,7 @@ function replay(client, opts = {}) {
   let shadowEvaluationCount = 0;
   let manualFilter = null;
   const deferredReceipts = /* @__PURE__ */ new Map();
+  let deferredPhase = null;
   const contractLimits = resolveSessionLimits(contracts);
   const compiledLimits = compiledSession?.sessionLimits;
   const mergedLimits = { ...contractLimits ?? {}, ...compiledLimits ?? {} };
@@ -5786,6 +5787,7 @@ function replay(client, opts = {}) {
       total_ms: 0,
       enforcement_ms: 0
     };
+    deferredPhase = null;
     const trace = createTrace(sessionState.totalStepCount);
     const traceCtx = { trace };
     let currentTraceStage = "narrow";
@@ -6700,11 +6702,31 @@ function replay(client, opts = {}) {
               }
             }
           }
+          const hasPhaseTransition = phaseResult?.legal && phaseResult.newPhase !== sessionState.currentPhase;
+          const shouldDeferPhase = isActiveGovern && !attemptDegraded && hasPhaseTransition;
           const prevVersionAllow = sessionState.stateVersion;
-          sessionState = finalizeExecutedStep(sessionState, completedStep, contracts, compiledSession);
+          sessionState = finalizeExecutedStep(
+            sessionState,
+            completedStep,
+            contracts,
+            compiledSession,
+            shouldDeferPhase ? { deferPhase: true } : void 0
+          );
           sessionState = recordDecisionOutcome(sessionState, "allowed");
           syncStateToStore(prevVersionAllow, sessionState);
           timing.finalize_ms += Date.now() - enforceFinalizeStart;
+          if (shouldDeferPhase && compiledSession) {
+            const advancingTools = /* @__PURE__ */ new Set();
+            for (const tc of toolCalls) {
+              const contract = compiledSession.perToolContracts.get(tc.name);
+              if (contract?.transitions?.advances_to === phaseResult.newPhase) {
+                advancingTools.add(tc.name);
+              }
+            }
+            if (advancingTools.size > 0 && phaseResult.newPhase != null) {
+              deferredPhase = { newPhase: phaseResult.newPhase, toolNames: advancingTools };
+            }
+          }
           if (isActiveGovern && !attemptDegraded && attemptPendingCalls && attemptPendingCalls.size > 0) {
             for (const [toolCallId, pending] of attemptPendingCalls) {
               deferredReceipts.set(toolCallId, {
@@ -6722,8 +6744,8 @@ function replay(client, opts = {}) {
             checked: { gate_mode: gateMode },
             found: { blocked_count: 0, action: "allow" }
           });
-          const allowNewPhase = phaseResult && phaseResult.legal && phaseResult.newPhase !== sessionState.currentPhase ? phaseResult.newPhase : sessionState.currentPhase;
-          trace.push({ stage: "finalize", tool: null, verdict: "info", reason: "cycle_complete", checked: {}, found: { state_version: sessionState.stateVersion, phase_before: completedStep.phase, phase_after: allowNewPhase, tools_committed: toolCalls.map((tc) => tc.name), tools_blocked: [], killed: false, step_index: sessionState.totalStepCount } });
+          const allowNewPhase = phaseResult && phaseResult.legal && phaseResult.newPhase !== (completedStep.phase ?? sessionState.currentPhase) ? phaseResult.newPhase : sessionState.currentPhase;
+          trace.push({ stage: "finalize", tool: null, verdict: "info", reason: "cycle_complete", checked: {}, found: { state_version: sessionState.stateVersion, phase_before: completedStep.phase, phase_after: allowNewPhase, ...shouldDeferPhase ? { phase_deferred: true } : {}, tools_committed: toolCalls.map((tc) => tc.name), tools_blocked: [], killed: false, step_index: sessionState.totalStepCount } });
           trace.complete = true;
           lastTrace = trace;
           emitDiagnostic2(diagnostics, { type: "replay_trace", session_id: sessionId, trace });
@@ -7070,6 +7092,10 @@ function replay(client, opts = {}) {
           throw new ReplayKillError(sessionId, killedAt);
         }
         const result = await executor(args);
+        if (deferredPhase && deferredPhase.toolNames.has(toolName)) {
+          sessionState = { ...sessionState, currentPhase: deferredPhase.newPhase };
+          deferredPhase = null;
+        }
         if (runtimeClient && leaseFence && !runtimeDegraded) {
           for (const [callId, deferred] of deferredReceipts) {
             if (deferred.toolName === toolName) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@replayci/replay",
-  "version": "0.1.13",
+  "version": "0.1.14",
   "description": "ReplayCI SDK for deterministic tool-call validation and observation.",
   "license": "ISC",
   "author": "ReplayCI",