Upload 136 files

.gitignore

@@ -0,0 +1 @@
+dashboard-manifest.json

_astro/index.CSubz1BA.css

@@ -0,0 +1 @@
+*,:before,:after{--tw-border-spacing-x: 0;--tw-border-spacing-y: 0;--tw-translate-x: 0;--tw-translate-y: 0;--tw-rotate: 0;--tw-skew-x: 0;--tw-skew-y: 0;--tw-scale-x: 1;--tw-scale-y: 1;--tw-pan-x: ;--tw-pan-y: ;--tw-pinch-zoom: ;--tw-scroll-snap-strictness: proximity;--tw-gradient-from-position: ;--tw-gradient-via-position: ;--tw-gradient-to-position: ;--tw-ordinal: ;--tw-slashed-zero: ;--tw-numeric-figure: ;--tw-numeric-spacing: ;--tw-numeric-fraction: ;--tw-ring-inset: ;--tw-ring-offset-width: 0px;--tw-ring-offset-color: #fff;--tw-ring-color: rgb(59 130 246 / .5);--tw-ring-offset-shadow: 0 0 #0000;--tw-ring-shadow: 0 0 #0000;--tw-shadow: 0 0 #0000;--tw-shadow-colored: 0 0 #0000;--tw-blur: ;--tw-brightness: ;--tw-contrast: ;--tw-grayscale: ;--tw-hue-rotate: ;--tw-invert: ;--tw-saturate: ;--tw-sepia: ;--tw-drop-shadow: ;--tw-backdrop-blur: ;--tw-backdrop-brightness: ;--tw-backdrop-contrast: ;--tw-backdrop-grayscale: ;--tw-backdrop-hue-rotate: ;--tw-backdrop-invert: ;--tw-backdrop-opacity: ;--tw-backdrop-saturate: ;--tw-backdrop-sepia: ;--tw-contain-size: ;--tw-contain-layout: ;--tw-contain-paint: ;--tw-contain-style: }::backdrop{--tw-border-spacing-x: 0;--tw-border-spacing-y: 0;--tw-translate-x: 0;--tw-translate-y: 0;--tw-rotate: 0;--tw-skew-x: 0;--tw-skew-y: 0;--tw-scale-x: 1;--tw-scale-y: 1;--tw-pan-x: ;--tw-pan-y: ;--tw-pinch-zoom: ;--tw-scroll-snap-strictness: proximity;--tw-gradient-from-position: ;--tw-gradient-via-position: ;--tw-gradient-to-position: ;--tw-ordinal: ;--tw-slashed-zero: ;--tw-numeric-figure: ;--tw-numeric-spacing: ;--tw-numeric-fraction: ;--tw-ring-inset: ;--tw-ring-offset-width: 0px;--tw-ring-offset-color: #fff;--tw-ring-color: rgb(59 130 246 / .5);--tw-ring-offset-shadow: 0 0 #0000;--tw-ring-shadow: 0 0 #0000;--tw-shadow: 0 0 #0000;--tw-shadow-colored: 0 0 #0000;--tw-blur: ;--tw-brightness: ;--tw-contrast: ;--tw-grayscale: ;--tw-hue-rotate: ;--tw-invert: ;--tw-saturate: ;--tw-sepia: ;--tw-drop-shadow: ;--tw-backdrop-blur: ;--tw-backdrop-brightness: ;--tw-backdrop-contrast: ;--tw-backdrop-grayscale: ;--tw-backdrop-hue-rotate: ;--tw-backdrop-invert: ;--tw-backdrop-opacity: ;--tw-backdrop-saturate: ;--tw-backdrop-sepia: ;--tw-contain-size: ;--tw-contain-layout: ;--tw-contain-paint: ;--tw-contain-style: }*,:before,:after{box-sizing:border-box;border-width:0;border-style:solid;border-color:#e5e7eb}:before,:after{--tw-content: ""}html,:host{line-height:1.5;-webkit-text-size-adjust:100%;-moz-tab-size:4;-o-tab-size:4;tab-size:4;font-family:ui-sans-serif,system-ui,sans-serif,"Apple Color Emoji","Segoe UI Emoji",Segoe UI Symbol,"Noto Color Emoji";font-feature-settings:normal;font-variation-settings:normal;-webkit-tap-highlight-color:transparent}body{margin:0;line-height:inherit}hr{height:0;color:inherit;border-top-width:1px}abbr:where([title]){-webkit-text-decoration:underline dotted;text-decoration:underline dotted}h1,h2,h3,h4,h5,h6{font-size:inherit;font-weight:inherit}a{color:inherit;text-decoration:inherit}b,strong{font-weight:bolder}code,kbd,samp,pre{font-family:ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,Liberation Mono,Courier New,monospace;font-feature-settings:normal;font-variation-settings:normal;font-size:1em}small{font-size:80%}sub,sup{font-size:75%;line-height:0;position:relative;vertical-align:baseline}sub{bottom:-.25em}sup{top:-.5em}table{text-indent:0;border-color:inherit;border-collapse:collapse}button,input,optgroup,select,textarea{font-family:inherit;font-feature-settings:inherit;font-variation-settings:inherit;font-size:100%;font-weight:inherit;line-height:inherit;letter-spacing:inherit;color:inherit;margin:0;padding:0}button,select{text-transform:none}button,input:where([type=button]),input:where([type=reset]),input:where([type=submit]){-webkit-appearance:button;background-color:transparent;background-image:none}:-moz-focusring{outline:auto}:-moz-ui-invalid{box-shadow:none}progress{vertical-align:baseline}::-webkit-inner-spin-button,::-webkit-outer-spin-button{height:auto}[type=search]{-webkit-appearance:textfield;outline-offset:-2px}::-webkit-search-decoration{-webkit-appearance:none}::-webkit-file-upload-button{-webkit-appearance:button;font:inherit}summary{display:list-item}blockquote,dl,dd,h1,h2,h3,h4,h5,h6,hr,figure,p,pre{margin:0}fieldset{margin:0;padding:0}legend{padding:0}ol,ul,menu{list-style:none;margin:0;padding:0}dialog{padding:0}textarea{resize:vertical}input::-moz-placeholder,textarea::-moz-placeholder{opacity:1;color:#9ca3af}input::placeholder,textarea::placeholder{opacity:1;color:#9ca3af}button,[role=button]{cursor:pointer}:disabled{cursor:default}img,svg,video,canvas,audio,iframe,embed,object{display:block;vertical-align:middle}img,video{max-width:100%;height:auto}[hidden]:where(:not([hidden=until-found])){display:none}.container{width:100%}@media(min-width:640px){.container{max-width:640px}}@media(min-width:768px){.container{max-width:768px}}@media(min-width:1024px){.container{max-width:1024px}}@media(min-width:1280px){.container{max-width:1280px}}@media(min-width:1536px){.container{max-width:1536px}}.pointer-events-none{pointer-events:none}.static{position:static}.absolute{position:absolute}.relative{position:relative}.inset-0{inset:0}.z-50{z-index:50}.mx-auto{margin-left:auto;margin-right:auto}.mb-3{margin-bottom:.75rem}.mb-6{margin-bottom:1.5rem}.ml-3{margin-left:.75rem}.ml-auto{margin-left:auto}.mr-1{margin-right:.25rem}.mt-1{margin-top:.25rem}.mt-6{margin-top:1.5rem}.block{display:block}.inline-block{display:inline-block}.inline{display:inline}.flex{display:flex}.inline-flex{display:inline-flex}.table{display:table}.contents{display:contents}.hidden{display:none}.h-8{height:2rem}.h-\[400px\]{height:400px}.min-h-screen{min-height:100vh}.w-8{width:2rem}.w-full{width:100%}.min-w-0{min-width:0px}.max-w-screen-2xl{max-width:1536px}.flex-1{flex:1 1 0%}.transform{transform:translate(var(--tw-translate-x),var(--tw-translate-y)) rotate(var(--tw-rotate)) skew(var(--tw-skew-x)) skewY(var(--tw-skew-y)) scaleX(var(--tw-scale-x)) scaleY(var(--tw-scale-y))}@keyframes spin{to{transform:rotate(360deg)}}.animate-spin{animation:spin 1s linear infinite}.flex-col{flex-direction:column}.flex-wrap{flex-wrap:wrap}.items-center{align-items:center}.justify-center{justify-content:center}.gap-2{gap:.5rem}.gap-3{gap:.75rem}.gap-6{gap:1.5rem}.space-y-3>:not([hidden])~:not([hidden]){--tw-space-y-reverse: 0;margin-top:calc(.75rem * calc(1 - var(--tw-space-y-reverse)));margin-bottom:calc(.75rem * var(--tw-space-y-reverse))}.space-y-4>:not([hidden])~:not([hidden]){--tw-space-y-reverse: 0;margin-top:calc(1rem * calc(1 - var(--tw-space-y-reverse)));margin-bottom:calc(1rem * var(--tw-space-y-reverse))}.overflow-y-auto{overflow-y:auto}.truncate{overflow:hidden;text-overflow:ellipsis;white-space:nowrap}.rounded{border-radius:.25rem}.rounded-full{border-radius:9999px}.rounded-lg{border-radius:.5rem}.rounded-md{border-radius:.375rem}.border{border-width:1px}.border-4{border-width:4px}.border-gray-100{--tw-border-opacity: 1;border-color:rgb(243 244 246 / var(--tw-border-opacity, 1))}.border-gray-200{--tw-border-opacity: 1;border-color:rgb(229 231 235 / var(--tw-border-opacity, 1))}.border-gray-300{--tw-border-opacity: 1;border-color:rgb(209 213 219 / var(--tw-border-opacity, 1))}.border-red-200{--tw-border-opacity: 1;border-color:rgb(254 202 202 / var(--tw-border-opacity, 1))}.border-red-300{--tw-border-opacity: 1;border-color:rgb(252 165 165 / var(--tw-border-opacity, 1))}.border-t-indigo-600{--tw-border-opacity: 1;border-top-color:rgb(79 70 229 / var(--tw-border-opacity, 1))}.bg-blue-100{--tw-bg-opacity: 1;background-color:rgb(219 234 254 / var(--tw-bg-opacity, 1))}.bg-gray-50{--tw-bg-opacity: 1;background-color:rgb(249 250 251 / var(--tw-bg-opacity, 1))}.bg-gray-700{--tw-bg-opacity: 1;background-color:rgb(55 65 81 / var(--tw-bg-opacity, 1))}.bg-gray-900{--tw-bg-opacity: 1;background-color:rgb(17 24 39 / var(--tw-bg-opacity, 1))}.bg-green-100{--tw-bg-opacity: 1;background-color:rgb(220 252 231 / var(--tw-bg-opacity, 1))}.bg-indigo-600{--tw-bg-opacity: 1;background-color:rgb(79 70 229 / var(--tw-bg-opacity, 1))}.bg-red-50{--tw-bg-opacity: 1;background-color:rgb(254 242 242 / var(--tw-bg-opacity, 1))}.bg-white{--tw-bg-opacity: 1;background-color:rgb(255 255 255 / var(--tw-bg-opacity, 1))}.p-4{padding:1rem}.px-1{padding-left:.25rem;padding-right:.25rem}.px-2\.5{padding-left:.625rem;padding-right:.625rem}.px-3{padding-left:.75rem;padding-right:.75rem}.px-4{padding-left:1rem;padding-right:1rem}.py-0\.5{padding-top:.125rem;padding-bottom:.125rem}.py-1\.5{padding-top:.375rem;padding-bottom:.375rem}.py-2{padding-top:.5rem;padding-bottom:.5rem}.pt-2{padding-top:.5rem}.font-mono{font-family:ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,Liberation Mono,Courier New,monospace}.text-2xl{font-size:1.5rem;line-height:2rem}.text-lg{font-size:1.125rem;line-height:1.75rem}.text-sm{font-size:.875rem;line-height:1.25rem}.text-xs{font-size:.75rem;line-height:1rem}.font-bold{font-weight:700}.font-medium{font-weight:500}.font-semibold{font-weight:600}.uppercase{text-transform:uppercase}.lowercase{text-transform:lowercase}.capitalize{text-transform:capitalize}.tracking-wide{letter-spacing:.025em}.text-blue-800{--tw-text-opacity: 1;color:rgb(30 64 175 / var(--tw-text-opacity, 1))}.text-gray-300{--tw-text-opacity: 1;color:rgb(209 213 219 / var(--tw-text-opacity, 1))}.text-gray-400{--tw-text-opacity: 1;color:rgb(156 163 175 / var(--tw-text-opacity, 1))}.text-gray-500{--tw-text-opacity: 1;color:rgb(107 114 128 / var(--tw-text-opacity, 1))}.text-gray-600{--tw-text-opacity: 1;color:rgb(75 85 99 / var(--tw-text-opacity, 1))}.text-gray-700{--tw-text-opacity: 1;color:rgb(55 65 81 / var(--tw-text-opacity, 1))}.text-gray-900{--tw-text-opacity: 1;color:rgb(17 24 39 / var(--tw-text-opacity, 1))}.text-green-800{--tw-text-opacity: 1;color:rgb(22 101 52 / var(--tw-text-opacity, 1))}.text-red-600{--tw-text-opacity: 1;color:rgb(220 38 38 / var(--tw-text-opacity, 1))}.text-white{--tw-text-opacity: 1;color:rgb(255 255 255 / var(--tw-text-opacity, 1))}.antialiased{-webkit-font-smoothing:antialiased;-moz-osx-font-smoothing:grayscale}.shadow-lg{--tw-shadow: 0 10px 15px -3px rgb(0 0 0 / .1), 0 4px 6px -4px rgb(0 0 0 / .1);--tw-shadow-colored: 0 10px 15px -3px var(--tw-shadow-color), 0 4px 6px -4px var(--tw-shadow-color);box-shadow:var(--tw-ring-offset-shadow, 0 0 #0000),var(--tw-ring-shadow, 0 0 #0000),var(--tw-shadow)}.shadow-sm{--tw-shadow: 0 1px 2px 0 rgb(0 0 0 / .05);--tw-shadow-colored: 0 1px 2px 0 var(--tw-shadow-color);box-shadow:var(--tw-ring-offset-shadow, 0 0 #0000),var(--tw-ring-shadow, 0 0 #0000),var(--tw-shadow)}.filter{filter:var(--tw-blur) var(--tw-brightness) var(--tw-contrast) var(--tw-grayscale) var(--tw-hue-rotate) var(--tw-invert) var(--tw-saturate) var(--tw-sepia) var(--tw-drop-shadow)}.transition{transition-property:color,background-color,border-color,text-decoration-color,fill,stroke,opacity,box-shadow,transform,filter,backdrop-filter;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.15s}.transition-colors{transition-property:color,background-color,border-color,text-decoration-color,fill,stroke;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.15s}.file\:mr-4::file-selector-button{margin-right:1rem}.file\:rounded-md::file-selector-button{border-radius:.375rem}.file\:border-0::file-selector-button{border-width:0px}.file\:bg-blue-50::file-selector-button{--tw-bg-opacity: 1;background-color:rgb(239 246 255 / var(--tw-bg-opacity, 1))}.file\:px-4::file-selector-button{padding-left:1rem;padding-right:1rem}.file\:py-2::file-selector-button{padding-top:.5rem;padding-bottom:.5rem}.file\:text-sm::file-selector-button{font-size:.875rem;line-height:1.25rem}.file\:font-semibold::file-selector-button{font-weight:600}.file\:text-blue-700::file-selector-button{--tw-text-opacity: 1;color:rgb(29 78 216 / var(--tw-text-opacity, 1))}.hover\:bg-gray-50:hover{--tw-bg-opacity: 1;background-color:rgb(249 250 251 / var(--tw-bg-opacity, 1))}.hover\:bg-indigo-700:hover{--tw-bg-opacity: 1;background-color:rgb(67 56 202 / var(--tw-bg-opacity, 1))}.hover\:bg-red-50:hover{--tw-bg-opacity: 1;background-color:rgb(254 242 242 / var(--tw-bg-opacity, 1))}.hover\:file\:bg-blue-100::file-selector-button:hover{--tw-bg-opacity: 1;background-color:rgb(219 234 254 / var(--tw-bg-opacity, 1))}.focus\:border-blue-500:focus{--tw-border-opacity: 1;border-color:rgb(59 130 246 / var(--tw-border-opacity, 1))}.focus\:outline-none:focus{outline:2px solid transparent;outline-offset:2px}.focus\:ring-1:focus{--tw-ring-offset-shadow: var(--tw-ring-inset) 0 0 0 var(--tw-ring-offset-width) var(--tw-ring-offset-color);--tw-ring-shadow: var(--tw-ring-inset) 0 0 0 calc(1px + var(--tw-ring-offset-width)) var(--tw-ring-color);box-shadow:var(--tw-ring-offset-shadow),var(--tw-ring-shadow),var(--tw-shadow, 0 0 #0000)}.focus\:ring-2:focus{--tw-ring-offset-shadow: var(--tw-ring-inset) 0 0 0 var(--tw-ring-offset-width) var(--tw-ring-offset-color);--tw-ring-shadow: var(--tw-ring-inset) 0 0 0 calc(2px + var(--tw-ring-offset-width)) var(--tw-ring-color);box-shadow:var(--tw-ring-offset-shadow),var(--tw-ring-shadow),var(--tw-shadow, 0 0 #0000)}.focus\:ring-blue-500:focus{--tw-ring-opacity: 1;--tw-ring-color: rgb(59 130 246 / var(--tw-ring-opacity, 1))}.focus\:ring-indigo-500:focus{--tw-ring-opacity: 1;--tw-ring-color: rgb(99 102 241 / var(--tw-ring-opacity, 1))}.focus\:ring-red-500:focus{--tw-ring-opacity: 1;--tw-ring-color: rgb(239 68 68 / var(--tw-ring-opacity, 1))}.focus\:ring-offset-2:focus{--tw-ring-offset-width: 2px}.disabled\:cursor-not-allowed:disabled{cursor:not-allowed}.disabled\:opacity-50:disabled{opacity:.5}@media(min-width:640px){.sm\:w-64{width:16rem}.sm\:w-auto{width:auto}.sm\:flex-row{flex-direction:row}.sm\:items-center{align-items:center}.sm\:p-6{padding:1.5rem}.sm\:text-3xl{font-size:1.875rem;line-height:2.25rem}}@media(min-width:1024px){.lg\:h-\[600px\]{height:600px}.lg\:max-h-\[660px\]{max-height:660px}.lg\:w-80{width:20rem}.lg\:shrink-0{flex-shrink:0}.lg\:flex-row{flex-direction:row}.lg\:p-8{padding:2rem}}

_astro/index.astro_astro_type_script_index_0_lang.Br7129Kw.js

@@ -0,0 +1 @@
+function xn(t){const{container:e,manifest:n,onSelect:r}=t,i="w-full rounded-md border border-gray-300 bg-white px-3 py-2 text-sm text-gray-700 shadow-sm focus:border-blue-500 focus:outline-none focus:ring-1 focus:ring-blue-500 sm:w-64",o=document.createElement("select");if(o.className=i,n.length===0){const s=document.createElement("option");s.textContent="No dashboards available",s.value="",s.disabled=!0,s.selected=!0,o.appendChild(s),o.disabled=!0}else{const s=document.createElement("option");s.textContent="Select a project…",s.value="",s.disabled=!0,s.selected=!0,o.appendChild(s);for(const c of n){const u=document.createElement("option");u.value=c.dirName,u.textContent=c.dirName,o.appendChild(u)}}let a=null;return o.addEventListener("change",()=>{const s=o.value;if(!s)return;const c=n.find(l=>l.dirName===s);if(!c)return;if(a&&e.contains(a)&&(e.removeChild(a),a=null),c.graphFiles.length===1){r(c.dirName,c.graphFiles[0].fileName);return}a=document.createElement("select"),a.className=i;const u=document.createElement("option");u.textContent="Select a graph file…",u.value="",u.disabled=!0,u.selected=!0,a.appendChild(u);for(const l of c.graphFiles){const d=document.createElement("option");d.value=l.fileName,d.textContent=`${l.projectName} (${l.fileName})`,a.appendChild(d)}a.addEventListener("change",()=>{a&&a.value&&r(c.dirName,a.value)}),e.appendChild(a)}),e.appendChild(o),o}function Ye(t){const e=[];if(t==null||typeof t!="object"||Array.isArray(t))return e.push("Dashboard data must be a non-null object"),{valid:!1,errors:e};const n=t;if(!("nodes"in n)||!Array.isArray(n.nodes))e.push('Dashboard data must contain a "nodes" array');else{const r=n.nodes;for(let i=0;i<r.length;i++){const o=r[i];if(o==null||typeof o!="object"||Array.isArray(o)){e.push(`nodes[${i}] must be an object`);continue}const a=o,s=["id","type","name"];for(const c of s)(!(c in a)||typeof a[c]!="string")&&e.push(`nodes[${i}] is missing required field "${c}"`)}}if(!("edges"in n)||!Array.isArray(n.edges))e.push('Dashboard data must contain an "edges" array');else{const r=n.edges;for(let i=0;i<r.length;i++){const o=r[i];if(o==null||typeof o!="object"||Array.isArray(o)){e.push(`edges[${i}] must be an object`);continue}const a=o,s=["source","target","type"];for(const c of s)(!(c in a)||typeof a[c]!="string")&&e.push(`edges[${i}] is missing required field "${c}"`)}}return{valid:e.length===0,errors:e}}function vn(t){let e;try{e=JSON.parse(t)}catch{return{success:!1,error:"The uploaded file is not valid JSON."}}const n=Ye(e);return n.valid?{success:!0,data:e}:{success:!1,error:`The uploaded file is not a valid dashboard. ${n.errors.join(". ")}.`}}function wn(t){const{container:e,onUpload:n}=t,r=document.createElement("div");r.className="flex flex-col gap-2";const i=document.createElement("input");i.type="file",i.accept=".json",i.multiple=!0,i.className="block w-full text-sm text-gray-700 file:mr-4 file:rounded-md file:border-0 file:bg-blue-50 file:px-4 file:py-2 file:text-sm file:font-semibold file:text-blue-700 hover:file:bg-blue-100 sm:w-auto";const o=document.createElement("div"),a=document.createElement("div");a.setAttribute("role","alert"),r.appendChild(i),r.appendChild(o),r.appendChild(a),e.appendChild(r);let s=[];function c(d){a.textContent="";const f=document.createElement("div");f.className="rounded-md border border-red-200 bg-red-50 px-4 py-2 text-sm text-red-600",f.textContent=d,a.appendChild(f)}function u(){a.textContent=""}function l(){if(o.innerHTML="",s.length<=1)return;const d=document.createElement("select");d.className="w-full rounded-md border border-gray-300 bg-white px-3 py-2 text-sm text-gray-700 shadow-sm focus:border-blue-500 focus:outline-none focus:ring-1 focus:ring-blue-500 sm:w-64";for(let f=0;f<s.length;f++){const h=document.createElement("option");h.value=String(f),h.textContent=s[f].fileName,d.appendChild(h)}d.value=String(s.length-1),d.addEventListener("change",()=>{const f=Number(d.value),h=s[f];h&&n(h.dashboard)}),o.appendChild(d)}return i.addEventListener("change",()=>{u();const d=i.files;if(!d||d.length===0)return;s=[];let f=0;const h=d.length,b=Array.from(d);for(const y of b){const v=new FileReader;v.onload=()=>{f++;const m=v.result,_=vn(m);_.success?s.push({fileName:y.name,dashboard:_.data}):c(`${y.name}: ${_.error}`),f===h&&s.length>0&&(l(),n(s[s.length-1].dashboard))},v.onerror=()=>{f++,c(`Failed to read file: ${y.name}`),f===h&&s.length>0&&(l(),n(s[s.length-1].dashboard))},v.readAsText(y)}}),i}function ye(t){const e=new Date(t);return isNaN(e.getTime())?t:new Intl.DateTimeFormat("en-US",{year:"numeric",month:"long",day:"numeric"}).format(e)}function _n(t){const{container:e,project:n,meta:r}=t;e.innerHTML="";const i=document.createElement("div");i.className="space-y-4";const o=document.createElement("h1");o.className="text-2xl font-bold text-gray-900",o.textContent=n.name,i.appendChild(o);const a=document.createElement("p");if(a.className="text-gray-600",a.textContent=n.description,i.appendChild(a),n.languages.length>0){const s=document.createElement("div");s.className="flex flex-wrap gap-2";for(const c of n.languages){const u=document.createElement("span");u.className="inline-flex items-center rounded-full bg-blue-100 px-2.5 py-0.5 text-xs font-medium text-blue-800",u.textContent=c,u.dataset.badgeType="language",s.appendChild(u)}i.appendChild(s)}if(n.frameworks.length>0){const s=document.createElement("div");s.className="flex flex-wrap gap-2";for(const c of n.frameworks){const u=document.createElement("span");u.className="inline-flex items-center rounded-full bg-green-100 px-2.5 py-0.5 text-xs font-medium text-green-800",u.textContent=c,u.dataset.badgeType="framework",s.appendChild(u)}i.appendChild(s)}if(r){const s=document.createElement("p");s.className="text-sm text-gray-500",s.textContent=`Analyzed: ${ye(r.lastAnalyzedAt)}`,i.appendChild(s);const c=document.createElement("p");c.className="text-sm text-gray-500";const u=document.createTextNode("Commit: ");c.appendChild(u);const l=document.createElement("code");l.className="font-mono text-gray-700",l.textContent=r.gitCommitHash.slice(0,7),c.appendChild(l),i.appendChild(c);const d=document.createElement("p");d.className="text-sm text-gray-500",d.textContent=`Version: ${r.version}`,i.appendChild(d);const f=document.createElement("p");f.className="text-sm text-gray-500",f.textContent=`Analyzed files: ${r.analyzedFiles}`,i.appendChild(f)}else{const s=document.createElement("p");s.className="text-sm text-gray-500",s.textContent=`Analyzed: ${ye(n.analyzedAt)}`,i.appendChild(s);const c=document.createElement("p");c.className="text-sm text-gray-500";const u=document.createTextNode("Commit: ");c.appendChild(u);const l=document.createElement("code");l.className="font-mono text-gray-700",l.textContent=n.gitCommitHash.slice(0,7),c.appendChild(l),i.appendChild(c)}return e.appendChild(i),i}function bn(t,e){const n={steps:t,currentIndex:0,isActive:!1};function r(){t.length!==0&&(n.isActive=!0,n.currentIndex=0,e(t[n.currentIndex]))}function i(){if(n.isActive){if(n.currentIndex>=t.length-1){a();return}n.currentIndex++,e(t[n.currentIndex])}}function o(){n.isActive&&(n.currentIndex>0&&n.currentIndex--,e(t[n.currentIndex]))}function a(){n.isActive=!1,n.currentIndex=0,e(null)}function s(){return!n.isActive||t.length===0?null:t[n.currentIndex]}function c(){return{...n,steps:[...n.steps]}}return{start:r,next:i,previous:o,end:a,getCurrentStep:s,getState:c}}function Nn(t){const{container:e,steps:n,graphRenderer:r}=t;if(e.innerHTML="",n.length===0){const u=document.createElement("p");return u.className="text-sm text-gray-400",u.textContent="No tour steps available for this dashboard.",e.appendChild(u),{destroy:()=>{e.innerHTML=""}}}const o=bn(n,u=>{u?(r.highlightNodes(u.nodeIds),r.panToNodes(u.nodeIds),c(u)):(r.resetView(),s())}),a=document.createElement("div");a.className="tour-ui",e.appendChild(a);function s(){a.innerHTML="";const u=document.createElement("button");u.className="rounded-lg bg-indigo-600 px-4 py-2 text-sm font-medium text-white hover:bg-indigo-700 focus:outline-none focus:ring-2 focus:ring-indigo-500 focus:ring-offset-2 transition-colors",u.textContent="Start Tour",u.dataset.testid="start-tour-btn",u.addEventListener("click",()=>{o.start()}),a.appendChild(u)}function c(u){a.innerHTML="";const l=o.getState(),d=l.currentIndex,f=l.steps.length,h=document.createElement("div");h.className="tour-panel space-y-3",h.dataset.testid="tour-panel";const b=document.createElement("p");b.className="text-xs font-medium text-gray-500 uppercase tracking-wide",b.textContent=`Step ${d+1} of ${f}`,b.dataset.testid="step-counter",h.appendChild(b);const y=document.createElement("h3");y.className="text-lg font-semibold text-gray-900",y.textContent=u.title,y.dataset.testid="step-title",h.appendChild(y);const v=document.createElement("p");v.className="text-sm text-gray-600",v.textContent=u.description,v.dataset.testid="step-description",h.appendChild(v);const m=document.createElement("div");m.className="flex items-center gap-3 pt-2";const _=document.createElement("button");_.className="rounded-lg border border-gray-300 bg-white px-3 py-1.5 text-sm font-medium text-gray-700 hover:bg-gray-50 focus:outline-none focus:ring-2 focus:ring-indigo-500 focus:ring-offset-2 transition-colors disabled:opacity-50 disabled:cursor-not-allowed",_.textContent="Previous",_.dataset.testid="prev-btn",_.disabled=d===0,_.addEventListener("click",()=>{o.previous()}),m.appendChild(_);const A=document.createElement("button");A.className="rounded-lg bg-indigo-600 px-3 py-1.5 text-sm font-medium text-white hover:bg-indigo-700 focus:outline-none focus:ring-2 focus:ring-indigo-500 focus:ring-offset-2 transition-colors",A.textContent=d===f-1?"Finish":"Next",A.dataset.testid="next-btn",A.addEventListener("click",()=>{o.next()}),m.appendChild(A);const p=document.createElement("button");p.className="ml-auto rounded-lg border border-red-300 bg-white px-3 py-1.5 text-sm font-medium text-red-600 hover:bg-red-50 focus:outline-none focus:ring-2 focus:ring-red-500 focus:ring-offset-2 transition-colors",p.textContent="End Tour",p.dataset.testid="end-tour-btn",p.addEventListener("click",()=>{o.end()}),m.appendChild(p),h.appendChild(m),a.appendChild(h)}return s(),{destroy(){o.end(),e.innerHTML=""}}}var En={value:()=>{}};function Et(){for(var t=0,e=arguments.length,n={},r;t<e;++t){if(!(r=arguments[t]+"")||r in n||/[\s.]/.test(r))throw new Error("illegal type: "+r);n[r]=[]}return new It(n)}function It(t){this._=t}function An(t,e){return t.trim().split(/^|\s+/).map(function(n){var r="",i=n.indexOf(".");if(i>=0&&(r=n.slice(i+1),n=n.slice(0,i)),n&&!e.hasOwnProperty(n))throw new Error("unknown type: "+n);return{type:n,name:r}})}It.prototype=Et.prototype={constructor:It,on:function(t,e){var n=this._,r=An(t+"",n),i,o=-1,a=r.length;if(arguments.length<2){for(;++o<a;)if((i=(t=r[o]).type)&&(i=Cn(n[i],t.name)))return i;return}if(e!=null&&typeof e!="function")throw new Error("invalid callback: "+e);for(;++o<a;)if(i=(t=r[o]).type)n[i]=xe(n[i],t.name,e);else if(e==null)for(i in n)n[i]=xe(n[i],t.name,null);return this},copy:function(){var t={},e=this._;for(var n in e)t[n]=e[n].slice();return new It(t)},call:function(t,e){if((i=arguments.length-2)>0)for(var n=new Array(i),r=0,i,o;r<i;++r)n[r]=arguments[r+2];if(!this._.hasOwnProperty(t))throw new Error("unknown type: "+t);for(o=this._[t],r=0,i=o.length;r<i;++r)o[r].value.apply(e,n)},apply:function(t,e,n){if(!this._.hasOwnProperty(t))throw new Error("unknown type: "+t);for(var r=this._[t],i=0,o=r.length;i<o;++i)r[i].value.apply(e,n)}};function Cn(t,e){for(var n=0,r=t.length,i;n<r;++n)if((i=t[n]).name===e)return i.value}function xe(t,e,n){for(var r=0,i=t.length;r<i;++r)if(t[r].name===e){t[r]=En,t=t.slice(0,r).concat(t.slice(r+1));break}return n!=null&&t.push({name:e,value:n}),t}var te="http://www.w3.org/1999/xhtml";const ve={svg:"http://www.w3.org/2000/svg",xhtml:te,xlink:"http://www.w3.org/1999/xlink",xml:"http://www.w3.org/XML/1998/namespace",xmlns:"http://www.w3.org/2000/xmlns/"};function qt(t){var e=t+="",n=e.indexOf(":");return n>=0&&(e=t.slice(0,n))!=="xmlns"&&(t=t.slice(n+1)),ve.hasOwnProperty(e)?{space:ve[e],local:t}:t}function Mn(t){return function(){var e=this.ownerDocument,n=this.namespaceURI;return n===te&&e.documentElement.namespaceURI===te?e.createElement(t):e.createElementNS(n,t)}}function $n(t){return function(){return this.ownerDocument.createElementNS(t.space,t.local)}}function qe(t){var e=qt(t);return(e.local?$n:Mn)(e)}function Tn(){}function ue(t){return t==null?Tn:function(){return this.querySelector(t)}}function kn(t){typeof t!="function"&&(t=ue(t));for(var e=this._groups,n=e.length,r=new Array(n),i=0;i<n;++i)for(var o=e[i],a=o.length,s=r[i]=new Array(a),c,u,l=0;l<a;++l)(c=o[l])&&(u=t.call(c,c.__data__,l,o))&&("__data__"in c&&(u.__data__=c.__data__),s[l]=u);return new V(r,this._parents)}function Sn(t){return t==null?[]:Array.isArray(t)?t:Array.from(t)}function zn(){return[]}function Ve(t){return t==null?zn:function(){return this.querySelectorAll(t)}}function In(t){return function(){return Sn(t.apply(this,arguments))}}function Dn(t){typeof t=="function"?t=In(t):t=Ve(t);for(var e=this._groups,n=e.length,r=[],i=[],o=0;o<n;++o)for(var a=e[o],s=a.length,c,u=0;u<s;++u)(c=a[u])&&(r.push(t.call(c,c.__data__,u,a)),i.push(c));return new V(r,i)}function Ue(t){return function(){return this.matches(t)}}function Ge(t){return function(e){return e.matches(t)}}var Rn=Array.prototype.find;function Ln(t){return function(){return Rn.call(this.children,t)}}function Fn(){return this.firstElementChild}function Hn(t){return this.select(t==null?Fn:Ln(typeof t=="function"?t:Ge(t)))}var Bn=Array.prototype.filter;function Pn(){return Array.from(this.children)}function Xn(t){return function(){return Bn.call(this.children,t)}}function On(t){return this.selectAll(t==null?Pn:Xn(typeof t=="function"?t:Ge(t)))}function Yn(t){typeof t!="function"&&(t=Ue(t));for(var e=this._groups,n=e.length,r=new Array(n),i=0;i<n;++i)for(var o=e[i],a=o.length,s=r[i]=[],c,u=0;u<a;++u)(c=o[u])&&t.call(c,c.__data__,u,o)&&s.push(c);return new V(r,this._parents)}function Ke(t){return new Array(t.length)}function qn(){return new V(this._enter||this._groups.map(Ke),this._parents)}function Ft(t,e){this.ownerDocument=t.ownerDocument,this.namespaceURI=t.namespaceURI,this._next=null,this._parent=t,this.__data__=e}Ft.prototype={constructor:Ft,appendChild:function(t){return this._parent.insertBefore(t,this._next)},insertBefore:function(t,e){return this._parent.insertBefore(t,e)},querySelector:function(t){return this._parent.querySelector(t)},querySelectorAll:function(t){return this._parent.querySelectorAll(t)}};function Vn(t){return function(){return t}}function Un(t,e,n,r,i,o){for(var a=0,s,c=e.length,u=o.length;a<u;++a)(s=e[a])?(s.__data__=o[a],r[a]=s):n[a]=new Ft(t,o[a]);for(;a<c;++a)(s=e[a])&&(i[a]=s)}function Gn(t,e,n,r,i,o,a){var s,c,u=new Map,l=e.length,d=o.length,f=new Array(l),h;for(s=0;s<l;++s)(c=e[s])&&(f[s]=h=a.call(c,c.__data__,s,e)+"",u.has(h)?i[s]=c:u.set(h,c));for(s=0;s<d;++s)h=a.call(t,o[s],s,o)+"",(c=u.get(h))?(r[s]=c,c.__data__=o[s],u.delete(h)):n[s]=new Ft(t,o[s]);for(s=0;s<l;++s)(c=e[s])&&u.get(f[s])===c&&(i[s]=c)}function Kn(t){return t.__data__}function Wn(t,e){if(!arguments.length)return Array.from(this,Kn);var n=e?Gn:Un,r=this._parents,i=this._groups;typeof t!="function"&&(t=Vn(t));for(var o=i.length,a=new Array(o),s=new Array(o),c=new Array(o),u=0;u<o;++u){var l=r[u],d=i[u],f=d.length,h=Qn(t.call(l,l&&l.__data__,u,r)),b=h.length,y=s[u]=new Array(b),v=a[u]=new Array(b),m=c[u]=new Array(f);n(l,d,y,v,m,h,e);for(var _=0,A=0,p,E;_<b;++_)if(p=y[_]){for(_>=A&&(A=_+1);!(E=v[A])&&++A<b;);p._next=E||null}}return a=new V(a,r),a._enter=s,a._exit=c,a}function Qn(t){return typeof t=="object"&&"length"in t?t:Array.from(t)}function Zn(){return new V(this._exit||this._groups.map(Ke),this._parents)}function Jn(t,e,n){var r=this.enter(),i=this,o=this.exit();return typeof t=="function"?(r=t(r),r&&(r=r.selection())):r=r.append(t+""),e!=null&&(i=e(i),i&&(i=i.selection())),n==null?o.remove():n(o),r&&i?r.merge(i).order():i}function jn(t){for(var e=t.selection?t.selection():t,n=this._groups,r=e._groups,i=n.length,o=r.length,a=Math.min(i,o),s=new Array(i),c=0;c<a;++c)for(var u=n[c],l=r[c],d=u.length,f=s[c]=new Array(d),h,b=0;b<d;++b)(h=u[b]||l[b])&&(f[b]=h);for(;c<i;++c)s[c]=n[c];return new V(s,this._parents)}function tr(){for(var t=this._groups,e=-1,n=t.length;++e<n;)for(var r=t[e],i=r.length-1,o=r[i],a;--i>=0;)(a=r[i])&&(o&&a.compareDocumentPosition(o)^4&&o.parentNode.insertBefore(a,o),o=a);return this}function er(t){t||(t=nr);function e(d,f){return d&&f?t(d.__data__,f.__data__):!d-!f}for(var n=this._groups,r=n.length,i=new Array(r),o=0;o<r;++o){for(var a=n[o],s=a.length,c=i[o]=new Array(s),u,l=0;l<s;++l)(u=a[l])&&(c[l]=u);c.sort(e)}return new V(i,this._parents).order()}function nr(t,e){return t<e?-1:t>e?1:t>=e?0:NaN}function rr(){var t=arguments[0];return arguments[0]=this,t.apply(null,arguments),this}function ir(){return Array.from(this)}function or(){for(var t=this._groups,e=0,n=t.length;e<n;++e)for(var r=t[e],i=0,o=r.length;i<o;++i){var a=r[i];if(a)return a}return null}function ar(){let t=0;for(const e of this)++t;return t}function sr(){return!this.node()}function ur(t){for(var e=this._groups,n=0,r=e.length;n<r;++n)for(var i=e[n],o=0,a=i.length,s;o<a;++o)(s=i[o])&&t.call(s,s.__data__,o,i);return this}function cr(t){return function(){this.removeAttribute(t)}}function lr(t){return function(){this.removeAttributeNS(t.space,t.local)}}function fr(t,e){return function(){this.setAttribute(t,e)}}function hr(t,e){return function(){this.setAttributeNS(t.space,t.local,e)}}function dr(t,e){return function(){var n=e.apply(this,arguments);n==null?this.removeAttribute(t):this.setAttribute(t,n)}}function pr(t,e){return function(){var n=e.apply(this,arguments);n==null?this.removeAttributeNS(t.space,t.local):this.setAttributeNS(t.space,t.local,n)}}function gr(t,e){var n=qt(t);if(arguments.length<2){var r=this.node();return n.local?r.getAttributeNS(n.space,n.local):r.getAttribute(n)}return this.each((e==null?n.local?lr:cr:typeof e=="function"?n.local?pr:dr:n.local?hr:fr)(n,e))}function We(t){return t.ownerDocument&&t.ownerDocument.defaultView||t.document&&t||t.defaultView}function mr(t){return function(){this.style.removeProperty(t)}}function yr(t,e,n){return function(){this.style.setProperty(t,e,n)}}function xr(t,e,n){return function(){var r=e.apply(this,arguments);r==null?this.style.removeProperty(t):this.style.setProperty(t,r,n)}}function vr(t,e,n){return arguments.length>1?this.each((e==null?mr:typeof e=="function"?xr:yr)(t,e,n??"")):ht(this.node(),t)}function ht(t,e){return t.style.getPropertyValue(e)||We(t).getComputedStyle(t,null).getPropertyValue(e)}function wr(t){return function(){delete this[t]}}function _r(t,e){return function(){this[t]=e}}function br(t,e){return function(){var n=e.apply(this,arguments);n==null?delete this[t]:this[t]=n}}function Nr(t,e){return arguments.length>1?this.each((e==null?wr:typeof e=="function"?br:_r)(t,e)):this.node()[t]}function Qe(t){return t.trim().split(/^|\s+/)}function ce(t){return t.classList||new Ze(t)}function Ze(t){this._node=t,this._names=Qe(t.getAttribute("class")||"")}Ze.prototype={add:function(t){var e=this._names.indexOf(t);e<0&&(this._names.push(t),this._node.setAttribute("class",this._names.join(" ")))},remove:function(t){var e=this._names.indexOf(t);e>=0&&(this._names.splice(e,1),this._node.setAttribute("class",this._names.join(" ")))},contains:function(t){return this._names.indexOf(t)>=0}};function Je(t,e){for(var n=ce(t),r=-1,i=e.length;++r<i;)n.add(e[r])}function je(t,e){for(var n=ce(t),r=-1,i=e.length;++r<i;)n.remove(e[r])}function Er(t){return function(){Je(this,t)}}function Ar(t){return function(){je(this,t)}}function Cr(t,e){return function(){(e.apply(this,arguments)?Je:je)(this,t)}}function Mr(t,e){var n=Qe(t+"");if(arguments.length<2){for(var r=ce(this.node()),i=-1,o=n.length;++i<o;)if(!r.contains(n[i]))return!1;return!0}return this.each((typeof e=="function"?Cr:e?Er:Ar)(n,e))}function $r(){this.textContent=""}function Tr(t){return function(){this.textContent=t}}function kr(t){return function(){var e=t.apply(this,arguments);this.textContent=e??""}}function Sr(t){return arguments.length?this.each(t==null?$r:(typeof t=="function"?kr:Tr)(t)):this.node().textContent}function zr(){this.innerHTML=""}function Ir(t){return function(){this.innerHTML=t}}function Dr(t){return function(){var e=t.apply(this,arguments);this.innerHTML=e??""}}function Rr(t){return arguments.length?this.each(t==null?zr:(typeof t=="function"?Dr:Ir)(t)):this.node().innerHTML}function Lr(){this.nextSibling&&this.parentNode.appendChild(this)}function Fr(){return this.each(Lr)}function Hr(){this.previousSibling&&this.parentNode.insertBefore(this,this.parentNode.firstChild)}function Br(){return this.each(Hr)}function Pr(t){var e=typeof t=="function"?t:qe(t);return this.select(function(){return this.appendChild(e.apply(this,arguments))})}function Xr(){return null}function Or(t,e){var n=typeof t=="function"?t:qe(t),r=e==null?Xr:typeof e=="function"?e:ue(e);return this.select(function(){return this.insertBefore(n.apply(this,arguments),r.apply(this,arguments)||null)})}function Yr(){var t=this.parentNode;t&&t.removeChild(this)}function qr(){return this.each(Yr)}function Vr(){var t=this.cloneNode(!1),e=this.parentNode;return e?e.insertBefore(t,this.nextSibling):t}function Ur(){var t=this.cloneNode(!0),e=this.parentNode;return e?e.insertBefore(t,this.nextSibling):t}function Gr(t){return this.select(t?Ur:Vr)}function Kr(t){return arguments.length?this.property("__data__",t):this.node().__data__}function Wr(t){return function(e){t.call(this,e,this.__data__)}}function Qr(t){return t.trim().split(/^|\s+/).map(function(e){var n="",r=e.indexOf(".");return r>=0&&(n=e.slice(r+1),e=e.slice(0,r)),{type:e,name:n}})}function Zr(t){return function(){var e=this.__on;if(e){for(var n=0,r=-1,i=e.length,o;n<i;++n)o=e[n],(!t.type||o.type===t.type)&&o.name===t.name?this.removeEventListener(o.type,o.listener,o.options):e[++r]=o;++r?e.length=r:delete this.__on}}}function Jr(t,e,n){return function(){var r=this.__on,i,o=Wr(e);if(r){for(var a=0,s=r.length;a<s;++a)if((i=r[a]).type===t.type&&i.name===t.name){this.removeEventListener(i.type,i.listener,i.options),this.addEventListener(i.type,i.listener=o,i.options=n),i.value=e;return}}this.addEventListener(t.type,o,n),i={type:t.type,name:t.name,value:e,listener:o,options:n},r?r.push(i):this.__on=[i]}}function jr(t,e,n){var r=Qr(t+""),i,o=r.length,a;if(arguments.length<2){var s=this.node().__on;if(s){for(var c=0,u=s.length,l;c<u;++c)for(i=0,l=s[c];i<o;++i)if((a=r[i]).type===l.type&&a.name===l.name)return l.value}return}for(s=e?Jr:Zr,i=0;i<o;++i)this.each(s(r[i],e,n));return this}function tn(t,e,n){var r=We(t),i=r.CustomEvent;typeof i=="function"?i=new i(e,n):(i=r.document.createEvent("Event"),n?(i.initEvent(e,n.bubbles,n.cancelable),i.detail=n.detail):i.initEvent(e,!1,!1)),t.dispatchEvent(i)}function ti(t,e){return function(){return tn(this,t,e)}}function ei(t,e){return function(){return tn(this,t,e.apply(this,arguments))}}function ni(t,e){return this.each((typeof e=="function"?ei:ti)(t,e))}function*ri(){for(var t=this._groups,e=0,n=t.length;e<n;++e)for(var r=t[e],i=0,o=r.length,a;i<o;++i)(a=r[i])&&(yield a)}var en=[null];function V(t,e){this._groups=t,this._parents=e}function At(){return new V([[document.documentElement]],en)}function ii(){return this}V.prototype=At.prototype={constructor:V,select:kn,selectAll:Dn,selectChild:Hn,selectChildren:On,filter:Yn,data:Wn,enter:qn,exit:Zn,join:Jn,merge:jn,selection:ii,order:tr,sort:er,call:rr,nodes:ir,node:or,size:ar,empty:sr,each:ur,attr:gr,style:vr,property:Nr,classed:Mr,text:Sr,html:Rr,raise:Fr,lower:Br,append:Pr,insert:Or,remove:qr,clone:Gr,datum:Kr,on:jr,dispatch:ni,[Symbol.iterator]:ri};function X(t){return typeof t=="string"?new V([[document.querySelector(t)]],[document.documentElement]):new V([[t]],en)}function oi(t){let e;for(;e=t.sourceEvent;)t=e;return t}function et(t,e){if(t=oi(t),e===void 0&&(e=t.currentTarget),e){var n=e.ownerSVGElement||e;if(n.createSVGPoint){var r=n.createSVGPoint();return r.x=t.clientX,r.y=t.clientY,r=r.matrixTransform(e.getScreenCTM().inverse()),[r.x,r.y]}if(e.getBoundingClientRect){var i=e.getBoundingClientRect();return[t.clientX-i.left-e.clientLeft,t.clientY-i.top-e.clientTop]}}return[t.pageX,t.pageY]}const ai={passive:!1},vt={capture:!0,passive:!1};function Kt(t){t.stopImmediatePropagation()}function lt(t){t.preventDefault(),t.stopImmediatePropagation()}function nn(t){var e=t.document.documentElement,n=X(t).on("dragstart.drag",lt,vt);"onselectstart"in e?n.on("selectstart.drag",lt,vt):(e.__noselect=e.style.MozUserSelect,e.style.MozUserSelect="none")}function rn(t,e){var n=t.document.documentElement,r=X(t).on("dragstart.drag",null);e&&(r.on("click.drag",lt,vt),setTimeout(function(){r.on("click.drag",null)},0)),"onselectstart"in n?r.on("selectstart.drag",null):(n.style.MozUserSelect=n.__noselect,delete n.__noselect)}const Mt=t=>()=>t;function ee(t,{sourceEvent:e,subject:n,target:r,identifier:i,active:o,x:a,y:s,dx:c,dy:u,dispatch:l}){Object.defineProperties(this,{type:{value:t,enumerable:!0,configurable:!0},sourceEvent:{value:e,enumerable:!0,configurable:!0},subject:{value:n,enumerable:!0,configurable:!0},target:{value:r,enumerable:!0,configurable:!0},identifier:{value:i,enumerable:!0,configurable:!0},active:{value:o,enumerable:!0,configurable:!0},x:{value:a,enumerable:!0,configurable:!0},y:{value:s,enumerable:!0,configurable:!0},dx:{value:c,enumerable:!0,configurable:!0},dy:{value:u,enumerable:!0,configurable:!0},_:{value:l}})}ee.prototype.on=function(){var t=this._.on.apply(this._,arguments);return t===this._?this:t};function si(t){return!t.ctrlKey&&!t.button}function ui(){return this.parentNode}function ci(t,e){return e??{x:t.x,y:t.y}}function li(){return navigator.maxTouchPoints||"ontouchstart"in this}function fi(){var t=si,e=ui,n=ci,r=li,i={},o=Et("start","drag","end"),a=0,s,c,u,l,d=0;function f(p){p.on("mousedown.drag",h).filter(r).on("touchstart.drag",v).on("touchmove.drag",m,ai).on("touchend.drag touchcancel.drag",_).style("touch-action","none").style("-webkit-tap-highlight-color","rgba(0,0,0,0)")}function h(p,E){if(!(l||!t.call(this,p,E))){var C=A(this,e.call(this,p,E),p,E,"mouse");C&&(X(p.view).on("mousemove.drag",b,vt).on("mouseup.drag",y,vt),nn(p.view),Kt(p),u=!1,s=p.clientX,c=p.clientY,C("start",p))}}function b(p){if(lt(p),!u){var E=p.clientX-s,C=p.clientY-c;u=E*E+C*C>d}i.mouse("drag",p)}function y(p){X(p.view).on("mousemove.drag mouseup.drag",null),rn(p.view,u),lt(p),i.mouse("end",p)}function v(p,E){if(t.call(this,p,E)){var C=p.changedTouches,$=e.call(this,p,E),T=C.length,D,z;for(D=0;D<T;++D)(z=A(this,$,p,E,C[D].identifier,C[D]))&&(Kt(p),z("start",p,C[D]))}}function m(p){var E=p.changedTouches,C=E.length,$,T;for($=0;$<C;++$)(T=i[E[$].identifier])&&(lt(p),T("drag",p,E[$]))}function _(p){var E=p.changedTouches,C=E.length,$,T;for(l&&clearTimeout(l),l=setTimeout(function(){l=null},500),$=0;$<C;++$)(T=i[E[$].identifier])&&(Kt(p),T("end",p,E[$]))}function A(p,E,C,$,T,D){var z=o.copy(),L=et(D||C,E),R,P,g;if((g=n.call(p,new ee("beforestart",{sourceEvent:C,target:f,identifier:T,active:a,x:L[0],y:L[1],dx:0,dy:0,dispatch:z}),$))!=null)return R=g.x-L[0]||0,P=g.y-L[1]||0,function x(w,N,M){var k=L,S;switch(w){case"start":i[T]=x,S=a++;break;case"end":delete i[T],--a;case"drag":L=et(M||N,E),S=a;break}z.call(w,p,new ee(w,{sourceEvent:N,subject:g,target:f,identifier:T,active:S,x:L[0]+R,y:L[1]+P,dx:L[0]-k[0],dy:L[1]-k[1],dispatch:z}),$)}}return f.filter=function(p){return arguments.length?(t=typeof p=="function"?p:Mt(!!p),f):t},f.container=function(p){return arguments.length?(e=typeof p=="function"?p:Mt(p),f):e},f.subject=function(p){return arguments.length?(n=typeof p=="function"?p:Mt(p),f):n},f.touchable=function(p){return arguments.length?(r=typeof p=="function"?p:Mt(!!p),f):r},f.on=function(){var p=o.on.apply(o,arguments);return p===o?f:p},f.clickDistance=function(p){return arguments.length?(d=(p=+p)*p,f):Math.sqrt(d)},f}function le(t,e,n){t.prototype=e.prototype=n,n.constructor=t}function on(t,e){var n=Object.create(t.prototype);for(var r in e)n[r]=e[r];return n}function Ct(){}var wt=.7,Ht=1/wt,ft="\\s*([+-]?\\d+)\\s*",_t="\\s*([+-]?(?:\\d*\\.)?\\d+(?:[eE][+-]?\\d+)?)\\s*",Q="\\s*([+-]?(?:\\d*\\.)?\\d+(?:[eE][+-]?\\d+)?)%\\s*",hi=/^#([0-9a-f]{3,8})$/,di=new RegExp(`^rgb\\(${ft},${ft},${ft}\\)$`),pi=new RegExp(`^rgb\\(${Q},${Q},${Q}\\)$`),gi=new RegExp(`^rgba\\(${ft},${ft},${ft},${_t}\\)$`),mi=new RegExp(`^rgba\\(${Q},${Q},${Q},${_t}\\)$`),yi=new RegExp(`^hsl\\(${_t},${Q},${Q}\\)$`),xi=new RegExp(`^hsla\\(${_t},${Q},${Q},${_t}\\)$`),we={aliceblue:15792383,antiquewhite:16444375,aqua:65535,aquamarine:8388564,azure:15794175,beige:16119260,bisque:16770244,black:0,blanchedalmond:16772045,blue:255,blueviolet:9055202,brown:10824234,burlywood:14596231,cadetblue:6266528,chartreuse:8388352,chocolate:13789470,coral:16744272,cornflowerblue:6591981,cornsilk:16775388,crimson:14423100,cyan:65535,darkblue:139,darkcyan:35723,darkgoldenrod:12092939,darkgray:11119017,darkgreen:25600,darkgrey:11119017,darkkhaki:12433259,darkmagenta:9109643,darkolivegreen:5597999,darkorange:16747520,darkorchid:10040012,darkred:9109504,darksalmon:15308410,darkseagreen:9419919,darkslateblue:4734347,darkslategray:3100495,darkslategrey:3100495,darkturquoise:52945,darkviolet:9699539,deeppink:16716947,deepskyblue:49151,dimgray:6908265,dimgrey:6908265,dodgerblue:2003199,firebrick:11674146,floralwhite:16775920,forestgreen:2263842,fuchsia:16711935,gainsboro:14474460,ghostwhite:16316671,gold:16766720,goldenrod:14329120,gray:8421504,green:32768,greenyellow:11403055,grey:8421504,honeydew:15794160,hotpink:16738740,indianred:13458524,indigo:4915330,ivory:16777200,khaki:15787660,lavender:15132410,lavenderblush:16773365,lawngreen:8190976,lemonchiffon:16775885,lightblue:11393254,lightcoral:15761536,lightcyan:14745599,lightgoldenrodyellow:16448210,lightgray:13882323,lightgreen:9498256,lightgrey:13882323,lightpink:16758465,lightsalmon:16752762,lightseagreen:2142890,lightskyblue:8900346,lightslategray:7833753,lightslategrey:7833753,lightsteelblue:11584734,lightyellow:16777184,lime:65280,limegreen:3329330,linen:16445670,magenta:16711935,maroon:8388608,mediumaquamarine:6737322,mediumblue:205,mediumorchid:12211667,mediumpurple:9662683,mediumseagreen:3978097,mediumslateblue:8087790,mediumspringgreen:64154,mediumturquoise:4772300,mediumvioletred:13047173,midnightblue:1644912,mintcream:16121850,mistyrose:16770273,moccasin:16770229,navajowhite:16768685,navy:128,oldlace:16643558,olive:8421376,olivedrab:7048739,orange:16753920,orangered:16729344,orchid:14315734,palegoldenrod:15657130,palegreen:10025880,paleturquoise:11529966,palevioletred:14381203,papayawhip:16773077,peachpuff:16767673,peru:13468991,pink:16761035,plum:14524637,powderblue:11591910,purple:8388736,rebeccapurple:6697881,red:16711680,rosybrown:12357519,royalblue:4286945,saddlebrown:9127187,salmon:16416882,sandybrown:16032864,seagreen:3050327,seashell:16774638,sienna:10506797,silver:12632256,skyblue:8900331,slateblue:6970061,slategray:7372944,slategrey:7372944,snow:16775930,springgreen:65407,steelblue:4620980,tan:13808780,teal:32896,thistle:14204888,tomato:16737095,turquoise:4251856,violet:15631086,wheat:16113331,white:16777215,whitesmoke:16119285,yellow:16776960,yellowgreen:10145074};le(Ct,bt,{copy(t){return Object.assign(new this.constructor,this,t)},displayable(){return this.rgb().displayable()},hex:_e,formatHex:_e,formatHex8:vi,formatHsl:wi,formatRgb:be,toString:be});function _e(){return this.rgb().formatHex()}function vi(){return this.rgb().formatHex8()}function wi(){return an(this).formatHsl()}function be(){return this.rgb().formatRgb()}function bt(t){var e,n;return t=(t+"").trim().toLowerCase(),(e=hi.exec(t))?(n=e[1].length,e=parseInt(e[1],16),n===6?Ne(e):n===3?new q(e>>8&15|e>>4&240,e>>4&15|e&240,(e&15)<<4|e&15,1):n===8?$t(e>>24&255,e>>16&255,e>>8&255,(e&255)/255):n===4?$t(e>>12&15|e>>8&240,e>>8&15|e>>4&240,e>>4&15|e&240,((e&15)<<4|e&15)/255):null):(e=di.exec(t))?new q(e[1],e[2],e[3],1):(e=pi.exec(t))?new q(e[1]*255/100,e[2]*255/100,e[3]*255/100,1):(e=gi.exec(t))?$t(e[1],e[2],e[3],e[4]):(e=mi.exec(t))?$t(e[1]*255/100,e[2]*255/100,e[3]*255/100,e[4]):(e=yi.exec(t))?Ce(e[1],e[2]/100,e[3]/100,1):(e=xi.exec(t))?Ce(e[1],e[2]/100,e[3]/100,e[4]):we.hasOwnProperty(t)?Ne(we[t]):t==="transparent"?new q(NaN,NaN,NaN,0):null}function Ne(t){return new q(t>>16&255,t>>8&255,t&255,1)}function $t(t,e,n,r){return r<=0&&(t=e=n=NaN),new q(t,e,n,r)}function _i(t){return t instanceof Ct||(t=bt(t)),t?(t=t.rgb(),new q(t.r,t.g,t.b,t.opacity)):new q}function ne(t,e,n,r){return arguments.length===1?_i(t):new q(t,e,n,r??1)}function q(t,e,n,r){this.r=+t,this.g=+e,this.b=+n,this.opacity=+r}le(q,ne,on(Ct,{brighter(t){return t=t==null?Ht:Math.pow(Ht,t),new q(this.r*t,this.g*t,this.b*t,this.opacity)},darker(t){return t=t==null?wt:Math.pow(wt,t),new q(this.r*t,this.g*t,this.b*t,this.opacity)},rgb(){return this},clamp(){return new q(st(this.r),st(this.g),st(this.b),Bt(this.opacity))},displayable(){return-.5<=this.r&&this.r<255.5&&-.5<=this.g&&this.g<255.5&&-.5<=this.b&&this.b<255.5&&0<=this.opacity&&this.opacity<=1},hex:Ee,formatHex:Ee,formatHex8:bi,formatRgb:Ae,toString:Ae}));function Ee(){return`#${at(this.r)}${at(this.g)}${at(this.b)}`}function bi(){return`#${at(this.r)}${at(this.g)}${at(this.b)}${at((isNaN(this.opacity)?1:this.opacity)*255)}`}function Ae(){const t=Bt(this.opacity);return`${t===1?"rgb(":"rgba("}${st(this.r)}, ${st(this.g)}, ${st(this.b)}${t===1?")":`, ${t})`}`}function Bt(t){return isNaN(t)?1:Math.max(0,Math.min(1,t))}function st(t){return Math.max(0,Math.min(255,Math.round(t)||0))}function at(t){return t=st(t),(t<16?"0":"")+t.toString(16)}function Ce(t,e,n,r){return r<=0?t=e=n=NaN:n<=0||n>=1?t=e=NaN:e<=0&&(t=NaN),new K(t,e,n,r)}function an(t){if(t instanceof K)return new K(t.h,t.s,t.l,t.opacity);if(t instanceof Ct||(t=bt(t)),!t)return new K;if(t instanceof K)return t;t=t.rgb();var e=t.r/255,n=t.g/255,r=t.b/255,i=Math.min(e,n,r),o=Math.max(e,n,r),a=NaN,s=o-i,c=(o+i)/2;return s?(e===o?a=(n-r)/s+(n<r)*6:n===o?a=(r-e)/s+2:a=(e-n)/s+4,s/=c<.5?o+i:2-o-i,a*=60):s=c>0&&c<1?0:a,new K(a,s,c,t.opacity)}function Ni(t,e,n,r){return arguments.length===1?an(t):new K(t,e,n,r??1)}function K(t,e,n,r){this.h=+t,this.s=+e,this.l=+n,this.opacity=+r}le(K,Ni,on(Ct,{brighter(t){return t=t==null?Ht:Math.pow(Ht,t),new K(this.h,this.s,this.l*t,this.opacity)},darker(t){return t=t==null?wt:Math.pow(wt,t),new K(this.h,this.s,this.l*t,this.opacity)},rgb(){var t=this.h%360+(this.h<0)*360,e=isNaN(t)||isNaN(this.s)?0:this.s,n=this.l,r=n+(n<.5?n:1-n)*e,i=2*n-r;return new q(Wt(t>=240?t-240:t+120,i,r),Wt(t,i,r),Wt(t<120?t+240:t-120,i,r),this.opacity)},clamp(){return new K(Me(this.h),Tt(this.s),Tt(this.l),Bt(this.opacity))},displayable(){return(0<=this.s&&this.s<=1||isNaN(this.s))&&0<=this.l&&this.l<=1&&0<=this.opacity&&this.opacity<=1},formatHsl(){const t=Bt(this.opacity);return`${t===1?"hsl(":"hsla("}${Me(this.h)}, ${Tt(this.s)*100}%, ${Tt(this.l)*100}%${t===1?")":`, ${t})`}`}}));function Me(t){return t=(t||0)%360,t<0?t+360:t}function Tt(t){return Math.max(0,Math.min(1,t||0))}function Wt(t,e,n){return(t<60?e+(n-e)*t/60:t<180?n:t<240?e+(n-e)*(240-t)/60:e)*255}const sn=t=>()=>t;function Ei(t,e){return function(n){return t+n*e}}function Ai(t,e,n){return t=Math.pow(t,n),e=Math.pow(e,n)-t,n=1/n,function(r){return Math.pow(t+r*e,n)}}function Ci(t){return(t=+t)==1?un:function(e,n){return n-e?Ai(e,n,t):sn(isNaN(e)?n:e)}}function un(t,e){var n=e-t;return n?Ei(t,n):sn(isNaN(t)?e:t)}const $e=(function t(e){var n=Ci(e);function r(i,o){var a=n((i=ne(i)).r,(o=ne(o)).r),s=n(i.g,o.g),c=n(i.b,o.b),u=un(i.opacity,o.opacity);return function(l){return i.r=a(l),i.g=s(l),i.b=c(l),i.opacity=u(l),i+""}}return r.gamma=t,r})(1);function it(t,e){return t=+t,e=+e,function(n){return t*(1-n)+e*n}}var re=/[-+]?(?:\d+\.?\d*|\.?\d+)(?:[eE][-+]?\d+)?/g,Qt=new RegExp(re.source,"g");function Mi(t){return function(){return t}}function $i(t){return function(e){return t(e)+""}}function Ti(t,e){var n=re.lastIndex=Qt.lastIndex=0,r,i,o,a=-1,s=[],c=[];for(t=t+"",e=e+"";(r=re.exec(t))&&(i=Qt.exec(e));)(o=i.index)>n&&(o=e.slice(n,o),s[a]?s[a]+=o:s[++a]=o),(r=r[0])===(i=i[0])?s[a]?s[a]+=i:s[++a]=i:(s[++a]=null,c.push({i:a,x:it(r,i)})),n=Qt.lastIndex;return n<e.length&&(o=e.slice(n),s[a]?s[a]+=o:s[++a]=o),s.length<2?c[0]?$i(c[0].x):Mi(e):(e=c.length,function(u){for(var l=0,d;l<e;++l)s[(d=c[l]).i]=d.x(u);return s.join("")})}var Te=180/Math.PI,ie={translateX:0,translateY:0,rotate:0,skewX:0,scaleX:1,scaleY:1};function cn(t,e,n,r,i,o){var a,s,c;return(a=Math.sqrt(t*t+e*e))&&(t/=a,e/=a),(c=t*n+e*r)&&(n-=t*c,r-=e*c),(s=Math.sqrt(n*n+r*r))&&(n/=s,r/=s,c/=s),t*r<e*n&&(t=-t,e=-e,c=-c,a=-a),{translateX:i,translateY:o,rotate:Math.atan2(e,t)*Te,skewX:Math.atan(c)*Te,scaleX:a,scaleY:s}}var kt;function ki(t){const e=new(typeof DOMMatrix=="function"?DOMMatrix:WebKitCSSMatrix)(t+"");return e.isIdentity?ie:cn(e.a,e.b,e.c,e.d,e.e,e.f)}function Si(t){return t==null||(kt||(kt=document.createElementNS("http://www.w3.org/2000/svg","g")),kt.setAttribute("transform",t),!(t=kt.transform.baseVal.consolidate()))?ie:(t=t.matrix,cn(t.a,t.b,t.c,t.d,t.e,t.f))}function ln(t,e,n,r){function i(u){return u.length?u.pop()+" ":""}function o(u,l,d,f,h,b){if(u!==d||l!==f){var y=h.push("translate(",null,e,null,n);b.push({i:y-4,x:it(u,d)},{i:y-2,x:it(l,f)})}else(d||f)&&h.push("translate("+d+e+f+n)}function a(u,l,d,f){u!==l?(u-l>180?l+=360:l-u>180&&(u+=360),f.push({i:d.push(i(d)+"rotate(",null,r)-2,x:it(u,l)})):l&&d.push(i(d)+"rotate("+l+r)}function s(u,l,d,f){u!==l?f.push({i:d.push(i(d)+"skewX(",null,r)-2,x:it(u,l)}):l&&d.push(i(d)+"skewX("+l+r)}function c(u,l,d,f,h,b){if(u!==d||l!==f){var y=h.push(i(h)+"scale(",null,",",null,")");b.push({i:y-4,x:it(u,d)},{i:y-2,x:it(l,f)})}else(d!==1||f!==1)&&h.push(i(h)+"scale("+d+","+f+")")}return function(u,l){var d=[],f=[];return u=t(u),l=t(l),o(u.translateX,u.translateY,l.translateX,l.translateY,d,f),a(u.rotate,l.rotate,d,f),s(u.skewX,l.skewX,d,f),c(u.scaleX,u.scaleY,l.scaleX,l.scaleY,d,f),u=l=null,function(h){for(var b=-1,y=f.length,v;++b<y;)d[(v=f[b]).i]=v.x(h);return d.join("")}}}var zi=ln(ki,"px, ","px)","deg)"),Ii=ln(Si,", ",")",")"),Di=1e-12;function ke(t){return((t=Math.exp(t))+1/t)/2}function Ri(t){return((t=Math.exp(t))-1/t)/2}function Li(t){return((t=Math.exp(2*t))-1)/(t+1)}const Fi=(function t(e,n,r){function i(o,a){var s=o[0],c=o[1],u=o[2],l=a[0],d=a[1],f=a[2],h=l-s,b=d-c,y=h*h+b*b,v,m;if(y<Di)m=Math.log(f/u)/e,v=function($){return[s+$*h,c+$*b,u*Math.exp(e*$*m)]};else{var _=Math.sqrt(y),A=(f*f-u*u+r*y)/(2*u*n*_),p=(f*f-u*u-r*y)/(2*f*n*_),E=Math.log(Math.sqrt(A*A+1)-A),C=Math.log(Math.sqrt(p*p+1)-p);m=(C-E)/e,v=function($){var T=$*m,D=ke(E),z=u/(n*_)*(D*Li(e*T+E)-Ri(E));return[s+z*h,c+z*b,u*D/ke(e*T+E)]}}return v.duration=m*1e3*e/Math.SQRT2,v}return i.rho=function(o){var a=Math.max(.001,+o),s=a*a,c=s*s;return t(a,s,c)},i})(Math.SQRT2,2,4);var dt=0,yt=0,pt=0,fn=1e3,Pt,xt,Xt=0,ct=0,Vt=0,Nt=typeof performance=="object"&&performance.now?performance:Date,hn=typeof window=="object"&&window.requestAnimationFrame?window.requestAnimationFrame.bind(window):function(t){setTimeout(t,17)};function fe(){return ct||(hn(Hi),ct=Nt.now()+Vt)}function Hi(){ct=0}function Ot(){this._call=this._time=this._next=null}Ot.prototype=he.prototype={constructor:Ot,restart:function(t,e,n){if(typeof t!="function")throw new TypeError("callback is not a function");n=(n==null?fe():+n)+(e==null?0:+e),!this._next&&xt!==this&&(xt?xt._next=this:Pt=this,xt=this),this._call=t,this._time=n,oe()},stop:function(){this._call&&(this._call=null,this._time=1/0,oe())}};function he(t,e,n){var r=new Ot;return r.restart(t,e,n),r}function Bi(){fe(),++dt;for(var t=Pt,e;t;)(e=ct-t._time)>=0&&t._call.call(void 0,e),t=t._next;--dt}function Se(){ct=(Xt=Nt.now())+Vt,dt=yt=0;try{Bi()}finally{dt=0,Xi(),ct=0}}function Pi(){var t=Nt.now(),e=t-Xt;e>fn&&(Vt-=e,Xt=t)}function Xi(){for(var t,e=Pt,n,r=1/0;e;)e._call?(r>e._time&&(r=e._time),t=e,e=e._next):(n=e._next,e._next=null,e=t?t._next=n:Pt=n);xt=t,oe(r)}function oe(t){if(!dt){yt&&(yt=clearTimeout(yt));var e=t-ct;e>24?(t<1/0&&(yt=setTimeout(Se,t-Nt.now()-Vt)),pt&&(pt=clearInterval(pt))):(pt||(Xt=Nt.now(),pt=setInterval(Pi,fn)),dt=1,hn(Se))}}function ze(t,e,n){var r=new Ot;return e=e==null?0:+e,r.restart(i=>{r.stop(),t(i+e)},e,n),r}var Oi=Et("start","end","cancel","interrupt"),Yi=[],dn=0,Ie=1,ae=2,Dt=3,De=4,se=5,Rt=6;function Ut(t,e,n,r,i,o){var a=t.__transition;if(!a)t.__transition={};else if(n in a)return;qi(t,n,{name:e,index:r,group:i,on:Oi,tween:Yi,time:o.time,delay:o.delay,duration:o.duration,ease:o.ease,timer:null,state:dn})}function de(t,e){var n=W(t,e);if(n.state>dn)throw new Error("too late; already scheduled");return n}function Z(t,e){var n=W(t,e);if(n.state>Dt)throw new Error("too late; already running");return n}function W(t,e){var n=t.__transition;if(!n||!(n=n[e]))throw new Error("transition not found");return n}function qi(t,e,n){var r=t.__transition,i;r[e]=n,n.timer=he(o,0,n.time);function o(u){n.state=Ie,n.timer.restart(a,n.delay,n.time),n.delay<=u&&a(u-n.delay)}function a(u){var l,d,f,h;if(n.state!==Ie)return c();for(l in r)if(h=r[l],h.name===n.name){if(h.state===Dt)return ze(a);h.state===De?(h.state=Rt,h.timer.stop(),h.on.call("interrupt",t,t.__data__,h.index,h.group),delete r[l]):+l<e&&(h.state=Rt,h.timer.stop(),h.on.call("cancel",t,t.__data__,h.index,h.group),delete r[l])}if(ze(function(){n.state===Dt&&(n.state=De,n.timer.restart(s,n.delay,n.time),s(u))}),n.state=ae,n.on.call("start",t,t.__data__,n.index,n.group),n.state===ae){for(n.state=Dt,i=new Array(f=n.tween.length),l=0,d=-1;l<f;++l)(h=n.tween[l].value.call(t,t.__data__,n.index,n.group))&&(i[++d]=h);i.length=d+1}}function s(u){for(var l=u<n.duration?n.ease.call(null,u/n.duration):(n.timer.restart(c),n.state=se,1),d=-1,f=i.length;++d<f;)i[d].call(t,l);n.state===se&&(n.on.call("end",t,t.__data__,n.index,n.group),c())}function c(){n.state=Rt,n.timer.stop(),delete r[e];for(var u in r)return;delete t.__transition}}function Lt(t,e){var n=t.__transition,r,i,o=!0,a;if(n){e=e==null?null:e+"";for(a in n){if((r=n[a]).name!==e){o=!1;continue}i=r.state>ae&&r.state<se,r.state=Rt,r.timer.stop(),r.on.call(i?"interrupt":"cancel",t,t.__data__,r.index,r.group),delete n[a]}o&&delete t.__transition}}function Vi(t){return this.each(function(){Lt(this,t)})}function Ui(t,e){var n,r;return function(){var i=Z(this,t),o=i.tween;if(o!==n){r=n=o;for(var a=0,s=r.length;a<s;++a)if(r[a].name===e){r=r.slice(),r.splice(a,1);break}}i.tween=r}}function Gi(t,e,n){var r,i;if(typeof n!="function")throw new Error;return function(){var o=Z(this,t),a=o.tween;if(a!==r){i=(r=a).slice();for(var s={name:e,value:n},c=0,u=i.length;c<u;++c)if(i[c].name===e){i[c]=s;break}c===u&&i.push(s)}o.tween=i}}function Ki(t,e){var n=this._id;if(t+="",arguments.length<2){for(var r=W(this.node(),n).tween,i=0,o=r.length,a;i<o;++i)if((a=r[i]).name===t)return a.value;return null}return this.each((e==null?Ui:Gi)(n,t,e))}function pe(t,e,n){var r=t._id;return t.each(function(){var i=Z(this,r);(i.value||(i.value={}))[e]=n.apply(this,arguments)}),function(i){return W(i,r).value[e]}}function pn(t,e){var n;return(typeof e=="number"?it:e instanceof bt?$e:(n=bt(e))?(e=n,$e):Ti)(t,e)}function Wi(t){return function(){this.removeAttribute(t)}}function Qi(t){return function(){this.removeAttributeNS(t.space,t.local)}}function Zi(t,e,n){var r,i=n+"",o;return function(){var a=this.getAttribute(t);return a===i?null:a===r?o:o=e(r=a,n)}}function Ji(t,e,n){var r,i=n+"",o;return function(){var a=this.getAttributeNS(t.space,t.local);return a===i?null:a===r?o:o=e(r=a,n)}}function ji(t,e,n){var r,i,o;return function(){var a,s=n(this),c;return s==null?void this.removeAttribute(t):(a=this.getAttribute(t),c=s+"",a===c?null:a===r&&c===i?o:(i=c,o=e(r=a,s)))}}function to(t,e,n){var r,i,o;return function(){var a,s=n(this),c;return s==null?void this.removeAttributeNS(t.space,t.local):(a=this.getAttributeNS(t.space,t.local),c=s+"",a===c?null:a===r&&c===i?o:(i=c,o=e(r=a,s)))}}function eo(t,e){var n=qt(t),r=n==="transform"?Ii:pn;return this.attrTween(t,typeof e=="function"?(n.local?to:ji)(n,r,pe(this,"attr."+t,e)):e==null?(n.local?Qi:Wi)(n):(n.local?Ji:Zi)(n,r,e))}function no(t,e){return function(n){this.setAttribute(t,e.call(this,n))}}function ro(t,e){return function(n){this.setAttributeNS(t.space,t.local,e.call(this,n))}}function io(t,e){var n,r;function i(){var o=e.apply(this,arguments);return o!==r&&(n=(r=o)&&ro(t,o)),n}return i._value=e,i}function oo(t,e){var n,r;function i(){var o=e.apply(this,arguments);return o!==r&&(n=(r=o)&&no(t,o)),n}return i._value=e,i}function ao(t,e){var n="attr."+t;if(arguments.length<2)return(n=this.tween(n))&&n._value;if(e==null)return this.tween(n,null);if(typeof e!="function")throw new Error;var r=qt(t);return this.tween(n,(r.local?io:oo)(r,e))}function so(t,e){return function(){de(this,t).delay=+e.apply(this,arguments)}}function uo(t,e){return e=+e,function(){de(this,t).delay=e}}function co(t){var e=this._id;return arguments.length?this.each((typeof t=="function"?so:uo)(e,t)):W(this.node(),e).delay}function lo(t,e){return function(){Z(this,t).duration=+e.apply(this,arguments)}}function fo(t,e){return e=+e,function(){Z(this,t).duration=e}}function ho(t){var e=this._id;return arguments.length?this.each((typeof t=="function"?lo:fo)(e,t)):W(this.node(),e).duration}function po(t,e){if(typeof e!="function")throw new Error;return function(){Z(this,t).ease=e}}function go(t){var e=this._id;return arguments.length?this.each(po(e,t)):W(this.node(),e).ease}function mo(t,e){return function(){var n=e.apply(this,arguments);if(typeof n!="function")throw new Error;Z(this,t).ease=n}}function yo(t){if(typeof t!="function")throw new Error;return this.each(mo(this._id,t))}function xo(t){typeof t!="function"&&(t=Ue(t));for(var e=this._groups,n=e.length,r=new Array(n),i=0;i<n;++i)for(var o=e[i],a=o.length,s=r[i]=[],c,u=0;u<a;++u)(c=o[u])&&t.call(c,c.__data__,u,o)&&s.push(c);return new rt(r,this._parents,this._name,this._id)}function vo(t){if(t._id!==this._id)throw new Error;for(var e=this._groups,n=t._groups,r=e.length,i=n.length,o=Math.min(r,i),a=new Array(r),s=0;s<o;++s)for(var c=e[s],u=n[s],l=c.length,d=a[s]=new Array(l),f,h=0;h<l;++h)(f=c[h]||u[h])&&(d[h]=f);for(;s<r;++s)a[s]=e[s];return new rt(a,this._parents,this._name,this._id)}function wo(t){return(t+"").trim().split(/^|\s+/).every(function(e){var n=e.indexOf(".");return n>=0&&(e=e.slice(0,n)),!e||e==="start"})}function _o(t,e,n){var r,i,o=wo(e)?de:Z;return function(){var a=o(this,t),s=a.on;s!==r&&(i=(r=s).copy()).on(e,n),a.on=i}}function bo(t,e){var n=this._id;return arguments.length<2?W(this.node(),n).on.on(t):this.each(_o(n,t,e))}function No(t){return function(){var e=this.parentNode;for(var n in this.__transition)if(+n!==t)return;e&&e.removeChild(this)}}function Eo(){return this.on("end.remove",No(this._id))}function Ao(t){var e=this._name,n=this._id;typeof t!="function"&&(t=ue(t));for(var r=this._groups,i=r.length,o=new Array(i),a=0;a<i;++a)for(var s=r[a],c=s.length,u=o[a]=new Array(c),l,d,f=0;f<c;++f)(l=s[f])&&(d=t.call(l,l.__data__,f,s))&&("__data__"in l&&(d.__data__=l.__data__),u[f]=d,Ut(u[f],e,n,f,u,W(l,n)));return new rt(o,this._parents,e,n)}function Co(t){var e=this._name,n=this._id;typeof t!="function"&&(t=Ve(t));for(var r=this._groups,i=r.length,o=[],a=[],s=0;s<i;++s)for(var c=r[s],u=c.length,l,d=0;d<u;++d)if(l=c[d]){for(var f=t.call(l,l.__data__,d,c),h,b=W(l,n),y=0,v=f.length;y<v;++y)(h=f[y])&&Ut(h,e,n,y,f,b);o.push(f),a.push(l)}return new rt(o,a,e,n)}var Mo=At.prototype.constructor;function $o(){return new Mo(this._groups,this._parents)}function To(t,e){var n,r,i;return function(){var o=ht(this,t),a=(this.style.removeProperty(t),ht(this,t));return o===a?null:o===n&&a===r?i:i=e(n=o,r=a)}}function gn(t){return function(){this.style.removeProperty(t)}}function ko(t,e,n){var r,i=n+"",o;return function(){var a=ht(this,t);return a===i?null:a===r?o:o=e(r=a,n)}}function So(t,e,n){var r,i,o;return function(){var a=ht(this,t),s=n(this),c=s+"";return s==null&&(c=s=(this.style.removeProperty(t),ht(this,t))),a===c?null:a===r&&c===i?o:(i=c,o=e(r=a,s))}}function zo(t,e){var n,r,i,o="style."+e,a="end."+o,s;return function(){var c=Z(this,t),u=c.on,l=c.value[o]==null?s||(s=gn(e)):void 0;(u!==n||i!==l)&&(r=(n=u).copy()).on(a,i=l),c.on=r}}function Io(t,e,n){var r=(t+="")=="transform"?zi:pn;return e==null?this.styleTween(t,To(t,r)).on("end.style."+t,gn(t)):typeof e=="function"?this.styleTween(t,So(t,r,pe(this,"style."+t,e))).each(zo(this._id,t)):this.styleTween(t,ko(t,r,e),n).on("end.style."+t,null)}function Do(t,e,n){return function(r){this.style.setProperty(t,e.call(this,r),n)}}function Ro(t,e,n){var r,i;function o(){var a=e.apply(this,arguments);return a!==i&&(r=(i=a)&&Do(t,a,n)),r}return o._value=e,o}function Lo(t,e,n){var r="style."+(t+="");if(arguments.length<2)return(r=this.tween(r))&&r._value;if(e==null)return this.tween(r,null);if(typeof e!="function")throw new Error;return this.tween(r,Ro(t,e,n??""))}function Fo(t){return function(){this.textContent=t}}function Ho(t){return function(){var e=t(this);this.textContent=e??""}}function Bo(t){return this.tween("text",typeof t=="function"?Ho(pe(this,"text",t)):Fo(t==null?"":t+""))}function Po(t){return function(e){this.textContent=t.call(this,e)}}function Xo(t){var e,n;function r(){var i=t.apply(this,arguments);return i!==n&&(e=(n=i)&&Po(i)),e}return r._value=t,r}function Oo(t){var e="text";if(arguments.length<1)return(e=this.tween(e))&&e._value;if(t==null)return this.tween(e,null);if(typeof t!="function")throw new Error;return this.tween(e,Xo(t))}function Yo(){for(var t=this._name,e=this._id,n=mn(),r=this._groups,i=r.length,o=0;o<i;++o)for(var a=r[o],s=a.length,c,u=0;u<s;++u)if(c=a[u]){var l=W(c,e);Ut(c,t,n,u,a,{time:l.time+l.delay+l.duration,delay:0,duration:l.duration,ease:l.ease})}return new rt(r,this._parents,t,n)}function qo(){var t,e,n=this,r=n._id,i=n.size();return new Promise(function(o,a){var s={value:a},c={value:function(){--i===0&&o()}};n.each(function(){var u=Z(this,r),l=u.on;l!==t&&(e=(t=l).copy(),e._.cancel.push(s),e._.interrupt.push(s),e._.end.push(c)),u.on=e}),i===0&&o()})}var Vo=0;function rt(t,e,n,r){this._groups=t,this._parents=e,this._name=n,this._id=r}function mn(){return++Vo}var tt=At.prototype;rt.prototype={constructor:rt,select:Ao,selectAll:Co,selectChild:tt.selectChild,selectChildren:tt.selectChildren,filter:xo,merge:vo,selection:$o,transition:Yo,call:tt.call,nodes:tt.nodes,node:tt.node,size:tt.size,empty:tt.empty,each:tt.each,on:bo,attr:eo,attrTween:ao,style:Io,styleTween:Lo,text:Bo,textTween:Oo,remove:Eo,tween:Ki,delay:co,duration:ho,ease:go,easeVarying:yo,end:qo,[Symbol.iterator]:tt[Symbol.iterator]};function Uo(t){return((t*=2)<=1?t*t*t:(t-=2)*t*t+2)/2}var Go={time:null,delay:0,duration:250,ease:Uo};function Ko(t,e){for(var n;!(n=t.__transition)||!(n=n[e]);)if(!(t=t.parentNode))throw new Error(`transition ${e} not found`);return n}function Wo(t){var e,n;t instanceof rt?(e=t._id,t=t._name):(e=mn(),(n=Go).time=fe(),t=t==null?null:t+"");for(var r=this._groups,i=r.length,o=0;o<i;++o)for(var a=r[o],s=a.length,c,u=0;u<s;++u)(c=a[u])&&Ut(c,t,e,u,a,n||Ko(c,e));return new rt(r,this._parents,t,e)}At.prototype.interrupt=Vi;At.prototype.transition=Wo;function Qo(t,e){var n,r=1;t==null&&(t=0),e==null&&(e=0);function i(){var o,a=n.length,s,c=0,u=0;for(o=0;o<a;++o)s=n[o],c+=s.x,u+=s.y;for(c=(c/a-t)*r,u=(u/a-e)*r,o=0;o<a;++o)s=n[o],s.x-=c,s.y-=u}return i.initialize=function(o){n=o},i.x=function(o){return arguments.length?(t=+o,i):t},i.y=function(o){return arguments.length?(e=+o,i):e},i.strength=function(o){return arguments.length?(r=+o,i):r},i}function Zo(t){const e=+this._x.call(null,t),n=+this._y.call(null,t);return yn(this.cover(e,n),e,n,t)}function yn(t,e,n,r){if(isNaN(e)||isNaN(n))return t;var i,o=t._root,a={data:r},s=t._x0,c=t._y0,u=t._x1,l=t._y1,d,f,h,b,y,v,m,_;if(!o)return t._root=a,t;for(;o.length;)if((y=e>=(d=(s+u)/2))?s=d:u=d,(v=n>=(f=(c+l)/2))?c=f:l=f,i=o,!(o=o[m=v<<1|y]))return i[m]=a,t;if(h=+t._x.call(null,o.data),b=+t._y.call(null,o.data),e===h&&n===b)return a.next=o,i?i[m]=a:t._root=a,t;do i=i?i[m]=new Array(4):t._root=new Array(4),(y=e>=(d=(s+u)/2))?s=d:u=d,(v=n>=(f=(c+l)/2))?c=f:l=f;while((m=v<<1|y)===(_=(b>=f)<<1|h>=d));return i[_]=o,i[m]=a,t}function Jo(t){var e,n,r=t.length,i,o,a=new Array(r),s=new Array(r),c=1/0,u=1/0,l=-1/0,d=-1/0;for(n=0;n<r;++n)isNaN(i=+this._x.call(null,e=t[n]))||isNaN(o=+this._y.call(null,e))||(a[n]=i,s[n]=o,i<c&&(c=i),i>l&&(l=i),o<u&&(u=o),o>d&&(d=o));if(c>l||u>d)return this;for(this.cover(c,u).cover(l,d),n=0;n<r;++n)yn(this,a[n],s[n],t[n]);return this}function jo(t,e){if(isNaN(t=+t)||isNaN(e=+e))return this;var n=this._x0,r=this._y0,i=this._x1,o=this._y1;if(isNaN(n))i=(n=Math.floor(t))+1,o=(r=Math.floor(e))+1;else{for(var a=i-n||1,s=this._root,c,u;n>t||t>=i||r>e||e>=o;)switch(u=(e<r)<<1|t<n,c=new Array(4),c[u]=s,s=c,a*=2,u){case 0:i=n+a,o=r+a;break;case 1:n=i-a,o=r+a;break;case 2:i=n+a,r=o-a;break;case 3:n=i-a,r=o-a;break}this._root&&this._root.length&&(this._root=s)}return this._x0=n,this._y0=r,this._x1=i,this._y1=o,this}function ta(){var t=[];return this.visit(function(e){if(!e.length)do t.push(e.data);while(e=e.next)}),t}function ea(t){return arguments.length?this.cover(+t[0][0],+t[0][1]).cover(+t[1][0],+t[1][1]):isNaN(this._x0)?void 0:[[this._x0,this._y0],[this._x1,this._y1]]}function O(t,e,n,r,i){this.node=t,this.x0=e,this.y0=n,this.x1=r,this.y1=i}function na(t,e,n){var r,i=this._x0,o=this._y0,a,s,c,u,l=this._x1,d=this._y1,f=[],h=this._root,b,y;for(h&&f.push(new O(h,i,o,l,d)),n==null?n=1/0:(i=t-n,o=e-n,l=t+n,d=e+n,n*=n);b=f.pop();)if(!(!(h=b.node)||(a=b.x0)>l||(s=b.y0)>d||(c=b.x1)<i||(u=b.y1)<o))if(h.length){var v=(a+c)/2,m=(s+u)/2;f.push(new O(h[3],v,m,c,u),new O(h[2],a,m,v,u),new O(h[1],v,s,c,m),new O(h[0],a,s,v,m)),(y=(e>=m)<<1|t>=v)&&(b=f[f.length-1],f[f.length-1]=f[f.length-1-y],f[f.length-1-y]=b)}else{var _=t-+this._x.call(null,h.data),A=e-+this._y.call(null,h.data),p=_*_+A*A;if(p<n){var E=Math.sqrt(n=p);i=t-E,o=e-E,l=t+E,d=e+E,r=h.data}}return r}function ra(t){if(isNaN(l=+this._x.call(null,t))||isNaN(d=+this._y.call(null,t)))return this;var e,n=this._root,r,i,o,a=this._x0,s=this._y0,c=this._x1,u=this._y1,l,d,f,h,b,y,v,m;if(!n)return this;if(n.length)for(;;){if((b=l>=(f=(a+c)/2))?a=f:c=f,(y=d>=(h=(s+u)/2))?s=h:u=h,e=n,!(n=n[v=y<<1|b]))return this;if(!n.length)break;(e[v+1&3]||e[v+2&3]||e[v+3&3])&&(r=e,m=v)}for(;n.data!==t;)if(i=n,!(n=n.next))return this;return(o=n.next)&&delete n.next,i?(o?i.next=o:delete i.next,this):e?(o?e[v]=o:delete e[v],(n=e[0]||e[1]||e[2]||e[3])&&n===(e[3]||e[2]||e[1]||e[0])&&!n.length&&(r?r[m]=n:this._root=n),this):(this._root=o,this)}function ia(t){for(var e=0,n=t.length;e<n;++e)this.remove(t[e]);return this}function oa(){return this._root}function aa(){var t=0;return this.visit(function(e){if(!e.length)do++t;while(e=e.next)}),t}function sa(t){var e=[],n,r=this._root,i,o,a,s,c;for(r&&e.push(new O(r,this._x0,this._y0,this._x1,this._y1));n=e.pop();)if(!t(r=n.node,o=n.x0,a=n.y0,s=n.x1,c=n.y1)&&r.length){var u=(o+s)/2,l=(a+c)/2;(i=r[3])&&e.push(new O(i,u,l,s,c)),(i=r[2])&&e.push(new O(i,o,l,u,c)),(i=r[1])&&e.push(new O(i,u,a,s,l)),(i=r[0])&&e.push(new O(i,o,a,u,l))}return this}function ua(t){var e=[],n=[],r;for(this._root&&e.push(new O(this._root,this._x0,this._y0,this._x1,this._y1));r=e.pop();){var i=r.node;if(i.length){var o,a=r.x0,s=r.y0,c=r.x1,u=r.y1,l=(a+c)/2,d=(s+u)/2;(o=i[0])&&e.push(new O(o,a,s,l,d)),(o=i[1])&&e.push(new O(o,l,s,c,d)),(o=i[2])&&e.push(new O(o,a,d,l,u)),(o=i[3])&&e.push(new O(o,l,d,c,u))}n.push(r)}for(;r=n.pop();)t(r.node,r.x0,r.y0,r.x1,r.y1);return this}function ca(t){return t[0]}function la(t){return arguments.length?(this._x=t,this):this._x}function fa(t){return t[1]}function ha(t){return arguments.length?(this._y=t,this):this._y}function ge(t,e,n){var r=new me(e??ca,n??fa,NaN,NaN,NaN,NaN);return t==null?r:r.addAll(t)}function me(t,e,n,r,i,o){this._x=t,this._y=e,this._x0=n,this._y0=r,this._x1=i,this._y1=o,this._root=void 0}function Re(t){for(var e={data:t.data},n=e;t=t.next;)n=n.next={data:t.data};return e}var Y=ge.prototype=me.prototype;Y.copy=function(){var t=new me(this._x,this._y,this._x0,this._y0,this._x1,this._y1),e=this._root,n,r;if(!e)return t;if(!e.length)return t._root=Re(e),t;for(n=[{source:e,target:t._root=new Array(4)}];e=n.pop();)for(var i=0;i<4;++i)(r=e.source[i])&&(r.length?n.push({source:r,target:e.target[i]=new Array(4)}):e.target[i]=Re(r));return t};Y.add=Zo;Y.addAll=Jo;Y.cover=jo;Y.data=ta;Y.extent=ea;Y.find=na;Y.remove=ra;Y.removeAll=ia;Y.root=oa;Y.size=aa;Y.visit=sa;Y.visitAfter=ua;Y.x=la;Y.y=ha;function ut(t){return function(){return t}}function ot(t){return(t()-.5)*1e-6}function da(t){return t.x+t.vx}function pa(t){return t.y+t.vy}function ga(t){var e,n,r,i=1,o=1;typeof t!="function"&&(t=ut(t==null?1:+t));function a(){for(var u,l=e.length,d,f,h,b,y,v,m=0;m<o;++m)for(d=ge(e,da,pa).visitAfter(s),u=0;u<l;++u)f=e[u],y=n[f.index],v=y*y,h=f.x+f.vx,b=f.y+f.vy,d.visit(_);function _(A,p,E,C,$){var T=A.data,D=A.r,z=y+D;if(T){if(T.index>f.index){var L=h-T.x-T.vx,R=b-T.y-T.vy,P=L*L+R*R;P<z*z&&(L===0&&(L=ot(r),P+=L*L),R===0&&(R=ot(r),P+=R*R),P=(z-(P=Math.sqrt(P)))/P*i,f.vx+=(L*=P)*(z=(D*=D)/(v+D)),f.vy+=(R*=P)*z,T.vx-=L*(z=1-z),T.vy-=R*z)}return}return p>h+z||C<h-z||E>b+z||$<b-z}}function s(u){if(u.data)return u.r=n[u.data.index];for(var l=u.r=0;l<4;++l)u[l]&&u[l].r>u.r&&(u.r=u[l].r)}function c(){if(e){var u,l=e.length,d;for(n=new Array(l),u=0;u<l;++u)d=e[u],n[d.index]=+t(d,u,e)}}return a.initialize=function(u,l){e=u,r=l,c()},a.iterations=function(u){return arguments.length?(o=+u,a):o},a.strength=function(u){return arguments.length?(i=+u,a):i},a.radius=function(u){return arguments.length?(t=typeof u=="function"?u:ut(+u),c(),a):t},a}function ma(t){return t.index}function Le(t,e){var n=t.get(e);if(!n)throw new Error("node not found: "+e);return n}function ya(t){var e=ma,n=d,r,i=ut(30),o,a,s,c,u,l=1;t==null&&(t=[]);function d(v){return 1/Math.min(s[v.source.index],s[v.target.index])}function f(v){for(var m=0,_=t.length;m<l;++m)for(var A=0,p,E,C,$,T,D,z;A<_;++A)p=t[A],E=p.source,C=p.target,$=C.x+C.vx-E.x-E.vx||ot(u),T=C.y+C.vy-E.y-E.vy||ot(u),D=Math.sqrt($*$+T*T),D=(D-o[A])/D*v*r[A],$*=D,T*=D,C.vx-=$*(z=c[A]),C.vy-=T*z,E.vx+=$*(z=1-z),E.vy+=T*z}function h(){if(a){var v,m=a.length,_=t.length,A=new Map(a.map((E,C)=>[e(E,C,a),E])),p;for(v=0,s=new Array(m);v<_;++v)p=t[v],p.index=v,typeof p.source!="object"&&(p.source=Le(A,p.source)),typeof p.target!="object"&&(p.target=Le(A,p.target)),s[p.source.index]=(s[p.source.index]||0)+1,s[p.target.index]=(s[p.target.index]||0)+1;for(v=0,c=new Array(_);v<_;++v)p=t[v],c[v]=s[p.source.index]/(s[p.source.index]+s[p.target.index]);r=new Array(_),b(),o=new Array(_),y()}}function b(){if(a)for(var v=0,m=t.length;v<m;++v)r[v]=+n(t[v],v,t)}function y(){if(a)for(var v=0,m=t.length;v<m;++v)o[v]=+i(t[v],v,t)}return f.initialize=function(v,m){a=v,u=m,h()},f.links=function(v){return arguments.length?(t=v,h(),f):t},f.id=function(v){return arguments.length?(e=v,f):e},f.iterations=function(v){return arguments.length?(l=+v,f):l},f.strength=function(v){return arguments.length?(n=typeof v=="function"?v:ut(+v),b(),f):n},f.distance=function(v){return arguments.length?(i=typeof v=="function"?v:ut(+v),y(),f):i},f}const xa=1664525,va=1013904223,Fe=4294967296;function wa(){let t=1;return()=>(t=(xa*t+va)%Fe)/Fe}function _a(t){return t.x}function ba(t){return t.y}var Na=10,Ea=Math.PI*(3-Math.sqrt(5));function Aa(t){var e,n=1,r=.001,i=1-Math.pow(r,1/300),o=0,a=.6,s=new Map,c=he(d),u=Et("tick","end"),l=wa();t==null&&(t=[]);function d(){f(),u.call("tick",e),n<r&&(c.stop(),u.call("end",e))}function f(y){var v,m=t.length,_;y===void 0&&(y=1);for(var A=0;A<y;++A)for(n+=(o-n)*i,s.forEach(function(p){p(n)}),v=0;v<m;++v)_=t[v],_.fx==null?_.x+=_.vx*=a:(_.x=_.fx,_.vx=0),_.fy==null?_.y+=_.vy*=a:(_.y=_.fy,_.vy=0);return e}function h(){for(var y=0,v=t.length,m;y<v;++y){if(m=t[y],m.index=y,m.fx!=null&&(m.x=m.fx),m.fy!=null&&(m.y=m.fy),isNaN(m.x)||isNaN(m.y)){var _=Na*Math.sqrt(.5+y),A=y*Ea;m.x=_*Math.cos(A),m.y=_*Math.sin(A)}(isNaN(m.vx)||isNaN(m.vy))&&(m.vx=m.vy=0)}}function b(y){return y.initialize&&y.initialize(t,l),y}return h(),e={tick:f,restart:function(){return c.restart(d),e},stop:function(){return c.stop(),e},nodes:function(y){return arguments.length?(t=y,h(),s.forEach(b),e):t},alpha:function(y){return arguments.length?(n=+y,e):n},alphaMin:function(y){return arguments.length?(r=+y,e):r},alphaDecay:function(y){return arguments.length?(i=+y,e):+i},alphaTarget:function(y){return arguments.length?(o=+y,e):o},velocityDecay:function(y){return arguments.length?(a=1-y,e):1-a},randomSource:function(y){return arguments.length?(l=y,s.forEach(b),e):l},force:function(y,v){return arguments.length>1?(v==null?s.delete(y):s.set(y,b(v)),e):s.get(y)},find:function(y,v,m){var _=0,A=t.length,p,E,C,$,T;for(m==null?m=1/0:m*=m,_=0;_<A;++_)$=t[_],p=y-$.x,E=v-$.y,C=p*p+E*E,C<m&&(T=$,m=C);return T},on:function(y,v){return arguments.length>1?(u.on(y,v),e):u.on(y)}}}function Ca(){var t,e,n,r,i=ut(-30),o,a=1,s=1/0,c=.81;function u(h){var b,y=t.length,v=ge(t,_a,ba).visitAfter(d);for(r=h,b=0;b<y;++b)e=t[b],v.visit(f)}function l(){if(t){var h,b=t.length,y;for(o=new Array(b),h=0;h<b;++h)y=t[h],o[y.index]=+i(y,h,t)}}function d(h){var b=0,y,v,m=0,_,A,p;if(h.length){for(_=A=p=0;p<4;++p)(y=h[p])&&(v=Math.abs(y.value))&&(b+=y.value,m+=v,_+=v*y.x,A+=v*y.y);h.x=_/m,h.y=A/m}else{y=h,y.x=y.data.x,y.y=y.data.y;do b+=o[y.data.index];while(y=y.next)}h.value=b}function f(h,b,y,v){if(!h.value)return!0;var m=h.x-e.x,_=h.y-e.y,A=v-b,p=m*m+_*_;if(A*A/c<p)return p<s&&(m===0&&(m=ot(n),p+=m*m),_===0&&(_=ot(n),p+=_*_),p<a&&(p=Math.sqrt(a*p)),e.vx+=m*h.value*r/p,e.vy+=_*h.value*r/p),!0;if(h.length||p>=s)return;(h.data!==e||h.next)&&(m===0&&(m=ot(n),p+=m*m),_===0&&(_=ot(n),p+=_*_),p<a&&(p=Math.sqrt(a*p)));do h.data!==e&&(A=o[h.data.index]*r/p,e.vx+=m*A,e.vy+=_*A);while(h=h.next)}return u.initialize=function(h,b){t=h,n=b,l()},u.strength=function(h){return arguments.length?(i=typeof h=="function"?h:ut(+h),l(),u):i},u.distanceMin=function(h){return arguments.length?(a=h*h,u):Math.sqrt(a)},u.distanceMax=function(h){return arguments.length?(s=h*h,u):Math.sqrt(s)},u.theta=function(h){return arguments.length?(c=h*h,u):Math.sqrt(c)},u}const St=t=>()=>t;function Ma(t,{sourceEvent:e,target:n,transform:r,dispatch:i}){Object.defineProperties(this,{type:{value:t,enumerable:!0,configurable:!0},sourceEvent:{value:e,enumerable:!0,configurable:!0},target:{value:n,enumerable:!0,configurable:!0},transform:{value:r,enumerable:!0,configurable:!0},_:{value:i}})}function nt(t,e,n){this.k=t,this.x=e,this.y=n}nt.prototype={constructor:nt,scale:function(t){return t===1?this:new nt(this.k*t,this.x,this.y)},translate:function(t,e){return t===0&e===0?this:new nt(this.k,this.x+this.k*t,this.y+this.k*e)},apply:function(t){return[t[0]*this.k+this.x,t[1]*this.k+this.y]},applyX:function(t){return t*this.k+this.x},applyY:function(t){return t*this.k+this.y},invert:function(t){return[(t[0]-this.x)/this.k,(t[1]-this.y)/this.k]},invertX:function(t){return(t-this.x)/this.k},invertY:function(t){return(t-this.y)/this.k},rescaleX:function(t){return t.copy().domain(t.range().map(this.invertX,this).map(t.invert,t))},rescaleY:function(t){return t.copy().domain(t.range().map(this.invertY,this).map(t.invert,t))},toString:function(){return"translate("+this.x+","+this.y+") scale("+this.k+")"}};var Yt=new nt(1,0,0);nt.prototype;function Zt(t){t.stopImmediatePropagation()}function gt(t){t.preventDefault(),t.stopImmediatePropagation()}function $a(t){return(!t.ctrlKey||t.type==="wheel")&&!t.button}function Ta(){var t=this;return t instanceof SVGElement?(t=t.ownerSVGElement||t,t.hasAttribute("viewBox")?(t=t.viewBox.baseVal,[[t.x,t.y],[t.x+t.width,t.y+t.height]]):[[0,0],[t.width.baseVal.value,t.height.baseVal.value]]):[[0,0],[t.clientWidth,t.clientHeight]]}function He(){return this.__zoom||Yt}function ka(t){return-t.deltaY*(t.deltaMode===1?.05:t.deltaMode?1:.002)*(t.ctrlKey?10:1)}function Sa(){return navigator.maxTouchPoints||"ontouchstart"in this}function za(t,e,n){var r=t.invertX(e[0][0])-n[0][0],i=t.invertX(e[1][0])-n[1][0],o=t.invertY(e[0][1])-n[0][1],a=t.invertY(e[1][1])-n[1][1];return t.translate(i>r?(r+i)/2:Math.min(0,r)||Math.max(0,i),a>o?(o+a)/2:Math.min(0,o)||Math.max(0,a))}function Ia(){var t=$a,e=Ta,n=za,r=ka,i=Sa,o=[0,1/0],a=[[-1/0,-1/0],[1/0,1/0]],s=250,c=Fi,u=Et("start","zoom","end"),l,d,f,h=500,b=150,y=0,v=10;function m(g){g.property("__zoom",He).on("wheel.zoom",T,{passive:!1}).on("mousedown.zoom",D).on("dblclick.zoom",z).filter(i).on("touchstart.zoom",L).on("touchmove.zoom",R).on("touchend.zoom touchcancel.zoom",P).style("-webkit-tap-highlight-color","rgba(0,0,0,0)")}m.transform=function(g,x,w,N){var M=g.selection?g.selection():g;M.property("__zoom",He),g!==M?E(g,x,w,N):M.interrupt().each(function(){C(this,arguments).event(N).start().zoom(null,typeof x=="function"?x.apply(this,arguments):x).end()})},m.scaleBy=function(g,x,w,N){m.scaleTo(g,function(){var M=this.__zoom.k,k=typeof x=="function"?x.apply(this,arguments):x;return M*k},w,N)},m.scaleTo=function(g,x,w,N){m.transform(g,function(){var M=e.apply(this,arguments),k=this.__zoom,S=w==null?p(M):typeof w=="function"?w.apply(this,arguments):w,I=k.invert(S),F=typeof x=="function"?x.apply(this,arguments):x;return n(A(_(k,F),S,I),M,a)},w,N)},m.translateBy=function(g,x,w,N){m.transform(g,function(){return n(this.__zoom.translate(typeof x=="function"?x.apply(this,arguments):x,typeof w=="function"?w.apply(this,arguments):w),e.apply(this,arguments),a)},null,N)},m.translateTo=function(g,x,w,N,M){m.transform(g,function(){var k=e.apply(this,arguments),S=this.__zoom,I=N==null?p(k):typeof N=="function"?N.apply(this,arguments):N;return n(Yt.translate(I[0],I[1]).scale(S.k).translate(typeof x=="function"?-x.apply(this,arguments):-x,typeof w=="function"?-w.apply(this,arguments):-w),k,a)},N,M)};function _(g,x){return x=Math.max(o[0],Math.min(o[1],x)),x===g.k?g:new nt(x,g.x,g.y)}function A(g,x,w){var N=x[0]-w[0]*g.k,M=x[1]-w[1]*g.k;return N===g.x&&M===g.y?g:new nt(g.k,N,M)}function p(g){return[(+g[0][0]+ +g[1][0])/2,(+g[0][1]+ +g[1][1])/2]}function E(g,x,w,N){g.on("start.zoom",function(){C(this,arguments).event(N).start()}).on("interrupt.zoom end.zoom",function(){C(this,arguments).event(N).end()}).tween("zoom",function(){var M=this,k=arguments,S=C(M,k).event(N),I=e.apply(M,k),F=w==null?p(I):typeof w=="function"?w.apply(M,k):w,U=Math.max(I[1][0]-I[0][0],I[1][1]-I[0][1]),H=M.__zoom,B=typeof x=="function"?x.apply(M,k):x,J=c(H.invert(F).concat(U/H.k),B.invert(F).concat(U/B.k));return function(G){if(G===1)G=B;else{var j=J(G),Gt=U/j[2];G=new nt(Gt,F[0]-j[0]*Gt,F[1]-j[1]*Gt)}S.zoom(null,G)}})}function C(g,x,w){return!w&&g.__zooming||new $(g,x)}function $(g,x){this.that=g,this.args=x,this.active=0,this.sourceEvent=null,this.extent=e.apply(g,x),this.taps=0}$.prototype={event:function(g){return g&&(this.sourceEvent=g),this},start:function(){return++this.active===1&&(this.that.__zooming=this,this.emit("start")),this},zoom:function(g,x){return this.mouse&&g!=="mouse"&&(this.mouse[1]=x.invert(this.mouse[0])),this.touch0&&g!=="touch"&&(this.touch0[1]=x.invert(this.touch0[0])),this.touch1&&g!=="touch"&&(this.touch1[1]=x.invert(this.touch1[0])),this.that.__zoom=x,this.emit("zoom"),this},end:function(){return--this.active===0&&(delete this.that.__zooming,this.emit("end")),this},emit:function(g){var x=X(this.that).datum();u.call(g,this.that,new Ma(g,{sourceEvent:this.sourceEvent,target:m,transform:this.that.__zoom,dispatch:u}),x)}};function T(g,...x){if(!t.apply(this,arguments))return;var w=C(this,x).event(g),N=this.__zoom,M=Math.max(o[0],Math.min(o[1],N.k*Math.pow(2,r.apply(this,arguments)))),k=et(g);if(w.wheel)(w.mouse[0][0]!==k[0]||w.mouse[0][1]!==k[1])&&(w.mouse[1]=N.invert(w.mouse[0]=k)),clearTimeout(w.wheel);else{if(N.k===M)return;w.mouse=[k,N.invert(k)],Lt(this),w.start()}gt(g),w.wheel=setTimeout(S,b),w.zoom("mouse",n(A(_(N,M),w.mouse[0],w.mouse[1]),w.extent,a));function S(){w.wheel=null,w.end()}}function D(g,...x){if(f||!t.apply(this,arguments))return;var w=g.currentTarget,N=C(this,x,!0).event(g),M=X(g.view).on("mousemove.zoom",F,!0).on("mouseup.zoom",U,!0),k=et(g,w),S=g.clientX,I=g.clientY;nn(g.view),Zt(g),N.mouse=[k,this.__zoom.invert(k)],Lt(this),N.start();function F(H){if(gt(H),!N.moved){var B=H.clientX-S,J=H.clientY-I;N.moved=B*B+J*J>y}N.event(H).zoom("mouse",n(A(N.that.__zoom,N.mouse[0]=et(H,w),N.mouse[1]),N.extent,a))}function U(H){M.on("mousemove.zoom mouseup.zoom",null),rn(H.view,N.moved),gt(H),N.event(H).end()}}function z(g,...x){if(t.apply(this,arguments)){var w=this.__zoom,N=et(g.changedTouches?g.changedTouches[0]:g,this),M=w.invert(N),k=w.k*(g.shiftKey?.5:2),S=n(A(_(w,k),N,M),e.apply(this,x),a);gt(g),s>0?X(this).transition().duration(s).call(E,S,N,g):X(this).call(m.transform,S,N,g)}}function L(g,...x){if(t.apply(this,arguments)){var w=g.touches,N=w.length,M=C(this,x,g.changedTouches.length===N).event(g),k,S,I,F;for(Zt(g),S=0;S<N;++S)I=w[S],F=et(I,this),F=[F,this.__zoom.invert(F),I.identifier],M.touch0?!M.touch1&&M.touch0[2]!==F[2]&&(M.touch1=F,M.taps=0):(M.touch0=F,k=!0,M.taps=1+!!l);l&&(l=clearTimeout(l)),k&&(M.taps<2&&(d=F[0],l=setTimeout(function(){l=null},h)),Lt(this),M.start())}}function R(g,...x){if(this.__zooming){var w=C(this,x).event(g),N=g.changedTouches,M=N.length,k,S,I,F;for(gt(g),k=0;k<M;++k)S=N[k],I=et(S,this),w.touch0&&w.touch0[2]===S.identifier?w.touch0[0]=I:w.touch1&&w.touch1[2]===S.identifier&&(w.touch1[0]=I);if(S=w.that.__zoom,w.touch1){var U=w.touch0[0],H=w.touch0[1],B=w.touch1[0],J=w.touch1[1],G=(G=B[0]-U[0])*G+(G=B[1]-U[1])*G,j=(j=J[0]-H[0])*j+(j=J[1]-H[1])*j;S=_(S,Math.sqrt(G/j)),I=[(U[0]+B[0])/2,(U[1]+B[1])/2],F=[(H[0]+J[0])/2,(H[1]+J[1])/2]}else if(w.touch0)I=w.touch0[0],F=w.touch0[1];else return;w.zoom("touch",n(A(S,I,F),w.extent,a))}}function P(g,...x){if(this.__zooming){var w=C(this,x).event(g),N=g.changedTouches,M=N.length,k,S;for(Zt(g),f&&clearTimeout(f),f=setTimeout(function(){f=null},h),k=0;k<M;++k)S=N[k],w.touch0&&w.touch0[2]===S.identifier?delete w.touch0:w.touch1&&w.touch1[2]===S.identifier&&delete w.touch1;if(w.touch1&&!w.touch0&&(w.touch0=w.touch1,delete w.touch1),w.touch0)w.touch0[1]=this.__zoom.invert(w.touch0[0]);else if(w.end(),w.taps===2&&(S=et(S,this),Math.hypot(d[0]-S[0],d[1]-S[1])<v)){var I=X(this).on("dblclick.zoom");I&&I.apply(this,arguments)}}}return m.wheelDelta=function(g){return arguments.length?(r=typeof g=="function"?g:St(+g),m):r},m.filter=function(g){return arguments.length?(t=typeof g=="function"?g:St(!!g),m):t},m.touchable=function(g){return arguments.length?(i=typeof g=="function"?g:St(!!g),m):i},m.extent=function(g){return arguments.length?(e=typeof g=="function"?g:St([[+g[0][0],+g[0][1]],[+g[1][0],+g[1][1]]]),m):e},m.scaleExtent=function(g){return arguments.length?(o[0]=+g[0],o[1]=+g[1],m):[o[0],o[1]]},m.translateExtent=function(g){return arguments.length?(a[0][0]=+g[0][0],a[1][0]=+g[1][0],a[0][1]=+g[0][1],a[1][1]=+g[1][1],m):[[a[0][0],a[0][1]],[a[1][0],a[1][1]]]},m.constrain=function(g){return arguments.length?(n=g,m):n},m.duration=function(g){return arguments.length?(s=+g,m):s},m.interpolate=function(g){return arguments.length?(c=g,m):c},m.on=function(){var g=u.on.apply(u,arguments);return g===u?m:g},m.clickDistance=function(g){return arguments.length?(y=(g=+g)*g,m):Math.sqrt(y)},m.tapDistance=function(g){return arguments.length?(v=+g,m):v},m}const Da={file:{color:"#3B82F6",shape:"circle"},class:{color:"#8B5CF6",shape:"square"},module:{color:"#10B981",shape:"diamond"}},Ra={color:"#6B7280",shape:"circle"};function La(t){return Da[t]??Ra}const Jt=16,mt=14,zt=30,Be=["rgba(59, 130, 246, 0.1)","rgba(139, 92, 246, 0.1)","rgba(16, 185, 129, 0.1)","rgba(245, 158, 11, 0.1)","rgba(239, 68, 68, 0.1)","rgba(14, 165, 233, 0.1)","rgba(168, 85, 247, 0.1)","rgba(20, 184, 166, 0.1)","rgba(249, 115, 22, 0.1)","rgba(236, 72, 153, 0.1)"],Fa=["rgba(59, 130, 246, 0.4)","rgba(139, 92, 246, 0.4)","rgba(16, 185, 129, 0.4)","rgba(245, 158, 11, 0.4)","rgba(239, 68, 68, 0.4)","rgba(14, 165, 233, 0.4)","rgba(168, 85, 247, 0.4)","rgba(20, 184, 166, 0.4)","rgba(249, 115, 22, 0.4)","rgba(236, 72, 153, 0.4)"];function Ha(t){const{container:e,width:n,height:r}=t,i=X(e).append("svg").attr("width",n).attr("height",r).attr("class","graph-svg");i.append("defs").append("marker").attr("id","arrowhead").attr("viewBox","0 0 10 10").attr("refX",28).attr("refY",5).attr("markerWidth",8).attr("markerHeight",8).attr("orient","auto-start-reverse").append("path").attr("d","M 0 0 L 10 5 L 0 10 Z").attr("fill","#94A3B8");const a=i.append("g").attr("class","zoom-container"),s=a.append("g").attr("class","layers"),c=a.append("g").attr("class","edges"),u=a.append("g").attr("class","nodes"),l=Ia().scaleExtent([.1,10]).extent([[0,0],[n,r]]).on("zoom",_=>{a.attr("transform",_.transform.toString())});i.call(l);let d=null;const f=document.createElement("div");f.className="graph-tooltip absolute hidden bg-gray-900 text-white text-sm rounded-lg shadow-lg px-3 py-2 pointer-events-none z-50",f.style.position="absolute",f.style.display="none",e.style.position=e.style.position||"relative",e.appendChild(f);function h(_){s.selectAll("*").remove(),c.selectAll("*").remove(),u.selectAll("*").remove(),d&&(d.stop(),d=null);const A=_.nodes.map(x=>({id:x.id,type:x.type,name:x.name,summary:x.summary,tags:[...x.tags]})),p=new Set(A.map(x=>x.id)),E=_.edges.filter(x=>p.has(x.source)&&p.has(x.target)).map(x=>({source:x.source,target:x.target,type:x.type}));_.edges.forEach(x=>{(!p.has(x.source)||!p.has(x.target))&&console.warn(`Skipping orphaned edge: ${x.source} → ${x.target}`)}),d=Aa(A).force("link",ya(E).id(x=>x.id).distance(100)).force("charge",Ca().strength(-200)).force("center",Qo(n/2,r/2)).force("collide",ga(Jt+4));const C=c.selectAll("line").data(E).join("line").attr("class","edge").attr("stroke","#94A3B8").attr("stroke-width",1.5).attr("marker-end","url(#arrowhead)"),$=c.selectAll("text.edge-label").data(E).join("text").attr("class","edge-label").text(x=>x.type).attr("text-anchor","middle").attr("font-size","10px").attr("fill","#64748B").attr("dy",-6),T=u.selectAll("g").data(A,x=>x.id).join("g").attr("class","node");T.each(function(x){const w=X(this),N=La(x.type);if(N.shape==="circle")w.append("circle").attr("r",Jt).attr("fill",N.color).attr("stroke","#fff").attr("stroke-width",2);else if(N.shape==="square")w.append("rect").attr("x",-mt).attr("y",-mt).attr("width",mt*2).attr("height",mt*2).attr("rx",3).attr("fill",N.color).attr("stroke","#fff").attr("stroke-width",2);else if(N.shape==="diamond"){const M=mt;w.append("polygon").attr("points",`0,${-M} ${M},0 0,${M} ${-M},0`).attr("fill",N.color).attr("stroke","#fff").attr("stroke-width",2)}w.append("text").text(x.name).attr("text-anchor","middle").attr("dy",Jt+14).attr("font-size","11px").attr("fill","#374151")});const D=fi().on("start",(x,w)=>{!x.active&&d&&d.alphaTarget(.3).restart(),w.fx=w.x,w.fy=w.y}).on("drag",(x,w)=>{w.fx=x.x,w.fy=x.y}).on("end",(x,w)=>{!x.active&&d&&d.alphaTarget(0),w.fx=null,w.fy=null});T.call(D),T.on("mouseenter",function(x,w){const N=w.tags.length>0?w.tags.join(", "):"";f.innerHTML=[`<div class="tooltip-name font-bold">${w.name}</div>`,`<div class="tooltip-type text-gray-300">${w.type}</div>`,`<div class="tooltip-summary text-gray-400">${w.summary}</div>`,N?`<div class="tooltip-tags mt-1">${w.tags.map(k=>`<span class="inline-block bg-gray-700 rounded px-1 mr-1 text-xs">${k}</span>`).join("")}</div>`:""].join(""),f.style.display="block",f.classList.remove("hidden");const M=e.getBoundingClientRect();f.style.left=`${x.clientX-M.left+12}px`,f.style.top=`${x.clientY-M.top+12}px`}).on("mouseleave",function(){f.style.display="none",f.classList.add("hidden")});const L=(_.layers??[]).filter(x=>x.nodeIds.filter(N=>p.has(N)?!0:(console.warn(`Layer "${x.name}": skipping missing node "${N}"`),!1)).length>0),R=s.selectAll("g.layer").data(L,x=>x.id).join("g").attr("class","layer");R.each(function(x,w){const N=X(this),M=w%Be.length;N.append("rect").attr("class","layer-rect").attr("rx",8).attr("ry",8).attr("fill",Be[M]).attr("stroke",Fa[M]).attr("stroke-width",1.5),N.append("text").attr("class","layer-label").text(x.name).attr("font-size","12px").attr("font-weight","bold").attr("fill","#6B7280")});const P=new Map;L.forEach(x=>{const w=x.nodeIds.filter(N=>p.has(N));P.set(x.id,w)});const g=new Map;A.forEach(x=>g.set(x.id,x)),d.on("tick",()=>{C.attr("x1",x=>x.source.x??0).attr("y1",x=>x.source.y??0).attr("x2",x=>x.target.x??0).attr("y2",x=>x.target.y??0),$.attr("x",x=>{const w=x.source.x??0,N=x.target.x??0;return(w+N)/2}).attr("y",x=>{const w=x.source.y??0,N=x.target.y??0;return(w+N)/2}),T.attr("transform",x=>`translate(${x.x??0},${x.y??0})`),R.each(function(x){const N=(P.get(x.id)??[]).map(B=>g.get(B)).filter(B=>B!==void 0);if(N.length===0)return;const M=N.map(B=>B.x??0),k=N.map(B=>B.y??0),S=Math.min(...M)-zt,I=Math.min(...k)-zt,F=Math.max(...M)+zt,U=Math.max(...k)+zt,H=X(this);H.select(".layer-rect").attr("x",S).attr("y",I).attr("width",F-S).attr("height",U-I),H.select(".layer-label").attr("x",S+8).attr("y",I+16)})})}function b(_){const A=new Set(_),p=new Set;u.selectAll(".node").each(function(E){p.add(E.id)}),_.forEach(E=>{p.has(E)||console.warn(`highlightNodes: skipping missing node "${E}"`)}),u.selectAll(".node").each(function(E){const C=X(this);A.has(E.id)?(C.attr("opacity",1),C.select("circle, rect, polygon").attr("stroke","#FBBF24").attr("stroke-width",3)):C.attr("opacity",.3)}),c.selectAll(".edge").each(function(E){const C=typeof E.source=="object"?E.source.id:E.source,$=typeof E.target=="object"?E.target.id:E.target,T=A.has(C)||A.has($);X(this).attr("opacity",T?1:.15)})}function y(_){if(_.length===0)return;const A=[],p=new Set;if(u.selectAll(".node").each(function(R){p.add(R.id),_.includes(R.id)&&A.push(R)}),_.forEach(R=>{p.has(R)||console.warn(`panToNodes: skipping missing node "${R}"`)}),A.length===0)return;const E=A.map(R=>R.x??0),C=A.map(R=>R.y??0),$=(Math.min(...E)+Math.max(...E))/2,T=(Math.min(...C)+Math.max(...C))/2,D=n/2-$,z=r/2-T,L=Yt.translate(D,z);i.transition().duration(500).call(l.transform,L)}function v(){u.selectAll(".node").each(function(){const _=X(this);_.attr("opacity",1),_.select("circle, rect, polygon").attr("stroke","#fff").attr("stroke-width",2)}),c.selectAll(".edge").attr("opacity",1),i.transition().duration(300).call(l.transform,Yt)}function m(){d&&(d.stop(),d=null),i.remove(),f.parentNode&&f.parentNode.removeChild(f)}return{render:h,highlightNodes:b,panToNodes:y,resetView:v,destroy:m}}function jt(t,e){const n=document.createElement("div");n.className="rounded-md border border-red-200 bg-red-50 px-4 py-2 text-sm text-red-600",n.setAttribute("role","alert"),n.textContent=e,t.appendChild(n)}function Pe(t){t.querySelectorAll('[role="alert"]').forEach(e=>e.remove())}function Xe(t){t.innerHTML="";const e=document.createElement("div");e.className="absolute inset-0 flex items-center justify-center",e.dataset.testid="loading-indicator";const n=document.createElement("div");n.className="h-8 w-8 animate-spin rounded-full border-4 border-gray-300 border-t-indigo-600",e.appendChild(n);const r=document.createElement("span");r.className="ml-3 text-sm text-gray-500",r.textContent="Loading dashboard…",e.appendChild(r),t.appendChild(e)}function Oe(){const t=document.getElementById("dashboard-selector"),e=document.getElementById("upload-handler"),n=document.getElementById("metadata-panel"),r=document.getElementById("graph-container"),i=document.getElementById("tour-controls");if(!t||!e||!n||!r||!i){console.error("Dashboard Preview: required DOM containers not found.");return}let o=null,a=null,s=[];function c(){if(o)return o;r.innerHTML="";const h=r.clientWidth||800,b=r.clientHeight||500;return o=Ha({container:r,width:h,height:b}),o}function u(h,b){const y=c();y.render(h),_n({container:n,project:h.project,meta:b}),a&&(a.destroy(),a=null);const v=h.tour??[];a=Nn({container:i,steps:v,graphRenderer:y})}async function l(h,b){Pe(t),Xe(r),o&&(o.destroy(),o=null);try{const y=await fetch(`/dashboards/${h}/${b}`);if(!y.ok)throw new Error(`HTTP ${y.status}: ${y.statusText}`);const v=await y.json(),m=Ye(v);if(!m.valid){r.innerHTML="",jt(t,`Invalid dashboard: ${m.errors.join(". ")}.`);return}const A=s.find(p=>p.dirName===h)?.meta;u(v,A)}catch(y){r.innerHTML="";const v=y instanceof Error?y.message:"Unknown error";jt(t,`Failed to load dashboard. ${v}`),console.error("Dashboard fetch error:",y)}}function d(h){Pe(t),Xe(r),o&&(o.destroy(),o=null),u(h)}async function f(){try{const h=await fetch("/dashboard-manifest.json");if(!h.ok)throw new Error(`HTTP ${h.status}: ${h.statusText}`);const b=await h.json();s=b,xn({container:t,manifest:b,onSelect:(y,v)=>{l(y,v)}})}catch(h){const b=h instanceof Error?h.message:"Unknown error";jt(t,`Failed to load dashboard list. ${b}`),console.error("Manifest fetch error:",h)}wn({container:e,onUpload:d})}f()}document.readyState==="loading"?document.addEventListener("DOMContentLoaded",Oe):Oe();

assets/agents/architecture-analyzer.md

@@ -0,0 +1,476 @@
+---
+name: architecture-analyzer
+description: |
+  Analyzes a codebase's file structure, summaries, and import relationships to identify
+  logical architectural layers and assign every file to exactly one layer.
+model: inherit
+---
+
+# Architecture Analyzer
+
+You are an expert software architect. Your job is to analyze a codebase's file structure, summaries, and import relationships to identify logical architectural layers and assign every file to exactly one layer. Your layer assignments must be well-reasoned and reflect the actual organization of the code, including non-code files like configs, documentation, infrastructure, and data schemas.
+
+## Task
+
+Given a list of file nodes (with paths, summaries, tags, and node types) and import edges, identify 3-10 logical architecture layers and assign every file node to exactly one layer. You will accomplish this in two phases: first, write and execute a script that computes structural patterns from the import graph and file paths; second, use those structural insights to make semantic layer assignments.
+
+---
+
+## Phase 1 -- Structural Analysis Script
+
+Write a script (prefer Node.js; fall back to Python if unavailable) that analyzes the file paths and import edges to compute structural patterns that inform layer identification. The script handles all deterministic graph analysis so you can focus on semantic interpretation.
+
+### Script Requirements
+
+1. **Accept** a JSON input file path as the first argument. This file contains:
+   ```json
+   {
+     "fileNodes": [
+       {"id": "file:src/routes/index.ts", "type": "file", "name": "index.ts", "filePath": "src/routes/index.ts", "summary": "...", "tags": ["api-handler"]},
+       {"id": "config:tsconfig.json", "type": "config", "name": "tsconfig.json", "filePath": "tsconfig.json", "summary": "...", "tags": ["configuration"]},
+       {"id": "document:README.md", "type": "document", "name": "README.md", "filePath": "README.md", "summary": "...", "tags": ["documentation"]},
+       {"id": "service:Dockerfile", "type": "service", "name": "Dockerfile", "filePath": "Dockerfile", "summary": "...", "tags": ["infrastructure"]}
+     ],
+     "importEdges": [
+       {"source": "file:src/routes/index.ts", "target": "file:src/services/auth.ts", "type": "imports"}
+     ],
+     "allEdges": [
+       // Only file-level edges (between file-level nodes). Excludes sub-file edges like file→function contains.
+       {"source": "file:src/routes/index.ts", "target": "file:src/services/auth.ts", "type": "imports"},
+       {"source": "config:tsconfig.json", "target": "file:src/index.ts", "type": "configures"},
+       {"source": "service:Dockerfile", "target": "file:src/index.ts", "type": "deploys"}
+     ]
+   }
+   ```
+2. **Write** results JSON to the path given as the second argument.
+3. **Exit 0** on success. **Exit 1** on fatal error (print error to stderr).
+
+### What the Script Must Compute
+
+**A. Directory Grouping**
+
+Group all file node IDs by their top-level directory. First, compute the common path prefix shared by all files (e.g., if all paths start with `src/`, the common prefix is `src/`). Then group by the first directory segment after that prefix. For example, with prefix `src/`:
+- `src/routes/index.ts` -> group `routes`
+- `src/services/auth.ts` -> group `services`
+- `src/utils/format.ts` -> group `utils`
+
+If files have no common prefix (e.g., `src/foo.ts`, `lib/bar.ts`, `config.json`), group by their first directory segment (`src`, `lib`, root).
+
+If the project has a flat structure (all files in one directory with no subdirectories), group by file type/extension pattern (e.g., `*.test.ts` → `test`, `*.config.*` → `config`).
+
+**B. Node Type Grouping**
+
+Group all file node IDs by their node type (`file`, `config`, `document`, `service`, `pipeline`, `table`, `schema`, `resource`, `endpoint`). This reveals the distribution of code vs. non-code files.
+
+**C. Import Adjacency Matrix**
+
+Build an adjacency list of which files import which other files. Compute:
+- For each file: fan-out (how many files it imports) and fan-in (how many files import it)
+- For each directory group: the set of other groups it imports from and is imported by
+
+**D. Cross-Category Dependency Analysis**
+
+Using `allEdges`, compute cross-category relationships:
+- Count edges of each type between node type groups (e.g., config→file configures edges, service→file deploys edges)
+- Identify which non-code nodes connect to which code nodes
+- Output a matrix:
+  ```
+  config -> file: 5 (configures)
+  document -> file: 3 (documents)
+  service -> file: 2 (deploys)
+  pipeline -> file: 1 (triggers)
+  schema -> file: 2 (defines_schema)
+  ```
+
+**E. Inter-Group Import Frequency**
+
+For every pair of directory groups, count the number of import edges between them. Produce a matrix:
+```
+routes -> services: 12
+routes -> utils: 3
+services -> models: 8
+services -> utils: 5
+```
+
+This reveals dependency direction between groups.
+
+**F. Intra-Group Import Density**
+
+For each directory group, count how many import edges exist between files within the same group versus total edges involving that group. High intra-group density suggests the group is cohesive and should be its own layer.
+
+**G. Directory Pattern Matching**
+
+Classify each directory name against known architectural patterns:
+
+| Directory Patterns | Pattern Label |
+|---|---|
+| `routes`, `api`, `controllers`, `endpoints`, `handlers` | `api` |
+| `services`, `core`, `lib`, `domain`, `logic` | `service` |
+| `models`, `db`, `data`, `persistence`, `repository`, `entities` | `data` |
+| `components`, `views`, `pages`, `ui`, `layouts`, `screens` | `ui` |
+| `middleware`, `plugins`, `interceptors`, `guards` | `middleware` |
+| `utils`, `helpers`, `common`, `shared`, `tools` | `utility` |
+| `config`, `constants`, `env`, `settings` | `config` |
+| `__tests__`, `test`, `tests`, `spec`, `specs` | `test` |
+| `types`, `interfaces`, `schemas`, `contracts`, `dtos` | `types` |
+| `hooks` | `hooks` |
+| `store`, `state`, `reducers`, `actions`, `slices` | `state` |
+| `assets`, `static`, `public` | `assets` |
+| `migrations` | `data` |
+| `management`, `commands` | `config` |
+| `templatetags` | `utility` |
+| `signals` | `service` |
+| `serializers` | `api` |
+| `cmd` | `entry` |
+| `internal` | `service` |
+| `pkg` | `utility` |
+| `src/main/java` | `service` |
+| `src/test/java` | `test` |
+| `dto`, `request`, `response` | `types` |
+| `entity` | `data` |
+| `controller` | `api` |
+| `routers` | `api` |
+| `composables` | `service` |
+| `blueprints` | `api` |
+| `mailers`, `jobs`, `channels` | `service` |
+| `bin` | `entry` |
+| `docs`, `documentation`, `wiki` | `documentation` |
+| `deploy`, `deployment`, `infra`, `infrastructure` | `infrastructure` |
+| `.github`, `.gitlab`, `.circleci` | `ci-cd` |
+| `k8s`, `kubernetes`, `helm`, `charts` | `infrastructure` |
+| `terraform`, `tf` | `infrastructure` |
+| `docker` | `infrastructure` |
+| `sql`, `database`, `schema` | `data` |
+
+Also check file-level patterns:
+- Files matching `*.test.*` or `*.spec.*` or `test_*.py` or `*_test.go` or `*Test.java` or `*_spec.rb` or `*Test.php` or `*Tests.cs` -> `test`
+- Files matching `*.d.ts` -> `types` (TypeScript declaration files only)
+- Files named `index.ts`, `index.js`, or `__init__.py` at a package/directory root -> `entry`
+- Files named `manage.py` at the project root -> `entry` (Django management entry point)
+- Files named `wsgi.py` or `asgi.py` -> `config` (Python WSGI/ASGI server config)
+- Files named `main.go` at `cmd/*/` -> `entry` (Go binary entry points)
+- Files named `main.rs` or `lib.rs` at `src/` -> `entry` (Rust crate roots)
+- Files named `Application.java` or `Program.cs` -> `entry` (JVM / .NET entry points)
+- Files named `config.ru` -> `entry` (Ruby Rack entry point)
+- Files named `Cargo.toml`, `go.mod`, `Gemfile`, `pom.xml`, `build.gradle`, `composer.json` -> `config` (language-level project config)
+- `Dockerfile`, `docker-compose.*` -> `infrastructure`
+- `*.tf`, `*.tfvars` -> `infrastructure`
+- `.github/workflows/*`, `.gitlab-ci.yml`, `Jenkinsfile` -> `ci-cd`
+- `*.sql` -> `data`
+- `*.graphql`, `*.gql`, `*.proto` -> `types`
+- `*.md`, `*.rst` -> `documentation`
+- `Makefile` -> `infrastructure`
+
+**H. Deployment Topology Detection**
+
+Identify deployment-related files and their relationships:
+- Look for Dockerfile → docker-compose → K8s manifests chains
+- Detect multi-environment configurations (e.g., Dockerfile.dev, Dockerfile.prod, docker-compose.prod.yml)
+- Identify infrastructure-as-code layering (Terraform modules, CloudFormation stacks)
+
+Output:
+```json
+"deploymentTopology": {
+  "hasDockerfile": true,
+  "hasCompose": true,
+  "hasK8s": false,
+  "hasTerraform": false,
+  "hasCI": true,
+  "infraFiles": ["Dockerfile", "docker-compose.yml", ".github/workflows/ci.yml"]
+}
+```
+
+**I. Data Pipeline Detection**
+
+Identify data flow patterns:
+- Schema definition files → migration files → API endpoint handlers → client code
+- Database schemas → ORM models → service layer → API layer
+- Protobuf/GraphQL definitions → generated code → service handlers
+
+Output:
+```json
+"dataPipeline": {
+  "schemaFiles": ["schema.sql", "schema.graphql"],
+  "migrationFiles": ["migrations/001_init.sql"],
+  "dataModelFiles": ["src/models/user.ts"],
+  "apiHandlerFiles": ["src/routes/users.ts"]
+}
+```
+
+**J. Documentation Coverage**
+
+For each directory group, check if there are documentation files:
+- Does the directory have a README.md?
+- Are there docs/*.md files that reference code in this group?
+- Calculate a coverage ratio: groups-with-docs / total-groups
+
+Output:
+```json
+"docCoverage": {
+  "groupsWithDocs": 3,
+  "totalGroups": 7,
+  "coverageRatio": 0.43,
+  "undocumentedGroups": ["middleware", "utils", "state", "types"]
+}
+```
+
+**K. Dependency Direction**
+
+For each pair of groups with imports between them, determine the dominant direction. If group A imports from group B more than B imports from A, then A depends on B. Output this as a list of directed dependency relationships.
+
+### Script Output Format
+
+```json
+{
+  "scriptCompleted": true,
+  "directoryGroups": {
+    "routes": ["file:src/routes/index.ts", "file:src/routes/auth.ts"],
+    "services": ["file:src/services/auth.ts", "file:src/services/user.ts"],
+    "utils": ["file:src/utils/format.ts"]
+  },
+  "nodeTypeGroups": {
+    "file": ["file:src/index.ts", "file:src/utils.ts"],
+    "config": ["config:tsconfig.json", "config:package.json"],
+    "document": ["document:README.md"],
+    "service": ["service:Dockerfile"],
+    "pipeline": ["pipeline:.github/workflows/ci.yml"]
+  },
+  "crossCategoryEdges": [
+    {"fromType": "config", "toType": "file", "edgeType": "configures", "count": 5},
+    {"fromType": "service", "toType": "file", "edgeType": "deploys", "count": 2}
+  ],
+  "interGroupImports": [
+    {"from": "routes", "to": "services", "count": 12},
+    {"from": "services", "to": "utils", "count": 5}
+  ],
+  "intraGroupDensity": {
+    "routes": {"internalEdges": 3, "totalEdges": 15, "density": 0.2},
+    "services": {"internalEdges": 8, "totalEdges": 20, "density": 0.4}
+  },
+  "patternMatches": {
+    "routes": "api",
+    "services": "service",
+    "utils": "utility"
+  },
+  "deploymentTopology": {
+    "hasDockerfile": true,
+    "hasCompose": true,
+    "hasK8s": false,
+    "hasTerraform": false,
+    "hasCI": true,
+    "infraFiles": ["Dockerfile", "docker-compose.yml", ".github/workflows/ci.yml"]
+  },
+  "dataPipeline": {
+    "schemaFiles": [],
+    "migrationFiles": [],
+    "dataModelFiles": ["src/models/user.ts"],
+    "apiHandlerFiles": ["src/routes/users.ts"]
+  },
+  "docCoverage": {
+    "groupsWithDocs": 1,
+    "totalGroups": 5,
+    "coverageRatio": 0.2,
+    "undocumentedGroups": ["services", "utils", "routes"]
+  },
+  "dependencyDirection": [
+    {"dependent": "routes", "dependsOn": "services"},
+    {"dependent": "services", "dependsOn": "utils"}
+  ],
+  "fileStats": {
+    "totalFileNodes": 42,
+    "filesPerGroup": {"routes": 8, "services": 12, "utils": 5},
+    "nodeTypeCounts": {"file": 30, "config": 5, "document": 3, "service": 2, "pipeline": 2}
+  },
+  "fileFanIn": {
+    "file:src/utils/format.ts": 15,
+    "file:src/services/auth.ts": 8
+  },
+  "fileFanOut": {
+    "file:src/routes/index.ts": 6,
+    "file:src/app.ts": 10
+  }
+}
+```
+
+### Preparing the Script Input
+
+Before writing the script, create its input JSON file:
+
+```bash
+cat > $PROJECT_ROOT/.understand-anything/tmp/ua-arch-input.json << 'ENDJSON'
+{
+  "fileNodes": [<file nodes from prompt — all node types>],
+  "importEdges": [<import edges from prompt>],
+  "allEdges": [<all edges from prompt including configures, documents, deploys, etc.>]
+}
+ENDJSON
+```
+
+### Executing the Script
+
+After writing the script, execute it:
+
+```bash
+node $PROJECT_ROOT/.understand-anything/tmp/ua-arch-analyze.js $PROJECT_ROOT/.understand-anything/tmp/ua-arch-input.json $PROJECT_ROOT/.understand-anything/tmp/ua-arch-results.json
+```
+
+If the script exits with a non-zero code, read stderr, diagnose the issue, fix the script, and re-run. You have up to 2 retry attempts.
+
+---
+
+## Phase 2 -- Semantic Layer Assignment
+
+After the script completes, read `$PROJECT_ROOT/.understand-anything/tmp/ua-arch-results.json`. Use the structural analysis as the primary input for your layer decisions. Do NOT re-read source files or re-analyze imports -- trust the script's results entirely.
+
+### Step 1 -- Evaluate Directory Groups as Layer Candidates
+
+For each directory group from the script output:
+
+1. Check if `patternMatches` assigned it a known pattern label. If yes, this is a strong signal for what layer it belongs to.
+2. Check `intraGroupDensity`. High density (>0.3) suggests the group is cohesive and should likely be its own layer.
+3. Check `interGroupImports`. Groups that are heavily imported by others but import few groups themselves are likely foundational layers (utility, types, data).
+
+### Step 2 -- Analyze Dependency Direction
+
+Use the `dependencyDirection` data to understand the project's layering:
+- Top-level layers (API, UI) depend on middle layers (Service, State)
+- Middle layers depend on bottom layers (Data, Utility, Types)
+- This forms a dependency hierarchy that should map to your layer ordering
+
+### Step 3 -- Consider Non-Code Layers
+
+Use `nodeTypeGroups` and `deploymentTopology` to determine if non-code layers are warranted:
+
+- **Infrastructure layer:** Create if the project has Dockerfiles, Terraform, K8s manifests, or other deployment files. Include all `service` and `resource` type nodes.
+- **CI/CD layer:** Create if the project has CI/CD configs (.github/workflows, .gitlab-ci.yml, Jenkinsfile). Include all `pipeline` type nodes. May be merged with Infrastructure if few files.
+- **Documentation layer:** Create if the project has 3+ documentation files (README, guides, API docs). Include all `document` type nodes. May be merged with a "Project" or "Root" layer if few files.
+- **Data layer:** Create if the project has SQL, GraphQL, Protobuf, or other schema files. Include `table`, `schema`, and `endpoint` type nodes. May be merged with an existing "Data" or "Models" layer.
+- **Configuration layer:** Create if the project has 3+ config files beyond just package.json. Include all `config` type nodes. May be merged with a "Root" or "Project" layer if few files.
+
+**Merging guidance:** For small projects, merge non-code layers into a single "Project Support" or "Infrastructure & Config" layer rather than creating many single-file layers. For larger projects, separate them into distinct layers.
+
+### Step 4 -- Consider File Summaries and Tags
+
+When directory structure alone is ambiguous (e.g., a flat `src/` directory with no subdirectories), use the file summaries and tags from the input data to determine each file's role. Think about what responsibility the file fulfills in the system.
+
+### Step 5 -- Select 3-10 Layers
+
+Choose layers based on the project's actual architecture, informed by the script's structural data. Common patterns include:
+- **Layered architecture:** API -> Service -> Data + Infrastructure + Config
+- **Component-based:** UI Components, State, Services, Utils, Infrastructure
+- **MVC:** Models, Views, Controllers + Config + Docs
+- **Monorepo packages:** Each package forms its own layer + shared infra
+- **Library:** Core, Plugins, Types, Tests, Documentation
+
+**Layer hint for non-code files:**
+
+| Pattern | Suggested Layer |
+|---|---|
+| Dockerfile, docker-compose.*, K8s manifests, Terraform | `layer:infrastructure` |
+| .github/workflows/*, .gitlab-ci.yml, Jenkinsfile | `layer:ci-cd` or merge into `layer:infrastructure` |
+| README.md, docs/*.md, CONTRIBUTING.md, CHANGELOG.md | `layer:documentation` or merge into relevant code layer |
+| *.sql, migrations/*.sql | `layer:data` |
+| *.graphql, *.proto, *.prisma | `layer:data` or `layer:types` |
+| package.json, tsconfig.json, *.toml, *.yaml configs | `layer:config` or merge into relevant code layer |
+
+Merge small directory groups into larger layers when they share a common purpose. Prefer fewer, well-defined layers over many granular ones.
+
+### Step 6 -- Assign Every File Node
+
+Go through each file node ID from the input and assign it to exactly one layer. Use the `directoryGroups` mapping as the primary assignment mechanism -- most files in the same directory group should end up in the same layer.
+
+For non-code files, use the node type as the primary signal:
+- `config` nodes → Configuration or root layer
+- `document` nodes → Documentation layer
+- `service`, `resource` nodes → Infrastructure layer
+- `pipeline` nodes → CI/CD or Infrastructure layer
+- `table`, `schema`, `endpoint` nodes → Data layer
+
+For files that do not clearly fit any layer, place them in the most relevant layer or create a "Shared" / "Utility" catch-all layer. Do not leave any file unassigned.
+
+**Cross-check:** The sum of all `nodeIds` array lengths across all layers MUST equal the total number of file nodes from the input (`fileStats.totalFileNodes` from the script output).
+
+## Layer ID Format
+
+Use `layer:<kebab-case>` format consistently:
+- `layer:api`, `layer:service`, `layer:data`, `layer:ui`, `layer:middleware`
+- `layer:utility`, `layer:config`, `layer:test`, `layer:types`, `layer:state`
+- `layer:infrastructure`, `layer:documentation`, `layer:ci-cd`
+
+## Output Format
+
+Produce a single, valid JSON array. Every field shown is **required**.
+
+```json
+[
+  {
+    "id": "layer:api",
+    "name": "API Layer",
+    "description": "HTTP endpoints, route handlers, and request/response processing",
+    "nodeIds": ["file:src/routes/index.ts", "file:src/controllers/auth.ts"]
+  },
+  {
+    "id": "layer:service",
+    "name": "Service Layer",
+    "description": "Core business logic, domain services, and orchestration",
+    "nodeIds": ["file:src/services/auth.ts", "file:src/services/user.ts"]
+  },
+  {
+    "id": "layer:infrastructure",
+    "name": "Infrastructure",
+    "description": "Container definitions, deployment configurations, and CI/CD pipelines",
+    "nodeIds": ["service:Dockerfile", "service:docker-compose.yml", "pipeline:.github/workflows/ci.yml"]
+  },
+  {
+    "id": "layer:documentation",
+    "name": "Documentation",
+    "description": "Project documentation, guides, and API references",
+    "nodeIds": ["document:README.md", "document:docs/getting-started.md"]
+  },
+  {
+    "id": "layer:data",
+    "name": "Data Layer",
+    "description": "Database schemas, migrations, and data model definitions",
+    "nodeIds": ["table:migrations/001.sql:users", "schema:schema.graphql"]
+  },
+  {
+    "id": "layer:config",
+    "name": "Configuration",
+    "description": "Project configuration files and build settings",
+    "nodeIds": ["config:tsconfig.json", "config:package.json"]
+  },
+  {
+    "id": "layer:utility",
+    "name": "Utility Layer",
+    "description": "Shared helpers, common utilities, and cross-cutting concerns",
+    "nodeIds": ["file:src/utils/format.ts"]
+  }
+]
+```
+
+**Required fields for every layer:**
+- `id` (string) -- must follow `layer:<kebab-case>` format
+- `name` (string) -- human-readable name, title-cased
+- `description` (string) -- 1 sentence describing the layer's responsibility, specific to this project (not generic boilerplate)
+- `nodeIds` (string[]) -- non-empty array of file node IDs belonging to this layer
+
+## Critical Constraints
+
+- EVERY file node ID from the input MUST appear in exactly one layer's `nodeIds` array. Missing file assignments break the downstream pipeline. This includes non-code nodes (config, document, service, pipeline, table, schema, resource, endpoint).
+- NEVER include node IDs in `nodeIds` that were not provided in the input. Do not invent node IDs.
+- NEVER create a layer with an empty `nodeIds` array.
+- ALWAYS verify your output accounts for all input file nodes. Count them: the sum of all `nodeIds` array lengths must equal the total number of input file nodes.
+- Keep to 3-10 layers. If the project is very small (under 10 files), 3 layers is sufficient. If large (100+ files), up to 10 is appropriate. Before writing output, count your layers and verify the count is within this range.
+- Layer `description` must be specific to this project, not generic boilerplate.
+- Trust the script's structural analysis. Do NOT re-read source files or re-count imports. The script's adjacency data, density calculations, and pattern matches are deterministic and reliable.
+- If the script produces empty directory groups or groups with zero files, skip them — do not create empty layers.
+
+## Writing Results
+
+After producing the JSON:
+
+1. Write the JSON array to: `<project-root>/.understand-anything/intermediate/layers.json`
+2. The project root will be provided in your prompt.
+3. Respond with ONLY a brief text summary: number of layers, their names, and the file count per layer.
+
+Do NOT include the full JSON in your text response.

assets/agents/article-analyzer.md

@@ -0,0 +1,93 @@
+---
+name: article-analyzer
+description: |
+  Analyzes markdown files using pre-parsed structural data and LLM inference to extract knowledge graph nodes and edges (entities, claims, implicit relationships, topic clustering).
+model: inherit
+---
+
+# Article Analyzer Agent
+
+You are a knowledge graph extraction expert. Your job is to analyze wiki articles and extract **implicit** knowledge — entities, claims, and relationships that are NOT already captured by explicit wikilinks.
+
+## Input
+
+You will receive a batch of articles as a JSON array. Each article has:
+- `id`: the article node ID (e.g., `"article:concepts/concept-brain"`)
+- `name`: article title
+- `summary`: first paragraph
+- `wikilinks`: list of explicit wikilink targets (already captured as `related` edges — do NOT duplicate these)
+- `category`: index.md category (if any)
+- `content`: article text (truncated to ~3000 chars)
+
+You will also receive the full list of existing node IDs so you can reference them.
+
+## Task
+
+For each article in the batch, extract:
+
+### 1. Entities (people, tools, papers, organizations)
+Named things mentioned in the text that do NOT have their own wiki page (not in existing node IDs). Create `entity` nodes.
+
+- `id`: `"entity:{normalized-name}"` (lowercase, hyphens for spaces)
+- `type`: `"entity"`
+- `name`: proper name as written
+- `summary`: one-line description from context
+- `tags`: `["entity"]` plus any relevant category
+- `complexity`: `"simple"`
+
+### 2. Claims (decisions, assertions, theses)
+Specific assertions, architectural decisions, or key insights. Create `claim` nodes.
+
+- `id`: `"claim:{article-stem}:{short-slug}"` (e.g., `"claim:decision-typescript-python:ts-core-py-clones"`)
+- `type`: `"claim"`
+- `name`: short claim title
+- `summary`: the assertion itself (1-2 sentences)
+- `tags`: `["claim"]` plus category
+- `complexity`: `"simple"`
+
+### 3. Implicit Relationships
+Relationships between articles that go beyond simple wikilink association. Only emit these when there is clear textual evidence:
+
+- **`builds_on`**: Article A explicitly extends, refines, or supersedes ideas from article B. Weight: 0.8
+- **`contradicts`**: Article A conflicts with or reverses a position from article B. Weight: 0.9
+- **`exemplifies`**: An entity or article is a concrete example of a concept. Weight: 0.7
+- **`authored_by`**: Article attributed to a specific entity (person/agent). Weight: 0.6
+- **`cites`**: Article references a raw source document. Weight: 0.7
+
+Edge format:
+```json
+{
+  "source": "article:...",
+  "target": "article:... or entity:... or claim:... or source:...",
+  "type": "builds_on",
+  "direction": "forward",
+  "weight": 0.8,
+  "description": "Brief reason for this relationship"
+}
+```
+
+## Rules
+
+1. **Do NOT duplicate wikilink edges.** The parse script already created `related` edges for every `[[wikilink]]`. Your job is to find what the wikilinks missed.
+2. **Be conservative.** Only create edges with clear textual evidence. A vague thematic similarity is not enough.
+3. **Deduplicate entities.** If the same person/tool appears in multiple articles, create the entity node once.
+4. **Use existing IDs.** When creating edges to existing articles, use their exact `id` from the provided node list.
+5. **Keep it small.** For a batch of 10-15 articles, expect ~5-15 entities, ~5-10 claims, and ~10-20 implicit edges. Don't over-extract.
+
+## Output Format
+
+Write a JSON file to `$INTERMEDIATE_DIR/analysis-batch-$BATCH_NUM.json`:
+
+```json
+{
+  "nodes": [
+    { "id": "entity:...", "type": "entity", "name": "...", "summary": "...", "tags": [...], "complexity": "simple" },
+    { "id": "claim:...", "type": "claim", "name": "...", "summary": "...", "tags": [...], "complexity": "simple" }
+  ],
+  "edges": [
+    { "source": "...", "target": "...", "type": "builds_on", "direction": "forward", "weight": 0.8, "description": "..." }
+  ]
+}
+```
+
+Do NOT include any article or topic nodes in your output — those already exist from the parse script. Only output NEW entity nodes, claim nodes, and implicit edges.

assets/agents/assemble-reviewer.md

@@ -0,0 +1,97 @@
+---
+name: assemble-reviewer
+description: |
+  Reviews the output of merge-batch-graphs.py for semantic issues the script
+  cannot catch. Recovers dropped nodes/edges and fills cross-batch gaps.
+model: inherit
+---
+
+# Assemble Reviewer
+
+You are a quality reviewer for the assembled knowledge graph produced by `merge-batch-graphs.py`. The script has already applied all mechanical fixes — your job is to handle what it **could not fix** and verify the fixes look sane.
+
+## Context
+
+The merge script reads batch analysis results (`batch-*.json`), combines them, and writes `assembled-graph.json`. It applies these mechanical fixes automatically:
+- Normalizes node IDs (strips double prefixes, project-name prefixes, adds missing prefixes, canonicalizes `func:` → `function:`)
+- Normalizes complexity values to `simple`/`moderate`/`complex` for known mappings
+- Rewrites edge `source`/`target` references to match corrected node IDs
+- Deduplicates nodes by ID (keeps last) and edges by `(source, target, type)` (keeps higher weight)
+- Drops edges referencing nodes that don't exist in the merged set
+
+The script produces a stderr report with two sections:
+- **Fixed**: pattern-grouped counts of what it corrected (e.g., `170 × func: → function:`)
+- **Could not fix**: issues that need your judgment (unknown types, unknown complexity values, dropped items)
+
+## Your Task
+
+You will receive the script's report, the path to `assembled-graph.json`, and the project's `$IMPORT_MAP`. Work through these steps in order.
+
+### Step 1 — Sanity-check the "Fixed" section
+
+Review the pattern counts. You do NOT redo any fixes. Just verify the numbers are reasonable:
+- If a single pattern dominates (e.g., 100% of function nodes had `func:` prefix), that's a systemic LLM output pattern — expected, move on.
+- If a large percentage of nodes needed ID correction (>30%), flag this as a potential upstream issue in your notes.
+- If complexity values were heavily skewed to one unknown value, note it.
+
+### Step 2 — Investigate the "Could not fix" section
+
+For each issue listed, take action:
+
+**Nodes with no `id` field:**
+- Read the corresponding batch file to find the original node data.
+- If you can determine what the ID should be (from the node's `type`, `filePath`, and `name`), construct the ID following the convention `<type-prefix>:<filePath>[:<name>]` and add the node to `assembled-graph.json`.
+- If the node is too malformed to recover, skip it and note it in your report.
+
+**Unknown node types** (e.g., `"widget"`, `"helper"`):
+- Check if the type is a known alias or typo for a valid type (e.g., `"func"` → `"function"`, `"doc"` → `"document"`, `"svc"` → `"service"`).
+- If mappable, fix the node's `type` field and update its ID prefix accordingly.
+- If genuinely unknown, leave as-is and note it in your report.
+
+**Unknown complexity values** (e.g., `"very low"`, `"trivial"`):
+- Use your judgment to map to the closest valid value (`simple`, `moderate`, or `complex`).
+- Update the node in `assembled-graph.json`.
+
+**Dropped dangling edges:**
+- For each dropped edge, check if the missing node should exist:
+  - Was the file analyzed? (Check the batch files or scan result)
+  - Did the batch produce a node that got dropped due to missing ID? (Cross-reference with the "no id" items above)
+- If the node should exist, re-create it with sensible defaults (`summary: "No summary available"`, `tags: ["untagged"]`, `complexity: "moderate"`) and restore the edge.
+- If the target genuinely doesn't exist (e.g., external dependency), skip it.
+
+### Step 3 — Check for cross-batch edge gaps
+
+The merge script combines what each batch produced independently. Batches don't know about each other's internal nodes (functions, classes). Using the `$IMPORT_MAP` provided in your prompt:
+
+- For each import relationship in `$IMPORT_MAP`, verify a corresponding `imports` edge exists in the assembled graph.
+- If an edge is missing between two file nodes that should be connected, add it with `type: "imports"`, `direction: "forward"`, `weight: 0.7`.
+- Do NOT add speculative edges — only add edges that are backed by `$IMPORT_MAP` data.
+
+### Step 4 — Write results
+
+1. Apply all fixes directly to `assembled-graph.json`.
+2. Write a summary to the review output path provided in your prompt:
+
+```json
+{
+  "fixedSectionOk": true,
+  "nodesRecovered": 0,
+  "edgesRestored": 0,
+  "crossBatchEdgesAdded": 0,
+  "typesRemapped": 0,
+  "complexityRemapped": 0,
+  "notes": ["any observations about data quality"]
+}
+```
+
+3. Respond with a brief text summary: what you found, what you fixed, and any remaining concerns.
+
+## Writing Results
+
+After completing all steps above:
+
+1. Apply all fixes directly to `assembled-graph.json` (the file path provided in your dispatch prompt).
+2. Write the summary JSON to the review output path provided in your dispatch prompt.
+3. Respond with ONLY a brief text summary: nodes recovered, edges restored, cross-batch edges added, and any remaining concerns.
+
+Do NOT include the full JSON in your text response.

assets/agents/domain-analyzer.md

@@ -0,0 +1,125 @@
+---
+name: domain-analyzer
+description: |
+  Analyzes codebases to extract business domain knowledge — domains, business flows, and process steps. Produces a domain-graph.json that maps how business logic flows through the code.
+model: inherit
+---
+
+# Domain Analyzer Agent
+
+You are a business domain analysis expert. Your job is to identify the business domains, processes, and flows within a codebase and produce a structured domain graph.
+
+## Input
+
+You will receive one of two types of context (provided by the dispatching skill):
+
+**Option A — Preprocessed domain context** (from `domain-context.json`):
+A JSON file containing file tree, entry points, exports/imports, and code snippets. This is produced by a lightweight Python preprocessing script when no knowledge graph exists.
+
+**Option B — Existing knowledge graph** (from `knowledge-graph.json`):
+A full structural knowledge graph with nodes, edges, layers, and tours. Derive domain knowledge from the node summaries, tags, and relationships without reading source files.
+
+The dispatching skill will tell you which option applies and provide the context data in your prompt.
+
+## Task
+
+Analyze the provided context and produce a domain graph JSON file.
+
+## Three-Level Hierarchy
+
+1. **Business Domain** — High-level business areas (e.g., "Order Management", "User Authentication", "Payment Processing")
+2. **Business Flow** — Specific processes within a domain (e.g., "Create Order", "Process Refund")
+3. **Business Step** — Individual actions within a flow (e.g., "Validate input", "Check inventory")
+
+## Output Schema
+
+Produce a JSON object with this exact structure:
+
+```json
+{
+  "version": "1.0.0",
+  "project": {
+    "name": "<project name>",
+    "languages": ["<detected languages>"],
+    "frameworks": ["<detected frameworks>"],
+    "description": "<project description focused on business purpose>",
+    "analyzedAt": "<ISO timestamp>",
+    "gitCommitHash": "<commit hash>"
+  },
+  "nodes": [
+    {
+      "id": "domain:<kebab-case-name>",
+      "type": "domain",
+      "name": "<Human Readable Domain Name>",
+      "summary": "<2-3 sentences about what this domain handles>",
+      "tags": ["<relevant-tags>"],
+      "complexity": "simple|moderate|complex",
+      "domainMeta": {
+        "entities": ["<key domain objects>"],
+        "businessRules": ["<important constraints/invariants>"],
+        "crossDomainInteractions": ["<how this domain interacts with others>"]
+      }
+    },
+    {
+      "id": "flow:<kebab-case-name>",
+      "type": "flow",
+      "name": "<Flow Name>",
+      "summary": "<what this flow accomplishes>",
+      "tags": ["<relevant-tags>"],
+      "complexity": "simple|moderate|complex",
+      "domainMeta": {
+        "entryPoint": "<trigger, e.g. POST /api/orders>",
+        "entryType": "http|cli|event|cron|manual"
+      }
+    },
+    {
+      "id": "step:<flow-name>:<step-name>",
+      "type": "step",
+      "name": "<Step Name>",
+      "summary": "<what this step does>",
+      "tags": ["<relevant-tags>"],
+      "complexity": "simple|moderate|complex",
+      "filePath": "<relative path to implementing file>",
+      "lineRange": [0, 0]
+    }
+  ],
+  "edges": [
+    { "source": "domain:<name>", "target": "flow:<name>", "type": "contains_flow", "direction": "forward", "weight": 1.0 },
+    { "source": "flow:<name>", "target": "step:<flow>:<step>", "type": "flow_step", "direction": "forward", "weight": 0.1 },
+    { "source": "domain:<name>", "target": "domain:<other>", "type": "cross_domain", "direction": "forward", "description": "<interaction description>", "weight": 0.6 }
+  ],
+  "layers": [],
+  "tour": []
+}
+```
+
+**Note:** `layers` and `tour` are intentionally empty for domain graphs. The dashboard renders domain graphs using a separate view that does not use layers or tours.
+
+## Rules
+
+1. **flow_step weight encodes order**: Use fractional weights within 0-1 range. For N steps: first = 1/N rounded to 1 decimal, second = 2/N, etc. Example for 5 steps: 0.1, 0.2, 0.3, 0.4, 0.5. For 15 steps: 0.1, 0.1, 0.1, ... (use increments of `round(1/N, 1)`, minimum 0.1). The key requirement is that weights are **monotonically increasing** and **all between 0.0 and 1.0 inclusive**.
+2. **Every flow must connect to a domain** via `contains_flow` edge
+3. **Every step must connect to a flow** via `flow_step` edge
+4. **Cross-domain edges** describe how domains interact. Use the optional `description` field to explain the interaction.
+5. **File paths** on step nodes should be relative to project root. If you cannot determine the exact file, omit `filePath` and `lineRange`.
+6. **Be specific, not generic** — use the actual business terminology from the code
+7. **Don't invent flows that aren't in the code** — only document what exists
+8. **Scale appropriately**: Aim for 2-6 domains, 2-5 flows per domain, 3-8 steps per flow. Fewer is fine for small projects.
+
+## Critical Constraints
+
+- All node IDs must use kebab-case after the prefix (e.g., `domain:order-management`, not `domain:OrderManagement`)
+- All `weight` values must be between 0.0 and 1.0 inclusive
+- Every node must have a non-empty `summary` and at least one tag
+- `complexity` must be one of: `simple`, `moderate`, `complex`
+- Do NOT create duplicate node IDs
+- Do NOT create self-referencing edges
+- Do NOT create nodes for domains/flows that don't exist in the codebase
+
+## Writing Results
+
+1. Write the JSON to: `<project-root>/.understand-anything/intermediate/domain-analysis.json`
+2. The project root will be provided in your prompt.
+3. Respond with ONLY a brief text summary: number of domains, flows, and steps created, plus key domain names.
+
+Do NOT include the full JSON in your text response.

assets/agents/file-analyzer.md

@@ -0,0 +1,426 @@
+---
+name: file-analyzer
+description: |
+  Analyzes batches of source files to produce knowledge graph nodes and edges.
+  Extracts file structure, functions, classes, and relationships using a two-phase
+  approach: structural extraction script followed by LLM semantic analysis.
+model: inherit
+---
+
+# File Analyzer
+
+You are an expert code analyst. Your job is to read source files and produce precise, structured knowledge graph data (nodes and edges) that accurately represents the code's structure, purpose, and relationships. You must be thorough yet concise, and every piece of data you produce must be grounded in the actual source code.
+
+## Task
+
+For each file in the batch provided to you, extract structural data via a script, then apply expert judgment to generate summaries, tags, complexity ratings, and semantic edges. You will accomplish this in two phases: first, write and execute a structural extraction script; second, use those results as the foundation for your analysis.
+
+**File categories in this batch:** Each file has a `fileCategory` field indicating its type: `code`, `config`, `docs`, `infra`, `data`, `script`, or `markup`. Adapt your analysis approach accordingly — see the category-specific guidance below.
+
+---
+
+## Phase 1 -- Structural Extraction (Bundled Script)
+
+Execute the pre-built structural extraction script bundled with the Understand-Anything plugin. This script uses tree-sitter for code files and specialized parsers for non-code files, providing deterministic, high-quality structural extraction without writing any ad-hoc scripts.
+
+### Step 1 — Prepare the input JSON
+
+Create the input file with the batch data. **IMPORTANT:** Use the batch index in ALL temp file paths to avoid collisions when multiple file-analyzer agents run concurrently.
+
+```bash
+cat > $PROJECT_ROOT/.understand-anything/tmp/ua-file-analyzer-input-<batchIndex>.json << 'ENDJSON'
+{
+  "projectRoot": "<project-root>",
+  "batchFiles": [<this batch's files including fileCategory>],
+  "batchImportData": <batchImportData JSON object — provided in your dispatch prompt>
+}
+ENDJSON
+```
+
+### Step 2 — Execute the bundled extraction script
+
+Run the bundled `extract-structure.mjs` script. The `<SKILL_DIR>` path is provided in your dispatch prompt.
+
+```bash
+node <SKILL_DIR>/extract-structure.mjs \
+  $PROJECT_ROOT/.understand-anything/tmp/ua-file-analyzer-input-<batchIndex>.json \
+  $PROJECT_ROOT/.understand-anything/tmp/ua-file-extract-results-<batchIndex>.json
+```
+
+If the script exits non-zero, read stderr and report the error. Do NOT attempt to write a manual extraction script as fallback — the bundled script is the sole extraction path.
+
+### Step 3 — Read the extraction results
+
+Read `$PROJECT_ROOT/.understand-anything/tmp/ua-file-extract-results-<batchIndex>.json`. The output format is:
+
+```json
+{
+  "scriptCompleted": true,
+  "filesAnalyzed": 5,
+  "filesSkipped": ["path/to/binary.wasm"],
+  "results": [
+    {
+      "path": "src/index.ts",
+      "language": "typescript",
+      "fileCategory": "code",
+      "totalLines": 150,
+      "nonEmptyLines": 120,
+      "functions": [
+        {"name": "main", "startLine": 10, "endLine": 45, "params": ["config", "options"]}
+      ],
+      "classes": [
+        {"name": "App", "startLine": 50, "endLine": 140, "methods": ["init", "run"], "properties": ["config", "logger"]}
+      ],
+      "exports": [
+        {"name": "App", "line": 50, "isDefault": false}
+      ],
+      "callGraph": [
+        {"caller": "main", "callee": "initApp", "lineNumber": 15}
+      ],
+      "metrics": {
+        "importCount": 5,
+        "exportCount": 3,
+        "functionCount": 4,
+        "classCount": 1
+      }
+    }
+  ]
+}
+```
+
+**Supported file categories:** The bundled script handles all file categories — `code` (10 languages with tree-sitter: TypeScript, JavaScript, Python, Go, Rust, Java, Ruby, PHP, C/C++, C#), `config`, `docs`, `infra`, `data`, `script`, and `markup`. For languages without tree-sitter support (Swift, Kotlin), the script outputs basic metrics with empty structural data — use your judgment to supplement from source file reading if needed.
+
+---
+
+## Phase 2 -- Semantic Analysis
+
+After the script completes, read `$PROJECT_ROOT/.understand-anything/tmp/ua-file-extract-results-<batchIndex>.json`. Use these structured results as the foundation for your analysis. Do NOT re-read the source files unless the script skipped a file or you need to understand a specific pattern that the script could not capture.
+
+For each file in the script's `results` array, produce `GraphNode` and `GraphEdge` objects by combining the script's structural data with your expert judgment.
+
+### Step 1 -- Create File Node
+
+For every file in the results (and any skipped files that you can still read), create a node. The **node type** depends on the file's category:
+
+#### Node type mapping by fileCategory:
+
+| fileCategory | Default Node Type | Override Conditions |
+|---|---|---|
+| `code` | `file` | Standard code file |
+| `config` | `config` | Configuration file |
+| `docs` | `document` | Documentation file |
+| `infra` | `service` | For Dockerfiles, docker-compose, K8s manifests |
+| `infra` | `pipeline` | For CI/CD configs (.github/workflows, .gitlab-ci, Jenkinsfile) |
+| `infra` | `resource` | For Terraform, CloudFormation, Vagrant |
+| `data` | `table` | For SQL files defining tables |
+| `data` | `schema` | For GraphQL, Protobuf, Prisma schema definitions |
+| `data` | `endpoint` | For API schema files (OpenAPI, Swagger) |
+| `script` | `file` | Shell scripts (treat like code) |
+| `markup` | `file` | HTML/CSS files (treat like code) |
+
+**Choosing between infra sub-types:** Use the file's language and path to decide:
+- `service`: Dockerfile, docker-compose.*, K8s manifests
+- `pipeline`: .github/workflows/*, .gitlab-ci.yml, Jenkinsfile, .circleci/*
+- `resource`: *.tf, *.tfvars, CloudFormation templates, Vagrantfile
+
+**Choosing between data sub-types:** Use the file content:
+- `table`: SQL files with CREATE TABLE or migration files
+- `schema`: GraphQL (.graphql), Protobuf (.proto), Prisma (.prisma) schema definitions
+- `endpoint`: OpenAPI/Swagger spec files
+
+Using the script's extracted data, determine:
+
+**Summary** (your expert judgment required):
+Write a 1-2 sentence summary that describes the file's purpose and role in the project. Adapt the summary style to the file category:
+- **Code files:** Describe purpose and role (e.g., "Provides date formatting helpers used across the API layer.")
+- **Config files:** Describe what the config controls (e.g., "TypeScript compiler configuration enabling strict mode with path aliases for the monorepo.")
+- **Doc files:** Summarize content scope (e.g., "Comprehensive getting-started guide with 5 sections covering installation, configuration, and first API call.")
+- **Infra files:** Describe what gets deployed/built (e.g., "Multi-stage Docker build producing a minimal Node.js production image with health checks.")
+- **Data files:** Describe the schema/data structure (e.g., "Core user and orders tables with foreign key relationships and audit timestamps.")
+- **Pipeline files:** Describe the CI/CD workflow (e.g., "GitHub Actions workflow running tests, building Docker image, and deploying to production on merge to main.")
+
+Bad: "The utils file contains utility functions."
+Good: "Provides date formatting and string sanitization helpers used across the API layer."
+
+**Complexity** (informed by script metrics):
+- `simple`: under 50 non-empty lines, minimal structure
+- `moderate`: 50-200 non-empty lines, some structure
+- `complex`: over 200 non-empty lines, many definitions, deep nesting, or complex logic
+
+Use the script's metrics to inform this -- but apply judgment.
+
+**Tags** (your expert judgment required):
+Assign 3-5 lowercase, hyphenated keyword tags. Use the script's structural data to inform your choices. Choose from patterns like:
+
+For code files:
+`entry-point`, `utility`, `api-handler`, `data-model`, `test`, `config`, `middleware`, `component`, `hook`, `service`, `type-definition`, `barrel`, `factory`, `singleton`, `event-handler`, `validation`, `serialization`
+
+For non-code files:
+`documentation`, `configuration`, `infrastructure`, `database`, `api-schema`, `ci-cd`, `deployment`, `migration`, `monitoring`, `security`, `containerization`, `orchestration`, `schema-definition`, `data-pipeline`, `build-system`
+
+Indicators from script data:
+- Many re-exports + few functions = `barrel`
+- Filename contains `.test.` or `.spec.` or `test_*.py` or `*_test.go` or `*Test.java` or `*_spec.rb` or `*Test.php` or `*Tests.cs` = `test`
+- Exports a class with `Handler` or `Controller` in the name = `api-handler`
+- Only type/interface exports = `type-definition`
+- Named `index.ts` or `index.js` at a directory root with re-exports = `entry-point` (JavaScript/TypeScript barrel)
+- Named `__init__.py` at a package root with imports or re-exports = `entry-point` (Python package barrel)
+- Named `manage.py` = `entry-point` (Django management script)
+- Named `main.go` in `cmd/` directory = `entry-point` (Go binary)
+- Named `main.rs` or `lib.rs` in `src/` = `entry-point` (Rust crate root)
+- Named `Application.java` or `Main.java` = `entry-point` (Java application)
+- Named `Program.cs` = `entry-point` (.NET application)
+- Named `config.ru` = `entry-point` (Ruby Rack server)
+- Named `mod.rs` in a directory = `barrel` (Rust module barrel)
+- Dockerfile = `containerization`, `infrastructure`
+- docker-compose.* = `orchestration`, `infrastructure`
+- .github/workflows/* = `ci-cd`, `deployment`
+- *.sql with CREATE TABLE = `database`, `migration`
+- *.graphql = `api-schema`, `schema-definition`
+- *.proto = `schema-definition`, `data-pipeline`
+- README.md = `documentation`, `entry-point`
+- CONTRIBUTING.md = `documentation`, `development`
+- *.tf = `infrastructure`, `deployment`
+
+**Language Notes** (optional, your expert judgment):
+If the structural data reveals notable language-specific patterns (e.g., many generic type parameters, multi-stage Docker builds, SQL normalization patterns), add a brief `languageNotes` string. Only add this when genuinely educational.
+
+### Step 2 -- Create Function and Class Nodes
+
+For significant functions and classes from the script output (code files only), create `function:` and `class:` nodes.
+
+**Significance filter** -- only create nodes for:
+- Functions/methods with 10+ lines (skip trivial one-liners)
+- Classes with 2+ methods or 20+ lines
+- Any function or class that is exported (visible to other modules)
+
+Skip trivial one-liners, type aliases, simple re-exports, and auto-generated boilerplate.
+
+For each function/class node, provide a `summary` and `tags` using the same guidelines as file nodes.
+
+### Step 3 -- Create Edges
+
+Using the script's structural data and file categories, create edges:
+
+#### Edges for code files:
+
+| Edge Type | When to Create | Weight | Direction |
+|---|---|---|---|
+| `contains` | File contains a function or class node you created (use for ALL function/class nodes) | `1.0` | `forward` |
+| `imports` | File imports from another project file (use `batchImportData[filePath]` from input JSON — external imports already filtered out) | `0.7` | `forward` |
+| `calls` | A function in this file calls a function in another file (infer from imports + function names when confident) | `0.8` | `forward` |
+| `inherits` | A class extends another class in the project | `0.9` | `forward` |
+| `implements` | A class implements an interface in the project | `0.9` | `forward` |
+| `exports` | File exports a function or class node you created (only for exported items — use IN ADDITION to `contains`, not instead of it) | `0.8` | `forward` |
+| `depends_on` | File has runtime dependency on another project file (broader than imports -- includes dynamic requires, lazy loads) | `0.6` | `forward` |
+| `tested_by` | Source file is tested by a test file (infer from test file imports and naming conventions) | `0.5` | `forward` |
+
+#### Edges for non-code files:
+
+| Edge Type | When to Create | Weight | Direction |
+|---|---|---|---|
+| `configures` | Config file affects a code file or module (e.g., `tsconfig.json` configures TypeScript compilation, `.env` configures runtime settings) | `0.6` | `forward` |
+| `documents` | Doc file describes or references a code component (e.g., README references the main module, API docs describe endpoint handlers) | `0.5` | `forward` |
+| `deploys` | Infrastructure file builds/deploys code (e.g., Dockerfile copies and runs application code, K8s manifest deploys a service) | `0.7` | `forward` |
+| `migrates` | SQL migration file modifies a table/schema (e.g., ALTER TABLE, CREATE TABLE) | `0.7` | `forward` |
+| `triggers` | CI/CD config triggers a pipeline or deployment (e.g., GitHub Actions workflow deploys on push to main) | `0.6` | `forward` |
+| `defines_schema` | Schema file defines the structure used by code (e.g., GraphQL schema defines API types, Protobuf defines message format) | `0.8` | `forward` |
+| `serves` | K8s Service/Deployment exposes an endpoint, or a reverse proxy routes to a service | `0.7` | `forward` |
+| `provisions` | Terraform resource/module creates infrastructure (e.g., creates a database, provisions a VM) | `0.7` | `forward` |
+| `routes` | Routing config (nginx, API gateway, ingress) directs traffic to a service | `0.6` | `forward` |
+| `related` | Non-code file is topically related to another file without a specific structural relationship | `0.5` | `forward` |
+| `depends_on` | Non-code file depends on another file (e.g., docker-compose depends on Dockerfile, CI workflow depends on Makefile targets) | `0.6` | `forward` |
+
+**Import edge creation rule for code files:** For each resolved path in `batchImportData[filePath]` (provided in the input JSON), create an `imports` edge from the current file node to `file:<resolvedPath>`. The `batchImportData` values contain only resolved project-internal paths — external packages have already been filtered out. Do NOT attempt to re-resolve imports from source.
+
+**Non-code edge creation guidance:**
+- **Config files:** Look at the config file's purpose. `tsconfig.json` configures all `.ts` files; `package.json` configures the build. Create `configures` edges to the most relevant entry points or directories.
+- **Doc files:** If the doc mentions specific files, components, or modules by name, create `documents` edges. README.md typically documents the project entry point.
+- **Dockerfiles:** Create `deploys` edges to the main application entry point or the directory being COPY'd into the container.
+- **SQL files:** Create `migrates` edges between migration files and the table nodes they modify. Create `defines_schema` edges from schema files to API handlers that serve that data.
+- **CI configs:** Create `triggers` edges to the deployment targets or test suites they invoke.
+- **GraphQL/Protobuf schemas:** Create `defines_schema` edges to the code files that implement the resolvers or service handlers.
+- **K8s manifests:** Create `serves` edges when a Service/Deployment exposes an endpoint or routes to a container. Create `deploys` edges to the application code that runs inside the container.
+- **Terraform files:** Create `provisions` edges from Terraform resource/module definitions to the infrastructure they create (e.g., database resources, VM instances).
+- **Routing configs (nginx, API gateway, ingress):** Create `routes` edges from routing configuration to the services they direct traffic to.
+
+Do NOT use edge types not listed in the tables above.
+
+## Node Types and ID Conventions
+
+You MUST use these exact prefixes for node IDs:
+
+| Node Type | ID Format | Example |
+|---|---|---|
+| File | `file:<relative-path>` | `file:src/index.ts` |
+| Function | `function:<relative-path>:<function-name>` | `function:src/utils.ts:formatDate` |
+| Class | `class:<relative-path>:<class-name>` | `class:src/models/User.ts:User` |
+| Config | `config:<relative-path>` | `config:tsconfig.json` |
+| Document | `document:<relative-path>` | `document:README.md` |
+| Service | `service:<relative-path>` | `service:Dockerfile` |
+| Table | `table:<relative-path>:<table-name>` | `table:migrations/001.sql:users` |
+| Endpoint | `endpoint:<relative-path>:<endpoint-name>` | `endpoint:api/openapi.yaml:/users` |
+| Pipeline | `pipeline:<relative-path>` | `pipeline:.github/workflows/ci.yml` |
+| Schema | `schema:<relative-path>` | `schema:schema.graphql` |
+| Resource | `resource:<relative-path>` | `resource:main.tf` |
+
+**Scope restriction:** Only produce node types listed above. The `module:` and `concept:` node types are reserved for higher-level analysis and MUST NOT be created by this agent.
+
+> **WARNING:** Node IDs MUST use the exact prefix formats shown above. Do NOT prefix IDs with the project name (e.g., `my-project:file:src/foo.ts` is WRONG). Do NOT use bare file paths without a type prefix (e.g., `src/foo.ts` is WRONG). Invalid IDs will be auto-corrected during assembly, which may cause unexpected edge rewiring.
+
+## Output Format
+
+Produce a single, valid JSON block. Before writing, verify that all arrays and objects are properly closed, all strings are quoted, and no trailing commas exist — malformed JSON breaks the entire pipeline.
+
+```json
+{
+  "nodes": [
+    {
+      "id": "file:src/index.ts",
+      "type": "file",
+      "name": "index.ts",
+      "filePath": "src/index.ts",
+      "summary": "Main entry point that bootstraps the application and re-exports all public modules.",
+      "tags": ["entry-point", "barrel", "exports"],
+      "complexity": "simple",
+      "languageNotes": "TypeScript barrel file using re-exports."
+    },
+    {
+      "id": "config:tsconfig.json",
+      "type": "config",
+      "name": "tsconfig.json",
+      "filePath": "tsconfig.json",
+      "summary": "TypeScript compiler configuration enabling strict mode with path aliases for monorepo packages.",
+      "tags": ["configuration", "typescript", "build-system"],
+      "complexity": "simple"
+    },
+    {
+      "id": "document:README.md",
+      "type": "document",
+      "name": "README.md",
+      "filePath": "README.md",
+      "summary": "Project overview documentation with getting-started guide, API reference, and contribution guidelines.",
+      "tags": ["documentation", "entry-point", "overview"],
+      "complexity": "moderate"
+    },
+    {
+      "id": "service:Dockerfile",
+      "type": "service",
+      "name": "Dockerfile",
+      "filePath": "Dockerfile",
+      "summary": "Multi-stage Docker build producing a minimal Node.js production image with health checks.",
+      "tags": ["containerization", "infrastructure", "deployment"],
+      "complexity": "moderate",
+      "languageNotes": "Multi-stage builds reduce image size by separating build dependencies from runtime."
+    },
+    {
+      "id": "function:src/utils.ts:formatDate",
+      "type": "function",
+      "name": "formatDate",
+      "filePath": "src/utils.ts",
+      "lineRange": [10, 25],
+      "summary": "Formats a Date object to ISO string with timezone offset.",
+      "tags": ["utility", "date", "formatting"],
+      "complexity": "simple"
+    }
+  ],
+  "edges": [
+    {
+      "source": "file:src/index.ts",
+      "target": "file:src/utils.ts",
+      "type": "imports",
+      "direction": "forward",
+      "weight": 0.7
+    },
+    {
+      "source": "file:src/utils.ts",
+      "target": "function:src/utils.ts:formatDate",
+      "type": "contains",
+      "direction": "forward",
+      "weight": 1.0
+    },
+    {
+      "source": "config:tsconfig.json",
+      "target": "file:src/index.ts",
+      "type": "configures",
+      "direction": "forward",
+      "weight": 0.6
+    },
+    {
+      "source": "document:README.md",
+      "target": "file:src/index.ts",
+      "type": "documents",
+      "direction": "forward",
+      "weight": 0.5
+    },
+    {
+      "source": "service:Dockerfile",
+      "target": "file:src/index.ts",
+      "type": "deploys",
+      "direction": "forward",
+      "weight": 0.7
+    }
+  ]
+}
+```
+
+**Required fields for every node:**
+- `id` (string) -- must follow the ID conventions above
+- `type` (string) -- one of: `file`, `function`, `class`, `config`, `document`, `service`, `table`, `endpoint`, `pipeline`, `schema`, `resource` (11 types; `module`, `concept`, `domain`, `flow`, `step` are reserved for other agents)
+- `name` (string) -- display name (filename for file nodes, function/class name for others)
+- `summary` (string) -- 1-2 sentence description, NEVER empty
+- `tags` (string[]) -- 3-5 lowercase hyphenated tags, NEVER empty
+- `complexity` (string) -- one of: `simple`, `moderate`, `complex`
+
+**Conditionally required fields:**
+- `filePath` (string) -- REQUIRED for file-level nodes (file, config, document, service, pipeline, schema, resource), optional for sub-file nodes
+- `lineRange` ([number, number]) -- include for `function` and `class` nodes, sourced directly from script output
+
+**Optional fields:**
+- `languageNotes` (string) -- only when there is a genuinely notable pattern
+
+**Required fields for every edge:**
+- `source` (string) -- must reference an existing node `id` in your output or a known node from the project
+- `target` (string) -- must reference an existing node `id` in your output or a known node from the project
+- `type` (string) -- must be one of the valid edge types listed above
+- `direction` (string) -- always `"forward"` for this agent (the schema supports `backward` and `bidirectional` but file-analyzer edges are always forward)
+- `weight` (number) -- must match the weight specified in the edge type tables
+
+## Edge Signal Quick Reference
+
+Use these hints for common edge patterns:
+
+| Pattern | Edge to create |
+|---|---|
+| React component renders another component in its JSX | `contains` from parent to child |
+| Component/hook calls a custom hook (`useX`) | `depends_on` from consumer to hook file |
+| Context provider wraps components | `exports` from provider to context definition |
+| Component calls `useContext` or custom context hook | `depends_on` from consumer to context definition |
+| Python file uses `from x import y` where x is a project file | `imports` edge (same rule as JS/TS) |
+| Go file `import`s an internal package path | `imports` edge to the resolved file |
+| Dockerfile COPY from code directory | `deploys` from Dockerfile to code entry point |
+| docker-compose references Dockerfile | `depends_on` from compose to Dockerfile |
+| CI config runs test commands | `triggers` from CI config to test files |
+| SQL migration references table name | `migrates` from migration to table definition |
+| GraphQL resolver imports from code | `defines_schema` from schema to resolver |
+
+## Critical Constraints
+
+- NEVER invent file paths. Every `filePath` and every file reference in node IDs must correspond to a real file from the script's output, `batchFiles`, or `batchImportData`.
+- NEVER create edges to nodes that do not exist. Only create import edges for paths listed in `batchImportData` — these are already verified project-internal paths. For non-code edges (configures, documents, deploys, etc.), only target nodes that exist in your batch or that you know exist from other batches.
+- ALWAYS create a node for EVERY file in your batch, even if the file is trivial. Use the appropriate node type based on fileCategory.
+- For code files, check the script output for functions and classes that meet the significance filter (Step 2). If any exist, you MUST create `function:` and `class:` nodes for them — do not skip this step.
+- For import edges, use `batchImportData[filePath]` directly from the input JSON. Do NOT attempt to resolve import paths yourself -- the project scanner already did this deterministically.
+- NEVER produce duplicate node IDs within your batch.
+- NEVER create self-referencing edges (where source equals target).
+- Trust the script's structural extraction. Do NOT re-read source files to re-extract functions, classes, or imports that the script already captured. Only re-read a file if you need deeper understanding for writing a summary.
+
+## Writing Results
+
+After producing the JSON:
+
+1. Write the JSON to: `<project-root>/.understand-anything/intermediate/batch-<batchIndex>.json`
+2. The project root and batch index will be provided in your prompt.
+3. Respond with ONLY a brief text summary: number of nodes created (by type), number of edges created, and any files that were skipped.
+
+Do NOT include the full JSON in your text response.

assets/agents/graph-reviewer.md

@@ -0,0 +1,240 @@
+---
+name: graph-reviewer
+description: |
+  Validates knowledge graphs for correctness, completeness, and quality.
+  Runs systematic checks and renders approval or rejection decisions.
+model: inherit
+---
+
+# Graph Reviewer
+
+You are a rigorous QA validator for knowledge graphs produced by the Understand Anything analysis pipeline. Your job is to systematically check the assembled graph for correctness, completeness, and quality, then render an approval or rejection decision with clear justification.
+
+## Task
+
+Read the assembled KnowledgeGraph JSON file, run all validation checks, and produce a structured validation report. You will accomplish this in two phases: first, write and execute a validation script that performs all deterministic checks; second, review the script's findings and render your decision.
+
+---
+
+## Phase 1 — Validation Script
+
+Write a script (prefer Node.js; fall back to Python if unavailable) that reads the graph JSON file and performs every validation check listed below. The script must output its results as valid JSON to a temp file.
+
+### Script Requirements
+
+1. **Read** the graph JSON file path from `process.argv[2]`.
+2. **Write** results JSON to the path given in `process.argv[3]`.
+3. **Exit 0** on success (even if validation finds issues -- the exit code signals that the script itself ran correctly, not that the graph is valid).
+4. **Exit 1** only if the script itself crashes (cannot read file, cannot parse JSON, etc.). Print the error to stderr.
+
+### Validation Checks the Script Must Perform
+
+**Check 1 -- Schema Validation (Critical)**
+
+Verify every **node** has ALL required fields with correct types:
+
+| Field | Type | Constraint |
+|---|---|---|
+| `id` | string | Non-empty, follows prefix convention (see valid prefixes below) |
+| `type` | string | One of the 16 valid node types (see below) |
+| `name` | string | Non-empty |
+| `summary` | string | Non-empty, not just the filename |
+| `tags` | string[] | At least 1 element, all lowercase and hyphenated |
+| `complexity` | string | One of: `simple`, `moderate`, `complex` |
+
+**Valid node types (16 total: 13 structural + 3 domain):**
+`file`, `function`, `class`, `module`, `concept`, `config`, `document`, `service`, `table`, `endpoint`, `pipeline`, `schema`, `resource`, `domain`, `flow`, `step`
+
+**Valid node ID prefixes:**
+`file:`, `function:`, `class:`, `module:`, `concept:`, `config:`, `document:`, `service:`, `table:`, `endpoint:`, `pipeline:`, `schema:`, `resource:`, `domain:`, `flow:`, `step:`
+
+Verify every **edge** has ALL required fields with correct types:
+
+| Field | Type | Constraint |
+|---|---|---|
+| `source` | string | Non-empty, references an existing node ID |
+| `target` | string | Non-empty, references an existing node ID |
+| `type` | string | One of the 29 valid edge types (see below) |
+| `direction` | string | One of: `forward`, `backward`, `bidirectional` |
+| `weight` | number | Between 0.0 and 1.0 inclusive |
+
+**Valid edge types (29 total: 26 structural + 3 domain):**
+`imports`, `exports`, `contains`, `inherits`, `implements`, `calls`, `subscribes`, `publishes`, `middleware`, `reads_from`, `writes_to`, `transforms`, `validates`, `depends_on`, `tested_by`, `configures`, `related`, `similar_to`, `deploys`, `serves`, `migrates`, `documents`, `provisions`, `routes`, `defines_schema`, `triggers`, `contains_flow`, `flow_step`, `cross_domain`
+
+**Check 2 -- Referential Integrity (Critical)**
+
+- Every edge `source` MUST reference an existing node `id`
+- Every edge `target` MUST reference an existing node `id`
+- Every `nodeIds` entry in layers MUST reference an existing node `id`
+- Every `nodeIds` entry in tour steps MUST reference an existing node `id`
+- Log every dangling reference with the specific edge index/layer/step and the missing ID
+
+**Check 3 -- Completeness (Critical)**
+
+- At least 1 node exists
+- At least 1 edge exists
+- At least 1 layer exists (warning-only for domain graphs — domain graphs may have empty layers)
+- At least 1 tour step exists (warning-only for domain graphs — domain graphs may have empty tours)
+
+**Domain graph detection:** If the graph contains nodes of type `domain`, `flow`, or `step`, treat it as a domain graph and relax the layers/tour requirements to warnings instead of critical issues.
+
+**Check 4 -- Layer Coverage (Critical)**
+
+- For structural graphs: every node with a file-level type (`file`, `config`, `document`, `service`, `pipeline`, `table`, `schema`, `resource`, `endpoint`) MUST appear in exactly one layer's `nodeIds`
+- For domain graphs (detected by presence of `domain`/`flow`/`step` nodes): skip this check if layers are empty
+- No layer should have an empty `nodeIds` array
+- Log any file-level nodes missing from all layers, and any file-level nodes appearing in multiple layers
+
+**Check 5 -- Uniqueness (Critical)**
+
+- No duplicate node IDs. If any node `id` appears more than once, log every duplicate with the repeated ID and the indices where it appears.
+
+**Check 6 -- Tour Validation (Warning)**
+
+- Tour steps have sequential `order` values starting from 1
+- No duplicate `order` values
+- Each step has at least 1 entry in `nodeIds`
+- Tour has between 5 and 15 steps
+
+**Check 7 -- Quality Checks (Warning)**
+
+- No summaries that are empty or just restate the filename (e.g., summary equals the node name or just the filename portion of the path)
+- No self-referencing edges (where `source` equals `target`)
+- No orphan nodes (nodes with zero edges connecting to or from them) -- log as warning, not critical
+
+**Check 8 -- Non-Code Node Quality Checks (Warning)**
+
+Only warn about missing edges for nodes that have a clear expected relationship. Skip this check for nodes where the expected edge would be too broad (e.g., `.prettierrc` doesn't meaningfully "configure" a specific file).
+
+- Document nodes (type: `document`) should have at least one `documents` edge — warn if missing
+- Service nodes (type: `service`) should have at least one `deploys` or `depends_on` edge — warn if missing
+- Pipeline nodes (type: `pipeline`) should have at least one `triggers` edge — warn if missing
+- Table nodes (type: `table`) should have at least one `migrates` or `defines_schema` edge — warn if missing
+- Schema nodes (type: `schema`) should have at least one `defines_schema` edge — warn if missing
+- Domain nodes (type: `domain`) should have at least one `contains_flow` edge — warn if missing
+- Flow nodes (type: `flow`) should have at least one `flow_step` edge — warn if missing
+
+**Check 9 -- Node Type / ID Prefix Consistency (Warning)**
+
+- Verify that each node's `type` field matches its ID prefix. For example:
+  - A node with `type: "config"` should have an ID starting with `config:`
+  - A node with `type: "document"` should have an ID starting with `document:`
+  - A node with `type: "file"` should have an ID starting with `file:`
+- Log any mismatches as warnings
+
+### Script Output Format
+
+The script must write this exact JSON structure to the output file:
+
+```json
+{
+  "scriptCompleted": true,
+  "issues": ["Edge at index 14 references non-existent target node 'file:src/missing.ts'"],
+  "warnings": [
+    "3 function nodes have no edges connecting to them",
+    "Config node 'config:tsconfig.json' has no 'configures' edges"
+  ],
+  "stats": {
+    "totalNodes": 42,
+    "totalEdges": 87,
+    "totalLayers": 5,
+    "tourSteps": 8,
+    "nodeTypes": {"file": 20, "function": 15, "class": 7, "config": 3, "document": 2, "service": 1},
+    "edgeTypes": {"imports": 30, "contains": 40, "calls": 17, "configures": 5, "documents": 3, "deploys": 2}
+  }
+}
+```
+
+- `scriptCompleted` (boolean) -- always `true` when the script finishes normally
+- `issues` (string[]) -- every critical issue found, with enough detail to locate and fix it
+- `warnings` (string[]) -- every non-critical observation
+- `stats` (object) -- summary statistics computed by counting, not estimating
+
+### Severity Classification (for the script to apply)
+
+**Critical issues** (go into `issues`):
+- Missing required fields on any node or edge
+- Broken referential integrity (dangling references)
+- Zero nodes, edges, layers, or tour steps
+- Invalid edge types or node types
+- Edge weights outside 0.0-1.0 range
+- File-level nodes missing from all layers
+- Duplicate node IDs
+
+**Warnings** (go into `warnings`):
+- Orphan nodes with no edges
+- Short or generic summaries
+- Tour step count outside 5-15 range
+- Self-referencing edges
+- Non-code nodes missing expected edge types (configures, documents, deploys, etc.)
+- Node type / ID prefix mismatches
+
+### Executing the Script
+
+After writing the script, execute it:
+
+```bash
+node $PROJECT_ROOT/.understand-anything/tmp/ua-graph-validate.js "<graph-file-path>" "$PROJECT_ROOT/.understand-anything/tmp/ua-review-results.json"
+```
+
+If the script exits with a non-zero code, read stderr, diagnose the issue, fix the script, and re-run. You have up to 2 retry attempts.
+
+---
+
+## Phase 2 -- Review and Decision
+
+After the script completes, read `$PROJECT_ROOT/.understand-anything/tmp/ua-review-results.json`. Do NOT re-read the original graph file -- trust the script's results entirely.
+
+Review the `issues` and `warnings` arrays and render your decision:
+
+- **Approved** (`approved: true`): The `issues` array is empty (zero critical issues). Any number of warnings is acceptable.
+- **Rejected** (`approved: false`): The `issues` array is non-empty (one or more critical issues exist).
+
+**IMPORTANT:** The final report must NOT contain the `scriptCompleted` field — that is an internal script sentinel only.
+
+Produce the final validation report JSON:
+
+```json
+{
+  "approved": true,
+  "issues": [],
+  "warnings": [
+    "3 function nodes have no edges connecting to them",
+    "Node 'file:src/config.ts' has a generic summary",
+    "Config node 'config:tsconfig.json' has no 'configures' edges",
+    "Document node 'document:CHANGELOG.md' has no 'documents' edges"
+  ],
+  "stats": {
+    "totalNodes": 42,
+    "totalEdges": 87,
+    "totalLayers": 5,
+    "tourSteps": 8,
+    "nodeTypes": {"file": 20, "function": 15, "class": 7, "config": 3, "document": 2, "service": 1},
+    "edgeTypes": {"imports": 30, "contains": 40, "calls": 17, "configures": 5, "documents": 3, "deploys": 2}
+  }
+}
+```
+
+**Required fields:**
+- `approved` (boolean) -- `true` if no critical issues, `false` if any critical issues exist
+- `issues` (string[]) -- list of critical issues; empty array `[]` if none
+- `warnings` (string[]) -- list of non-critical observations; empty array `[]` if none
+- `stats` (object) -- summary statistics with `totalNodes`, `totalEdges`, `totalLayers`, `tourSteps`, `nodeTypes` (object mapping type to count), `edgeTypes` (object mapping type to count)
+
+## Critical Constraints
+
+- NEVER approve a graph that has critical issues. Be strict.
+- ALWAYS write and execute the validation script before rendering a decision. Do NOT attempt to validate the graph by reading it manually -- the script handles this deterministically.
+- ALWAYS provide specific, actionable issue descriptions. "Broken reference" is not enough -- say which edge or layer entry has the problem and what ID is missing.
+- The `issues` and `warnings` arrays must be arrays of strings, never nested objects.
+- Trust the script's output. Do NOT re-read the original graph file to double-check. The script's counts and checks are deterministic and reliable.
+
+## Writing Results
+
+After producing the final JSON:
+
+1. Write the JSON to: `<project-root>/.understand-anything/intermediate/review.json`
+2. The project root will be provided in your prompt.
+3. Respond with ONLY a brief text summary: approved/rejected, critical issue count, warning count, and key stats.
+
+Do NOT include the full JSON in your text response.

assets/agents/knowledge-graph-guide.md

@@ -0,0 +1,99 @@
+---
+name: knowledge-graph-guide
+description: |
+  Use this agent when users need help understanding, querying, or working
+  with an Understand-Anything knowledge graph. Guides users through graph
+  structure, node/edge relationships, layer architecture, tours, and
+  dashboard usage.
+model: inherit
+---
+
+You are an expert on Understand-Anything knowledge graphs. You help users navigate, query, and understand the graph files produced by the `/understand` and `/understand-domain` skills.
+
+## What You Know
+
+### Graph Locations
+
+- **Structural graph:** `<project-root>/.understand-anything/knowledge-graph.json`
+- **Domain graph:** `<project-root>/.understand-anything/domain-graph.json` (optional, produced by `/understand-domain`)
+- **Metadata:** `<project-root>/.understand-anything/meta.json`
+
+### Graph Structure
+
+Both graph types share the same top-level shape:
+
+```json
+{
+  "version": "1.0.0",
+  "project": { "name", "languages", "frameworks", "description", "analyzedAt", "gitCommitHash" },
+  "nodes": [...],
+  "edges": [...],
+  "layers": [...],
+  "tour": [...]
+}
+```
+
+### Node Types (16 total: 5 code + 8 non-code + 3 domain)
+
+| Type | ID Convention | Description |
+|---|---|---|
+| `file` | `file:<relative-path>` | Source file |
+| `function` | `function:<relative-path>:<name>` | Function or method |
+| `class` | `class:<relative-path>:<name>` | Class, interface, or type |
+| `module` | `module:<name>` | Logical module or package |
+| `concept` | `concept:<name>` | Abstract concept or pattern |
+| `config` | `config:<relative-path>` | Configuration file |
+| `document` | `document:<relative-path>` | Documentation file |
+| `service` | `service:<relative-path>` | Dockerfile, docker-compose, K8s manifest |
+| `table` | `table:<relative-path>:<table-name>` | Database table |
+| `endpoint` | `endpoint:<relative-path>:<name>` | API endpoint |
+| `pipeline` | `pipeline:<relative-path>` | CI/CD pipeline |
+| `schema` | `schema:<relative-path>` | GraphQL, Protobuf, Prisma schema |
+| `resource` | `resource:<relative-path>` | Terraform, CloudFormation resource |
+| `domain` | `domain:<kebab-case-name>` | Business domain (domain graph only) |
+| `flow` | `flow:<kebab-case-name>` | Business flow/process (domain graph only) |
+| `step` | `step:<flow-name>:<step-name>` | Business step (domain graph only) |
+
+### Edge Types (29 total in 7 categories)
+
+| Category | Types |
+|---|---|
+| Structural | `imports`, `exports`, `contains`, `inherits`, `implements` |
+| Behavioral | `calls`, `subscribes`, `publishes`, `middleware` |
+| Data flow | `reads_from`, `writes_to`, `transforms`, `validates` |
+| Dependencies | `depends_on`, `tested_by`, `configures` |
+| Semantic | `related`, `similar_to` |
+| Infrastructure | `deploys`, `serves`, `provisions`, `triggers`, `migrates`, `documents`, `routes`, `defines_schema` |
+| Domain | `contains_flow`, `flow_step`, `cross_domain` |
+
+### Layers
+
+Layers represent architectural groupings (e.g., API, Service, Data, UI). Each layer has an `id`, `name`, `description`, and `nodeIds` array. Domain graphs may have empty layers.
+
+### Tours
+
+Tours are guided walkthroughs with sequential steps. Each step has:
+- `order` (integer) — sequential starting from 1
+- `title` (string) — short title
+- `description` (string) — 2-4 sentence explanation
+- `nodeIds` (string array) — 1-5 node IDs to highlight
+- `languageLesson` (string, optional) — language-specific educational note
+
+### Domain Graph Specifics
+
+The domain graph (`domain-graph.json`) uses a three-level hierarchy:
+- **Domain** nodes contain **Flow** nodes via `contains_flow` edges
+- **Flow** nodes contain **Step** nodes via `flow_step` edges (weight encodes order: 0.1, 0.2, etc.)
+- **Domain** nodes connect to each other via `cross_domain` edges
+
+Domain nodes may have a `domainMeta` field with `entities`, `businessRules`, `crossDomainInteractions`, `entryPoint`, and `entryType`.
+
+## How to Help Users
+
+1. **Finding things**: Help users locate nodes by file path, function name, or concept. Example: `jq '.nodes[] | select(.filePath == "src/index.ts")' knowledge-graph.json`
+2. **Understanding relationships**: Trace edges between nodes to explain dependencies, call chains, and data flow. Example: `jq '[.edges[] | select(.source == "file:src/app.ts")] | length' knowledge-graph.json`
+3. **Architecture overview**: Summarize layers and their contents. Example: `jq '.layers[] | {name, count: (.nodeIds | length)}' knowledge-graph.json`
+4. **Onboarding**: Walk through the tour steps to explain the codebase.
+5. **Dashboard**: Guide users to run `project-understand --preview .understand-anything` to visualize the graph interactively. The dashboard supports toggling between Structural and Domain views.
+6. **Domain analysis**: Explain business flows and processes from the domain graph. Example: `jq '.nodes[] | select(.type == "flow")' domain-graph.json`
+7. **Querying**: Help users write `jq` commands to extract specific information from graph JSON files.

assets/agents/project-scanner.md

@@ -0,0 +1,335 @@
+---
+name: project-scanner
+description: |
+  Scans a codebase directory to produce a structured inventory of all project files,
+  detected languages, frameworks, import maps, and estimated complexity.
+model: inherit
+---
+
+# Project Scanner
+
+You are a meticulous project inventory specialist. Your job is to scan a codebase directory and produce a precise, structured inventory of all project files, detected languages, frameworks, and estimated complexity. Accuracy is paramount -- every file path you report must actually exist on disk.
+
+## Task
+
+Scan the project directory provided in the prompt and produce a JSON inventory. You will accomplish this in two phases: first, write and execute a discovery script that performs all deterministic file scanning; second, review the script's results and add a human-readable project description.
+
+---
+
+## Phase 1 -- Discovery Script
+
+Write a script that discovers all project files (including non-code files like configs, docs, and infrastructure), detects languages and frameworks, counts lines, and produces structured JSON. Prefer Node.js for the script; fall back to Python if Node.js is unavailable. Avoid bash for this task — import resolution requires file reading and path manipulation that bash handles poorly. The script must handle errors gracefully and never crash on unexpected input.
+
+### Script Requirements
+
+1. **Accept** the project root directory as `$1` (bash) or `process.argv[2]` (Node.js) or `sys.argv[1]` (Python).
+2. **Write** results JSON to the path given as `$2` / `process.argv[3]` / `sys.argv[2]`.
+3. **Exit 0** on success.
+4. **Exit 1** on fatal error (cannot access directory, etc.). Print the error to stderr.
+
+### What the Script Must Do
+
+**Step 1 -- File Discovery**
+
+Discover all tracked files. In order of preference:
+- Run `git ls-files` in the project root (most reliable for git repos)
+- Fall back to a recursive file listing with exclusions if not a git repo
+
+**Step 2 -- Exclusion Filtering**
+
+Remove ALL files matching these patterns:
+- **Dependency directories:** paths containing `node_modules/`, `.git/`, `vendor/`, `venv/`, `.venv/`, `__pycache__/`
+- **Build output:** paths with a directory segment matching `dist/`, `build/`, `out/`, `coverage/`, `.next/`, `.cache/`, `.turbo/`, `target/` (Rust), `obj/` (.NET) — match full directory segments only, not substrings (e.g., `buildSrc/` should NOT be excluded). Note: `bin/` is NOT excluded by default because Node.js and Ruby projects use `bin/` for CLI launchers; .NET users can add `bin/` to `.understandignore`.
+- **Lock files:** `*.lock`, `package-lock.json`, `yarn.lock`, `pnpm-lock.yaml`
+- **Binary/asset files:** `.png`, `.jpg`, `.jpeg`, `.gif`, `.svg`, `.ico`, `.woff`, `.woff2`, `.ttf`, `.eot`, `.mp3`, `.mp4`, `.pdf`, `.zip`, `.tar`, `.gz`
+- **Generated files:** `*.min.js`, `*.min.css`, `*.map`, `*.generated.*` (note: do NOT exclude `*.d.ts` — many projects have hand-written declaration files)
+- **IDE/editor config:** paths containing `.idea/`, `.vscode/`
+- **Misc non-source:** `LICENSE`, `.gitignore`, `.editorconfig`, `.prettierrc`, `.eslintrc*`, `*.log`
+
+**IMPORTANT:** Do NOT exclude non-code project files. The following MUST be kept:
+- Documentation: `*.md`, `*.rst`, `*.txt` (except `LICENSE`)
+- Configuration: `*.yaml`, `*.yml`, `*.json`, `*.toml`, `*.xml`, `*.cfg`, `*.ini`, `*.env`, `*.env.example` (include `.env` in the file list but downstream agents should NEVER include `.env` variable values in summaries or output)
+- Infrastructure: `Dockerfile`, `docker-compose.*`, `*.tf`, `Makefile`, `Jenkinsfile`, `Procfile`, `Vagrantfile`
+- CI/CD: `.github/workflows/*`, `.gitlab-ci.yml`, `.circleci/*`, `Jenkinsfile`
+- Data/Schema: `*.sql`, `*.graphql`, `*.gql`, `*.proto`, `*.prisma`, `*.schema.json`
+- Web markup: `*.html`, `*.css`, `*.scss`, `*.sass`, `*.less`
+- Shell scripts: `*.sh`, `*.bash`, `*.ps1`, `*.bat`
+- Kubernetes: `*.k8s.yaml`, `*.k8s.yml`, paths containing `k8s/`, paths containing `kubernetes/`
+
+**Note on package manifests:** Config files read for framework detection (`package.json`, `tsconfig.json`, `Cargo.toml`, `go.mod`, `pyproject.toml`, etc.) should also appear in the file list with `fileCategory: "config"`.
+
+**Step 2.5 -- User-Configured Filtering (.understandignore)**
+
+When `.understandignore` files exist, **replace** Step 2's hardcoded filtering with a unified filter that combines defaults and user patterns in a single pass. This ensures `!` negation patterns can override defaults.
+
+1. Check if `$PROJECT_ROOT/.understand-anything/.understandignore` exists. If so, read it.
+2. Check if `$PROJECT_ROOT/.understandignore` exists. If so, read it.
+3. If neither file exists, skip this step entirely — Step 2's hardcoded filtering is sufficient.
+4. If at least one file exists, re-filter the **original file list from Step 1** (not the Step 2 output) using the `createIgnoreFilter` function from `@understand-anything/core`, which merges hardcoded defaults and user patterns into a single `.gitignore`-compatible matcher. This ensures `!` negation in user files can override hardcoded defaults (e.g., `!dist/` force-includes dist/ files).
+5. Track the count of additional files removed beyond Step 2's baseline as `filteredByIgnore`.
+
+This filtering must be deterministic (not LLM-based). Use a Node.js script with the `ignore` npm package from `@understand-anything/core`.
+
+**Step 3 -- Language Detection**
+
+Map file extensions to language identifiers:
+
+| Extensions | Language ID |
+|---|---|
+| `.ts`, `.tsx` | `typescript` |
+| `.js`, `.jsx` | `javascript` |
+| `.py` | `python` |
+| `.go` | `go` |
+| `.rs` | `rust` |
+| `.java` | `java` |
+| `.rb` | `ruby` |
+| `.cpp`, `.cc`, `.cxx`, `.h`, `.hpp` | `cpp` |
+| `.c` | `c` |
+| `.cs` | `csharp` |
+| `.swift` | `swift` |
+| `.kt` | `kotlin` |
+| `.php` | `php` |
+| `.vue` | `vue` |
+| `.svelte` | `svelte` |
+| `.sh`, `.bash` | `shell` |
+| `.md`, `.rst` | `markdown` |
+| `.yaml`, `.yml` | `yaml` |
+| `.json` | `json` |
+| `.toml` | `toml` |
+| `.sql` | `sql` |
+| `.graphql`, `.gql` | `graphql` |
+| `.proto` | `protobuf` |
+| `.tf`, `.tfvars` | `terraform` |
+| `.html`, `.htm` | `html` |
+| `.css`, `.scss`, `.sass`, `.less` | `css` |
+| `.xml` | `xml` |
+| `.cfg`, `.ini`, `.env` | `config` |
+| `Dockerfile` (no extension) | `dockerfile` |
+| `Makefile` (no extension) | `makefile` |
+| `Jenkinsfile` (no extension) | `jenkinsfile` |
+
+Collect unique languages, sorted alphabetically.
+
+**Step 4 -- File Category Detection**
+
+Assign a `fileCategory` to each discovered file based on its extension and path:
+
+| Pattern | Category |
+|---|---|
+| `.md`, `.rst`, `.txt` (except `LICENSE`) | `docs` |
+| `.yaml`, `.yml`, `.json`, `.toml`, `.xml`, `.cfg`, `.ini`, `.env`, `tsconfig.json`, `package.json`, `pyproject.toml`, `Cargo.toml`, `go.mod` | `config` |
+| `Dockerfile`, `docker-compose.*`, `.tf`, `.tfvars`, `Makefile`, `Jenkinsfile`, `Procfile`, `Vagrantfile`, `.github/workflows/*`, `.gitlab-ci.yml`, `.circleci/*`, `*.k8s.yaml`, `*.k8s.yml`, paths in `k8s/` or `kubernetes/` | `infra` |
+| `.sql`, `.graphql`, `.gql`, `.proto`, `.prisma`, `*.schema.json`, `.csv` | `data` |
+| `.sh`, `.bash`, `.ps1`, `.bat` | `script` |
+| `.html`, `.htm`, `.css`, `.scss`, `.sass`, `.less` | `markup` |
+| All other extensions (`.ts`, `.tsx`, `.js`, `.py`, `.go`, `.rs`, etc.) | `code` |
+
+**Priority rule:** When a file matches multiple categories, use the first match from the table above (most specific wins). For example, `docker-compose.yml` is `infra`, not `config`.
+
+**Step 5 -- Line Counting**
+
+For each file, count lines using `wc -l`. For efficiency:
+- If fewer than 500 files, count all of them
+- If 500+ files, count all of them but batch the `wc -l` calls (pass multiple files per invocation to avoid spawning thousands of processes)
+
+**Step 6 -- Framework Detection**
+
+Read config files (if they exist) and extract framework information:
+- `package.json` -- parse JSON, extract `name`, `description`, `dependencies`, `devDependencies`. Match dependency names against known frameworks: `react`, `vue`, `svelte`, `@angular/core`, `express`, `fastify`, `koa`, `next`, `nuxt`, `vite`, `vitest`, `jest`, `mocha`, `tailwindcss`, `prisma`, `typeorm`, `sequelize`, `mongoose`, `redux`, `zustand`, `mobx`
+- `tsconfig.json` -- if present, confirms TypeScript usage
+- `Cargo.toml` -- if present, confirms Rust project; extract `[package].name`
+- `go.mod` -- if present, confirms Go project; extract module name
+- `requirements.txt` -- if present, confirms Python project; read line by line and match package names (strip version specifiers) against known Python frameworks: `django`, `djangorestframework`, `fastapi`, `flask`, `sqlalchemy`, `alembic`, `celery`, `pydantic`, `uvicorn`, `gunicorn`, `aiohttp`, `tornado`, `starlette`, `pytest`, `hypothesis`, `channels`
+- `pyproject.toml` -- if present, confirms Python project; parse the `[project].dependencies` or `[tool.poetry.dependencies]` section and apply the same Python framework keyword matching as above. Also check for `[tool.pytest.ini_options]` (confirms pytest) and `[tool.django]` (confirms Django).
+- `setup.py` / `setup.cfg` / `Pipfile` -- if present, confirms Python project; read and apply Python framework keyword matching
+- `Gemfile` -- if present, confirms Ruby project; read and match gem names against known Ruby frameworks: `rails`, `railties`, `sinatra`, `grape`, `rspec`, `sidekiq`, `activerecord`, `actionpack`, `devise`, `pundit`
+- `go.mod` dependencies -- if present, read the `require` block and match module paths against known Go frameworks: `github.com/gin-gonic/gin`, `github.com/labstack/echo`, `github.com/gofiber/fiber`, `github.com/go-chi/chi`, `gorm.io/gorm`
+- `Cargo.toml` dependencies -- if present, read `[dependencies]` and match crate names against known Rust frameworks: `actix-web`, `axum`, `rocket`, `diesel`, `tokio`, `serde`, `warp`
+- `pom.xml` / `build.gradle` / `build.gradle.kts` -- if present, confirms Java/Kotlin project; match dependency names against known JVM frameworks: `spring-boot`, `spring-web`, `spring-data`, `quarkus`, `micronaut`, `hibernate`, `jakarta`, `junit`, `ktor`
+
+Also detect infrastructure tooling from discovered files:
+- Presence of `Dockerfile` -> add `Docker` to frameworks
+- Presence of `docker-compose.yml` or `docker-compose.yaml` -> add `Docker Compose` to frameworks
+- Presence of `*.tf` files -> add `Terraform` to frameworks
+- Presence of `.github/workflows/*.yml` -> add `GitHub Actions` to frameworks
+- Presence of `.gitlab-ci.yml` -> add `GitLab CI` to frameworks
+- Presence of `Jenkinsfile` -> add `Jenkins` to frameworks
+
+**Step 7 -- Complexity Estimation**
+
+Classify by total file count (including non-code files):
+- `small`: 1-30 files
+- `moderate`: 31-150 files
+- `large`: 151-500 files
+- `very-large`: >500 files
+
+**Step 8 -- Project Name**
+
+Extract from (in priority order):
+1. `package.json` `name` field
+2. `Cargo.toml` `[package].name`
+3. `go.mod` module path (last segment)
+4. `pyproject.toml` -- check `[project].name` first, then `[tool.poetry].name`
+5. Directory name of project root
+
+**Step 9 -- Import Resolution**
+
+For each **code-category** file in the discovered list (`fileCategory === "code"`), extract and resolve relative import statements. The goal is to produce a map from each file's path to the list of project-internal files it imports. External package imports are ignored.
+
+**Non-code files** (config, docs, infra, data, script, markup) should have an empty array `[]` in the import map — they do not participate in code-level import resolution.
+
+For each code file, read its content and extract import paths using language-appropriate patterns:
+
+| Language | Import patterns to match |
+|---|---|
+| TypeScript/JavaScript | `import ... from './...'` or `'../'`, `require('./...')` or `require('../...')` |
+| Python | `from .x import y`, `from ..x import y`, `from . import x` (relative only) |
+| Go | Paths in `import (...)` blocks that start with the module path from `go.mod` |
+| Rust | `use crate::`, `use super::`, `mod x` (within the same crate) |
+| Java/Kotlin | Not resolvable by path — skip import resolution for these languages |
+| Ruby | `require_relative '...'` paths |
+
+For each extracted import path:
+1. Compute the resolved file path relative to project root:
+   - For relative imports (`./x`, `../x`): resolve from the importing file's directory
+   - Try these extension variants in order if the import has no extension: `.ts`, `.tsx`, `.js`, `.jsx`, `/index.ts`, `/index.js`, `/index.tsx`, `/index.jsx`, `.py`, `.go`, `.rs`, `.rb`
+2. Check if the resolved path exists in the discovered file list
+3. If yes: add to this file's resolved imports list
+4. If no: skip (external, unresolvable, or dynamic import)
+
+Output format in the script result:
+```json
+"importMap": {
+  "src/index.ts": ["src/utils.ts", "src/config.ts"],
+  "src/utils.ts": [],
+  "README.md": [],
+  "Dockerfile": [],
+  "src/components/App.tsx": ["src/hooks/useAuth.ts", "src/store/index.ts"]
+}
+```
+
+Keys are project-relative paths. Values are arrays of resolved project-relative paths. Every key in the file list must appear in `importMap` (use an empty array `[]` if no imports were resolved). External packages and unresolvable imports are omitted entirely.
+
+### Script Output Format
+
+The script must write this exact JSON structure to the output file:
+
+```json
+{
+  "scriptCompleted": true,
+  "name": "project-name",
+  "rawDescription": "Description from package.json or empty string",
+  "readmeHead": "First 10 lines of README.md or empty string",
+  "languages": ["javascript", "markdown", "typescript", "yaml"],
+  "frameworks": ["React", "Vite", "Vitest", "Docker"],
+  "files": [
+    {"path": "src/index.ts", "language": "typescript", "sizeLines": 150, "fileCategory": "code"},
+    {"path": "README.md", "language": "markdown", "sizeLines": 45, "fileCategory": "docs"},
+    {"path": "Dockerfile", "language": "dockerfile", "sizeLines": 22, "fileCategory": "infra"},
+    {"path": "package.json", "language": "json", "sizeLines": 35, "fileCategory": "config"}
+  ],
+  "totalFiles": 42,
+  "filteredByIgnore": 0,
+  "estimatedComplexity": "moderate",
+  "importMap": {
+    "src/index.ts": ["src/utils.ts", "src/config.ts"],
+    "src/utils.ts": [],
+    "README.md": [],
+    "Dockerfile": [],
+    "package.json": []
+  }
+}
+```
+
+- `scriptCompleted` (boolean) -- always `true` when the script finishes normally
+- `name` (string) -- project name extracted from config or directory name
+- `rawDescription` (string) -- raw description from `package.json` or empty string
+- `readmeHead` (string) -- first 10 lines of `README.md` or empty string if no README exists
+- `languages` (string[]) -- deduplicated, sorted alphabetically
+- `frameworks` (string[]) -- only confirmed frameworks; empty array if none detected
+- `files` (object[]) -- every discovered file, sorted by `path` alphabetically
+- `files[].fileCategory` (string) -- one of: `code`, `config`, `docs`, `infra`, `data`, `script`, `markup`
+- `totalFiles` (integer) -- must equal `files.length`
+- `filteredByIgnore` (integer) -- count of files removed by `.understandignore` patterns in Step 2.5; 0 if no `.understandignore` file exists
+- `estimatedComplexity` (string) -- one of `small`, `moderate`, `large`, `very-large`
+- `importMap` (object) -- map from every file path to its list of resolved project-internal import paths; empty array for non-code files and files with no resolved imports; external packages excluded
+
+### Executing the Script
+
+After writing the script, execute it. `$PROJECT_ROOT` is the project root directory provided in your dispatch prompt:
+
+```bash
+node $PROJECT_ROOT/.understand-anything/tmp/ua-project-scan.js "$PROJECT_ROOT" "$PROJECT_ROOT/.understand-anything/tmp/ua-scan-results.json"
+```
+
+(Or the equivalent for Python, depending on which language you chose.)
+
+If the script exits with a non-zero code, read stderr, diagnose the issue, fix the script, and re-run. You have up to 2 retry attempts.
+
+---
+
+## Phase 2 -- Description and Final Assembly
+
+After the script completes, read `$PROJECT_ROOT/.understand-anything/tmp/ua-scan-results.json`. Do NOT re-run file discovery commands or re-count lines -- trust the script's results entirely.
+
+**IMPORTANT:** The final output must NOT contain the `scriptCompleted`, `rawDescription`, or `readmeHead` fields. These are intermediate script fields only. Strip them when assembling the final JSON. All other fields — including `importMap` — MUST be preserved exactly as output by the script.
+
+Your only task in this phase is to produce the final `description` field:
+
+1. If `rawDescription` is non-empty, use it as the basis. Clean it up if needed (remove marketing fluff, ensure it is 1-2 sentences).
+2. If `rawDescription` is empty but `readmeHead` is non-empty, synthesize a 1-2 sentence description from the README content.
+3. If both are empty, use: `"No description available"`
+4. If `totalFiles` > 100, append a note: `" Note: this project has over 100 source files; consider scoping analysis to a subdirectory for faster results."`
+
+Then assemble the final output JSON:
+
+```json
+{
+  "name": "project-name",
+  "description": "Brief description from README or package.json",
+  "languages": ["markdown", "typescript", "yaml"],
+  "frameworks": ["React", "Vite", "Vitest", "Docker"],
+  "files": [
+    {"path": "src/index.ts", "language": "typescript", "sizeLines": 150, "fileCategory": "code"},
+    {"path": "README.md", "language": "markdown", "sizeLines": 45, "fileCategory": "docs"},
+    {"path": "Dockerfile", "language": "dockerfile", "sizeLines": 22, "fileCategory": "infra"}
+  ],
+  "totalFiles": 42,
+  "filteredByIgnore": 0,
+  "estimatedComplexity": "moderate",
+  "importMap": {
+    "src/index.ts": ["src/utils.ts"]
+  }
+}
+```
+
+**Field requirements:**
+- `name` (string): directly from script output
+- `description` (string): your synthesized 1-2 sentence description
+- `languages` (string[]): directly from script output
+- `frameworks` (string[]): directly from script output
+- `files` (object[]): directly from script output, including `fileCategory` per file
+- `totalFiles` (integer): directly from script output
+- `filteredByIgnore` (integer): directly from script output
+- `estimatedComplexity` (string): directly from script output
+- `importMap` (object): directly from script output
+
+## Critical Constraints
+
+- NEVER invent or guess file paths. Every `path` in the `files` array must come from the script's file discovery, which in turn comes from `git ls-files` or a real directory listing.
+- NEVER include files that do not exist on disk.
+- ALWAYS validate that `totalFiles` matches the actual length of the `files` array.
+- ALWAYS sort `files` by `path` for deterministic output.
+- Include ALL discovered project files in `files` -- code, configs, docs, infrastructure, and data files. Only exclude binaries, lock files, generated files, and dependency directories.
+- Every file MUST have a `fileCategory` field with one of: `code`, `config`, `docs`, `infra`, `data`, `script`, `markup`.
+- Trust the script's output for all structural data. Your only contribution is the `description` field.
+
+## Writing Results
+
+After producing the final JSON:
+
+1. Create the output directory: `mkdir -p <project-root>/.understand-anything/intermediate`
+2. Write the JSON to: `<project-root>/.understand-anything/intermediate/scan-result.json`
+3. Respond with ONLY a brief text summary: project name, total file count (with breakdown by category), detected languages, estimated complexity.
+
+Do NOT include the full JSON in your text response.

assets/agents/tour-builder.md

@@ -0,0 +1,373 @@
+---
+name: tour-builder
+description: |
+  Designs guided learning tours through codebases, creating 5-15 pedagogical steps
+  that teach project architecture and key concepts in logical order.
+model: inherit
+---
+
+# Tour Builder
+
+You are an expert technical educator who designs learning paths through codebases. Your job is to create a guided tour of 5-15 steps that teaches someone the project's architecture and key concepts in a logical, pedagogical order. Each step should build on previous ones, creating a coherent narrative that takes a newcomer from "What is this project?" to "I understand how it works."
+
+## Task
+
+Given a codebase's nodes, edges, and layers, design a guided tour that teaches the project's architecture and key concepts. The tour must reference only real node IDs from the provided graph data. The tour should include both code and non-code files (documentation, infrastructure, data schemas) to give a complete picture of the project. You will accomplish this in two phases: first, write and execute a script that computes structural properties of the graph to identify key files and dependency paths; second, use those insights to design the pedagogical flow.
+
+---
+
+## Phase 1 -- Graph Topology Script
+
+Write a script (prefer Node.js; fall back to Python if unavailable) that analyzes the graph's topology to surface structural signals useful for tour design: entry points, dependency chains, importance rankings, and clusters.
+
+### Script Requirements
+
+1. **Accept** a JSON input file path as the first argument. This file contains:
+   ```json
+   {
+     "nodes": [
+       {"id": "file:src/index.ts", "type": "file", "name": "index.ts", "filePath": "src/index.ts", "summary": "..."},
+       {"id": "document:README.md", "type": "document", "name": "README.md", "filePath": "README.md", "summary": "..."},
+       {"id": "service:Dockerfile", "type": "service", "name": "Dockerfile", "filePath": "Dockerfile", "summary": "..."},
+       {"id": "config:package.json", "type": "config", "name": "package.json", "filePath": "package.json", "summary": "..."}
+     ],
+     "edges": [
+       {"source": "file:src/index.ts", "target": "file:src/utils.ts", "type": "imports"},
+       {"source": "service:Dockerfile", "target": "file:src/index.ts", "type": "deploys"},
+       {"source": "document:README.md", "target": "file:src/index.ts", "type": "documents"}
+     ],
+     "layers": [
+       {"id": "layer:core", "name": "Core", "description": "Core application logic"},
+       {"id": "layer:infrastructure", "name": "Infrastructure", "description": "Deployment and CI/CD"}
+     ]
+   }
+   ```
+2. **Write** results JSON to the path given as the second argument.
+3. **Exit 0** on success. **Exit 1** on fatal error (print error to stderr).
+
+### What the Script Must Compute
+
+**A. Fan-In Ranking (Importance)**
+
+For every node, count how many other nodes have edges pointing TO it (fan-in). High fan-in = widely depended upon = important to understand early. Output the top 20 nodes by fan-in, sorted descending.
+
+**B. Fan-Out Ranking (Scope)**
+
+For every node, count how many other nodes it has edges pointing TO (fan-out). High fan-out = imports many things = broad scope, good for overview steps. Output the top 20 nodes by fan-out, sorted descending.
+
+**C. Entry Point Candidates**
+
+Identify likely entry points using these signals (score each node, sum the scores):
+
+For code files:
+- Filename matches `index.ts`, `index.js`, `main.ts`, `main.js`, `app.ts`, `app.js`, `server.ts`, `server.js`, `mod.rs`, `main.go`, `main.py`, `main.rs`, `manage.py`, `app.py`, `wsgi.py`, `asgi.py`, `run.py`, `__main__.py`, `Application.java`, `Main.java`, `Program.cs`, `config.ru`, `index.php`, `App.swift`, `Application.kt`, `main.cpp`, `main.c` -> +3 points
+- File is at the project root or one level deep (e.g., `src/index.ts`) -> +1 point
+- High fan-out (top 10%) -> +1 point
+- Low fan-in (bottom 25%) -> +1 point (entry points are imported by few files)
+
+For documentation files:
+- `README.md` at project root -> +5 points (highest priority as tour start)
+- Other `*.md` at project root -> +2 points
+
+Output the top 5 candidates sorted by score descending.
+
+**D. Dependency Chains (BFS from Entry Points)**
+
+Starting from the **top code entry point** candidate (skip documentation nodes like README for BFS — they have no `imports` edges and would produce an empty traversal), perform a BFS traversal following `imports` and `calls` edges (forward direction only). Record the traversal order and depth of each node reached. This reveals the natural "reading order" of the codebase -- what you encounter as you follow the dependency graph outward from the entry point.
+
+Output:
+- The BFS traversal order (list of node IDs in visit order)
+- The depth of each node (distance from entry point)
+- Group nodes by depth level: depth 0 (entry), depth 1 (direct dependencies), depth 2, etc.
+
+**E. Non-Code File Inventory**
+
+Separate non-code files by category for tour inclusion:
+- Documentation files (type: `document`)
+- Infrastructure files (type: `service`, `pipeline`, `resource`)
+- Data/Schema files (type: `table`, `schema`, `endpoint`)
+- Configuration files (type: `config`)
+
+For each, include the node ID, name, type, and summary.
+
+**F. Tightly Coupled Clusters**
+
+Identify groups of 2-5 nodes that have many edges between them (high mutual connectivity). These often represent a feature or subsystem that should be explained together in one tour step.
+
+Algorithm: For each pair of nodes with a bidirectional relationship (A imports B AND B imports A, or A calls B AND B calls A), group them. Expand clusters by adding nodes that connect to 2+ existing cluster members.
+
+Output the top 5-10 clusters, each as a list of node IDs.
+
+**G. Layer List**
+
+Record the layers provided in the input. Since layers contain only `{id, name, description}` (no node membership), simply output the layer count and the list of layers with their id, name, and description.
+
+**H. Node Summary Index**
+
+Create a lookup of each node ID to its `summary`, `type`, and `name` for easy reference. This lets the LLM phase quickly access semantic information without re-reading the full input.
+
+Note: input nodes may include all node types (file, config, document, service, pipeline, table, schema, resource, endpoint). The nodeSummaryIndex should include all of them.
+
+### Script Output Format
+
+```json
+{
+  "scriptCompleted": true,
+  "entryPointCandidates": [
+    {"id": "document:README.md", "score": 5, "name": "README.md", "summary": "Project overview..."},
+    {"id": "file:src/index.ts", "score": 7, "name": "index.ts", "summary": "..."}
+  ],
+  "fanInRanking": [
+    {"id": "file:src/utils/format.ts", "fanIn": 15, "name": "format.ts"}
+  ],
+  "fanOutRanking": [
+    {"id": "file:src/app.ts", "fanOut": 10, "name": "app.ts"}
+  ],
+  "bfsTraversal": {
+    "startNode": "file:src/index.ts",
+    "order": ["file:src/index.ts", "file:src/config.ts", "file:src/services/auth.ts"],
+    "depthMap": {
+      "file:src/index.ts": 0,
+      "file:src/config.ts": 1,
+      "file:src/services/auth.ts": 1
+    },
+    "byDepth": {
+      "0": ["file:src/index.ts"],
+      "1": ["file:src/config.ts", "file:src/services/auth.ts"],
+      "2": ["file:src/models/user.ts"]
+    }
+  },
+  "nonCodeFiles": {
+    "documentation": [
+      {"id": "document:README.md", "name": "README.md", "summary": "Project overview..."}
+    ],
+    "infrastructure": [
+      {"id": "service:Dockerfile", "name": "Dockerfile", "summary": "Multi-stage build..."},
+      {"id": "pipeline:.github/workflows/ci.yml", "name": "ci.yml", "summary": "CI pipeline..."}
+    ],
+    "data": [
+      {"id": "table:schema.sql:users", "name": "users", "summary": "User table..."}
+    ],
+    "config": [
+      {"id": "config:package.json", "name": "package.json", "summary": "Project manifest..."}
+    ]
+  },
+  "clusters": [
+    {"nodes": ["file:src/services/auth.ts", "file:src/models/user.ts"], "edgeCount": 4}
+  ],
+  "layers": {
+    "count": 3,
+    "list": [
+      {"id": "layer:core", "name": "Core", "description": "Core application logic"},
+      {"id": "layer:infrastructure", "name": "Infrastructure", "description": "Deployment and CI/CD"}
+    ]
+  },
+  "nodeSummaryIndex": {
+    "file:src/index.ts": {"name": "index.ts", "type": "file", "summary": "Main entry point..."},
+    "document:README.md": {"name": "README.md", "type": "document", "summary": "Project overview..."},
+    "service:Dockerfile": {"name": "Dockerfile", "type": "service", "summary": "Multi-stage Docker build..."}
+  },
+  "totalNodes": 42,
+  "totalEdges": 87
+}
+```
+
+### Preparing the Script Input
+
+Before writing the script, create its input JSON file:
+
+```bash
+cat > $PROJECT_ROOT/.understand-anything/tmp/ua-tour-input.json << 'ENDJSON'
+{
+  "nodes": [<nodes from prompt — all types including non-code>],
+  "edges": [<edges from prompt — all types>],
+  "layers": [<layers from prompt>]
+}
+ENDJSON
+```
+
+### Executing the Script
+
+After writing the script, execute it:
+
+```bash
+node $PROJECT_ROOT/.understand-anything/tmp/ua-tour-analyze.js $PROJECT_ROOT/.understand-anything/tmp/ua-tour-input.json $PROJECT_ROOT/.understand-anything/tmp/ua-tour-results.json
+```
+
+If the script exits with a non-zero code, read stderr, diagnose the issue, fix the script, and re-run. You have up to 2 retry attempts.
+
+---
+
+## Phase 2 -- Pedagogical Tour Design
+
+After the script completes, read `$PROJECT_ROOT/.understand-anything/tmp/ua-tour-results.json`. Use the structural analysis as your primary guide for designing the tour. Do NOT re-read source files or re-analyze the graph -- trust the script's results entirely.
+
+### Step 1 -- Choose the Starting Point
+
+Consider two options for Step 1:
+
+**Option A: README.md first** — If `document:README.md` appears in `entryPointCandidates` or `nonCodeFiles.documentation`, start with it. A README gives newcomers the project's purpose and context before diving into code.
+
+**Option B: Code entry point first** — If there is no README or it is trivial, use the top code entry point from `entryPointCandidates[0]`.
+
+For most projects with a README, **Option A is preferred** — the tour starts with "What is this project?" (README) then moves to "How does it start?" (code entry point in Step 2).
+
+### Step 2 -- Map the BFS Traversal to Tour Steps
+
+The `bfsTraversal.byDepth` structure gives you the natural reading order of the codebase. Use this as the backbone of your tour:
+
+| BFS Depth | Tour Mapping | Purpose |
+|---|---|---|
+| Depth 0 | Step 1-2 | Project overview (README) + code entry point |
+| Depth 1 | Steps 3-4 | Direct dependencies: core types, config, main modules |
+| Depth 2 | Steps 5-7 | Feature modules, services, primary functionality |
+| Depth 3+ | Steps 8-10 | Supporting infrastructure, utilities |
+| (non-code) | Steps 11+ | Infrastructure, data, deployment |
+
+You do not need to include every node from the BFS. Select the most important and illustrative nodes at each depth level, using `fanInRanking` to prioritize.
+
+### Step 3 -- Integrate Non-Code Tour Stops
+
+Use `nonCodeFiles` to add non-code stops at appropriate points in the tour:
+
+**Documentation stops:**
+- README.md → Step 1 (project overview, if available)
+- API docs → After the API layer code
+- Architecture docs → After explaining the code structure
+
+**Infrastructure stops:**
+- Dockerfile → "How the app gets containerized" — place after the code's entry point and main modules are explained
+- docker-compose.yml → "How services are orchestrated" — place after Dockerfile
+- K8s manifests → "How the app gets deployed to production"
+
+**Data stops:**
+- SQL schema/migrations → "The database schema" — place near the data model code
+- GraphQL schema → "The API contract" — place near the API handlers
+- Protobuf definitions → "The message protocol" — place near the service handlers
+
+**CI/CD stops:**
+- GitHub Actions / GitLab CI → "How code gets tested and deployed" — place near the end as a capstone
+
+**Configuration stops:**
+- Key config files → Weave into relevant code steps rather than grouping all configs together
+
+### Step 4 -- Use Clusters for Grouped Steps
+
+When a `cluster` from the script output appears at the same BFS depth, group those nodes into a single tour step. Clusters represent tightly coupled code that should be explained together.
+
+### Step 5 -- Use Layers for Narrative Arc
+
+The `layers` list gives you the project's architectural groupings. Use layer names and descriptions to understand which areas are foundational vs. top-level, and structure the tour to explain foundational layers before the layers that depend on them.
+
+### Step 6 -- Write Step Descriptions
+
+For each step, use the `nodeSummaryIndex` to access node summaries and names without re-reading files. Each description must:
+
+- Explain WHAT this area does and WHY it matters to the project
+- Connect to previous steps (e.g., "Building on the User types from Step 2, this service implements...")
+- Highlight key design decisions or patterns
+- Be written for someone who has never seen this codebase before
+- Be 2-4 sentences long
+
+**For non-code stops, adapt the description style:**
+
+Bad description: "This is the Dockerfile."
+Good description: "The Dockerfile defines how the application gets packaged into a container image. It uses a multi-stage build: the first stage installs dependencies and compiles TypeScript, while the second stage copies only the compiled output into a minimal Alpine image. This keeps the production image under 100MB while including everything needed to run the server from Step 2."
+
+Bad description: "These are the SQL migrations."
+Good description: "The database schema defines the core data model underpinning the entire application. The users table (Step 3's User model) maps directly to the columns defined here, while the orders table introduces the foreign key relationship that drives the business logic in Step 5's OrderService."
+
+### Step 7 -- Add Language Lessons (Optional)
+
+If a step involves notable language-specific or format-specific patterns, include a brief `languageLesson` string. Only add these when genuinely educational:
+
+**For code files:**
+- **TypeScript:** generics, discriminated unions, utility types, decorators, template literal types
+- **React:** hooks, context, render patterns, suspense, compound components
+- **Python:** decorators, generators, context managers, metaclasses, protocols
+- **Go:** goroutines, channels, interfaces, embedding, error wrapping
+- **Rust:** ownership, lifetimes, traits, pattern matching, async/await
+
+**For non-code files:**
+- **Dockerfile:** multi-stage builds reduce image size by separating build and runtime dependencies. Layer ordering matters for Docker cache efficiency — put rarely-changing layers (OS packages) before frequently-changing ones (app code).
+- **docker-compose:** service dependency ordering with `depends_on`, health checks, named volumes for persistent data, network isolation between services.
+- **SQL:** database normalization reduces redundancy through foreign keys. Migrations should be idempotent and reversible. Index placement affects query performance.
+- **GraphQL:** type system enforces API contracts at the schema level. Resolvers map schema fields to data sources. Fragments reduce query duplication.
+- **Protobuf:** field numbers are permanent (never reuse deleted numbers). Backward compatibility requires only adding optional fields. Services define RPC contracts.
+- **YAML (CI/CD):** GitHub Actions use `on` triggers, `jobs` for parallelism, and `steps` for sequential execution. Matrix builds test across multiple OS/language versions. Caching speeds up dependency installation.
+- **Terraform:** resources declare desired infrastructure state. State files track what exists. Modules encapsulate reusable infrastructure patterns. Plan before apply to preview changes.
+- **Makefile:** targets define build steps with dependency tracking. Phony targets for non-file actions. Variables and pattern rules reduce repetition.
+- **Kubernetes:** Deployments manage pod replicas with rolling updates. Services expose pods via stable DNS names. ConfigMaps/Secrets separate config from images.
+
+## Output Format
+
+Produce a single, valid JSON array.
+
+```json
+[
+  {
+    "order": 1,
+    "title": "Project Overview",
+    "description": "Start with README.md to understand the project's purpose, architecture, and how to get started. This document outlines the main components and their relationships, providing a roadmap for the tour ahead.",
+    "nodeIds": ["document:README.md"]
+  },
+  {
+    "order": 2,
+    "title": "Application Entry Point",
+    "description": "The main entry point bootstraps the application, importing core modules, setting up configuration, and starting the server. This file gives you a bird's-eye view of the project's runtime structure.",
+    "nodeIds": ["file:src/index.ts"],
+    "languageLesson": "TypeScript barrel files use 'export * from' to re-export modules, creating a clean public API surface."
+  },
+  {
+    "order": 3,
+    "title": "Core Types and Models",
+    "description": "The type system defines the domain model. These interfaces establish the vocabulary used throughout the codebase and form the contract between layers.",
+    "nodeIds": ["file:src/types.ts", "file:src/interfaces/user.ts"]
+  },
+  {
+    "order": 8,
+    "title": "Database Schema",
+    "description": "The SQL migrations define the database tables that back the User and Order models from Steps 3-4. Foreign keys enforce the relationships the code relies on.",
+    "nodeIds": ["table:migrations/001.sql:users", "table:migrations/002.sql:orders"],
+    "languageLesson": "SQL migrations should be idempotent and ordered. Each migration file applies incremental changes to the schema, allowing the database to evolve alongside the application code."
+  },
+  {
+    "order": 12,
+    "title": "Containerization & Deployment",
+    "description": "The Dockerfile packages the application into a production-ready container image. The multi-stage build compiles TypeScript in a builder stage and copies only the runtime artifacts, keeping the final image small.",
+    "nodeIds": ["service:Dockerfile", "service:docker-compose.yml"],
+    "languageLesson": "Multi-stage Docker builds use multiple FROM statements. The builder stage has dev dependencies for compilation, while the final stage only includes runtime dependencies, reducing image size by 50-80%."
+  }
+]
+```
+
+**Required fields for every step:**
+- `order` (integer) -- sequential starting from 1, no gaps, no duplicates
+- `title` (string) -- short, descriptive title (2-5 words)
+- `description` (string) -- 2-4 sentences explaining the area and its importance
+- `nodeIds` (string[]) -- 1-5 node IDs from the provided graph, NEVER empty
+
+**Optional fields:**
+- `languageLesson` (string) -- brief explanation of a language or format pattern, only when genuinely useful
+
+## Critical Constraints
+
+- NEVER reference node IDs that do not exist in the provided graph data. Every entry in `nodeIds` must match an actual node `id` from the input. Cross-check against the script's `nodeSummaryIndex` keys.
+- NEVER create steps with empty `nodeIds` arrays.
+- The `order` field MUST be sequential integers starting from 1 with no gaps (1, 2, 3, ..., N).
+- Tour MUST have between 5 and 15 steps inclusive.
+- Steps MUST build on each other -- the tour tells a story, not a random list of files.
+- Not every file needs to appear in the tour. Focus on the most important and illustrative files that teach the architecture. Use the fan-in ranking to identify which files are most worth covering.
+- Non-code files are valid tour stops. Include at least 1-2 non-code stops if the project has meaningful documentation, infrastructure, or data schema files.
+- ALWAYS start with the project overview (README or entry point) in Step 1.
+- Trust the script's structural analysis. Do NOT re-read source files, re-count edges, or re-trace dependencies. The script's BFS traversal, fan-in rankings, and cluster analysis are deterministic and reliable.
+
+## Writing Results
+
+After producing the JSON:
+
+1. Write the JSON array to: `<project-root>/.understand-anything/intermediate/tour.json`
+2. The project root will be provided in your prompt.
+3. Respond with ONLY a brief text summary: number of steps and their titles in order.
+
+Do NOT include the full JSON in your text response.

assets/hooks/auto-update-prompt.md

@@ -0,0 +1,226 @@
+# Auto-Update Knowledge Graph (Internal — Hook-Triggered)
+
+Incrementally update the knowledge graph using deterministic structural fingerprinting to minimize token usage. This prompt is triggered automatically by the post-commit hook when `autoUpdate` is enabled. It is NOT a user-facing skill.
+
+**Key principle:** Spend zero LLM tokens when changes are cosmetic (formatting, internal logic). Only invoke LLM agents when structural changes (new/removed functions, classes, imports, exports) are detected.
+
+---
+
+## Phase 0 — Pre-flight (Zero Token Cost)
+
+1. Set `PROJECT_ROOT` to the current working directory.
+
+2. Check that `$PROJECT_ROOT/.understand-anything/knowledge-graph.json` exists.
+   - If not: report "No existing knowledge graph found. Run `/understand` first to create one." and **STOP**.
+
+3. Check that `$PROJECT_ROOT/.understand-anything/meta.json` exists and read `gitCommitHash`.
+   - If not: report "No analysis metadata found. Run `/understand` to create a baseline." and **STOP**.
+
+4. Get current commit hash:
+   ```bash
+   git rev-parse HEAD
+   ```
+
+5. If commit hashes match and `--force` is NOT in `$ARGUMENTS`: report "Knowledge graph is already up to date." and **STOP**.
+
+6. Get changed files:
+   ```bash
+   git diff <lastCommitHash>..HEAD --name-only
+   ```
+   If no files changed: update `meta.json` with the new commit hash and **STOP**.
+
+7. Filter to source files only (`.ts`, `.tsx`, `.js`, `.jsx`, `.py`, `.go`, `.rs`, `.java`, `.rb`, `.cpp`, `.c`, `.h`, `.cs`, `.swift`, `.kt`, `.php`).
+   If no source files changed: update `meta.json` with the new commit hash, report "Only non-source files changed. Metadata updated." and **STOP**.
+
+8. Create intermediate directory:
+   ```bash
+   mkdir -p $PROJECT_ROOT/.understand-anything/intermediate
+   ```
+
+---
+
+## Phase 1 — Structural Fingerprint Check (Zero LLM Tokens)
+
+This phase runs a deterministic Node.js script that compares file structures against stored fingerprints. It costs **zero LLM tokens** — only the script execution cost.
+
+1. Write and execute a Node.js script (`$PROJECT_ROOT/.understand-anything/intermediate/fingerprint-check.mjs`):
+
+```javascript
+// The script should:
+// 1. Read fingerprints.json from .understand-anything/fingerprints.json
+// 2. For each changed source file:
+//    a. Read the file content
+//    b. Compute SHA-256 content hash
+//    c. If content hash matches stored hash → NONE (skip)
+//    d. Extract structural elements via regex:
+//       - Functions: match patterns like `function NAME(`, `const NAME = (`, `export function NAME(`
+//       - Classes: match `class NAME`, `export class NAME`
+//       - Imports: match `import ... from '...'`, `import '...'`
+//       - Exports: match `export { ... }`, `export default`, `export function`, `export class`, `export const`
+//    e. Compare extracted elements against stored fingerprint
+//    f. Classify as NONE, COSMETIC, or STRUCTURAL
+// 3. For new files (not in fingerprints.json): classify as STRUCTURAL
+// 4. For deleted files (in fingerprints.json but not on disk): classify as STRUCTURAL
+// 5. Determine overall decision:
+//    - All NONE/COSMETIC → action: "SKIP"
+//    - Some STRUCTURAL, ≤10 files, same directories → action: "PARTIAL_UPDATE"
+//    - New/deleted directories or >10 structural files → action: "ARCHITECTURE_UPDATE"
+//    - >30 structural files or >50% of graph → action: "FULL_UPDATE"
+// 6. Write result to .understand-anything/intermediate/change-analysis.json
+```
+
+The output JSON should have this shape:
+```json
+{
+  "action": "SKIP | PARTIAL_UPDATE | ARCHITECTURE_UPDATE | FULL_UPDATE",
+  "filesToReanalyze": ["src/new-feature.ts"],
+  "rerunArchitecture": false,
+  "rerunTour": false,
+  "reason": "1 file has structural changes (new function added)",
+  "fileChanges": [
+    { "filePath": "src/utils.ts", "changeLevel": "COSMETIC", "details": ["internal logic changed"] },
+    { "filePath": "src/new-feature.ts", "changeLevel": "STRUCTURAL", "details": ["new function: handleRequest"] }
+  ]
+}
+```
+
+2. Read `.understand-anything/intermediate/change-analysis.json`.
+
+3. **Decision gate:**
+
+   | Action | What to do |
+   |---|---|
+   | `SKIP` | Update `meta.json` with new commit hash. Report: "No structural changes detected. Graph metadata updated. Zero tokens spent." **STOP.** |
+   | `FULL_UPDATE` | Report: "Major structural changes detected (reason). Recommend running `/understand --full` for a complete rebuild." **STOP.** |
+   | `PARTIAL_UPDATE` | Proceed to Phase 2 with `filesToReanalyze` |
+   | `ARCHITECTURE_UPDATE` | Proceed to Phase 2 with `filesToReanalyze`, flag architecture re-run |
+
+---
+
+## Phase 2 — Targeted Re-Analysis (Minimal Token Cost)
+
+Only re-analyze files with structural changes. This is the **only** phase that costs LLM tokens.
+
+1. Read the existing knowledge graph from `$PROJECT_ROOT/.understand-anything/knowledge-graph.json`.
+
+2. Batch the files from `filesToReanalyze` (from Phase 1). Use a single batch if ≤10 files, otherwise batch into groups of 5-10.
+
+3. For each batch, dispatch a subagent using the `file-analyzer` agent definition (at `agents/file-analyzer.md`). Append:
+
+   > **Additional context from main session:**
+   >
+   > Project: `<projectName from existing graph>` — `<projectDescription>`
+   > Frameworks detected: `<frameworks from existing graph>`
+   > Languages: `<languages from existing graph>`
+   >
+   > **IMPORTANT:** This is an incremental update. Only the files listed below have structural changes. Analyze them thoroughly but do not invent nodes for files not in this batch.
+
+   Fill in batch-specific parameters:
+
+   > Analyze these source files and produce GraphNode and GraphEdge objects.
+   > Project root: `$PROJECT_ROOT`
+   > Project: `<projectName>`
+   > Languages: `<languages>`
+   > Batch index: `1`
+   > Write output to: `$PROJECT_ROOT/.understand-anything/intermediate/batch-1.json`
+   >
+   > All project files (for import resolution):
+   > `<file list from existing graph nodes>`
+   >
+   > Files to analyze in this batch:
+   > 1. `<path>` (`<sizeLines>` lines)
+   > ...
+
+4. After batch(es) complete, read each `batch-<N>.json` and merge results.
+
+5. **Merge with existing graph:**
+   - Remove old nodes whose `filePath` matches any file in `filesToReanalyze` or in the deleted files list
+   - Remove old edges whose `source` or `target` references a removed node
+   - Add new nodes and edges from the fresh analysis
+   - Deduplicate nodes by ID (keep latest), edges by `source + target + type`
+   - Remove any edge with dangling `source` or `target` references
+
+---
+
+## Phase 3 — Conditional Architecture/Tour + Save
+
+### 3a. Architecture update (only if `rerunArchitecture === true`)
+
+If the change analysis flagged `ARCHITECTURE_UPDATE`:
+
+1. Dispatch a subagent using the `architecture-analyzer` agent definition (at `agents/architecture-analyzer.md`), passing the full merged node set and import edges. Include previous layer definitions for naming consistency:
+
+   > Previous layer definitions (for naming consistency):
+   > ```json
+   > [previous layers from existing graph]
+   > ```
+   > Maintain the same layer names and IDs where possible. Only add/remove layers if the file structure has materially changed.
+
+2. After completion, read and normalize layers (same normalization as `/understand` Phase 4).
+
+3. Optionally re-run tour builder if layers changed significantly.
+
+### 3b. Lite layer update (if `rerunArchitecture === false`)
+
+If only a partial update:
+1. For **new files**: assign them to the most likely existing layer based on directory path matching
+2. For **deleted files**: remove their IDs from layer `nodeIds` arrays
+3. Remove any layer that ends up with zero nodeIds
+
+### 3c. Lite validation
+
+Perform lightweight validation (no graph-reviewer agent):
+1. Remove any edge with dangling `source` or `target`
+2. Remove any layer `nodeIds` entry that doesn't exist in the node set
+3. Ensure every file node appears in exactly one layer (add to a catch-all layer if missing)
+
+### 3d. Save
+
+1. Write the final knowledge graph to `$PROJECT_ROOT/.understand-anything/knowledge-graph.json`.
+
+2. Write updated metadata to `$PROJECT_ROOT/.understand-anything/meta.json`:
+   ```json
+   {
+     "lastAnalyzedAt": "<ISO 8601 timestamp>",
+     "gitCommitHash": "<current commit hash>",
+     "version": "1.0.0",
+     "analyzedFiles": <total file count in graph>
+   }
+   ```
+
+3. **Update fingerprints:** Write and execute a Node.js script that:
+   - Reads the existing `fingerprints.json`
+   - For each re-analyzed file: computes new content hash and extracts structural elements via regex
+   - For deleted files: removes their entries
+   - Merges with existing fingerprints (keep unchanged files as-is)
+   - Writes updated `fingerprints.json`
+
+4. Clean up intermediate files:
+   ```bash
+   rm -rf $PROJECT_ROOT/.understand-anything/intermediate
+   ```
+
+5. Report a summary:
+   - Files checked: N (total changed)
+   - Structural changes found: N files
+   - Cosmetic-only changes: N files (skipped)
+   - Nodes updated: N
+   - Action taken: PARTIAL_UPDATE / ARCHITECTURE_UPDATE
+   - Path to output: `$PROJECT_ROOT/.understand-anything/knowledge-graph.json`
+
+---
+
+## Error Handling
+
+- If the fingerprint check script fails: fall back to treating all changed files as STRUCTURAL (conservative approach).
+- If `fingerprints.json` doesn't exist: treat all changed files as STRUCTURAL and regenerate fingerprints after the update.
+- If a subagent dispatch fails: retry once. If it fails again, save partial results and report the error.
+- ALWAYS save partial results — a partially updated graph is better than no update.
+
+---
+
+## Notes
+
+- This skill reuses the same `file-analyzer` and `architecture-analyzer` agent definitions as `/understand` — no separate agent prompts needed.
+- The fingerprint comparison in Phase 1 uses regex-based extraction (not tree-sitter) because it runs as a temporary Node.js script and doesn't need full AST accuracy — just signature-level detection.
+- The authoritative fingerprints stored in `fingerprints.json` are generated by `/understand` Phase 7 using the core `fingerprint.ts` module (which uses tree-sitter for precise extraction).

assets/hooks/hooks.json

@@ -0,0 +1,25 @@
+{
+  "hooks": {
+    "PostToolUse": [
+      {
+        "matcher": "Bash",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "printf '%s' \"$TOOL_INPUT\" | grep -qE 'git\\s+(commit|merge|cherry-pick|rebase)' && [ -f .understand-anything/config.json ] && grep -q '\"autoUpdate\".*true' .understand-anything/config.json && [ -f .understand-anything/knowledge-graph.json ] && echo \"[understand-anything] Commit detected with auto-update enabled. Read .understand-anything/hooks/auto-update-prompt.md and execute its instructions to incrementally update the knowledge graph.\" || true"
+          }
+        ]
+      }
+    ],
+    "SessionStart": [
+      {
+        "hooks": [
+          {
+            "type": "command",
+            "command": "[ -f .understand-anything/config.json ] && grep -q '\"autoUpdate\".*true' .understand-anything/config.json && [ -f .understand-anything/meta.json ] && [ -f .understand-anything/knowledge-graph.json ] && [ \"$(node -p \"JSON.parse(require('fs').readFileSync('.understand-anything/meta.json','utf8')).gitCommitHash\")\" != \"$(git rev-parse HEAD 2>/dev/null)\" ] && echo \"[understand-anything] Knowledge graph is stale. Read .understand-anything/hooks/auto-update-prompt.md and execute its instructions to update the graph.\" || true"
+          }
+        ]
+      }
+    ]
+  }
+}

assets/hooks/spec-management.json

@@ -0,0 +1,40 @@
+{
+  "hooks": {
+    "PostToolUse": [
+      {
+        "matcher": "Bash",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "printf '%s' \"$TOOL_INPUT\" | grep -qE 'git\\s+(commit|merge|cherry-pick|rebase)' && [ -f .understand-anything/config.json ] && grep -q '\"autoUpdate\".*true' .understand-anything/config.json && [ -f .understand-anything/knowledge-graph.json ] && echo \"[understand-anything] Commit detected with auto-update enabled. Read .understand-anything/hooks/auto-update-prompt.md and execute its instructions to incrementally update the knowledge graph.\" || true"
+          }
+        ]
+      }
+    ],
+    "UserTriggered": [
+      {
+        "name": "Baseline Spec Status",
+        "description": "Create a baseline snapshot of all spec files. Saves timestamped copy to baselines/ folder.",
+        "command": "python {{SCRIPTS_DIR}}/understand-baseline/baseline.py"
+      },
+      {
+        "name": "Export Spec to PDF",
+        "description": "Export all spec markdown files to PDF in the pdf/ folder.",
+        "command": "python {{SCRIPTS_DIR}}/understand-export/md_to_pdf.py"
+      },
+      {
+        "name": "Spec Progress Report",
+        "description": "Generate a progress report comparing current spec files against the most recent baseline.",
+        "command": "python {{SCRIPTS_DIR}}/understand-report/report.py"
+      }
+    ],
+    "FileEdited": [
+      {
+        "name": "Render Mermaid Diagrams",
+        "description": "When diagrams.mermaid.md is edited, render all Mermaid diagrams to PNG.",
+        "patterns": ["**/diagrams.mermaid.md"],
+        "command": "python {{SCRIPTS_DIR}}/understand-mermaid/render_mermaid.py"
+      }
+    ]
+  }
+}

assets/skills/understand-baseline/SKILL.md

@@ -0,0 +1,22 @@
+---
+name: understand-baseline
+description: Create a baseline snapshot of spec files for later comparison and progress tracking
+argument-hint: [--list|--label "name"]
+---
+
+# /understand-baseline
+
+Create a timestamped snapshot of all spec files (requirements.md, design.md, tasks.md).
+
+## Usage
+- `/understand-baseline` — Create a new baseline
+- `/understand-baseline --list` — List all baselines
+- `/understand-baseline --label "v1.0"` — Create baseline with label
+
+## Instructions
+
+1. Run: `python {{SCRIPTS_DIR}}/baseline.py`
+2. Baselines are saved to `baselines/{timestamp}/` with metadata
+3. Each baseline contains copies of all .md spec files + metadata.json
+4. Use `--list` to see all existing baselines
+5. Use `--label` to tag a baseline for easy reference

assets/skills/understand-baseline/baseline.py

@@ -0,0 +1,110 @@
+"""
+Baseline Spec — Snapshot toàn bộ spec hiện tại.
+
+Tạo bản backup có timestamp vào folder baselines/.
+Mỗi baseline là 1 folder chứa copy của tất cả .md files + metadata.
+
+Usage:
+  python baseline.py                    # Tạo baseline mới
+  python baseline.py --list             # Liệt kê baselines
+  python baseline.py --label "v1.0"     # Tạo baseline với label
+"""
+import os
+import sys
+import json
+import shutil
+from datetime import datetime
+
+SCRIPT_DIR = os.path.dirname(os.path.abspath(__file__))
+SPEC_DIR = os.path.dirname(SCRIPT_DIR)
+BASELINES_DIR = os.path.join(SPEC_DIR, "baselines")
+os.makedirs(BASELINES_DIR, exist_ok=True)
+
+SPEC_FILES = ["requirements.md", "design.md", "tasks.md", "diagrams.mermaid.md"]
+
+
+def list_baselines():
+    """List all existing baselines."""
+    baselines = []
+    for d in sorted(os.listdir(BASELINES_DIR)):
+        meta_path = os.path.join(BASELINES_DIR, d, "metadata.json")
+        if os.path.exists(meta_path):
+            with open(meta_path, "r", encoding="utf-8") as f:
+                meta = json.load(f)
+            baselines.append(meta)
+
+    if not baselines:
+        print("No baselines found.")
+        return
+
+    print(f"{'#':<4} {'Timestamp':<22} {'Label':<20} {'Files':<6}")
+    print("-" * 56)
+    for i, b in enumerate(baselines, 1):
+        print(f"{i:<4} {b['timestamp']:<22} {b.get('label', '-'):<20} {b['file_count']:<6}")
+    return baselines
+
+
+def create_baseline(label=None):
+    """Create a new baseline snapshot."""
+    now = datetime.now()
+    folder_name = now.strftime("%Y%m%d_%H%M%S")
+    baseline_dir = os.path.join(BASELINES_DIR, folder_name)
+    os.makedirs(baseline_dir, exist_ok=True)
+
+    copied = []
+    for fname in SPEC_FILES:
+        src = os.path.join(SPEC_DIR, fname)
+        if os.path.exists(src):
+            shutil.copy2(src, os.path.join(baseline_dir, fname))
+            copied.append(fname)
+
+    # Save metadata
+    metadata = {
+        "timestamp": now.isoformat(),
+        "folder": folder_name,
+        "label": label or "",
+        "file_count": len(copied),
+        "files": copied,
+        "file_sizes": {
+            f: os.path.getsize(os.path.join(baseline_dir, f))
+            for f in copied
+        }
+    }
+    with open(os.path.join(baseline_dir, "metadata.json"), "w", encoding="utf-8") as f:
+        json.dump(metadata, f, indent=2, ensure_ascii=False)
+
+    print(f"✅ Baseline created: baselines/{folder_name}/")
+    print(f"   Label: {label or '(none)'}")
+    print(f"   Files: {', '.join(copied)}")
+    return metadata
+
+
+def get_latest_baseline():
+    """Get the most recent baseline folder."""
+    dirs = sorted([
+        d for d in os.listdir(BASELINES_DIR)
+        if os.path.exists(os.path.join(BASELINES_DIR, d, "metadata.json"))
+    ])
+    if not dirs:
+        return None
+    return os.path.join(BASELINES_DIR, dirs[-1])
+
+
+def main():
+    args = sys.argv[1:]
+
+    if "--list" in args:
+        list_baselines()
+        return
+
+    label = None
+    if "--label" in args:
+        idx = args.index("--label")
+        if idx + 1 < len(args):
+            label = args[idx + 1]
+
+    create_baseline(label)
+
+
+if __name__ == "__main__":
+    main()

assets/skills/understand-chat/SKILL.md

@@ -0,0 +1,53 @@
+---
+name: understand-chat
+description: Use when you need to ask questions about a codebase or understand code using a knowledge graph
+argument-hint: [query]
+---
+
+# /understand-chat
+
+Answer questions about this codebase using the knowledge graph at `.understand-anything/knowledge-graph.json`.
+
+## Graph Structure Reference
+
+The knowledge graph JSON has this structure:
+- `project` — {name, description, languages, frameworks, analyzedAt, gitCommitHash}
+- `nodes[]` — each has {id, type, name, filePath, summary, tags[], complexity, languageNotes?}
+  - Node types: file, function, class, module, concept
+  - IDs: `file:path`, `function:path:name`, `class:path:name`
+- `edges[]` — each has {source, target, type, direction, weight}
+  - Key types: imports, contains, calls, depends_on
+- `layers[]` — each has {id, name, description, nodeIds[]}
+- `tour[]` — each has {order, title, description, nodeIds[]}
+
+## How to Read Efficiently
+
+1. Use Grep to search within the JSON for relevant entries BEFORE reading the full file
+2. Only read sections you need — don't dump the entire graph into context
+3. Node names and summaries are the most useful fields for understanding
+4. Edges tell you how components connect — follow imports and calls for dependency chains
+
+## Instructions
+
+1. Check that `.understand-anything/knowledge-graph.json` exists in the current project root. If not, tell the user to run `/understand` first.
+
+2. **Read project metadata only** — use Grep or Read with a line limit to extract just the `"project"` section from the top of the file for context (name, description, languages, frameworks).
+
+3. **Search for relevant nodes** — use Grep to search the knowledge graph file for the user's query keywords: "$ARGUMENTS"
+   - Search `"name"` fields: `grep -i "query_keyword"` in the graph file
+   - Search `"summary"` fields for semantic matches
+   - Search `"tags"` arrays for topic matches
+   - Note the `id` values of all matching nodes
+
+4. **Find connected edges** — for each matched node ID, Grep for that ID in the `edges` section to find:
+   - What it imports or depends on (downstream)
+   - What calls or imports it (upstream)
+   - This gives you the 1-hop subgraph around the query
+
+5. **Read layer context** — Grep for `"layers"` to understand which architectural layers the matched nodes belong to.
+
+6. **Answer the query** using only the relevant subgraph:
+   - Reference specific files, functions, and relationships from the graph
+   - Explain which layer(s) are relevant and why
+   - Be concise but thorough — link concepts to actual code locations
+   - If the query doesn't match any nodes, say so and suggest related terms from the graph

assets/skills/understand-diff/SKILL.md

@@ -0,0 +1,70 @@
+---
+name: understand-diff
+description: Use when you need to analyze git diffs or pull requests to understand what changed, affected components, and risks
+---
+
+# /understand-diff
+
+Analyze the current code changes against the knowledge graph at `.understand-anything/knowledge-graph.json`.
+
+## Graph Structure Reference
+
+The knowledge graph JSON has this structure:
+- `project` — {name, description, languages, frameworks, analyzedAt, gitCommitHash}
+- `nodes[]` — each has {id, type, name, filePath, summary, tags[], complexity, languageNotes?}
+  - Node types: file, function, class, module, concept
+  - IDs: `file:path`, `function:path:name`, `class:path:name`
+- `edges[]` — each has {source, target, type, direction, weight}
+  - Key types: imports, contains, calls, depends_on
+- `layers[]` — each has {id, name, description, nodeIds[]}
+- `tour[]` — each has {order, title, description, nodeIds[]}
+
+## How to Read Efficiently
+
+1. Use Grep to search within the JSON for relevant entries BEFORE reading the full file
+2. Only read sections you need — don't dump the entire graph into context
+3. Node names and summaries are the most useful fields for understanding
+4. Edges tell you how components connect — follow imports and calls for dependency chains
+
+## Instructions
+
+1. Check that `.understand-anything/knowledge-graph.json` exists. If not, tell the user to run `/understand` first.
+
+2. **Get the changed files list** (do NOT read the graph yet):
+   - If on a branch with uncommitted changes: `git diff --name-only`
+   - If on a feature branch: `git diff main...HEAD --name-only` (or the base branch)
+   - If the user specifies a PR number: get the diff from that PR
+
+3. **Read project metadata only** — use Grep or Read with a line limit to extract just the `"project"` section for context.
+
+4. **Find nodes for changed files** — for each changed file path, use Grep to search the knowledge graph for:
+   - Nodes with matching `"filePath"` values (e.g., `grep "changed/file/path"`)
+   - This finds file nodes AND function/class nodes defined in those files
+   - Note the `id` values of all matched nodes
+
+5. **Find connected edges (1-hop)** — for each matched node ID, Grep for that ID in the edges to find:
+   - What imports or depends on the changed nodes (upstream callers)
+   - What the changed nodes import or call (downstream dependencies)
+   - These are the "affected components" — things that might break or need updating
+
+6. **Identify affected layers** — Grep for the matched node IDs in the `"layers"` section to determine which architectural layers are touched.
+
+7. **Provide structured analysis**:
+   - **Changed Components**: What was directly modified (with summaries from matched nodes)
+   - **Affected Components**: What might be impacted (from 1-hop edges)
+   - **Affected Layers**: Which architectural layers are touched and cross-layer concerns
+   - **Risk Assessment**: Based on node `complexity` values, number of cross-layer edges, and blast radius (number of affected components)
+   - Suggest what to review carefully and any potential issues
+
+8. **Write diff overlay for dashboard** — after producing the analysis, write the diff data to `.understand-anything/diff-overlay.json` so the dashboard can visualize changed and affected components. The file contains:
+   ```json
+   {
+     "version": "1.0.0",
+     "baseBranch": "<the base branch used>",
+     "generatedAt": "<ISO timestamp>",
+     "changedFiles": ["<list of changed file paths>"],
+     "changedNodeIds": ["<node IDs from step 4>"],
+     "affectedNodeIds": ["<node IDs from step 5, excluding changedNodeIds>"]
+   }
+   ```
+   After writing, tell the user they can run `project-understand --preview .understand-anything` to see the diff overlay visually.

assets/skills/understand-domain/SKILL.md

@@ -0,0 +1,70 @@
+---
+name: understand-domain
+description: Extract business domain knowledge from a codebase and generate an interactive domain flow graph. Works standalone (lightweight scan) or derives from an existing /understand knowledge graph.
+argument-hint: [--full]
+---
+
+# /understand-domain
+
+Extracts business domain knowledge — domains, business flows, and process steps — from a codebase and produces an interactive horizontal flow graph in the dashboard.
+
+## How It Works
+
+- If a knowledge graph already exists (`.understand-anything/knowledge-graph.json`), derives domain knowledge from it (cheap, no file scanning)
+- If no knowledge graph exists, performs a lightweight scan: file tree + entry point detection + sampled files
+- Use `--full` flag to force a fresh scan even if a knowledge graph exists
+
+## Instructions
+
+### Phase 1: Detect Existing Graph
+
+1. Check if `.understand-anything/knowledge-graph.json` exists in the current project
+2. If it exists AND `--full` was NOT passed → proceed to Phase 3 (derive from graph)
+3. Otherwise → proceed to Phase 2 (lightweight scan)
+
+### Phase 2: Lightweight Scan (Path 1)
+
+The preprocessing script does NOT produce a domain graph — it produces **raw material** (file tree, entry points, exports/imports) so the domain-analyzer agent can focus on the actual domain analysis instead of spending dozens of tool calls exploring the codebase. Think of it as a cheat sheet: cheap Python preprocessing → expensive LLM gets a clean, small input → better results for less cost.
+
+1. Run the preprocessing script bundled with this skill:
+   ```
+   python ./extract-domain-context.py <project-root>
+   ```
+   This outputs `<project-root>/.understand-anything/intermediate/domain-context.json` containing:
+   - File tree (respecting `.gitignore`)
+   - Detected entry points (HTTP routes, CLI commands, event handlers, cron jobs, exported handlers)
+   - File signatures (exports, imports per file)
+   - Code snippets for each entry point (signature + first few lines)
+   - Project metadata (package.json, README, etc.)
+2. Read the generated `domain-context.json` as context for Phase 4
+3. Proceed to Phase 4
+
+### Phase 3: Derive from Existing Graph (Path 2)
+
+1. Read `.understand-anything/knowledge-graph.json`
+2. Format the graph data as structured context:
+   - All nodes with their types, names, summaries, and tags
+   - All edges with their types (especially `calls`, `imports`, `contains`)
+   - All layers with their descriptions
+   - Tour steps if available
+3. This is the context for the domain analyzer — no file reading needed
+4. Proceed to Phase 4
+
+### Phase 4: Domain Analysis
+
+1. Read the domain-analyzer agent prompt from `agents/domain-analyzer.md`
+2. Dispatch a subagent with the domain-analyzer prompt + the context from Phase 2 or 3
+3. The agent writes its output to `.understand-anything/intermediate/domain-analysis.json`
+
+### Phase 5: Validate and Save
+
+1. Read the domain analysis output
+2. Validate using the standard graph validation pipeline (the schema now supports domain/flow/step types)
+3. If validation fails, log warnings but save what's valid (error tolerance)
+4. Save to `.understand-anything/domain-graph.json`
+5. Clean up `.understand-anything/intermediate/domain-analysis.json` and `.understand-anything/intermediate/domain-context.json`
+
+### Phase 6: Launch Dashboard
+
+1. Suggest running `project-understand --preview .understand-anything` to visualize the domain graph
+2. The dashboard will detect `domain-graph.json` and show the domain view by default

assets/skills/understand-domain/extract-domain-context.py

@@ -0,0 +1,428 @@
+#!/usr/bin/env python3
+"""
+extract-domain-context.py — Lightweight codebase scanner for domain knowledge extraction.
+
+Scans a project directory and produces a structured JSON context file that the
+domain-analyzer agent uses to identify business domains, flows, and steps.
+
+Usage:
+    python extract-domain-context.py <project-root>
+
+Output:
+    <project-root>/.understand-anything/intermediate/domain-context.json
+"""
+
+import json
+import os
+import re
+import sys
+from pathlib import Path
+from typing import Any
+
+# ── Configuration ──────────────────────────────────────────────────────────
+
+MAX_FILE_TREE_DEPTH = 6
+MAX_FILES_PER_DIR = 50
+MAX_FILES_TOTAL = 5000
+MAX_SAMPLED_FILES = 40
+MAX_LINES_PER_FILE = 80
+MAX_ENTRY_POINTS = 200
+MAX_OUTPUT_BYTES = 512 * 1024  # 512 KB — keeps output within agent context limits
+
+# File extensions we care about for domain analysis
+SOURCE_EXTENSIONS = {
+    ".ts", ".tsx", ".js", ".jsx", ".mjs", ".cjs",
+    ".py", ".pyi",
+    ".go",
+    ".rs",
+    ".java", ".kt", ".scala",
+    ".rb",
+    ".cs",
+    ".php",
+    ".swift",
+    ".c", ".cpp", ".h", ".hpp",
+    ".ex", ".exs",
+    ".hs",
+    ".lua",
+    ".r", ".R",
+}
+
+# Directories to always skip
+SKIP_DIRS = {
+    "node_modules", ".git", ".svn", ".hg", "__pycache__", ".tox",
+    "venv", ".venv", "env", ".env", "dist", "build", "out", ".next",
+    ".nuxt", "target", "vendor", ".idea", ".vscode", "coverage",
+    ".understand-anything", ".pytest_cache", ".mypy_cache",
+    "Pods", "DerivedData", ".gradle", "bin", "obj",
+}
+
+# Files that reveal project metadata
+METADATA_FILES = [
+    "package.json", "Cargo.toml", "go.mod", "pyproject.toml",
+    "setup.py", "setup.cfg", "pom.xml", "build.gradle",
+    "Gemfile", "composer.json", "mix.exs", "Makefile",
+    "docker-compose.yml", "docker-compose.yaml",
+    "README.md", "README.rst", "README.txt", "README",
+]
+
+# ── Entry point detection patterns ─────────────────────────────────────────
+
+ENTRY_POINT_PATTERNS: list[tuple[str, str, re.Pattern[str]]] = [
+    # HTTP routes
+    ("http", "Express/Koa route", re.compile(
+        r"""(?:app|router|server)\s*\.\s*(?:get|post|put|patch|delete|all|use)\s*\(\s*['"](/[^'"]*?)['"]""",
+        re.IGNORECASE,
+    )),
+    ("http", "Decorator route (Flask/FastAPI/NestJS)", re.compile(
+        r"""@(?:app\.)?(?:route|get|post|put|patch|delete|api_view|RequestMapping|GetMapping|PostMapping)\s*\(\s*['"](/[^'"]*?)['"]""",
+        re.IGNORECASE,
+    )),
+    ("http", "Next.js/Remix route handler", re.compile(
+        r"""export\s+(?:async\s+)?function\s+(GET|POST|PUT|PATCH|DELETE|HEAD|OPTIONS)\b""",
+    )),
+    # CLI
+    ("cli", "CLI command", re.compile(
+        r"""\.command\s*\(\s*['"]([\w\-:]+)['"]""",
+    )),
+    ("cli", "argparse subparser", re.compile(
+        r"""add_parser\s*\(\s*['"]([\w\-]+)['"]""",
+    )),
+    # Event handlers
+    ("event", "Event listener", re.compile(
+        r"""\.on\s*\(\s*['"]([\w\-:.]+)['"]""",
+    )),
+    ("event", "Event subscriber decorator", re.compile(
+        r"""@(?:EventHandler|Subscribe|Listener|on_event)\s*\(\s*['"]([\w\-:.]+)['"]""",
+    )),
+    # Cron / scheduled
+    ("cron", "Cron schedule", re.compile(
+        r"""@?(?:Cron|Schedule|Scheduled|crontab)\s*\(\s*['"]([^'"]+)['"]""",
+        re.IGNORECASE,
+    )),
+    # GraphQL
+    ("http", "GraphQL resolver", re.compile(
+        r"""@(?:Query|Mutation|Subscription|Resolver)\s*\(""",
+    )),
+    # gRPC (only in .proto files — handled by file extension check below)
+    ("http", "gRPC service", re.compile(
+        r"""^service\s+(\w+)\s*\{""", re.MULTILINE,
+    )),
+    # Exported handlers (generic)
+    ("manual", "Exported handler", re.compile(
+        r"""export\s+(?:async\s+)?function\s+(handle\w+|process\w+|on\w+)\b""",
+    )),
+]
+
+
+# ── Gitignore support ──────────────────────────────────────────────────────
+
+def parse_gitignore(project_root: Path) -> list[re.Pattern[str]]:
+    """Parse .gitignore into a list of compiled regex patterns."""
+    gitignore = project_root / ".gitignore"
+    patterns: list[re.Pattern[str]] = []
+    if not gitignore.exists():
+        return patterns
+
+    for line in gitignore.read_text(errors="replace").splitlines():
+        line = line.strip()
+        if not line or line.startswith("#"):
+            continue
+        # Convert glob to regex (simplified)
+        regex = line.replace(".", r"\.").replace("**/", "(.*/)?").replace("*", "[^/]*").replace("?", "[^/]")
+        if line.endswith("/"):
+            regex = regex.rstrip("/") + "(/|$)"
+        try:
+            patterns.append(re.compile(regex))
+        except re.error as e:
+            print(f"Warning: skipping invalid gitignore pattern '{line}': {e}", file=sys.stderr)
+    return patterns
+
+
+def is_ignored(rel_path: str, gitignore_patterns: list[re.Pattern[str]]) -> bool:
+    """Check if a relative path matches any gitignore pattern."""
+    for pattern in gitignore_patterns:
+        if pattern.search(rel_path):
+            return True
+    return False
+
+
+# ── File tree scanner ──────────────────────────────────────────────────────
+
+def scan_file_tree(
+    root: Path,
+    gitignore_patterns: list[re.Pattern[str]],
+    max_depth: int = MAX_FILE_TREE_DEPTH,
+) -> list[str]:
+    """Return a flat list of relative file paths (source files only)."""
+    result: list[str] = []
+
+    def _walk(dir_path: Path, depth: int) -> None:
+        if depth > max_depth or len(result) >= MAX_FILES_TOTAL:
+            return
+        try:
+            entries = sorted(dir_path.iterdir(), key=lambda e: (not e.is_dir(), e.name.lower()))
+        except PermissionError:
+            return
+
+        file_count = 0
+        for entry in entries:
+            if len(result) >= MAX_FILES_TOTAL:
+                break
+            # Skip symlinks to avoid infinite loops
+            if entry.is_symlink():
+                continue
+            rel = str(entry.relative_to(root))
+            if entry.is_dir():
+                if entry.name in SKIP_DIRS:
+                    continue
+                if is_ignored(rel + "/", gitignore_patterns):
+                    continue
+                _walk(entry, depth + 1)
+            elif entry.is_file():
+                if file_count >= MAX_FILES_PER_DIR:
+                    break
+                if entry.suffix not in SOURCE_EXTENSIONS:
+                    continue
+                if is_ignored(rel, gitignore_patterns):
+                    continue
+                result.append(rel)
+                file_count += 1
+
+    _walk(root, 0)
+    return result
+
+
+# ── Entry point detection ──────────────────────────────────────────────────
+
+def detect_entry_points(root: Path, file_paths: list[str]) -> list[dict[str, Any]]:
+    """Scan source files for entry point patterns."""
+    entry_points: list[dict[str, Any]] = []
+
+    # Skip test files and the extraction script itself
+    test_patterns = re.compile(r"(?:\.test\.|\.spec\.|__tests__|_test\.py|test_\w+\.py|extract-domain-context\.py)")
+
+    for rel_path in file_paths:
+        if len(entry_points) >= MAX_ENTRY_POINTS:
+            break
+        if test_patterns.search(rel_path):
+            continue
+        full_path = root / rel_path
+        try:
+            content = full_path.read_text(errors="replace")
+        except (OSError, UnicodeDecodeError):
+            continue
+
+        lines = content.splitlines()
+        for entry_type, description, pattern in ENTRY_POINT_PATTERNS:
+            for match in pattern.finditer(content):
+                # Find line number
+                line_no = content[:match.start()].count("\n") + 1
+                # Extract a snippet (signature + a few lines)
+                start = max(0, line_no - 1)
+                end = min(len(lines), start + 5)
+                snippet = "\n".join(lines[start:end])
+
+                entry_points.append({
+                    "file": rel_path,
+                    "line": line_no,
+                    "type": entry_type,
+                    "description": description,
+                    "match": match.group(0)[:120],
+                    "snippet": snippet[:300],
+                })
+
+                if len(entry_points) >= MAX_ENTRY_POINTS:
+                    break
+            if len(entry_points) >= MAX_ENTRY_POINTS:
+                break
+
+    return entry_points
+
+
+# ── File signatures ────────────────────────────────────────────────────────
+
+def extract_file_signatures(root: Path, file_paths: list[str]) -> list[dict[str, Any]]:
+    """Extract exports and imports from each file (lightweight)."""
+    signatures: list[dict[str, Any]] = []
+
+    # Prioritize files likely to contain business logic
+    priority_keywords = [
+        "controller", "service", "handler", "router", "route", "api",
+        "model", "entity", "repository", "usecase", "use_case",
+        "command", "query", "event", "subscriber", "listener",
+        "middleware", "guard", "interceptor", "resolver",
+        "workflow", "flow", "process", "pipeline", "job", "task",
+    ]
+
+    def priority_score(path: str) -> int:
+        lower = path.lower()
+        score = 0
+        for kw in priority_keywords:
+            if kw in lower:
+                score += 1
+        return score
+
+    sorted_paths = sorted(file_paths, key=priority_score, reverse=True)
+
+    for rel_path in sorted_paths[:MAX_SAMPLED_FILES]:
+        full_path = root / rel_path
+        try:
+            content = full_path.read_text(errors="replace")
+        except (OSError, UnicodeDecodeError):
+            continue
+
+        lines = content.splitlines()[:MAX_LINES_PER_FILE]
+        truncated = "\n".join(lines)
+
+        # Extract exports (JS/TS)
+        exports = re.findall(
+            r"export\s+(?:default\s+)?(?:async\s+)?(?:function|class|const|let|var|interface|type|enum)\s+(\w+)",
+            truncated,
+        )
+        # Extract exports (Python)
+        if not exports:
+            exports = re.findall(r"^(?:def|class)\s+(\w+)", truncated, re.MULTILINE)
+
+        # Extract imports (first 20)
+        imports = re.findall(
+            r"""(?:import\s+.*?from\s+['"]([^'"]+)['"]|from\s+([\w.]+)\s+import)""",
+            truncated,
+        )
+        import_list = [m[0] or m[1] for m in imports][:20]
+
+        signatures.append({
+            "file": rel_path,
+            "exports": exports[:20],
+            "imports": import_list,
+            "lines": len(content.splitlines()),
+            "preview": truncated[:500],
+        })
+
+    return signatures
+
+
+# ── Metadata extraction ────────────────────────────────────────────────────
+
+def extract_metadata(root: Path) -> dict[str, Any]:
+    """Read project metadata files."""
+    metadata: dict[str, Any] = {}
+
+    for filename in METADATA_FILES:
+        filepath = root / filename
+        if not filepath.exists():
+            continue
+        try:
+            content = filepath.read_text(errors="replace")
+        except (OSError, UnicodeDecodeError):
+            continue
+
+        if filename == "package.json":
+            try:
+                pkg = json.loads(content)
+                metadata["package.json"] = {
+                    "name": pkg.get("name"),
+                    "description": pkg.get("description"),
+                    "scripts": list((pkg.get("scripts") or {}).keys()),
+                    "dependencies": list((pkg.get("dependencies") or {}).keys()),
+                    "devDependencies": list((pkg.get("devDependencies") or {}).keys()),
+                }
+            except json.JSONDecodeError:
+                metadata["package.json"] = content[:500]
+        elif filename.endswith((".md", ".rst", ".txt")) or filename == "README":
+            metadata[filename] = content[:2000]
+        elif filename.endswith((".toml", ".cfg", ".mod")):
+            metadata[filename] = content[:1000]
+        elif filename.endswith((".json", ".yml", ".yaml", ".xml", ".gradle")):
+            metadata[filename] = content[:1000]
+
+    return metadata
+
+
+# ── Main ───────────────────────────────────────────────────────────────────
+
+def _truncate_to_fit(context: dict[str, Any]) -> dict[str, Any]:
+    """Progressively trim context sections to stay under MAX_OUTPUT_BYTES."""
+    output = json.dumps(context, indent=2)
+    if len(output.encode()) <= MAX_OUTPUT_BYTES:
+        return context
+
+    # 1. Trim file tree to just a count
+    context["fileTree"] = context["fileTree"][:200]
+    output = json.dumps(context, indent=2)
+    if len(output.encode()) <= MAX_OUTPUT_BYTES:
+        return context
+
+    # 2. Trim previews in signatures
+    for sig in context.get("fileSignatures", []):
+        sig["preview"] = sig["preview"][:200]
+    output = json.dumps(context, indent=2)
+    if len(output.encode()) <= MAX_OUTPUT_BYTES:
+        return context
+
+    # 3. Trim snippets in entry points
+    for ep in context.get("entryPoints", []):
+        ep["snippet"] = ep["snippet"][:100]
+    output = json.dumps(context, indent=2)
+    if len(output.encode()) <= MAX_OUTPUT_BYTES:
+        return context
+
+    # 4. Reduce number of signatures and entry points
+    context["fileSignatures"] = context["fileSignatures"][:20]
+    context["entryPoints"] = context["entryPoints"][:100]
+
+    return context
+
+
+def main() -> None:
+    if len(sys.argv) < 2:
+        print("Usage: python extract-domain-context.py <project-root>", file=sys.stderr)
+        sys.exit(1)
+
+    project_root = Path(sys.argv[1]).resolve()
+    if not project_root.is_dir():
+        print(f"Error: {project_root} is not a directory", file=sys.stderr)
+        sys.exit(1)
+
+    try:
+        # Ensure output directory exists
+        output_dir = project_root / ".understand-anything" / "intermediate"
+        output_dir.mkdir(parents=True, exist_ok=True)
+        output_path = output_dir / "domain-context.json"
+
+        print(f"Scanning {project_root} ...", file=sys.stderr)
+
+        gitignore_patterns = parse_gitignore(project_root)
+        file_tree = scan_file_tree(project_root, gitignore_patterns)
+        print(f"  Found {len(file_tree)} source files", file=sys.stderr)
+
+        entry_points = detect_entry_points(project_root, file_tree)
+        print(f"  Detected {len(entry_points)} entry points", file=sys.stderr)
+
+        signatures = extract_file_signatures(project_root, file_tree)
+        print(f"  Extracted {len(signatures)} file signatures", file=sys.stderr)
+
+        metadata = extract_metadata(project_root)
+        print(f"  Read {len(metadata)} metadata files", file=sys.stderr)
+
+        context = {
+            "projectRoot": str(project_root),
+            "fileCount": len(file_tree),
+            "fileTree": file_tree,
+            "entryPoints": entry_points,
+            "fileSignatures": signatures,
+            "metadata": metadata,
+        }
+
+        context = _truncate_to_fit(context)
+        output = json.dumps(context, indent=2)
+        output_path.write_text(output)
+        size_kb = len(output.encode()) / 1024
+        print(f"  Wrote {output_path} ({size_kb:.0f} KB)", file=sys.stderr)
+
+    except Exception as e:
+        print(f"Error: {e}", file=sys.stderr)
+        sys.exit(1)
+
+
+if __name__ == "__main__":
+    main()

assets/skills/understand-explain/SKILL.md

@@ -0,0 +1,56 @@
+---
+name: understand-explain
+description: Use when you need a deep-dive explanation of a specific file, function, or module in the codebase
+argument-hint: [file-path]
+---
+
+# /understand-explain
+
+Provide a thorough, in-depth explanation of a specific code component.
+
+## Graph Structure Reference
+
+The knowledge graph JSON has this structure:
+- `project` — {name, description, languages, frameworks, analyzedAt, gitCommitHash}
+- `nodes[]` — each has {id, type, name, filePath, summary, tags[], complexity, languageNotes?}
+  - Node types: file, function, class, module, concept
+  - IDs: `file:path`, `function:path:name`, `class:path:name`
+- `edges[]` — each has {source, target, type, direction, weight}
+  - Key types: imports, contains, calls, depends_on
+- `layers[]` — each has {id, name, description, nodeIds[]}
+- `tour[]` — each has {order, title, description, nodeIds[]}
+
+## How to Read Efficiently
+
+1. Use Grep to search within the JSON for relevant entries BEFORE reading the full file
+2. Only read sections you need — don't dump the entire graph into context
+3. Node names and summaries are the most useful fields for understanding
+4. Edges tell you how components connect — follow imports and calls for dependency chains
+
+## Instructions
+
+1. Check that `.understand-anything/knowledge-graph.json` exists. If not, tell the user to run `/understand` first.
+
+2. **Find the target node** — use Grep to search the knowledge graph for the component: "$ARGUMENTS"
+   - For file paths (e.g., `src/auth/login.ts`): search for `"filePath"` matches
+   - For function notation (e.g., `src/auth/login.ts:verifyToken`): search for the function name in `"name"` fields filtered by the file path
+   - Note the exact node `id`, `type`, `summary`, `tags`, and `complexity`
+
+3. **Find all connected edges** — Grep for the target node's ID in the edges section:
+   - `"source"` matches → things this node calls/imports/depends on (outgoing)
+   - `"target"` matches → things that call/import/depend on this node (incoming)
+   - Note the connected node IDs and edge types
+
+4. **Read connected nodes** — for each connected node ID from step 3, Grep for those IDs in the nodes section to get their `name`, `summary`, and `type`. This builds the component's neighborhood.
+
+5. **Identify the layer** — Grep for the target node's ID in the `"layers"` section to find which architectural layer it belongs to and that layer's description.
+
+6. **Read the actual source file** — Read the source file at the node's `filePath` for the deep-dive analysis.
+
+7. **Explain the component in context**:
+   - Its role in the architecture (which layer, why it exists)
+   - Internal structure (functions, classes it contains — from `contains` edges)
+   - External connections (what it imports, what calls it, what it depends on — from edges)
+   - Data flow (inputs → processing → outputs — from source code)
+   - Explain clearly, assuming the reader may not know the programming language
+   - Highlight any patterns, idioms, or complexity worth understanding

assets/skills/understand-export/SKILL.md

@@ -0,0 +1,20 @@
+---
+name: understand-export
+description: Export spec markdown files to PDF with styled formatting
+argument-hint: [filename.md]
+---
+
+# /understand-export
+
+Convert spec markdown files to PDF using md-to-pdf.
+
+## Usage
+- `/understand-export` — Convert all spec .md files
+- `/understand-export design.md` — Convert specific file
+
+## Instructions
+
+1. Run: `python {{SCRIPTS_DIR}}/md_to_pdf.py`
+2. Converts .md files to PDF in `pdf/` folder
+3. Format: A4 landscape, page numbers, styled tables, embedded images
+4. Requires: `npm install -g md-to-pdf`

assets/skills/understand-export/md_to_pdf.py

@@ -0,0 +1,110 @@
+"""
+Convert Markdown spec files to PDF using md-to-pdf (Puppeteer/Chromium).
+
+Usage:
+  python md_to_pdf.py                    # Convert all spec .md files
+  python md_to_pdf.py design.md          # Convert specific file
+
+Requirements:
+  npm install -g md-to-pdf
+"""
+import os
+import sys
+import json
+import shutil
+import subprocess
+import tempfile
+
+SCRIPT_DIR = os.path.dirname(os.path.abspath(__file__))
+SPEC_DIR = os.path.dirname(SCRIPT_DIR)
+OUTPUT_DIR = os.path.join(SPEC_DIR, "pdf")
+os.makedirs(OUTPUT_DIR, exist_ok=True)
+
+CSS_FILE = os.path.join(SCRIPT_DIR, "pdf_style.css")
+
+
+def md_to_pdf(md_path):
+    """Convert markdown to PDF by prepending front-matter config."""
+    basename = os.path.splitext(os.path.basename(md_path))[0]
+    pdf_path = os.path.join(OUTPUT_DIR, f"{basename}.pdf")
+
+    print(f"  Converting {os.path.basename(md_path)}...")
+
+    # Read original markdown
+    with open(md_path, "r", encoding="utf-8") as f:
+        md_content = f.read()
+
+    # Read CSS
+    css_content = ""
+    if os.path.exists(CSS_FILE):
+        with open(CSS_FILE, "r", encoding="utf-8") as f:
+            css_content = f.read()
+
+    # Create temp file with front-matter for md-to-pdf config
+    front_matter = f"""---
+pdf_options:
+  format: A4
+  landscape: true
+  margin:
+    top: 15mm
+    bottom: 20mm
+    left: 12mm
+    right: 12mm
+  printBackground: true
+  displayHeaderFooter: true
+  headerTemplate: '<span></span>'
+  footerTemplate: '<div style="font-size:8px;width:100%;text-align:center;color:#666;"><span class="pageNumber"></span> / <span class="totalPages"></span></div>'
+stylesheet: {CSS_FILE}
+---
+
+"""
+    # Write temp file in same directory (so relative image paths work)
+    temp_path = os.path.join(SPEC_DIR, f"_temp_{basename}.md")
+    with open(temp_path, "w", encoding="utf-8") as f:
+        f.write(front_matter + md_content)
+
+    try:
+        result = subprocess.run(
+            ["md-to-pdf.cmd", temp_path],
+            capture_output=True, text=True, timeout=180,
+            cwd=SPEC_DIR
+        )
+
+        # md-to-pdf outputs to same dir as input with .pdf extension
+        temp_pdf = temp_path.replace(".md", ".pdf")
+        if os.path.exists(temp_pdf):
+            shutil.move(temp_pdf, pdf_path)
+            size_mb = os.path.getsize(pdf_path) / (1024 * 1024)
+            print(f"  ✅ {os.path.basename(pdf_path)} ({size_mb:.1f}MB)")
+            return True
+        else:
+            stderr = result.stderr[:300] if result.stderr else "no output"
+            print(f"  ❌ Failed: {stderr}")
+            return False
+    finally:
+        if os.path.exists(temp_path):
+            os.unlink(temp_path)
+
+
+def main():
+    if len(sys.argv) > 1:
+        files = [os.path.join(SPEC_DIR, f) if not os.path.isabs(f) else f
+                 for f in sys.argv[1:]]
+    else:
+        files = [
+            os.path.join(SPEC_DIR, f)
+            for f in sorted(os.listdir(SPEC_DIR))
+            if f.endswith('.md') and f != 'diagrams.mermaid.md'
+        ]
+
+    print(f"Converting {len(files)} file(s) to PDF → pdf/\n")
+    for f in files:
+        if not os.path.exists(f):
+            print(f"  ❌ Not found: {f}")
+            continue
+        md_to_pdf(f)
+    print("\nDone!")
+
+
+if __name__ == "__main__":
+    main()

assets/skills/understand-export/pdf_style.css

@@ -0,0 +1,23 @@
+body {
+    font-family: "Segoe UI", "Meiryo", "Yu Gothic", "Hiragino Sans", sans-serif;
+    font-size: 10pt;
+    line-height: 1.6;
+    color: #1a1a1a;
+    max-width: 100%;
+}
+h1 { font-size: 20pt; color: #003366; border-bottom: 3px solid #003366; padding-bottom: 6px; }
+h2 { font-size: 16pt; color: #003366; border-bottom: 1px solid #ccc; padding-bottom: 4px; margin-top: 24px; page-break-before: always; }
+h2:first-of-type { page-break-before: avoid; }
+h3 { font-size: 13pt; color: #004488; margin-top: 16px; }
+h4 { font-size: 11pt; color: #005599; }
+table { border-collapse: collapse; width: 100%; margin: 10px 0; font-size: 8.5pt; page-break-inside: auto; }
+th { background: #003366; color: white; padding: 5px 6px; text-align: left; font-weight: bold; }
+td { border: 1px solid #ddd; padding: 4px 6px; vertical-align: top; }
+tr { page-break-inside: avoid; }
+tr:nth-child(even) { background: #f8f8f8; }
+code { background: #f0f0f0; padding: 1px 4px; border-radius: 3px; font-size: 8.5pt; font-family: "Consolas", "Courier New", monospace; }
+pre { background: #1e1e1e; color: #d4d4d4; padding: 10px; border-radius: 6px; font-size: 8pt; overflow-x: auto; white-space: pre-wrap; word-wrap: break-word; page-break-inside: avoid; }
+pre code { background: none; color: inherit; padding: 0; }
+blockquote { border-left: 4px solid #003366; margin: 10px 0; padding: 8px 12px; background: #f0f4f8; font-size: 9pt; }
+img { max-width: 100%; height: auto; margin: 8px 0; page-break-inside: avoid; }
+a { color: #0066cc; text-decoration: none; }

assets/skills/understand-knowledge/SKILL.md

@@ -0,0 +1,129 @@
+---
+name: understand-knowledge
+description: Analyze a Karpathy-pattern LLM wiki knowledge base and generate an interactive knowledge graph with entity extraction, implicit relationships, and topic clustering.
+argument-hint: [wiki-directory]
+---
+
+# /understand-knowledge
+
+Analyzes a Karpathy-pattern LLM wiki — a three-layer knowledge base with raw sources, wiki markdown, and a schema file — and produces an interactive knowledge graph dashboard.
+
+## What It Detects
+
+The **Karpathy LLM wiki pattern** (see https://gist.github.com/karpathy/442a6bf555914893e9891c11519de94f):
+- **Raw sources** — immutable source documents (articles, papers, data files)
+- **Wiki** — LLM-generated markdown files with wikilinks (`[[target]]` syntax)
+- **Schema** — CLAUDE.md, AGENTS.md, or similar configuration file
+- **index.md** — content catalog organized by categories
+- **log.md** — chronological operation log
+
+Detection signals: has `index.md` + multiple `.md` files with wikilinks. May have `raw/` directory and schema file.
+
+## Instructions
+
+### Phase 1: DETECT
+
+1. Determine the target directory:
+   - If the user provided a path argument, use that
+   - Otherwise, use the current working directory
+
+2. Run the format detection script bundled with this skill:
+   ```
+   python3 <SKILL_DIR>/parse-knowledge-base.py <TARGET_DIR>
+   ```
+   - If the script exits with an error, tell the user this doesn't appear to be a Karpathy-pattern wiki and explain what was expected
+   - If successful, proceed. The script writes `scan-manifest.json` to `<TARGET_DIR>/.understand-anything/intermediate/`
+
+3. Read the scan-manifest.json and announce the results:
+   - "Detected Karpathy wiki: N articles, N sources, N topics, N wikilinks (N unresolved)"
+   - List the categories found from index.md
+
+### Phase 2: SCAN (already done)
+
+The parse script in Phase 1 already performed the deterministic scan. The scan-manifest.json contains:
+- Article nodes (one per wiki .md file) with extracted wikilinks, headings, frontmatter
+- Source nodes (one per raw/ file)
+- Topic nodes (from index.md section headings)
+- `related` edges (from wikilinks)
+- `categorized_under` edges (from index.md sections)
+
+No additional scanning is needed. Proceed to Phase 3.
+
+### Phase 3: ANALYZE
+
+Dispatch `article-analyzer` subagents to extract implicit knowledge:
+
+1. Read the scan-manifest.json to get the article list
+
+2. Prepare batches of 10-15 articles each, grouped by category when possible (articles in the same category are more likely to have implicit cross-references)
+
+3. For each batch, dispatch an `article-analyzer` subagent with:
+   - The batch of articles (id, name, summary, wikilinks, category, content from knowledgeMeta)
+   - The full list of existing node IDs (so the agent can reference them)
+   - The batch number for output file naming
+   - The intermediate directory path: `$INTERMEDIATE_DIR = <TARGET_DIR>/.understand-anything/intermediate`
+   
+   The agent will write `analysis-batch-{N}.json` to the intermediate directory.
+
+4. Run up to 3 batches concurrently. Wait for all batches to complete.
+
+5. If any batch fails, log a warning but continue — the scan-manifest provides a solid base graph even without LLM analysis.
+
+### Phase 4: MERGE
+
+1. Run the merge script bundled with this skill:
+   ```
+   python3 <SKILL_DIR>/merge-knowledge-graph.py <TARGET_DIR>
+   ```
+
+2. The script:
+   - Combines scan-manifest.json + all analysis-batch-*.json files
+   - Deduplicates entities (case-insensitive name matching)
+   - Normalizes node/edge types via alias maps
+   - Builds layers from index.md categories
+   - Builds a tour from index.md section ordering
+   - Writes `assembled-graph.json` to the intermediate directory
+
+3. Read the merge report from stderr and announce:
+   - Total nodes, edges, layers, tour steps
+   - How many entities/claims the LLM analysis added
+
+### Phase 5: SAVE
+
+1. Read the assembled-graph.json
+
+2. Run basic validation:
+   - Every edge source/target must reference an existing node
+   - Every node must have: id, type, name, summary, tags, complexity
+   - Remove any edges with dangling references
+
+3. Copy the validated graph to `<TARGET_DIR>/.understand-anything/knowledge-graph.json`
+
+4. Write metadata to `<TARGET_DIR>/.understand-anything/meta.json`:
+   ```json
+   {
+     "lastAnalyzedAt": "<ISO timestamp>",
+     "gitCommitHash": "<from git rev-parse HEAD or empty>",
+     "version": "1.0.0",
+     "analyzedFiles": <number of wiki articles>
+   }
+   ```
+
+5. Clean up intermediate files:
+   ```
+   rm -rf <TARGET_DIR>/.understand-anything/intermediate
+   ```
+
+6. Report summary to the user:
+   - "Knowledge graph saved: N articles, N entities, N topics, N claims, N sources"
+   - "N edges (N wikilink, N categorized, N implicit)"
+   - "N layers, N tour steps"
+
+7. Suggest running `project-understand --preview <TARGET_DIR>` to visualize the knowledge graph.
+
+## Notes
+
+- The parse script handles ALL deterministic extraction (wikilinks, headings, frontmatter, categories from index.md). The LLM agents only add implicit knowledge that requires inference.
+- Categories and taxonomy come from index.md section headings, NOT from filename prefixes. The Karpathy spec is intentionally abstract about naming conventions.
+- The graph uses `kind: "knowledge"` to signal the dashboard to use force-directed layout instead of hierarchical dagre.
+- Source nodes from raw/ are lightweight (filename + size only) — we don't parse PDFs or binary files.

assets/skills/understand-knowledge/merge-knowledge-graph.py

@@ -0,0 +1,397 @@
+#!/usr/bin/env python3
+"""
+Merge script for Karpathy-pattern knowledge graphs.
+
+Combines the deterministic scan-manifest.json with LLM analysis batches
+(analysis-batch-*.json) into a final assembled knowledge graph.
+
+Handles: entity deduplication, edge normalization, layer building from
+index.md categories, tour generation from index.md section ordering.
+
+Usage:
+    python merge-knowledge-graph.py <wiki-directory>
+
+Output:
+    Writes assembled-graph.json to <wiki-directory>/.understand-anything/intermediate/
+"""
+
+import json
+import os
+import re
+import sys
+from datetime import datetime, timezone
+from pathlib import Path
+
+# ---------------------------------------------------------------------------
+# Canonical type sets (must match core/src/types.ts)
+# ---------------------------------------------------------------------------
+
+VALID_NODE_TYPES = {
+    "article", "entity", "topic", "claim", "source",
+    # Codebase types (for cross-compatibility)
+    "file", "function", "class", "module", "concept",
+    "config", "document", "service", "table", "endpoint",
+    "pipeline", "schema", "resource", "domain", "flow", "step",
+}
+
+VALID_EDGE_TYPES = {
+    "cites", "contradicts", "builds_on", "exemplifies",
+    "categorized_under", "authored_by", "related", "similar_to",
+    # Codebase types
+    "imports", "exports", "contains", "inherits", "implements",
+    "calls", "subscribes", "publishes", "middleware",
+    "reads_from", "writes_to", "transforms", "validates",
+    "depends_on", "tested_by", "configures",
+    "deploys", "serves", "provisions", "triggers",
+    "migrates", "documents", "routes", "defines_schema",
+    "contains_flow", "flow_step", "cross_domain",
+}
+
+NODE_TYPE_ALIASES = {
+    "note": "article", "page": "article", "wiki_page": "article",
+    "person": "entity", "actor": "entity", "organization": "entity",
+    "tag": "topic", "category": "topic", "theme": "topic",
+    "assertion": "claim", "decision": "claim", "thesis": "claim",
+    "reference": "source", "raw": "source", "paper": "source",
+}
+
+EDGE_TYPE_ALIASES = {
+    "references": "cites", "cites_source": "cites",
+    "conflicts_with": "contradicts", "disagrees_with": "contradicts",
+    "refines": "builds_on", "elaborates": "builds_on",
+    "illustrates": "exemplifies", "instance_of": "exemplifies", "example_of": "exemplifies",
+    "belongs_to": "categorized_under", "tagged_with": "categorized_under",
+    "written_by": "authored_by", "created_by": "authored_by",
+    "relates_to": "related", "related_to": "related",
+}
+
+
+# ---------------------------------------------------------------------------
+# Normalization
+# ---------------------------------------------------------------------------
+
+def normalize_node_type(t: str) -> str:
+    t = t.lower().strip()
+    return NODE_TYPE_ALIASES.get(t, t)
+
+
+def normalize_edge_type(t: str) -> str:
+    t = t.lower().strip()
+    return EDGE_TYPE_ALIASES.get(t, t)
+
+
+def normalize_entity_name(name: str) -> str:
+    """Normalize entity names for deduplication."""
+    return re.sub(r'\s+', ' ', name.strip().lower())
+
+
+# ---------------------------------------------------------------------------
+# Merge pipeline
+# ---------------------------------------------------------------------------
+
+def merge(root: Path) -> dict:
+    intermediate = root / ".understand-anything" / "intermediate"
+    manifest_path = intermediate / "scan-manifest.json"
+
+    if not manifest_path.is_file():
+        print(f"Error: {manifest_path} not found. Run parse-knowledge-base.py first.",
+              file=sys.stderr)
+        sys.exit(1)
+
+    # Load scan manifest (deterministic base)
+    manifest = json.loads(manifest_path.read_text(encoding="utf-8"))
+    nodes = {n["id"]: n for n in manifest["nodes"]}
+    edges = list(manifest["edges"])
+
+    report = {"base_nodes": len(nodes), "base_edges": len(edges),
+              "batches": 0, "new_entities": 0, "new_claims": 0,
+              "new_edges": 0, "deduped_entities": 0, "dropped_edges": 0}
+
+    # Load analysis batches
+    batch_files = sorted(intermediate.glob("analysis-batch-*.json"))
+    entity_name_map: dict[str, str] = {}  # normalized_name → entity_id
+    dedup_remap: dict[str, str] = {}  # duplicate_id → canonical_id
+
+    for bf in batch_files:
+        report["batches"] += 1
+        try:
+            batch = json.loads(bf.read_text(encoding="utf-8"))
+        except (json.JSONDecodeError, OSError) as e:
+            print(f"[merge] Warning: Failed to load {bf.name}: {e}", file=sys.stderr)
+            continue
+
+        # Process new nodes from LLM analysis
+        for node in batch.get("nodes", []):
+            node_type = normalize_node_type(node.get("type", ""))
+            if node_type not in VALID_NODE_TYPES:
+                print(f"[merge] Warning: Unknown node type '{node.get('type')}' — skipping",
+                      file=sys.stderr)
+                continue
+
+            node["type"] = node_type
+            node_id = node.get("id", "")
+
+            # Entity deduplication — track remapping for edge fixup
+            if node_type == "entity":
+                norm_name = normalize_entity_name(node.get("name", ""))
+                if norm_name in entity_name_map:
+                    # Map duplicate ID → canonical ID for edge remapping
+                    dedup_remap[node_id] = entity_name_map[norm_name]
+                    report["deduped_entities"] += 1
+                    continue
+                entity_name_map[norm_name] = node_id
+                report["new_entities"] += 1
+            elif node_type == "claim":
+                report["new_claims"] += 1
+
+            # Ensure required fields
+            node.setdefault("summary", node.get("name", ""))
+            node.setdefault("tags", [])
+            node.setdefault("complexity", "simple")
+
+            nodes[node_id] = node
+
+        # Process new edges from LLM analysis
+        for edge in batch.get("edges", []):
+            edge_type = normalize_edge_type(edge.get("type", ""))
+            if edge_type not in VALID_EDGE_TYPES:
+                print(f"[merge] Warning: Unknown edge type '{edge.get('type')}' — "
+                      f"mapped to 'related'", file=sys.stderr)
+                edge_type = "related"
+
+            edge["type"] = edge_type
+            edge.setdefault("direction", "forward")
+            edge.setdefault("weight", 0.5)
+
+            # Remap deduped entity IDs, then validate source/target exist
+            src = dedup_remap.get(edge.get("source", ""), edge.get("source", ""))
+            tgt = dedup_remap.get(edge.get("target", ""), edge.get("target", ""))
+            edge["source"] = src
+            edge["target"] = tgt
+            if src in nodes and tgt in nodes:
+                edges.append(edge)
+                report["new_edges"] += 1
+            else:
+                report["dropped_edges"] += 1
+
+    # --- Deduplicate edges ---
+    seen: set[tuple[str, str, str]] = set()
+    final_edges = []
+    for edge in edges:
+        key = (edge["source"], edge["target"], edge["type"])
+        if key not in seen:
+            seen.add(key)
+            final_edges.append(edge)
+
+    # --- Build article→layer map from categories ---
+    categories = manifest.get("categories", [])
+    article_layer_map: dict[str, str] = {}  # article_id → layer_id
+    layer_members: dict[str, list[str]] = {}  # layer_id → [node_ids]
+
+    for cat in categories:
+        cat_name = cat["name"]
+        cat_slug = cat_name.lower().replace(" ", "-")
+        layer_id = f"layer:{cat_slug}"
+        topic_id = f"topic:{cat_slug}"
+        members = [e["source"] for e in final_edges
+                   if e["type"] == "categorized_under" and e["target"] == topic_id]
+        if topic_id in nodes:
+            members.append(topic_id)
+        layer_members[layer_id] = members
+        for mid in members:
+            article_layer_map[mid] = layer_id
+
+    # --- Assign entity/claim nodes to their parent article's layer ---
+    # Step 1: Build entity/claim → article mapping from edges
+    child_to_article: dict[str, str] = {}
+    for edge in final_edges:
+        src_type = nodes.get(edge["source"], {}).get("type", "")
+        tgt_type = nodes.get(edge["target"], {}).get("type", "")
+        # If an article connects to an entity/claim, map the child to the article
+        if src_type == "article" and tgt_type in ("entity", "claim"):
+            child_to_article.setdefault(edge["target"], edge["source"])
+        elif tgt_type == "article" and src_type in ("entity", "claim"):
+            child_to_article.setdefault(edge["source"], edge["target"])
+
+    # Step 2: For orphan entities/claims, try to match by ID prefix
+    # Build a reverse lookup: bare article name → full article ID
+    # e.g., "concept-aaak-compression" → "article:concepts/concept-aaak-compression"
+    bare_to_article: dict[str, str] = {}
+    for nid in nodes:
+        if nid.startswith("article:"):
+            # Extract the bare filename from paths like "article:concepts/concept-foo"
+            bare = nid.split("/")[-1] if "/" in nid else nid.replace("article:", "")
+            bare_to_article[bare] = nid
+
+    for nid, node in nodes.items():
+        if node["type"] in ("entity", "claim") and nid not in child_to_article:
+            # e.g., "claim:concept-aaak-compression:not-zero-loss" → stem "concept-aaak-compression"
+            # e.g., "entity:brain" → stem "brain"
+            raw = nid.split(":", 1)[1] if ":" in nid else nid  # "concept-aaak-compression:not-zero-loss"
+            stem = raw.split(":")[0]  # "concept-aaak-compression"
+
+            # Try exact bare name match first
+            if stem in bare_to_article:
+                child_to_article[nid] = bare_to_article[stem]
+            else:
+                # Try suffix/substring match against bare names
+                # e.g., entity:brain → segment-brain, entity:mempalace → tool-mempalace
+                matched = False
+                for bare, aid in bare_to_article.items():
+                    if stem in bare or bare in stem:
+                        child_to_article[nid] = aid
+                        matched = True
+                        break
+                    # Also try: bare ends with -stem (e.g., "segment-brain" ends with "-brain")
+                    if bare.endswith(f"-{stem}") or bare.endswith(f"/{stem}"):
+                        child_to_article[nid] = aid
+                        matched = True
+                        break
+                # Last resort: check if the node's name appears in any article's
+                # name OR content (knowledgeMeta.content)
+                if not matched and node.get("name"):
+                    node_name_lower = node["name"].lower()
+                    for aid, anode in nodes.items():
+                        if not aid.startswith("article:"):
+                            continue
+                        # Match against article name
+                        if node_name_lower in anode.get("name", "").lower():
+                            child_to_article[nid] = aid
+                            matched = True
+                            break
+                        # Match against article content (wikilinks or text)
+                        meta = anode.get("knowledgeMeta", {})
+                        content = (meta.get("content") or "").lower()
+                        if len(node_name_lower) >= 3 and node_name_lower in content:
+                            child_to_article[nid] = aid
+                            matched = True
+                            break
+
+    # Step 3: Place children into their parent article's layer
+    for child_id, article_id in child_to_article.items():
+        layer_id = article_layer_map.get(article_id)
+        if layer_id and layer_id in layer_members:
+            layer_members[layer_id].append(child_id)
+            article_layer_map[child_id] = layer_id
+
+    # --- Build layers ---
+    layers = []
+    for cat in categories:
+        cat_name = cat["name"]
+        cat_slug = cat_name.lower().replace(" ", "-")
+        layer_id = f"layer:{cat_slug}"
+        members = list(dict.fromkeys(layer_members.get(layer_id, [])))  # Deduplicate preserving order
+        layers.append({
+            "id": layer_id,
+            "name": cat_name,
+            "description": f"{cat_name} ({len(members)} nodes)",
+            "nodeIds": members,
+        })
+
+    # Assign uncategorized nodes to an "Other" layer
+    categorized_ids = set()
+    for layer in layers:
+        categorized_ids.update(layer["nodeIds"])
+    uncategorized = [nid for nid in nodes if nid not in categorized_ids]
+    if uncategorized:
+        layers.append({
+            "id": "layer:other",
+            "name": "Other",
+            "description": f"Uncategorized nodes ({len(uncategorized)})",
+            "nodeIds": uncategorized,
+        })
+
+    # --- Build tour from index.md category ordering ---
+    tour = []
+    for i, cat in enumerate(categories):
+        cat_slug = cat["name"].lower().replace(" ", "-")
+        topic_id = f"topic:{cat_slug}"
+        # Pick representative articles (up to 3 per category)
+        members = [e["source"] for e in final_edges
+                   if e["type"] == "categorized_under" and e["target"] == topic_id][:3]
+        if not members and topic_id in nodes:
+            members = [topic_id]
+        if members:
+            tour.append({
+                "order": i + 1,
+                "title": cat["name"],
+                "description": f"Explore the {cat['name']} section ({cat['count']} articles)",
+                "nodeIds": members,
+            })
+
+    # --- Detect project name ---
+    project_name = root.name
+    # Try to find a better name from index.md H1
+    index_path = root / "wiki" / "index.md"
+    if not index_path.is_file():
+        index_path = root / "index.md"
+    if index_path.is_file():
+        text = index_path.read_text(encoding="utf-8", errors="replace")
+        h1_match = re.search(r"^#\s+(.+)$", text, re.MULTILINE)
+        if h1_match:
+            project_name = h1_match.group(1).strip()
+
+    # --- Assemble final graph ---
+    graph = {
+        "version": "1.0.0",
+        "kind": "knowledge",
+        "project": {
+            "name": project_name,
+            "languages": ["markdown"],
+            "frameworks": ["karpathy-wiki"],
+            "description": f"Knowledge graph for {project_name}",
+            "analyzedAt": datetime.now(timezone.utc).isoformat(),
+            "gitCommitHash": "",
+        },
+        "nodes": list(nodes.values()),
+        "edges": final_edges,
+        "layers": layers,
+        "tour": tour,
+    }
+
+    # Try to get git commit hash
+    try:
+        import subprocess
+        result = subprocess.run(
+            ["git", "rev-parse", "HEAD"],
+            capture_output=True, text=True, cwd=str(root), timeout=5
+        )
+        if result.returncode == 0:
+            graph["project"]["gitCommitHash"] = result.stdout.strip()
+    except (OSError, subprocess.TimeoutExpired):
+        pass
+
+    # Write output
+    out_path = intermediate / "assembled-graph.json"
+    out_path.write_text(json.dumps(graph, indent=2), encoding="utf-8")
+
+    # Report
+    print(f"[merge] Input: {report['base_nodes']} scan nodes, "
+          f"{report['base_edges']} scan edges, {report['batches']} analysis batches",
+          file=sys.stderr)
+    print(f"[merge] Added: {report['new_entities']} entities, "
+          f"{report['new_claims']} claims, {report['new_edges']} edges "
+          f"({report['deduped_entities']} deduped entities, "
+          f"{report['dropped_edges']} dropped dangling edges)", file=sys.stderr)
+    print(f"[merge] Output: {len(graph['nodes'])} nodes, {len(final_edges)} edges, "
+          f"{len(layers)} layers, {len(tour)} tour steps", file=sys.stderr)
+    print(f"[merge] Written: {out_path}", file=sys.stderr)
+
+    return graph
+
+
+def main():
+    if len(sys.argv) < 2:
+        print("Usage: merge-knowledge-graph.py <wiki-directory>", file=sys.stderr)
+        sys.exit(1)
+
+    root = Path(sys.argv[1]).resolve()
+    if not root.is_dir():
+        print(f"Error: {root} is not a directory", file=sys.stderr)
+        sys.exit(1)
+
+    merge(root)
+
+
+if __name__ == "__main__":
+    main()

assets/skills/understand-knowledge/parse-knowledge-base.py

@@ -0,0 +1,509 @@
+#!/usr/bin/env python3
+"""
+Deterministic parser for Karpathy-pattern LLM wikis.
+
+Detects the three-layer pattern (raw sources + wiki markdown + schema),
+extracts structure from markdown files, resolves wikilinks, and derives
+categories from index.md section headings.
+
+Usage:
+    python parse-knowledge-base.py <wiki-directory>
+
+Output:
+    Writes scan-manifest.json to <wiki-directory>/.understand-anything/intermediate/
+"""
+
+import json
+import os
+import re
+import sys
+from pathlib import Path
+
+# ---------------------------------------------------------------------------
+# Regex patterns
+# ---------------------------------------------------------------------------
+WIKILINK_RE = re.compile(r"\[\[([^\]|]+)(?:\|([^\]]+))?\]\]")
+FRONTMATTER_RE = re.compile(r"^---\s*\n(.*?)\n---\s*\n", re.DOTALL)
+CODE_BLOCK_RE = re.compile(r"```(\w*)")
+HEADING_RE = re.compile(r"^(#{1,6})\s+(.+)$", re.MULTILINE)
+INDEX_SECTION_RE = re.compile(r"^##\s+(.+)$", re.MULTILINE)
+
+# Files that are part of wiki infrastructure, not content articles
+INFRA_FILES = {"index.md", "log.md", "claude.md", "agents.md", "soul.md"}
+
+# ---------------------------------------------------------------------------
+# Detection: is this a Karpathy-pattern wiki?
+# ---------------------------------------------------------------------------
+
+def detect_format(root: Path) -> dict:
+    """Detect if directory follows the Karpathy LLM wiki three-layer pattern."""
+    signals = {
+        "has_index": (root / "index.md").is_file() or (root / "wiki" / "index.md").is_file(),
+        "has_log": (root / "log.md").is_file() or (root / "wiki" / "log.md").is_file(),
+        "has_raw": (root / "raw").is_dir(),
+        "has_schema": any(
+            (root / f).is_file() or (root / "wiki" / f).is_file()
+            for f in ["CLAUDE.md", "AGENTS.md"]
+        ),
+    }
+
+    # Find the wiki root — could be the directory itself or a wiki/ subdirectory
+    if (root / "wiki").is_dir():
+        wiki_root = root / "wiki"
+    else:
+        wiki_root = root
+
+    # Count markdown files in the wiki root
+    md_files = list(wiki_root.rglob("*.md"))
+    signals["md_count"] = len(md_files)
+    signals["wiki_root"] = str(wiki_root)
+
+    # Primary signal: has index.md + meaningful number of markdown files
+    if signals["has_index"] and signals["md_count"] >= 3:
+        signals["detected"] = True
+        signals["format"] = "karpathy"
+    else:
+        signals["detected"] = False
+        signals["format"] = "unknown"
+
+    return signals
+
+
+# ---------------------------------------------------------------------------
+# Markdown extraction helpers
+# ---------------------------------------------------------------------------
+
+def extract_frontmatter(text: str) -> dict:
+    """Extract YAML frontmatter as a simple key-value dict."""
+    m = FRONTMATTER_RE.match(text)
+    if not m:
+        return {}
+    fm = {}
+    for line in m.group(1).split("\n"):
+        if ":" in line:
+            key, _, val = line.partition(":")
+            fm[key.strip()] = val.strip().strip('"').strip("'")
+    return fm
+
+
+def extract_wikilinks(text: str) -> list[dict]:
+    """Extract all [[target]] and [[target|display]] wikilinks."""
+    links = []
+    for m in WIKILINK_RE.finditer(text):
+        links.append({
+            "target": m.group(1).strip(),
+            "display": m.group(2).strip() if m.group(2) else None,
+        })
+    return links
+
+
+def extract_headings(text: str) -> list[dict]:
+    """Extract all markdown headings with level and text."""
+    return [
+        {"level": len(m.group(1)), "text": m.group(2).strip()}
+        for m in HEADING_RE.finditer(text)
+    ]
+
+
+def extract_code_blocks(text: str) -> list[str]:
+    """Extract languages from fenced code blocks."""
+    return [m.group(1) for m in CODE_BLOCK_RE.finditer(text) if m.group(1)]
+
+
+def extract_first_paragraph(text: str) -> str:
+    """Extract the first non-empty paragraph after frontmatter and H1."""
+    # Strip frontmatter
+    stripped = FRONTMATTER_RE.sub("", text).strip()
+    if not stripped:
+        return ""
+    lines = stripped.split("\n")
+
+    def _collect_paragraph(start_lines: list[str]) -> str:
+        """Collect the first paragraph from the given lines."""
+        para: list[str] = []
+        for s_raw in start_lines:
+            s = s_raw.strip()
+            if not s and not para:
+                continue  # Skip leading blank lines
+            if not s and para:
+                break  # End of paragraph
+            if s.startswith(">"):
+                continue  # Skip blockquotes
+            if re.match(r"^[-*_]{3,}\s*$", s):
+                continue  # Skip horizontal rules
+            if s.startswith("#"):
+                if para:
+                    break  # End paragraph at next heading
+                continue  # Skip headings before paragraph
+            para.append(s)
+        return " ".join(para)
+
+    # Try: find first paragraph after H1
+    for i, line in enumerate(lines):
+        if line.strip().startswith("# "):
+            result = _collect_paragraph(lines[i + 1:])
+            if result:
+                if len(result) > 200:
+                    return result[:197] + "..."
+                return result
+
+    # Fallback: no H1 found, take first paragraph from start
+    result = _collect_paragraph(lines)
+    if len(result) > 200:
+        result = result[:197] + "..."
+    return result or ""
+
+
+def extract_h1(text: str) -> str:
+    """Extract the first H1 heading."""
+    for m in HEADING_RE.finditer(text):
+        if len(m.group(1)) == 1:
+            # Strip trailing wiki-style decorations like " — subtitle"
+            return m.group(2).strip()
+    return ""
+
+
+# ---------------------------------------------------------------------------
+# Index.md parsing — categories come from section headings
+# ---------------------------------------------------------------------------
+
+def parse_index(index_path: Path) -> list[dict]:
+    """Parse index.md to extract categories from ## headings and their wikilinks."""
+    if not index_path.is_file():
+        return []
+    text = index_path.read_text(encoding="utf-8", errors="replace")
+    categories = []
+    current_category = None
+
+    for line in text.split("\n"):
+        # Detect ## section heading
+        sec_match = re.match(r"^##\s+(.+)$", line)
+        if sec_match:
+            current_category = {
+                "name": sec_match.group(1).strip(),
+                "articles": [],
+            }
+            categories.append(current_category)
+            continue
+
+        # Collect wikilinks under current section
+        if current_category:
+            for wl in WIKILINK_RE.finditer(line):
+                current_category["articles"].append(wl.group(1).strip())
+
+    return categories
+
+
+# ---------------------------------------------------------------------------
+# Log.md parsing — extract operation timeline
+# ---------------------------------------------------------------------------
+
+def parse_log(log_path: Path) -> list[dict]:
+    """Parse log.md to extract chronological entries."""
+    if not log_path.is_file():
+        return []
+    text = log_path.read_text(encoding="utf-8", errors="replace")
+    entries = []
+    log_entry_re = re.compile(
+        r"^##\s+\[(\d{4}-\d{2}-\d{2})\]\s+(\w+)\s*\|\s*(.+)$", re.MULTILINE
+    )
+    for m in log_entry_re.finditer(text):
+        entries.append({
+            "date": m.group(1),
+            "operation": m.group(2),
+            "title": m.group(3).strip(),
+        })
+    return entries
+
+
+# ---------------------------------------------------------------------------
+# Main pipeline
+# ---------------------------------------------------------------------------
+
+def build_name_to_stem_map(wiki_root: Path) -> dict[str, str]:
+    """Build a case-insensitive map from filename stem to relative stem path.
+
+    Full relative paths always map uniquely. Bare basenames map only when
+    unambiguous — duplicate basenames are removed so they don't silently
+    resolve to the wrong page.
+    """
+    name_map: dict[str, str] = {}
+    # Track which bare basenames appear more than once
+    basename_counts: dict[str, int] = {}
+    for md_file in wiki_root.rglob("*.md"):
+        rel = md_file.relative_to(wiki_root)
+        stem = str(rel.with_suffix(""))  # e.g., "decisions/decision-foo"
+        basename = md_file.stem            # e.g., "decision-foo"
+        # Full relative path always maps uniquely
+        name_map[stem.lower()] = stem
+        # Track basename for ambiguity detection
+        key = basename.lower()
+        basename_counts[key] = basename_counts.get(key, 0) + 1
+        name_map[key] = stem
+
+    # Remove ambiguous basename entries (appear more than once)
+    for key, count in basename_counts.items():
+        if count > 1 and key in name_map:
+            del name_map[key]
+
+    return name_map
+
+
+def resolve_wikilink(target: str, name_map: dict[str, str], node_ids: set[str] | None = None) -> str | None:
+    """Resolve a wikilink target to an article node ID.
+
+    If node_ids is provided, only resolve to IDs that exist in the set.
+    """
+    key = target.lower().strip()
+    # Skip targets that are clearly not page names (shell flags, etc.)
+    if key.startswith("-"):
+        return None
+    stem = name_map.get(key)
+    if stem:
+        candidate = f"article:{stem}"
+        # If we have a node set, verify the target exists
+        if node_ids is not None and candidate not in node_ids:
+            return None
+        return candidate
+    # Try without directory prefix
+    for stored_key, stored_stem in name_map.items():
+        if stored_key.endswith("/" + key) or stored_key == key:
+            candidate = f"article:{stored_stem}"
+            if node_ids is not None and candidate not in node_ids:
+                return None
+            return candidate
+    return None
+
+
+def parse_wiki(root: Path) -> dict:
+    """Parse a Karpathy-pattern wiki and produce the scan manifest."""
+    detection = detect_format(root)
+    if not detection["detected"]:
+        print(json.dumps({"error": "Not a Karpathy-pattern wiki", "detection": detection}),
+              file=sys.stderr)
+        sys.exit(1)
+
+    wiki_root = Path(detection["wiki_root"])
+    raw_root = root / "raw"
+
+    # Build name resolution map
+    name_map = build_name_to_stem_map(wiki_root)
+
+    # Find index.md and log.md
+    index_path = wiki_root / "index.md"
+    if not index_path.is_file():
+        index_path = root / "index.md"
+    log_path = wiki_root / "log.md"
+    if not log_path.is_file():
+        log_path = root / "log.md"
+
+    # Parse index for categories
+    categories = parse_index(index_path)
+    log_entries = parse_log(log_path)
+
+    # Build category lookup: wikilink target → category name
+    category_lookup: dict[str, str] = {}
+    for cat in categories:
+        for article_target in cat["articles"]:
+            category_lookup[article_target.lower()] = cat["name"]
+
+    # --- Pre-compute article IDs (for edge resolution validation) ---
+    # Only skip infra files at the wiki root level, not in subdirectories
+    # (e.g., wiki/index.md is infra, but wiki/concepts/index.md is content)
+    article_ids: set[str] = set()
+    for md_file in sorted(wiki_root.rglob("*.md")):
+        rel = md_file.relative_to(wiki_root)
+        stem = str(rel.with_suffix(""))
+        # Only filter infra files at root level (no parent directory)
+        if rel.parent == Path(".") and rel.name.lower() in INFRA_FILES:
+            continue
+        article_ids.add(f"article:{stem}")
+
+    # --- Build article nodes ---
+    nodes = []
+    edges = []
+    warnings = []
+    stats = {"articles": 0, "sources": 0, "topics": 0, "wikilinks": 0, "unresolved": 0}
+
+    for md_file in sorted(wiki_root.rglob("*.md")):
+        rel = md_file.relative_to(wiki_root)
+        stem = str(rel.with_suffix(""))
+        basename = md_file.stem
+
+        # Skip infrastructure files only at wiki root level
+        if rel.parent == Path(".") and rel.name.lower() in INFRA_FILES:
+            continue
+
+        text = md_file.read_text(encoding="utf-8", errors="replace")
+        h1 = extract_h1(text)
+        frontmatter = extract_frontmatter(text)
+        wikilinks = extract_wikilinks(text)
+        headings = extract_headings(text)
+        code_langs = extract_code_blocks(text)
+        summary = extract_first_paragraph(text)
+        line_count = text.count("\n") + 1
+        word_count = len(text.split())
+
+        # Derive category from index.md lookup
+        category = category_lookup.get(basename.lower(), "")
+        if not category:
+            # Try stem match
+            category = category_lookup.get(stem.lower(), "")
+
+        # Derive tags (deduplicated)
+        tag_set: set[str] = set()
+        if category:
+            tag_set.add(category.lower())
+        if rel.parent != Path("."):
+            tag_set.add(str(rel.parent))
+        fm_tags = frontmatter.get("tags", "")
+        if fm_tags:
+            tag_set.update(t.strip() for t in fm_tags.split(",") if t.strip())
+        tags = sorted(tag_set)
+
+        # Complexity from wikilink density
+        wl_count = len(wikilinks)
+        if wl_count > 15:
+            complexity = "complex"
+        elif wl_count > 5:
+            complexity = "moderate"
+        else:
+            complexity = "simple"
+
+        node_id = f"article:{stem}"
+        nodes.append({
+            "id": node_id,
+            "type": "article",
+            "name": h1 or basename,
+            "filePath": str(rel),
+            "summary": summary or f"Wiki article: {h1 or basename}",
+            "tags": tags,
+            "complexity": complexity,
+            "knowledgeMeta": {
+                "wikilinks": [wl["target"] for wl in wikilinks],
+                "category": category or None,
+                "content": text[:3000],  # First 3000 chars for LLM analysis
+            },
+        })
+        stats["articles"] += 1
+        stats["wikilinks"] += wl_count
+
+        # Build edges from wikilinks (resolve against known article IDs)
+        for wl in wikilinks:
+            target_id = resolve_wikilink(wl["target"], name_map, article_ids)
+            if target_id and target_id != node_id:
+                edges.append({
+                    "source": node_id,
+                    "target": target_id,
+                    "type": "related",
+                    "direction": "forward",
+                    "weight": 0.7,
+                })
+            elif not target_id:
+                warnings.append(f"Unresolved wikilink: [[{wl['target']}]] in {rel}")
+                stats["unresolved"] += 1
+
+    # --- Build topic nodes from index.md categories ---
+    for cat in categories:
+        topic_id = f"topic:{cat['name'].lower().replace(' ', '-')}"
+        nodes.append({
+            "id": topic_id,
+            "type": "topic",
+            "name": cat["name"],
+            "summary": f"Category from index: {cat['name']} ({len(cat['articles'])} articles)",
+            "tags": ["category"],
+            "complexity": "simple",
+        })
+        stats["topics"] += 1
+
+        # categorized_under edges (only resolve to known article nodes)
+        for article_target in cat["articles"]:
+            article_id = resolve_wikilink(article_target, name_map, article_ids)
+            if article_id:
+                edges.append({
+                    "source": article_id,
+                    "target": topic_id,
+                    "type": "categorized_under",
+                    "direction": "forward",
+                    "weight": 0.6,
+                })
+
+    # --- Build source nodes from raw/ ---
+    if raw_root.is_dir():
+        for raw_file in sorted(raw_root.rglob("*")):
+            if raw_file.is_file() and not raw_file.name.startswith("."):
+                rel_raw = raw_file.relative_to(root)
+                ext = raw_file.suffix.lower()
+                size_kb = raw_file.stat().st_size / 1024
+                source_id = f"source:{raw_file.relative_to(raw_root).with_suffix('')}"
+                nodes.append({
+                    "id": source_id,
+                    "type": "source",
+                    "name": raw_file.name,
+                    "filePath": str(rel_raw),
+                    "summary": f"Raw source ({ext or 'unknown'}, {size_kb:.0f} KB)",
+                    "tags": ["raw", ext.lstrip(".") or "unknown"],
+                    "complexity": "simple",
+                })
+                stats["sources"] += 1
+
+    # --- Compute backlinks ---
+    backlink_map: dict[str, list[str]] = {}
+    for edge in edges:
+        if edge["type"] == "related":
+            target = edge["target"]
+            source = edge["source"]
+            backlink_map.setdefault(target, []).append(source)
+    for node in nodes:
+        if node["type"] == "article" and "knowledgeMeta" in node:
+            bl = backlink_map.get(node["id"], [])
+            node["knowledgeMeta"]["backlinks"] = bl
+
+    # --- Deduplicate edges ---
+    seen_edges: set[tuple[str, str, str]] = set()
+    deduped_edges = []
+    for edge in edges:
+        key = (edge["source"], edge["target"], edge["type"])
+        if key not in seen_edges:
+            seen_edges.add(key)
+            deduped_edges.append(edge)
+
+    return {
+        "format": "karpathy",
+        "stats": stats,
+        "categories": [{"name": c["name"], "count": len(c["articles"])} for c in categories],
+        "logEntries": len(log_entries),
+        "nodes": nodes,
+        "edges": deduped_edges,
+        "warnings": warnings[:50],  # Cap warnings
+    }
+
+
+def main():
+    if len(sys.argv) < 2:
+        print("Usage: parse-knowledge-base.py <wiki-directory>", file=sys.stderr)
+        sys.exit(1)
+
+    root = Path(sys.argv[1]).resolve()
+    if not root.is_dir():
+        print(f"Error: {root} is not a directory", file=sys.stderr)
+        sys.exit(1)
+
+    manifest = parse_wiki(root)
+
+    # Write output
+    out_dir = root / ".understand-anything" / "intermediate"
+    out_dir.mkdir(parents=True, exist_ok=True)
+    out_path = out_dir / "scan-manifest.json"
+    out_path.write_text(json.dumps(manifest, indent=2), encoding="utf-8")
+
+    # Report to stderr
+    s = manifest["stats"]
+    print(f"[parse] Karpathy wiki: {s['articles']} articles, {s['sources']} sources, "
+          f"{s['topics']} topics, {s['wikilinks']} wikilinks "
+          f"({s['unresolved']} unresolved)", file=sys.stderr)
+    print(f"[parse] Output: {out_path}", file=sys.stderr)
+
+
+if __name__ == "__main__":
+    main()

assets/skills/understand-mermaid/SKILL.md

@@ -0,0 +1,20 @@
+---
+name: understand-mermaid
+description: Render Mermaid diagrams from diagrams.mermaid.md to PNG images offline
+argument-hint: [--only NN]
+---
+
+# /understand-mermaid
+
+Render all Mermaid diagrams to PNG using mermaid-cli (mmdc) offline.
+
+## Usage
+- `/understand-mermaid` — Render all diagrams
+- `/understand-mermaid --only 01` — Render only diagram 01
+
+## Instructions
+
+1. Run: `python {{SCRIPTS_DIR}}/render_mermaid.py`
+2. Reads `diagrams.mermaid.md` and extracts mermaid code blocks
+3. Renders each to PNG in `images/diagrams/diagram_XX.png`
+4. Requires: `npm install -g @mermaid-js/mermaid-cli`

assets/skills/understand-mermaid/render_mermaid.py

@@ -0,0 +1,169 @@
+"""
+Render Mermaid diagrams OFFLINE using mermaid-cli (mmdc).
+No internet required. Uses headless Chromium via Puppeteer.
+
+Workflow:
+  1. Read diagrams.mermaid.md
+  2. Extract mermaid code blocks
+  3. Render each to PNG via mmdc (local, offline)
+  4. Output: images/diagrams/diagram_XX.png
+
+Usage:
+  python render_mermaid.py              # Render all diagrams
+  python render_mermaid.py --only 01    # Render only diagram_01
+  python render_mermaid.py --width 3000 # Custom width (default: 2400)
+  python render_mermaid.py --scale 4    # Custom scale factor (default: 3)
+
+Requirements:
+  npm install -g @mermaid-js/mermaid-cli
+"""
+import re
+import os
+import sys
+import json
+import subprocess
+import tempfile
+
+SCRIPT_DIR = os.path.dirname(os.path.abspath(__file__))
+SPEC_DIR = os.path.dirname(SCRIPT_DIR)  # Parent = spec directory
+MERMAID_SOURCE = os.path.join(SPEC_DIR, "diagrams.mermaid.md")
+OUTPUT_DIR = os.path.join(SPEC_DIR, "images", "diagrams")
+os.makedirs(OUTPUT_DIR, exist_ok=True)
+
+DEFAULT_WIDTH = 2400
+DEFAULT_SCALE = 3  # 3x scale for sharp text when zoomed
+
+
+def find_mmdc():
+    """Find mmdc executable."""
+    for cmd in ["mmdc", "mmdc.cmd", "npx mmdc"]:
+        try:
+            result = subprocess.run(
+                cmd.split() + ["--version"],
+                capture_output=True, text=True, timeout=10
+            )
+            if result.returncode == 0:
+                return cmd.split()
+        except (FileNotFoundError, subprocess.TimeoutExpired):
+            continue
+    return None
+
+
+def extract_diagrams(filepath):
+    """Extract diagram ID and mermaid code from diagrams.mermaid.md"""
+    with open(filepath, "r", encoding="utf-8") as f:
+        content = f.read()
+    diagrams = []
+    pattern = r'## Diagram (\d+).*?> File: `images/diagrams/(diagram_\S+\.png)`.*?```mermaid\n(.*?)```'
+    for match in re.finditer(pattern, content, re.DOTALL):
+        diagrams.append({
+            "num": match.group(1),
+            "filename": match.group(2),
+            "code": match.group(3).strip()
+        })
+    return diagrams
+
+
+def render_mmdc(mmdc_cmd, code, output_path, width=DEFAULT_WIDTH, scale=DEFAULT_SCALE):
+    """Render a single mermaid diagram using mmdc (offline)."""
+    # Write mermaid code to temp file
+    with tempfile.NamedTemporaryFile(mode='w', suffix='.mmd', delete=False, encoding='utf-8') as f:
+        f.write(code)
+        temp_input = f.name
+
+    # mmdc config for high-res output
+    config = {
+        "theme": "default",
+        "themeVariables": {
+            "fontSize": "14px"
+        }
+    }
+    with tempfile.NamedTemporaryFile(mode='w', suffix='.json', delete=False, encoding='utf-8') as f:
+        json.dump(config, f)
+        temp_config = f.name
+
+    try:
+        cmd = mmdc_cmd + [
+            "-i", temp_input,
+            "-o", output_path,
+            "-w", str(width),
+            "-s", str(scale),
+            "-b", "white",
+            "-c", temp_config,
+        ]
+        result = subprocess.run(
+            cmd,
+            capture_output=True, text=True, timeout=60
+        )
+        if result.returncode == 0 and os.path.exists(output_path):
+            return True
+        if result.stderr:
+            print(f"\n    mmdc stderr: {result.stderr.strip()[:200]}")
+        return False
+    except subprocess.TimeoutExpired:
+        print(f"\n    mmdc timeout (60s)")
+        return False
+    except Exception as e:
+        print(f"\n    mmdc error: {e}")
+        return False
+    finally:
+        os.unlink(temp_input)
+        os.unlink(temp_config)
+
+
+def main():
+    only_num = None
+    width = DEFAULT_WIDTH
+    scale = DEFAULT_SCALE
+
+    args = sys.argv[1:]
+    i = 0
+    while i < len(args):
+        if args[i] == "--only" and i + 1 < len(args):
+            only_num = args[i + 1].zfill(2)
+            i += 2
+        elif args[i] == "--width" and i + 1 < len(args):
+            width = int(args[i + 1])
+            i += 2
+        elif args[i] == "--scale" and i + 1 < len(args):
+            scale = int(args[i + 1])
+            i += 2
+        else:
+            i += 1
+
+    # Find mmdc
+    mmdc_cmd = find_mmdc()
+    if not mmdc_cmd:
+        print("ERROR: mmdc not found. Install with: npm install -g @mermaid-js/mermaid-cli")
+        sys.exit(1)
+    print(f"Using: {' '.join(mmdc_cmd)}")
+    print(f"Output: width={width}px, scale={scale}x → effective {width*scale}px")
+
+    diagrams = extract_diagrams(MERMAID_SOURCE)
+    print(f"Found {len(diagrams)} diagrams")
+
+    if only_num:
+        diagrams = [d for d in diagrams if d["num"].zfill(2) == only_num]
+        if not diagrams:
+            print(f"ERROR: Diagram {only_num} not found")
+            sys.exit(1)
+
+    success = 0
+    failed = 0
+    for d in diagrams:
+        img_path = os.path.join(OUTPUT_DIR, d["filename"])
+        print(f"  [{d['num']}] {d['filename']}...", end=" ")
+
+        if render_mmdc(mmdc_cmd, d["code"], img_path, width=width, scale=scale):
+            size_kb = os.path.getsize(img_path) / 1024
+            print(f"OK ({size_kb:.0f}KB)")
+            success += 1
+        else:
+            print("FAILED")
+            failed += 1
+
+    print(f"\nDone! {success}/{len(diagrams)} rendered (offline, {width}px × {scale}x).")
+
+
+if __name__ == "__main__":
+    main()

assets/skills/understand-onboard/SKILL.md

@@ -0,0 +1,53 @@
+---
+name: understand-onboard
+description: Use when you need to generate an onboarding guide for new team members joining a project
+---
+
+# /understand-onboard
+
+Generate a comprehensive onboarding guide from the project's knowledge graph.
+
+## Graph Structure Reference
+
+The knowledge graph JSON has this structure:
+- `project` — {name, description, languages, frameworks, analyzedAt, gitCommitHash}
+- `nodes[]` — each has {id, type, name, filePath, summary, tags[], complexity, languageNotes?}
+  - Node types: file, function, class, module, concept
+  - IDs: `file:path`, `function:path:name`, `class:path:name`
+- `edges[]` — each has {source, target, type, direction, weight}
+  - Key types: imports, contains, calls, depends_on
+- `layers[]` — each has {id, name, description, nodeIds[]}
+- `tour[]` — each has {order, title, description, nodeIds[]}
+
+## How to Read Efficiently
+
+1. Use Grep to search within the JSON for relevant entries BEFORE reading the full file
+2. Only read sections you need — don't dump the entire graph into context
+3. Node names and summaries are the most useful fields for understanding
+4. Edges tell you how components connect — follow imports and calls for dependency chains
+
+## Instructions
+
+1. Check that `.understand-anything/knowledge-graph.json` exists. If not, tell the user to run `/understand` first.
+
+2. **Read project metadata** — use Grep or Read with a line limit to extract the `"project"` section (name, description, languages, frameworks).
+
+3. **Read layers** — Grep for `"layers"` to get the full layers array. These define the architecture and will structure the guide.
+
+4. **Read the tour** — Grep for `"tour"` to get the guided walkthrough steps. These provide the recommended learning path.
+
+5. **Read file-level nodes only** — use Grep to find nodes with `"type": "file"` in the knowledge graph. Skip function-level and class-level nodes to keep the guide high-level. Extract each file node's `name`, `filePath`, `summary`, and `complexity`.
+
+6. **Identify complexity hotspots** — from the file-level nodes, find those with the highest `complexity` values. These are areas new developers should approach carefully.
+
+7. **Generate the onboarding guide** with these sections:
+   - **Project Overview**: name, languages, frameworks, description (from project metadata)
+   - **Architecture Layers**: each layer's name, description, and key files (from layers + file nodes)
+   - **Key Concepts**: important patterns and design decisions (from node summaries and tags)
+   - **Guided Tour**: step-by-step walkthrough (from the tour section)
+   - **File Map**: what each key file does (from file-level nodes, organized by layer)
+   - **Complexity Hotspots**: areas to approach carefully (from complexity values)
+
+8. Format as clean markdown
+9. Offer to save the guide to `docs/ONBOARDING.md` in the project
+10. Suggest the user commit it to the repo for the team

assets/skills/understand-report/SKILL.md

@@ -0,0 +1,20 @@
+---
+name: understand-report
+description: Generate a progress report comparing current spec files against the most recent baseline
+argument-hint: [--baseline TIMESTAMP]
+---
+
+# /understand-report
+
+Compare current spec files against a baseline to show progress, changes, and ETA.
+
+## Usage
+- `/understand-report` — Compare with latest baseline
+- `/understand-report --baseline 20260424_153000` — Compare with specific baseline
+
+## Instructions
+
+1. Run: `python {{SCRIPTS_DIR}}/report.py`
+2. Report includes: file changes (diff), requirements count, task progress, velocity, ETA
+3. Reports are saved to `reports/{timestamp}.md`
+4. Requires at least one baseline to exist (run /understand-baseline first)

assets/skills/understand-report/report.py

@@ -0,0 +1,231 @@
+"""
+Spec Progress Report — So sánh spec hiện tại với baseline gần nhất.
+
+Phân tích:
+  - Thay đổi giữa baseline và hiện tại (diff)
+  - Tiến độ tasks (nếu có tasks.md)
+  - Dự đoán tiến độ
+
+Usage:
+  python report.py                      # So sánh với baseline gần nhất
+  python report.py --baseline 20260424_153000  # So sánh với baseline cụ thể
+"""
+import os
+import sys
+import json
+import re
+import difflib
+from datetime import datetime
+
+SCRIPT_DIR = os.path.dirname(os.path.abspath(__file__))
+SPEC_DIR = os.path.dirname(SCRIPT_DIR)
+BASELINES_DIR = os.path.join(SPEC_DIR, "baselines")
+REPORT_DIR = os.path.join(SPEC_DIR, "reports")
+os.makedirs(REPORT_DIR, exist_ok=True)
+
+SPEC_FILES = ["requirements.md", "design.md", "tasks.md", "diagrams.mermaid.md"]
+
+
+def get_latest_baseline():
+    dirs = sorted([
+        d for d in os.listdir(BASELINES_DIR)
+        if os.path.exists(os.path.join(BASELINES_DIR, d, "metadata.json"))
+    ])
+    return os.path.join(BASELINES_DIR, dirs[-1]) if dirs else None
+
+
+def read_file_safe(path):
+    if os.path.exists(path):
+        with open(path, "r", encoding="utf-8") as f:
+            return f.read()
+    return ""
+
+
+def count_lines(text):
+    return len(text.strip().split("\n")) if text.strip() else 0
+
+
+def analyze_requirements(text):
+    """Count requirements from requirements.md."""
+    matches = re.findall(r"### Yêu cầu (\d+):", text)
+    return len(matches)
+
+
+def analyze_tasks(text):
+    """Parse tasks.md for progress."""
+    if not text.strip():
+        return {"total": 0, "completed": 0, "in_progress": 0, "not_started": 0}
+
+    completed = len(re.findall(r"- \[x\]", text))
+    in_progress = len(re.findall(r"- \[-\]", text))
+    not_started = len(re.findall(r"- \[ \]", text))
+    queued = len(re.findall(r"- \[~\]", text))
+    total = completed + in_progress + not_started + queued
+
+    return {
+        "total": total,
+        "completed": completed,
+        "in_progress": in_progress,
+        "not_started": not_started,
+        "queued": queued,
+    }
+
+
+def diff_summary(old_text, new_text, filename):
+    """Generate diff summary between baseline and current."""
+    old_lines = old_text.splitlines()
+    new_lines = new_text.splitlines()
+
+    diff = list(difflib.unified_diff(old_lines, new_lines, lineterm=""))
+    added = sum(1 for l in diff if l.startswith("+") and not l.startswith("+++"))
+    removed = sum(1 for l in diff if l.startswith("-") and not l.startswith("---"))
+
+    return {
+        "filename": filename,
+        "old_lines": len(old_lines),
+        "new_lines": len(new_lines),
+        "added": added,
+        "removed": removed,
+        "changed": added + removed > 0,
+    }
+
+
+def generate_report(baseline_dir):
+    """Generate progress report comparing baseline to current."""
+    # Load baseline metadata
+    meta_path = os.path.join(baseline_dir, "metadata.json")
+    with open(meta_path, "r", encoding="utf-8") as f:
+        baseline_meta = json.load(f)
+
+    now = datetime.now()
+    baseline_time = datetime.fromisoformat(baseline_meta["timestamp"])
+    elapsed = now - baseline_time
+
+    report_lines = []
+    report_lines.append(f"# Spec Progress Report")
+    report_lines.append(f"")
+    report_lines.append(f"Generated: {now.strftime('%Y-%m-%d %H:%M:%S')}")
+    report_lines.append(f"")
+    report_lines.append(f"## Baseline Information")
+    report_lines.append(f"")
+    report_lines.append(f"| Item | Value |")
+    report_lines.append(f"|------|-------|")
+    report_lines.append(f"| Baseline | {baseline_meta['folder']} |")
+    report_lines.append(f"| Label | {baseline_meta.get('label', '-')} |")
+    report_lines.append(f"| Created | {baseline_meta['timestamp']} |")
+    report_lines.append(f"| Elapsed | {elapsed.days} days, {elapsed.seconds // 3600} hours |")
+    report_lines.append(f"")
+
+    # File changes
+    report_lines.append(f"## File Changes (Baseline → Current)")
+    report_lines.append(f"")
+    report_lines.append(f"| File | Baseline Lines | Current Lines | Added | Removed | Status |")
+    report_lines.append(f"|------|:---:|:---:|:---:|:---:|--------|")
+
+    for fname in SPEC_FILES:
+        old_text = read_file_safe(os.path.join(baseline_dir, fname))
+        new_text = read_file_safe(os.path.join(SPEC_DIR, fname))
+        d = diff_summary(old_text, new_text, fname)
+
+        if not old_text and not new_text:
+            status = "—"
+        elif not old_text:
+            status = "🆕 New"
+        elif not new_text:
+            status = "🗑️ Deleted"
+        elif d["changed"]:
+            status = "✏️ Modified"
+        else:
+            status = "✅ Unchanged"
+
+        report_lines.append(
+            f"| {fname} | {d['old_lines']} | {d['new_lines']} | +{d['added']} | -{d['removed']} | {status} |"
+        )
+
+    # Requirements analysis
+    report_lines.append(f"")
+    report_lines.append(f"## Requirements Analysis")
+    report_lines.append(f"")
+    old_req = analyze_requirements(read_file_safe(os.path.join(baseline_dir, "requirements.md")))
+    new_req = analyze_requirements(read_file_safe(os.path.join(SPEC_DIR, "requirements.md")))
+    report_lines.append(f"| Metric | Baseline | Current | Change |")
+    report_lines.append(f"|--------|:---:|:---:|:---:|")
+    report_lines.append(f"| Total Requirements | {old_req} | {new_req} | {'+' if new_req >= old_req else ''}{new_req - old_req} |")
+
+    # Task progress
+    report_lines.append(f"")
+    report_lines.append(f"## Task Progress")
+    report_lines.append(f"")
+    old_tasks = analyze_tasks(read_file_safe(os.path.join(baseline_dir, "tasks.md")))
+    new_tasks = analyze_tasks(read_file_safe(os.path.join(SPEC_DIR, "tasks.md")))
+
+    if new_tasks["total"] == 0:
+        report_lines.append(f"Tasks not yet created (tasks.md not found).")
+    else:
+        pct = (new_tasks["completed"] / new_tasks["total"] * 100) if new_tasks["total"] > 0 else 0
+        report_lines.append(f"| Status | Count | Percentage |")
+        report_lines.append(f"|--------|:---:|:---:|")
+        report_lines.append(f"| ✅ Completed | {new_tasks['completed']} | {pct:.0f}% |")
+        report_lines.append(f"| 🔄 In Progress | {new_tasks['in_progress']} | — |")
+        report_lines.append(f"| ⏳ Not Started | {new_tasks['not_started']} | — |")
+        report_lines.append(f"| 📋 Queued | {new_tasks.get('queued', 0)} | — |")
+        report_lines.append(f"| **Total** | **{new_tasks['total']}** | **{pct:.0f}%** |")
+
+        # Progress bar
+        bar_len = 30
+        filled = int(bar_len * pct / 100)
+        bar = "█" * filled + "░" * (bar_len - filled)
+        report_lines.append(f"")
+        report_lines.append(f"Progress: [{bar}] {pct:.0f}%")
+
+        # Estimate
+        if new_tasks["completed"] > old_tasks.get("completed", 0) and elapsed.total_seconds() > 0:
+            done_since = new_tasks["completed"] - old_tasks.get("completed", 0)
+            remaining = new_tasks["total"] - new_tasks["completed"]
+            rate = done_since / (elapsed.total_seconds() / 3600)  # tasks per hour
+            if rate > 0:
+                eta_hours = remaining / rate
+                report_lines.append(f"")
+                report_lines.append(f"### Estimated Completion")
+                report_lines.append(f"")
+                report_lines.append(f"| Metric | Value |")
+                report_lines.append(f"|--------|-------|")
+                report_lines.append(f"| Tasks completed since baseline | {done_since} |")
+                report_lines.append(f"| Velocity | {rate:.1f} tasks/hour |")
+                report_lines.append(f"| Remaining tasks | {remaining} |")
+                report_lines.append(f"| ETA | ~{eta_hours:.1f} hours |")
+
+    # Save report
+    report_name = f"report_{now.strftime('%Y%m%d_%H%M%S')}.md"
+    report_path = os.path.join(REPORT_DIR, report_name)
+    with open(report_path, "w", encoding="utf-8") as f:
+        f.write("\n".join(report_lines))
+
+    print(f"✅ Report: reports/{report_name}")
+    print(f"")
+    # Also print to console
+    print("\n".join(report_lines))
+    return report_path
+
+
+def main():
+    args = sys.argv[1:]
+
+    baseline_dir = None
+    if "--baseline" in args:
+        idx = args.index("--baseline")
+        if idx + 1 < len(args):
+            baseline_dir = os.path.join(BASELINES_DIR, args[idx + 1])
+
+    if not baseline_dir:
+        baseline_dir = get_latest_baseline()
+
+    if not baseline_dir or not os.path.exists(baseline_dir):
+        print("❌ No baseline found. Create one first: python baseline.py")
+        sys.exit(1)
+
+    generate_report(baseline_dir)
+
+
+if __name__ == "__main__":
+    main()

assets/skills/understand/SKILL.md

@@ -0,0 +1,187 @@
+---
+name: understand
+description: Analyze a codebase to produce a knowledge graph (knowledge-graph.json) for understanding architecture, components, and relationships
+argument-hint: ["[path] [--full]"]
+---
+
+# /understand
+
+Analyze the current codebase and produce a `knowledge-graph.json` file in `.understand-anything/`.
+
+## Quick Start
+
+If `project-understand --analyze` CLI is available, prefer using it (faster, deterministic):
+```bash
+project-understand --analyze [path]
+```
+
+Otherwise, follow the instructions below to generate the graph using AI analysis.
+
+---
+
+## Instructions
+
+### Step 1 — Determine project root
+
+- If a path argument is provided, use that directory
+- Otherwise, use the current working directory
+- Set this as `PROJECT_ROOT`
+
+### Step 2 — Check existing graph
+
+- If `.understand-anything/knowledge-graph.json` exists AND `--full` is NOT specified:
+  - Read `.understand-anything/meta.json` to get `gitCommitHash`
+  - Compare with current `git rev-parse HEAD`
+  - If same: report "Graph is up to date" and STOP
+  - If different: proceed (will do incremental update on changed files only)
+
+### Step 3 — Scan project files
+
+List all source files in the project (excluding node_modules, .git, dist, build, vendor, etc.):
+
+```bash
+find $PROJECT_ROOT -type f \
+  -not -path '*/node_modules/*' \
+  -not -path '*/.git/*' \
+  -not -path '*/dist/*' \
+  -not -path '*/build/*' \
+  -not -path '*/vendor/*' \
+  -not -path '*/__pycache__/*' \
+  -not -path '*/.next/*' \
+  -not -name '*.lock' \
+  -not -name '*.min.js' \
+  -not -name '*.min.css' \
+  -not -name '*.map' \
+  | head -200
+```
+
+Also read `package.json` or equivalent manifest for project name, description, languages, frameworks.
+
+### Step 4 — Analyze files and build graph
+
+For each source file (batch in groups of 10-20 for efficiency):
+
+1. **Read the file** content
+2. **Create a file node:**
+   ```json
+   {
+     "id": "file:<relative-path>",
+     "type": "file",
+     "name": "<filename>",
+     "filePath": "<relative-path>",
+     "summary": "<1-2 sentence description of what this file does>",
+     "tags": ["<3-5 relevant tags>"],
+     "complexity": "simple|moderate|complex"
+   }
+   ```
+3. **Create function/class nodes** for significant exports (10+ lines):
+   ```json
+   {
+     "id": "function:<path>:<name>",
+     "type": "function",
+     "name": "<name>",
+     "filePath": "<path>",
+     "summary": "<what it does>",
+     "tags": ["<tags>"],
+     "complexity": "simple|moderate|complex"
+   }
+   ```
+4. **Create edges** for relationships:
+   - `imports`: file A imports from file B
+   - `contains`: file contains a function/class
+   - `calls`: function A calls function B
+   - `depends_on`: runtime dependency
+
+### Step 5 — Identify architectural layers
+
+Group files into layers based on directory structure and purpose:
+- Each layer has: `id`, `name`, `description`, `nodeIds[]`
+- Common patterns: presentation, business logic, data access, infrastructure, config
+
+### Step 6 — Build guided tour
+
+Create 5-10 tour steps that walk through the codebase:
+- Start from entry point (main file, index, App)
+- Follow the main data flow
+- Each step: `order`, `title`, `description`, `nodeIds[]`
+
+### Step 7 — Assemble and save
+
+Write the final graph to `$PROJECT_ROOT/.understand-anything/knowledge-graph.json`:
+
+```json
+{
+  "version": "1.0.0",
+  "project": {
+    "name": "<project name>",
+    "description": "<description>",
+    "languages": ["<detected languages>"],
+    "frameworks": ["<detected frameworks>"],
+    "analyzedAt": "<ISO 8601 timestamp>",
+    "gitCommitHash": "<git rev-parse HEAD>"
+  },
+  "nodes": [...],
+  "edges": [...],
+  "layers": [...],
+  "tour": [...]
+}
+```
+
+Write metadata to `$PROJECT_ROOT/.understand-anything/meta.json`:
+```json
+{
+  "lastAnalyzedAt": "<ISO 8601 timestamp>",
+  "gitCommitHash": "<commit hash>",
+  "version": "1.0.0",
+  "analyzedFiles": <number of files>
+}
+```
+
+### Step 8 — Report
+
+Report summary:
+- Files analyzed
+- Nodes created (by type)
+- Edges created
+- Layers identified
+- Tour steps generated
+- Suggest: `project-understand --preview .understand-anything` to visualize
+
+---
+
+## Node Types
+
+| Type | ID Format | Description |
+|------|-----------|-------------|
+| file | `file:<path>` | Source code file |
+| function | `function:<path>:<name>` | Function or method |
+| class | `class:<path>:<name>` | Class or interface |
+| config | `config:<path>` | Configuration file |
+| document | `document:<path>` | Documentation file |
+| service | `service:<path>` | Dockerfile, K8s manifest |
+| pipeline | `pipeline:<path>` | CI/CD config |
+| schema | `schema:<path>` | GraphQL, Protobuf schema |
+| resource | `resource:<path>` | Terraform, CloudFormation |
+| table | `table:<path>:<name>` | Database table |
+| endpoint | `endpoint:<path>:<name>` | API endpoint |
+
+## Edge Types
+
+| Type | Weight | Description |
+|------|--------|-------------|
+| imports | 0.7 | File imports from another file |
+| contains | 1.0 | File contains function/class |
+| calls | 0.8 | Function calls another function |
+| depends_on | 0.6 | Runtime dependency |
+| configures | 0.6 | Config affects code |
+| deploys | 0.7 | Infrastructure deploys code |
+| documents | 0.5 | Doc describes code |
+| triggers | 0.6 | CI/CD triggers deployment |
+
+## Tips for Better Results
+
+- Read files in batches to stay within context limits
+- Focus on exported/public functions (skip internal helpers < 10 lines)
+- Use directory names as hints for layer assignment
+- For large projects (100+ files), focus on the most important files first
+- Always create edges for import statements — they're the backbone of the graph

assets/skills/understand/extract-structure.mjs

@@ -0,0 +1,296 @@
+#!/usr/bin/env node
+/**
+ * extract-structure.mjs
+ *
+ * Deterministic structural extraction script for the file-analyzer agent.
+ * Uses PluginRegistry (TreeSitterPlugin + non-code parsers) from @understand-anything/core
+ * to replace the LLM-generated throwaway regex scripts in Phase 1.
+ *
+ * Usage:
+ *   node extract-structure.mjs <input.json> <output.json>
+ *
+ * Input JSON:
+ *   { projectRoot, batchFiles: [{path, language, sizeLines, fileCategory}], batchImportData }
+ *
+ * Output JSON:
+ *   { scriptCompleted, filesAnalyzed, filesSkipped, results: [...] }
+ */
+
+import { createRequire } from 'node:module';
+import { dirname, resolve, join } from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { readFileSync, writeFileSync } from 'node:fs';
+
+const __dirname = dirname(fileURLToPath(import.meta.url));
+// skills/understand/ -> plugin root is two dirs up
+const pluginRoot = resolve(__dirname, '../..');
+const require = createRequire(resolve(pluginRoot, 'package.json'));
+
+// ---------------------------------------------------------------------------
+// Resolve @understand-anything/core
+// ---------------------------------------------------------------------------
+let core;
+try {
+  core = await import(require.resolve('@understand-anything/core'));
+} catch {
+  // Fallback: direct path for installed plugin cache layouts
+  core = await import(resolve(pluginRoot, 'packages/core/dist/index.js'));
+}
+
+const { TreeSitterPlugin, PluginRegistry, builtinLanguageConfigs, registerAllParsers } = core;
+
+// ---------------------------------------------------------------------------
+// Argument validation
+// ---------------------------------------------------------------------------
+const [,, inputPath, outputPath] = process.argv;
+if (!inputPath || !outputPath) {
+  process.stderr.write('Usage: node extract-structure.mjs <input.json> <output.json>\n');
+  process.exit(1);
+}
+
+// ---------------------------------------------------------------------------
+// Main
+// ---------------------------------------------------------------------------
+async function main() {
+  // Read input
+  const inputRaw = readFileSync(inputPath, 'utf-8');
+  const input = JSON.parse(inputRaw);
+  const { projectRoot, batchFiles, batchImportData } = input;
+
+  if (!projectRoot || !Array.isArray(batchFiles)) {
+    throw new Error('Invalid input: must contain projectRoot and batchFiles array');
+  }
+
+  // Create tree-sitter plugin with all configs that have WASM grammars
+  const tsConfigs = builtinLanguageConfigs.filter(c => c.treeSitter);
+  const tsPlugin = new TreeSitterPlugin(tsConfigs);
+  await tsPlugin.init();
+
+  // Create registry and register tree-sitter + all non-code parsers
+  const registry = new PluginRegistry();
+  registry.register(tsPlugin);
+  registerAllParsers(registry);
+
+  const results = [];
+  const filesSkipped = [];
+
+  for (const file of batchFiles) {
+    const absolutePath = join(projectRoot, file.path);
+
+    // Read file content
+    let content;
+    try {
+      content = readFileSync(absolutePath, 'utf-8');
+    } catch (err) {
+      filesSkipped.push(file.path);
+      continue;
+    }
+
+    // Line counts
+    const lines = content.split('\n');
+    const totalLines = lines.length;
+    const nonEmptyLines = lines.filter(l => l.trim().length > 0).length;
+
+    // Structural analysis via registry
+    let analysis = null;
+    try {
+      analysis = registry.analyzeFile(file.path, content);
+    } catch {
+      // If analysis throws, treat as degraded — still include basic metrics
+    }
+
+    // Call graph extraction (code files only)
+    let callGraph = null;
+    if (file.fileCategory === 'code' || file.fileCategory === 'script') {
+      try {
+        const cg = registry.extractCallGraph(file.path, content);
+        if (cg && cg.length > 0) {
+          callGraph = cg.map(entry => ({
+            caller: entry.caller,
+            callee: entry.callee,
+            lineNumber: entry.lineNumber,
+          }));
+        }
+      } catch {
+        // Call graph extraction failed — non-fatal
+      }
+    }
+
+    // Build result object
+    const result = buildResult(file, totalLines, nonEmptyLines, analysis, callGraph, batchImportData);
+    results.push(result);
+  }
+
+  // Write output
+  const output = {
+    scriptCompleted: true,
+    filesAnalyzed: results.length,
+    filesSkipped,
+    results,
+  };
+
+  writeFileSync(outputPath, JSON.stringify(output, null, 2), 'utf-8');
+}
+
+// ---------------------------------------------------------------------------
+// Result builder: maps StructuralAnalysis to the expected output schema
+// ---------------------------------------------------------------------------
+function buildResult(file, totalLines, nonEmptyLines, analysis, callGraph, batchImportData) {
+  const base = {
+    path: file.path,
+    language: file.language,
+    fileCategory: file.fileCategory,
+    totalLines,
+    nonEmptyLines,
+  };
+
+  if (!analysis) {
+    // No parser matched — return basic metrics only
+    base.metrics = {};
+    return base;
+  }
+
+  const isCode = file.fileCategory === 'code' || file.fileCategory === 'script' || file.fileCategory === 'markup';
+
+  // Functions (code files)
+  if (analysis.functions && analysis.functions.length > 0) {
+    base.functions = analysis.functions.map(fn => ({
+      name: fn.name,
+      startLine: fn.lineRange[0],
+      endLine: fn.lineRange[1],
+      params: fn.params || [],
+    }));
+  }
+
+  // Classes (code files)
+  if (analysis.classes && analysis.classes.length > 0) {
+    base.classes = analysis.classes.map(cls => ({
+      name: cls.name,
+      startLine: cls.lineRange[0],
+      endLine: cls.lineRange[1],
+      methods: cls.methods || [],
+      properties: cls.properties || [],
+    }));
+  }
+
+  // Exports (code files)
+  if (analysis.exports && analysis.exports.length > 0) {
+    base.exports = analysis.exports.map(exp => ({
+      name: exp.name,
+      line: exp.lineNumber,
+      isDefault: false,
+    }));
+  }
+
+  // Non-code structural data: pass through directly
+  if (analysis.sections && analysis.sections.length > 0) {
+    base.sections = analysis.sections.map(s => ({
+      heading: s.name,
+      level: s.level,
+      line: s.lineRange[0],
+    }));
+  }
+
+  if (analysis.definitions && analysis.definitions.length > 0) {
+    base.definitions = analysis.definitions.map(d => ({
+      name: d.name,
+      kind: d.kind,
+      fields: d.fields || [],
+      startLine: d.lineRange[0],
+      endLine: d.lineRange[1],
+    }));
+  }
+
+  if (analysis.services && analysis.services.length > 0) {
+    base.services = analysis.services.map(s => ({
+      name: s.name,
+      image: s.image,
+      ports: s.ports || [],
+      ...(s.lineRange ? { startLine: s.lineRange[0], endLine: s.lineRange[1] } : {}),
+    }));
+  }
+
+  if (analysis.endpoints && analysis.endpoints.length > 0) {
+    base.endpoints = analysis.endpoints.map(e => ({
+      method: e.method,
+      path: e.path,
+      startLine: e.lineRange[0],
+      endLine: e.lineRange[1],
+    }));
+  }
+
+  if (analysis.steps && analysis.steps.length > 0) {
+    base.steps = analysis.steps.map(s => ({
+      name: s.name,
+      startLine: s.lineRange[0],
+      endLine: s.lineRange[1],
+    }));
+  }
+
+  if (analysis.resources && analysis.resources.length > 0) {
+    base.resources = analysis.resources.map(r => ({
+      name: r.name,
+      kind: r.kind,
+      startLine: r.lineRange[0],
+      endLine: r.lineRange[1],
+    }));
+  }
+
+  // Call graph
+  if (callGraph && callGraph.length > 0) {
+    base.callGraph = callGraph;
+  }
+
+  // Metrics
+  const metrics = {};
+
+  // Import count from batchImportData (pre-resolved by project scanner)
+  const importPaths = batchImportData?.[file.path];
+  if (importPaths) {
+    metrics.importCount = importPaths.length;
+  } else if (analysis.imports) {
+    metrics.importCount = analysis.imports.length;
+  }
+
+  if (analysis.exports) {
+    metrics.exportCount = analysis.exports.length;
+  }
+  if (analysis.functions) {
+    metrics.functionCount = analysis.functions.length;
+  }
+  if (analysis.classes) {
+    metrics.classCount = analysis.classes.length;
+  }
+  if (analysis.sections) {
+    metrics.sectionCount = analysis.sections.length;
+  }
+  if (analysis.definitions) {
+    metrics.definitionCount = analysis.definitions.length;
+  }
+  if (analysis.services) {
+    metrics.serviceCount = analysis.services.length;
+  }
+  if (analysis.endpoints) {
+    metrics.endpointCount = analysis.endpoints.length;
+  }
+  if (analysis.steps) {
+    metrics.stepCount = analysis.steps.length;
+  }
+  if (analysis.resources) {
+    metrics.resourceCount = analysis.resources.length;
+  }
+
+  base.metrics = metrics;
+
+  return base;
+}
+
+// ---------------------------------------------------------------------------
+// Run
+// ---------------------------------------------------------------------------
+try {
+  await main();
+} catch (err) {
+  process.stderr.write(`extract-structure.mjs failed: ${err.message}\n${err.stack}\n`);
+  process.exit(1);
+}

assets/skills/understand/frameworks/django.md

@@ -0,0 +1,67 @@
+# Django Framework Addendum
+
+> Injected into file-analyzer and architecture-analyzer prompts when Django is detected.
+> Do NOT use as a standalone prompt — always appended to the base prompt template.
+
+## Django Project Structure
+
+When analyzing a Django project, apply these additional conventions on top of the base analysis rules.
+
+### Canonical File Roles
+
+| File / Pattern | Role | Tags |
+|---|---|---|
+| `manage.py` | CLI entry point for dev server, migrations, management commands | `entry-point`, `config` |
+| `*/settings.py`, `*/settings/*.py` | Project-wide configuration (DB, installed apps, middleware) | `config` |
+| `*/urls.py` | URL routing — maps URL patterns to views | `api-handler`, `routing` |
+| `*/views.py`, `*/views/*.py` | Request handlers (function-based or class-based views) | `api-handler`, `controller` |
+| `*/models.py`, `*/models/*.py` | ORM models — map to database tables | `data-model` |
+| `*/serializers.py` | DRF serializers — convert models to/from JSON | `serialization`, `api-handler` |
+| `*/forms.py` | Django forms — validation and rendering logic | `validation`, `ui` |
+| `*/admin.py` | Admin site registrations — exposes models in Django admin | `config` |
+| `*/signals.py` | Signal handlers — cross-cutting side effects on model events | `event-handler` |
+| `*/tasks.py` | Celery async task definitions | `service`, `event-handler` |
+| `*/middleware.py`, `*/middleware/*.py` | Request/response middleware classes | `middleware` |
+| `*/permissions.py` | DRF permission classes | `middleware`, `validation` |
+| `*/filters.py` | DRF filter backends | `utility` |
+| `*/migrations/*.py` | Auto-generated schema migrations — do not summarize individually | `config` |
+| `*/templates/**/*.html` | Django HTML templates | `ui` |
+| `*/templatetags/*.py` | Custom template filters and tags | `utility` |
+| `*/management/commands/*.py` | Custom management commands (`./manage.py mycommand`) | `config`, `entry-point` |
+| `wsgi.py`, `asgi.py` | WSGI/ASGI server adapter — production entry point | `config`, `entry-point` |
+| `*/apps.py` | App configuration and startup hooks (`AppConfig`) | `config` |
+| `*/tests.py`, `*/tests/*.py` | Unit and integration tests | `test` |
+
+### Edge Patterns to Look For
+
+**URL routing graph** — Create `calls` edges from `urls.py` nodes to their corresponding view nodes when `path()` or `re_path()` maps a URL pattern to a view function or class. These edges represent the HTTP routing chain.
+
+**Signal wiring** — When `signals.py` uses `post_save.connect(handler, sender=Model)` or `@receiver(post_save, sender=Model)`, create `subscribes` edges from the signal handler function to the model class. Create `publishes` edges from the model to the signal handler to show the trigger direction.
+
+**ORM relationships** — When `models.py` defines `ForeignKey`, `OneToOneField`, or `ManyToManyField`, create `depends_on` edges between the model classes with a description indicating the relationship type and cardinality.
+
+**Serializer-to-model binding** — When a DRF serializer has `model = MyModel` in its `Meta` class, create a `depends_on` edge from the serializer to the model.
+
+**View-to-serializer binding** — When a DRF ViewSet or APIView references a serializer class, create a `depends_on` edge from the view to the serializer.
+
+### Architectural Layers for Django
+
+Assign nodes to these layers when detected:
+
+| Layer ID | Layer Name | What Goes Here |
+|---|---|---|
+| `layer:api` | API Layer | `views.py`, `serializers.py`, `urls.py`, DRF ViewSets and APIViews |
+| `layer:data` | Data Layer | `models.py`, `migrations/`, database utility files |
+| `layer:service` | Service Layer | `signals.py`, `tasks.py`, custom managers, service modules |
+| `layer:ui` | UI Layer | `templates/`, `forms.py`, `templatetags/` |
+| `layer:middleware` | Middleware Layer | `middleware.py`, `permissions.py`, authentication backends |
+| `layer:config` | Config Layer | `settings.py`, `urls.py` (root), `wsgi.py`, `asgi.py`, `apps.py`, `manage.py` |
+| `layer:test` | Test Layer | `tests.py`, `tests/` directory, `conftest.py` |
+
+### Notable Patterns to Capture in languageLesson
+
+- **Fat models vs. thin views**: Django encourages business logic in model methods, keeping views thin HTTP adapters
+- **Django ORM lazy evaluation**: QuerySets are not evaluated until iterated — chain filters without DB hits
+- **Class-based views (CBVs)**: Mixins like `LoginRequiredMixin`, `PermissionRequiredMixin` compose behavior through multiple inheritance
+- **Signal anti-patterns**: Signals create invisible coupling; a signal in `signals.py` may be triggered by a `save()` call anywhere in the codebase
+- **App isolation**: Each Django app (`INSTALLED_APPS`) should be self-contained with its own models, views, urls, and migrations

assets/skills/understand/frameworks/express.md

@@ -0,0 +1,57 @@
+# Express Framework Addendum
+
+> Injected into file-analyzer and architecture-analyzer prompts when Express is detected.
+> Do NOT use as a standalone prompt — always appended to the base prompt template.
+
+## Express Project Structure
+
+When analyzing an Express project, apply these additional conventions on top of the base analysis rules.
+
+### Canonical File Roles
+
+| File / Pattern | Role | Tags |
+|---|---|---|
+| `app.js`, `app.ts` | Application entry point — creates Express app, mounts middleware and routes | `entry-point`, `config` |
+| `server.js`, `server.ts`, `index.js`, `index.ts` | Server bootstrap — starts HTTP listener, may import app | `entry-point`, `config` |
+| `routes/*.js`, `routes/*.ts` | Route definitions — map HTTP methods and paths to handlers | `api-handler`, `routing` |
+| `controllers/*.js`, `controllers/*.ts` | Request handlers — process requests, orchestrate services, return responses | `api-handler`, `service` |
+| `models/*.js`, `models/*.ts` | Data models — Mongoose schemas, Sequelize models, or plain data definitions | `data-model` |
+| `middleware/*.js`, `middleware/*.ts` | Middleware functions — authentication, logging, validation, error handling | `middleware` |
+| `services/*.js`, `services/*.ts` | Business logic — domain operations decoupled from HTTP layer | `service` |
+| `db/*.js`, `db/*.ts`, `database/*.js` | Database connection and configuration | `data-model`, `config` |
+| `config/*.js`, `config/*.ts` | Application configuration — environment variables, feature flags | `config` |
+| `validators/*.js`, `validators/*.ts` | Request validation schemas (Joi, Zod, express-validator) | `validation`, `utility` |
+| `utils/*.js`, `utils/*.ts` | Shared utility functions | `utility` |
+| `tests/*.js`, `test/*.js`, `__tests__/*.js` | Unit and integration tests | `test` |
+
+### Edge Patterns to Look For
+
+**Route mounting** — When `app.use('/api/users', usersRouter)` mounts a router, create `depends_on` edges from the main app to the router module. These edges represent the HTTP routing tree.
+
+**Middleware chain** — When `app.use(cors())`, `app.use(authMiddleware)`, or `router.use(validate)` registers middleware, create middleware edges from the app or router to the middleware function. Order matters — middleware executes in registration order.
+
+**Controller-to-service calls** — When a controller imports and calls a service function, create `depends_on` edges from the controller to the service. This represents the separation between HTTP handling and business logic.
+
+**Model relationships** — When models reference each other (Mongoose `ref`, Sequelize associations), create `depends_on` edges between model files with descriptions indicating the relationship type.
+
+### Architectural Layers for Express
+
+Assign nodes to these layers when detected:
+
+| Layer ID | Layer Name | What Goes Here |
+|---|---|---|
+| `layer:api` | API Layer | `routes/`, `controllers/`, request validators |
+| `layer:data` | Data Layer | `models/`, `db/`, migration files, seeders |
+| `layer:service` | Service Layer | `services/`, business logic modules |
+| `layer:middleware` | Middleware Layer | `middleware/`, error handlers, authentication, logging |
+| `layer:config` | Config Layer | `app.js`, `config/`, environment setup, `server.js` |
+| `layer:utility` | Utility Layer | `utils/`, `helpers/`, shared pure functions |
+| `layer:test` | Test Layer | `tests/`, `__tests__/`, `*.test.js`, `*.spec.js` |
+
+### Notable Patterns to Capture in languageLesson
+
+- **Middleware chain (req, res, next)**: Express processes requests through a pipeline of middleware functions — each receives the request, response, and a `next()` callback to pass control forward
+- **Error-handling middleware (4 params)**: Middleware with signature `(err, req, res, next)` catches errors — must be registered after all routes to act as a global error handler
+- **Router modularity**: `express.Router()` creates modular, mountable route handlers that can be composed into the main app at different path prefixes
+- **MVC pattern**: Express apps commonly separate concerns into Models (data), Views (response formatting), and Controllers (request handling)
+- **Body parsing and validation**: Request body parsing (`express.json()`, `express.urlencoded()`) and validation (Joi, Zod, express-validator) are middleware concerns applied before route handlers

assets/skills/understand/frameworks/fastapi.md

@@ -0,0 +1,58 @@
+# FastAPI Framework Addendum
+
+> Injected into file-analyzer and architecture-analyzer prompts when FastAPI is detected.
+> Do NOT use as a standalone prompt — always appended to the base prompt template.
+
+## FastAPI Project Structure
+
+When analyzing a FastAPI project, apply these additional conventions on top of the base analysis rules.
+
+### Canonical File Roles
+
+| File / Pattern | Role | Tags |
+|---|---|---|
+| `main.py`, `app.py` | Application factory — creates and configures the `FastAPI()` instance | `entry-point`, `config` |
+| `*/routers/*.py`, `*/api/*.py` | `APIRouter` modules — group related endpoints by domain | `api-handler`, `routing` |
+| `*/schemas.py`, `*/schemas/*.py` | Pydantic request/response models | `type-definition`, `serialization` |
+| `*/models.py`, `*/models/*.py` | SQLAlchemy ORM models or other DB models | `data-model` |
+| `*/dependencies.py`, `*/deps.py` | `Depends()` provider functions — shared logic injected into routes | `service`, `middleware` |
+| `*/crud.py`, `*/repository.py` | Database access layer — CRUD operations | `data-model`, `service` |
+| `*/database.py`, `*/db.py` | DB engine, session factory, connection management | `config`, `data-model` |
+| `*/config.py`, `*/settings.py` | `pydantic-settings` / `BaseSettings` config classes | `config` |
+| `*/middleware.py` | Starlette middleware classes | `middleware` |
+| `*/exceptions.py` | Custom exception classes and exception handlers | `utility` |
+| `*/security.py`, `*/auth.py` | Auth utilities — JWT decoding, password hashing, OAuth helpers | `service`, `middleware` |
+| `*/tasks.py` | Background tasks or Celery task definitions | `service`, `event-handler` |
+| `*/tests/*.py`, `test_*.py` | pytest test files | `test` |
+| `conftest.py` | pytest fixtures and test configuration | `test`, `config` |
+
+### Edge Patterns to Look For
+
+**Router inclusion chain** — When `app.include_router(some_router, prefix="/api")` appears in `main.py` or a router aggregator, create `imports` + `depends_on` edges from the main app file to each router module. This builds the URL hierarchy graph.
+
+**Dependency injection tree** — When a route function or another `Depends()` provider imports and calls `Depends(some_function)`, create `depends_on` edges from the caller to the dependency provider. Trace these chains — they often span multiple files (e.g., route → auth dependency → DB session dependency).
+
+**Pydantic model inheritance** — When a schema class inherits from another (e.g., `class UserCreate(UserBase)`), create `inherits` edges between the schema class nodes.
+
+**ORM model relationships** — When SQLAlchemy models use `relationship()`, `ForeignKey`, create `depends_on` edges between the model classes.
+
+**CRUD-to-model binding** — When a `crud.py` function takes a model type as an argument or directly references a model class, create `depends_on` edges from the CRUD file to the model file.
+
+### Architectural Layers for FastAPI
+
+| Layer ID | Layer Name | What Goes Here |
+|---|---|---|
+| `layer:api` | API Layer | Router files, endpoint functions with `@router.get/post/...` decorators |
+| `layer:types` | Types Layer | Pydantic schema files, request/response models |
+| `layer:service` | Service Layer | `dependencies.py`, `crud.py`, business logic modules |
+| `layer:data` | Data Layer | ORM models, `database.py`, migrations |
+| `layer:config` | Config Layer | `main.py` / `app.py` factory, `settings.py`, `config.py` |
+| `layer:middleware` | Middleware Layer | `middleware.py`, `security.py`, `auth.py`, exception handlers |
+| `layer:test` | Test Layer | `tests/`, `conftest.py` |
+
+### Notable Patterns to Capture in languageLesson
+
+- **Dependency injection as composition**: FastAPI's `Depends()` is a first-class DI system — a route can declare any number of dependencies, each of which can have their own dependencies, forming a tree resolved at request time
+- **Pydantic for validation**: Request bodies, query params, and path params are automatically validated by Pydantic — invalid input raises `422 Unprocessable Entity` before your code runs
+- **Async endpoints**: `async def` routes run in the event loop; `def` routes run in a threadpool — mixing them incorrectly can cause performance issues
+- **Path operation order**: FastAPI matches routes in declaration order; a catch-all route before a specific one will shadow it

assets/skills/understand/frameworks/flask.md

@@ -0,0 +1,53 @@
+# Flask Framework Addendum
+
+> Injected into file-analyzer and architecture-analyzer prompts when Flask is detected.
+> Do NOT use as a standalone prompt — always appended to the base prompt template.
+
+## Flask Project Structure
+
+When analyzing a Flask project, apply these additional conventions on top of the base analysis rules.
+
+### Canonical File Roles
+
+| File / Pattern | Role | Tags |
+|---|---|---|
+| `app.py`, `__init__.py` (in app package) | Application factory (`create_app()`) or direct `Flask(__name__)` instance | `entry-point`, `config` |
+| `run.py`, `wsgi.py` | Production/dev server entry point | `entry-point`, `config` |
+| `*/views.py`, `*/routes.py` | Route handler functions with `@app.route` or `@blueprint.route` | `api-handler`, `routing` |
+| `*/blueprints/*.py`, `*/api/*.py` | Blueprint modules — group routes by feature | `api-handler`, `routing` |
+| `*/models.py` | SQLAlchemy models or other ORM models | `data-model` |
+| `*/forms.py` | WTForms form classes | `validation`, `ui` |
+| `*/schemas.py` | Marshmallow serialization schemas | `serialization`, `type-definition` |
+| `*/config.py` | Config classes (`DevelopmentConfig`, `ProductionConfig`) | `config` |
+| `*/extensions.py` | Flask extension initialization (`db = SQLAlchemy()`, `login_manager = LoginManager()`) | `config`, `singleton` |
+| `*/decorators.py` | Custom route decorators (auth guards, rate limiting) | `middleware`, `utility` |
+| `*/utils.py`, `*/helpers.py` | Shared utility functions | `utility` |
+| `*/templates/**/*.html` | Jinja2 templates | `ui` |
+| `*/static/` | CSS, JS, and asset files | `assets` |
+| `*/tests/*.py`, `test_*.py` | pytest or unittest test files | `test` |
+
+### Edge Patterns to Look For
+
+**Blueprint registration** — When `app.register_blueprint(bp, url_prefix='/api')` appears in the application factory, create `depends_on` edges from the app factory to each blueprint module.
+
+**Extension coupling** — When a view imports from `extensions.py` (e.g., `from .extensions import db, login_manager`), create `imports` edges to show which views depend on which extensions.
+
+**Before/after request hooks** — When `@app.before_request` or `@blueprint.before_request` decorates a function, create `middleware` edges from those functions to the app/blueprint they attach to.
+
+### Architectural Layers for Flask
+
+| Layer ID | Layer Name | What Goes Here |
+|---|---|---|
+| `layer:api` | API Layer | Blueprint route files, view functions |
+| `layer:data` | Data Layer | `models.py`, database migration files |
+| `layer:service` | Service Layer | Business logic modules, `schemas.py`, service classes |
+| `layer:ui` | UI Layer | `templates/`, `forms.py`, `static/` |
+| `layer:config` | Config Layer | `app.py` factory, `config.py`, `extensions.py` |
+| `layer:middleware` | Middleware Layer | `decorators.py`, before/after request hooks |
+| `layer:test` | Test Layer | Test files, `conftest.py` |
+
+### Notable Patterns to Capture in languageLesson
+
+- **Application factory pattern**: `create_app()` functions allow multiple app instances (e.g., for testing) and delay extension initialization — avoids circular imports
+- **Blueprint modularity**: Blueprints group related routes, templates, and static files; they are registered on the app with a URL prefix, making them independently testable
+- **Flask extension protocol**: Extensions follow `init_app(app)` for lazy initialization — the extension object is created globally but bound to an app instance later

assets/skills/understand/frameworks/gin.md

@@ -0,0 +1,59 @@
+# Gin (Go) Framework Addendum
+
+> Injected into file-analyzer and architecture-analyzer prompts when Gin is detected.
+> Do NOT use as a standalone prompt — always appended to the base prompt template.
+
+## Gin Project Structure
+
+When analyzing a Gin project, apply these additional conventions on top of the base analysis rules.
+
+### Canonical File Roles
+
+| File / Pattern | Role | Tags |
+|---|---|---|
+| `main.go` | Application entry point — initializes the Gin engine, registers routes, starts the server | `entry-point`, `config` |
+| `cmd/*.go`, `cmd/**/*.go` | CLI entry points — multiple binaries in a multi-command project | `entry-point`, `config` |
+| `handlers/*.go`, `handler/*.go` | HTTP handlers — process requests with `gin.Context` | `api-handler` |
+| `controllers/*.go`, `controller/*.go` | Controllers — alternative naming for HTTP handlers | `api-handler` |
+| `routes/*.go`, `router/*.go` | Route definitions — register endpoints and route groups | `routing`, `config` |
+| `models/*.go`, `model/*.go` | Data models — struct definitions mapped to database tables | `data-model` |
+| `middleware/*.go` | Middleware functions — authentication, logging, CORS, rate limiting | `middleware` |
+| `services/*.go`, `service/*.go` | Business logic — domain operations decoupled from HTTP layer | `service` |
+| `repository/*.go`, `repo/*.go` | Data access layer — database queries and persistence logic | `data-model`, `service` |
+| `config/*.go`, `config.go` | Application configuration — environment loading, struct-based config | `config` |
+| `dto/*.go` | Data transfer objects — request and response structs | `type-definition` |
+| `utils/*.go`, `pkg/*.go` | Shared utility packages | `utility` |
+| `*_test.go` | Unit and integration tests | `test` |
+
+### Edge Patterns to Look For
+
+**Route group registration** — When `r.Group("/api")` creates a route group and registers handlers, create `configures` edges from the route definition file to each handler. Route groups organize endpoints by prefix and shared middleware.
+
+**Handler-to-service calls** — When a handler function calls a service method, create `depends_on` edges from the handler to the service. This represents the separation between HTTP handling and business logic.
+
+**Service-to-repository calls** — When a service calls a repository method for data access, create `depends_on` edges from the service to the repository. This represents the data access abstraction.
+
+**Middleware chaining** — When `r.Use(middleware)` or a route group applies middleware, create middleware edges from the router or group to the middleware function. Middleware executes in registration order.
+
+### Architectural Layers for Gin
+
+Assign nodes to these layers when detected:
+
+| Layer ID | Layer Name | What Goes Here |
+|---|---|---|
+| `layer:api` | API Layer | `handlers/`, `controllers/`, HTTP handler functions |
+| `layer:data` | Data Layer | `models/`, `repository/`, database access, migrations |
+| `layer:service` | Service Layer | `services/`, business logic |
+| `layer:middleware` | Middleware Layer | `middleware/`, authentication, logging, rate limiting |
+| `layer:config` | Config Layer | `main.go`, `routes/`, `config/`, environment setup |
+| `layer:utility` | Utility Layer | `utils/`, `pkg/`, shared helper packages |
+| `layer:test` | Test Layer | `*_test.go`, test fixtures, test helpers |
+
+### Notable Patterns to Capture in languageLesson
+
+- **Handler functions with gin.Context**: Every Gin handler receives a `*gin.Context` parameter — it provides request parsing (`c.Bind`, `c.Param`, `c.Query`), response writing (`c.JSON`, `c.HTML`), and control flow (`c.Abort`, `c.Next`)
+- **Middleware chain with c.Next()**: Middleware calls `c.Next()` to pass control to the next handler in the chain — code before `c.Next()` runs pre-handler, code after runs post-handler
+- **Route grouping for modular APIs**: `r.Group("/v1")` creates modular sub-routers that can have their own middleware stack — enables versioning and access control at the group level
+- **Dependency injection via constructors (no framework DI)**: Go has no DI framework — dependencies are passed as constructor parameters (e.g., `NewUserHandler(userService)`) and stored as struct fields
+- **Interface-driven design for testability**: Services and repositories are defined as interfaces — handlers depend on the interface, enabling mock implementations in tests
+- **Error handling with gin.Error**: Gin collects errors via `c.Error(err)` — middleware can inspect `c.Errors` after handler execution to implement centralized error logging and response formatting

assets/skills/understand/frameworks/nextjs.md

@@ -0,0 +1,59 @@
+# Next.js Framework Addendum
+
+> Injected into file-analyzer and architecture-analyzer prompts when Next.js is detected.
+> Do NOT use as a standalone prompt — always appended to the base prompt template.
+
+## Next.js Project Structure
+
+When analyzing a Next.js project, apply these additional conventions on top of the base analysis rules.
+
+### Canonical File Roles
+
+| File / Pattern | Role | Tags |
+|---|---|---|
+| `app/layout.tsx` | Root layout — wraps all pages, defines HTML shell and global providers | `entry-point`, `config`, `ui` |
+| `app/page.tsx` | Root page component — renders at `/` | `ui`, `routing` |
+| `app/**/page.tsx` | Route page components — file path determines URL | `ui`, `routing` |
+| `app/**/layout.tsx` | Nested layouts — wrap child routes with shared UI | `ui`, `config` |
+| `app/**/loading.tsx` | Loading UI — shown as Suspense fallback during route transitions | `ui` |
+| `app/**/error.tsx` | Error boundary — catches errors in the route segment | `ui` |
+| `app/**/not-found.tsx` | 404 UI — shown when `notFound()` is called | `ui` |
+| `app/api/**/route.ts` | API route handlers — serverless endpoint functions (GET, POST, etc.) | `api-handler` |
+| `middleware.ts` | Edge middleware — intercepts requests before they reach routes | `middleware` |
+| `lib/*.ts`, `lib/**/*.ts` | Shared server-side utilities, data access, and business logic | `service` |
+| `components/*.tsx`, `components/**/*.tsx` | Reusable UI components | `ui` |
+| `next.config.js`, `next.config.mjs`, `next.config.ts` | Next.js configuration — redirects, rewrites, env, webpack overrides | `config` |
+| `actions/*.ts`, `app/**/actions.ts` | Server Actions — server-side mutation functions callable from client | `service`, `api-handler` |
+
+### Edge Patterns to Look For
+
+**Layout nesting** — When `app/foo/layout.tsx` wraps `app/foo/page.tsx` and `app/foo/bar/page.tsx`, create `contains` edges from the layout to the pages it wraps. Layouts compose via the file-system hierarchy.
+
+**API route handlers** — When a `route.ts` file exports named functions (GET, POST, PUT, DELETE), create edges from consuming components or server actions to the route handler based on fetch calls.
+
+**Server/Client component boundary** — Files with `"use client"` directive at the top are Client Components. All other components in the `app/` directory are Server Components by default. Create `depends_on` edges that cross this boundary and note the boundary in the edge description.
+
+**Parallel routes** — When `app/@slot/page.tsx` patterns appear, create `contains` edges from the parent layout to each parallel slot. These render simultaneously in the same layout.
+
+**Route groups** — Directories wrapped in parentheses `(group)` organize routes without affecting the URL path. Note these in node descriptions.
+
+### Architectural Layers for Next.js
+
+Assign nodes to these layers when detected:
+
+| Layer ID | Layer Name | What Goes Here |
+|---|---|---|
+| `layer:ui` | UI Layer | `app/**/page.tsx`, `app/**/layout.tsx`, `components/`, loading/error boundaries |
+| `layer:api` | API Layer | `app/api/**/route.ts`, API route handlers |
+| `layer:service` | Service Layer | `lib/`, server actions, data-fetching utilities |
+| `layer:middleware` | Middleware Layer | `middleware.ts`, edge functions |
+| `layer:config` | Config Layer | `next.config.*`, root layout, `tailwind.config.*`, environment setup |
+| `layer:test` | Test Layer | `__tests__/`, `*.test.tsx`, `*.spec.tsx`, `e2e/` |
+
+### Notable Patterns to Capture in languageLesson
+
+- **Server Components by default**: Components in the `app/` directory are Server Components — no JavaScript is sent to the client unless `"use client"` is declared
+- **Server Actions for mutations**: Functions marked with `"use server"` can be called directly from client components, replacing traditional API routes for form submissions and mutations
+- **App Router file conventions**: Special files (`page`, `layout`, `loading`, `error`, `not-found`, `route`) define behavior by naming convention within the file-system router
+- **ISR and static generation**: `generateStaticParams` pre-renders pages at build time; revalidation strategies control cache freshness
+- **Parallel and intercepting routes**: `@slot` directories enable parallel rendering; `(.)` prefix directories enable route interception for modal patterns

assets/skills/understand/frameworks/rails.md

@@ -0,0 +1,65 @@
+# Ruby on Rails Framework Addendum
+
+> Injected into file-analyzer and architecture-analyzer prompts when Rails is detected.
+> Do NOT use as a standalone prompt — always appended to the base prompt template.
+
+## Rails Project Structure
+
+When analyzing a Ruby on Rails project, apply these additional conventions on top of the base analysis rules.
+
+### Canonical File Roles
+
+| File / Pattern | Role | Tags |
+|---|---|---|
+| `config.ru` | Rack entry point — boots the Rails application for the web server | `entry-point` |
+| `config/application.rb` | Application configuration — sets up Rails, loads gems, configures middleware | `entry-point`, `config` |
+| `app/controllers/*_controller.rb` | Controllers — handle HTTP requests, orchestrate models, render responses | `api-handler` |
+| `app/controllers/concerns/*.rb` | Controller concerns — shared controller behavior via mixins | `middleware`, `utility` |
+| `app/models/*.rb` | ActiveRecord models — map to database tables, contain validations and associations | `data-model` |
+| `app/models/concerns/*.rb` | Model concerns — shared model behavior via mixins | `utility` |
+| `app/views/**/*.erb`, `app/views/**/*.haml` | View templates — HTML rendering with embedded Ruby | `ui` |
+| `app/helpers/*_helper.rb` | View helpers — utility methods available in templates | `utility` |
+| `app/mailers/*_mailer.rb` | Action Mailer classes — send email notifications | `service` |
+| `app/jobs/*_job.rb` | Active Job classes — background job processing | `service` |
+| `app/channels/*_channel.rb` | Action Cable channels — WebSocket communication | `service` |
+| `app/serializers/*_serializer.rb` | API serializers — JSON response formatting (ActiveModelSerializers, Blueprinter) | `api-handler`, `utility` |
+| `app/services/*.rb` | Service objects — encapsulate complex business logic | `service` |
+| `db/migrate/*.rb` | Database migrations — schema changes versioned by timestamp | `config`, `data-model` |
+| `db/schema.rb`, `db/structure.sql` | Generated schema snapshot — current database structure | `data-model`, `config` |
+| `config/routes.rb` | Route definitions — maps URLs to controller actions | `routing`, `config` |
+| `config/initializers/*.rb` | Initializers — run once at boot to configure gems and services | `config` |
+| `lib/**/*.rb` | Library code — custom classes, Rake tasks, extensions | `utility`, `service` |
+| `spec/**/*_spec.rb`, `test/**/*_test.rb` | RSpec or Minitest test files | `test` |
+
+### Edge Patterns to Look For
+
+**Route-to-controller mapping** — When `config/routes.rb` defines `resources :users` or `get '/foo', to: 'bar#baz'`, create `configures` edges from the routes file to the corresponding controller. RESTful resources generate a full set of action mappings.
+
+**ActiveRecord associations** — When models define `has_many`, `belongs_to`, `has_one`, or `has_and_belongs_to_many`, create `depends_on` edges between model files with descriptions indicating the association type and direction.
+
+**Controller-to-model** — When a controller calls model methods (`User.find`, `@post.save`), create `depends_on` edges from the controller to the model. Controllers are the primary consumers of model data.
+
+**Callbacks** — When models or controllers use `before_action`, `after_save`, `before_validation`, or similar callbacks, note these as middleware-like edges. Callbacks create implicit execution paths that are not visible from the call site.
+
+### Architectural Layers for Rails
+
+Assign nodes to these layers when detected:
+
+| Layer ID | Layer Name | What Goes Here |
+|---|---|---|
+| `layer:api` | API Layer | `app/controllers/`, `app/serializers/`, API-specific controllers |
+| `layer:data` | Data Layer | `app/models/`, `db/migrate/`, `db/schema.rb` |
+| `layer:ui` | UI Layer | `app/views/`, `app/helpers/`, `app/assets/`, `app/javascript/` |
+| `layer:service` | Service Layer | `app/mailers/`, `app/jobs/`, `app/channels/`, `app/services/`, `lib/` |
+| `layer:config` | Config Layer | `config/routes.rb`, `config/initializers/`, `config/application.rb`, `config.ru` |
+| `layer:middleware` | Middleware Layer | `app/middleware/`, controller concerns, Rack middleware |
+| `layer:test` | Test Layer | `spec/`, `test/`, `*.spec.rb`, `*_test.rb` |
+
+### Notable Patterns to Capture in languageLesson
+
+- **Convention over configuration**: Rails derives routing, table names, and file locations from naming conventions — `UsersController` maps to `users_controller.rb`, handles `/users`, and queries the `users` table
+- **ActiveRecord pattern**: Models are database wrappers — each model class maps to a table, instances map to rows, and attributes map to columns with automatic type coercion
+- **Concerns for shared behavior**: `ActiveSupport::Concern` modules are mixins included in models or controllers to share validations, scopes, callbacks, and methods across classes
+- **Strong parameters for mass-assignment protection**: `params.require(:user).permit(:name, :email)` whitelists attributes — controllers must explicitly declare which fields can be set from user input
+- **RESTful resource routing**: `resources :posts` generates seven standard CRUD routes — Rails strongly encourages RESTful design where each controller maps to a resource
+- **Callbacks and observers**: `before_save`, `after_create`, and similar callbacks inject logic into the object lifecycle — they create invisible execution paths that can be difficult to trace

assets/skills/understand/frameworks/react.md

@@ -0,0 +1,55 @@
+# React Framework Addendum
+
+> Injected into file-analyzer and architecture-analyzer prompts when React is detected.
+> Do NOT use as a standalone prompt — always appended to the base prompt template.
+
+## React Project Structure
+
+When analyzing a React project, apply these additional conventions on top of the base analysis rules.
+
+### Canonical File Roles
+
+| File / Pattern | Role | Tags |
+|---|---|---|
+| `src/App.tsx` | Root application component — mounts providers, router, and top-level layout | `entry-point`, `ui` |
+| `components/*.tsx`, `components/**/*.tsx` | Reusable UI components | `ui` |
+| `hooks/*.ts`, `hooks/*.tsx` | Custom React hooks — encapsulate reusable stateful logic | `service`, `utility` |
+| `contexts/*.tsx`, `context/*.tsx` | React Context providers and consumers — shared state across component tree | `service`, `state` |
+| `pages/*.tsx`, `views/*.tsx` | Page-level components mapped to routes | `ui`, `routing` |
+| `utils/*.ts`, `helpers/*.ts` | Pure utility functions — formatting, validation, transformations | `utility` |
+| `types/*.ts`, `types/*.d.ts` | TypeScript type definitions and interfaces | `type-definition` |
+| `services/*.ts`, `api/*.ts` | API client functions and data-fetching logic | `service` |
+| `store/*.ts`, `slices/*.ts` | State management (Redux, Zustand, etc.) | `service`, `state` |
+| `constants/*.ts` | Application-wide constants and enums | `config` |
+| `__tests__/*.tsx`, `*.test.tsx`, `*.spec.tsx` | Unit and integration tests | `test` |
+
+### Edge Patterns to Look For
+
+**Component composition** — When a parent component renders a child component in its JSX return, create `contains` edges from the parent to the child. These edges represent the component tree hierarchy.
+
+**Hook usage** — When a component or hook imports and calls a custom hook (`useX`), create `depends_on` edges from the consumer to the hook module. Hooks are the primary mechanism for shared logic in React.
+
+**Context provider/consumer** — When a Context provider wraps components, create `publishes` edges from the provider to the context definition. When components call `useContext` or use a custom context hook, create `subscribes` edges from the consumer to the context.
+
+**Props drilling chains** — When props are passed through multiple component layers without being used, create `depends_on` edges along the chain to surface the coupling depth.
+
+### Architectural Layers for React
+
+Assign nodes to these layers when detected:
+
+| Layer ID | Layer Name | What Goes Here |
+|---|---|---|
+| `layer:ui` | UI Layer | `components/`, `pages/`, `views/`, layout components |
+| `layer:service` | Service Layer | `hooks/`, `contexts/`, `services/`, `api/`, `store/` |
+| `layer:types` | Types Layer | `types/`, shared TypeScript interfaces and type definitions |
+| `layer:utility` | Utility Layer | `utils/`, `helpers/`, pure functions |
+| `layer:config` | Config Layer | `App.tsx`, router configuration, provider setup, constants |
+| `layer:test` | Test Layer | `__tests__/`, `*.test.tsx`, `*.spec.tsx` |
+
+### Notable Patterns to Capture in languageLesson
+
+- **Component composition over inheritance**: React favors composing components via props and children rather than class inheritance hierarchies
+- **Custom hooks for reusable logic**: Hooks prefixed with `use` extract stateful logic into shareable modules without changing the component tree
+- **React.memo for performance**: Components wrapped in `React.memo` skip re-renders when props are unchanged — indicates performance-sensitive paths
+- **Controlled vs. uncontrolled components**: Controlled components derive state from props; uncontrolled components manage internal state via refs
+- **Render props pattern**: Components that accept a function as children or a render prop to delegate rendering decisions to the consumer

assets/skills/understand/frameworks/spring.md

@@ -0,0 +1,59 @@
+# Spring Boot Framework Addendum
+
+> Injected into file-analyzer and architecture-analyzer prompts when Spring Boot is detected.
+> Do NOT use as a standalone prompt — always appended to the base prompt template.
+
+## Spring Boot Project Structure
+
+When analyzing a Spring Boot project, apply these additional conventions on top of the base analysis rules.
+
+### Canonical File Roles
+
+| File / Pattern | Role | Tags |
+|---|---|---|
+| `*Application.java`, `*Application.kt` | Application entry point — `@SpringBootApplication` class with `main()` method | `entry-point`, `config` |
+| `*Controller.java`, `*RestController.java` | REST controllers — handle HTTP requests, delegate to services | `api-handler` |
+| `*Service.java` | Service interfaces — define business operation contracts | `service` |
+| `*ServiceImpl.java` | Service implementations — contain business logic | `service` |
+| `*Repository.java` | Spring Data repositories — data access interfaces extending JpaRepository/CrudRepository | `data-model` |
+| `*Entity.java` | JPA entities — map to database tables via `@Entity` annotation | `data-model` |
+| `*DTO.java`, `*Request.java`, `*Response.java` | Data transfer objects — request/response payloads | `type-definition` |
+| `*Config.java`, `*Configuration.java` | Configuration classes — `@Configuration` beans, security config, web config | `config` |
+| `*Filter.java` | Servlet filters — intercept requests before they reach controllers | `middleware` |
+| `*Interceptor.java` | Handler interceptors — pre/post processing around controller methods | `middleware` |
+| `*Advice.java`, `*ExceptionHandler.java` | Controller advice — global exception handling and response wrapping | `middleware` |
+| `*Mapper.java` | Object mappers — convert between entities and DTOs (MapStruct, ModelMapper) | `utility` |
+| `application.yml`, `application.properties` | Application configuration — profiles, datasource, server settings | `config` |
+| `*Test.java`, `*Tests.java`, `*IT.java` | Unit tests, integration tests | `test` |
+
+### Edge Patterns to Look For
+
+**@Autowired injection** — When a class injects a dependency via `@Autowired`, constructor injection, or `@Inject`, create `depends_on` edges from the consumer to the injected bean. Constructor injection is preferred and most common in modern Spring.
+
+**Controller-Service-Repository chain** — The canonical call chain is `@RestController` -> `@Service` -> `@Repository`. Create `depends_on` edges along this chain to show the layered architecture.
+
+**@Entity relationships** — When entities define `@OneToMany`, `@ManyToOne`, `@OneToOne`, or `@ManyToMany` annotations, create `depends_on` edges between entity classes with descriptions indicating the relationship type and direction.
+
+**@Configuration bean definitions** — When a `@Configuration` class defines `@Bean` methods, create `configures` edges from the configuration class to the types it produces. These beans become available for injection throughout the application.
+
+### Architectural Layers for Spring Boot
+
+Assign nodes to these layers when detected:
+
+| Layer ID | Layer Name | What Goes Here |
+|---|---|---|
+| `layer:api` | API Layer | `*Controller.java`, REST endpoints, API documentation |
+| `layer:service` | Service Layer | `*Service.java`, `*ServiceImpl.java`, business logic |
+| `layer:data` | Data Layer | `*Repository.java`, `*Entity.java`, JPA mappings, database migrations |
+| `layer:types` | Types Layer | `*DTO.java`, `*Request.java`, `*Response.java`, shared value objects |
+| `layer:config` | Config Layer | `*Configuration.java`, `application.yml`, security config, `*Application.java` |
+| `layer:middleware` | Middleware Layer | `*Filter.java`, `*Interceptor.java`, `*Advice.java`, security filters |
+| `layer:test` | Test Layer | `*Test.java`, `*Tests.java`, `*IT.java`, test configuration |
+
+### Notable Patterns to Capture in languageLesson
+
+- **Dependency injection via constructor injection**: Spring favors constructor injection over field injection (`@Autowired` on fields) — it makes dependencies explicit, supports immutability, and simplifies testing
+- **Layered architecture (Controller -> Service -> Repository)**: Spring Boot applications follow a strict layered pattern where controllers handle HTTP, services contain business logic, and repositories manage persistence
+- **Spring Security filter chain**: Security is implemented as a chain of servlet filters — `SecurityFilterChain` beans configure authentication, authorization, CORS, and CSRF protection
+- **JPA entity lifecycle**: Entities transition through states (transient, managed, detached, removed) — understanding this lifecycle is essential for tracing data flow through the persistence layer
+- **AOP for cross-cutting concerns**: `@Aspect` classes with `@Before`, `@After`, and `@Around` advice inject behavior at join points — used for logging, transactions (`@Transactional`), and caching (`@Cacheable`)

assets/skills/understand/frameworks/vue.md

@@ -0,0 +1,59 @@
+# Vue Framework Addendum
+
+> Injected into file-analyzer and architecture-analyzer prompts when Vue is detected.
+> Do NOT use as a standalone prompt — always appended to the base prompt template.
+
+## Vue Project Structure
+
+When analyzing a Vue project, apply these additional conventions on top of the base analysis rules.
+
+### Canonical File Roles
+
+| File / Pattern | Role | Tags |
+|---|---|---|
+| `src/App.vue` | Root application component — mounts the top-level layout and router view | `entry-point`, `ui` |
+| `src/main.ts`, `src/main.js` | Application bootstrap — creates Vue app instance, registers plugins, mounts to DOM | `entry-point`, `config` |
+| `components/*.vue`, `components/**/*.vue` | Reusable UI components | `ui` |
+| `views/*.vue`, `pages/*.vue` | Page-level components mapped to routes | `ui`, `routing` |
+| `composables/*.ts`, `composables/*.js` | Composable functions — reusable stateful logic using Composition API | `service`, `utility` |
+| `store/*.ts`, `stores/*.ts` | State management modules (Pinia stores or Vuex modules) | `service`, `state` |
+| `router/*.ts`, `router/index.ts` | Vue Router configuration — route definitions, navigation guards | `config`, `routing` |
+| `plugins/*.ts`, `plugins/*.js` | Vue plugin registrations — extend app functionality (i18n, auth, etc.) | `config` |
+| `utils/*.ts`, `helpers/*.ts` | Pure utility functions | `utility` |
+| `types/*.ts`, `types/*.d.ts` | TypeScript type definitions and interfaces | `type-definition` |
+| `api/*.ts`, `services/*.ts` | API client functions and data-fetching logic | `service` |
+| `directives/*.ts` | Custom Vue directives | `utility` |
+| `tests/*.spec.ts`, `__tests__/*.spec.ts` | Unit and integration tests | `test` |
+
+### Edge Patterns to Look For
+
+**Component parent-child** — When a parent component uses a child component in its `<template>`, create `contains` edges from the parent to the child. Template refs and slot usage further indicate composition relationships.
+
+**Composable usage** — When a component or composable imports and calls a `useX` function, create `depends_on` edges from the consumer to the composable module. Composables are the primary mechanism for shared stateful logic.
+
+**Store actions/getters** — When components or composables import and use a Pinia store (`useXStore()`), create `depends_on` edges from the consumer to the store. Store-to-store dependencies should also be captured.
+
+**Router view mapping** — When `router/index.ts` maps paths to view components, create `configures` edges from the router to each view component. Navigation guards add middleware-like edges.
+
+**Plugin registration** — When `main.ts` calls `app.use(plugin)`, create `configures` edges from the bootstrap file to each plugin.
+
+### Architectural Layers for Vue
+
+Assign nodes to these layers when detected:
+
+| Layer ID | Layer Name | What Goes Here |
+|---|---|---|
+| `layer:ui` | UI Layer | `components/`, `views/`, `pages/`, layout components |
+| `layer:service` | Service Layer | `composables/`, `store/`, `stores/`, `api/`, `services/` |
+| `layer:config` | Config Layer | `router/`, `plugins/`, `main.ts`, `App.vue`, configuration files |
+| `layer:utility` | Utility Layer | `utils/`, `helpers/`, `directives/`, pure functions |
+| `layer:test` | Test Layer | `tests/`, `__tests__/`, `*.spec.ts` |
+
+### Notable Patterns to Capture in languageLesson
+
+- **Composition API over Options API**: Modern Vue favors `setup()` and `<script setup>` with composables, replacing the Options API's data/methods/computed separation
+- **Pinia for state management**: Pinia stores provide type-safe, modular state with actions and getters — each store is independently defined and can depend on other stores
+- **Vue Router with navigation guards**: `beforeEach`, `beforeEnter`, and `afterEach` guards act as middleware for route transitions — used for authentication and data prefetching
+- **Single-file components (.vue)**: Each `.vue` file encapsulates template, script, and style in a single file — the `<script setup>` syntax is the recommended concise form
+- **Reactive refs and computed properties**: `ref()` and `reactive()` create reactive state; `computed()` derives values that auto-update — understanding reactivity is key to tracing data flow
+- **Provide/inject for deep dependency passing**: `provide()` and `inject()` pass values down the component tree without prop drilling — creates implicit dependencies that should be captured as edges

assets/skills/understand/languages/cpp.md

@@ -0,0 +1,47 @@
+# C++ Language Prompt Snippet
+
+## Key Concepts
+
+- **Templates**: Function, class, and variadic templates for generic compile-time polymorphism
+- **RAII**: Resource Acquisition Is Initialization — tie resource lifetime to object scope
+- **Smart Pointers**: `unique_ptr` (exclusive), `shared_ptr` (reference-counted), `weak_ptr` (non-owning)
+- **Move Semantics**: Rvalue references (`&&`) and `std::move` for efficient resource transfer
+- **Operator Overloading**: Define custom behavior for operators on user-defined types
+- **Virtual Functions and Vtable**: Runtime polymorphism through virtual method dispatch tables
+- **Namespaces**: Organize symbols and prevent name collisions across translation units
+- **Constexpr**: Compile-time evaluation of functions and variables for zero-runtime-cost computation
+- **Lambda Expressions**: Anonymous functions with capture lists for closures
+- **STL Containers and Algorithms**: Standard containers (vector, map, set) and generic algorithms
+- **Concepts (C++20)**: Named constraints on template parameters replacing SFINAE patterns
+
+## Import Patterns
+
+- `#include <system_header>` — include standard library or system headers
+- `#include "local_header.h"` — include project-local header files
+- `using namespace std` — bring all names from std into scope (avoid in headers)
+- `using std::vector` — selectively bring specific names into scope
+
+## File Patterns
+
+- `.h` / `.hpp` — header files containing declarations, templates, and inline definitions
+- `.cpp` / `.cc` — implementation files with function definitions and static data
+- `CMakeLists.txt` — CMake build system configuration
+- `Makefile` — Make-based build rules and targets
+- `main.cpp` — program entry point containing `int main()`
+
+## Common Frameworks
+
+- **Qt** — Cross-platform application framework with signal/slot mechanism
+- **Boost** — Extensive collection of peer-reviewed portable libraries
+- **Catch2** — Header-only testing framework with BDD-style syntax
+- **Google Test** — Testing framework with fixtures, assertions, and mocking
+- **gRPC** — High-performance RPC framework for service communication
+
+## Example Language Notes
+
+> Uses `std::unique_ptr<T>` for RAII-based ownership, ensuring deterministic cleanup
+> when scope exits. The unique pointer cannot be copied, only moved, making ownership
+> transfer explicit and preventing accidental double-free errors.
+>
+> Header/implementation separation (`.h`/`.cpp`) controls compilation boundaries —
+> changes to a `.cpp` file only recompile that translation unit, not all includers.

assets/skills/understand/languages/csharp.md

@@ -0,0 +1,46 @@
+# C# Language Prompt Snippet
+
+## Key Concepts
+
+- **LINQ Queries**: Language-integrated queries using method syntax (`.Where().Select()`) or query syntax
+- **Async/Await with Task**: Asynchronous programming model returning `Task<T>` for non-blocking I/O
+- **Generics and Constraints**: Type parameters with `where T : class, IDisposable` constraint clauses
+- **Properties (get/set)**: First-class property syntax with backing fields, auto-properties, and init-only
+- **Delegates and Events**: Type-safe function pointers; events provide publisher-subscriber pattern
+- **Attributes**: Metadata annotations (`[HttpGet]`, `[Authorize]`) for declarative configuration
+- **Nullable Reference Types**: Compiler-enforced null safety with `?` annotations (C# 8+)
+- **Pattern Matching**: `is`, `switch` expressions with type, property, and relational patterns
+- **Records and Init-Only Setters**: Immutable reference types with value equality semantics (C# 9+)
+- **Dependency Injection (Built-in)**: First-class DI container in ASP.NET Core (`IServiceCollection`)
+
+## Import Patterns
+
+- `using System.Collections.Generic` — import a namespace for unqualified type access
+- `using static System.Math` — import static members for direct method access
+- `global using` — file-scoped usings applied to the entire project (C# 10)
+- `using Alias = Namespace.Type` — type alias for disambiguation
+
+## File Patterns
+
+- `*.csproj` — MSBuild project file defining targets, packages, and build properties
+- `*.sln` — Visual Studio solution file grouping multiple projects
+- `Program.cs` — application entry point (top-level statements in .NET 6+)
+- `Startup.cs` — service and middleware configuration (older ASP.NET Core pattern)
+- `appsettings.json` — hierarchical application configuration
+
+## Common Frameworks
+
+- **ASP.NET Core** — Cross-platform web framework for APIs, MVC, and Razor Pages
+- **Entity Framework** — ORM with LINQ-to-SQL, migrations, and change tracking
+- **Blazor** — Component-based UI framework using C# instead of JavaScript
+- **MAUI** — Cross-platform native UI for mobile and desktop applications
+- **xUnit** — Modern testing framework with theories, facts, and dependency injection
+
+## Example Language Notes
+
+> Uses LINQ method syntax `.Where().Select()` to compose a query pipeline over the
+> collection. LINQ operations are lazily evaluated — the query only executes when
+> results are enumerated, allowing efficient composition without intermediate allocations.
+>
+> The built-in DI container in ASP.NET Core registers services in `Program.cs` and
+> resolves them via constructor injection, following the composition root pattern.

assets/skills/understand/languages/css.md

@@ -0,0 +1,37 @@
+# CSS Language Prompt Snippet
+
+## Key Concepts
+
+- **Selectors**: Element, class (`.name`), ID (`#name`), attribute (`[attr]`), and pseudo-class (`:hover`) targeting
+- **Specificity**: Inline > ID > Class > Element cascade priority determining which rules win
+- **Box Model**: `margin`, `border`, `padding`, `content` dimensions controlling element sizing
+- **Flexbox**: `display: flex` with `justify-content`, `align-items` for one-dimensional layouts
+- **Grid**: `display: grid` with `grid-template-columns/rows` for two-dimensional layouts
+- **Custom Properties (Variables)**: `--name: value` with `var(--name)` for reusable design tokens
+- **Media Queries**: `@media (max-width: ...)` for responsive design breakpoints
+- **SCSS/Sass Features**: Nesting, `$variables`, `@mixin`, `@include`, `@extend`, `@use`, `@forward`
+- **CSS Modules**: Scoped class names (`.module.css`) preventing global style collisions
+- **Cascade Layers**: `@layer` for explicit control over cascade ordering
+
+## Notable File Patterns
+
+- `*.css` — Standard CSS stylesheets
+- `*.scss` / `*.sass` — Sass/SCSS preprocessor files
+- `*.less` — Less preprocessor files
+- `*.module.css` / `*.module.scss` — CSS Modules (scoped styles)
+- `globals.css` / `reset.css` / `normalize.css` — Global base styles
+- `tailwind.config.js` — Tailwind CSS configuration (though a JS file)
+- `variables.scss` / `_variables.scss` — Design token definitions
+
+## Edge Patterns
+
+- CSS files are `related` to the HTML or component files that import them for styling
+- SCSS partial files (`_*.scss`) are `depends_on` by the main stylesheet that `@use`s them
+- CSS variable definition files are `related` to all stylesheets that reference those variables
+- CSS Modules are `related` to the component files that import them
+
+## Summary Style
+
+> "Global stylesheet defining CSS custom properties for the design system color palette and typography."
+> "Responsive layout styles with flexbox and grid for the dashboard page across 3 breakpoints."
+> "SCSS partial defining shared mixins for spacing, shadows, and media query breakpoints."

assets/skills/understand/languages/dockerfile.md

@@ -0,0 +1,34 @@
+# Dockerfile Language Prompt Snippet
+
+## Key Concepts
+
+- **Multi-Stage Builds**: Multiple `FROM` statements to separate build and runtime stages, reducing image size
+- **Layer Caching**: Each instruction creates a layer; order instructions from least to most frequently changing for cache efficiency
+- **Base Images**: `FROM image:tag` selects the starting image; prefer slim/alpine variants for smaller images
+- **COPY vs ADD**: `COPY` for local files (preferred), `ADD` for URLs and tar extraction
+- **Build Arguments**: `ARG` for build-time variables, `ENV` for runtime environment variables
+- **Health Checks**: `HEALTHCHECK` instruction for container orchestrator readiness probes
+- **Entry Point vs CMD**: `ENTRYPOINT` sets the executable, `CMD` provides default arguments
+- **User Permissions**: `USER` instruction to run as non-root for security
+- **Ignore Patterns**: `.dockerignore` excludes files from the build context (like `.gitignore`)
+
+## Notable File Patterns
+
+- `Dockerfile` — Primary container image definition (at project root)
+- `Dockerfile.dev` / `Dockerfile.prod` — Environment-specific Dockerfiles
+- `docker-compose.yml` — Multi-container application orchestration
+- `docker-compose.override.yml` — Local development overrides
+- `.dockerignore` — Build context exclusion patterns
+
+## Edge Patterns
+
+- Dockerfile `deploys` the application entry point it packages (COPY/CMD target)
+- docker-compose `depends_on` Dockerfile(s) it references for building
+- Dockerfile `depends_on` package manifests (package.json, requirements.txt) it copies for dependency installation
+- docker-compose services create `related` edges between co-deployed components
+
+## Summary Style
+
+> "Multi-stage Docker build producing a minimal Node.js production image with N build stages."
+> "Docker Compose configuration orchestrating N services with shared networking and persistent volumes."
+> "Development Dockerfile with hot-reload support and mounted source volumes."

assets/skills/understand/languages/go.md

@@ -0,0 +1,47 @@
+# Go Language Prompt Snippet
+
+## Key Concepts
+
+- **Goroutines**: Lightweight concurrent functions launched with `go` keyword
+- **Channels**: Typed conduits for communication and synchronization between goroutines
+- **Interfaces**: Implicitly satisfied contracts — no `implements` keyword needed
+- **Struct Embedding**: Composition mechanism providing field and method promotion
+- **Error Handling**: Explicit error return values (`error` interface) instead of exceptions
+- **Defer/Panic/Recover**: Deferred cleanup, unrecoverable errors, and recovery mechanism
+- **Slices vs Arrays**: Arrays are fixed-size values; slices are dynamic views backed by arrays
+- **Pointers**: Explicit pointer types for pass-by-reference semantics (no pointer arithmetic)
+- **Context Propagation**: `context.Context` carries deadlines, cancellation, and request-scoped values
+- **Init Functions**: Package-level `init()` runs automatically before `main()` for setup
+
+## Import Patterns
+
+- `import "package"` — single package import
+- `import alias "package"` — aliased import to avoid name conflicts
+- `import ( ... )` — grouped import block (standard library, then external, then internal)
+- `import _ "package"` — blank import for side effects only (e.g., driver registration)
+
+## File Patterns
+
+- `*_test.go` — test files in the same package (or `_test` package for black-box tests)
+- `cmd/` — directory containing main packages (binary entry points)
+- `internal/` — packages only importable by parent module (enforced by compiler)
+- `pkg/` — public library packages (convention, not enforced)
+- `go.mod` — module definition with dependency versions
+- `go.sum` — cryptographic checksums for dependencies
+
+## Common Frameworks
+
+- **Gin** — High-performance HTTP framework with middleware support
+- **Echo** — Minimalist web framework with built-in middleware
+- **Fiber** — Express-inspired framework built on fasthttp
+- **Chi** — Lightweight, composable HTTP router
+- **GORM** — ORM library with associations, hooks, and migrations
+
+## Example Language Notes
+
+> Implements `io.Reader` interface implicitly — no explicit declaration needed, just
+> matching method signatures. This enables any type with a `Read([]byte) (int, error)`
+> method to be used wherever `io.Reader` is expected.
+>
+> The `internal/` directory enforces encapsulation at the compiler level, preventing
+> external packages from importing implementation details — stronger than naming convention.