# KBX v29 Validation Report

## 자동 검증 명령

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

## 검증 범위

- Design Token generation / Figma variable parity
- API / Problem / Integration / Provider / External Data contracts
- Configuration / Migration Safety / Deployment governance
- Authorization / Sensitive Data / Telemetry / Experiment governance
- Canonical test scenarios / fixtures
- Screen / Component / Navigation manifests
- TypeScript/Vue script syntax transpile
- Architecture / Operations / Process coverage
- Production readiness guard
- Application Shell
- T01~T09 Template completeness
- Interaction contracts
- Grid productivity
- T04/T05 Golden contracts
- T02/T03 Record lifecycle
- v29 Template Runtime / Global Utility / Home Navigation / Workspace Security
- Component Catalog
- Design-code parity
- Release governance

## 최종 수치

- Design Tokens: **134**
- Component Definitions: **81**
- Core Component APIs: **34**
- Component Catalog Entries: **53**
- Screen Definitions: **20**
- Navigation Entries: **16**
- API Operations: **66**
- Permissions: **54**
- Canonical Fields: **51**
- Canonical Test Scenarios: **25**
- Fixture Sets: **16**
- Fixture Refs: **37**
- Golden Screen Coverage: **10 / 10**
- TypeScript/Vue Script Units: **286**
- DB Migrations: **16**
- Design Debt: **294**

## v29 전용 검증

`validate-template-navigation-v29.mjs`가 다음을 검증한다.

- T01~T09 runtime/density/utility/accessibility metadata
- T01~T08 Runtime State Boundary 적용
- T09 Runtime State + Help Host
- Screen Frame Global Utility Host
- Home Quick Start dedupe/order policy
- preference scope 변경 시 Workspace Session isolation
- permission 변화에 따른 tab pruning
- safe recent path resolution
- max tab LRU enforcement + Dirty/Pinned 보호
- Menu Search combobox/listbox/focus trap
- Shell notice와 dismiss contract
- 주요 Golden Page의 실제 runtime-state adoption

## Runtime validation boundary

현재 artifact 환경에는 다음 실행 인프라가 보장되지 않는다.

- .NET SDK
- 실행 PostgreSQL/API
- 설치된 pnpm/node_modules
- Playwright browser runtime

따라서 다음을 실제 완료했다고 주장하지 않는다.

- ASP.NET Core compile/runtime
- PostgreSQL migration execution
- Vitest runtime execution
- Playwright browser execution

반면 Node 기반 KBX Governance Gate와 286개 TypeScript/Vue script unit syntax transpile은 실제 실행하여 PASS했다.
