Issue #3611086: Rename InteractionContext::returnUrl() to nextStepUrl()

Frank Mablyrequested to merge
issue/orchestra-3611086:3611086-rename-interactioncontextreturnurl-to into 1.x

Mechanical rename, no behavior change.

InteractionContext::returnUrl() and branchReturnUrl() build the dispatcher continuation URL (a capability link to the orchestra_interaction.step route that advances the run to whatever it parks on next), not an operator "return to where I came from". The return naming overloaded the operator return-to-trace target added in #3610524 (orchestra_return).

  • returnUrl() -> nextStepUrl()
  • branchReturnUrl() -> branchNextStepUrl()

Callers updated: PaymentInteraction (3), ReviewInteractionBase, CommentInteraction, RedirectInteraction (branch variant), the SignalOutcomeInteraction test double, and the OperationGateway comment. Method docblocks reworded to next-step semantics; the external-interaction-internals doc reference updated.

After this, "return" means only the operator return, "next step" means workflow chaining. Interaction + payment kernel suites pass (96 tests, 1003 assertions).

Merge request reports