Files
document-haness/docs/clean-architecture-backend-template/tech-log-studio/runtime-contract-correctness/case/case-messaging-claim-check-f03.md
T
DongHyeonkaandClaude Fable 5.1 b25357c48a docs(clean-architecture-backend-template): fold analysis into final and re-select one topic
- analysis/·source-index·state.json 을 final/document.md 제2부·제3부로 접었다. SSOT 는 하나다
- 파일럿 — commit-ambiguity-as-a-result 를 새 기준으로 재선별. 후보 14 → 글감 5
  (PROMOTE 5 · MERGE_INTO 3 · KEEP_IN_SSOT 4 · 보류 2). 기록 5건을 다시 썼고 그림 1개를
  techviz 로 만들었다
- 재선별이 잡은 것: 제1부 §6.2·§11.1 이 자기 §13.2 와 어긋나 있었다(레인을 안 돌렸다 vs
  돌렸다) — 정정. 이미 답이 나와 있던 Question 을 HEAD 재실행 질문으로 다시 세웠다.
  Concept 이 인용한 코드가 SSOT 에 없어 뺐다
- candidateScope·sourceRepository 기록. 나머지 43개 주제는 재선별 대기(PENDING 905)

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
2026-09-07 12:39:20 +09:00

3.2 KiB

kind, slug, title, topic, project, status, sourceRevision, rootTreeNode, evidenceCapturedOn, assets, evidence, source, module, priority
kind slug title topic project status sourceRevision rootTreeNode evidenceCapturedOn assets evidence source module priority
CASE messaging-claim-check-f03 예외 승격이 에러 코드 문자열 접미사에 의존한다 runtime-contract-correctness clean-architecture-backend-template 게시 전 21234e38cdb9a926cbc92bb97a2aee2e4a7d2916 case:messaging-claim-check-f03 2026-09-01
key file
messaging-claim-check-f03 ../../../final/evidence/rendered/messaging-claim-check-f03.svg
../../../final/evidence/raw/messaging-claim-check-f03.txt
원본 분석 절은 final/document.md#a19-messaging-claim-check#L525 이다.
messaging-claim-check P3

예외 승격이 에러 코드 문자열 접미사에 의존한다

ClaimCheckResolver.verify가 validation.failure().code().endsWith("_MISMATCH")로 ClaimCheckIntegrityException 승격을 결정한다. ClaimCheckIntegrityGuard의 세 코드 중 둘이 그 접미사를 갖는다.

관계

  • leaf의 각 public 클래스는 자기 레인에 테스트를 갖는다 같은 분석 리프에서 끌어낸 규칙이다.
  • 같은 튜닝 값이 두 계층에 있으면 어느 쪽이 이기는지 정한다 같은 분석 리프에서 끌어낸 규칙이다.

문제

ClaimCheckResolver.verify가 validation.failure().code().endsWith("_MISMATCH")로 ClaimCheckIntegrityException 승격을 결정한다.

ClaimCheckIntegrityGuard의 세 코드 중 둘이 그 접미사를 갖는다.

결론

두 클래스 사이의 계약이 문자열 명명 규약이고 어디에도 선언되지 않았다.

guard가 코드를 바꾸면(예: CLAIM_CHECK_DIGEST_INVALID) 승격이 조용히 멈추고 poison message가 PERMANENT_BUSINESS로 분류된다 — 재시도 정책이 달라진다.

검증 환경

OpenJDK : 21.0.12 java -version 으로 확인 Gradle : 9.0.0 src/gradle/wrapper/gradle-wrapper.properties 의 distributionUrl 로 확인 확인 방식 : ClaimCheckResolver 참조 8건 검색과 승격 조건이 보는 문자열 접미사 및 guard 의 코드 집합 대조 소스 수정 : x

재현 조건

원문은 final/document.md#a19-messaging-claim-check#L525 에 있다.

본문

ClaimCheckResolver.verifyvalidation.failure().code().endsWith("_MISMATCH")ClaimCheckIntegrityException 승격을 결정한다. ClaimCheckIntegrityGuard의 세 코드 중 둘이 그 접미사를 갖는다.

ClaimCheckResolver 참조 위치

:::evidence key="messaging-claim-check-f03" alt="코드베이스에서 ClaimCheckResolver 를 검색한 출력 8줄. 이 기록이 세는 참조가 그 출력에 그대로 보인다." caption="ClaimCheckResolver 코드베이스 검색 — 8줄 · exit 0" zoom="true" :::

두 클래스 사이의 계약이 문자열 명명 규약이다

어디에도 선언되지 않았다. guard가 코드를 바꾸면(예: CLAIM_CHECK_DIGEST_INVALID) 승격이 조용히 멈추고 poison message가 PERMANENT_BUSINESS로 분류된다 — 재시도 정책이 달라진다.

확인하지 못한 것

guard 의 코드를 바꿔 승격이 조용히 멈추는 것을 재현하지 않았다. 두 클래스 사이의 계약이 문자열 명명 규약이라는 코드 형태로 판정했다.