// Optional read-only validator. node check-plan.mjs data.json plan.json [saved-content.html] // This checks structure and declared selections, not permissions, medical facts or rendered appearance. import fs from 'node:fs'; import {pathToFileURL} from 'node:url'; const filled=v=>typeof v==='string'?v.trim().length>0:Array.isArray(v)?v.length>0:v!==null&&typeof v==='object'?Object.keys(v).length>0:false; const httpUrl=v=>{try{const u=new URL(v);return ['http:','https:'].includes(u.protocol)&&!u.username&&!u.password;}catch{return false;}}; const imageOk=v=>v&&httpUrl(v.url)&&(typeof v.alt==='string'||v.decorative===true); function savedRegions(html){ const regions=new Map(),stack=[];let malformed=false; for(const m of html.matchAll(//g)){ const [,close,name,raw]=m; if(close){const last=stack.pop();if(!last||last.name!==name)malformed=true;continue;} const selfClosing=/\/\s*$/.test(raw),attr=raw.replace(/\/\s*$/,'').trim();let attrs={}; try{if(attr)attrs=JSON.parse(attr);}catch{malformed=true;} const anchors=stack.map(x=>x.anchor).filter(Boolean);if(attrs.anchor)anchors.push(attrs.anchor); for(const id of anchors){if(!regions.has(id))regions.set(id,[]);regions.get(id).push(name);} if(!selfClosing)stack.push({name,anchor:attrs.anchor}); } return {regions,malformed:malformed||stack.length>0}; } export function validatePlan(data,plan,html){ const errors=[],warnings=[],add=s=>errors.push(s); const blueprint=data.blueprints?.find(b=>b.id===plan.blueprintId); if(!blueprint)return {ok:false,errors:['Unknown blueprintId. Use the published blueprint or adapt it explicitly before validating.'],warnings,stage:'plan'}; const variant=blueprint.variants.find(v=>v.id===plan.variantId); if(!variant)add('Unknown variantId'); if(plan.schemaVersion!==data.schemaVersion)add('schemaVersion mismatch'); if(!httpUrl(plan.site?.url)||!filled(plan.site?.themeVersion)||!filled(plan.site?.plan))add('Site URL/version/plan are unresolved'); if(!['draft','publish'].includes(plan.saveState))add('saveState must be draft or publish; this does not grant publish permission'); if(!Array.isArray(plan.sections))return {ok:false,errors:[...errors,'sections must be an ordered array'],warnings,stage:'plan'}; const override=plan.structureOverride?.userApproved===true&&filled(plan.structureOverride?.reason); const active=plan.sections.filter(s=>s.enabled!==false),ids=active.map(s=>s.id),distinct=new Set(); if(new Set(ids).size!==ids.length)add('Duplicate section IDs'); for(const s of plan.sections.filter(s=>s.enabled===false))if(!filled(s.omissionReason))add(`${s.id}: disabled section needs omissionReason`); if(!override&&variant&&JSON.stringify(ids)!==JSON.stringify(variant.order))add('Section order/coverage differs from variant; document an explicit user-approved structureOverride'); const saved=typeof html==='string'?savedRegions(html):null; if(saved?.malformed)add('Saved Gutenberg comments have mismatched nesting or invalid attributes'); for(const s of active){ const def=blueprint.sections.find(x=>x.id===s.id); if(!def){add(`${s.id}: section has no content requirements in blueprint`);continue;} if(s.role!==def.role)add(`${s.id}: role differs from blueprint`); const block=s.selectedBlock; if(!block||!filled(block.name)){add(`${s.id}: selectedBlock is unresolved`);continue;} const excluded=data.excludedForNewPages?.find(b=>b.name===block.name); if(excluded)add(`${s.id}: block excluded for new pages: ${block.name}`); const candidate=data.catalog.find(c=>c.name===block.name); const fallback=block.name.startsWith('core/')&&s.fallback?.userApproved===true&&filled(s.fallback.reason); if(!candidate&&!fallback)add(`${s.id}: block is not a published candidate; plain paragraphs cannot replace a major section for speed`); if(candidate){ if(!candidate.roles.includes(s.role))add(`${s.id}: selected block does not match role ${s.role}`); if(block.specUrl!==candidate.specUrl)add(`${s.id}: specUrl differs from candidate source`); if(block.availability!=='confirmed')add(`${s.id}: target-site availability not confirmed`); if(block.cautionsReviewed!==true)add(`${s.id}: full aiHint/notes/exclusions not reviewed`); if(s.role!=='heading')distinct.add(block.name); } for(const key of def.requiredContent)if(!filled(s.content?.[key]))add(`${s.id}: missing content.${key}`); if(def.requiredContent.includes('image')&&!imageOk(s.content?.image))add(`${s.id}: image URL/alt unresolved`); if(def.requiredContent.includes('action')){ const a=s.content?.action;if(!filled(a?.label)||!(httpUrl(a?.target)||(typeof a?.target==='string'&&a.target.startsWith('#')&&ids.includes(a.target.slice(1)))))add(`${s.id}: action label/target invalid or missing section`); } const itemFields={guides:['title','body'],flow:['title','body'],faq:['question','answer'],information:['label','value']}[s.role]; if(itemFields&&Array.isArray(s.content?.items))for(const [i,item] of s.content.items.entries()){ for(const field of itemFields)if(!filled(item[field]))add(`${s.id}: items[${i}].${field} missing`); if(candidate?.requiresItemImages&&!imageOk(item.image))add(`${s.id}: items[${i}].image unresolved`); if(item.target&&!(httpUrl(item.target)||(item.target.startsWith('#')&&ids.includes(item.target.slice(1)))))add(`${s.id}: items[${i}].target invalid`); } for(const key of ['colors','sizes','spacing'])if(!filled(s.design?.[key]))add(`${s.id}: design.${key} unresolved`); if(plan.phase==='final')for(const key of ['pc','sp','links'])if(s.checks?.[key]!==true)add(`${s.id}: final ${key} check is incomplete`); if(saved&&!saved.regions.get(s.id)?.includes(block.name))add(`${s.id}: selected block absent inside saved section anchor`); } if(!override&&distinct.size