# KBX v12 Validation Report

## Static/Foundation validation

`node scripts/validate-kbx.mjs` 결과:

```text
Screen Definitions           16
Component Definitions        61
Core Design Components       34
Component Catalog Entries    35
Design Tokens                55
Navigation Entries           12
TS/Vue Script Units         202
Database Migrations           8

Screen Manifest             PASS
Component Manifest          PASS
Navigation Manifest         PASS
Generated Screen Registry   PASS
Screen Governance           PASS
Scaffolder Contract         PASS
TypeScript Syntax           PASS
Architecture Guard          PASS
Operations Guard            PASS
Process Coverage            PASS
Production Readiness        PASS
Application Shell           PASS
Component Catalog           PASS
Design-Code Parity          PASS
Design Debt Ratchet         PASS
Release Impact              PASS
Release Governance          PASS
```

## Design debt baseline

v12에서 기존 hardcoded CSS literal을 일괄 리팩토링하지 않고 현재 수치를 baseline으로 채택했다.

```text
raw color / dimension literals: 567
policy: ratchet-only
```

신규 변경은 이 수치를 증가시킬 수 없다. 기존 파일의 부채는 Component 리팩토링 시 단계적으로 감소시킨다.

## Release impact

```text
Baseline                v11
Declared change level   patch
Required change level   none
Public contract changes 0
```

v12는 public KBX Screen/Component/Token contract를 의도적으로 변경하지 않고, Design↔Code 및 Release governance를 도입한 baseline-adoption iteration이다.

## Host repository에서 추가로 실행할 필수 Gate

현재 Foundation artifact는 전체 dependency lockfile/실제 브라우저/실제 .NET solution을 포함한 최종 제품 저장소가 아니다. Host Repository에서는 다음을 반드시 실행한다.

```text
pnpm install --frozen-lockfile
vue-tsc
Vitest
Vite production build
Playwright keyboard E2E
Playwright visual regression: compact / comfortable / touch

.NET 10 restore/build
xUnit
DbUp migration dry-run / integration test
PostgreSQL integration tests
```

Figma 실제 Library 동기화는 `design/figma/*.contract.json`을 기준으로 별도 연결한다. 이 artifact는 Figma node id나 특정 파일에 종속되지 않는다.
