[Commands API interface consistency #1] tests and non-breaking fixes

[uglide]

Introduces a reflection-based unit-test suite that verifies the sync, async, reactive, Kotlin coroutine and cluster node-selection command interfaces stay in lockstep, replacing the consistency-by-regeneration guarantee of the template-based API generators (removal of the generators follows in #3866).

What the suite checks

• Sync ↔ async — method parity in both directions plus RedisFuture<T> return-type wrapping. This is load-bearing at runtime: the sync API is a dynamic proxy over async (FutureSyncInvocationHandler), so a mismatch previously failed only at call time.
• Sync ↔ reactive — parity plus the Mono/Flux mapping rules (collections → Flux, forced-Flux, Value<>-wrapped elements) and @Deprecated on streaming-channel variants.
• Sync ↔ Kotlin coroutines — presence plus suspend/Flow shape (via kotlin-reflect, new test-scope dependency managed by the Kotlin BOM).
• Node-selection — Executions/AsyncExecutions wrapping and the exclusion list, with a staleness check on the list itself.
• Aggregates — RedisCommands, RedisClusterCommands, NodeSelectionCommands, RedisClusterCoroutinesCommands etc. extend every command group they must cover, and the methods declared directly on the aggregates (auth, select, the CLUSTER commands, …) are parity-checked against their async/reactive counterparts.
• Builder coverage — every command has a same-named method on its command builder and every command-producing builder method is reachable from an interface.

Structure: CommandInterfaces (group catalog — the single place to register a new command group), KnownApiDeviations (all intentional irregularities, ported from the generator rule tables), TypeSignatures (shared reflection helpers). Supersedes SyncAsyncApiConvergenceUnitTests.

Deviations found and fixed

Calibrating the suite against the committed interfaces surfaced real drift, fixed in the second commit:

• RedisCoroutinesCommands did not extend RediSearchCoroutinesCommands (the impl already delegated to it)
• Kotlin coroutine API was missing bitopDiff/bitopDiff1/bitopAndor/bitopOne, hgetex(key, fields), hsetex(key, map) and the xackdel/xdelex stream commands
• reactive hgetdel/hgetex streaming-channel variants were missing @Deprecated

Deviations found and deferred

The node-selection aggregate wiring drift (missing ACL/Array groups; NodeSelectionAsyncCommands extending the sync NodeSelectionStreamCommands) is not fixed here — correcting it changes return types on AsyncNodeSelection and is therefore a breaking change. It is exempted via KnownApiDeviations.NODE_SELECTION_AGGREGATE_PENDING (with a documenting comment) and fixed in #3867, targeted for the 8.0.0 release.

Note: the first commit intentionally fails the new tests (it demonstrates the drift); the second commit makes the suite green.

Make sure that:

• You have read the contribution guidelines.
• You have created a feature request first to discuss your contribution intent. Please reference the feature request ticket number in the pull request.
• You applied code formatting rules using the mvn formatter:format target. Don't submit any formatting related changes.
• You submit test cases (unit or integration tests) that back your changes.

🤖 Generated with Claude Code

---

Note

Medium Risk
Touches many public command interfaces and cluster/coroutine aggregates; mistakes could break compile-time API contracts, though changes are additive or deprecation-only with heavy reflection test coverage.

Overview
Adds a reflection-based unit test suite under io.lettuce.core.api.consistency that keeps sync, async, reactive, Kotlin coroutines, cluster aggregates, node-selection, and command builders aligned—replacing the old SyncAsyncApiConvergenceUnitTests and the generator-era guarantee. Shared scaffolding includes CommandInterfaces, KnownApiDeviations, and TypeSignatures; kotlin-reflect is added as a test dependency.

Interface fixes surfaced by the new tests: RedisCoroutinesCommands and RedisClusterCoroutinesCommands now extend RediSearch (and cluster coroutines also wire Function, JSON, VectorSet, Array); Kotlin coroutines gain 7.7 APIs (bitopDiff/Diff1/Andor/One, simplified hsetex/hgetex, xackdel/xdelex); reactive hgetex/hgetdel streaming-channel overloads are marked @Deprecated; missing @Deprecated on cluster masters() and reactive keysLegacy is restored.

Generator/test maintenance: KotlinCompilationUnitFactory FLOW_METHODS updated for new streaming commands; coroutine integration tests cover hash expiry, bitops, and stream deletion. Known node-selection aggregate gaps stay exempt via NODE_SELECTION_AGGREGATE_PENDING (deferred to 8.0).

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

[chatgpt-codex-connector]

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: f29cddcb82

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

• Open a pull request for review
• Mark a draft as ready
• Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

[cursor]

Cursor Bugbot has reviewed your changes using default effort and found 1 potential issue.

^{❌ Bugbot Autofix is OFF. To automatically fix reported issues with cloud agents, have a team admin enable autofix in the Cursor dashboard.}

^{Reviewed by Cursor Bugbot for commit fddac9d. Configure here.}

[chatgpt-codex-connector]

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: fddac9d08f

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

• Open a pull request for review
• Mark a draft as ready
• Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

[chatgpt-codex-connector]

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 622d6750ad

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

• Open a pull request for review
• Mark a draft as ready
• Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".