npm - @fcon-tech/portolan - Versions diffs - 0.4.5 - Mend

@fcon-tech/portolan 0.4.5

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (59) hide show

package/LICENSE +21 -0
package/README.md +110 -0
package/adapters/README.md +226 -0
package/adapters/omp/portolan-mcp +19 -0
package/adapters/opencode/expedition-launcher +70 -0
package/adapters/opencode/install.test.ts +105 -0
package/adapters/opencode/install.ts +357 -0
package/adapters/pi/portolan-mcp +19 -0
package/adapters/scheduling/night-watch.cron +23 -0
package/core/schema/chart.schema.json +154 -0
package/core/src/bin/portolan.ts +84 -0
package/core/src/chart-io.rollback-fixture.ts +55 -0
package/core/src/chart-io.ts +121 -0
package/core/src/chart-store.ts +137 -0
package/core/src/chartroom/cli.ts +63 -0
package/core/src/chartroom/render.ts +213 -0
package/core/src/chartroom/review-template.html +232 -0
package/core/src/chartroom/review.ts +109 -0
package/core/src/chartroom/template.html +1090 -0
package/core/src/fan-in.ts +84 -0
package/core/src/harbor/chat-format.ts +154 -0
package/core/src/harbor/cli.ts +178 -0
package/core/src/harbor/errors.ts +22 -0
package/core/src/harbor/fingerprint.ts +29 -0
package/core/src/harbor/history.ts +178 -0
package/core/src/harbor/launcher.ts +155 -0
package/core/src/harbor/night-policy.ts +64 -0
package/core/src/harbor/proposals.ts +324 -0
package/core/src/harbor/run.ts +72 -0
package/core/src/harbor/settings.ts +108 -0
package/core/src/harbor/snapshot.ts +187 -0
package/core/src/harbor/watch.ts +103 -0
package/core/src/index.ts +28 -0
package/core/src/notices.ts +117 -0
package/core/src/perimeter.ts +44 -0
package/core/src/server/adapter-boundary.ts +66 -0
package/core/src/server/main.ts +27 -0
package/core/src/server/registry.ts +609 -0
package/core/src/server/server.ts +123 -0
package/core/src/server/test-harness.ts +161 -0
package/core/src/sheets.ts +151 -0
package/core/src/staleness.ts +203 -0
package/core/src/tools/log.ts +215 -0
package/core/src/tools/manifests.ts +912 -0
package/core/src/tools/neighborhood.ts +423 -0
package/core/src/tools/shared.ts +72 -0
package/core/src/tools/sound.ts +634 -0
package/core/src/tools/sweep.ts +198 -0
package/core/src/tools/symbols.ts +176 -0
package/core/src/tools/trust-report.ts +193 -0
package/core/src/types.ts +162 -0
package/core/src/validate.ts +106 -0
package/package.json +34 -0
package/skill/SKILL.md +279 -0
package/skill/examples/sailing-directions-example.md +35 -0
package/skill/sailing-directions.template.md +59 -0
package/skill/verify/checks.ts +476 -0
package/skill/verify/dry-run.ts +738 -0
package/skill/verify/fixture.ts +128 -0

package/core/src/chartroom/template.html ADDED Viewed

@@ -0,0 +1,1090 @@
+<!doctype html>
+<html lang="en">
+<head>
+<meta charset="utf-8">
+<meta name="viewport" content="width=device-width, initial-scale=1">
+<title>Chart Room</title>
+<style>
+  :root{
+    --paper:#e7dfc8; --panel:#eadfc4; --ink:#33291c; --ink-soft:#6b5a3e;
+    --water:#b9cfc6; --halo1:#cfdcd2; --halo2:#dfe3d3;
+    --island:#ecddb0; --island-edge:#8a744e; --island-ink:#4a3b26;
+    --danger:#8a3226; --poe:#274a63;
+    --lane-measured:#25505e; --lane-charted:#4f7f8d;
+    --lane-reported:#5f8886; --lane-doubtful:#98aaa4;
+    --frame:#6b5a3e; --accent:#7a2f22;
+    --chipbg:#efe6d0; --halotext:#e7dfc8; --sea-tex:#9dbfb4;
+    --font-map:Georgia,'Iowan Old Style','Times New Roman',serif;
+    --font-ui:Georgia,serif;
+  }
+  body.eng{
+    --paper:#0f151b; --panel:#141c24; --ink:#e7edf1; --ink-soft:#9fb1bd;
+    --water:#131c24; --halo1:#1a2833; --halo2:#16222c;
+    --island:#20303e; --island-edge:#3d586d; --island-ink:#cfe0ea;
+    --danger:#e08573; --poe:#7fb6d9;
+    --lane-measured:#4fd0c8; --lane-charted:#35788a;
+    --lane-reported:#4f7d8c; --lane-doubtful:#39505c;
+    --frame:#3d586d; --accent:#e08573;
+    --chipbg:#0f151b; --halotext:#0f151b; --sea-tex:#1b2733;
+    --font-map:'Segoe UI',system-ui,sans-serif;
+    --font-ui:'Segoe UI',system-ui,sans-serif;
+  }
+  *{box-sizing:border-box}
+  html,body{height:100%}
+  body{margin:0;background:var(--paper);color:var(--ink);font-family:var(--font-ui);
+       display:flex;flex-direction:column;transition:background .2s}
+  header#topbar{display:flex;align-items:baseline;gap:14px;padding:10px 18px 6px;
+       border-bottom:2px solid var(--frame)}
+  #title{font-variant:small-caps;letter-spacing:.14em;font-weight:700;font-size:19px}
+  #province{font-weight:400;letter-spacing:.02em;color:var(--ink-soft);font-size:15px}
+  #topbar .spacer{flex:1}
+  #filters{display:flex;gap:6px;align-items:center;flex-wrap:wrap}
+  #findBox{font:inherit;font-size:13px;padding:4px 10px;border:1.5px solid var(--frame);
+       border-radius:3px;background:var(--chipbg);color:var(--ink);width:170px}
+  #findBox:focus-visible{outline:2px solid var(--accent);outline-offset:1px}
+  .chip{font:inherit;font-size:11.5px;padding:3px 9px;border:1.5px solid var(--frame);
+       border-radius:11px;background:transparent;color:var(--ink);cursor:pointer}
+  .chip[aria-pressed="true"],.chip.on{background:var(--lane-measured);border-color:var(--lane-measured);
+       color:#fff}
+  .chip:hover{background:var(--panel)}
+  #map .dimmed{opacity:.16}
+  #map .dimmed text.lbl{opacity:.35}
+  #modeBtn{font:inherit;font-size:13px;padding:5px 14px;border:1.5px solid var(--frame);
+       border-radius:3px;background:transparent;color:var(--ink);cursor:pointer}
+  #modeBtn:hover{background:var(--panel)}
+  #modeBtn:focus-visible{outline:2px solid var(--accent);outline-offset:2px}
+  #stage{flex:1;display:flex;min-height:0}
+  #mapwrap{flex:1;min-width:0;position:relative;cursor:grab}
+  #mapwrap.panning{cursor:grabbing}
+  svg#map{width:100%;height:100%;display:block}
+  aside#panel{width:520px;flex:none;overflow-y:auto;padding:14px 16px 24px;
+       border-left:2px solid var(--frame);background:var(--panel)}
+  aside#panel h2{margin:2px 0 8px;font-variant:small-caps;letter-spacing:.1em;font-size:16px}
+  aside#panel h3{margin:14px 0 6px;font-size:14px;font-variant:small-caps;letter-spacing:.08em;
+       border-bottom:1px solid var(--frame);padding-bottom:2px}
+  aside#panel p{font-size:13px;line-height:1.5;margin:6px 0}
+  aside#panel li{font-size:13px;line-height:1.45;margin:4px 0}
+  aside#panel code{font-family:ui-monospace,Menlo,Consolas,monospace;font-size:11.5px;
+       background:rgba(127,127,127,.12);padding:0 3px;border-radius:2px}
+  .trustbar{display:flex;height:14px;border:1px solid var(--frame);border-radius:2px;overflow:hidden;margin:6px 0 2px}
+  .trustbar div{height:100%}
+  .trustkey{display:flex;flex-wrap:wrap;gap:4px 14px;font-size:11.5px;color:var(--ink-soft);margin-bottom:6px}
+  .trustkey b{color:var(--ink);font-weight:600}
+  .statline{font-size:12.5px;color:var(--ink-soft);margin:4px 0}
+  .dossier-head{display:flex;align-items:baseline;gap:10px;flex-wrap:wrap}
+  .dossier-head h2{margin:0}
+  .closebtn{margin-left:auto;font:inherit;font-size:12px;border:1px solid var(--frame);
+       background:transparent;color:var(--ink);border-radius:3px;padding:2px 10px;cursor:pointer}
+  .badge{display:inline-block;font-size:11px;letter-spacing:.04em;border:1px solid var(--frame);
+       border-radius:9px;padding:1px 8px;color:var(--ink-soft)}
+  .badge.trust{border-color:var(--lane-measured);color:var(--lane-measured);font-weight:600}
+  .anchors{margin:2px 0 4px;padding:0;list-style:none}
+  .anchors li{font-family:ui-monospace,Menlo,Consolas,monospace;font-size:10.5px;color:var(--ink-soft);
+       white-space:nowrap;overflow:hidden;text-overflow:ellipsis}
+  .fwrow{display:flex;gap:8px;font-size:12.5px;align-items:baseline}
+  .fwrow .t{flex:1;min-width:0;overflow:hidden;text-overflow:ellipsis;white-space:nowrap}
+  .fwrow .tr{font-size:10.5px;color:var(--ink-soft)}
+  .ledger{display:flex;gap:8px;margin:8px 0 2px}
+  .lamp{flex:1;border:1.5px solid var(--frame);border-radius:4px;padding:6px 8px;text-align:center}
+  .lamp .n{font-size:17px;font-weight:700;display:block;line-height:1.1}
+  .lamp .t{font-size:9px;letter-spacing:.1em;display:block;margin-top:2px}
+  .lamp.observed{border-color:var(--lane-measured)} .lamp.observed .t{color:var(--lane-measured)}
+  .lamp.verified{border-color:#1d6b46} .lamp.verified .t{color:#1d6b46}
+  .lamp.declared{border-color:var(--poe)} .lamp.declared .t{color:var(--poe)}
+  .lamp.claimed{border-color:var(--accent)} .lamp.claimed .t{color:var(--accent)}
+  .ledger-note{font-size:10px;color:var(--ink-soft);margin:3px 0 0}
+  .fwrow .snd{font-size:9.5px;color:#1d6b46;font-weight:600}
+  .notice{margin:7px 0;border-left:2px solid var(--frame);padding-left:9px}
+  .notice .nact{font-size:10.5px;font-weight:700;letter-spacing:.05em;margin-right:6px}
+  .notice .nnote{font-size:12px;color:var(--ink-soft);margin-top:2px}
+  .notice code{font-size:11px}
+  /* map svg */
+  .nautical-only{transition:opacity .2s}
+  body.eng .nautical-only{opacity:0;pointer-events:none}
+  body.eng #world{display:none}
+  body.eng .maponly{display:none}
+  body:not(.eng) #graphview{display:none}
+  body:not(.eng) .engonly{display:none}
+  /* graph view */
+  .gnode{cursor:pointer}
+  .gnode .box{fill:var(--island);stroke:var(--island-edge);stroke-width:1.6}
+  .gnode:hover .box{stroke-width:2.8}
+  .gnode .gname{fill:var(--island-ink);font-size:13px;font-family:var(--font-map)}
+  .gnode .gbadge{fill:var(--ink-soft);font-size:10px;font-family:var(--font-map)}
+  .gedge{fill:none;stroke-linecap:round}
+  .gedge:hover{stroke-width:4}
+  .gnode{transition:opacity .15s}
+  #map.blasting .gnode:not(.lit):not(.lit2){opacity:.22}
+  #map.blasting .gedge:not(.lit):not(.lit2){opacity:.1}
+  text.lbl{font-family:var(--font-map);fill:var(--ink);paint-order:stroke;
+       stroke:var(--halotext);stroke-width:3px;stroke-linejoin:round;pointer-events:none}
+  text.lbl.big{font-style:italic;font-size:23px;font-weight:600}
+  text.lbl.mid{font-style:italic;font-size:17.5px;font-weight:500}
+  text.lbl.small{font-size:11.5px;font-weight:600;letter-spacing:.07em;text-transform:uppercase}
+  .island{cursor:pointer}
+  .island .coast{fill:var(--island);stroke:var(--island-edge);stroke-width:2.2}
+  .island:hover .coast{stroke-width:3.6}
+  .island.edgeless .coast{stroke-dasharray:1 5;stroke-linecap:round}
+  .lane{fill:none;stroke-linecap:round;transition:opacity .15s}
+  .lane:hover{stroke-width:4}
+  .casing{pointer-events:none}
+  #map.blasting .casing{opacity:.25}
+  #map.blasting .island:not(.lit):not(.lit2){opacity:.22}
+  #map.blasting .island:not(.lit):not(.lit2) text{opacity:.4}
+  #map.blasting .lane:not(.lit):not(.lit2){opacity:.1}
+  .island{transition:opacity .15s}
+  text.marginal{font-family:var(--font-map);fill:var(--ink-soft)}
+  text.cartouche-main{font-family:var(--font-map);fill:var(--ink);letter-spacing:.22em;
+       font-variant:small-caps;font-weight:700}
+  text.dragon{font-family:var(--font-map);font-style:italic;fill:var(--ink-soft);letter-spacing:.12em}
+</style>
+</head>
+<body>
+<header id="topbar">
+  <div id="title">Chart Room</div>
+  <div id="province"></div>
+  <div class="spacer"></div>
+  <div id="filters" role="group" aria-label="Filters">
+    <input id="findBox" type="search" placeholder="find vessel…" autocomplete="off">
+    <span id="trustChips"></span>
+    <button class="chip" id="dangerChip" type="button" aria-pressed="false">dangers only</button>
+    <button class="chip" id="resetChip" type="button">reset</button>
+  </div>
+  <button id="modeBtn" type="button">Engineering mode</button>
+</header>
+<div id="stage">
+  <div id="mapwrap">
+    <svg id="map" viewBox="0 0 1880 1340" role="img" aria-label="Archipelago map of the charted province">
+      <defs>
+        <filter id="paperTex" x="0" y="0" width="100%" height="100%">
+          <feTurbulence type="fractalNoise" baseFrequency="0.012 0.016" numOctaves="4" seed="41" result="n"/>
+          <feDiffuseLighting in="n" lighting-color="#ffffff" surfaceScale="2.2">
+            <feDistantLight azimuth="235" elevation="58"/>
+          </feDiffuseLighting>
+        </filter>
+        <filter id="coastWobble" x="-8%" y="-8%" width="116%" height="116%">
+          <feTurbulence type="fractalNoise" baseFrequency="0.05" numOctaves="2" seed="7" result="w"/>
+          <feDisplacementMap in="SourceGraphic" in2="w" scale="2.4"/>
+        </filter>
+        <pattern id="staleHatch" width="7" height="7" patternTransform="rotate(45)" patternUnits="userSpaceOnUse">
+          <line x1="0" y1="0" x2="0" y2="7" stroke="var(--accent)" stroke-width="1.4" opacity=".55"/>
+        </pattern>
+        <marker id="arrow" viewBox="0 0 10 10" refX="8" refY="5" markerWidth="5.5" markerHeight="5.5" orient="auto-start-reverse">
+          <path d="M0,1 L9,5 L0,9 z" fill="context-stroke"/>
+        </marker>
+        <clipPath id="frameClip">
+          <rect x="42" y="42" width="1796" height="1256"/>
+        </clipPath>
+      </defs>
+      <rect id="sea" x="0" y="0" width="1880" height="1340" fill="var(--water)"/>
+      <g clip-path="url(#frameClip)">
+        <rect id="seaTex" x="0" y="0" width="1880" height="1340" filter="url(#paperTex)" opacity="0.5" class="nautical-only"/>
+        <g id="viewport">
+          <g id="world">
+            <g id="rhumbs" class="nautical-only"></g>
+            <g id="halos"></g>
+            <g id="lanes"></g>
+            <g id="islands"></g>
+            <g id="marks"></g>
+            <g id="labels"></g>
+            <g id="plate" style="pointer-events:none"></g>
+          </g>
+          <g id="graphview"></g>
+        </g>
+      </g>
+      <g id="margin"></g>
+    </svg>
+  </div>
+  <aside id="panel">
+    <div id="briefing"></div>
+    <div id="dossier" hidden></div>
+  </aside>
+</div>
+<script>
+"use strict";
+const DATA = __CHART_DATA__;
+const BRIEF = __BRIEF_HTML__;
+const META = __META__;
+const NOTICES = DATA.notices || [];
+const TANGLES = DATA.tangles || [];
+/* ---------- deterministic randomness ---------- */
+function mulberry32(a){return function(){a|=0;a=a+0x6D2B79F5|0;let t=Math.imul(a^a>>>15,1|a);
+  t=t+Math.imul(t^t>>>7,61|t)^t;return((t^t>>>14)>>>0)/4294967296}}
+function hashStr(s){let h=2166136261;for(let i=0;i<s.length;i++){h^=s.charCodeAt(i);
+  h=Math.imul(h,16777619)}return h>>>0}
+const SEED = hashStr(JSON.stringify(DATA.entries.map(e=>e.id).sort())+DATA.entries.length);
+/* ---------- lexicon ---------- */
+const LEX = {
+  nautical:{vessel:"Vessel",fairway:"Fairway",danger:"Danger",poe:"Port of entry",
+    beacon:"Beacon",light:"Light",unsurveyed:"Unsurveyed",hub:"dependents",
+    chartroom:"CHART ROOM",blastr:"Blast radius"},
+  eng:{vessel:"Component",fairway:"Dependency",danger:"Risk",poe:"Entry point",
+    beacon:"Config surface",light:"API contract",unsurveyed:"Unknown",hub:"dependents",
+    chartroom:"SYSTEM MAP",blastr:"Impact set"}
+};
+let mode = localStorage.getItem("chartroom.mode") || "nautical";
+function lex(k){return LEX[mode][k]}
+/* ---------- chart model ---------- */
+const entries = DATA.entries;
+const vessels = entries.filter(e=>e.kind==="vessel");
+const fairways = entries.filter(e=>e.kind==="fairway");
+const dangers  = entries.filter(e=>e.kind==="danger");
+const poes     = entries.filter(e=>e.kind==="portOfEntry");
+const beacons  = entries.filter(e=>e.kind==="beacon");
+const lights   = entries.filter(e=>e.kind==="light");
+const byId = new Map(vessels.map(v=>[v.id,v]));
+const TRUSTS = ["measured","charted","reported","doubtful","unsurveyed"];
+const TRUST_RANK = {measured:0,charted:1,reported:2,doubtful:3,unsurveyed:4};
+const fanIn = new Map(), fanOut = new Map();
+vessels.forEach(v=>{fanIn.set(v.id,0);fanOut.set(v.id,0)});
+fairways.forEach(f=>{if(fanOut.has(f.from))fanOut.set(f.from,fanOut.get(f.from)+1);
+                     if(fanIn.has(f.to))fanIn.set(f.to,fanIn.get(f.to)+1)});
+const depAdj = new Map(); // reverse: to -> [from]
+fairways.forEach(f=>{if(!depAdj.has(f.to))depAdj.set(f.to,[]);depAdj.get(f.to).push(f.from)});
+function dependents(id){ // transitive
+  const seen=new Set(),q=[id];
+  while(q.length){const x=q.pop();(depAdj.get(x)||[]).forEach(d=>{if(!seen.has(d)){seen.add(d);q.push(d)}})}
+  return seen}
+const GOD_HUB = 5;
+const godHubs = vessels.filter(v=>fanIn.get(v.id)>=GOD_HUB);
+const poeVessels = new Set(poes.map(p=>p.vessel));
+function filesOf(v){return (v.signature&&v.signature.files)||1}
+/* ---------- trust shares ---------- */
+const trustCount = {};
+entries.forEach(e=>trustCount[e.trust]=(trustCount[e.trust]||0)+1);
+/* ---------- geometry ---------- */
+const W=1880,H=1340, M=90; // margin for marginalia
+const rnd = mulberry32(SEED);
+function radiusOf(v){return 8+22*Math.log10(Math.max(2,filesOf(v)))}
+vessels.forEach(v=>{
+  const n=16,jit=[];
+  for(let i=0;i<n;i++)jit.push(0.80+0.38*rnd());
+  v._r=radiusOf(v); v._R=v._r*1.24; v._jit=jit; v._rot=rnd()*2*Math.PI;
+});
+function blobPath(cx,cy,r,jit,rot){
+  const n=jit.length;const pts=[];
+  for(let i=0;i<n;i++){const a=rot+i/n*2*Math.PI;const rr=r*jit[i];
+    pts.push([cx+Math.cos(a)*rr,cy+Math.sin(a)*rr])}
+  let d="";
+  for(let i=0;i<n;i++){
+    const p0=pts[(i-1+n)%n],p1=pts[i],p2=pts[(i+1)%n],p3=pts[(i+2)%n];
+    const c1=[p1[0]+(p2[0]-p0[0])/6,p1[1]+(p2[1]-p0[1])/6];
+    const c2=[p2[0]-(p3[0]-p1[0])/6,p2[1]-(p3[1]-p1[1])/6];
+    if(i===0)d+="M"+p1[0].toFixed(1)+","+p1[1].toFixed(1);
+    d+="C"+c1[0].toFixed(1)+","+c1[1].toFixed(1)+" "+c2[0].toFixed(1)+","+c2[1].toFixed(1)+" "+p2[0].toFixed(1)+","+p2[1].toFixed(1);
+  }
+  return d+"Z";
+}
+function vBlob(v,scale){const cx=v._x,cy=v._y;
+  return blobPath(cx,cy,v._r*scale,v._jit.map(j=>1+(j-1)*Math.pow(scale,0.7)),v._rot)}
+/* layout: deterministic force relaxation */
+(function layout(){
+  const inner={x0:M+70,y0:M+60,x1:W-M-70,y1:H-M-40};
+  const main=vessels.slice().sort((a,b)=>fanIn.get(b.id)-fanIn.get(a.id)||a.id.localeCompare(b.id));
+  // seed positions on an ellipse, most-connected toward center
+  main.forEach((v,i)=>{
+    const t=i/main.length*2*Math.PI-Math.PI/2;
+    const depth=i<5?0.34:i<12?0.62:0.9;
+    const cx=(inner.x0+inner.x1)/2, cy=(inner.y0+inner.y1)/2;
+    v._x=cx+Math.cos(t)*((inner.x1-inner.x0)/2*depth)*(0.85+0.3*rnd());
+    v._y=cy+Math.sin(t)*((inner.y1-inner.y0)/2*depth)*(0.85+0.3*rnd());
+  });
+  // the busiest harbors belong mid-province: most lanes are inbound to them
+  {
+    const hx=(inner.x0+inner.x1)/2, hy=(inner.y0+inner.y1)/2;
+    main.filter(v=>fanIn.get(v.id)>=GOD_HUB).forEach(v=>{
+      v._x=hx+(rnd()-0.5)*160; v._y=hy+(rnd()-0.5)*140});
+  }
+  const links=fairways.filter(f=>byId.has(f.from)&&byId.has(f.to));
+  const K=150;
+  for(let it=0;it<500;it++){
+    const temp=Math.max(3,170*(1-it/500));
+    for(let i=0;i<main.length;i++)for(let j=i+1;j<main.length;j++){
+      const a=main[i],b=main[j];let dx=b._x-a._x,dy=b._y-a._y;
+      let d=Math.sqrt(dx*dx+dy*dy)||0.01;
+      let f=Math.min(temp,K*K/(d*d)*d*0.02+d*0.002);
+      dx/=d;dy/=d;a._x-=dx*f;a._y-=dy*f;b._x+=dx*f;b._y+=dy*f}
+    links.forEach(f=>{const a=byId.get(f.from),b=byId.get(f.to);
+      let dx=b._x-a._x,dy=b._y-a._y;const d=Math.hypot(dx,dy)||0.01;
+      const target=a._R+b._R+130;let s=(d-target)/d*0.03;
+      s=Math.max(-temp,Math.min(temp,s));
+      dx*=s;dy*=s;a._x+=dx;a._y+=dy;b._x-=dx;b._y-=dy});
+    const cx=(inner.x0+inner.x1)/2,cy=(inner.y0+inner.y1)/2;
+    main.forEach(v=>{v._x+=(cx-v._x)*0.0025;v._y+=(cy-v._y)*0.0035});
+  }
+  // guarantee: resolve island overlaps and clamp inside the frame
+  const GAP=54;
+  for(let s=0;s<160;s++){
+    let any=false;
+    for(let i=0;i<main.length;i++)for(let j=i+1;j<main.length;j++){
+      const a=main[i],b=main[j];let dx=b._x-a._x,dy=b._y-a._y;
+      let d=Math.hypot(dx,dy)||0.01;const min=a._R+b._R+GAP;
+      if(d<min){const push=(min-d)/2+0.5;dx/=d;dy/=d;
+        a._x-=dx*push;a._y-=dy*push;b._x+=dx*push;b._y+=dy*push;any=true}}
+    main.forEach(v=>{
+      const nx=Math.min(Math.max(v._x,inner.x0+v._R),inner.x1-v._R);
+      const ny=Math.min(Math.max(v._y,inner.y0+v._R),inner.y1-v._R);
+      if(nx!==v._x||ny!==v._y)any=true;v._x=nx;v._y=ny});
+    if(!any)break;
+  }
+  // hub anchor: the busiest harbors settle mid-province, where their
+  // inbound lanes are shortest; overlap-freeing continues around them
+  {
+    const hx=(inner.x0+inner.x1)/2, hy=(inner.y0+inner.y1)/2;
+    const hubs=main.filter(v=>fanIn.get(v.id)>=GOD_HUB);
+    hubs.forEach((v,i)=>{const a=i/hubs.length*2*Math.PI;
+      v._x=hx+Math.cos(a)*120-80; v._y=hy+Math.sin(a)*110-40});
+    for(let s2=0;s2<50;s2++){
+      let moved=false;
+      for(let i=0;i<main.length;i++)for(let j=i+1;j<main.length;j++){
+        const a=main[i],b=main[j];let dx=b._x-a._x,dy=b._y-a._y;
+        const d=Math.hypot(dx,dy)||0.01;const min=a._R+b._R+GAP;
+        if(d<min){const push=(min-d)/2+0.5;
+          if(!hubs.includes(a)){a._x-=dx/d*push;a._y-=dy/d*push}
+          if(!hubs.includes(b)){b._x+=dx/d*push;b._y+=dy/d*push}
+          moved=true}}
+      main.forEach(v=>{
+        const nx=Math.min(Math.max(v._x,inner.x0+v._R),inner.x1-v._R);
+        const ny=Math.min(Math.max(v._y,inner.y0+v._R),inner.y1-v._R);
+        if(nx!==v._x||ny!==v._y)moved=true;v._x=nx;v._y=ny});
+      if(!moved)break;
+    }
+  }
+})();
+/* ---------- svg helpers ---------- */
+const SVGNS="http://www.w3.org/2000/svg";
+function el(tag,attrs,parent){const n=document.createElementNS(SVGNS,tag);
+  for(const k in attrs)n.setAttribute(k,attrs[k]);if(parent)parent.appendChild(n);return n}
+/* shared lane styling by trust (map lanes + graph edges) */
+const LANE_STYLE={measured:{stroke:"var(--lane-measured)","stroke-width":2.6},
+               charted:{stroke:"var(--lane-charted)","stroke-width":2.2},
+               reported:{stroke:"var(--lane-reported)","stroke-width":2,"stroke-dasharray":"7 5"},
+               doubtful:{stroke:"var(--lane-doubtful)","stroke-width":1.6,"stroke-dasharray":"3 6"},
+               unsurveyed:{stroke:"var(--lane-doubtful)","stroke-width":1.4,"stroke-dasharray":"1 7"}};
+/* rhumb lines from the rose center */
+(function(){const g=document.getElementById("rhumbs");
+  const rx=W-190,ry=205;g.dataset.cx=rx;g.dataset.cy=ry;
+  for(let i=0;i<16;i++){const a=i/16*2*Math.PI;
+    el("line",{x1:rx,y1:ry,x2:rx+Math.cos(a)*2400,y2:ry+Math.sin(a)*2400,
+      stroke:"var(--ink-soft)","stroke-width":i%4===0?1.0:0.55,opacity:0.16},g)}
+})();
+/* halos: stepped bathymetric bands around each island, band depth = trust of record */
+(function(){const g=document.getElementById("halos");
+  const OUTER=["#8fb3a2","#a9c2b0","#c1d1bd","#d6dcc6","#e6ddc4"]; // measured=deepest, unsurveyed=paper
+  const INNER=["#7ba18e","#9ab39c","#b8c8ac","#cfd4b8","#eee4c5"];
+  vessels.forEach(v=>{
+    const depth=TRUST_RANK[v.trust]??4;
+    el("path",{d:vBlob(v,1.66),fill:OUTER[depth],stroke:"none",opacity:.94},g);
+    el("path",{d:vBlob(v,1.28),fill:INNER[depth],stroke:"none",opacity:.97},g);
+  });
+})();
+/* lanes: paper casing + tapered three-segment stroke + hub fan spread */
+(function(){const g=document.getElementById("lanes");
+  // fan index per (to,id): arrows into one hub land side by side, not stacked
+  const fan=new Map();
+  fairways.forEach(f=>{if(!byId.has(f.to))return;
+    if(!fan.has(f.to))fan.set(f.to,[]);
+    fan.get(f.to).push(f.id)});
+  fan.forEach(list=>list.sort());
+  const fanIdx=new Map();
+  fan.forEach((list,to)=>list.forEach((id,i)=>fanIdx.set(id,{i,n:list.length})));
+  // braid groups: same destination AND same approach sector (8 buckets)
+  const sectorOf=(f)=>{
+    const a=byId.get(f.from),b=byId.get(f.to);if(!a||!b)return "x";
+    const ang=Math.atan2(b._y-a._y,b._x-a._x);
+    return f.to+":"+(((Math.round(ang/(Math.PI/4))%8)+8)%8)};
+  const braid=new Map();
+  fairways.forEach(f=>{const k=sectorOf(f);
+    if(!braid.has(k))braid.set(k,[]);braid.get(k).push(f.id)});
+  braid.forEach(list=>list.sort());
+  const braidIdx=new Map();
+  braid.forEach(list=>list.forEach((id,i)=>{if(list.length>1)braidIdx.set(id,i)}));
+  const style={measured:{stroke:"var(--lane-measured)",dash:null,w:[3.4,2.5,1.6]},
+               charted:{stroke:"var(--lane-charted)",dash:null,w:[3.0,2.2,1.4]},
+               reported:{stroke:"var(--lane-reported)",dash:"7 5",w:[2.7,2.0,1.3]},
+               doubtful:{stroke:"var(--lane-doubtful)",dash:"3 6",w:[2.2,1.7,1.2]},
+               unsurveyed:{stroke:"var(--lane-doubtful)",dash:"1 7",w:[2.0,1.6,1.1]}};
+  const pt=(a,c,b,t)=>{const u=1-t;
+    return [u*u*a[0]+2*u*t*c[0]+t*t*b[0], u*u*a[1]+2*u*t*c[1]+t*t*b[1]]};
+  fairways.forEach(f=>{const a=byId.get(f.from),b=byId.get(f.to);if(!a||!b)return;
+    const h=hashStr(f.id);
+    const mx=(a._x+b._x)/2,my=(a._y+b._y)/2;
+    let dx=b._x-a._x,dy=b._y-a._y;const d=Math.hypot(dx,dy)||0.01;
+    let bend=(0.22+((h>>>4)%100)/100*0.3)*(((h>>>9)&1)?-1:1);
+    if(braidIdx.has(f.id)){
+      const k=braidIdx.get(f.id);
+      bend=Math.abs(bend)*(1+Math.floor(k/2)*0.45)*((k&1)?-1:1);
+    }
+    const cx=mx-dy/d*d*bend*0.9, cy=my+dx/d*d*bend*0.9;
+    // start / end on the coasts
+    let sx=a._x+dx/d*(a._r+5),sy=a._y+dy/d*(a._r+5);
+    let ex=b._x-dx/d*(b._r+8),ey=b._y-dy/d*(b._r+8);
+    // fan spread at the destination, perpendicular to approach
+    const fi=fanIdx.get(f.id)||{i:0,n:1};
+    if(fi.n>1){const off=(fi.i-(fi.n-1)/2)*9;
+      ex+=-dy/d*off; ey+=dx/d*off}
+    const A=[sx,sy];const B=[ex,ey];
+    // deterministic obstacle avoidance: if the curve grazes a foreign
+    // island, flip/strengthen the bend (up to three attempts)
+    const clear=(ctl)=>{
+      const probes=[[0.3],[0.55],[0.8]];
+      return !probes.some(([t])=>{
+        const p=pt(A,ctl,B,t);
+        return vessels.some(v=>v!==a&&v!==b&&
+          Math.hypot(p[0]-v._x,p[1]-v._y)<v._r*1.14)})};
+    let ctl=[cx,cy];
+    if(!clear(ctl)){
+      for(const cand of [-bend,-bend*1.9,bend*1.9]){
+        const cx2=mx-dy/d*d*cand*0.9, cy2=my+dx/d*d*cand*0.9;
+        if(clear([cx2,cy2])){ctl=[cx2,cy2];break}}}
+    const st=style[f.trust]||style.charted;
+    const endTangent=[B[0]-ctl[0],B[1]-ctl[1]];const tl=Math.hypot(...endTangent)||1;
+    // arrowhead drawn as a filled wedge aligned with the landing tangent
+    const ax=B[0],ay=B[1],ux=endTangent[0]/tl,uy=endTangent[1]/tl;
+    const head=el("path",{d:`M${ax},${ay} L${ax-ux*9-uy*3.6},${ay-uy*9+ux*3.6} L${ax-ux*9+uy*3.6},${ay-uy*9-ux*3.6} Z`,
+      fill:st.stroke,"stroke":"none",class:"lane","data-fw":f.id},g);
+    head.dataset.from=f.from;head.dataset.to=f.to;
+    // paper casing then three tapering dash-respecting segments
+    el("path",{d:`M${A[0]},${A[1]} Q${ctl[0]},${ctl[1]} ${B[0]},${B[1]}`,
+      fill:"none",stroke:"var(--halotext)","stroke-width":st.w[0]+2.6,
+      "stroke-linecap":"round",opacity:.65,class:"casing"},g);
+    [[0,.42,st.w[0]],[.38,.74,st.w[1]],[.70,1,st.w[2]]].forEach(([t0,t1,w])=>{
+      const p0=pt(A,ctl,B,t0),p1=pt(A,ctl,B,(t0+t1)/2),p2=pt(A,ctl,B,Math.min(t1, .999));
+      const sp=el("path",{d:`M${p0[0].toFixed(1)},${p0[1].toFixed(1)} Q${p1[0].toFixed(1)},${p1[1].toFixed(1)} ${p2[0].toFixed(1)},${p2[1].toFixed(1)}`,
+        fill:"none",class:"lane","data-fw":f.id},
+        g);
+      sp.setAttribute("stroke",st.stroke);
+      sp.setAttribute("stroke-width",w);
+      if(st.dash)sp.setAttribute("stroke-dasharray",st.dash);
+      sp.dataset.from=f.from;sp.dataset.to=f.to;
+    });
+  });
+})();
+/* islands */
+(function(){const g=document.getElementById("islands");
+  vessels.forEach(v=>{
+    const grp=el("g",{class:"island","data-v":v.id,tabindex:0,
+      role:"button","aria-label":v.name||v.id},g);
+    if(fanIn.get(v.id)===0&&!poeVessels.has(v.id))grp.classList.add("edgeless");
+    el("path",{d:vBlob(v,1),class:"coast",filter:"url(#coastWobble)"},grp);
+    if(v.stale)el("path",{d:vBlob(v,1),fill:"url(#staleHatch)",stroke:"none"},grp);
+    grp.addEventListener("click",ev=>{ev.stopPropagation();hidePlate();select(v.id)});
+    grp.addEventListener("keydown",ev=>{if(ev.key==="Enter"||ev.key===" "){ev.preventDefault();hidePlate();select(v.id)}});
+    grp.addEventListener("pointerenter",()=>{if(selected!==v.id)showPlate(v)});
+    grp.addEventListener("pointerleave",()=>{if(plateFor===v.id)hidePlate()});
+  });
+})();
+/* marks: dangers, ports of entry, god-hub chips */
+(function(){const g=document.getElementById("marks");
+  const ink="var(--danger)";
+  function rock(x,y){el("path",{d:`M${x-7},${y} h14 M${x},${y-7} v14`,stroke:ink,"stroke-width":2.4,"stroke-linecap":"round"},g)}
+  function shallow(x,y){for(let k=0;k<3;k++){const a=k*Math.PI/3;
+    el("line",{x1:x-7*Math.cos(a),y1:y-7*Math.sin(a),x2:x+7*Math.cos(a),y2:y+7*Math.sin(a),
+      stroke:ink,"stroke-width":1.8,"stroke-linecap":"round"},g)}}
+  function wreck(x,y){el("path",{d:`M${x},${y-8} v16 M${x},${y-6} l-6,-4 M${x},${y-6} l6,-4 M${x},${y-2} l-6,-4 M${x},${y-2} l6,-4`,
+    stroke:ink,"stroke-width":1.7,fill:"none","stroke-linecap":"round"},g);
+    el("circle",{cx:x,cy:y,r:15,fill:"none",stroke:ink,"stroke-width":1.1,"stroke-dasharray":"2 3"},g)}
+  const SYM={rock,wreck,shallow};
+  // spread danger marks along each island's coast, away from the label (bottom)
+  const perVessel=new Map();
+  dangers.forEach(d=>{if(!perVessel.has(d.vessel))perVessel.set(d.vessel,[]);
+    perVessel.get(d.vessel).push(d)});
+  const drnd=mulberry32(SEED^0xfeedbee);
+  perVessel.forEach((list,vid)=>{const v=byId.get(vid);if(!v)return;
+    list.forEach((d,i)=>{const a=-2.35+i*0.55+(drnd()-0.5)*0.2;
+      const x=v._x+Math.cos(a)*(v._r+22),y=v._y+Math.sin(a)*(v._r+22);
+      (SYM[d.category]||rock)(x,y);d._x=x;d._y=y})});
+  // ports of entry: anchor on the coast away from the label (labels sit
+  // below), protocol as a small letterspaced chip just outside the glyph
+  function anchor(x,y){
+    el("path",{d:`M${x},${y-9} v15 M${x-6},${y-2} h12 M${x},${y+6} a6,6 0 1,0 -6,-6 M${x},${y-9} a3.4,3.4 0 0,1 6,0`,
+      stroke:"var(--poe)","stroke-width":2.2,fill:"none","stroke-linecap":"round"},g)}
+  poes.forEach(p=>{const v=byId.get(p.vessel);if(!v)return;
+    const a=-Math.PI/2+((hashStr(p.id)%40)-20)/70; // near top, deterministic spread
+    const x=v._x+Math.cos(a)*(v._r+20),y=v._y+Math.sin(a)*(v._r+20);
+    anchor(x,y);
+    const t=el("text",{x,y:y-(v._r>26?26:20),"text-anchor":"middle",class:"marginal",
+      "font-size":9,"font-weight":700,"letter-spacing":".14em",fill:"var(--poe)"},g);
+    t.textContent=(p.protocol||"").toUpperCase()||"ENTRY"});
+  // god-hub chips
+  godHubs.forEach(v=>{const x=v._x+v._r*0.75,y=v._y-v._r*0.85;
+    el("circle",{cx:x,cy:y,r:11,fill:"var(--chipbg)",stroke:"var(--frame)","stroke-width":1.4},g);
+    const t=el("text",{x,y:y+4.5,"text-anchor":"middle","font-size":12,"font-weight":700,
+      fill:"var(--ink)",class:"marginal"},g);t.textContent=fanIn.get(v.id)});
+  // whirlpools: one spiral glyph per tangle at its members' centroid
+  TANGLES.forEach((group,ti)=>{
+    const cx=group.reduce((s,id)=>s+byId.get(id)._x,0)/group.length;
+    const cy=group.reduce((s,id)=>s+byId.get(id)._y,0)/group.length;
+    const wp=el("g",{class:"whirl","data-t":ti},g);
+    for(let arm=0;arm<3;arm++){
+      let d="",a=arm*2*Math.PI/3;
+      for(let s=0;s<=14;s++){
+        const r=4+s*1.15,th=a+s*0.42;
+        d+=(s?"L":"M")+(cx+Math.cos(th)*r).toFixed(1)+","+(cy+Math.sin(th)*r).toFixed(1)}
+      el("path",{d,fill:"none",stroke:"var(--danger)","stroke-width":1.6,
+        "stroke-linecap":"round",opacity:.85},wp)}
+  });
+  const t=document.createElementNS(SVGNS,"title");
+})();
+/* labels */
+(function(){const g=document.getElementById("labels");
+  const ranked=vessels.slice().sort((a,b)=>filesOf(b)-filesOf(a));
+  ranked.forEach((v,i)=>{
+    const cls=i<5?"big":i<13?"mid":"small";
+    const t=el("text",{x:v._x,y:v._y+v._r+16,"text-anchor":"middle",
+      class:"lbl "+cls,"data-v":v.id},g);
+    t.textContent=(v.name||v.id).replace(/^Apache /,"");
+  });
+})();
+/* label plane: two deterministic passes push overlapping labels apart */
+(function(){const g=document.getElementById("labels");
+  const boxes=[...g.querySelectorAll("text.lbl")].map(t=>{
+    const b=t.getBBox();return {t,x:b.x,y:b.y,w:b.width,h:b.height}});
+  boxes.sort((a,b)=>b.w-a.w);
+  for(let pass=0;pass<2;pass++){
+    for(let i=0;i<boxes.length;i++)for(let j=0;j<boxes.length;j++){
+      if(i===j)continue;
+      const A=boxes[i],B=boxes[j];
+      if(Math.abs(A.x-B.x)<(A.w+B.w)/2&&Math.abs(A.y-B.y)<(A.h+B.h)/2){
+        A.y+=B.y<=A.y?8:-8;
+        A.t.setAttribute("y",A.y+A.h-3)}
+    }
+  }
+})();
+/* ---------- island atlas plates (chart-room: island-atlas-plates) ---------- */
+const PLATE_W=264;
+function roleOf(v){
+  const fi=fanIn.get(v.id)||0,fo=fanOut.get(v.id)||0;
+  if(!poeVessels.has(v.id)&&fi===0)return mode==="eng"?"ISOLATED":"DERELICT";
+  if(fi>=GOD_HUB)return mode==="eng"?"HUB":"HARBOR HUB";
+  if(fi>=3&&fo>=3)return mode==="eng"?"GATEWAY":"GATEWAY";
+  if(fo===0)return mode==="eng"?"LEAF":"ANCHORAGE";
+  return null}
+function buildPlate(v){
+  const g=document.getElementById("plate");
+  while(g.firstChild)g.removeChild(g.firstChild);
+  const el=(t,at,txt)=>{const n=document.createElementNS(SVGNS,t);
+    for(const k in at)n.setAttribute(k,at[k]);
+    if(txt!==undefined)n.textContent=txt;g.appendChild(n);return n};
+  const din=fairways.filter(f=>f.to===v.id).length;
+  const dout=fairways.filter(f=>f.from===v.id).length;
+  const np=poes.filter(p=>p.vessel===v.id).length;
+  const nb=beacons.filter(b=>b.vessel===v.id).length;
+  const nl=lights.filter(l=>l.vessel===v.id).length;
+  const nd=dangers.filter(d=>d.vessel===v.id);
+  const notice=NOTICES.find(n=>n.key==="vessel/"+v.id);
+  const role=roleOf(v);
+  let rows=5+(notice?1:0)+(role?1:0)+(v.stale?1:0)+(nd.length?1:0);
+  const h=74+rows*15+8;
+  // anchor: right of the island, flip if overflowing the neatline
+  let px=v._x+v._R+18, py=Math.max(v._y-h/2,46);
+  if(px+PLATE_W>W-52)px=Math.max(52,v._x-v._R-18-PLATE_W);
+  py=Math.min(py,H-70-h);
+  el("rect",{x:px,y:py,width:PLATE_W,height:h,fill:"var(--paper)",
+    stroke:"var(--frame)","stroke-width":1.6});
+  el("rect",{x:px+4,y:py+4,width:PLATE_W-8,height:h-8,fill:"none",
+    stroke:"var(--frame)","stroke-width":.6});
+  const trustColor={measured:"var(--lane-measured)",charted:"var(--lane-charted)",
+    reported:"var(--lane-reported)",doubtful:"var(--lane-doubtful)",
+    unsurveyed:"#b9ab84"}[v.trust]||"var(--lane-charted)";
+  el("rect",{x:px,y:py,width:7,height:h,fill:trustColor});
+  let y=py+24;
+  const title=el("text",{x:px+16,y:y,fill:"var(--ink)"});
+  title.setAttribute("style","font-family:var(--font-map);font-size:14px;font-weight:700;font-style:italic");
+  title.textContent=(v.name||v.id);
+  y+=13;
+  el("text",{x:px+16,y,fill:"var(--ink-soft)","font-size":9.5},v.id+
+    (filesOf(v)?"  ·  "+filesOf(v).toLocaleString()+" files":""));
+  y+=11;
+  el("text",{x:px+16,y,fill:"var(--ink-soft)","font-size":9.5},
+    ((v.paths&&v.paths.length)||0)+" source path"+(((v.paths&&v.paths.length)===1)?"":"s"));
+  y+=17;
+  // counters row
+  const counts=[
+    [mode==="eng"?"in":"in", din],[mode==="eng"?"out":"out", dout],
+    [lexShort("poe"),np],[lexShort("beacon"),nb],[lexShort("light"),nl],
+    [lexShort("danger"),nd.length]];
+  let cx0=px+16;
+  counts.forEach(([lab,val])=>{
+    el("text",{x:cx0,y,"font-size":10.5,"font-weight":700,fill:"var(--ink)"},String(val));
+    el("text",{x:cx0+((val>=10)?13:8),y,"font-size":8.6,fill:"var(--ink-soft)"},lab);
+    cx0+=((val>=10)?14:9)+lab.length*4.6+10});
+  y+=17;
+  // behavior line
+  const behav=v.behavior
+    ? (mode==="eng"?"behavior charted":"behavior measured")
+    : (mode==="eng"?"runtime unknown":"runtime unsurveyed");
+  el("text",{x:px+16,y,"font-size":10,fill:v.behavior?"var(--lane-measured)":"var(--accent)"},
+    behav);
+  y+=15;
+  if(v.stale){el("text",{x:px+16,y,"font-size":10,"font-weight":700,
+    fill:"var(--accent)"},"PENDING CORRECTION");y+=15}
+  if(notice){el("text",{x:px+16,y,"font-size":10,fill:"var(--ink-soft)"},
+    (mode==="eng"?"last change: ":"latest notice: ")+notice.action+" · "+notice.key.split("/")[1]);y+=15}
+  if(role){el("text",{x:px+16,y,"font-size":10,"font-weight":700,
+    "letter-spacing":".12em",fill:"var(--accent)"},role);y+=15}
+  y+=2;
+  el("text",{x:px+16,y,"font-size":8.8,fill:"var(--ink-soft)"},
+    (mode==="eng"?"Click for details + impact set":"Click for dossier & blast radius"));
+  function lexShort(k){return LEX[mode][k]}
+}
+let plateFor=null;
+function showPlate(v){
+  if(selected===v.id){hidePlate();return}
+  plateFor=v.id;buildPlate(v)}
+function hidePlate(){plateFor=null;
+  const g=document.getElementById("plate");
+  while(g.firstChild)g.removeChild(g.firstChild)}
+/* graph view (engineering mode): layered dependency diagram */
+(function buildGraph(){
+  const g=document.getElementById("graphview");
+  const NH=40; // node height
+  const disp=v=>(v.name||v.id).replace(/^Apache /,"");
+  // rank = longest dependency chain into the node (dependents above, foundations below)
+  const rank=new Map();vessels.forEach(v=>rank.set(v.id,0));
+  for(let k=0;k<60;k++){let ch=false;
+    fairways.forEach(f=>{if(rank.has(f.from)&&rank.has(f.to)){
+      const nr=rank.get(f.from)+1;
+      if(nr>rank.get(f.to)){rank.set(f.to,nr);ch=true}}});
+    if(!ch)break}
+  const byRank=new Map();
+  vessels.forEach(v=>{const r=rank.get(v.id);
+    if(!byRank.has(r))byRank.set(r,[]);byRank.get(r).push(v)});
+  const ranks=[...byRank.keys()].sort((a,b)=>a-b);
+  ranks.forEach(r=>byRank.get(r).sort((a,b)=>
+    fanIn.get(b.id)-fanIn.get(a.id)||a.id.localeCompare(b.id)));
+  // barycenter sweeps to reduce crossings (deterministic)
+  const ord=new Map(); // id -> current index in its rank
+  const neigh=(v,down)=>fairways.filter(f=>down?f.from===v.id:f.to===v.id)
+    .map(f=>down?f.to:f.from).filter(id=>ord.has(id));
+  for(let sweep=0;sweep<14;sweep++){
+    const down=sweep%2===0;
+    const seq=down?ranks:ranks.slice().reverse();
+    seq.forEach(r=>{
+      const row=byRank.get(r);
+      const keyed=row.map((v,i)=>{
+        const nb=neigh(v,down);
+        const bc=nb.length?nb.reduce((s,id)=>s+ord.get(id),0)/nb.length:i;
+        return [v,bc+i*1e-4]});
+      keyed.sort((a,b)=>a[1]-b[1]);
+      byRank.set(r,keyed.map(x=>x[0]));
+      byRank.get(r).forEach((v,i)=>ord.set(v.id,i));
+    });
+  }
+  // place
+  const rowH=Math.min(148,(H-360)/Math.max(1,ranks.length-1));
+  const top=170,left=140,right=W-140,gap=40;
+  const nodeW=v=>Math.max(96,disp(v).length*8.6+64);
+  const gp=new Map();
+  ranks.forEach(r=>{
+    const row=byRank.get(r);
+    const avail=right-left;
+    const rawW=row.map(v=>nodeW(v));
+    let rowW=rawW.reduce((s,w)=>s+w+gap,0)-gap;
+    const k=rowW>avail?Math.max(0.45,avail/rowW):1; // squeeze wide rows
+    const ws=rawW.map(w=>Math.max(64,w*k));
+    rowW=ws.reduce((s,w)=>s+w+gap,0)-gap;
+    const rgap=rowW>avail?Math.max(8,gap-(rowW-avail)/Math.max(1,row.length-1)):gap;
+    if(rowW>avail)rowW=ws.reduce((s,w)=>s+w+rgap,0)-rgap;
+    let x=left+Math.max(10,(avail-rowW)/2);
+    row.forEach((v,i)=>{const w=ws[i];
+      gp.set(v.id,{x:x+w/2,y:top+r*rowH,w,sq:k<1});x+=w+rgap})});
+  // edges first
+  const ge=el("g",{},g);
+  fairways.forEach(f=>{const a=gp.get(f.from),b=gp.get(f.to);if(!a||!b)return;
+    const sy=a.y+NH/2,ty=b.y-NH/2,dy=ty-sy;
+    const p=el("path",Object.assign({d:`M${a.x},${sy} C${a.x},${sy+dy*0.55} ${b.x},${ty-dy*0.55} ${b.x},${ty-6}`,
+      class:"gedge","data-fw":f.id,"marker-end":"url(#arrow)"},LANE_STYLE[f.trust]||LANE_STYLE.charted),ge);
+    p.dataset.from=f.from;p.dataset.to=f.to});
+  // nodes
+  const TRUST_DOT={measured:"var(--lane-measured)",charted:"var(--lane-charted)",
+    reported:"var(--lane-reported)",doubtful:"var(--lane-doubtful)",unsurveyed:"#8a8a8a"};
+  const gn=el("g",{},g);
+  vessels.forEach(v=>{const p=gp.get(v.id);
+    const grp=el("g",{class:"gnode","data-v":v.id,tabindex:0,role:"button",
+      "aria-label":v.name||v.id},gn);
+    el("rect",{x:p.x-p.w/2,y:p.y-NH/2,width:p.w,height:NH,rx:7,class:"box"},grp);
+    el("circle",{cx:p.x-p.w/2+14,cy:p.y,r:5,fill:TRUST_DOT[v.trust]||"#8a8a8a"},grp);
+    const name=el("text",{x:p.x+6,y:p.y+4.5,"text-anchor":"middle",class:"gname"},grp);
+    if(p.sq){name.setAttribute("textLength",Math.max(40,p.w-40));
+      name.setAttribute("lengthAdjust","spacingAndGlyphs")}
+    name.textContent=disp(v);
+    const badges=[];
+    if(poeVessels.has(v.id))badges.push("entry");
+    const nd=dangers.filter(d=>d.vessel===v.id).length;if(nd)badges.push("⚠"+nd);
+    if(fanIn.get(v.id)>=GOD_HUB)badges.push("×"+fanIn.get(v.id));
+    if(badges.length){const bt=el("text",{x:p.x,y:p.y-NH/2-6,"text-anchor":"middle",
+      class:"gbadge"},grp);bt.textContent=badges.join("  ")}
+    grp.addEventListener("click",ev=>{ev.stopPropagation();select(v.id)});
+    grp.addEventListener("keydown",ev=>{if(ev.key==="Enter"||ev.key===" "){ev.preventDefault();select(v.id)}});
+  });
+  // rank axis note
+  const ax=el("text",{x:70,y:H-90,class:"marginal","font-size":11,
+    transform:`rotate(-90 70 ${H-90})`},g);
+  ax.textContent="dependents above → foundations below";
+})();
+/* marginalia: frame, cartouche, rose, legend, scale ladder, dragon */
+(function(){const g=document.getElementById("margin");
+  el("rect",{x:26,y:26,width:W-52,height:H-52,fill:"none",stroke:"var(--frame)","stroke-width":2.6},g);
+  el("rect",{x:36,y:36,width:W-72,height:H-72,fill:"none",stroke:"var(--frame)","stroke-width":0.8},g);
+  const maponly={class:"maponly"};
+  // cartouche
+  const cx=64,cy=64;
+  const cart=el("g",maponly,g);
+  el("rect",{x:cx,y:cy,width:388,height:96,fill:"var(--paper)",stroke:"var(--frame)","stroke-width":1.6},cart);
+  el("rect",{x:cx+5,y:cy+5,width:378,height:86,fill:"none",stroke:"var(--frame)","stroke-width":0.7},cart);
+  let t=el("text",{x:cx+20,y:cy+32,class:"cartouche-main","font-size":21},cart);
+  t.dataset.lex="chartroom";
+  t=el("text",{x:cx+20,y:cy+54,class:"marginal","font-size":14.5,fill:"var(--ink)"},cart);
+  t.textContent=META.province;
+  t=el("text",{x:cx+20,y:cy+74,class:"marginal","font-size":12},cart);
+  t.textContent=`Expedition ${META.expedition} · ${vessels.length} ${lex("vessel").toLowerCase()}s · ${fairways.length} ${lex("fairway").toLowerCase()}s · ${dangers.length} ${lex("danger").toLowerCase()}s`;
+  t.dataset.redynamic="counts";
+  // graph header (engineering)
+  const gh=el("g",{class:"engonly"},g);
+  let gt=el("text",{x:64,y:96,class:"cartouche-main","font-size":21},gh);
+  gt.dataset.lex="chartroom";
+  gt=el("text",{x:64,y:118,class:"marginal","font-size":14.5,fill:"var(--ink)"},gh);
+  gt.textContent=META.province;
+  gt=el("text",{x:64,y:136,class:"marginal","font-size":12},gh);
+  gt.textContent=`Expedition ${META.expedition} · layered by dependency depth`;
+  // compass rose
+  const rx=W-190,ry=205;
+  const rose=el("g",{class:"nautical-only"},g);
+  el("circle",{cx:rx,cy:ry,r:44,fill:"none",stroke:"var(--ink-soft)","stroke-width":1},rose);
+  el("circle",{cx:rx,cy:ry,r:34,fill:"none",stroke:"var(--ink-soft)","stroke-width":0.5},rose);
+  for(let i=0;i<8;i++){const a=i*Math.PI/4;const long=i%2===0;
+    const r1=long?58:44;
+    el("line",{x1:rx,y1:ry,x2:rx+Math.cos(a)*r1,y2:ry+Math.sin(a)*r1,
+      stroke:"var(--ink-soft)","stroke-width":long?2:1},rose);
+    if(long){const w=a+Math.PI/8;
+      el("path",{d:`M${rx+Math.cos(a)*54},${ry+Math.sin(a)*54} L${rx+Math.cos(w)*8},${ry+Math.sin(w)*8} L${rx+Math.cos(a+Math.PI/8+0.35)*16},${ry+Math.sin(a+Math.PI/8+0.35)*16} Z`,
+        fill:"var(--ink-soft)",opacity:.8},rose)}}
+  const nt=el("text",{x:rx,y:ry-64,"text-anchor":"middle","font-size":12,class:"marginal"},rose);
+  nt.textContent="N";
+  // map legend (nautical)
+  const mleg=el("g",maponly,g);
+  const lx=56,ly=H-268;
+  el("rect",{x:lx,y:ly,width:360,height:226,fill:"var(--paper)",stroke:"var(--frame)","stroke-width":1.4},mleg);
+  let lt=el("text",{x:lx+16,y:ly+26,class:"cartouche-main","font-size":13},mleg);lt.textContent="LEGEND";
+  // trust of record (water depth)
+  const bands=["#7ba18e","#9ab39c","#b8c8ac","#cfd4b8","#eee4c5"];
+  TRUSTS.forEach((tr,i)=>{const y=ly+46+i*20;
+    el("rect",{x:lx+16,y:y-10,width:30,height:13,fill:bands[i],stroke:"var(--island-edge)","stroke-width":.8},mleg);
+    const t2=el("text",{x:lx+60,y:y+1,"font-size":11.5,class:"marginal",fill:"var(--ink)"},mleg);
+    t2.textContent=tr});
+  // lane styles
+  const lstyles={measured:["var(--lane-measured)","none"],charted:["var(--lane-charted)","none"],
+    reported:["var(--lane-reported)","7 5"],doubtful:["var(--lane-doubtful)","3 6"]};
+  let yy=ly+158;
+  const lt2=el("text",{x:lx+16,y:yy,"font-size":11,class:"marginal"},mleg);
+  lt2.textContent="Fairway trust →";
+  Object.keys(lstyles).forEach((tr,i)=>{const y=yy+16+i*15;
+    el("line",{x1:lx+16,y1:y-3,x2:lx+50,y2:y-3,stroke:lstyles[tr][0],"stroke-width":2.2,
+      "stroke-dasharray":lstyles[tr][1],fill:"none"},mleg);
+    const t3=el("text",{x:lx+60,y:y,"font-size":11,class:"marginal",fill:"var(--ink)"},mleg);
+    t3.textContent=tr});
+  // graph legend (engineering)
+  const gleg=el("g",{class:"engonly"},g);
+  const gx=56,gy=H-268;
+  el("rect",{x:gx,y:gy,width:360,height:226,fill:"var(--paper)",stroke:"var(--frame)","stroke-width":1.4},gleg);
+  let gl=el("text",{x:gx+16,y:gy+26,class:"cartouche-main","font-size":13},gleg);gl.textContent="LEGEND";
+  let gy2=gy+48;
+  gl=el("text",{x:gx+16,y:gy2,"font-size":11,class:"marginal",fill:"var(--ink)"},gleg);
+  gl.textContent="Edge trust →";
+  Object.keys(lstyles).forEach((tr,i)=>{const y=gy2+16+i*15;
+    el("line",{x1:gx+16,y1:y-3,x2:gx+50,y2:y-3,stroke:lstyles[tr][0],"stroke-width":2.2,
+      "stroke-dasharray":lstyles[tr][1],fill:"none"},gleg);
+    const t3=el("text",{x:gx+60,y:y,"font-size":11,class:"marginal",fill:"var(--ink)"},gleg);
+    t3.textContent=tr});
+  const notes=["● node dot = component record trust",
+    "entry = port of entry · ⚠n = risks · ×n = dependents",
+    "click a node: impact set (transitive dependents)"];
+  notes.forEach((s,i)=>{const t4=el("text",{x:gx+16,y:gy2+16+4*15+14+i*15,
+    "font-size":10.5,class:"marginal",fill:"var(--ink)"},gleg);t4.textContent=s});
+  // size ladder
+  const ladder=el("g",maponly,g);
+  const sx=W-320,sy=H-96;
+  [[34,"~25k files"],[22,"~1k"],[12,"~10"]].forEach(([r,lab],i)=>{
+    el("circle",{cx:sx+i*86,cy:sy,r,fill:"var(--island)",stroke:"var(--island-edge)","stroke-width":1.6},ladder);
+    const t4=el("text",{x:sx+i*86,y:sy+r+14,"text-anchor":"middle","font-size":10.5,class:"marginal"},ladder);
+    t4.textContent=lab});
+  // one dragon
+  const drag=el("g",maponly,g);
+  const dx=W-150,dy=H-190;
+  el("path",{d:`M${dx-60},${dy} q10,-14 20,0 q10,-14 20,0 q10,14 22,2 q6,-5 10,2`,
+    stroke:"var(--ink-soft)",fill:"none","stroke-width":1.4,opacity:.7},drag);
+  const dt=el("text",{x:dx+8,y:dy+26,"text-anchor":"middle",class:"dragon","font-size":12},g);
+  dt.textContent="hic svnt dracones";
+})();
+/* ---------- panel: briefing ---------- */
+function trustBar(){
+  const colors={measured:"#2c5a68",charted:"#5d8895",reported:"#6b8f8f",doubtful:"#a4b6b1",unsurveyed:"#d9d2b6"};
+  let bar='<div class="trustbar">';
+  TRUSTS.forEach(tr=>{const n=trustCount[tr]||0;
+    if(n)bar+=`<div style="width:${n/DATA.entries.length*100}%;background:${colors[tr]}" title="${tr}: ${n}"></div>`});
+  bar+="</div><div class='trustkey'>"+TRUSTS.map(tr=>
+    `<span><b>${trustCount[tr]||0}</b> ${tr}</span>`).join("")+"</div>";
+  return bar;
+}
+/* Chart-controlled strings are data, never markup: every interpolation of a
+   chart field into HTML passes through esc, so a charted note like
+   `<img src=x onerror=...>` renders as text (stored-XSS guard — the room is
+   published, not just viewed locally). */
+const esc=s=>String(s).replace(/[&<>"']/g,c=>({"&":"&amp;","<":"&lt;",">":"&gt;",'"':"&quot;","'":"&#39;"}[c]));
+function renderBriefing(){
+  const b=document.getElementById("briefing"),d=document.getElementById("dossier");
+  d.hidden=true;b.hidden=false;
+  b.innerHTML=`<h2>${lex("chartroom")}</h2>
+   <p class="statline">${vessels.length} ${mode==="eng"?"components":"vessels"} · ${fairways.length} ${mode==="eng"?"dependencies":"fairways"} ·
+     ${poes.length} ${mode==="eng"?"entry points":"ports of entry"} · ${dangers.length} ${mode==="eng"?"risks":"dangers"} ·
+     ${beacons.length} ${mode==="eng"?"config surfaces":"beacons"} · ${lights.length} ${mode==="eng"?"API contracts":"lights"}</p>
+   <h3>Trust of chart</h3>${trustBar()}
+   ${tanglesPanel()}
+   ${noticesPanel()}
+   ${godHubs.length?`<h3>Hubs</h3><ul>${godHubs.map(v=>
+      `<li><b>${esc(v.name||v.id)}</b> — ${fanIn.get(v.id)} ${lex("hub")}</li>`).join("")}</ul>`:""}
+   <h3>Sailing Directions</h3>${BRIEF}
+   <p class="statline" style="margin-top:14px">Click an island for the dossier and ${lex("blastr").toLowerCase()}.</p>`;
+}
+/* Dependency tangles panel (chart-room: chart-room-tangles) */
+function tanglesPanel(){
+  if(!TANGLES.length)
+    return `<h3>${mode==="eng"?"Dependency cycles":"Tangles"}</h3>
+      <p class="statline">${mode==="eng"
+        ?"No dependency cycles — the graph is acyclic (verified)."
+        :"No tangles — these waters run clear, no whirlpools charted."}</p>`;
+  const rows=TANGLES.map((group,i)=>`
+    <div class="notice"><span class="nact" style="color:var(--danger)">${mode==="eng"?"CYCLE":"WHIRLPOOL"} ${i+1}</span>
+    ${group.map(id=>`<code>${esc(id)}</code>`).join(" ")}</div>`).join("");
+  return `<h3>${mode==="eng"?`Dependency cycles (${TANGLES.length})`:`Whirlpools (${TANGLES.length})`}</h3>${rows}`;
+}
+/* Notices to Mariners panel (chart-room: notices-panel) */
+function noticesPanel(){
+  const title=mode==="eng"?"Change log":"Notices to Mariners";
+  if(!NOTICES.length)
+    return `<h3>${title}</h3><p class="statline">${mode==="eng"
+      ?"No changes recorded — the chart is current."
+      :"No outstanding notices — the chart is current."}</p>`;
+  const colors={added:"#2c7a4f",corrected:"#2c5a68",markedStale:"#9a6a1e",retired:"#8a3226"};
+  const names={added:"ADDED",corrected:"CORRECTED",markedStale:"MARKED STALE",retired:"RETIRED"};
+  const rows=NOTICES.map(n=>`
+    <div class="notice"><span class="nact" style="color:${colors[n.action]||'var(--ink-soft)'}">${names[n.action]}</span>
+    <code>${esc(n.key)}</code>${n.note?`<div class="nnote">${esc(n.note)}</div>`:""}
+    ${n.anchors.length?`<ul class="anchors">${n.anchors.map(a=>`<li>${esc(a)}</li>`).join("")}</ul>`:""}
+    </div>`).join("");
+  return `<h3>${title} (${NOTICES.length})</h3>${rows}`;
+}
+/* ---------- dossier ---------- */
+function fmtAnchor(a){if(!a)return"";
+  if(a.type==="manifest")return a.path+"#"+a.key;
+  return a.path+(a.line?":"+a.line:"")}
+function trustBadge(tr){return `<span class="badge trust">${tr}</span>`}
+function renderDossier(v){
+  const b=document.getElementById("briefing"),d=document.getElementById("dossier");
+  b.hidden=true;d.hidden=false;
+  const din=dangers.filter(x=>x.vessel===v.id);
+  const fin=fairways.filter(f=>f.to===v.id);
+  const fout=fairways.filter(f=>f.from===v.id);
+  const vp=poes.filter(p=>p.vessel===v.id);
+  const vb=beacons.filter(x=>x.vessel===v.id);
+  const vl=lights.filter(x=>x.vessel===v.id);
+  const blast=dependents(v.id);
+  const sec=(title,rows)=>rows.length?`<h3>${title}</h3>${rows.join("")}`:"";
+  const own=[v,...din,...fin,...fout,...vp,...vb,...vl];
+  const hasReceipt=own.some(e=>(e.anchors||[]).some(a=>a.type==="receipt"))||!!v.behavior;
+  const obs=hasReceipt?1:0;
+  const scope=[...own];
+  const byTrust=t=>scope.filter(e=>e.trust===t).length;
+  const ver=byTrust("measured");
+  const dec=byTrust("charted");
+  const cla=scope.filter(e=>e.trust==="reported"||e.trust==="doubtful")
+    .map(e=>`${e.kind}/${e.id}`);
+  d.innerHTML=`
+   <div class="dossier-head"><h2>${esc(v.name||v.id)}</h2>${trustBadge(v.trust)}
+     <button class="closebtn" type="button">✕ Close</button></div>
+   <p class="statline"><code>${esc(v.id)}</code> · ${filesOf(v).toLocaleString()} files
+     ${fanIn.get(v.id)?` · ${fanIn.get(v.id)} ${lex("hub")}`:" · no known dependents (edge of the charted waters)"}
+     ${v.stale?' · <b style="color:var(--accent)">pending correction</b>':""}</p>
+   ${v.note?`<p>${esc(v.note)}</p>`:""}
+   <h3>${mode==="eng"?"How we know":"How this is known"}</h3>
+   <div class="ledger">
+     <span class="lamp observed"><span class="n">${obs}</span><span class="t">OBSERVED</span></span>
+     <span class="lamp verified"><span class="n">${ver}</span><span class="t">VERIFIED</span></span>
+     <span class="lamp declared"><span class="n">${dec}</span><span class="t">DECLARED</span></span>
+     <span class="lamp claimed"><span class="n">${cla.length}</span><span class="t">CLAIMED</span></span>
+   </div>
+   <p class="ledger-note">observed = execution receipts · verified = source-read (measured) · declared = manifests & packaging (charted) · claimed = report or doubtful${cla.length?" — rides on "+cla.map(c=>`<code>${esc(c)}</code>`).join(", "):""}</p>
+   <h3>${lex("blastr")}</h3>
+   <p>${blast.size} ${lex("vessel").toLowerCase()}s depend on this transitively
+      ${blast.size?[...blast].map(id=>`<code>${esc(id)}</code>`).join(" "):""}.</p>
+   ${sec(mode==="eng"?"Entry points":"Ports of entry",vp.map(p=>`<p><b>${esc(p.protocol||"")}</b> — ${esc(p.note||"")}
+      <ul class="anchors">${(p.anchors||[]).map(a=>`<li>${esc(fmtAnchor(a))}</li>`).join("")}</ul></p>`))}
+   ${sec(lex("danger")+"s",din.map(x=>`<p><b>${esc(x.category)}</b> — ${esc(x.note||"")}
+      <ul class="anchors">${(x.anchors||[]).map(a=>`<li>${esc(fmtAnchor(a))}</li>`).join("")}</ul></p>`))}
+   ${sec(lex("fairway")+"s in ("+fin.length+")",fin.map(f=>`<div class="fwrow">
+      <span class="t"><b>${esc(f.from)}</b> <code>${esc(f.id)}</code></span><span class="tr">${esc(f.trust)}${/sounded:\s*confirmed/i.test(f.note||"")?' · <span class="snd">sounded ✓</span>':""}</span></div>`))}
+   ${sec(lex("fairway")+"s out ("+fout.length+")",fout.map(f=>`<div class="fwrow">
+      <span class="t"><b>${esc(f.to)}</b> <code>${esc(f.id)}</code></span><span class="tr">${esc(f.trust)}${/sounded:\s*confirmed/i.test(f.note||"")?' · <span class="snd">sounded ✓</span>':""}</span></div>`))}
+   ${sec(lex("beacon")+"s",vb.map(x=>`<p><code>${esc(x.key)}</code> (${esc(x.surface)}) — ${esc(x.note||"")}</p>`))}
+   ${sec(lex("light")+"s",vl.map(x=>`<p><b>${esc(x.name)}</b> — ${esc(x.note||"")}</p>`))}
+   ${TANGLES.some(t=>t.includes(v.id))?(()=>{const g=TANGLES.find(t=>t.includes(v.id))||[];
+      return sec("In a tangle with",[
+        `<p>${g.filter(id=>id!==v.id).map(id=>`<code>${esc(id)}</code>`).join(" ")}</p>`])})():""}
+   <h3>${lex("unsurveyed")}</h3>
+   <p>${v.behavior?"":"Runtime behavior "+lex("unsurveyed").toLowerCase()+" — vessel <code>behavior</code> is unset (nothing observed running)."}</p>`;
+  d.querySelector(".closebtn").addEventListener("click",()=>clearSelect());
+}
+/* ---------- find & focus filters (chart-room: chart-room-search) ---------- */
+/* Filters dim attention, never remove data: dimmed vessels keep labels and stay clickable. */
+const filterState={trust:new Set(),dangerOnly:false};
+const dangerVessels=new Set(dangers.map(d=>d.vessel));
+(function buildFilterUI(){
+  const chips=document.getElementById("trustChips");
+  TRUSTS.forEach(tr=>{
+    const b=document.createElement("button");
+    b.type="button";b.className="chip";b.textContent=tr;b.setAttribute("aria-pressed","false");
+    b.addEventListener("click",()=>{
+      filterState.trust.has(tr)?filterState.trust.delete(tr):filterState.trust.add(tr);
+      b.setAttribute("aria-pressed",filterState.trust.has(tr)?"true":"false");
+      applyFilters()});
+    chips.appendChild(b)});
+  const dc=document.getElementById("dangerChip");
+  dc.addEventListener("click",()=>{filterState.dangerOnly=!filterState.dangerOnly;
+    dc.setAttribute("aria-pressed",String(filterState.dangerOnly));applyFilters()});
+  document.getElementById("resetChip").addEventListener("click",()=>{
+    filterState.trust.clear();filterState.dangerOnly=false;
+    document.querySelectorAll("#filters .chip[aria-pressed]").forEach(c=>c.setAttribute("aria-pressed","false"));
+    applyFilters()});
+  document.getElementById("findBox").addEventListener("change",ev=>{
+    const q=ev.target.value.trim().toLowerCase();if(!q)return;
+    const best=vessels.find(v=>v.id.toLowerCase()===q)
+      ||vessels.find(v=>(v.name||"").toLowerCase().startsWith(q)||v.id.toLowerCase().startsWith(q))
+      ||vessels.find(v=>(v.name||"").toLowerCase().includes(q)||v.id.toLowerCase().includes(q));
+    if(best)select(best.id);ev.target.value=""});
+})();
+function vesselBright(id){
+  const v=byId.get(id);if(!v)return true;
+  if(filterState.trust.size&&!filterState.trust.has(v.trust))return false;
+  if(filterState.dangerOnly&&!dangerVessels.has(id))return false;
+  return true}
+function applyFilters(){
+  if(!filterState.trust.size&&!filterState.dangerOnly){
+    document.querySelectorAll("#map .dimmed").forEach(n=>n.classList.remove("dimmed"));
+    return}
+  const anyActive=selected!==null; // interplay handled by blasting rules on top
+  document.querySelectorAll(".island").forEach(g=>
+    g.classList.toggle("dimmed",anyActive?false:!vesselBright(g.dataset.v)));
+  document.querySelectorAll(".gnode").forEach(g=>
+    g.classList.toggle("dimmed",!vesselBright(g.dataset.v)));
+}
+/* ---------- selection & blast radius ---------- */
+let selected=null;
+function select(id){
+  hidePlate();selected=id;const map=document.getElementById("map");
+  map.classList.add("blasting");
+  const blast=dependents(id);blast.add(id);
+  document.querySelectorAll(".island,.gnode").forEach(g=>{
+    g.classList.toggle("lit",g.dataset.v===id);
+    g.classList.toggle("lit2",blast.has(g.dataset.v)&&g.dataset.v!==id)});
+  document.querySelectorAll(".lane,.gedge").forEach(p=>{
+    const f=p.dataset.from,t=p.dataset.to;
+    p.classList.toggle("lit",t===id&&blast.has(f)||(f===id));
+    p.classList.toggle("lit2",blast.has(f)&&blast.has(t));
+    p.style.opacity=blast.has(f)&&blast.has(t)?"": (f===id?"":"0.15")});
+  renderDossier(byId.get(id));
+}
+function clearSelect(){
+  selected=null;const map=document.getElementById("map");
+  map.classList.remove("blasting");
+  document.querySelectorAll(".lit,.lit2").forEach(g=>g.classList.remove("lit","lit2"));
+  document.querySelectorAll(".lane,.gedge").forEach(p=>p.style.opacity="");
+  renderBriefing();
+}
+document.getElementById("map").addEventListener("click",ev=>{
+  if(ev.target.id==="sea"||ev.target.id==="seaTex")clearSelect()});
+/* lit styling */
+const st=document.createElement("style");
+st.textContent=`.island.lit .coast{stroke:var(--accent);stroke-width:4.4}
+.island.lit2 .coast{stroke-width:3.4}
+.gnode.lit .box{stroke:var(--accent);stroke-width:3}
+.gnode.lit2 .box{stroke-width:2.4}
+.lane.lit{stroke-width:4!important}.lane.lit2{stroke-width:3!important;opacity:1!important}
+.gedge.lit{stroke-width:4!important}.gedge.lit2{stroke-width:3!important;opacity:1!important}`;
+document.head.appendChild(st);
+/* ---------- pan & zoom ---------- */
+(function(){
+  const world=document.getElementById("viewport"),wrap=document.getElementById("mapwrap");
+  const VB={x:0,y:0,w:1880,h:1340};let scale=1,vx=VB.x,vy=VB.y,vw=VB.w,vh=VB.h;
+  function apply(){world.setAttribute("transform",
+    `translate(${vx},${vy}) scale(${vw/VB.w})`);
+    labelZoom()}
+  function labelZoom(){const s=VB.w/vw;
+    document.querySelectorAll("text.lbl.small").forEach(t=>t.style.display=s<0.55?"none":"");
+    document.querySelectorAll("text.lbl.mid").forEach(t=>t.style.display=s<0.33?"none":"")}
+  wrap.addEventListener("wheel",ev=>{ev.preventDefault();
+    const r=wrap.getBoundingClientRect();
+    const px=vx+(ev.clientX-r.left)/r.width*vw, py=vy+(ev.clientY-r.top)/r.height*vh;
+    const k=ev.deltaY>0?1.12:0.89;
+    const nw=Math.min(Math.max(vw*k,300),2600),nh=nw*VB.h/VB.w;
+    vx=px-(px-vx)*nw/vw;vy=py-(py-vy)*nh/vh;vw=nw;vh=nh;clamp();apply()},{passive:false});
+  function clamp(){vx=Math.min(Math.max(vx,-800),2200);vy=Math.min(Math.max(vy,-600),1600)}
+  let drag=null;
+  wrap.addEventListener("pointerdown",ev=>{if(ev.button!==0)return;
+    drag={x:ev.clientX,y:ev.clientY};wrap.classList.add("panning")});
+  wrap.addEventListener("pointermove",ev=>{if(!drag)return;
+    const r=wrap.getBoundingClientRect();
+    vx-=(ev.clientX-drag.x)/r.width*vw;vy-=(ev.clientY-drag.y)/r.height*vh;
+    drag={x:ev.clientX,y:ev.clientY};clamp();apply()});
+  window.addEventListener("pointerup",()=>{drag=null;wrap.classList.remove("panning")});
+  window.addEventListener("keydown",ev=>{if(ev.key==="Escape")clearSelect()});
+  apply();
+})();
+/* ---------- mode toggle ---------- */
+function applyMode(){
+  document.body.classList.toggle("eng",mode==="eng");
+  document.getElementById("modeBtn").textContent=mode==="eng"?"Nautical mode":"Engineering mode";
+  document.getElementById("title").textContent=lex("chartroom");
+  localStorage.setItem("chartroom.mode",mode);
+  document.querySelectorAll("[data-lex]").forEach(t=>{t.textContent=lex(t.dataset.lex)});
+  const c=document.querySelector("[data-redynamic]");
+  if(c)c.textContent=`Expedition ${META.expedition} · ${vessels.length} ${lex("vessel").toLowerCase()}s · ${fairways.length} ${lex("fairway").toLowerCase()}s · ${dangers.length} ${lex("danger").toLowerCase()}s`;
+  if(selected)renderDossier(byId.get(selected));else renderBriefing();
+}
+document.getElementById("modeBtn").addEventListener("click",()=>{
+  mode=mode==="nautical"?"eng":"nautical";applyMode()});
+/* ---------- boot ---------- */
+document.getElementById("province").textContent=META.targetPath;
+applyMode();
+</script>
+</body>
+</html>