Skip to content

feat(api): add non-throwing multi-cluster status query - #664

Merged
SunSi12138 merged 13 commits into
devfrom
feat/653-control-plane-status-query
Sep 12, 2026
Merged

SunSi12138 merged 13 commits into
devfrom
feat/653-control-plane-status-query

Conversation

@SunSi12138

Copy link
Copy Markdown
Owner

Summary

  • add SharpLinkClusterStatusSnapshot as the point-in-time status projection for one configured cluster slot
  • add ISharpLinkMultiClusterClient.TryGetClusterStatus(...) so valid-but-absent (including concurrently removed) clusters are an expected query miss instead of exception-driven control flow
  • keep existing GetClusterState / GetClusterRuntimeState / GetClusterReadiness convenience getters unchanged for compatibility
  • document the public control-plane result-vs-exception policy and keep follow-up scopes isolated
  • add unit coverage for configured, absent, and invalid/default cluster keys

Scope

This completes the remaining query/audit part of #653 without duplicating the split child issues. Multi-cluster mutation results from #656 are already on dev; #652, #654, and #655 remain independent work for readiness publication, runtime configuration results, and health results respectively.

No RPC wire contract or request hot path is changed.

Validation

  • GitHub Actions / repository validation gates will be used as the source of truth for this branch.

Closes #653

@SunSi12138 SunSi12138 left a comment

Copy link
Copy Markdown
Owner Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

发现 1 个会让新 status API 与现有独立 readiness 状态域产生确定性矛盾的 blocker;其余范围继续复核中。

Comment thread src/SharpLink.Abstractions/SharpLinkClusterStatusSnapshot.cs Outdated

@SunSi12138 SunSi12138 left a comment

Copy link
Copy Markdown
Owner Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

补充 1 个独立的 public-interface compatibility blocker:default fallback 当前依赖一个从未标准化的 legacy exception shape。

Comment thread src/SharpLink.Abstractions/ISharpLinkMultiClusterClient.cs Outdated
@SunSi12138
SunSi12138 merged commit 5fac7a0 into dev Sep 12, 2026
9 checks passed
@SunSi12138
SunSi12138 deleted the feat/653-control-plane-status-query branch September 12, 2026 04:42
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