# README 가 스스로 정한 세 축과 그 증거
| 축 | 뜻 | 증거 |
| --- | --- | --- |
| **API 구현** | 타입·정책·contract test가 존재한다 | `:adapter:outbound:cache-redis:test` |
| **Spring composition 구현** | `APP_REDIS_ENABLED=true`에서 실제 bean이 조립된다 | `RedisSdkAutoConfigurationTest` |
| **실서버 qualification** | 지원 topology·버전에서 실제 서버로 증명됐다 | `redisTopologyTest` lane evidence |

# 준비도 표
| Capability | API 구현 | Spring composition 구현 | 실서버 qualification |
| --- | --- | --- | --- |
| Redis SDK typed API (`…cache.redis.sdk`) | 있음 | settings bind + validate 까지만 | 없음 |
| Topology client / connection lifecycle | 없음 | 없음 | 없음 |
| cache / session / idempotency / rate limit / lease semantic port | 없음 | 없음 | 없음 |
| role-aware health·readiness contributor | 없음 | 없음 | 없음 |

# 표 아래 두 문단
즉 현재 `APP_REDIS_ENABLED=true`가 하는 일은 `RedisSdkSettings`를 bind하고 cross-field 규칙을
fail-fast로 검증하는 것까지다. client, connection, gateway, semantic adapter, health contributor는
아직 조립되지 않는다. 남은 단계와 순서는
`docs/superpowers/plans/2026-08-10-redis-optionality-and-composition.md`에 있다.
readiness registry에도 `selected` card가 없으므로 Redis R2 release claim은 없다. 아래 절들은
이전 세대 semantic adapter 세트의 설계 결정을 기록한 것이며, 그 코드는 현재 이 leaf에 없다.
복구 범위는 위 plan의 Phase E가 소유한다.

# 세 줄 뒤 같은 README 의 산문
모듈은 Lettuce connection lifecycle,
finite command timeout, reconnect replay 차단, finite request queue/admission, positive/negative
TTL, absolute soft/hard expiry, deterministic bounded TTL jitter, digest-protected v2 binary
envelope, HMAC physical key,
invalidation, closed-catalog
`EVALSHA -> NOSCRIPT -> SCRIPT LOAD -> digest verify -> EVALSHA` recovery를 제공한다.
`app.cache.redis.client-mode=external`이면 프로젝트가 제공한 `RedisClient` 호환 경로를 사용하고
managed connection을 생성하지 않는다.

# 둘째 열의 증거로 지목된 시험이 단언하는 것
            context -> {
              assertThat(context).hasNotFailed();
              assertThat(context).hasSingleBean(RedisSdkSettings.class);
              RedisSdkSettings settings = context.getBean(RedisSdkSettings.class);
              assertThat(settings.isEnabled()).isTrue();
              assertThat(settings.getNodes()).containsExactly("redis-a:6379");
              assertThat(context).hasSingleBean(RedisRuntimeClient.class);
              assertThat(context.getBean(RedisRuntimeClient.class).mode())
                  .isEqualTo(RedisDeploymentMode.STANDALONE);
              assertThat(context).hasSingleBean(RedisRuntimeOwner.class);
              assertThat(settings.getNamespace().getEnvironment()).isEqualTo("prod");