# KBX v32 Validation Report

## 검증 명령

```bash
node scripts/validate-kbx.mjs
```

## v32 전용 Gate

`validate-template-navigation-v32.mjs`가 다음을 확인한다.

- `KbxSummaryItem`, `KbxQuickFilterItem` 공통 계약
- ScreenFrame의 Page Header / Command Bar Surface 식별자
- T01 Quick Filter/Summary first-class composition
- T03 Summary first-class composition
- T04 Validation/Summary first-class composition
- T05 Summary 및 Master/Detail/History Surface
- T06 Work Summary/Exception Counter first-class composition
- T07 Criteria/Summary/Comparison/Resolution Surface
- T08 Import file/mapping/validation/result Surface
- T09 Mobile Header/Network/Instruction/Sticky Action Surface
- Home Pinned 우선순위와 Favorite Toggle
- Home 화면별 열린 Workspace 건수 표시
- Global Header/Home/SideNav Ctrl+K 접근성 metadata
- SideNav Favorite `aria-pressed`
- Golden Screen의 신규 Template API 실제 사용
- Validation/Exception Summary의 Design Token normalization
- 변경 Component SemVer 갱신

## 호환성

Backend API, Permission, PostgreSQL Migration, Outbox/Inbox, Hangfire, Domain Validation 계약에는 v32에서 새 breaking 변경을 추가하지 않았다.

T01/T03/T04/T05/T06의 신규 props는 기존 Slot API를 제거하지 않는 additive contract다. Custom 화면은 기존 Slot을 그대로 사용할 수 있다.

## 검증 범위

전체 Gate는 API, Authorization, Integration, Provider, External Data, Configuration, Migration Safety, Deployment, Telemetry, Experiment, Test Governance, Scaffolder, TypeScript/Vue syntax, Architecture, Operations, Production Readiness, Application Shell, T01~T09 Template, Interaction, Grid Productivity, Golden T04/T05, Record Lifecycle, v29/v30/v31/v32 Navigation, Component Catalog, Design/Figma parity, Release Governance를 포함한다.

## 최종 실행 결과

- TypeScript/Vue 정적 구문 검증: **291 units PASS**
- Screen Definition: **20개 PASS**
- Component Definition: **84개 PASS**
- Navigation Entry: **16개 PASS**
- Component Catalog: **56 entries / 34 core APIs PASS**
- Design Token 생성: **143 tokens PASS**
- Design Debt Ratchet: **268 <= 268 PASS** (`hex 9`, `px 259`)
- Release Impact: **required major / declared major PASS**
- Release Governance: **major PASS**
- Release 분석 tracked changes: **216**

이 보고서의 PASS는 저장소에 포함된 Node 기반 정적/계약/Governance Gate 실행 결과를 뜻한다. 실제 브라우저 Playwright 실행, .NET 10 런타임, PostgreSQL/Npgsql 연동 실행까지 수행했다는 의미는 아니다.
