init: llm-wiki-haness 하네스 설계

vault/10-projects/errors/scheduled-reaper-wrong-config-prefix-2026-06-09.md

@@ -0,0 +1,42 @@
+---
+title: error / scheduled-reaper-wrong-config-prefix-2026-06-09
+source_type: error-note
+status: raw
+related_branches: [feature-rate-limit-idempotency-contract]
+related_projects: [ca-skeleton]
+tags: [error, ca-skeleton, spring, scheduling, configuration]
+created: 2026-06-09
+status_label: resolved
+---
+
+# error: scheduled-reaper-wrong-config-prefix-2026-06-09
+
+> Layer: `raw/errors/` — 코드 리뷰(ca-quality-reviewer)가 잡은 silent config 키 불일치.
+
+## Parent / 부모
+
+- [[raw/branch-notes/feature-rate-limit-idempotency-contract]]
+
+## 증상 / Symptom
+
+`IdempotencyReaper`의 `@Scheduled(fixedDelayString = "${ca-skeleton.rate-limit.reaper-interval:PT10M}")`가
+**잘못된 prefix**(`rate-limit`)를 참조. 실제 바인딩 속성은 `ca-skeleton.idempotency.reaper-interval`
+(`IdempotencyProperties` 소유). 컴파일/테스트는 통과하지만 운영자가 `ca-skeleton.idempotency.reaper-interval`을
+조정해도 무시되고 항상 하드코딩 기본값 `PT10M`로 동작. `IdempotencyProperties.reaperInterval`은 dead letter.
+
+## 원인 / Root cause
+
+`@Scheduled` SpEL placeholder는 키가 없으면 inline default(`:PT10M`)로 **조용히** 폴백 →
+오타/잘못된 prefix가 런타임 예외 없이 묻힘. 빌드 게이트가 placeholder–property 정합을 검증하지 않음.
+
+## 해결 / Resolution
+
+`@Scheduled` 표현식을 `${ca-skeleton.idempotency.reaper-interval:PT10M}`로 수정. 정적 테스트로는
+잡기 어려워 코드 리뷰 단계에서 포착됨(테스트는 `reap()` 반환값만 검증, 스케줄 wiring 미검증).
+
+## 교훈 / Lesson
+
+`@Scheduled(...:default)` / `@Value(...:default)` 처럼 **inline default가 있는 placeholder는
+오타가 silent**. 같은 의미의 값이 두 곳(property record + 어노테이션 문자열)에 있으면 drift 위험.
+가능하면 단일 출처(설정 record 주입)로 통일하거나, 키 정합을 검증하는 테스트를 둔다.
+관련: [[raw/branch-notes/feature-rate-limit-idempotency-contract]]