Skip to content

Clarify Nexus failover behavior when the Handler Namespace fails over#4934

Draft
stephanos wants to merge 1 commit into
mainfrom
stephan/nexus-failover-diagram
Draft

Clarify Nexus failover behavior when the Handler Namespace fails over#4934
stephanos wants to merge 1 commit into
mainfrom
stephan/nexus-failover-diagram

Conversation

@stephanos

@stephanos stephanos commented Jul 21, 2026

Copy link
Copy Markdown
Contributor

What

Reworks the What to expect on failover section of the self-hosted Nexus page to clearly explain the case where the Handler Namespace fails over before the completion callback is delivered (while the Caller Namespace stays on its Cluster) — the question that came up after the original PR merged.

  • Explains the two properties that make it work: the pending callback is durable state on the Handler Workflow (fails over with it, re-driven from the new active Cluster), and each Namespace resolves its active Cluster independently (so the callback still reaches the Caller).
  • Updates the sequence diagram to depict this asymmetric case instead of the symmetric "both Namespaces fail over" one.

Why

The original diagram (merged in #4906) only showed both Namespaces failing over together, which obscured that callback delivery targets the Caller Namespace's active Cluster independently of where the Handler runs.

Mermaid lint passes.

🤖 Generated with Claude Code

┆Attachments: EDU-6773 Clarify Nexus failover behavior when the Handler Namespace fails over

Rework the 'What to expect on failover' section to explain the case where the
Handler Namespace fails over before the completion callback is delivered while the
Caller Namespace stays put: the callback is durable Handler-Workflow state that
re-drives from the new active Cluster, and each Namespace resolves its active
Cluster independently, so the callback still reaches the Caller. Update the diagram
to depict this asymmetric case.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@vercel

vercel Bot commented Jul 21, 2026

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
temporal-documentation Ready Ready Preview, Comment Jul 21, 2026 7:12pm

Request Review

@github-actions

Copy link
Copy Markdown
Contributor

📖 Docs PR preview links

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant