Semantic member selection versions

Semantic providers can declare selection_identity_version when changing their member identity encoding. Cube's stable-member-ID adapter requires cube-member-id-v1. Deploy the compatible core library, host, frontend and Cube adapter together; do not roll back to title-keyed code after saving ID-based charts.

Saved Cube selections without this version are rejected, even when a saved title happens to equal a member ID. No historical title mapping is recovered. Open each chart in Explore, choose Start field selection, reselect its metrics, dimensions, filters and sorting, then save. Reset also clears field-dependent formatting; it does not overwrite the saved chart until Save is chosen. Native filters and chart customizations have a separate reset in their configuration form that clears fields, pre-filters, sorting, defaults and dependencies.

Dashboard filters retain their own saved generation. Old filter state and unversioned external member overrides cannot borrow a chart's version. Recreate old dashboard permalink/filter state after reselection. Cross-view overlays are rejected unless their source identity matches the receiving semantic view; matching display titles are not proof of matching members.

The marker is a compatibility contract, not an authorization credential. API clients must rebuild their selections from current member IDs before supplying extras.semantic_selection_version on each query. Providers without a required version retain their existing behavior. No metadata-database migration or automatic rewrite of saved charts is performed.

Programmatic clients must explicitly select current member IDs. Chart-data API queries send extras.semantic_selection_version; name-based datasource queries and MCP get_table requests send top-level semantic_selection_version. Discover the value from datasource metadata (or each external metric returned by MCP list_metrics). The server never adds a missing marker from metadata. Explore query controls remain unavailable until explicit field initialization, so legacy filter subjects cannot trigger value suggestions before reselection.

For versioned semantic views, Matrixify All mode with A to Z or Z to A sorting cannot populate or refresh dimension values from suggestions. Existing saved values are preserved. For a new selection, switch to Members and enter values manually; the control displays this guidance when suggestions are unavailable.