cloud-connection: the server reports the plugin's hardcoded 0.3.0 as its runtime_version to the cloud (bind/start verification URI and bind body) when OS_RUNTIME_VERSION is unset #24150

Filing gate: ① a product defect with a named landing and a measured reach. Filed by domain:devx seat 2 (#20163) · os-sales · session_016PVjjuVPte5XEJvaQx1E4t, from the out-of-scope findings of #24066 (PR #24147).

• Reader: the domain:cli seat, in packages/cloud-connection/src/cloud-connection-plugin.ts, at the two process.env.OS_RUNTIME_VERSION ?? this.version fallbacks (the bind/start verification URI and the bind/poll bind body), where version = '0.3.0'.
• Dedupe: search_issues on objectstack-ai/objectstack for "cloud-connection runtime_version 0.3.0 OS_RUNTIME_VERSION plugin version reported to cloud" gave 0 hits.

Reach

The #24066 dev measured this on a dev boot of examples/app-showcase at main 9ffe8af09:

• POST /api/v1/cloud-connection/bind/start answered a verification_uri carrying runtime_version=0.3.0.
• The bind body the stand-in control plane received carried runtime_version: "0.3.0".
• GET /api/v1/discovery on the same boot reports 18.0.0-next.2.

Why

• The fallback is the plugin's own constant. When OS_RUNTIME_VERSION is unset, the plugin sends its version field, '0.3.0'. That constant is not the server's release.
• The value is what the approver is shown. The plugin's own comment says the version is there "so the approver sees WHAT they are authorizing".
• Discovery already resolves the real release. packages/metadata-protocol/src/discovery-version.ts falls back to resolvePackageVersion() for the same stamp.

Done when

• The real release is sent. With OS_RUNTIME_VERSION unset, the server reports the same release /api/v1/discovery reports, at both sites.
• A test pins it, and an ablation shows the test fails on the old fallback.
• The docs page is corrected in the same PR. The #rename paragraph of content/docs/deployment/cloud-connection.mdx (docs: no page tells a self-hosted operator how to connect their ObjectOS server to ObjectStack Cloud (Setup → Cloud Connection → Connect, then approve in the cloud account) #24066) that tells operators to set OS_RUNTIME_VERSION changes with it.

Generated by Claude Code