Files
KArtSell.Aegis/docs/Design/kbx-foundation-v36

KBX Foundation v36 — Recipe Verification · Generated Test Plan · Deterministic Home Workbench

KBX v36는 v35의 Screen Recipe / Secure Scaffolder 기반을 실제 검증계약까지 닫는 Foundation iteration이다. 목표는 화면·컴포넌트 수를 더 늘리는 것이 아니라, T01~T09를 선택한 순간부터 표준 UX, 보안, 복구, 테스트 증적이 함께 따라오도록 만드는 것이다.

v36 핵심

  • T01~T09 testProfile 추가
    • 필수 Scenario Kind
    • 필수 Behavioral Tag
    • 필수 Evidence
    • 필수 Recovery/Interaction Check
  • generated/screen-recipe-verification-manifest.json 추가
  • T01~T09 Recipe Verification 9/9 자동 폐쇄성
  • 각 Recipe는 실제 해당 Template을 사용하는 Screen의 Canonical E2E Scenario를 최소 1개 요구
  • T02 Master / T06 Queue / T07 Reconcile Canonical E2E Recovery Scenario 추가
  • Scaffolder가 신규 Vertical Slice에 *.test-plan.ts 자동 생성
  • 생성 Test Plan은 Canonical Scenario / Required Check / Required Evidence를 타입 계약으로 보존
  • 기존 Master / Transaction / Fast Entry의 명시적 --write-permission fail-closed 정책 유지
  • Home Attention Queue를 동일 우선순위 내 최신 발생 순으로 정렬
  • Home은 표시 상한과 별개로 권한 필터 후 실제 전체 건수 및 overflow를 정확히 표시
  • buildKbxHomeAttentionQueue() public API 추가, 기존 buildKbxHomeAttention() 호환 유지
  • Screen Recipe testProfile / canonicalScenarioIds 변경을 Release Impact에서 추적
  • Design Debt ratchet 131 유지

검증

node scripts/validate-kbx.mjs

최종 검증 기준:

  • 299 TS/Vue script units
  • 20 Screen Definitions
  • 84 Component Definitions
  • 66 Component Catalog entries
  • 153 Design Tokens
  • 9 Screen Recipes
  • 30 Canonical Test Scenarios
  • Recipe Verification 9/9
  • 16 Navigation Entries
  • Design Debt 131 <= 131
  • Release Impact major / major

문서

  • docs/screen-recipe-verification-home-attention-v36.md
  • docs/kbx-v36-standard-traceability.md
  • docs/validation-report-v36.md
  • docs/release/migration-guide.md