[andy-stark-redis]

Summary

The last redis_py items from DOC-7267, checked against redis-py 8.1.0. Ten command files change, only their redis_py lists, plus the status file and the merged data file.

• Stale entries updated:
  • JSON.SET gains fpha and returns Optional[bool].
  • TS.MRANGE and TS.MREVRANGE gain exclude_empty, and aggregation_type takes a string or a list of strings.
  • XREAD and XREADGROUP gain max_count and max_size.
• Nonexistent methods:
  • CLIENT CACHING, FT.CURSOR DEL and FT._LIST have no redis-py method, so their lists are empty and redis_py is generic_only in the status file.
  • FT.CURSOR READ is aggregate() called with a Cursor, so its entry is now the aggregate signature.
• FT.AGGREGATE typed query as Union[str, Query]. The method takes Union[AggregateRequest, Cursor], so I corrected it. This wasn't on the original list.

Review notes

• Every touched entry's parameter names equal inspect.signature of the method in 8.1.0. No other client's key changes, and the merged file equals a regeneration from the per-command files.
• A re-run of my method-existence detector flagged 36 more entries (AR*, HIMPORT*, HOTKEYS*, DELEX, DIGEST, MSETEX, VRANGE, XCFGSET, FT.HYBRID). All 36 methods exist in 8.1.0, so the detector was wrong and they are not defects.
• Not fixed: the ResponseT and Any returns on the XREAD and TS range entries, and any other redis_py entry whose parameter types differ from 8.1.0. Only the entries the earlier sweep flagged were rechecked.
• New param descriptions are mine, based on the docstrings in 8.1.0.

🤖 Generated with Claude Code

---

Note

Low Risk
Documentation-only JSON updates; no runtime code paths touched, so risk is limited to potential data-entry mistakes.

Overview
Aligns the redis-py command documentation with redis-py 8.1.0 by rewriting signatures and parameters for JSON, search, timeseries, and streams helpers. The composite command-api-mapping.json and the per-command shards are updated together so the merged data stays consistent.

Removes redis-py entries that never existed and flags those commands as generic_only in command-api-mapping-status.json, explicitly covering CLIENT CACHING, FT.CURSOR DEL, and FT._LIST. Search cursor flows now document aggregate(...) with AggregateRequest/Cursor, and the FT aggregate mapping tightens its parameter typing.

Introduces new optional knobs where the client gained them: JSON.SET exposes the fpha flag and fixes the boolean return type, TS.MRANGE/TS.MREVRANGE accept list aggregations plus exclude_empty, and XREAD/XREADGROUP capture max_count/max_size with Redis 8.10 notes.

^{Reviewed by Cursor Bugbot for commit bbf1227. Bugbot is set up for automated code reviews on this repo. Configure here.}

[github-actions]

DOC-7267

[github-actions]

🧠 Redis Memory

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

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

  Summary

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

  DOC-7267 Fix malformed and non-callable redis_py entries

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

  DOC-7267 Fix malformed and non-callable redis_py entries

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

  Summary

• PR — DOC-7267 Clean up the NRedisStack sync and async entries 🆕

  Summary

Memory updated at bbf1227

[dwdougherty]

Approved.