refactor(core): 인증·계정 예외 6종을 CoreAuthFailure sealed 루트로 압축 (#934 1·2단계) [base: develop]

[OnlyReadOneBook]

#934 의 1·2단계만 담는다. 4-A(수신자)·4-B(애프터노트)는 모듈이 갈려 별도 PR 로 올린다 — 이슈는 닫지 않는다.

무엇을

core:domain 에 흩어져 있던 예외 5개와, onboarding·setting presentation 에 이름·구조가 같은 채로 두 벌 있던 UserCancelledAuthException 을 CoreAuthFailure sealed 루트 하나로 모았다. 파일 7개 → 1개.

묶기만 하지 않았다

이슈가 지적한 대로 소비처를 루트로 좁혔다. OnboardingFailureMessage(5개 중 3개만 분기) 와 LoginViewModel(5개 중 2개만 분기) 은 when 의 subject 가 Throwable 이고 else 를 달고 있어 sealed 로 묶어도 exhaustiveness 이득이 0 이었다. 루트로 좁혀 사유가 늘면 컴파일러가 두 소비처를 잡는다.

기존 else 로 흘려보내던 케이스의 문구는 바꾸지 않았다 — 동작 무변경이다. 폴백이 뜻하는 건 "사유 미확인" 이 아니라 "이 화면에서 줄 전용 문구 없음" 이고, 자격 거절·인증번호 무효·인증 취소 셋은 각각 입력 필드 인라인·무시로 이 함수 밖에서 갈리므로 여기 쓸 문구가 정의된 적이 없다.

판단해서 정한 것

• message 를 6종 모두 정적 진단 문구로 통일하고 루트 생성자 파라미터를 String? → String 으로 좁혔다. NetworkUnavailable 만 null 이라 규칙이 둘이었던 것을 맞춘 것으로, 기본 생성에 맡길 때 cause.toString() 의 영문 기술 원문이 message 가 되는 것을 막는다는 목적은 그대로다. 규약을 KDoc 이 아니라 타입으로 강제해 하위 타입이 빠뜨릴 수 없게 했다.
  • 대신 .message 를 화면에 싣지 않는다는 규약을 루트 KDoc 에 명시했다. .message ?: 폴백 프로덕션 소비처 3곳(LoginEntry 2, ReceiverMindRecordViewModel 1)에 이 예외들이 닿지 않는 것은 실측 확인.
• UserCancelledAuth 의 기본 메시지 2종("사용자가 로그인을 취소했습니다"/"인증을 취소했습니다")은 소비처가 전부 타입만 보고 갈라내 아무도 읽지 않는 것을 확인하고 하나로 합쳤다. onboarding 쪽에만 있던 존재 이유(코루틴 CancellationException 과 구분해 구조적 동시성을 깨뜨리지 않기 위함)는 루트 KDoc 으로 옮겼다.
• 주석 정리 동반 — 계정·인증 매퍼 3파일에서 BE 계약을 복제한 서술(서버 code 의미·엔드포인트·2026-07-30 실기기 logcat 같은 관측 날짜)과 과거 수정 이력을 걷었다. ApiException 이 IOException 을 상속해 when 순서가 곧 의미라는 함정 경고는 남겼다.

검증

게이트	결과
:app:compileDebugUnitTestKotlin	green
:app:compileDebugAndroidTestKotlin (#949 신설)	green
전 모듈 ktlintCheck	green
:core:data · :feature:onboarding:presentation · :feature:setting:presentation testDebugUnitTest	green (failures 0)

시각 검증 해당 없음 — 리소스·디자인 토큰 변경 0. Compose 파일은 ConnectedAccountsScreen.kt 하나가 바뀌었으나 import 와 if (e !is CoreAuthFailure.UserCancelledAuth) 타입 체크 한 줄이라 렌더 결과가 동일하다. baseline 사이클 미실행.

리뷰어에게

• AfternoteFailureReporting.kt 를 4-A PR 도 건드린다. 여기선 백틱 주석 안 심볼명 치환이고, 4-A 는 그 문단을 통째로 지운다. 순차 머지 시 뒤쪽이 리베이스 한 번 필요하고 해결은 "삭제 채택" 이다.
• 남은 범위 2건은 이 PR 밖이다 — fix(setting): 수신인 입력 검증 및 오류 처리 개선 (#577) #771 의 ReceiverRequestRejectedException 편입은 그 PR 소관, "ApiException → 도메인 sealed 번역 지점 매퍼 정리" 는 같은 파일을 건드리는 refactor(afternote): data/mapper 명명·배치 정리 — 같은 방향 매핑이 파일 3개·함수명 2종으로 갈림 #932 로 이관 제안.