test: explain handled entity failure in replay regression

Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>

Copilot-Session: 064f1284-f637-4ba9-8406-8c094ce9f845

Author: andystaples

tests/durabletask/test_orchestrator_payload_failure.py

@@ -55,6 +55,7 @@ def orchestrator(ctx, _):
             try:
                 yield ctx.call_entity(ENTITY_IDS[0], "get")
             except task.TaskFailedError:
+                # Handle the expected failure so replay can verify lock releases.
                 pass
         yield ctx.wait_for_external_event("next")
         return "done"