llm-wiki/vault/10-projects/errors/ca-tmpl-preexisting-check-baseline-failures-2026-07-20.md

title, source_type, status, related_branches, related_projects, tags, created, status_label

title	source_type	status	related_branches	related_projects	tags	created	status_label
error / ca-tmpl-preexisting-check-baseline-failures-2026-07-20	error-note	raw	chore-harness-policy-engine-alignment	ca-skeleton	error ca-skeleton testing build-tooling	2026-07-20	open

error: ca-tmpl-preexisting-check-baseline-failures-2026-07-20

Layer: raw/errors/ — 하네스 구현 검증 중 확인한 HEAD-identical production baseline 실패 기록.

부모

• raw/branch-notes/chore-harness-policy-engine-alignment

증상

• 에러 메시지 (원문 그대로):

  CleanArchitectureTest.PERSISTENCE_RDBMS_ENTITIES_DO_NOT_PIN_VENDOR_COLUMN_DEFINITIONS
  'if' construct must use '{}'s. [NeedBraces]
  

• 발생 컨텍스트: focused CleanArchitectureTest, ./gradlew check, app-bootstrap test 제외 check.
• 발생 시점: 2026-07-20 KST
• 발생 환경: local
• 재현 가능 여부: always

재현 절차

1. cd src && ./gradlew :app-bootstrap:test --tests '*CleanArchitectureTest' --console=plain
2. cd src && ./gradlew check -x :app-bootstrap:test --console=plain
3. 기대: 모두 PASS. 실제: JPA vendor column definition 1건과 domain NeedBraces 3건으로 각각 FAIL.

조사 단계

• 2026-07-20 — git diff HEAD --로 failing entity/test/domain files를 대조 → 모두 working-tree diff 없음.
• 2026-07-20 — git show HEAD:로 columnDefinition = "char(64)"와 enforcing ArchUnit rule 확인 → 하네스 변경 이전 baseline임을 확인.
• 2026-07-20 — app-bootstrap test 제외 check 실행 → Page.java, User.java, FeedItem.java의 별도 Checkstyle 실패 확인.

근본 원인

• 직접 원인: IdempotencyRecordEntity.requestHash가 vendor SQL char(64)를 annotation에 고정했고 domain 세 파일의 단일-line if가 NeedBraces rule과 충돌한다.
• 근본 원인: 현재 HEAD 자체가 architecture/checkstyle guardrail과 정합하지 않다.
• 트리거 조건: 전체 architecture test 또는 Checkstyle task 실행.

근거

• raw/branch-notes/chore-harness-policy-engine-alignment §검증 결과 — 실행 명령, 범위 분리, review verdict.

해결

• 적용한 조치: 본 harness branch에서는 production 파일을 수정하지 않고 실패를 범위 밖 baseline으로 분리했다.
• 검증 방법: failing files의 git diff HEAD가 비어 있음을 확인했다.
• 잔여 위험 / 후속 작업: persistence mapping/migration 정합과 domain brace 수정을 별도 production-fix branch에서 수행하고 전체 check를 재실행해야 한다.

회고

• 빨리 감지하는 신호: dependency verifier PASS 뒤 focused ArchUnit와 Checkstyle가 별도로 FAIL할 수 있다.
• 예방 체크리스트 항목 후보: harness change 전 baseline check 결과를 캡처하고 diff-caused와 HEAD-identical failure를 분리한다.
• wiki로 끌어올릴 가치: baseline-aware verification과 diff identity 구분 패턴.

관련

• raw/branch-notes/chore-harness-policy-engine-alignment