Skip to content

feat(cluster-tool): add cluster readiness flow and CLI - #88

Open
joshglogau wants to merge 7 commits into
masterfrom
feature/cluster-readiness-flowscenario
Open

feat(cluster-tool): add cluster readiness flow and CLI#88
joshglogau wants to merge 7 commits into
masterfrom
feature/cluster-readiness-flowscenario

Conversation

@joshglogau

@joshglogau joshglogau commented Aug 27, 2026

Copy link
Copy Markdown

Summary

Adds reusable cluster-readiness PhaseGroups, a fresh-cluster FlowScenario, and a connected read-only CLI over explicit endpoints. Both entrypoints use the platform's existing PhaseGroup → Phase → Step → Report engine.

This is the clean replacement for #53; that PR remains unchanged as historical context.

Behavior

  • Pins endpoint identity and checks Wire, Ethereum, and Solana liveness.
  • Verifies swap protocol configuration, active reserves, token bindings, assets, underwriter capacity, pending-request health, and client-side route quotes.
  • Uses bounded table reads that fail explicitly rather than accepting partial state.
  • Keeps normal flows fail-fast; readiness alone opts into diagnostic collection so independent read-only checks remain visible while the command still exits nonzero.

The proof boundary is intentionally read-only. It does not claim signer, custody, transaction, settlement, Hub, or artifact-publication readiness.

Run

node scripts/run-flow.mjs flow-cluster-readiness \
  --cluster-path /tmp/wire-flow-cluster-readiness \
  --wire-build-path /path/to/wire-sysio/build \
  --ethereum-path /path/to/wire-ethereum \
  --solana-path /path/to/wire-solana

node scripts/flow-heartbeat-monitor.mjs \
  --cluster-path /tmp/wire-flow-cluster-readiness

The connected command accepts explicit Wire, Ethereum, and Solana RPC identity flags through wire-cluster-tool readiness.

Validation

  • GitHub Build and test and Jest results: green.
  • Focused cleanup verification: 12 suites / 52 tests, lint, TypeScript build, and git diff --check.
  • Earlier connected acceptance: 19/19 Steps and 28/28 route quote preflights passed. The final structural cleanup was not rerun against that live cluster.

Review focus

  • Readiness-only diagnostic collection versus the unchanged fail-fast default.
  • Required Wire chain identity and optional Ethereum/Solana identity pins.
  • The explicit read-only proof boundary and bounded table-scan policy.

@joshglogau
joshglogau marked this pull request as ready for review September 2, 2026 13:50
@joshglogau joshglogau changed the title Refactor cluster readiness into reusable native PhaseGroups, a fresh-cluster FlowScenario, and an explicit-endpoint connected CLI feat(cluster-tool): add cluster readiness flow and CLI Sep 2, 2026
@joshglogau
joshglogau requested a review from jglanz September 2, 2026 15:18
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