Add SDK and CLI server protocol compatibility checks

[longquanzheng]

Summary

• add FlowService.GetServerInfo with diagnostic Server version and an inclusive supported protocol interval
• negotiate the highest common protocol before Attribute index synchronization and WorkerService binding in all five SDKs
• add dexcli version check with structured compatibility output and failure reporting
• inject and verify Server, CLI, and SDK artifact versions in release builds
• document upgrade sequencing and protocol compatibility in English and Simplified Chinese

Rationale and user impact

Artifact versions do not reliably describe wire compatibility. Server and client protocol intervals let newer SDKs retain support for older Servers while allowing breaking Server releases to reject SDKs that no longer overlap. Servers without GetServerInfo are rejected, so the mechanism is introduced with a Server-first upgrade.

Workers now fail startup before index synchronization or listener binding when the information RPC fails, an interval is invalid, or the intervals do not overlap. Existing running Workers do not renegotiate. Operators can check CLI compatibility explicitly with dexcli version check.

Validation

• UV_CACHE_DIR=/tmp/dex-uv-cache make generated-code-check
• make copyright-check
• make docs-prose-check
• make -C server unitTests
• Temporal and Cadence TestServerInfo integration tests
• CLI test and integration suites
• Go, Java, Python, TypeScript, and Rust SDK compatibility tests
• Java publication smoke test and public documentation check
• Python pre-commit and public documentation checks
• TypeScript typecheck, tests, and documentation check
• Rust fmt, clippy, tests, and documentation check
• actionlint for every changed release workflow

The full local Server integration command also exercised the new tests successfully, but the aggregate run reached its 20-minute timeout after two unrelated Cadence text-search assertions returned no results. Those assertions reproduced in isolation and are outside this change's search paths.

Related

The matching dex-developer skill update is published as a separate stacked PR because it lives in another repository.

[codecov]

Codecov Report

❌ Patch coverage is 61.00279% with 140 lines in your changes missing coverage. Please review.

Files with missing lines	Patch %	Lines
sdk-typescript/src/server-protocol.ts	49.15%	30 Missing ⚠️
sdk-go/dex/server_protocol.go	64.55%	24 Missing and 4 partials ⚠️
sdk-rust/crates/dex-sdk/src/server_protocol.rs	40.00%	21 Missing ⚠️
sdk-python/dex/_server_protocol.py	59.25%	8 Missing and 3 partials ⚠️
.../superdurable/dex/ServerProtocolCompatibility.java	47.36%	5 Missing and 5 partials ⚠️
sdk-python/dex/async_worker.py	44.44%	10 Missing ⚠️
sdk-python/dex/worker.py	44.44%	10 Missing ⚠️
sdk-rust/crates/dex-sdk/src/worker.rs	60.86%	9 Missing ⚠️
sdk-typescript/src/worker.ts	74.07%	7 Missing ⚠️
...java/src/main/java/io/superdurable/dex/Worker.java	76.47%	4 Missing ⚠️

📢 Thoughts on this report? Let us know!