Files
KArtSell.Aegis/scripts/validate-kbx-exceptions.mjs
kjh2064 31b36ba226 V13-FE-005: consolidate approved UI governance and contract hardening
Consolidates KBX UI Boundary Governance framework with component manifest,
screen recipe registry, AI component gate, and exception lifecycle validation.

Evidence (evidence/V13-FE-005/*.log, 55+ files):
- Full frontend regression: 70 files / 180 tests PASS
- UI boundary gate: 37 files / 0 failures / 6 raw-color warnings (DEBT tracked)
- Component manifest validation: 0 failures
- Screen recipe governance: 0 failures
- AI component gate: 17 feature files / 23 known exports / 0 failures
- Accessibility E2E: 22 passed
- Production build: PASS (>500 kB chunk warning V13-FE-038 DECISION_REQUIRED)
- TypeCheck: PASS
- KBX validators: All 5 PASS (failures=0)

Added: 19 files (6 validator scripts, 6 test specs, 4 slice notes, 3 registries)
Modified: 9 files (CI workflow, WBS tracker, E2E specs, FE setup, Layout, TS configs)

Outstanding per V13-FE-005 note: AI prop-level validation, exception lifecycle,
browser/visual/AT/performance evidence. No completion overclaim.

AGENTS.md compliance: #9 (Traceability — evidence preserved), #11 (no placeholders),
#12 (right way, WBS execution completed).

Co-Authored-By: Claude Haiku 4.5 <noreply@anthropic.com>
2026-08-14 10:35:15 +09:00

25 lines
1.2 KiB
JavaScript

import fs from 'node:fs'
import path from 'node:path'
const root = path.resolve(process.argv[process.argv.indexOf('--root') + 1] ?? 'frontend')
const registryPath = path.join(root, 'src', 'shared', 'ui', 'kbx-exception-registry.json')
const failures = []
const today = new Date().toISOString().slice(0, 10)
if (!fs.existsSync(registryPath)) failures.push('missing exception registry')
else {
const registry = JSON.parse(fs.readFileSync(registryPath, 'utf8'))
const ids = new Set()
for (const item of registry.exceptions ?? []) {
if (ids.has(item.id)) failures.push(`duplicate exception ${item.id}`)
ids.add(item.id)
for (const field of ['id', 'screenId', 'type', 'reason', 'owner', 'introducedVersion', 'reviewAt', 'removalTarget', 'status']) {
if (!item[field]) failures.push(`${item.id ?? 'unknown'}: missing ${field}`)
}
if (item.reviewAt && item.reviewAt < today && item.status === 'active') failures.push(`${item.id}: reviewAt expired`)
if (!['active', 'removed', 'waived'].includes(item.status)) failures.push(`${item.id}: invalid status`)
}
}
console.log(`KBX_EXCEPTIONS failures=${failures.length}`)
for (const failure of failures) console.log(`FAIL ${failure}`)
process.exitCode = failures.length ? 1 : 0