more code review and plans

2026-05-22 14:10:15 +07:00
parent 0a6500daf2
commit b4623beb1d
7 changed files with 720 additions and 14 deletions
@@ -158,6 +158,11 @@ def build_barrier_patch(
    writes cannot be blindly merged because reducers must see the value produced
    by earlier item patches. The barrier therefore replays trace-facing incoming
    changes against a single staged state in deterministic item order.
+
+    Unlike ordinary node patches, barrier patch `changes` report the final
+    committed aggregate values. A barrier trace is the single visible state
+    commit for all buffered item patches, so showing raw per-item incoming
+    values would hide what actually landed in `RunState.state`.
    """
    state_fields = workflow.state_schema.field_index()
    staged_state = deepcopy(state)