# KBX Foundation v33 Validation Report

## 1. 실행 명령

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

## 2. 최종 결과

**PASS**

주요 결과:

- TypeScript/Vue syntax transpile: **293 units PASS**
- Screen Governance: **20 screens PASS**
- Component Manifest: **84 components PASS**
- Component Catalog: **56 entries / 34 core APIs PASS**
- Navigation Manifest: **16 entries PASS**
- Design Tokens: **143 PASS**
- Field Governance: **51 canonical fields PASS**
- API Governance: **66 operations / 7 problem types PASS**
- Authorization: **54 permissions / 51 used / 5 sensitive PASS**
- Integration Governance: **3 integrations / 4 scenarios PASS**
- Migration Safety: **16 migrations PASS**
- Test Governance: **27 scenarios / 16 fixture sets / 37 refs / golden 10/10 PASS**
- Design Debt Ratchet: **268 <= 268 PASS**
- Release Impact: **required major / declared major PASS**
- Tracked contract changes from baseline: **218**

## 3. Template/Navigation 누적 Gate

- v29 PASS
- v30 PASS
- v31 PASS
- v32 PASS
- **v33 PASS**

v33 Gate 확인 항목:

1. `idle` state contract
2. T01~T09 `stateCapabilities`
3. Template idle recovery action
4. Permission Host provider/injection
5. Screen-level permission block
6. Command/Workflow/Bulk permission filtering
7. T09 permission boundary
8. Golden/Reference initial-state adoption
9. Home failed/urgent attention
10. Preference v3 bounded migration
11. Workspace URL length/control-character rejection
12. Component manifest/catalog version/state scenario

## 4. 기존 계약 회귀 확인

다음 기존 Gate도 모두 PASS했다.

- T01~T09 Template completeness
- Runtime Template Type Guard
- SearchPanel renderer de-duplication
- Grid productivity
- T04/T05 Golden behavior
- Record lifecycle
- Application shell
- Workspace multi-instance/pinning/focus
- Route capability recovery
- Recent route hardening
- Component catalog
- Design/Figma parity
- Release governance

## 5. 실행하지 않은 범위

이번 환경에서 다음을 실행했다고 주장하지 않는다.

- 실제 .NET 10 API host 기동
- 실제 PostgreSQL/Npgsql 연동
- Hangfire/SignalR 실서비스 연계
- Vitest 전체 runtime test suite
- Playwright browser E2E

Unit/E2E 소스는 보강했지만 최종 보증은 별도 CI/실행환경에서 수행해야 한다.

## 6. 잔여 기술부채

Design Debt ratchet은 268로 유지되었다. 신규 hard-coded literal 증가는 없다.

다음 우선 후보는 기존 debt가 큰 컴포넌트다.

- `KbxExcelImport`
- `KbxExceptionDetailDrawer`
- `KbxLookupDialog`
- `KbxAiAssistant`
- WMS Barcode Capture

다음 단계에서는 화면 수를 늘리기보다 이 공통 컴포넌트의 상태/토큰/테스트 품질을 먼저 줄이는 편이 효과적이다.