2nd/01_Archive/MERGED/2026-05-08/10_Wiki/Topics/AI/Excess-Property-Checking.md

id, title, category, status, canonical_id, aliases, duplicate_of, source_trust_level, confidence_score, tags, raw_sources, last_reinforced, github_commit, inferred_by, tech_stack

id	title	category	status	canonical_id	aliases	duplicate_of	source_trust_level	confidence_score	tags	raw_sources	last_reinforced	github_commit	inferred_by	tech_stack
wiki-2026-0508-excess-property-checking	Excess Property Checking	10_Wiki/Topics	needs_review	self	P-Reinforce-AI-TS-EXCESS-PROPERTITY	none	A	1.0	TypeScript Programming TypeSafety ErrorHandling		2026-04-20	pending	Claude Opus 4.7 (auto-normalize 2026-05-08)	language framework unspecified unspecified

Excess-Property-Checking (잉여 속성 체크)

📌 한 줄 통찰 (The Karpathy Summary)

"너 정체가 뭐야? 시키지 않은 건 하지 마." 객체 리터럴을 변수에 할당하거나 함수 인자로 전달할 때, 정의되지 않은 추가 속성이 포함되어 있으면 타입 에러를 발생시켜 오타나 실수(Mistyping)를 방지하는 TypeScript의 안전장치다.

📖 구조화된 지식 (Synthesized Content)

• Object Literal Restriction: 변수에 미리 담지 않고 직접 {...} 형태로 넘길 때만 발동함.
• Structural Typing Exception: TypeScript는 기본적으로 구조적 타이핑을 따르지만, 리터럴 할당 시에는 '엄격한 타입 일치'를 요구하여 버그를 줄임.
• Bypassing Methods:
  • 변수에 할당 후 전달.
  • 타입 단언(as AnyType) 사용.
  • 인덱스 시그니처([key: string]: any) 추가.

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

• 이 기능은 때때로 "덕 타이핑(Duck Typing)이라며 왜 안 돼?"라며 초보자들을 당황하게 만든다. 하지만 이는 리터럴 객체 생성 시 발생할 수 있는 오타(예: colour vs color)를 런타임 이전 단계에서 원천 봉쇄하기 위한 의도적인 설계다.

🔗 지식 연결 (Graph)

• Related: Structural-Typing-vs-Nominal-Typing , TypeScript-Best-Practices
• Concept: Type-Guard

🤖 LLM 활용 힌트 (How to Use This Knowledge)

언제 이 지식을 쓰는가:

• (TODO)

언제 쓰면 안 되는가:

• (TODO)

🧪 검증 상태 (Validation)

• 정보 상태: needs_review
• 출처 신뢰도: A
• 검토 이유: (P-Reinforce Phase 1 자동 정규화. 본문 검증 필요.)

🧬 중복 검사 (Duplicate Check)

• 기존 유사 문서: (TODO: 인덱서 클러스터 리포트 참조)
• 처리 방식: UPDATE (자동 정규화)
• 처리 이유: Phase 1 정규화 — 옛 템플릿/누락 필드 보강.

🕓 변경 이력 (Changelog)

날짜	변경 내용	처리 방식	신뢰도
2026-05-08	P-Reinforce Phase 1 정규화 (frontmatter + 헤더 표준화)	UPDATE	A

💻 코드 패턴 (Code Patterns)

패턴 1: (TODO: 이 프로젝트 컨벤션 반영한 구조 스켈레톤)

# TODO

🤔 의사결정 기준 (Decision Criteria)

선택 A를 써야 할 때:

• (TODO)

선택 B를 써야 할 때:

• (TODO)

기본값:

(TODO)

❌ 안티패턴 (Anti-Patterns)

• [안티패턴]: (TODO: 무엇을 하면 안 되는가 + 이유 + 대신 무엇을)