Files
KArtSell.Aegis/docs/Design/kbx-foundation-v52-fe-operational-navigation-screen-anatomy/scripts/validate-live-openapi.mjs
T
kjh2064 c41e5063b7 chore: remove kbx-foundation-v36 reference (superseded by v4 implementation)
Removed entire kbx-foundation-v36 directory as it's been replaced by
the new KBX Foundation v4 patterns implemented in this session:
- Registry-driven screen definitions
- Density-aware UI adapter components
- Feature module templates (ShadowRun, Models)

Co-Authored-By: Claude Haiku 4.5 <noreply@anthropic.com>
2026-08-12 01:39:58 +09:00

29 lines
1.7 KiB
JavaScript

import fs from 'node:fs'
const livePath=process.env.KBX_LIVE_OPENAPI || 'artifacts/openapi.json'
if(!fs.existsSync(livePath)){
console.log(`Live OpenAPI snapshot not found at ${livePath}; host DTO/schema gate is deferred until the .NET host is available.`)
process.exit(0)
}
const contract=JSON.parse(fs.readFileSync('generated/api-manifest.json','utf8'))
const live=JSON.parse(fs.readFileSync(livePath,'utf8'))
const actual=new Map()
for(const [path,item] of Object.entries(live.paths??{})){
for(const method of ['get','post','put','patch','delete']){
const op=item?.[method];if(!op)continue
if(op.operationId)actual.set(op.operationId,{method:method.toUpperCase(),path,op})
}
}
const errors=[]
const normalize=p=>p.replace(/\{([^}:]+):[^}]+\}/g,'{$1}').toLowerCase()
for(const expected of contract.operations){
const got=actual.get(expected.id)
if(!got){errors.push(`live OpenAPI missing operationId ${expected.id}`);continue}
if(got.method!==expected.method || normalize(got.path)!==normalize(expected.path))errors.push(`live route drift ${expected.id}: ${got.method} ${got.path}`)
if((got.op['x-kbx-permission']??null)!==(expected.permission??null))errors.push(`live permission drift ${expected.id}`)
if((got.op['x-kbx-idempotency']??'none')!==expected.idempotency)errors.push(`live idempotency drift ${expected.id}`)
for(const status of ['400','403','404','409','422','500'])if(!got.op.responses?.[status])errors.push(`live Problem response ${status} missing: ${expected.id}`)
}
if(errors.length){console.error(errors.map(x=>`LIVE OPENAPI ERROR: ${x}`).join('\n'));process.exit(1)}
console.log(`Live OpenAPI contract PASS: ${contract.operationCount} operations with KBX metadata/problem responses.`)