2nd/10_Wiki/Topics/AI/Discriminated-Unions-for-Error-Handling.md

id, category, confidence_score, tags, last_reinforced

id	category	confidence_score	tags	last_reinforced
TS-UNION-001	10_Wiki/💡 Topics/AI	1.0	typescript type-system functional-programming error-handling	2026-04-26

Discriminated Unions (판별 가능한 유니온)

📌 한 줄 통찰 (The Karpathy Summary)

"타입 가드를 자동화하는 영리한 리터럴 태그" — 공통된 속성(Tag)을 기준으로 여러 타입을 하나로 묶고, 코드 레벨에서 안전하게 특정 타입을 식별해낼 수 있게 하는 타입 설계 기법.

📖 구조화된 지식 (Synthesized Content)

• 추출된 패턴: 여러 객체 타입이 공통적으로 가지는 '태그(Literal property)'를 사용하여 컴파일러가 조건문(switch, if) 내에서 타입을 정확히 좁힐 수 있도록 돕는 패턴.
• 세부 내용:
  • Tag/Kind 속성: 각 타입에 고유한 문자열 리터럴 속성을 부여하여 구분의 근거를 마련.
  • Exhaustiveness Check: switch 문에서 모든 가능한 케이스를 처리했는지 TypeScript 컴파일러가 확인하게 함.
  • Error Handling: Success와 Failure 타입을 유니온으로 묶어 런타임 에러 대신 컴파일 타임에 예외 처리를 강제.
  • Pattern Matching: 함수형 언어의 패턴 매칭과 유사한 안정성을 객체 지향 환경에서 구현.

⚠️ 모순 및 업데이트 (Contradictions & RL Update)

• 과거 데이터와의 충돌: instanceof나 임의의 속성 체크 기반의 불안정한 타입 가드에서, 명시적인 '태그' 기반의 선언적 타입 가드로 표준화됨.
• 정책 변화: Antigravity 에이전트의 통신 프로토콜 정의 시, 메시지 타입을 Discriminated Unions로 정의하여 파싱 오류를 원천 차단함.

🔗 지식 연결 (Graph)

• Parent: 10_Wiki/💡 Topics/AI
• Related: Type-Guards, Algebraic-Data-Types, Exhaustiveness-Checking
• Raw Source: 10_Wiki/Topics/AI/Discriminated-Unions-for-Error-Handling.md