Unity 인식 handoff와 도트 UI/스프라이트 개선

[SilverSupplier]

작업 범위

• 외부 입력/인식 계층과 Unity 게임 런타임 사이의 handoff 경계를 추가했습니다.
• Recognition 폴더에 base/overlay recognizer 인터페이스와 heuristic 구현, SpellRecognitionHandoff DTO를 추가했습니다.
• SpellCastingService와 ExamGameController에 handoff 처리 경로를 붙이고, overlay no active seal / detached overlay / duplicate / stack full 실패를 구분했습니다.
• 명시적 targetSealId가 있는 overlay handoff는 해당 seal이 만료/누락되면 다른 seal로 fallback하지 않도록 고정했습니다.
• SpellRecognitionHandoff의 nullable recognized 값은 Unity 직렬화가 가능한 backing field + nullable property 형태로 정리했습니다.
• 엔딩 리포트에 base/overlay 성공·실패, duplicate/stack full/detached/no seal, 힌트 표시, 힌트 후 성공, 층별 완료 요약을 확장했습니다.
• Resources/Sprites에 32x32 도트 sprite pack을 추가하고, PNG sprite/Texture2D fallback loading과 runtime tint를 보강했습니다.
• HUD, Magic Note, Ending Report 패널을 픽셀 UI 톤으로 다듬고, 성공/실패/위험 접촉/층 완료 toast 피드백을 추가했습니다. Toast는 HUD와 겹치지 않도록 top-right에 배치했습니다.
• 1~5층별 floor palette와 장식 구성을 분리하고, 4층 균열층과 5층 성좌심 final seal 연출을 강화했습니다.

팀원 확인 포인트

• sw1029 입력/인식 계층은 SpellRecognitionHandoff.Base(...) / SpellRecognitionHandoff.Overlay(...)를 통해 Unity 런타임에 결과를 넘기면 됩니다.
• overlay 실패가 no seal, detached, duplicate, stack full로 분리되어 Magic Note/Ending Report에 기록되는지 확인 부탁드립니다.
• 외부 adapter가 targetSealId를 넘긴 경우에는 최신 active seal snapshot 기준으로 보내야 합니다. stale id는 다른 seal에 붙지 않고 no active seal 피드백으로 돌아갑니다.
• 4층은 hazard stabilizer 목표가 안전 지점을 앞으로 당기는 흐름이고, 5층은 5/6 통과 엔딩에서 6/6 진엔딩으로 업그레이드 가능한 흐름입니다.
• 새 sprite pack은 Resources/Sprites/<PixelSpriteKind>.png 경로를 우선 사용하고, 누락 시 기존 procedural sprite fallback이 유지됩니다.
• UI/비주얼 변경이 크므로 실제 플레이에서 HUD/Magic Note/toast가 목표 라벨이나 final seal을 가리지 않는지 확인 부탁드립니다.

검증

• git diff --cached --check: 통과
• Unity EditMode: 54/54 Passed
• Unity PlayMode: 19/19 Passed
• Windows build: Succeeded, 0 errors, 0 warnings
• docs validation: validated 0 task documents against work queue
• player smoke: MagicExamHall.exe -batchmode -nographics 초기화 확인, sprite tiling 경고 없음

비고

• PR base는 main, head는 SilverSupplier:codex/unity-handoff-sprite-ui-polish입니다.
• 최종 로컬 정리를 쉽게 하려고 stack 없이 단일 브랜치/단일 커밋으로 정리했습니다.
• 테스트 XML은 생성 후 삭제했고, Unity 로그/빌드 산출물은 커밋 범위에서 제외했습니다.
• npm test/build는 이번 Unity 런타임/문서 범위와 직접 관련이 없어 실행하지 않았습니다.