[andy-stark-redis]

Adds data/command-api-mapping/ entries (15 files) for the commands new in Redis 8.12, and regenerates data/command-api-mapping.json (additions only; git diff --patience shows +8,516/-0).

Commands: BITRANGEINTARRAY; SADDEX, SEXPIRE, SPEXPIRE, SEXPIREAT, SPEXPIREAT, STTL, SPTTL, SEXPIRETIME, SPEXPIRETIME, SPERSIST; BLESS SET/CLEAR/GET/SCAN.

Warning

Do not merge yet. This PR documents client APIs that are on the clients' default branches but in no stable release. Base is feature-oss-8.12 (the 8.12 release branch), not main.

Run-verified on redis:8.12-rc2 (reports redis_version:8.11.241, the rc2 string), 2026-11-10. Every mapped signature was called as written against the default branch of its client and returned the expected value: redis-py 509306fc7325, go-redis 9f33ff11dff1, node-redis be1e998a653d, redis-rb cadebe5d2c5e, predis 1685693b83ef, Jedis c701a365ab46, lettuce 62e6e6e7010b (sync, async and reactive). 320 overload rows passed, with no mismatches. Notes: node-redis blessScan needs a string cursor ('0'), and SADDEX replies 1 for any successful call, not a member count.

Park manifest

Ticket: DOC-7292
Parked at: 2026-11-10
Trigger to pick up: for each client, the merge commit of its PR below is an ancestor of a non-prerelease tag (gh api repos/<o>/<r>/compare/<merge-sha>...<tag> returns behind_by: 0), and Redis 8.12 is GA. Clients ship at different times, so unpark can land client rows in stages: remove rows for clients still unreleased.
Labels: parked, do not merge yet

Pinned sources (state observed at park time, 2026-11-10)

Source	State	Head / merge SHA	Latest stable tag
jedis#4828 set expiry	merged, base master	merge e7c37d3d3d5e	v8.0.2 (v8.1.0-beta2 predates it)
jedis#4773 BLESS	merged, base master	merge 4978e839ce6f	v8.0.2
jedis#4830 BITRANGEINTARRAY	open, base master	head 8308d7a675b0	not mapped
lettuce#3991 set expiry	merged, base main	merge c8c11f7e454b	7.9.0.RELEASE (8.0.0.BETA1 is a prerelease)
lettuce#3992 BITRANGEINTARRAY	merged 2026-11-09	merge 5320f301a087	same
lettuce#3936 BLESS	merged	merge 55b8a8a91dde	same
redis-py#4587 BITRANGEINTARRAY	merged	merge 4fe8a8c18e28; master 509306fc7325	v8.1.0 (v8.2.0b1 has all but BITRANGEINTARRAY)
redis-rb#1409 BITRANGEINTARRAY	merged	merge cadebe5d2c5e (= master)	v6.0.0
go-redis#4242 BITRANGEINTARRAY	merged	merge f477e06feb2c; master 9f33ff11dff1	v9.23.0
predis#1749 set expiry	merged	merge 1685693b83ef (= main)	v3.7.1 (BLESS shipped there; set expiry did not)
predis#1754 BITRANGEINTARRAY	open	head 15c24ca18790	not mapped
node-redis master	all 15	be1e998a653d	redis@6.3.1 / 6.4.0-beta.0 has BLESS only
SE.Redis#3343 8.12 into main	open	head b7b0bc548ef8	none; not mapped (also NRedisStack)

Re-fetch a PR: gh api repos/<o>/<r>/pulls/<n> --jq '{state, merged, head_sha: .head.sha, merge: .merge_commit_sha, base: .base.ref, updated_at}'. Re-read signatures from each client's default branch or release tag, not from the PR.

Observed shape the page assumes

Confidence: MEDIUM for what each command does; LOW for identifiers, because none is released.

• redis_py, node_redis, go-redis, redis_rb: all 15 commands typed on the default branch. php (predis): all but BITRANGEINTARRAY.
• jedis: 14 commands (all but BITRANGEINTARRAY), String and byte[] overloads as separate entries.
• lettuce_sync/async/reactive: all 15, with many overloads (sexpire and spexpire have 8, sexpireat and spexpireat 12).
• Left out on purpose: redis-rs (only redis::cmd), nredisstack (SE.Redis work is on its 8.12 branch behind SER011), ioredis, redisvl.
• Descriptions are empty strings, as in HEXPIRE.json.

Re-check checklist

• Signatures called against a live 8.12-rc2 server on each client's default branch (2026-11-10).
• Highest risk: re-read every signature at each client's release tag. Identifiers move between a default branch and a release.
• SE.Redis maps several commands onto one method (SetMemberExpire covers SEXPIRE/SPEXPIRE/SEXPIREAT/SPEXPIREAT; SetMemberGetTimeToLive is SPTTL only; BLESS SCAN is IServer.BlessedKeys). Decide how NRedisStack rows should represent that once 8.12 reaches main.
• Add BITRANGEINTARRAY rows for jedis (#4830) and predis (DEV: add RESP2/3 return information to the t-digest commands #1754) once merged.
• Add redis-rs rows if typed methods appear.
• Check CMS.INITBYDIM, CMS.INITBYPROB and CMS.INCRBY for CELL_SIZE and negative increments (not mapped here).
• node-redis: only BLESS confirmed in a release; the other S* files were assumed to match SEXPIRE.
• go-redis BlessScan is node-local (cursor); node-redis BLESS SCAN returns a transformed {cursor, keys} object. Check whether the rows should say so.
• Reconcile redis_py/php signature style with older files such as HEXPIRE.json, which differ slightly from the client-quirks.md rules.
• The 2026-11-07 PR scan was already stale for lettuce and jedis; re-read defaults, don't trust the scan.

On unpark, then

Run /unpark with this PR's number. /unpark Steps 4–5 own the closing sequence; /finalize is deferred until then.

[github-actions]

DOC-7292

[github-actions]

🧠 Redis Memory

Found 5 related items from repository history (5 new this commit):

• PR — DOC-6957 Add Ruby (redis-rb) array data type examples [PARKED] 🆕

  DOC-6957 — Ruby (redis-rb) array data type examples

• PR — DOC-7267 Fill the missing Ruby entries from the redis-rb 6.0.0 source 🆕

  Summary

• PR — DOC-7267 Make node_redis entries callable and typed, and add ctx to go-redis HOTKEYS 🆕

  Summary

• PR — DOC-7267 Write the last Ruby entries from the method bodies and a live check 🆕

  Summary

• PR — DOC-7267 Fix malformed and non-callable redis_py entries 🆕

  Summary

Memory updated at 85470f0