Redis command capability ledger
This report separates four claims that cannot be reduced to one coverage percentage: command-name availability, typed semantics, RESP wire support, and session/topology behavior. A typed name does not prove every option, reply shape, protocol form, or routing mode.
The machine-readable source is conformance/command-capabilities.json. Unverified fields are explicit backlog, not implied support.
Pinned provenance
- Redis documentation version: 8.8
- Redis documentation revision:
ad12d9cd6d10 - Pinned metadata entries: 554
- Scoped command names: 506
- Redis documentation metadata license:
CC-BY-NC-SA-4.0(separate from the Rust crates’ MIT/Apache-2.0 license) - Ordinary generation and CI are offline; each vendored metadata file is SHA-256 verified from the detail manifest. The manifest records both the upstream byte digest and the digest after documented trailing-whitespace normalization.
Availability dispositions
| Disposition | Scoped names | Meaning |
|---|---|---|
dedicated_api | 6 | Supported by a stateful or higher-level API, not a stateless builder. |
intentionally_unsupported | 2 | Deliberately outside the client API contract. |
internal_protocol | 2 | Issued internally by routing/session machinery. |
raw_only | 8 | Available only through an explicitly routed raw command. |
typed_builder | 488 | Dedicated typed Command implementation. |
These counts describe availability only. They are not combined with semantic, wire, or operational verification into a headline score.
Scoped names without typed builders
| Command | Disposition | Public API | Rationale |
|---|---|---|---|
ASKING | internal_protocol | redis_tower_cluster::ClusterConnectionredis_tower_cluster::MultiplexedClusterClient | Cluster redirect handling sends ASKING and the redirected command as one connection-local exchange; a standalone builder would make unsafe separation easy. |
CLUSTER COUNT-FAILURE-REPORTS | raw_only | redis_tower_commands::RawCommand | Node-local cluster administration remains an explicitly routed raw operation. |
CLUSTER MIGRATION | raw_only | redis_tower_commands::RawCommand | Redis 8 cluster migration administration is not part of automatic client routing and must target a deliberate node. |
CLUSTER MYSHARDID | raw_only | redis_tower_commands::RawCommand | This node-local topology inspection command requires an explicitly selected cluster node. |
CLUSTER SLOT-STATS | raw_only | redis_tower_commands::RawCommand | This node-local Redis 8.2 administration command is available through a deliberately routed raw request. |
CLUSTER SYNCSLOTS | raw_only | redis_tower_commands::RawCommand | Cluster slot synchronization mutates node-local state and is intentionally not exposed as an ordinary routed builder. |
JSON.DEBUG HELP | raw_only | redis_tower_commands::RawCommand | JSON.DEBUG MEMORY has a typed builder; the module help variant is an operator-facing raw reply and remains raw-only. |
PSUBSCRIBE | dedicated_api | redis_tower::PubSubConnectionredis_tower::BinaryPubSubConnectionredis_tower_cluster::ClusterPubSubConnectionredis_tower_cluster::BinaryClusterPubSubConnection | Pattern subscription changes a dedicated socket into Pub/Sub mode and is owned by the streaming session API. |
PSYNC | intentionally_unsupported | — | Replication handshakes and replication-stream consumption are outside the request/response client contract. |
PUNSUBSCRIBE | dedicated_api | redis_tower::PubSubConnectionredis_tower::BinaryPubSubConnectionredis_tower_cluster::ClusterPubSubConnectionredis_tower_cluster::BinaryClusterPubSubConnection | Pattern unsubscription is part of the stateful Pub/Sub session and its acknowledgement stream. |
READONLY | internal_protocol | redis_tower_cluster::MultiplexedClusterClientBuilder | Replica-read connections issue READONLY during connection setup so reconnects restore the state before routing reads. |
READWRITE | raw_only | redis_tower_commands::RawCommand | The public cluster clients own their read-routing mode; ad hoc connection-state reversal is only available on an explicitly owned raw session. |
SSUBSCRIBE | dedicated_api | redis_tower::PubSubConnectionredis_tower::BinaryPubSubConnectionredis_tower_cluster::ShardedClusterPubSubConnectionredis_tower_cluster::BinaryShardedClusterPubSubConnection | Sharded Pub/Sub uses a dedicated standalone session or a slot-aware Cluster session that follows the channel slot’s owner. |
SUBSCRIBE | dedicated_api | redis_tower::PubSubConnectionredis_tower::BinaryPubSubConnectionredis_tower_cluster::ClusterPubSubConnectionredis_tower_cluster::BinaryClusterPubSubConnection | Subscription changes the connection protocol mode and is exposed through a dedicated streaming session rather than a stateless command builder. |
SUNSUBSCRIBE | dedicated_api | redis_tower::PubSubConnectionredis_tower::BinaryPubSubConnectionredis_tower_cluster::ShardedClusterPubSubConnectionredis_tower_cluster::BinaryShardedClusterPubSubConnection | Sharded unsubscription is owned by the dedicated standalone or slot-aware Cluster Pub/Sub session and its confirmation handling. |
SYNC | intentionally_unsupported | — | Legacy replication handshakes and replication-stream consumption are outside the request/response client contract. |
TRIMSLOTS | raw_only | redis_tower_commands::RawCommand | This node-local cluster maintenance operation is deliberately excluded from automatic key routing. |
UNSUBSCRIBE | dedicated_api | redis_tower::PubSubConnectionredis_tower::BinaryPubSubConnectionredis_tower_cluster::ClusterPubSubConnectionredis_tower_cluster::BinaryClusterPubSubConnection | Unsubscription and its confirmations are part of the stateful Pub/Sub session. |
Audited command semantics and operations
19/506 scoped names currently have a command-specific semantic or operational audit. The remaining rows are recorded as unverified in the machine ledger.
| Command | Semantics | Binary inputs | Options / response | Routing / session | Evidence |
|---|---|---|---|---|---|
ASKING | not_applicable | not_applicable | Owned by redirect machinery rather than an application command. | ASK target node; same connection and immediately followed by redirected command; One-shot connection state must not be separated from the redirected command. | topology.cluster-redirect |
AUTH | verified | partial | password or username/password; status; Prefer constructor credential configuration so reconnect restores authentication. | connection-local; connection setup; Ad hoc AUTH does not mutate a connection factory. | session.connection-setupsession.credential-provider |
BLPOP | verified | verified | one or more keys plus timeout; optional key/value pair; None on Redis timeout; Caller cancellation after write cannot prove that no element was delivered. | same slot in Cluster; exclusive connection recommended; a multiplexed response deadline can fail a slow command and retire its worker; Standalone value and Redis-timeout replies are verified. Cluster routing and non-stalling concurrent isolation are not command-specifically verified here. | command.blocking-dedicated |
CLIENT TRACKING | partial | not_applicable | owned by caching clients; raw ad hoc variants are not replayed; status; Caching clients enforce their own tracking configuration and invalidation lifecycle. | per data connection; connection-local tracking state; Tracking state is restored only by the caching client that owns it. | session.client-tracking |
EVAL | partial | verified | keys must be declared separately from arguments; raw Frame; The script defines the reply shape; applications must decode deliberately. | all declared keys in one Cluster slot; stateless command; Declared-key encoding is verified in standalone differential tests; Cluster routing remains unaudited here. | command.eval-declared-keys |
FT.SEARCH | partial | partial | FtSearch supports NOCONTENT, VERBATIM, WITHSCORES, LIMIT, RETURN and SORTBY; other documented options are not exposed by this builder; raw Frame; The separate high-level SearchClient::search API performs typed result deserialization. Both require the search Cargo feature and Redis Search server capability. | module/topology dependent; stateless command; Module availability is proven separately from compilation. | module.behavior-differential |
GET | verified | verified | none; Option<Bytes>; nil and empty values remain distinct; RESP2/RESP3 byte strings normalize to the same public shape. | single key slot; stateless command; Read-only and idempotent. | command.binary-and-scalartopology.cluster-core-routing |
HELLO | verified | partial | RESP version, optional auth and client name; server capability map; Prefer connection protocol configuration so reconnect repeats negotiation. | connection-local; connection setup; Protocol version is a socket property. | session.connection-setup |
HGETALL | verified | verified | none; Vec<(Bytes, Bytes)> parsed from RESP2 flat arrays or RESP3 maps; Binary fields and values are preserved; the public response is an ordered pair vector, not a map type. | single key slot; stateless command; Large hashes can produce large replies. | command.collection-stream-shapestopology.cluster-core-routing |
JSON.GET | partial | verified for keys | JSONPath and formatting grammar are textual; optional raw JSON bytes; Requires the JSON Cargo feature and RedisJSON server capability. | single key slot; stateless command; Module capability and standalone behavior are verified; Cluster module routing is not audited here. | module.behavior-differential |
MGET | verified | verified | one or more keys; ordered Vec<Option<Bytes>> preserving nil and empty entries; The result position corresponds to the input key position. | same slot for atomic server command; explicit split helpers are non-atomic; stateless command; Standalone response order is verified; cross-slot split-helper order is verified separately, but same-slot Cluster MGET remains unaudited here. | command.binary-and-scalartopology.cluster-core-routing |
MONITOR | verified | not_applicable | none; stream of monitor lines; MONITOR permanently changes the socket mode until it is dropped. | explicit server node; dedicated MonitorStream; No reconnect resume cursor; commands during a gap are lost. | session.monitor-dedicatedsession.credential-provider |
SCAN | partial | partial | cursor, MATCH and COUNT are live-tested; TYPE is encoded by the builder but is not live-tested here; cursor plus a possibly empty page of binary keys; Continue until cursor zero; changing keyspaces can repeat elements. | one selected node; use ClusterScan for all nodes; cursor sequence without connection affinity; A normal Cluster SCAN is not cluster-wide. | command.scan-cursor |
SELECT | verified | not_applicable | database index; status; Cluster does not support multiple logical databases. | connection-local; connection setup; Configure the database in the connection factory for reconnect replay. | session.connection-setupsession.credential-provider |
SET | partial | verified | EX/PX, NX/XX and GET are typed; EXAT/PXAT/KEEPTTL and Redis 8.4 IFEQ/IFNE/IFDEQ/IFDNE are unimplemented; Set::with_outcome returns independent Applied/NotApplied status and NotRequested/Missing/Value previous-value state; base Set preserves the legacy Option<Bytes> response; RESP2/RESP3 live and parser coverage exercises ordinary SET plus all applied/rejected NX/XX branches with and without GET, including missing, empty and binary previous values. Expiry combinations are not covered. | single key slot; stateless command; Non-idempotent option combinations are not replayed by typed retry policy. | command.set-optionscommand.binary-and-scalartopology.cluster-core-routing |
SSUBSCRIBE | verified | verified | one or more shard channels in one slot; subscription confirmations and message stream; Messages during a disconnect before server-side resubscription are not recovered. | standalone server or current Cluster owner of the shared slot; dedicated standalone or sharded Cluster Pub/Sub connection; Cluster cross-slot subscription sets are rejected before dispatch. | session.pubsub-reconnectsession.credential-provider |
SUBSCRIBE | verified | verified | one or more channels; subscription confirmations and message stream; Confirmed subscriptions can be replayed, but disconnected-gap messages are lost. | explicit standalone or Cluster node; dedicated Pub/Sub connection; Not a stateless multiplexed command. | session.pubsub-reconnectsession.credential-provider |
WATCH | verified | verified | one or more keys; status before EXEC commit/abort outcome; Use the Transaction abstraction for an already-built atomic exchange. | same Cluster slot; dedicated connection for read/compute/write retry loops; A pool has no multi-call connection lease. | command.pipeline-transactioncommand.binary-and-scalartopology.cluster-core-routing |
XREADGROUP | partial | partial | group, consumer, streams, IDs, COUNT and BLOCK; NOACK is not exposed by the builder; typed stream/entry vector for the tested non-blocking consumer-group lifecycle; The builder accepts byte-preserving CommandArg inputs, but the live XREADGROUP evidence uses text identifiers. Blocking timeout shape is not command-specifically verified here. | same slot in Cluster; exclusive connection recommended when BLOCK is used; Standalone consumer-group behavior is verified; blocking isolation and Cluster routing remain unaudited here. | command.stream-consumer-group |
Wire protocol contracts
| Contract | Status | Current behavior | Evidence |
|---|---|---|---|
configured-resource-limits | supported | Frame wire size, aggregate cardinality and nesting depth are preflighted before recursive frame materialization, independently of fragmentation. | protocol.boundariesprotocol.fragmentation |
fragmentation-equivalence | supported | Whole-buffer and arbitrarily fragmented decoding have the same semantic outcome and error category for the tested corpus. | protocol.fragmentation |
resp2-frames | supported | RESP2 scalars, nulls and aggregates are decoded within configured size/depth limits. | protocol.boundariesprotocol.fragmentation |
resp3-core-frames | supported | Supported RESP3 scalar and fixed aggregate forms are decoded and normalized by typed response parsers. | protocol.boundariescommand.collection-stream-shapes |
resp3-fixed-attributes | rejected | Fixed attributes fail closed without consuming bytes; attachment to the following value remains planned in issue #705. | protocol.boundaries |
resp3-streamed-forms | rejected | Streamed string/aggregate headers, chunks and terminators fail closed rather than becoming independent replies; bounded assembly remains planned in issue #705. | protocol.boundariesprotocol.fragmentation |
Logical behavior evidence
A source test, a configured workflow selector, and a dated successful run are separate evidence states. A later checkout must use its own attached checks rather than inheriting the observed result below.
Behavior command binary and scalar
Logical ID: command.binary-and-scalar.
Raw RESP2/RESP3 scalar, nil, empty, binary and numeric replies are compared with redis-rs. Separate typed live tests verify byte-preserving builders and public GET/MGET decoding, including ordered nil-versus-empty results, under forced RESP2 and RESP3.
- Dimensions:
typed-semantics,external-differential - Matrix: server
Redis 7.4.3 and 8.0.6 per-PR matrix; protocolsRESP2, RESP3; featurescore commands; topologiesstandalone - Source tests:
diff_mcp_scalar_nil_binary_and_numeric_boundaries,strings_preserve_invalid_utf8_and_protocol_looking_payloads,typed_binary_inputs_roundtrip_resp2,typed_binary_inputs_roundtrip_resp3,get_nonexistent,mget - Configured CI:
test-unit:,test-integration: - Last observed pass: 2026-09-25 at
07d10b1c0901
Behavior command blocking dedicated
Logical ID: command.blocking-dedicated.
Typed BLPOP returns a key/value pair when data is available and None after a Redis timeout on an exclusive connection. A separate multiplexed raw BLPOP test proves the configured response deadline returns CommandTimeout; the differential BLMOVE case is immediate because its source list is preloaded.
- Dimensions:
typed-semantics,session-ownership - Matrix: server
Redis 7.4.3 and 8.0.6 per-PR matrix; protocolsRESP2, RESP3; featurescore commands; topologiesstandalone - Source tests:
blpop_with_data,blpop_timeout,multiplexed_response_timeout_trips_on_slow_command,diff_mcp_blocking_command_uses_dedicated_sessions,lifecycle_blocking_scan_and_routing_arguments_are_byte_exact - Configured CI:
test-unit:,test-integration: - Last observed pass: 2026-09-25 at
6077899be738
Behavior command collection stream shapes
Logical ID: command.collection-stream-shapes.
Raw hash, collection and Stream replies are compared with redis-rs using independent keys and controlled normalization. Separate typed live and parser tests verify HGETALL’s public pair-vector shape, empty response and RESP3 map normalization.
- Dimensions:
typed-semantics,external-differential - Matrix: server
Redis 7.4.3 and 8.0.6 per-PR matrix; protocolsRESP2, RESP3; featurescore commands; topologiesstandalone - Source tests:
diff_mcp_hash_collection_and_stream_shapes,typed_binary_inputs_roundtrip_resp2,typed_binary_inputs_roundtrip_resp3,hgetall,hgetall_empty,resp3_hgetall_map - Configured CI:
test-unit:,test-integration: - Last observed pass: 2026-09-25 at
07d10b1c0901
Behavior command eval declared keys
Logical ID: command.eval-declared-keys.
Typed EVAL preserves binary declared keys and arguments and matches redis-rs for the tested nested reply.
- Dimensions:
typed-semantics,routing,external-differential - Matrix: server
Redis 7.4.3 and 8.0.6 per-PR matrix; protocolsRESP2, RESP3; featurescore commands; topologiesstandalone - Source tests:
diff_typed_remaining_families_preserve_opaque_bytes - Configured CI:
test-integration: - Last observed pass: 2026-09-25 at
7338c15d8442
Behavior command pipeline transaction
Logical ID: command.pipeline-transaction.
Pipeline ordering and transaction commit/abort outcomes are compared with redis-rs without reusing mutating datasets.
- Dimensions:
typed-semantics,session-ownership,external-differential - Matrix: server
Redis 7.4.3 and 8.0.6 per-PR matrix; protocolsRESP2, RESP3; featurescore commands; topologiesstandalone - Source tests:
diff_mcp_pipeline_and_transaction_outcomes - Configured CI:
test-integration: - Last observed pass: 2026-09-25 at
7338c15d8442
Behavior command scan cursor
Logical ID: command.scan-cursor.
Standalone SCAN cursor iteration exercises MATCH and COUNT until cursor zero; Cluster tests prove a plain keyless SCAN reaches one node while ClusterScan covers the full keyspace.
- Dimensions:
typed-semantics,cursor-lifecycle,routing - Matrix: server
Redis 7.4.3 and 8.0.6 standalone and Cluster per-PR matrix; protocolsdefault Auto negotiation; featurescore commands; topologiesstandalone, cluster - Source tests:
scan_basic,mux_cluster_scan_stream_covers_the_whole_keyspace - Configured CI:
test-integration: - Last observed pass: 2026-09-25 at
7338c15d8442
Behavior command set options
Logical ID: command.set-options.
SET outcome mode distinguishes applied and rejected NX/XX writes independently from unrequested, missing, empty and binary previous values. RESP2/RESP3 parser and live tests cover the complete supported outcome matrix; NX+GET and XX+GET branches are also compared with redis-rs. Expiry combinations remain outside this behavior row.
- Dimensions:
typed-semantics,external-differential - Matrix: server
Redis 7.4.3 and 8.0.6 per-PR matrix; protocolsRESP2, RESP3; featurescore commands; topologiesstandalone - Source tests:
set_outcome_without_get_distinguishes_condition_status,set_outcome_get_maps_nx_and_xx_semantics,cmd_set_nx,cmd_set_xx,typed_binary_inputs_roundtrip_resp2,typed_binary_inputs_roundtrip_resp3,diff_mcp_typed_set_builder_options - Configured CI:
test-unit:,test-integration: - Last observed pass: 2026-09-25 at
bdbcdf38471b
Behavior command stream consumer group
Logical ID: command.stream-consumer-group.
A typed XREADGROUP call reads new entries in a standalone consumer-group lifecycle, after which typed pending, acknowledgement, claim and autoclaim operations verify ownership transitions.
- Dimensions:
typed-semantics,session-ownership - Matrix: server
Redis 7.4.3 and 8.0.6 per-PR matrix; protocolsdefault Auto negotiation (RESP3 on the tested versions); featurescore commands; topologiesstandalone - Source tests:
stream_consumer_group_lifecycle,streams_consumer_groups - Configured CI:
test-integration: - Last observed pass: 2026-09-25 at
7338c15d8442
Behavior module behavior differential
Logical ID: module.behavior-differential.
Module capability preflight is followed by RedisJSON/Search/TimeSeries/probabilistic/Vector behavior and selected redis-rs reply comparisons.
- Dimensions:
typed-semantics,server-capability,external-differential - Matrix: server
Redis 8 module image; actual version discovered at runtime; protocolsRESP2/RESP3 for JSON differential, default negotiated protocol for other module assertions; featuresjson, search, bloom, sketch, tdigest, timeseries, vector-sets; topologiesstandalone - Source tests:
required_server_version_and_commands_are_present,differential_json_raw_replies_match_redis_rs,json_binary_key_roundtrip,search_create_index_and_query,timeseries_add_and_range,bloom_filter_add_and_exists,cuckoo_filter_add_exists_del,count_min_sketch_incrby_and_query,topk_reserve_add_and_query,tdigest_create_add_and_quantile,vector_set_basic_lifecycle - Configured CI:
modules: - Last observed pass: 2026-09-25 at
7338c15d8442
Behavior protocol boundaries
Logical ID: protocol.boundaries.
Independent wire fixtures prove frame limits, aggregate preflight, nesting limits and fail-closed handling for fixed attributes and streamed forms.
- Dimensions:
wire-protocol,resource-limits - Matrix: server
no server; independent wire fixtures; protocolsRESP2, RESP3; featuresprotocol; topologiesnot applicable - Source tests:
complete_oversized_frames_are_rejected_without_consuming_bytes,fixed_attributes_remain_unsupported_even_when_nested,all_streaming_tokens_fail_closed_at_top_level_and_inside_aggregates - Configured CI:
Run protocol boundary regressions - Last observed pass: 2026-09-25 at
7338c15d8442
Behavior protocol fragmentation
Logical ID: protocol.fragmentation.
Property and fuzz oracles compare whole-buffer decoding with arbitrary fragmentation plans and stable error categories.
- Dimensions:
wire-protocol,fragmentation,fuzzing - Matrix: server
no server; generated wire data; protocolsRESP2, RESP3; featuresprotocol, fuzz; topologiesnot applicable - Source tests:
pipelines_match_under_varied_fragmentation,decode_fragmented - Configured CI:
Smoke-test fuzz targets - Last observed pass: 2026-09-25 at
7338c15d8442
Behavior session client tracking
Logical ID: session.client-tracking.
Managed caching clients install tracking, invalidate external writes, reject unsafe connection-state commands and restore a lost redirect connection.
- Dimensions:
session-ownership,reconnect,server-capability - Matrix: server
isolated live Redis process in the per-PR standalone suite; protocolsRESP3; featuresclient-side caching; topologiesstandalone - Source tests:
default_tracking_caches_reads_and_observes_external_invalidation,managed_connection_state_commands_are_rejected_without_losing_tracking,tracking_receiver_loss_fails_closed_and_reinstalls_redirect - Configured CI:
test-integration: - Last observed pass: 2026-09-25 at
7338c15d8442
Behavior session connection setup
Logical ID: session.connection-setup.
Authentication, RESP negotiation and selected database state are exercised through connection setup and reconnect-aware paths.
- Dimensions:
session-ownership,reconnect - Matrix: server
Redis 7.4.3 and 8.0.6 per-PR matrix; protocolsdefault Auto negotiation, focused RESP3 HELLO path; featurescore, URL/auth; topologiesstandalone - Source tests:
reconnect_replays_auth,cover_hello_proto3,select_db - Configured CI:
test-integration: - Last observed pass: 2026-09-25 at
7338c15d8442
Behavior session credential provider
Logical ID: session.credential-provider.
One shared credential provider backs fresh standalone and Cluster sockets plus dedicated Pub/Sub and MONITOR construction. Provider URL setup preserves transport, selected database and RESP negotiation; lookup, forced-refresh, transport and session setup can share one deadline. A forced-refresh failure is redacted and stops setup before SELECT, HELLO or application traffic. Established ordinary clients can reauthenticate through owned tasks with explicitly documented owner-specific failure retirement, while Pub/Sub reconnects with confirmed binary subscriptions and MONITOR terminates/reopens rather than accepting unsafe generic in-band AUTH. Provider errors and refresh-task tracing omit third-party error text and retain authentication classification.
- Dimensions:
session-ownership,reconnect,security,routing - Matrix: server
Redis 7.4.3 and 8.0.6 per-PR matrix plus deterministic provider/unit fixtures; protocolsRESP2 setup, preserved RESP2/RESP3 URL negotiation; featurescore, URL/auth, Cluster, Pub/Sub, MONITOR, AWS and Entra providers; topologiesstandalone, cluster - Source tests:
staged_url_connection_orders_provider_auth_before_database_and_protocol,dropping_push_handle_drops_provider_stream,push_helper_tracing_does_not_render_provider_or_callback_errors,provider_url_factory_preserves_database_and_protocol_but_overrides_static_auth,provider_forced_refresh_failure_is_redacted_and_stops_setup,provider_factory_setup_timeout_bounds_a_stalled_provider,provider_failure_is_redacted_and_authentication_classified,shared_provider_handle_spans_concurrent_dedicated_connection_attempts,pubsub_rotation_reconnects_with_shared_provider_and_preserves_binary_subscriptions,monitor_rotation_terminates_and_reopens_through_shared_provider,node_factory_refetches_credentials_and_negotiates_after_auth,concurrent_force_refreshes_are_coalesced - Configured CI:
test-unit:,test-integration:,Run cluster integration tests - Last observed pass: 2026-09-25 at
5577d6820ca5
Behavior session monitor dedicated
Logical ID: session.monitor-dedicated.
A dedicated MONITOR session parses streamed events and preserves binary command arguments while another connection executes the command.
- Dimensions:
typed-semantics,session-ownership - Matrix: server
Redis 7.4.3 and 8.0.6 per-PR matrix; protocolsdefault negotiated protocol; featurescore; topologiesstandalone - Source tests:
monitor_stream_preserves_binary_command_arguments - Configured CI:
test-integration: - Last observed pass: 2026-09-25 at
7338c15d8442
Behavior session pubsub reconnect
Logical ID: session.pubsub-reconnect.
Dedicated regular and sharded Pub/Sub sessions preserve binary names, replay confirmed subscriptions and follow tested Cluster ownership changes.
- Dimensions:
session-ownership,routing,reconnect - Matrix: server
Redis 7.4.3 and 8.0.6 per-PR matrix; protocolsdefault Auto negotiation, focused standalone RESP3 push path; featurescore, cluster; topologiesstandalone, cluster - Source tests:
pubsub_resubscribes_after_reconnect,pubsub_resp3_push,binary_pubsub_names_round_trip_in_regular_and_sharded_sessions,sharded_pubsub_follows_topology_owner_change_and_resubscribes - Configured CI:
test-integration: - Last observed pass: 2026-09-25 at
7338c15d8442
Behavior topology cluster core routing
Logical ID: topology.cluster-core-routing.
Cluster live tests route binary single-key GET/SET, HGETALL, ordered non-atomic split MGET helpers and slot-pinned WATCH transactions through public APIs.
- Dimensions:
routing,typed-semantics,session-ownership,external-differential - Matrix: server
Redis 7.4.3 and 8.0.6 Cluster per-PR matrix; protocolsAuto (RESP3 on the tested Redis versions); featurescluster, core commands; topologiescluster - Source tests:
diff_redis_rs_cluster_public_entry_point,cluster_large_hgetall,mux_cluster_pipeline_and_split_helpers_preserve_order,cluster_transactions_are_slot_pinned_and_watch_safe - Configured CI:
Run cluster integration tests - Last observed pass: 2026-09-25 at
7338c15d8442
Behavior topology cluster redirect
Logical ID: topology.cluster-redirect.
Cluster clients keep ASKING with the redirected command, follow ASK then MOVED, and update slot ownership during a live reshard.
- Dimensions:
routing,session-ownership,topology - Matrix: server
Redis 7.4.3 and 8.0.6 Cluster per-PR matrix; protocolsAuto (RESP3 on the tested Redis versions); featurescluster; topologiescluster - Source tests:
mux_cluster_handles_ask_then_moved_during_live_reshard,cached_cluster_opt_in_follows_live_ask_without_conflicting_one_shot_flags - Configured CI:
Run cluster integration tests - Last observed pass: 2026-09-25 at
7338c15d8442
Offline validation and refresh
Validate references, dispositions, source builders, pinned file hashes, and generated output without network access:
python3 scripts/generate_command_capabilities.py --check
python3 scripts/generate_command_coverage.py --check
To review a newer Redis documentation snapshot, fetch an explicit commit into a separate directory and compare it before changing provenance:
python3 scripts/fetch_command_metadata.py --ref <redis-docs-commit> \
--output-dir /tmp/redis-command-metadata
python3 scripts/generate_command_capabilities.py \
--compare-metadata /tmp/redis-command-metadata
The comparison reports added/removed names and any command-definition change, including scope, routing keys/flags, arity, versions, summaries, history, and arguments/options. Updating the five vendored files, their hashes, and every new disposition is a reviewed repository change. The downstream MCP project’s Redis 8.10.1 application ledger has a different denominator and is not substituted for this client ledger.