Integration: TUI version and docs contracts on release stack

[lawrencecchen]

Final integrated candidate

This dependent draft layers the version identity red/green pair from PR 10251 and the frontend protocol documentation red/green pair from PR 10260 onto PR 10261, which already carries the PR 10258 TUI SDK validation stack and SDK release policy fixes from PRs 10245 and 10250.

Base head: 74a9aef90a0196f2cd8bece7f1ae79647d79ecb9.
Candidate head: 9dd3c77aab.

Preserved red/green history

• Version identity: 56a8991d10 (red), 3cd80a1479 (green).
• Frontend docs contract: f2d9663b25 (red), 9dd3c77aab (green).

Original PR branches and PR10261 remain unchanged. No merge or release action is requested.

Local evidence

Frontend docs behavior test, TUI spec/schema/resource checks, generated SDK drift check, Python compilation, and git diff --check pass. Hosted SDK and spec checks are dispatched for this exact head.

---

^{Need help on this PR? Tag @codesmith-bot with what you need. Autofix is disabled.}

---

Summary by cubic

Unifies cmux-tui binary version identity under one canonical distribution stamp and enforces frontend protocol docs against the supported wire API. Previously cmux-tui --version and remote-probe mixed the Cargo crate version with a distribution stamp; now both report the same canonical distribution version, and README claims align to protocol v12.

• Centralizes DISTRIBUTION_VERSION in cmux-tui-core and uses it in --version output and remote-probe JSON (version and distribution_version are identical).
• Updates .github workflows to stamp CMUX_TUI_DISTRIBUTION_VERSION from a single version input and to validate:
  • --version output starts with cmux <version> (npm prerelease is the canonical nightly stamp).
  • remote-probe --json build_identity, version, and distribution_version match the expected head and stamp.
• Adds cmux-tui/scripts/test_frontend_docs.py and runs it in the spec workflow to keep README protocol references in sync with the supported WebSocket protocol and the raw protocol guide; updates READMEs to v12.
• Release notes: pass the canonical version to the reusable build workflow; PyPI nightlies may use .dev... as metadata only—the binaries stay stamped with the npm value.

^{Written for commit 9dd3c77. Summary will update on new commits.}

[coderabbitai]

Important

Review skipped

Draft detected.

Please check the settings in the CodeRabbit UI or the .coderabbit.yaml file in this repository. To trigger a single review, invoke the @coderabbitai review command.

⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: ASSERTIVE

Plan: Pro Plus

Run ID: 30f6506e-e1a3-4d3d-b619-e581e2d9fe79

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

Use the checkbox below for a quick retry:

• 🔍 Trigger review

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands.}

[lawrencecchen]

Version consistency evidence for exact head 9dd3c77aab373fa4728dd07a4e9b62bfc051fc1f:

• Before this pair, all four npm platform packages (cmux-tui-darwin-arm64, cmux-tui-darwin-x64, cmux-tui-linux-arm64, cmux-tui-linux-x64) and six PyPI wheels reported cmux-tui 0.1.0, while registry metadata was 0.10.0. Stable target is 0.11.0.
• Red/green commits: 56a8991d10752ff1497af9aa2eac693556f46aed then 3cd80a14793d75abb37b6756e7671581960ccae7. CMUX_TUI_DISTRIBUTION_VERSION is the binary stamp. Nightly npm-form stamp stays separate from PyPI .dev... metadata.
• Full hosted verification attempt 2 is green: run 32011133831. It covered Linux/macOS tests, Windows and three other artifact builds, package distributions, Linux x64/arm64 entrypoints, macOS PyPI wheels x64/arm64, bindings E2E, valgrind, web, and the final hosted gate.
• Hosted SDK contracts: 32008710371. Hosted spec inventory: 32008712346.

No tag, publish, or merge action was performed.

[lawrencecchen]

Correction to the evidence comment above: the full run covered five binary artifact builds, Windows GNU plus x86_64/aarch64 Apple and x86_64/aarch64 Linux musl. All five passed.