create-yss-spec 3.3.1 → 3.3.3

package/template/.claude/skills/yss-cache/references/redis-fallback.md

@@ -1,23 +0,0 @@
-# Redis 故障降级与恢复
-
-## 状态流
-
-```text
-Redis 健康 -> 命令或健康检查失败 -> 标记不健康 -> 跳过 Redis
--> 可选 fallback -> 周期健康检查 -> Redis 可连接
--> 清理脏 Redis cache 与本地 fallback cache -> 恢复 Redis
-```
-
-- fallback 默认关闭，默认目标是 Caffeine。
-- Redis 健康检查当前每 20 秒执行一次。
-- Redis 命令级连接故障也会立即报告不健康，不必等待下一轮检查。
-- 只读 fallback 不标记 Redis cache 为脏。
-- put、putIfAbsent、evict、clear、invalidate 和 valueLoader 产生的回退写入会标记为脏。
-- 恢复时先清理降级期间发生写操作的 Redis cache，再清理本地 fallback cache。
-- Redis 失效失败时继续保持不健康状态并在后续检查重试，不能提前切回旧 Redis 数据。
-
-## 一致性判断
-
-- Caffeine fallback 是每节点独立数据，不能保证跨节点读到相同值。
-- `clear-fallback-on-recovery=false` 会跳过恢复清理，可能重新暴露 Redis 旧值；除非业务明确接受，不要关闭。
-- 强一致、锁、幂等状态或余额类数据不应依赖缓存 fallback 保证正确性。

package/template/.claude/skills/yss-cache/references/redis-topology.md

@@ -1,62 +0,0 @@
-# Redis 拓扑
-
-框架使用 Spring Boot `spring.redis` 属性和 Jedis 客户端。
-
-## Standalone
-
-```yaml
-spring:
-  redis:
-    host: localhost
-    port: 6379
-    database: 10
-    username: ${REDIS_USERNAME:}
-    password: ${REDIS_PASSWORD:}
-    connect-timeout: 5s
-    timeout: 10s
-    client-type: jedis
-    jedis:
-      pool:
-        enabled: true
-        max-active: 16
-        max-idle: 8
-        min-idle: 2
-        max-wait: 2s
-```
-
-## Sentinel
-
-```yaml
-spring:
-  redis:
-    database: 10
-    username: ${REDIS_USERNAME:}
-    password: ${REDIS_PASSWORD:}
-    sentinel:
-      master: mymaster
-      nodes: host1:26379,host2:26379,host3:26379
-      username: ${SENTINEL_USERNAME:}
-      password: ${SENTINEL_PASSWORD:}
-```
-
-业务 Redis 认证与 Sentinel 自身认证相互独立。
-
-## Cluster
-
-```yaml
-spring:
-  redis:
-    database: 0
-    username: ${REDIS_USERNAME:}
-    password: ${REDIS_PASSWORD:}
-    cluster:
-      nodes: host1:6379,host2:6379,host3:6379
-      max-redirects: 5
-```
-
-## 强制约束
-
-- Sentinel 和 Cluster 不能同时配置，违反时启动失败。
-- Redis Cluster 只允许 DB 0，非零 `spring.redis.database` 会启动失败。
-- username/password、SSL、client-name、连接/读取超时和 Jedis pool 参数会传入连接配置。
-- 不要提供 Lettuce 专属调优参数；当前实现明确使用 Jedis。

package/template/.claude/skills/yss-cache/references/serialization.md

@@ -1,17 +0,0 @@
-# 序列化兼容
-
-当前存在两条不同数据路径：
-
-- 框架 `RedisTemplate` 使用 Jackson JSON serializer。
-- Spring `RedisCacheManager` 沿用默认 JDK value serialization。
-
-两者的数据不可假设互相可读。`RedisTemplate` 的历史泛型声明与通用 JSON 行为也不完全一致，修改前必须检查消费方注入类型和实际操作。
-
-以下变化都属于 Redis 数据协议变更：
-
-- 修改 value/hash serializer。
-- 修改 key serializer 或 cache prefix。
-- 重命名 cache name。
-- 改变 key 的字段、顺序、归一化或版本。
-
-实施协议迁移前至少选择一种策略：双读单写、双写、版本化前缀、灰度清理或停机迁移。必须验证旧值读取、新值写入、回滚和混合版本节点；禁止把“统一 serializer”当作无风险重构。

package/template/.claude/skills/yss-cache/references/source-index.md

@@ -1,67 +0,0 @@
-# yss-cache Source Index
-
-Generated: 2026-08-17T12:03:37.436Z
-Source commit: `38b556a5081e6c66c0c538cbc1ef839b19996ed3`
-Source worktree: `dirty`
-Indexed source root: resolved at refresh time; set `YSS_SOURCE_ROOT` to reproduce or refresh.
-
-This file is generated by `yss-skill-source-index-refresh/scripts/refresh-yss-skill-index.mjs`. Do not hand-edit generated sections.
-
-Paths below are source path hints captured at refresh time. If they do not exist in the current workspace, locate sources using `YSS_SOURCE_ROOT`, CodeGraph, package/class names, Maven artifact names, or repository search before assuming the source is unavailable.
-
-## Component Path Hints
-
-- `yss-microservice-components/yss-component-cache-parent` (existed when indexed)
-
-## Documentation Files
-
-- `yss-microservice-components/yss-component-cache-parent/readme.md`
-
-## Maven Modules
-
-- `yss-microservice-components/yss-component-cache-parent`
-- `yss-microservice-components/yss-component-cache-parent/yss-component-cache-starter`
-- `yss-microservice-components/yss-component-cache-parent/yss-component-caffeine-cache`
-- `yss-microservice-components/yss-component-cache-parent/yss-component-hazelcast-cache`
-- `yss-microservice-components/yss-component-cache-parent/yss-component-jetcache`
-- `yss-microservice-components/yss-component-cache-parent/yss-component-redis-cache`
-- `yss-microservice-components/yss-component-cache-parent/yss-component-spring-cache`
-
-## Key Java Entry Points
-
-- `yss-microservice-components/yss-component-cache-parent/yss-component-cache-starter/src/main/java/com/yss/cloud/cache/CacheAutoConfiguration.java`
-- `yss-microservice-components/yss-component-cache-parent/yss-component-caffeine-cache/src/main/java/com/yss/cloud/cache/caffeine/config/CacheCaffeineManagerConfig.java`
-- `yss-microservice-components/yss-component-cache-parent/yss-component-caffeine-cache/src/main/java/com/yss/cloud/cache/caffeine/config/CacheCaffeineResolver.java`
-- `yss-microservice-components/yss-component-cache-parent/yss-component-caffeine-cache/src/main/java/com/yss/cloud/cache/caffeine/config/CaffeineCacheBackendProvider.java`
-- `yss-microservice-components/yss-component-cache-parent/yss-component-hazelcast-cache/src/main/java/com/yss/cloud/cache/hazelcast/config/CacheHazelcastManagerConfig.java`
-- `yss-microservice-components/yss-component-cache-parent/yss-component-hazelcast-cache/src/main/java/com/yss/cloud/cache/hazelcast/config/HazelcastCacheBackendProvider.java`
-- `yss-microservice-components/yss-component-cache-parent/yss-component-hazelcast-cache/src/main/java/com/yss/cloud/cache/hazelcast/config/YssCacheHazelcastProperties.java`
-- `yss-microservice-components/yss-component-cache-parent/yss-component-jetcache/src/main/java/com/yss/cloud/cache/jetcache/CacheManagerCompose.java`
-- `yss-microservice-components/yss-component-cache-parent/yss-component-redis-cache/src/main/java/com/yss/cloud/cache/redis/config/RedisCacheBackendProvider.java`
-- `yss-microservice-components/yss-component-cache-parent/yss-component-redis-cache/src/main/java/com/yss/cloud/cache/redis/config/RedisConnFactoryConfig.java`
-- `yss-microservice-components/yss-component-cache-parent/yss-component-redis-cache/src/main/java/com/yss/cloud/cache/redis/config/RedisTemplateConfig.java`
-- `yss-microservice-components/yss-component-cache-parent/yss-component-redis-cache/src/main/java/com/yss/cloud/cache/redis/config/SafeRedisCache.java`
-- `yss-microservice-components/yss-component-cache-parent/yss-component-redis-cache/src/main/java/com/yss/cloud/cache/redis/config/YssCacheRedisResolver.java`
-- `yss-microservice-components/yss-component-cache-parent/yss-component-redis-cache/src/main/java/com/yss/cloud/cache/repository/BaseRedisRepository.java`
-- `yss-microservice-components/yss-component-cache-parent/yss-component-redis-cache/src/main/java/com/yss/cloud/cache/repository/YssDatamiddle.java`
-- `yss-microservice-components/yss-component-cache-parent/yss-component-spring-cache/src/main/java/com/yss/cloud/cache/ApplicationContextCacheHelper.java`
-- `yss-microservice-components/yss-component-cache-parent/yss-component-spring-cache/src/main/java/com/yss/cloud/cache/CacheComposeResolver.java`
-- `yss-microservice-components/yss-component-cache-parent/yss-component-spring-cache/src/main/java/com/yss/cloud/cache/CacheManagerCompose.java`
-- `yss-microservice-components/yss-component-cache-parent/yss-component-spring-cache/src/main/java/com/yss/cloud/cache/CacheMemResolver.java`
-- `yss-microservice-components/yss-component-cache-parent/yss-component-spring-cache/src/main/java/com/yss/cloud/cache/CacheRedisResolver.java`
-- `yss-microservice-components/yss-component-cache-parent/yss-component-spring-cache/src/main/java/com/yss/cloud/cache/EnableYssCloudCache.java`
-- `yss-microservice-components/yss-component-cache-parent/yss-component-spring-cache/src/main/java/com/yss/cloud/cache/EnableYssCloudRedisCache.java`
-- `yss-microservice-components/yss-component-cache-parent/yss-component-spring-cache/src/main/java/com/yss/cloud/cache/YssCacheBackendProvider.java`
-- `yss-microservice-components/yss-component-cache-parent/yss-component-spring-cache/src/main/java/com/yss/cloud/cache/YssCacheInterceptor.java`
-- `yss-microservice-components/yss-component-cache-parent/yss-component-spring-cache/src/main/java/com/yss/cloud/cache/YssCacheProperties.java`
-- `yss-microservice-components/yss-component-cache-parent/yss-component-spring-cache/src/main/java/com/yss/cloud/cache/annotation/ClearCache.java`
-- `yss-microservice-components/yss-component-cache-parent/yss-component-spring-cache/src/main/java/com/yss/cloud/cache/annotation/QueryCache.java`
-- `yss-microservice-components/yss-component-cache-parent/yss-component-spring-cache/src/main/java/com/yss/cloud/cache/annotation/UpdateCache.java`
-- `yss-microservice-components/yss-component-cache-parent/yss-component-spring-cache/src/main/java/com/yss/cloud/cache/annotation/YssCacheAnnotationParser.java`
-- `yss-microservice-components/yss-component-cache-parent/yss-component-spring-cache/src/main/java/com/yss/cloud/cache/config/CacheOperationSourceConfiguration.java`
-
-## Recommended Next Reads
-
-- Start with the documentation files above when learning component usage.
-- Search the key Java entry points for annotations, auto configuration, properties, aspects, interceptors, handlers, and result objects before changing application code.
-- Prefer existing component extension points over rewriting framework logic in business modules.

package/template/.claude/skills/yss-cache/references/troubleshooting.md

@@ -1,33 +0,0 @@
-# 证据化排障
-
-## 缓存未命中
-
-1. 检查 starter/后端依赖和 `@EnableYssCloudCache`。
-2. 检查 `active-type` 与实际 Provider/CacheManager Bean。
-3. 确认调用经过 Spring 代理，不是同类自调用。
-4. 检查 SpEL 参数名、null、集合顺序和租户维度。
-5. 比较两次调用生成的 cache name/key，并检查 Redis 实际 key。
-6. 检查 `condition`、`unless`、TTL 和序列化异常。
-
-## 更新后仍读旧值
-
-1. 列出所有写、删、状态变更入口，确认每条路径都更新或清理相同 cache/key。
-2. 检查事务是否尚未提交；YSS 写/删/清理可能在 `afterCommit` 执行。
-3. 检查是否误用了 Caffeine、fallback 或 JetCache local cache。
-4. 检查 `allEntries`、`beforeInvocation` 和空 key 产生的 `SimpleKey.EMPTY`。
-
-## Redis 启动或连接失败
-
-1. 判定 Standalone/Sentinel/Cluster，检查拓扑互斥和 Cluster DB 0。
-2. 分别核对 Redis 数据节点与 Sentinel 认证。
-3. 检查 SSL、DNS、端口、connect/read timeout 和 Jedis pool。
-4. 检查用户自定义连接工厂是否使默认配置回退。
-
-## Redis 故障后行为异常
-
-1. 检查 fallback 是否明确开启、目标 Provider 是否存在且 available。
-2. 区分只读回退与脏写回退。
-3. 查看恢复时 Redis 清理失败日志；失败时框架应保持降级并重试。
-4. 多节点差异优先按 fallback 一致性窗口分析，不要误判为 Redis 广播失效。
-
-可先运行 `scripts/inspect-cache-usage.sh <project-root>` 取得静态证据，再进入源码路径。

package/template/.claude/skills/yss-cache/references/verification.md

@@ -1,34 +0,0 @@
-# 验证与完成标准
-
-## 组件
-
-```bash
-./mvnw -f yss-microservice-components/yss-component-cache-parent/pom.xml verify
-```
-
-跨模块测试使用父 reactor 的 `-pl <module> -am`，避免解析本地旧 SNAPSHOT。也可运行：
-
-```bash
-scripts/verify-cache-component.sh --source-root /path/to/yss-cloud-microservice
-```
-
-## 消费项目
-
-```bash
-./mvnw -pl <starter-module> -am -DskipTests package
-```
-
-完整启动依赖数据库、注册中心等外部服务时，构建验证与启动验证分开报告。
-
-## 验收矩阵
-
-- 首次调用执行业务，第二次相同 key 命中缓存。
-- 不同租户/业务 key 不串值。
-- 更新、删除、状态变更后旧值失效。
-- `condition`、`unless` 和异常返回行为符合预期。
-- 默认 TTL 和枚举覆盖 TTL 在后端物理存在。
-- Redis 停止后行为符合 fallback 配置；恢复后旧 Redis 值不会重新出现。
-- Sentinel/Cluster 创建正确连接工厂，Cluster 使用 DB 0。
-- Docker 可用时真实 Redis 认证、JSON template、JDK cache serialization 和 TTL 测试实际执行。
-- Java 8 组件 class major version 为 52。
-- `git diff --check` 通过，消费 starter 构建通过。

package/template/.claude/skills/yss-cache/scripts/check-skill-freshness.sh

@@ -1,84 +0,0 @@
-#!/usr/bin/env bash
-set -u
-
-skill_dir=$(CDPATH= cd -- "$(dirname -- "$0")/.." && pwd)
-
-locate_source() {
-  if [ "$#" -gt 0 ] && [ -n "$1" ]; then
-    if [ -d "$1/yss-microservice-components/yss-component-cache-parent" ]; then
-      echo "$1"
-      return 0
-    fi
-    return 1
-  fi
-  if [ -n "${YSS_SOURCE_ROOT:-}" ] && [ -d "$YSS_SOURCE_ROOT/yss-microservice-components/yss-component-cache-parent" ]; then
-    echo "$YSS_SOURCE_ROOT"
-    return 0
-  fi
-  for candidate in "$PWD" "$PWD/.." "$HOME/Projects/yss-cloud-microservice" "$HOME/Documents/yss-project/yss-cloud-microservice"; do
-    if [ -d "$candidate/yss-microservice-components/yss-component-cache-parent" ]; then
-      (CDPATH= cd -- "$candidate" && pwd)
-      return 0
-    fi
-  done
-  return 1
-}
-
-source_root=$(locate_source "${1:-}") || {
-  echo "ERROR: cannot locate yss-component-cache-parent; pass source root or set YSS_SOURCE_ROOT" >&2
-  exit 2
-}
-
-parent="$source_root/yss-microservice-components/yss-component-cache-parent"
-annotation="$parent/yss-component-spring-cache/src/main/java/com/yss/cloud/cache/annotation/ClearCache.java"
-properties="$parent/yss-component-spring-cache/src/main/java/com/yss/cloud/cache/YssCacheProperties.java"
-connection="$parent/yss-component-redis-cache/src/main/java/com/yss/cloud/cache/redis/config/RedisConnFactoryConfig.java"
-index="$skill_dir/references/source-index.md"
-fail=0
-
-require_text() {
-  file=$1
-  pattern=$2
-  label=$3
-  if ! grep -Eq "$pattern" "$file"; then
-    echo "STALE: $label not found in $file"
-    fail=1
-  fi
-}
-
-require_text "$annotation" 'boolean allEntries\(\)' 'ClearCache.allEntries'
-require_text "$annotation" 'boolean beforeInvocation\(\)' 'ClearCache.beforeInvocation'
-require_text "$properties" 'private Duration defaultTtl' 'yss.cache.default-ttl'
-require_text "$properties" 'private boolean fallbackEnabled' 'Redis fallback-enabled'
-require_text "$properties" 'private String fallbackType' 'Redis fallback-type'
-require_text "$properties" 'private boolean clearFallbackOnRecovery' 'Redis clear-fallback-on-recovery'
-require_text "$connection" 'cannot be configured together' 'Sentinel/Cluster mutual exclusion'
-require_text "$connection" 'database must be 0' 'Cluster database 0 guard'
-
-for module in yss-component-spring-cache yss-component-redis-cache yss-component-caffeine-cache yss-component-cache-starter yss-component-jetcache; do
-  if ! grep -q "$module" "$index"; then
-    echo "STALE: source-index is missing module $module"
-    fail=1
-  fi
-done
-
-generated=$(sed -n 's/^Generated: //p' "$index" | head -1)
-if [ -z "$generated" ]; then
-  echo "STALE: source-index has no Generated timestamp"
-  fail=1
-else
-  echo "INFO: source-index generated at $generated"
-fi
-
-if [ "$annotation" -nt "$index" ] || [ "$properties" -nt "$index" ] || [ "$connection" -nt "$index" ]; then
-  echo "STALE: critical cache source is newer than source-index"
-  fail=1
-fi
-
-if [ "$fail" -ne 0 ]; then
-  echo "RESULT: skill/source contract drift detected; refresh with yss-skill-source-index-refresh and review semantic references"
-  exit 1
-fi
-
-echo "RESULT: yss-cache critical contracts match source at $source_root"
-exit 0

package/template/.claude/skills/yss-cache/scripts/inspect-cache-usage.sh

@@ -1,96 +0,0 @@
-#!/usr/bin/env bash
-set -u
-
-usage() {
-  echo "Usage: $0 <project-root>" >&2
-}
-
-if [ "$#" -ne 1 ]; then
-  usage
-  exit 2
-fi
-
-root=$1
-if [ ! -d "$root" ]; then
-  echo "ERROR: project root does not exist: $root" >&2
-  exit 2
-fi
-
-if command -v rg >/dev/null 2>&1; then
-  search() { rg -n --hidden --glob '!target/**' --glob '!.git/**' --glob '*.java' --glob '*.yml' --glob '*.yaml' --glob '*.properties' --glob 'pom.xml' "$1" "$root" 2>/dev/null || true; }
-  files() { rg --files "$root" -g '*.yml' -g '*.yaml' -g '*.properties' -g '*.java' -g 'pom.xml'; }
-else
-  search() { grep -REn "$1" "$root" --include='*.java' --include='*.yml' --include='*.yaml' --include='*.properties' --include='pom.xml' 2>/dev/null || true; }
-  files() { find "$root" -type f \( -name '*.java' -o -name '*.yml' -o -name '*.yaml' -o -name '*.properties' -o -name 'pom.xml' \); }
-fi
-
-tmp=${TMPDIR:-/tmp}/yss-cache-inspect.$$
-trap 'rm -f "$tmp"' EXIT HUP INT TERM
-files >"$tmp"
-if [ ! -s "$tmp" ]; then
-  echo "ERROR: no Java, Maven, or configuration files found under $root" >&2
-  exit 2
-fi
-
-fail=0
-echo "YSS cache usage inspection: $root"
-
-report() {
-  level=$1
-  title=$2
-  pattern=$3
-  result=$(search "$pattern")
-  if [ -n "$result" ]; then
-    echo
-    echo "[$level] $title"
-    echo "$result" | sed -n '1,20p'
-  fi
-}
-
-report INFO "Cache component dependencies" 'yss-component-(cache-starter|spring-cache|redis-cache|caffeine-cache|hazelcast-cache|jetcache)'
-report INFO "Cache enable annotations" '@EnableYssCloud(Cache|RedisCache)'
-report INFO "YSS cache annotations" '@(QueryCache|UpdateCache|ClearCache)'
-report INFO "Configured backend and TTL" 'yss\.cache\.(active-type|default-ttl)|active-type:|default-ttl:'
-report INFO "Redis fallback configuration" 'fallback-(enabled|type)|clear-fallback-on-recovery'
-report INFO "RedisTemplate injection contracts" 'RedisTemplate[[:space:]]*<'
-
-sentinel=$(search 'spring\.redis\.sentinel|sentinel:')
-cluster=$(search 'spring\.redis\.cluster|cluster:')
-if [ -n "$sentinel" ] && [ -n "$cluster" ]; then
-  echo
-  echo "[ERROR] Both Redis Sentinel and Cluster configuration markers were found. Confirm they are not active in the same profile."
-  fail=1
-fi
-
-if [ -n "$cluster" ]; then
-  nonzero=$(search 'spring\.redis\.database[[:space:]]*=[[:space:]]*[1-9][0-9]*|database:[[:space:]]*[1-9][0-9]*')
-  if [ -n "$nonzero" ]; then
-    echo
-    echo "[ERROR] Redis Cluster requires database 0."
-    echo "$nonzero" | sed -n '1,20p'
-    fail=1
-  fi
-fi
-
-clear_without_key=$(search '@ClearCache[[:space:]]*(\([^)]*\))?')
-if [ -n "$clear_without_key" ]; then
-  echo
-  echo "[REVIEW] ClearCache usages found. Verify each use has a stable key or explicit allEntries=true; no-arg methods produce SimpleKey.EMPTY."
-fi
-
-query=$(search '@QueryCache')
-update=$(search '@(UpdateCache|ClearCache)')
-if [ -n "$query" ] && [ -z "$update" ]; then
-  echo
-  echo "[REVIEW] QueryCache is used but no UpdateCache/ClearCache annotation was found. Inspect explicit invalidation paths."
-fi
-
-if [ "$fail" -ne 0 ]; then
-  echo
-  echo "RESULT: blocking cache configuration defects found"
-  exit 1
-fi
-
-echo
-echo "RESULT: no statically provable blocking cache defect found; REVIEW items still require code inspection"
-exit 0

package/template/.claude/skills/yss-cache/scripts/verify-cache-component.sh

@@ -1,101 +0,0 @@
-#!/usr/bin/env bash
-set -u
-
-source_root=""
-consumer_root=""
-consumer_module=""
-
-usage() {
-  echo "Usage: $0 [--source-root PATH] [--consumer-root PATH --consumer-module MODULE]" >&2
-}
-
-while [ "$#" -gt 0 ]; do
-  case "$1" in
-    --source-root) [ "$#" -ge 2 ] || { usage; exit 2; }; source_root=$2; shift 2 ;;
-    --consumer-root) [ "$#" -ge 2 ] || { usage; exit 2; }; consumer_root=$2; shift 2 ;;
-    --consumer-module) [ "$#" -ge 2 ] || { usage; exit 2; }; consumer_module=$2; shift 2 ;;
-    -h|--help) usage; exit 0 ;;
-    *) usage; exit 2 ;;
-  esac
-done
-
-if [ -z "$source_root" ]; then
-  source_root=${YSS_SOURCE_ROOT:-}
-fi
-if [ -z "$source_root" ]; then
-  for candidate in "$PWD" "$PWD/.." "$HOME/Projects/yss-cloud-microservice" "$HOME/Documents/yss-project/yss-cloud-microservice"; do
-    if [ -d "$candidate/yss-microservice-components/yss-component-cache-parent" ]; then
-      source_root=$candidate
-      break
-    fi
-  done
-fi
-
-parent="${source_root%/}/yss-microservice-components/yss-component-cache-parent"
-if [ -z "$source_root" ] || [ ! -f "$parent/pom.xml" ]; then
-  echo "ERROR: cannot locate cache parent; use --source-root or YSS_SOURCE_ROOT" >&2
-  exit 2
-fi
-if [ ! -x "$source_root/mvnw" ]; then
-  echo "ERROR: Maven wrapper is missing or not executable: $source_root/mvnw" >&2
-  exit 2
-fi
-if { [ -n "$consumer_root" ] && [ -z "$consumer_module" ]; } || { [ -z "$consumer_root" ] && [ -n "$consumer_module" ]; }; then
-  echo "ERROR: --consumer-root and --consumer-module must be provided together" >&2
-  exit 2
-fi
-
-echo "== Cache reactor verify =="
-(cd "$source_root" && ./mvnw -f "$parent/pom.xml" verify) || exit 1
-
-echo "== Docker integration status =="
-report="$parent/yss-component-redis-cache/target/surefire-reports/TEST-com.yss.cloud.cache.redis.config.RedisStandaloneIntegrationTest.xml"
-if command -v docker >/dev/null 2>&1 && docker info >/dev/null 2>&1; then
-  if [ ! -f "$report" ]; then
-    echo "ERROR: Docker is available but Redis integration report is missing" >&2
-    exit 1
-  fi
-  if grep -Eq 'skipped="[1-9]' "$report"; then
-    echo "ERROR: Docker is available but Redis integration test was skipped" >&2
-    exit 1
-  fi
-  echo "PASS: real Redis integration test executed"
-else
-  echo "SKIP: Docker is unavailable; Redis integration test may be skipped by assumption"
-fi
-
-echo "== Diff whitespace =="
-if command -v git >/dev/null 2>&1 && git -C "$source_root" rev-parse --is-inside-work-tree >/dev/null 2>&1; then
-  git -C "$source_root" diff --check || exit 1
-else
-  echo "SKIP: source root is not a Git worktree"
-fi
-
-echo "== Java 8 bytecode =="
-classes=$(find "$parent" -path '*/target/classes/*.class' -type f | head -1)
-if [ -z "$classes" ]; then
-  echo "ERROR: no compiled cache class found" >&2
-  exit 1
-fi
-if ! command -v javap >/dev/null 2>&1; then
-  echo "ERROR: javap is required for bytecode verification" >&2
-  exit 2
-fi
-majors=$(find "$parent" -path '*/target/classes/*.class' -type f -exec javap -verbose {} \; 2>/dev/null | sed -n 's/.*major version: *//p' | sort -u)
-if [ "$majors" != "52" ]; then
-  echo "ERROR: expected only Java 8 major version 52, found: $majors" >&2
-  exit 1
-fi
-echo "PASS: all cache classes use major version 52"
-
-if [ -n "$consumer_root" ]; then
-  echo "== Consumer build =="
-  if [ ! -x "$consumer_root/mvnw" ] || [ ! -f "$consumer_root/pom.xml" ]; then
-    echo "ERROR: invalid consumer root: $consumer_root" >&2
-    exit 2
-  fi
-  (cd "$consumer_root" && ./mvnw -pl "$consumer_module" -am -DskipTests package) || exit 1
-fi
-
-echo "RESULT: cache verification passed"
-exit 0