arkaik 0.1.2 → 0.2.0

package/dist/assets/skill/references/schema.md

@@ -174,6 +174,8 @@ interface ProjectMetadata extends Record<string, unknown> {
   /** Per-map display overrides keyed by map id — built-ins included. */
   map_display?: Record<string, MapDisplayOptions>;
   products?: ProductDefinition[];
+  /** Federation (pollen) settings for hosted serving; `plant` is the ariko plant slug this project anchors to. */
+  pollen?: { plant?: string } & Record<string, unknown>;
 }
 
 interface Project {
@@ -307,7 +309,12 @@ type KnownJournalEvent =
   | RequestFiledEvent
   | RefAddedEvent
   | RefRemovedEvent
-  | RefStatusChangedEvent;
+  | RefStatusChangedEvent
+  | JournalBaselineEvent
+  | QualityAuditCompletedEvent
+  | QualityFindingOpenedEvent
+  | QualityFindingResolvedEvent
+  | QualitySignalTrippedEvent;
 
 interface ProjectBundle {
   /** Bundle Format contract version (docs/spec/bundle-format.md § Schema Versioning). Absent MUST be treated as 1. */
@@ -317,6 +324,8 @@ interface ProjectBundle {
   edges: Edge[];
   /** Optional embedded journal — the interchange projection (Level 2). Canonical storage is the JSONL sidecar; see docs/spec/journal.md. */
   journal?: JournalEvent[];
+  /** Optional Kritik quality state — profile, assessments, findings (docs/rfcs/kritik.md § 4.1). Additive; the matrix is derived, never stored. */
+  quality?: QualitySection;
 }
 ```
 <!-- GENERATED:SCHEMA:END -->

package/dist/assets/skill/scripts/validate-bundle.js

@@ -10,9 +10,9 @@
  *
  * Usage: node validate-bundle.js <path-to-bundle.json>
  */
-"use strict";var J=require("node:fs"),W=require("node:path");var z=["flow","view","data-model","api-endpoint","acceptance","decision"],F=["idea","discovery","backlog","development","releasing","live","archived"],V=["web","ios","android"],X=["composes","calls","displays","queries","covers","supersedes","generates","impacts"],pe={composes:[["flow","view"],["flow","flow"],["view","flow"],["view","view"]],calls:[["view","api-endpoint"],["flow","api-endpoint"],["api-endpoint","api-endpoint"],["api-endpoint","view"]],displays:[["view","data-model"]],queries:[["api-endpoint","data-model"]],covers:[["acceptance","view"],["acceptance","flow"]],supersedes:[["decision","decision"]],generates:[["decision","acceptance"]],impacts:[["decision","flow"],["decision","view"],["decision","data-model"],["decision","api-endpoint"]]};var le=["saves-time","simplifies","makes-money","reduces-risk","organizes","integrates","connects","reduces-effort","avoids-hassles","reduces-cost","quality","variety","sensory-appeal","informs","reduces-anxiety","rewards-me","nostalgia","design-aesthetics","badge-value","wellness","therapeutic-value","fun-entertainment","attractiveness","provides-access","provides-hope","self-actualization","motivation","heirloom","affiliation-belonging","self-transcendence"];var ue={flow:"F-",view:"V-","data-model":"DM-","api-endpoint":"API-",acceptance:"AC-",decision:"DEC-"};var je=["proposed","approved","enacted","rejected","deprecated","superseded"];function fe(p){switch(p){case"proposed":return"discovery";case"approved":return"backlog";case"enacted":return"live";case"rejected":case"deprecated":case"superseded":return"archived"}}function ge(p){let c=p.metadata?.decision_status;return je.includes(c)?c:"proposed"}var Q={prioritized:"backlog",blocked:"development"};function Z(p){return F.includes(p)?p:Q[p]}var Ce={...Q},Ve={backlog:"idea",...Q};function be(p){let c=s=>typeof s=="string"?s:"";return[...p].sort((s,i)=>{let h=c(s.ts),_=c(i.ts);if(h<_)return-1;if(h>_)return 1;let g=c(s.id),S=c(i.id);return g<S?-1:g>S?1:0})}function me(p){let c=[],s=[];return p.split(/\r?\n/).forEach((h,_)=>{let g=_+1;if(h.trim()==="")return;let S;try{S=JSON.parse(h)}catch(v){s.push({line:g,rule:"journal-line-parse",message:`Line ${g}: not valid JSON \u2014 ${v.message}`,severity:"error"});return}if(typeof S!="object"||S===null||Array.isArray(S)){s.push({line:g,rule:"journal-line-shape",message:`Line ${g}: each journal line must be a single JSON event object.`,severity:"error"});return}let E=S,w=[];if(typeof E.id!="string"&&w.push("id"),typeof E.ts!="string"&&w.push("ts"),typeof E.type!="string"&&w.push("type"),w.length>0){s.push({line:g,rule:"journal-line-shape",message:`Line ${g}: event is missing required envelope field(s): ${w.join(", ")}.`,severity:"error"});return}c.push(E)}),{events:c,findings:s}}var ke={"node.updated":["node_id"],"node.status_changed":["node_id"],"decision.status_changed":["node_id"],"node.deleted":["node_id"],"edge.added":["source_id","target_id"],"ref.added":["node_id"],"ref.removed":["node_id"],"ref.status_changed":["node_id"],"idea.proposed":["node_id"],"request.filed":["node_id"]};function Re(p,c){return p===c?!0:typeof c!="string"?!1:p==="backlog"&&c==="idea"?!0:(Z(p)??p)===(Z(c)??c)}function ye(p){let c=[],s=p.journal;if(s===void 0)return c;if(!Array.isArray(s))return c.push({path:"journal",rule:"journal-shape",message:"journal must be an array of events when present.",severity:"error"}),c;if(s.length===0)return c;let i=r=>typeof r=="string"?r:void 0,h=Array.isArray(p.nodes)?p.nodes:[],_=Array.isArray(p.edges)?p.edges:[],g=new Map,S=new Map;for(let r of h){let l=i(r?.id);if(l!==void 0){g.set(l,r.status);let m=r.metadata,$=m&&typeof m=="object"&&!Array.isArray(m)?m.decision_status:void 0;S.set(l,$??"proposed")}}let E=new Set;for(let r of _){let l=i(r?.id);l!==void 0&&E.add(l)}let w=[];s.forEach((r,l)=>{let m=`journal[${l}]`;if(typeof r!="object"||r===null||Array.isArray(r)){c.push({path:m,rule:"journal-event-shape",message:`journal[${l}]: each event must be a JSON object.`,severity:"error"});return}let $=r,I=[];if(i($.id)===void 0&&I.push("id"),i($.ts)===void 0&&I.push("ts"),i($.type)===void 0&&I.push("type"),I.length>0){c.push({path:m,rule:"journal-event-envelope",message:`journal[${l}]: event is missing required envelope field(s): ${I.join(", ")}.`,severity:"error"});return}w.push({ev:$,index:l})});let v=new Set(g.keys()),k=new Set(E);for(let{ev:r}of w)if(r.type==="node.created"){let l=i(r.node_id);l&&v.add(l)}else if(r.type==="edge.added"){let l=i(r.edge_id);l&&k.add(l)}let x=be(w.map(r=>r.ev)),b=new Set,N=new Map,C=new Map;for(let r of x)if(r.type==="node.created"){let l=i(r.node_id);l&&b.add(l)}else if(r.type==="node.status_changed"){let l=i(r.node_id);if(l&&r.platform===void 0){let m=i(r.to);m!==void 0&&N.set(l,m)}}else if(r.type==="decision.status_changed"){let l=i(r.node_id);if(l){let m=i(r.to);m!==void 0&&C.set(l,m)}}for(let{ev:r,index:l}of w){let m=ke[r.type];if(m)for(let $ of m){let I=i(r[$]);I!==void 0&&!v.has(I)&&c.push({path:`journal[${l}].${$}`,rule:"journal-dangling-node-ref",message:`journal[${l}] (${r.type}): references node "${I}" that never existed in the snapshot or journal.`,severity:"error"})}if(r.type==="deliverable.shipped"&&Array.isArray(r.node_ids)&&r.node_ids.forEach(($,I)=>{let R=i($);R!==void 0&&!v.has(R)&&c.push({path:`journal[${l}].node_ids[${I}]`,rule:"journal-dangling-node-ref",message:`journal[${l}] (${r.type}): references node "${R}" that never existed in the snapshot or journal.`,severity:"error"})}),r.type==="edge.removed"){let $=i(r.edge_id);$!==void 0&&!k.has($)&&c.push({path:`journal[${l}].edge_id`,rule:"journal-dangling-edge-ref",message:`journal[${l}] (edge.removed): references edge "${$}" that never existed in the snapshot or journal.`,severity:"error"})}}for(let[r,l]of g){b.has(r)||c.push({path:"journal",rule:"journal-missing-node-created",message:`Node "${r}" is present in the snapshot but has no node.created event in the journal.`,severity:"error"});let m=N.get(r);m!==void 0&&!Re(m,l)&&c.push({path:"journal",rule:"journal-status-mismatch",message:`Node "${r}": journal's last node.status_changed.to "${m}" disagrees with snapshot status "${String(l)}".`,severity:"error"})}for(let[r,l]of C){if(!S.has(r))continue;let m=S.get(r)??"proposed";l!==m&&c.push({path:"journal",rule:"journal-decision-status-mismatch",message:`Node "${r}": journal's last decision.status_changed.to "${l}" disagrees with snapshot decision_status "${String(m)}".`,severity:"error"})}return c}var _e=["rings","bars"],he=["chips","rows"],ve=["status","species"];var Pe=["journey","system"];function Se(p){return Pe.includes(p)}var we=["flow","view","acceptance"];function $e(p){let c=p?.metadata?.products;if(!Array.isArray(c))return[];let s=new Set,i=[];for(let h of c){if(typeof h!="object"||h===null||Array.isArray(h))continue;let _=h;typeof _.id!="string"||_.id.trim()===""||s.has(_.id)||(s.add(_.id),i.push(_))}return i}var De=["beta","monitoring","deprecated"],Ee=["compact","large"],Ie=2*1024*1024;function Ne(p){let c=p.indexOf(",");if(c===-1)return 0;let s=p.slice(c+1),i=s.endsWith("==")?2:s.endsWith("=")?1:0;return Math.floor(s.length*3/4)-i}function Ae(p){return typeof p=="string"&&!Number.isNaN(Date.parse(p))}function xe(p){let c=[],s=(e,d,n)=>c.push({path:e,rule:d,message:n,severity:"error"}),i=(e,d,n)=>c.push({path:e,rule:d,message:n,severity:"warning"}),h=()=>{let e=c.filter(n=>n.severity==="error"),d=c.filter(n=>n.severity==="warning");return{valid:e.length===0,findings:c,errors:e,warnings:d}};if(typeof p!="object"||p===null||Array.isArray(p))return s("","bundle-shape","Bundle must be an object with project, nodes, and edges."),h();let _=p,g=_.project,S=_.nodes,E=_.edges;if(!g||!S||!E)return s("","bundle-shape","Missing top-level keys (project, nodes, edges)."),h();if(!Array.isArray(S))return s("nodes","bundle-shape","nodes must be an array."),h();if(!Array.isArray(E))return s("edges","bundle-shape","edges must be an array."),h();let w=S,v=E,k=new Map,x=new Set;g.id||s("project.id","project-id-required","project.id is missing"),(typeof g.title!="string"||!g.title.trim())&&s("project.title","title-non-empty","project.title is missing or empty"),g.created_at||s("project.created_at","timestamp-required","project.created_at is missing"),g.updated_at||s("project.updated_at","timestamp-required","project.updated_at is missing"),g.created_at&&!Ae(g.created_at)&&i("project.created_at","iso-timestamp","project.created_at is not a valid ISO 8601 timestamp"),g.updated_at&&!Ae(g.updated_at)&&i("project.updated_at","iso-timestamp","project.updated_at is not a valid ISO 8601 timestamp");let b=g.metadata;b&&b.view_card_variant!==void 0&&!Ee.includes(b.view_card_variant)&&s("project.metadata.view_card_variant","view-card-variant",`project.metadata.view_card_variant must be one of ${Ee.join(", ")} (import rejects other values)`),w.forEach((e,d)=>{let n=`nodes[${d}]`,t=e.id;x.has(t)&&s(`${n}.id`,"duplicate-node-id",`Duplicate node ID: ${t}`),x.add(t),k.set(t,e),(typeof e.title!="string"||!e.title.trim())&&s(`${n}.title`,"title-non-empty",`Node ${t}: title is missing or empty`);let a=e.species,o=ue[a];o&&!(typeof t=="string"&&t.startsWith(o))&&s(`${n}.id`,"species-prefix",`Node ${t}: species "${a}" should have prefix "${o}"`),z.includes(a)||s(`${n}.species`,"valid-species",`Node ${t}: invalid species "${a}"`),e.project_id!==g.id&&s(`${n}.project_id`,"project-id-match",`Node ${t}: project_id "${e.project_id}" does not match project.id "${g.id}"`),F.includes(e.status)||s(`${n}.status`,"valid-status",`Node ${t}: invalid status "${e.status}"`);let f=e.platforms;if(!f||f.length===0)a!=="decision"&&s(`${n}.platforms`,"platforms-non-empty",`Node ${t}: platforms array is empty or missing`);else for(let y of f)V.includes(y)||s(`${n}.platforms`,"valid-platform",`Node ${t}: invalid platform "${y}"`);let u=e.metadata||{};u.stage!==void 0&&!De.includes(u.stage)&&s(`${n}.metadata.stage`,"valid-stage",`Node ${t}: invalid metadata.stage "${u.stage}"`);let A=u.platformNotes;if(A)for(let y of Object.keys(A))V.includes(y)||s(`${n}.metadata.platformNotes`,"valid-platform",`Node ${t}: platformNotes has invalid platform "${y}"`);let P=u.platformStatuses;if(P)for(let[y,j]of Object.entries(P))V.includes(y)?Array.isArray(f)&&!f.includes(y)&&i(`${n}.metadata.platformStatuses`,"platform-statuses-subset",`Node ${t}: platformStatuses covers platform "${y}" not in node.platforms`):s(`${n}.metadata.platformStatuses`,"valid-platform",`Node ${t}: platformStatuses has invalid platform "${y}"`),F.includes(j)||s(`${n}.metadata.platformStatuses`,"valid-status",`Node ${t}: platformStatuses has invalid status "${j}" for platform "${y}"`);let M=u.platformScreenshots;if(M){for(let[y,j]of Object.entries(M))if(typeof j=="string"&&j.startsWith("data:")){let Y=Ne(j);Y>Ie&&i(`${n}.metadata.platformScreenshots`,"screenshot-data-uri-size",`Node ${t}: platformScreenshots.${y} is a ${(Y/(1024*1024)).toFixed(1)}MB data URI, above the ${Ie/(1024*1024)}MB guidance (docs/spec/bundle-format.md \xA7 Asset Values) \u2014 consider a relative path or hosted URL instead`)}}let T=u.gherkin,L=u.values;if(a==="acceptance"?((typeof T!="string"||!T.trim())&&i(`${n}.metadata.gherkin`,"acceptance-gherkin-missing",`Acceptance ${t}: metadata.gherkin is missing or empty (one Given/When/Then scenario expected)`),(!Array.isArray(L)||L.length===0)&&i(`${n}.metadata.values`,"acceptance-values-missing",`Acceptance ${t}: metadata.values is missing or empty (assign 1-3 value elements)`)):(T!==void 0&&i(`${n}.metadata.gherkin`,"gherkin-species",`Node ${t}: metadata.gherkin is only meaningful on acceptance nodes`),L!==void 0&&i(`${n}.metadata.values`,"values-species",`Node ${t}: metadata.values is only meaningful on acceptance nodes`)),Array.isArray(L))for(let y of L)le.includes(y)||s(`${n}.metadata.values`,"valid-value",`Node ${t}: invalid value element "${y}"`);let q=u.refs;if(Array.isArray(q)){let y=new Set;q.forEach((j,Y)=>{let O=j??{},G=`${n}.metadata.refs[${Y}]`,D=O.id;typeof D!="string"||!D.trim()?s(`${G}.id`,"ref-id-required",`Node ${t}: ref is missing an id`):y.has(D)?s(`${G}.id`,"duplicate-ref-id",`Node ${t}: duplicate ref id "${D}"`):y.add(D),(typeof O.url!="string"||!O.url.trim())&&s(`${G}.url`,"ref-url-required",`Node ${t}: ref "${D}" is missing a url`),O.status_mapped!==void 0&&!F.includes(O.status_mapped)&&s(`${G}.status_mapped`,"valid-status",`Node ${t}: ref "${D}" has invalid status_mapped "${O.status_mapped}"`)})}if(u.decision_status!==void 0&&a!=="decision"&&i(`${n}.metadata.decision_status`,"decision-status-wrong-species",`decision_status is meaningful on decision nodes only; "${t}" is a ${a}.`),a==="decision"){let y=ge({metadata:e.metadata}),j=fe(y);e.status!==j&&i(`${n}.status`,"decision-lifecycle-mismatch",`Decision "${t}" is ${y}, whose lifecycle status should be "${j}", but status is "${e.status}" (spec \xA72).`)}if(a==="flow"){let y=u.playlist;!e.metadata||!y||!y.entries?s(`${n}.metadata.playlist`,"flow-playlist-required",`Flow ${t}: missing metadata.playlist.entries`):y.entries.length===0&&i(`${n}.metadata.playlist`,"flow-playlist-empty",`Flow ${t}: playlist is empty`)}});let N=g.root_node_id;N&&!x.has(N)&&s("project.root_node_id","root-node-exists",`project.root_node_id "${N}" does not reference an existing node`);let C=(e,d,n)=>{if(typeof e!="object"||e===null||Array.isArray(e))return;let t=e,a=[["flow_platforms",_e],["view_platforms",he],["minimap_color",ve]];for(let[o,f]of a){let u=t[o];u!==void 0&&(typeof u!="string"||!f.includes(u))&&i(`${d}.${o}`,"map-unknown-display",`${n} sets ${o} to "${String(u)}"; expected one of ${f.join(", ")} (renderers fall back to the default)`)}t.images!==void 0&&typeof t.images!="boolean"&&i(`${d}.images`,"map-unknown-display",`${n} sets images to a non-boolean value (renderers fall back to the default)`)},r=b?.map_display;if(typeof r=="object"&&r!==null&&!Array.isArray(r))for(let[e,d]of Object.entries(r))C(d,`project.metadata.map_display.${e}`,`Map "${e}"`);let l=b?.maps;if(Array.isArray(l)){let e=new Set;l.forEach((d,n)=>{if(typeof d!="object"||d===null||Array.isArray(d))return;let t=d,a=`project.metadata.maps[${n}]`,o=typeof t.id=="string"?t.id:void 0;o!==void 0&&(e.has(o)&&i(`${a}.id`,"map-duplicate-id",`Duplicate map id "${o}"`),e.add(o),Se(o)&&i(`${a}.id`,"map-shadows-built-in",`Map id "${o}" shadows a built-in map and will be ignored`));let f=t.root_node_id;typeof f=="string"&&!x.has(f)&&i(`${a}.root_node_id`,"map-unknown-root",`Map "${o??n}" anchors on "${f}" which does not reference an existing node`),Array.isArray(t.species)&&t.species.forEach((u,A)=>{typeof u=="string"&&!z.includes(u)&&i(`${a}.species[${A}]`,"map-unknown-species",`Map "${o??n}" filters on unknown species "${u}"`)}),Array.isArray(t.edge_types)&&t.edge_types.forEach((u,A)=>{typeof u=="string"&&!X.includes(u)&&i(`${a}.edge_types[${A}]`,"map-unknown-edge-type",`Map "${o??n}" filters on unknown edge type "${u}"`)}),C(t.display,`${a}.display`,`Map "${o??n}"`)})}let m=b?.products,$=new Set;if(Array.isArray(m)){let e=new Set;m.forEach((d,n)=>{if(typeof d!="object"||d===null||Array.isArray(d))return;let t=d,a=`project.metadata.products[${n}]`,o=typeof t.id=="string"?t.id:void 0;o!==void 0&&(e.has(o)?i(`${a}.id`,"product-duplicate-id",`Duplicate product id "${o}" \u2014 the first wins`):(e.add(o),o.trim()!==""&&$.add(o)),/^[a-z0-9]+(-[a-z0-9]+)*$/.test(o)||i(`${a}.id`,"product-invalid-id",`Product id "${o}" is not kebab-case`))})}let I=$.size>0,R=new Map;for(let e of v){if(e.edge_type!=="covers")continue;let d=typeof e.source_id=="string"?e.source_id:void 0,n=typeof e.target_id=="string"?e.target_id:void 0;if(d===void 0||n===void 0)continue;let t=R.get(d)??[];t.push(n),R.set(d,t)}let ee=new Map;if(I)for(let e of $e({metadata:b}))ee.set(e.id,new Set(Array.isArray(e.platforms)?e.platforms:[]));let te=new Map,ne=new Map;if(w.forEach((e,d)=>{let n=typeof e.id=="string"?e.id:`#${d}`,t=e.species,a=`nodes[${d}]`;ne.set(n,d);let o=e.metadata??{},f=typeof o.product=="string"?o.product:void 0,u=t!==void 0&&we.includes(t);if(f!==void 0&&!u){let M=z.includes(t)?`${t} membership is derived from consumers and must not be stored`:"metadata.product is only meaningful on flow, view, and acceptance nodes";i(`${a}.metadata.product`,"product-membership-wrong-species",`Node ${n}: ${M}`);return}if(!u)return;if(f===void 0){if(!I)return;t==="acceptance"?R.has(n)||i(`${a}.metadata.product`,"acceptance-product-unassigned",`Acceptance ${n} covers nothing and names no product \u2014 it will show only under "All products"`):i(`${a}.metadata.product`,"unassigned-membership",`Node ${n}: no product membership \u2014 it will show only under "All products"`);return}if(te.set(n,f),!$.has(f)){i(`${a}.metadata.product`,"product-unknown-reference",`Node ${n}: product "${f}" is not declared on the project`);return}let A=ee.get(f),P=Array.isArray(e.platforms)?e.platforms:[];if(A)for(let M of P)typeof M=="string"&&!A.has(M)&&i(`${a}.platforms`,"product-platform-not-in-menu",`Node ${n}: platform "${M}" is not in product "${f}"'s menu`)}),I)for(let[e,d]of R){let n=ne.get(e);if(n===void 0)continue;let t=new Set(d.map(a=>te.get(a)).filter(a=>!!a));t.size>1&&i(`nodes[${n}].metadata.product`,"acceptance-covers-span-products",`Acceptance ${e} covers anchors in ${[...t].sort().join(" and ")} \u2014 statuses may conflate products`)}let se=new Set,oe=new Set,ie=new Set;v.forEach((e,d)=>{let n=`edges[${d}]`,t=e.id,a=e.source_id,o=e.target_id,f=e.edge_type;se.has(t)&&s(`${n}.id`,"duplicate-edge-id",`Duplicate edge ID: ${t}`),se.add(t);let u=`e-${a}-${o}`;t!==u&&i(`${n}.id`,"edge-id-convention",`Edge ${t}: id does not match convention "${u}" (stale after a rename?)`);let A=`${a}->${o}:${f}`;oe.has(A)&&i(`${n}`,"duplicate-edge-relationship",`Duplicate edge relationship: ${A}`),oe.add(A),e.project_id!==g.id&&s(`${n}.project_id`,"project-id-match",`Edge ${t}: project_id does not match project.id`),x.has(a)||s(`${n}.source_id`,"dangling-edge",`Edge ${t}: source_id "${a}" not found in nodes`),x.has(o)||s(`${n}.target_id`,"dangling-edge",`Edge ${t}: target_id "${o}" not found in nodes`),X.includes(f)||s(`${n}.edge_type`,"valid-edge-type",`Edge ${t}: invalid edge_type "${f}"`);let P=k.get(a),M=k.get(o),T=pe[f];P&&M&&T&&(T.some(([q,ce])=>q===P.species&&ce===M.species)||s(`${n}.edge_type`,"edge-semantics",`Edge ${t}: "${f}" not valid from ${P.species} to ${M.species}`)),f==="composes"&&ie.add(`${a}->${o}`)});let B=(e,d,n,t=0)=>{if(t>50)return s(n,"playlist-depth",`Flow ${d}: playlist nesting too deep (possible cycle)`),[];let a=[];for(let o of e)if(o.type==="view")x.has(o.view_id)||s(n,"playlist-ref-exists",`Flow ${d}: playlist references non-existent view "${o.view_id}"`),a.push(o.view_id);else if(o.type==="flow")x.has(o.flow_id)||s(n,"playlist-ref-exists",`Flow ${d}: playlist references non-existent flow "${o.flow_id}"`),o.flow_id===d&&s(n,"playlist-self-cycle",`Flow ${d}: playlist contains itself (direct cycle)`),a.push(o.flow_id);else if(o.type==="condition")o.if_true&&a.push(...B(o.if_true,d,n,t+1)),o.if_false&&a.push(...B(o.if_false,d,n,t+1));else if(o.type==="junction"&&o.cases)for(let f of o.cases)a.push(...B(f.entries||[],d,n,t+1));return a};w.forEach((e,d)=>{let n=e.metadata;if(e.species==="flow"&&n?.playlist?.entries){let t=`nodes[${d}].metadata.playlist`,a=e.id,o=B(n.playlist.entries,a,t);for(let f of o)ie.has(`${a}->${f}`)||s(t,"playlist-composes-coherence",`Flow ${a}: playlist references "${f}" but no composes edge exists`)}});let K=new Map,re=new Map;w.forEach((e,d)=>{let n=e.metadata;if(e.species==="flow"&&n?.playlist?.entries){let t=e.id,a=[],o=f=>{for(let u of f)if(u.type==="flow"&&a.push(u.flow_id),u.type==="condition"&&(u.if_true&&o(u.if_true),u.if_false&&o(u.if_false)),u.type==="junction"&&u.cases)for(let A of u.cases)o(A.entries||[])};o(n.playlist.entries),K.set(t,a),re.set(t,`nodes[${d}].metadata.playlist`)}});let ae=new Set,H=new Set,de=e=>{if(H.has(e))return!0;if(ae.has(e))return!1;ae.add(e),H.add(e);for(let d of K.get(e)||[])if(de(d))return s(re.get(e)??"","flow-cycle",`Cycle detected: flow "${e}" -> "${d}"`),!0;return H.delete(e),!1};for(let e of K.keys())de(e);for(let e of ye(_))c.push(e);return h()}var Me="journal.jsonl";function U(p,c){return p.filter(s=>s?.species===c).length}function Te(){let p=process.argv[2];p||(console.error("Usage: node validate-bundle.js <path-to-bundle.json>"),process.exit(1)),(0,J.existsSync)(p)||(console.error(`File not found: ${p}`),process.exit(1));let c;try{c=JSON.parse((0,J.readFileSync)(p,"utf8"))}catch(v){console.error(`FATAL: Cannot parse JSON \u2014 ${v.message}`),process.exit(1)}let s=c;(typeof s!="object"||s===null||!s.project||!s.nodes||!s.edges)&&(console.error("FATAL: Missing top-level keys (project, nodes, edges)."),process.exit(1));let i=[],h=!1;if(s.journal===void 0){let v=(0,W.join)((0,W.dirname)(p),Me);if((0,J.existsSync)(v)){let{events:k,findings:x}=me((0,J.readFileSync)(v,"utf8"));i=x,h=!0,s.journal=k}}let _=Array.isArray(s.nodes)?s.nodes:[],g=Array.isArray(s.edges)?s.edges:[],S=Array.isArray(s.journal)?s.journal:[],E=xe(c);console.log(`
+"use strict";var U=require("node:fs"),Q=require("node:path");var H=["flow","view","data-model","api-endpoint","acceptance","decision"],K=["idea","discovery","backlog","development","releasing","live","archived"],B=["web","ios","android"],ne=["composes","calls","displays","queries","covers","supersedes","generates","impacts"],me={composes:[["flow","view"],["flow","flow"],["view","flow"],["view","view"]],calls:[["view","api-endpoint"],["flow","api-endpoint"],["api-endpoint","api-endpoint"],["api-endpoint","view"]],displays:[["view","data-model"]],queries:[["api-endpoint","data-model"]],covers:[["acceptance","view"],["acceptance","flow"]],supersedes:[["decision","decision"]],generates:[["decision","acceptance"]],impacts:[["decision","flow"],["decision","view"],["decision","data-model"],["decision","api-endpoint"]]};var he=["saves-time","simplifies","makes-money","reduces-risk","organizes","integrates","connects","reduces-effort","avoids-hassles","reduces-cost","quality","variety","sensory-appeal","informs","reduces-anxiety","rewards-me","nostalgia","design-aesthetics","badge-value","wellness","therapeutic-value","fun-entertainment","attractiveness","provides-access","provides-hope","self-actualization","motivation","heirloom","affiliation-belonging","self-transcendence"];var _e={flow:"F-",view:"V-","data-model":"DM-","api-endpoint":"API-",acceptance:"AC-",decision:"DEC-"};var De=["proposed","approved","enacted","rejected","deprecated","superseded"];function ve(f){switch(f){case"proposed":return"discovery";case"approved":return"backlog";case"enacted":return"live";case"rejected":case"deprecated":case"superseded":return"archived"}}function we(f){let p=f.metadata?.decision_status;return De.includes(p)?p:"proposed"}var ie={prioritized:"backlog",blocked:"development"};function se(f){return K.includes(f)?f:ie[f]}var Be={...ie},Ye={backlog:"idea",...ie};function Ne(f){let p=t=>typeof t=="string"?t:"";return[...f].sort((t,s)=>{let $=p(t.ts),w=p(s.ts);if($<w)return-1;if($>w)return 1;let m=p(t.id),I=p(s.id);return m<I?-1:m>I?1:0})}function re(f){let p=[],t=[];return f.split(/\r?\n/).forEach(($,w)=>{let m=w+1;if($.trim()==="")return;let I;try{I=JSON.parse($)}catch(L){t.push({line:m,rule:"journal-line-parse",message:`Line ${m}: not valid JSON \u2014 ${L.message}`,severity:"error"});return}if(typeof I!="object"||I===null||Array.isArray(I)){t.push({line:m,rule:"journal-line-shape",message:`Line ${m}: each journal line must be a single JSON event object.`,severity:"error"});return}let T=I,E=[];if(typeof T.id!="string"&&E.push("id"),typeof T.ts!="string"&&E.push("ts"),typeof T.type!="string"&&E.push("type"),E.length>0){t.push({line:m,rule:"journal-line-shape",message:`Line ${m}: event is missing required envelope field(s): ${E.join(", ")}.`,severity:"error"});return}p.push(T)}),{events:p,findings:t}}var Te={"node.updated":["node_id"],"node.status_changed":["node_id"],"decision.status_changed":["node_id"],"node.deleted":["node_id"],"edge.added":["source_id","target_id"],"ref.added":["node_id"],"ref.removed":["node_id"],"ref.status_changed":["node_id"],"idea.proposed":["node_id"],"request.filed":["node_id"]};function Fe(f,p){return f===p?!0:typeof p!="string"?!1:f==="backlog"&&p==="idea"?!0:(se(f)??f)===(se(p)??p)}function Se(f){let p=[],t=f.journal;if(t===void 0)return p;if(!Array.isArray(t))return p.push({path:"journal",rule:"journal-shape",message:"journal must be an array of events when present.",severity:"error"}),p;if(t.length===0)return p;let s=c=>typeof c=="string"?c:void 0,$=Array.isArray(f.nodes)?f.nodes:[],w=Array.isArray(f.edges)?f.edges:[],m=new Map,I=new Map;for(let c of $){let g=s(c?.id);if(g!==void 0){m.set(g,c.status);let _=c.metadata,x=_&&typeof _=="object"&&!Array.isArray(_)?_.decision_status:void 0;I.set(g,x??"proposed")}}let T=new Set;for(let c of w){let g=s(c?.id);g!==void 0&&T.add(g)}let E=[];t.forEach((c,g)=>{let _=`journal[${g}]`;if(typeof c!="object"||c===null||Array.isArray(c)){p.push({path:_,rule:"journal-event-shape",message:`journal[${g}]: each event must be a JSON object.`,severity:"error"});return}let x=c,j=[];if(s(x.id)===void 0&&j.push("id"),s(x.ts)===void 0&&j.push("ts"),s(x.type)===void 0&&j.push("type"),j.length>0){p.push({path:_,rule:"journal-event-envelope",message:`journal[${g}]: event is missing required envelope field(s): ${j.join(", ")}.`,severity:"error"});return}E.push({ev:x,index:g})});let L=new Set(m.keys()),k=new Set(T),F=new Set;for(let{ev:c}of E)if(c.type==="node.created"){let g=s(c.node_id);g&&L.add(g)}else if(c.type==="edge.added"){let g=s(c.edge_id);g&&k.add(g)}else if(c.type==="journal.baseline"&&Array.isArray(c.node_ids))for(let g of c.node_ids){let _=s(g);_&&(F.add(_),L.add(_))}let O=Ne(E.map(c=>c.ev)),J=new Set,G=new Map,q=new Map;for(let c of O)if(c.type==="node.created"){let g=s(c.node_id);g&&J.add(g)}else if(c.type==="node.status_changed"){let g=s(c.node_id);if(g&&c.platform===void 0){let _=s(c.to);_!==void 0&&G.set(g,_)}}else if(c.type==="decision.status_changed"){let g=s(c.node_id);if(g){let _=s(c.to);_!==void 0&&q.set(g,_)}}for(let{ev:c,index:g}of E){let _=Te[c.type];if(_)for(let x of _){let j=s(c[x]);j!==void 0&&!L.has(j)&&p.push({path:`journal[${g}].${x}`,rule:"journal-dangling-node-ref",message:`journal[${g}] (${c.type}): references node "${j}" that never existed in the snapshot or journal.`,severity:"error"})}if(c.type==="deliverable.shipped"&&Array.isArray(c.node_ids)&&c.node_ids.forEach((x,j)=>{let V=s(x);V!==void 0&&!L.has(V)&&p.push({path:`journal[${g}].node_ids[${j}]`,rule:"journal-dangling-node-ref",message:`journal[${g}] (${c.type}): references node "${V}" that never existed in the snapshot or journal.`,severity:"error"})}),c.type==="edge.removed"){let x=s(c.edge_id);x!==void 0&&!k.has(x)&&p.push({path:`journal[${g}].edge_id`,rule:"journal-dangling-edge-ref",message:`journal[${g}] (edge.removed): references edge "${x}" that never existed in the snapshot or journal.`,severity:"error"})}}for(let[c,g]of m){!J.has(c)&&!F.has(c)&&p.push({path:"journal",rule:"journal-missing-node-created",message:`Node "${c}" is present in the snapshot but has no node.created event in the journal.`,severity:"error"});let _=G.get(c);_!==void 0&&!Fe(_,g)&&p.push({path:"journal",rule:"journal-status-mismatch",message:`Node "${c}": journal's last node.status_changed.to "${_}" disagrees with snapshot status "${String(g)}".`,severity:"error"})}for(let[c,g]of q){if(!I.has(c))continue;let _=I.get(c)??"proposed";g!==_&&p.push({path:"journal",rule:"journal-decision-status-mismatch",message:`Node "${c}": journal's last decision.status_changed.to "${g}" disagrees with snapshot decision_status "${String(_)}".`,severity:"error"})}return p}var $e=["flow","view","acceptance"];function be(f){let p=f?.metadata?.products;if(!Array.isArray(p))return[];let t=new Set,s=[];for(let $ of p){if(typeof $!="object"||$===null||Array.isArray($))continue;let w=$;typeof w.id!="string"||w.id.trim()===""||t.has(w.id)||(t.add(w.id),s.push(w))}return s}var Ee=["rings","bars"],Ae=["chips","rows"],ke=["status","species"];var Le=["journey","system"];function xe(f){return Le.includes(f)}var X="cross-surface";var Oe=["beta","monitoring","deprecated"],Ie=["compact","large"],Re=2*1024*1024;function Ce(f){let p=f.indexOf(",");if(p===-1)return 0;let t=f.slice(p+1),s=t.endsWith("==")?2:t.endsWith("=")?1:0;return Math.floor(t.length*3/4)-s}function Me(f){return typeof f=="string"&&!Number.isNaN(Date.parse(f))}function Pe(f){let p=[],t=(e,r,n)=>p.push({path:e,rule:r,message:n,severity:"error"}),s=(e,r,n)=>p.push({path:e,rule:r,message:n,severity:"warning"}),$=()=>{let e=p.filter(n=>n.severity==="error"),r=p.filter(n=>n.severity==="warning");return{valid:e.length===0,findings:p,errors:e,warnings:r}};if(typeof f!="object"||f===null||Array.isArray(f))return t("","bundle-shape","Bundle must be an object with project, nodes, and edges."),$();let w=f,m=w.project,I=w.nodes,T=w.edges;if(!m||!I||!T)return t("","bundle-shape","Missing top-level keys (project, nodes, edges)."),$();if(!Array.isArray(I))return t("nodes","bundle-shape","nodes must be an array."),$();if(!Array.isArray(T))return t("edges","bundle-shape","edges must be an array."),$();let E=I,L=T,k=new Map,F=new Set;m.id||t("project.id","project-id-required","project.id is missing"),(typeof m.title!="string"||!m.title.trim())&&t("project.title","title-non-empty","project.title is missing or empty"),m.created_at||t("project.created_at","timestamp-required","project.created_at is missing"),m.updated_at||t("project.updated_at","timestamp-required","project.updated_at is missing"),m.created_at&&!Me(m.created_at)&&s("project.created_at","iso-timestamp","project.created_at is not a valid ISO 8601 timestamp"),m.updated_at&&!Me(m.updated_at)&&s("project.updated_at","iso-timestamp","project.updated_at is not a valid ISO 8601 timestamp");let O=m.metadata;O&&O.view_card_variant!==void 0&&!Ie.includes(O.view_card_variant)&&t("project.metadata.view_card_variant","view-card-variant",`project.metadata.view_card_variant must be one of ${Ie.join(", ")} (import rejects other values)`),E.forEach((e,r)=>{let n=`nodes[${r}]`,i=e.id;F.has(i)&&t(`${n}.id`,"duplicate-node-id",`Duplicate node ID: ${i}`),F.add(i),k.set(i,e),(typeof e.title!="string"||!e.title.trim())&&t(`${n}.title`,"title-non-empty",`Node ${i}: title is missing or empty`);let a=e.species,o=_e[a];o&&!(typeof i=="string"&&i.startsWith(o))&&t(`${n}.id`,"species-prefix",`Node ${i}: species "${a}" should have prefix "${o}"`),H.includes(a)||t(`${n}.species`,"valid-species",`Node ${i}: invalid species "${a}"`),e.project_id!==m.id&&t(`${n}.project_id`,"project-id-match",`Node ${i}: project_id "${e.project_id}" does not match project.id "${m.id}"`),K.includes(e.status)||t(`${n}.status`,"valid-status",`Node ${i}: invalid status "${e.status}"`);let l=e.platforms;if(!l||l.length===0)a!=="decision"&&t(`${n}.platforms`,"platforms-non-empty",`Node ${i}: platforms array is empty or missing`);else for(let d of l)B.includes(d)||t(`${n}.platforms`,"valid-platform",`Node ${i}: invalid platform "${d}"`);let u=e.metadata||{};u.stage!==void 0&&!Oe.includes(u.stage)&&t(`${n}.metadata.stage`,"valid-stage",`Node ${i}: invalid metadata.stage "${u.stage}"`);let S=u.platformNotes;if(S)for(let d of Object.keys(S))B.includes(d)||t(`${n}.metadata.platformNotes`,"valid-platform",`Node ${i}: platformNotes has invalid platform "${d}"`);let b=u.platformStatuses;if(b)for(let[d,y]of Object.entries(b))B.includes(d)?Array.isArray(l)&&!l.includes(d)&&s(`${n}.metadata.platformStatuses`,"platform-statuses-subset",`Node ${i}: platformStatuses covers platform "${d}" not in node.platforms`):t(`${n}.metadata.platformStatuses`,"valid-platform",`Node ${i}: platformStatuses has invalid platform "${d}"`),K.includes(y)||t(`${n}.metadata.platformStatuses`,"valid-status",`Node ${i}: platformStatuses has invalid status "${y}" for platform "${d}"`);let R=u.platformScreenshots;if(R){for(let[d,y]of Object.entries(R))if(typeof y=="string"&&y.startsWith("data:")){let M=Ce(y);M>Re&&s(`${n}.metadata.platformScreenshots`,"screenshot-data-uri-size",`Node ${i}: platformScreenshots.${d} is a ${(M/(1024*1024)).toFixed(1)}MB data URI, above the ${Re/(1024*1024)}MB guidance (docs/spec/bundle-format.md \xA7 Asset Values) \u2014 consider a relative path or hosted URL instead`)}}let P=u.gherkin,C=u.values;if(a==="acceptance"?((typeof P!="string"||!P.trim())&&s(`${n}.metadata.gherkin`,"acceptance-gherkin-missing",`Acceptance ${i}: metadata.gherkin is missing or empty (one Given/When/Then scenario expected)`),(!Array.isArray(C)||C.length===0)&&s(`${n}.metadata.values`,"acceptance-values-missing",`Acceptance ${i}: metadata.values is missing or empty (assign 1-3 value elements)`)):(P!==void 0&&s(`${n}.metadata.gherkin`,"gherkin-species",`Node ${i}: metadata.gherkin is only meaningful on acceptance nodes`),C!==void 0&&s(`${n}.metadata.values`,"values-species",`Node ${i}: metadata.values is only meaningful on acceptance nodes`)),Array.isArray(C))for(let d of C)he.includes(d)||t(`${n}.metadata.values`,"valid-value",`Node ${i}: invalid value element "${d}"`);let h=u.refs;if(Array.isArray(h)){let d=new Set;h.forEach((y,M)=>{let A=y??{},D=`${n}.metadata.refs[${M}]`,N=A.id;typeof N!="string"||!N.trim()?t(`${D}.id`,"ref-id-required",`Node ${i}: ref is missing an id`):d.has(N)?t(`${D}.id`,"duplicate-ref-id",`Node ${i}: duplicate ref id "${N}"`):d.add(N),(typeof A.url!="string"||!A.url.trim())&&t(`${D}.url`,"ref-url-required",`Node ${i}: ref "${N}" is missing a url`),A.status_mapped!==void 0&&!K.includes(A.status_mapped)&&t(`${D}.status_mapped`,"valid-status",`Node ${i}: ref "${N}" has invalid status_mapped "${A.status_mapped}"`)})}if(u.decision_status!==void 0&&a!=="decision"&&s(`${n}.metadata.decision_status`,"decision-status-wrong-species",`decision_status is meaningful on decision nodes only; "${i}" is a ${a}.`),a==="decision"){let d=we({metadata:e.metadata}),y=ve(d);e.status!==y&&s(`${n}.status`,"decision-lifecycle-mismatch",`Decision "${i}" is ${d}, whose lifecycle status should be "${y}", but status is "${e.status}" (spec \xA72).`)}if(a==="flow"){let d=u.playlist;!e.metadata||!d||!d.entries?t(`${n}.metadata.playlist`,"flow-playlist-required",`Flow ${i}: missing metadata.playlist.entries`):d.entries.length===0&&s(`${n}.metadata.playlist`,"flow-playlist-empty",`Flow ${i}: playlist is empty`)}});let J=m.root_node_id;J&&!F.has(J)&&t("project.root_node_id","root-node-exists",`project.root_node_id "${J}" does not reference an existing node`);let G=(e,r,n)=>{if(typeof e!="object"||e===null||Array.isArray(e))return;let i=e,a=[["flow_platforms",Ee],["view_platforms",Ae],["minimap_color",ke]];for(let[o,l]of a){let u=i[o];u!==void 0&&(typeof u!="string"||!l.includes(u))&&s(`${r}.${o}`,"map-unknown-display",`${n} sets ${o} to "${String(u)}"; expected one of ${l.join(", ")} (renderers fall back to the default)`)}i.images!==void 0&&typeof i.images!="boolean"&&s(`${r}.images`,"map-unknown-display",`${n} sets images to a non-boolean value (renderers fall back to the default)`)},q=O?.map_display;if(typeof q=="object"&&q!==null&&!Array.isArray(q))for(let[e,r]of Object.entries(q))G(r,`project.metadata.map_display.${e}`,`Map "${e}"`);let c=O?.maps;if(Array.isArray(c)){let e=new Set;c.forEach((r,n)=>{if(typeof r!="object"||r===null||Array.isArray(r))return;let i=r,a=`project.metadata.maps[${n}]`,o=typeof i.id=="string"?i.id:void 0;o!==void 0&&(e.has(o)&&s(`${a}.id`,"map-duplicate-id",`Duplicate map id "${o}"`),e.add(o),xe(o)&&s(`${a}.id`,"map-shadows-built-in",`Map id "${o}" shadows a built-in map and will be ignored`));let l=i.root_node_id;typeof l=="string"&&!F.has(l)&&s(`${a}.root_node_id`,"map-unknown-root",`Map "${o??n}" anchors on "${l}" which does not reference an existing node`),Array.isArray(i.species)&&i.species.forEach((u,S)=>{typeof u=="string"&&!H.includes(u)&&s(`${a}.species[${S}]`,"map-unknown-species",`Map "${o??n}" filters on unknown species "${u}"`)}),Array.isArray(i.edge_types)&&i.edge_types.forEach((u,S)=>{typeof u=="string"&&!ne.includes(u)&&s(`${a}.edge_types[${S}]`,"map-unknown-edge-type",`Map "${o??n}" filters on unknown edge type "${u}"`)}),G(i.display,`${a}.display`,`Map "${o??n}"`)})}let g=O?.products,_=new Set;if(Array.isArray(g)){let e=new Set;g.forEach((r,n)=>{if(typeof r!="object"||r===null||Array.isArray(r))return;let i=r,a=`project.metadata.products[${n}]`,o=typeof i.id=="string"?i.id:void 0;o!==void 0&&(e.has(o)?s(`${a}.id`,"product-duplicate-id",`Duplicate product id "${o}" \u2014 the first wins`):(e.add(o),o.trim()!==""&&_.add(o)),/^[a-z0-9]+(-[a-z0-9]+)*$/.test(o)||s(`${a}.id`,"product-invalid-id",`Product id "${o}" is not kebab-case`))})}let x=_.size>0,j=new Map;for(let e of L){if(e.edge_type!=="covers")continue;let r=typeof e.source_id=="string"?e.source_id:void 0,n=typeof e.target_id=="string"?e.target_id:void 0;if(r===void 0||n===void 0)continue;let i=j.get(r)??[];i.push(n),j.set(r,i)}let V=new Map;if(x)for(let e of be({metadata:O}))V.set(e.id,new Set(Array.isArray(e.platforms)?e.platforms:[]));let oe=new Map,ae=new Map;if(E.forEach((e,r)=>{let n=typeof e.id=="string"?e.id:`#${r}`,i=e.species,a=`nodes[${r}]`;ae.set(n,r);let o=e.metadata??{},l=typeof o.product=="string"?o.product:void 0,u=i!==void 0&&$e.includes(i);if(l!==void 0&&!u){let R=H.includes(i)?`${i} membership is derived from consumers and must not be stored`:"metadata.product is only meaningful on flow, view, and acceptance nodes";s(`${a}.metadata.product`,"product-membership-wrong-species",`Node ${n}: ${R}`);return}if(!u)return;if(l===void 0){if(!x)return;i==="acceptance"?j.has(n)||s(`${a}.metadata.product`,"acceptance-product-unassigned",`Acceptance ${n} covers nothing and names no product \u2014 it will show only under "All products"`):s(`${a}.metadata.product`,"unassigned-membership",`Node ${n}: no product membership \u2014 it will show only under "All products"`);return}if(oe.set(n,l),!_.has(l)){s(`${a}.metadata.product`,"product-unknown-reference",`Node ${n}: product "${l}" is not declared on the project`);return}let S=V.get(l),b=Array.isArray(e.platforms)?e.platforms:[];if(S)for(let R of b)typeof R=="string"&&!S.has(R)&&s(`${a}.platforms`,"product-platform-not-in-menu",`Node ${n}: platform "${R}" is not in product "${l}"'s menu`)}),x)for(let[e,r]of j){let n=ae.get(e);if(n===void 0)continue;let i=new Set(r.map(a=>oe.get(a)).filter(a=>!!a));i.size>1&&s(`nodes[${n}].metadata.product`,"acceptance-covers-span-products",`Acceptance ${e} covers anchors in ${[...i].sort().join(" and ")} \u2014 statuses may conflate products`)}let de=new Set,ce=new Set,le=new Set;L.forEach((e,r)=>{let n=`edges[${r}]`,i=e.id,a=e.source_id,o=e.target_id,l=e.edge_type;de.has(i)&&t(`${n}.id`,"duplicate-edge-id",`Duplicate edge ID: ${i}`),de.add(i);let u=`e-${a}-${o}`;i!==u&&s(`${n}.id`,"edge-id-convention",`Edge ${i}: id does not match convention "${u}" (stale after a rename?)`);let S=`${a}->${o}:${l}`;ce.has(S)&&s(`${n}`,"duplicate-edge-relationship",`Duplicate edge relationship: ${S}`),ce.add(S),e.project_id!==m.id&&t(`${n}.project_id`,"project-id-match",`Edge ${i}: project_id does not match project.id`),F.has(a)||t(`${n}.source_id`,"dangling-edge",`Edge ${i}: source_id "${a}" not found in nodes`),F.has(o)||t(`${n}.target_id`,"dangling-edge",`Edge ${i}: target_id "${o}" not found in nodes`),ne.includes(l)||t(`${n}.edge_type`,"valid-edge-type",`Edge ${i}: invalid edge_type "${l}"`);let b=k.get(a),R=k.get(o),P=me[l];b&&R&&P&&(P.some(([h,v])=>h===b.species&&v===R.species)||t(`${n}.edge_type`,"edge-semantics",`Edge ${i}: "${l}" not valid from ${b.species} to ${R.species}`)),l==="composes"&&le.add(`${a}->${o}`)});let ue=["view","flow","condition","junction"],Z=(e,r,n,i=0)=>{if(!(i>50)){if(!Array.isArray(e)){t(n,"playlist-entry-shape",`Flow ${r}: ${n} must be an array of playlist entries`);return}e.forEach((a,o)=>{let l=`${n}[${o}]`;if(typeof a!="object"||a===null||Array.isArray(a)){t(l,"playlist-entry-shape",`Flow ${r}: ${l} must be a playlist entry object`);return}let u=a,S=u.type;if(typeof S!="string"||!ue.includes(S)){t(`${l}.type`,"playlist-entry-shape",`Flow ${r}: ${l}.type must be one of ${ue.join(", ")} (got ${JSON.stringify(S)})`);return}if(S==="view")typeof u.view_id!="string"&&t(`${l}.view_id`,"playlist-entry-shape",`Flow ${r}: ${l} is a view entry with no view_id string`);else if(S==="flow")typeof u.flow_id!="string"&&t(`${l}.flow_id`,"playlist-entry-shape",`Flow ${r}: ${l} is a flow entry with no flow_id string`);else if(S==="condition"){typeof u.label!="string"&&t(`${l}.label`,"playlist-entry-shape",`Flow ${r}: ${l} is a condition with no label string`);for(let b of["if_true","if_false"])Array.isArray(u[b])?Z(u[b],r,`${l}.${b}`,i+1):t(`${l}.${b}`,"playlist-entry-shape",`Flow ${r}: ${l}.${b} must be an array of playlist entries (both branches are required, use [] for an empty one)`)}else{if(typeof u.label!="string"&&t(`${l}.label`,"playlist-entry-shape",`Flow ${r}: ${l} is a junction with no label string`),!Array.isArray(u.cases)){t(`${l}.cases`,"playlist-entry-shape",`Flow ${r}: ${l}.cases must be an array of junction cases`);return}u.cases.forEach((b,R)=>{let P=`${l}.cases[${R}]`;if(typeof b!="object"||b===null||Array.isArray(b)){t(P,"playlist-entry-shape",`Flow ${r}: ${P} must be a junction case object`);return}let C=b;typeof C.label!="string"&&t(`${P}.label`,"playlist-entry-shape",`Flow ${r}: ${P} has no label string`),Array.isArray(C.entries)?Z(C.entries,r,`${P}.entries`,i+1):t(`${P}.entries`,"playlist-entry-shape",`Flow ${r}: ${P}.entries must be an array of playlist entries \u2014 a junction case holds its own entries, not a bare view_id/flow_id`)})}})}};E.forEach((e,r)=>{let n=e.metadata;e.species==="flow"&&n?.playlist?.entries&&Z(n.playlist.entries,e.id,`nodes[${r}].metadata.playlist.entries`)});let z=(e,r,n,i=0)=>{if(i>50)return t(n,"playlist-depth",`Flow ${r}: playlist nesting too deep (possible cycle)`),[];let a=[];if(!Array.isArray(e))return a;for(let o of e)if(!(typeof o!="object"||o===null)){if(o.type==="view")F.has(o.view_id)||t(n,"playlist-ref-exists",`Flow ${r}: playlist references non-existent view "${o.view_id}"`),a.push(o.view_id);else if(o.type==="flow")F.has(o.flow_id)||t(n,"playlist-ref-exists",`Flow ${r}: playlist references non-existent flow "${o.flow_id}"`),o.flow_id===r&&t(n,"playlist-self-cycle",`Flow ${r}: playlist contains itself (direct cycle)`),a.push(o.flow_id);else if(o.type==="condition")o.if_true&&a.push(...z(o.if_true,r,n,i+1)),o.if_false&&a.push(...z(o.if_false,r,n,i+1));else if(o.type==="junction"&&o.cases)for(let l of o.cases)a.push(...z(l.entries||[],r,n,i+1))}return a};E.forEach((e,r)=>{let n=e.metadata;if(e.species==="flow"&&n?.playlist?.entries){let i=`nodes[${r}].metadata.playlist`,a=e.id,o=z(n.playlist.entries,a,i);for(let l of o)le.has(`${a}->${l}`)||t(i,"playlist-composes-coherence",`Flow ${a}: playlist references "${l}" but no composes edge exists`)}});let ee=new Map,pe=new Map;E.forEach((e,r)=>{let n=e.metadata;if(e.species==="flow"&&n?.playlist?.entries){let i=e.id,a=[],o=l=>{if(Array.isArray(l)){for(let u of l)if(!(typeof u!="object"||u===null)&&(u.type==="flow"&&a.push(u.flow_id),u.type==="condition"&&(u.if_true&&o(u.if_true),u.if_false&&o(u.if_false)),u.type==="junction"&&u.cases))for(let S of u.cases)o(S.entries||[])}};o(n.playlist.entries),ee.set(i,a),pe.set(i,`nodes[${r}].metadata.playlist`)}});let fe=new Set,te=new Set,ge=e=>{if(te.has(e))return!0;if(fe.has(e))return!1;fe.add(e),te.add(e);for(let r of ee.get(e)||[])if(ge(r))return t(pe.get(e)??"","flow-cycle",`Cycle detected: flow "${e}" -> "${r}"`),!0;return te.delete(e),!1};for(let e of ee.keys())ge(e);let W=w.quality;if(typeof W=="object"&&W!==null&&!Array.isArray(W)){let e=W,r=Array.isArray(e.assessments)?e.assessments:[],n=Array.isArray(e.findings)?e.findings:[],i=typeof e.profile=="object"&&e.profile!==null?e.profile:void 0,a=new Set;Array.isArray(i?.surfaces)&&i.surfaces.forEach((h,v)=>{if(typeof h!="object"||h===null||Array.isArray(h))return;let d=h,y=typeof d.id=="string"?d.id:void 0;y===void 0||y.trim()===""||(a.has(y)&&s(`quality.profile.surfaces[${v}].id`,"quality-duplicate-surface",`Duplicate surface id "${y}" \u2014 the first wins`),a.add(y))}),a.size===0&&(r.length>0||n.length>0)&&s("quality.profile.surfaces","quality-no-surfaces","Quality data is stored but the profile declares no surfaces \u2014 the matrix falls back to the surfaces the assessments name");let o=typeof e.library=="object"&&e.library!==null?e.library:void 0,l=new Set,u=new Map;if(Array.isArray(o?.criteria))for(let h of o.criteria){if(typeof h!="object"||h===null)continue;let v=h;typeof v.id=="string"&&(l.add(v.id),typeof v.superseded_by=="string"&&v.superseded_by!==""&&u.set(v.id,v.superseded_by))}else(r.length>0||n.length>0)&&s("quality.library","quality-library-missing","No criteria pack is embedded \u2014 criterion ids cannot be resolved to domains or weights; the matrix uses a synthesized library");(typeof e.framework_version!="string"||e.framework_version==="")&&s("quality.framework_version","quality-framework-version-missing","Quality section has no framework_version \u2014 scores are not comparable across audits without one");let S=(h,v,d)=>{let y=typeof h.criterion_id=="string"?h.criterion_id:void 0;y!==void 0&&l.size>0&&!l.has(y)&&s(`${v}.criterion_id`,"quality-unknown-criterion",`${d}: criterion "${y}" is not in the pinned library`);let M=y!==void 0?u.get(y):void 0;M!==void 0&&s(`${v}.criterion_id`,"quality-retired-criterion",`${d}: criterion "${y}" is retired \u2014 superseded by "${M}"`);let A=typeof h.surface=="string"?h.surface:void 0;A!==void 0&&A!==X&&a.size>0&&!a.has(A)&&s(`${v}.surface`,"quality-unknown-surface",`${d}: surface "${A}" is not declared in the profile`)},b=new Set;r.forEach((h,v)=>{if(typeof h!="object"||h===null||Array.isArray(h))return;let d=h,y=`quality.assessments[${v}]`,M=`Assessment ${v}`;S(d,y,M);let A=d.level;(typeof A!="number"||!Number.isInteger(A)||A<0||A>4)&&s(`${y}.level`,"quality-level-range",`${M}: level must be an integer 0-4 (N/A is the absence of the row, not a level)`),d.surface===X&&s(`${y}.surface`,"quality-cross-surface-assessment",`${M}: "${X}" is a findings-only lens \u2014 it carries no matrix column, so this score would render nowhere`),(typeof d.evidence!="string"||d.evidence.trim()==="")&&s(`${y}.evidence`,"quality-assessment-no-evidence",`${M}: scored with no evidence \u2014 a score without a citation is an opinion, not an assessment`);let D=typeof d.criterion_id=="string"?d.criterion_id:void 0,N=typeof d.surface=="string"?d.surface:void 0;if(D!==void 0&&N!==void 0){let ye=`${D}\0${N}`;b.has(ye)&&s(`${y}`,"quality-duplicate-assessment",`${M}: a second score for (${D} x ${N}) \u2014 the section stores latest-per-cell, so this cell is ambiguous`),b.add(ye)}});let R=new Set;n.forEach((h,v)=>{if(typeof h!="object"||h===null||Array.isArray(h))return;let d=h,y=`quality.findings[${v}]`,M=`Finding ${v}`;S(d,y,M);let A=typeof d.id=="string"?d.id:void 0;A!==void 0&&(R.has(A)&&s(`${y}.id`,"quality-duplicate-finding-id",`Duplicate finding id "${A}"`),R.add(A));for(let D of["impact","likelihood"]){let N=d[D];(typeof N!="number"||!Number.isInteger(N)||N<1||N>5)&&s(`${y}.${D}`,"quality-risk-range",`${M}: ${D} must be an integer 1-5 \u2014 severity is derived from impact x likelihood`)}for(let D of["severity","priority"])D in d&&s(`${y}.${D}`,"quality-derived-field-stored",`${M}: ${D} is derived from impact, likelihood and cost \u2014 storing it lets it drift from the numbers behind it`);d.status==="accepted-risk"&&(typeof d.detail!="string"||d.detail.trim()==="")&&s(`${y}.detail`,"quality-accepted-risk-no-note",`${M}: accepted-risk with no note \u2014 an accepted risk is a decision and reads like one`)});let P=new Set,C=Array.isArray(w.journal)?w.journal:[];C.forEach(h=>{if(typeof h!="object"||h===null)return;let v=h;v.type==="quality.finding.opened"&&typeof v.finding_id=="string"&&P.add(v.finding_id)}),C.forEach((h,v)=>{if(typeof h!="object"||h===null)return;let d=h,y=typeof d.type=="string"?d.type:"";y.startsWith("quality.")&&((typeof d.actor!="string"||d.actor.trim()==="")&&s(`journal[${v}].actor`,"quality-event-no-actor",`Journal event ${v}: ${y} has no actor \u2014 human, agent and CI scores become indistinguishable`),y==="quality.finding.resolved"&&typeof d.finding_id=="string"&&!P.has(d.finding_id)&&!R.has(d.finding_id)&&s(`journal[${v}].finding_id`,"quality-resolved-never-opened",`Journal event ${v}: resolves finding "${d.finding_id}", which no quality.finding.opened event or stored finding ever declared`))})}for(let e of Se(w))p.push(e);return $()}var je="journal.jsonl",Je="journal";function qe(f){let p=(0,Q.join)(f,Je);return(0,U.existsSync)(p)?(0,U.readdirSync)(p).filter(t=>t.startsWith("archive-")&&t.endsWith(".jsonl")).sort().map(t=>(0,Q.join)(p,t)):[]}function Y(f,p){return f.filter(t=>t?.species===p).length}function Ge(){let f=process.argv[2];f||(console.error("Usage: node validate-bundle.js <path-to-bundle.json>"),process.exit(1)),(0,U.existsSync)(f)||(console.error(`File not found: ${f}`),process.exit(1));let p;try{p=JSON.parse((0,U.readFileSync)(f,"utf8"))}catch(k){console.error(`FATAL: Cannot parse JSON \u2014 ${k.message}`),process.exit(1)}let t=p;(typeof t!="object"||t===null||!t.project||!t.nodes||!t.edges)&&(console.error("FATAL: Missing top-level keys (project, nodes, edges)."),process.exit(1));let s=[],$=!1,w=[];if(t.journal===void 0){let k=(0,Q.dirname)(f),F=(0,Q.join)(k,je),O=[];if((0,U.existsSync)(F)){let{events:J,findings:G}=re((0,U.readFileSync)(F,"utf8"));for(let q of G)s.push(q.message);$=!0,O.push(...J)}for(let J of qe(k)){let G=(0,Q.basename)(J),{events:q,findings:c}=re((0,U.readFileSync)(J,"utf8"));for(let g of c)s.push(`${G} \u2014 ${g.message}`);w.push(G),O.push(...q)}($||w.length>0)&&(t.journal=O)}let m=Array.isArray(t.nodes)?t.nodes:[],I=Array.isArray(t.edges)?t.edges:[],T=Array.isArray(t.journal)?t.journal:[],E=Pe(p);if(console.log(`
   Arkaik Bundle Validation`),console.log(`  =======================
-`),console.log(`  Nodes: ${_.length} (${U(_,"view")} views, ${U(_,"flow")} flows, ${U(_,"data-model")} data-models, ${U(_,"api-endpoint")} api-endpoints, ${U(_,"acceptance")} acceptances)`),console.log(`  Edges: ${g.length}`),h?console.log(`  Journal: ${S.length} event(s) from ${Me} sidecar`):S.length>0&&console.log(`  Journal: ${S.length} embedded event(s)`),console.log(""),E.warnings.length>0&&(console.log(`  Warnings: ${E.warnings.length}`),E.warnings.forEach(v=>console.log(`    WARN: ${v.message}`)),console.log(""));let w=[...i.map(v=>v.message),...E.errors.map(v=>v.message)];w.length===0&&(console.log(`  Result: VALID
-`),process.exit(0)),console.log(`  Errors: ${w.length}`),w.forEach(v=>console.log(`    ERROR: ${v}`)),console.log(`
+`),console.log(`  Nodes: ${m.length} (${Y(m,"view")} views, ${Y(m,"flow")} flows, ${Y(m,"data-model")} data-models, ${Y(m,"api-endpoint")} api-endpoints, ${Y(m,"acceptance")} acceptances)`),console.log(`  Edges: ${I.length}`),$||w.length>0){let k=[...$?[`${je} sidecar`]:[],...w.length>0?[`${w.length} archive(s)`]:[]].join(" + ");console.log(`  Journal: ${T.length} event(s) from ${k}`)}else T.length>0&&console.log(`  Journal: ${T.length} embedded event(s)`);console.log(""),E.warnings.length>0&&(console.log(`  Warnings: ${E.warnings.length}`),E.warnings.forEach(k=>console.log(`    WARN: ${k.message}`)),console.log(""));let L=[...s,...E.errors.map(k=>k.message)];L.length===0&&(console.log(`  Result: VALID
+`),process.exit(0)),console.log(`  Errors: ${L.length}`),L.forEach(k=>console.log(`    ERROR: ${k}`)),console.log(`
   Result: INVALID
-`),process.exit(1)}Te();
+`),process.exit(1)}Ge();