@floless/app 0.63.0 → 0.64.0

package/dist/floless-server.cjs

@@ -53022,7 +53022,7 @@ function appVersion() {
   return resolveVersion({
     isSea: isSea2(),
     sqVersionXml: readSqVersionXml(),
-    define: true ? "0.63.0" : void 0,
+    define: true ? "0.64.0" : void 0,
     pkgVersion: readPkgVersion()
   });
 }
@@ -53032,7 +53032,7 @@ function resolveChannel(s) {
   return "dev";
 }
 function appChannel() {
-  return resolveChannel({ isSea: isSea2(), define: true ? "0.63.0" : void 0 });
+  return resolveChannel({ isSea: isSea2(), define: true ? "0.64.0" : void 0 });
 }
 
 // workflow-update.ts
@@ -64076,7 +64076,7 @@ async function startServer() {
     { bodyLimit: 25 * 1024 * 1024 },
     // contracts embed rasters (matches PUT /api/contract) — the editor POSTs the live contract on every 3D rebuild
     async (req, reply) => {
-      const doc = req.body && "contract" in req.body ? req.body.contract : readContract(req.params.appId);
+      const doc = req.body && "contract" in req.body ? req.body.contract : readContractForApp(req.params.appId);
       if (doc == null) return reply.status(404).send({ ok: false, error: "no contract to render" });
       if (doc && typeof doc === "object" && doc.type === "drawing.vector/v1") {
         const cleaned = postProcess(doc);

package/dist/skills/floless-app-vectorize/SKILL.md

@@ -1,8 +1,8 @@
 ---
 name: floless-app-vectorize
-description: Vectorize a drawing into an editable drawing.vector/v1 contract in floless.app — the "Vectorize" reader. Triggers on a pending floless `rebake` request for the `vectorize` app (queued from its "Re-read & re-bake ▸" button), or asks like "vectorize this PDF", "turn my sketch into clean CAD linework", "read this detail into vectors", "trace this photo". Teaches the host AI to read a drawing at COMPOSE time — a vector PDF via ONE deterministic PyMuPDF pass (no LLM), a scan/photo/hand sketch via AWARE's fenced vision.extract (schema-bound, cached) — emit the drawing.vector/v1 contract, PUT it to the contract store, and hand the 2D vector editor to the user.
+description: Vectorize a drawing into an editable drawing.vector/v1 contract in floless.app — the "Vectorize" reader. Triggers on a pending floless `rebake` request for the `vectorize` app (queued from its "Re-read & re-bake ▸" button), or asks like "vectorize this PDF", "turn my sketch into clean CAD linework", "read this detail into vectors", "trace this photo", "make this drawing 3D". Teaches the host AI to read a drawing at COMPOSE time — a vector PDF via ONE deterministic PyMuPDF pass (no LLM), a scan/photo/hand sketch via AWARE's fenced vision.extract (schema-bound, cached) — emit the drawing.vector/v1 contract, PUT it to the contract store, and hand the 2D vector editor to the user; and, for a multi-view set (plan + elevation), to classify views, read datums, and declare entities so the server reconstructs a viewable 3D model.
 metadata:
-  version: 0.3.0
+  version: 0.4.0
 ---
 
 # Vectorize — read a drawing into a drawing.vector/v1 contract
@@ -26,8 +26,14 @@ The drawing is read **at compose time**, by one of two paths:
 There is **no model in the run path** either way. The app ships with a tiny hard-coded
 example; this skill is how the user's OWN drawing replaces it.
 
-**Later slices (mention as "next", do not attempt here):** multi-view 3D reconstruction,
-DXF export.
+A **multi-view set** (a plan plus an elevation/section of the same object) can additionally be
+**reconstructed in 3D**: the skill's multi-view pass (step 3c) adds view classification, datums
+and entity declarations to the contract, and the server's deterministic reconstruction renders
+it in the **View 3D** viewer — members and extruded bodies, with everything unplaceable listed
+honestly with a reason.
+
+**Later slices (mention as "next", do not attempt here):** DXF export, placing details into a
+live model.
 
 > **Pasted a request?** If the user pastes a message beginning with a `[floless-request
 > type=rebake id=…]` marker, that's a request copied from the FloLess Dashboard — resolve it
@@ -119,6 +125,50 @@ For each raster image (or rasterized PDF page exported to an image):
    the vision output matches what the drawing actually says. A wildly wrong trace usually means
    the image is too low-contrast — say so rather than shipping garbage.
 
+### 3c. Multi-view pass — make a plan + elevation set 3D (optional)
+
+Run this ONLY when the set contains **multiple views of one object** and the user wants 3D.
+Prerequisite discipline: `reading-structural-drawings` — **massing + coordinate frame FIRST**,
+entities last, cross-validate every view. All fields below are additive on the contract the
+2D pass (3a/3b) already produced; the server's reconstruction (`views-to-scene`) is
+deterministic and **refuses to guess** — anything you leave unresolved lands in the 3D view's
+"Not shown in 3D" list with a reason, never at a made-up position.
+
+1. **Classify every sheet** — set `sheets[].view`:
+   `{ kind: 'plan'|'elevation'|'section'|'detail', dir, datum }`. `dir` is the observer look
+   direction in world axes (a plan looks `-z`; a south elevation looks `+y`; a west-looking
+   section `+x`). **Cross-validate the scale of each axis pair with one known dimension**
+   (a labeled length that appears in both views) before trusting it — a wrong `dir` or scale
+   silently mirrors or misplaces the model. **Show the user the classification and get an OK**
+   ("s1 = plan at 1:50, s2 = south elevation — reconstruct from these?") before writing 3D
+   fields — this is the same confirm gate the steel reader uses before its heavy pass.
+2. **One world frame.** Give every sheet a `transform` (`scale` = world units per display unit,
+   `origin` = the display point that is world [0,0], `rotation` if the frame is turned) chosen
+   so the views AGREE: pick one shared reference (a grid intersection, a corner that appears in
+   both views) as the common origin. World units are the contract's `units` (mm canonical).
+3. **Datums** — read the height ladder off the elevation (level lines + labels) into the
+   top-level `datums: [{ id:'lv1', kind:'level', axis:'z', value:<world units>, label, sheet }]`.
+   Grid lines go in the same array with `axis:'x'|'y'`. Only `z` datums can drive heights.
+4. **Entities** — group the linework into `sheets[].groups`:
+   - a **member** (beam/bar/stud seen along its axis): `axis: [[x0,y0],[x1,y1]]` (this sheet's
+     display coords) + `section: { w, d }` in WORLD units — from a callout or a dimension, never
+     eyeballed;
+   - an **extruded body** (plate/wall/slab footprint): `footprint: [[x,y]…]` +
+     `extrude: { from, to }` where each end is a **z-datum id** or a world number. A present
+     extrude that doesn't resolve is an ERROR (surfaced, not guessed) — omit `extrude` entirely
+     if the height must come from the elevation instead;
+   - annotation groups (labels, dims) get neither — they simply don't build.
+5. **Links** — where a section mark or the drawing itself says two groups are the same object in
+   two views, add `links: [{ kind:'same-entity', a:{sheet,id}, b:{sheet,id} }]` (ids are only
+   sheet-unique — always the composite). A linked elevation entity gives its plan twin the
+   Z extent directly; unlinked entities are matched by their shared horizontal span, and
+   **anything ambiguous (two elevation entities over the same span) is skipped until you link it**.
+6. **PUT** the contract (step 4) and **open View 3D ▸** on the read node. Work the
+   "Not shown in 3D" panel like a worklist: each row says exactly what is missing (a datum, a
+   link, an extrude); fix the contract, re-PUT, reopen. Reconstructed members export through the
+   existing 3D/IFC path later; extruded bodies render in FloLess's own viewer only for now —
+   say so if the user asks about IFC.
+
 ### 4. Write to the contract store
 
 ```
@@ -147,6 +197,9 @@ Tell the user:
 - **Approve & bake lock**: when satisfied, the user clicks Approve in the editor header — it
   bakes the (edited) contract into the `read` node's `config.takeoff` and recompiles, arming
   the Run gate. Never auto-approve on their behalf.
+- **View 3D ▸** (after a multi-view pass, step 3c): the node action opens the read-only
+  reconstruction viewer — orbit/pan/zoom, solid/wire/x-ray, per-group toggles, and the
+  "Not shown in 3D" panel listing every entity that couldn't be placed, with the reason.
 
 ### 6. Clear the request
 

package/dist/web/aware.js

@@ -1360,6 +1360,11 @@
       // openContractEditor() returns false and the click would silently do nothing.
       if (contractType && window.CONTRACT_RENDERERS && window.CONTRACT_RENDERERS[contractType]) {
         addNodeAction(card, 'Edit contract ▸', () => openContractEditor(currentId, contractType));
+        // A renderer with a LOCAL 3D viewer (the drawing.vector reconstruction) gets View 3D via
+        // that page — distinct from the steel `scene` chain below (AWARE exporter companions).
+        if (window.CONTRACT_RENDERERS[contractType].viewerUrl) {
+          addNodeAction(card, 'View 3D ▸', () => openLocalViewer(currentId, contractType));
+        }
         // The 3D/IFC/BOM/Tekla chain derives a scene from the contract — only contract types that
         // declare `scene` support it (a drawing.vector node would 4xx on these endpoints).
         if (window.CONTRACT_RENDERERS[contractType].scene) {
@@ -1770,6 +1775,21 @@
     $contractEditor.hidden = false;
     return true;
   }
+  // A renderer-declared LOCAL viewer page (e.g. the drawing.vector 3D reconstruction) — reuses the
+  // contract-editor overlay/iframe. Read-only: no Approve (the editor owns that gate).
+  function openLocalViewer(appId, type) {
+    const r = window.CONTRACT_RENDERERS && window.CONTRACT_RENDERERS[type];
+    if (!r || !r.viewerUrl) return false;
+    const ap = document.getElementById('contract-editor-approve'); if (ap) ap.hidden = true;
+    $contractEditorTitle.replaceChildren(
+      Object.assign(document.createElement('span'), { textContent: appId, style: 'color:var(--text);font-weight:600' }),
+      Object.assign(document.createElement('span'), { textContent: ' · 3D view', style: 'color:var(--text-muted)' }),
+    );
+    $contractEditorFrame.onload = () => { try { $contractEditorFrame.contentWindow.focus(); } catch (_) {} };
+    $contractEditorFrame.src = r.viewerUrl(appId);
+    $contractEditor.hidden = false;
+    return true;
+  }
   // The steel filter pre-stage view — reuses the contract-editor overlay/iframe to load the served
   // steel-filter.html (layer/thickness/colour facets + eyedropper). Same seam as the editor: the
   // iframe talks to /api/contract directly and Save writes contract.filter.

package/dist/web/renderers.js

@@ -19,6 +19,9 @@ window.CONTRACT_RENDERERS = {
   },
   'drawing.vector/v1': {
     editorUrl: (appId) => '/vector-editor.html?app=' + encodeURIComponent(appId),
+    // Local read-only 3D reconstruction viewer (views-to-scene) — NOT the AWARE exporter chain
+    // (`scene`), which only steel supports; extrusion bodies render floless-side only for now.
+    viewerUrl: (appId) => '/vector-3d.html?app=' + encodeURIComponent(appId),
   },
 };
 

package/dist/web/steel-3d-view.js

@@ -280,6 +280,43 @@ function placePlate(mesh, el) {
   mesh.position.set(...(el.center || [0, 0, 0]));
 }
 
+// Signed area of a closed 2D polygon (shoelace) — used to reject a zero-area/collinear footprint.
+function shoelaceArea(pts) {
+  let a = 0;
+  for (let i = 0, n = pts.length; i < n; i++) {
+    const p = pts[i], q = pts[(i + 1) % n];
+    a += p[0] * q[1] - q[0] * p[1];
+  }
+  return a / 2;
+}
+
+// A vertical extrusion of an arbitrary world-XY footprint between two Z values — the multi-view
+// reconstruction's generic body (a plate, wall or slab read from a plan + elevation; see
+// server/views-to-scene.ts). Same ExtrudeGeometry recipe as placePlate, but the outline is the
+// element's own polygon in WORLD coordinates and the sweep is always +Z, so no basis rotation.
+function placeExtrusion(mesh, el) {
+  const fp = el.footprint || [];
+  // Reject a degenerate outline (fewer than 3 vertices, or a zero-area collinear loop by the
+  // shoelace test) — ExtrudeGeometry on it produces a NaN/empty body, not an honest shape.
+  if (fp.length < 3 || Math.abs(shoelaceArea(fp)) < 1e-6) { mesh.geometry = new THREE.BufferGeometry(); return; }
+  const shape = new THREE.Shape();
+  shape.moveTo(fp[0][0], fp[0][1]);
+  for (let i = 1; i < fp.length; i++) shape.lineTo(fp[i][0], fp[i][1]);
+  shape.closePath();
+  for (const h of el.holes || []) { // optional opening loops (same world-XY polygon form)
+    if (!h || h.length < 3) continue;
+    const hole = new THREE.Path();
+    hole.moveTo(h[0][0], h[0][1]);
+    for (let i = 1; i < h.length; i++) hole.lineTo(h[i][0], h[i][1]);
+    hole.closePath();
+    shape.holes.push(hole);
+  }
+  const z0 = Math.min(el.from || 0, el.to || 0), z1 = Math.max(el.from || 0, el.to || 0);
+  mesh.geometry = new THREE.ExtrudeGeometry(shape, { depth: Math.max(z1 - z0, 0.5), bevelEnabled: false });
+  mesh.quaternion.identity();
+  mesh.position.set(0, 0, z0); // the shape carries world XY; lift the slab to its bottom face
+}
+
 // A cylinder between two points (anchor rod / bolt shank).
 function placeBar(mesh, a, b, r, radial) {
   const A = V(a[0], a[1], a[2]), B = V(b[0], b[1], b[2]);
@@ -331,6 +368,7 @@ function placeWasher(mesh, el) {
 function placeElement(mesh, el) {
   switch (el.kind || 'box') {
     case 'box': placeMember(mesh, el.from, el.to, el); return true;
+    case 'extrusion': placeExtrusion(mesh, el); return true;
     case 'plate': placePlate(mesh, el); return true;
     case 'rod': placeBar(mesh, el.from, el.to, Math.max((el.d || 20) / 2, 0.5), 16); return true;
     case 'nut': placeNut(mesh, el); return true;
@@ -2200,7 +2238,9 @@ function updateStatusChip() {
   else if (showId) { const m = members().find((x) => x.id === showId); txt = m ? `${m.id} · ${m.profile || '—'}` : ''; }
   else if (selIds.size > 1) txt = `${selIds.size} members selected`;
   else if (isolatedIds) txt = `Isolated: ${isolatedIds.size} · Show all to restore`;
-  else txt = 'Drag to move · ends to stretch · Alt+drag elevation · right-drag orbit · dbl-click to zoom in';
+  // A read-only host (the vector 3D viewer) supplies its own idle hint — the default speaks
+  // editing verbs (move/stretch/elevate) that a viewer's no-op api would silently ignore.
+  else txt = (api && typeof api.statusHint === 'function' && api.statusHint()) || 'Drag to move · ends to stretch · Alt+drag elevation · right-drag orbit · dbl-click to zoom in';
   hoverChip.textContent = txt;
   hoverChip.style.left = (rect.left + rect.width / 2) + 'px'; hoverChip.style.transform = 'translateX(-50%)';
   hoverChip.style.top = (rect.bottom - 30) + 'px';

package/dist/web/vector-3d.html

@@ -0,0 +1,242 @@
+<!doctype html>
+<html lang="en">
+<head>
+<meta charset="utf-8">
+<meta name="viewport" content="width=device-width, initial-scale=1">
+<title>Vectorize — 3D view</title>
+<style>
+  /* Locked baseline: shadcn dark slate-blue (same tokens + scrollbar theming as the sibling editors). */
+  :root{--bg:#0f172a;--panel:#1e293b;--line:#334155;--text:#e2e8f0;--mut:#94a3b8;--brand:#3b82f6}
+  *{scrollbar-width:thin;scrollbar-color:#475569 transparent}
+  *::-webkit-scrollbar{width:10px;height:10px}
+  *::-webkit-scrollbar-track{background:transparent}
+  *::-webkit-scrollbar-thumb{background:#475569;border-radius:6px;border:2px solid transparent;background-clip:content-box}
+  *::-webkit-scrollbar-thumb:hover{background:#5b6b85;background-clip:content-box}
+  *::-webkit-scrollbar-corner{background:transparent}
+  *{box-sizing:border-box}
+  body{margin:0;background:var(--bg);color:var(--text);font:13px system-ui;height:100vh;display:flex;flex-direction:column;overflow:hidden}
+  header{display:flex;align-items:center;gap:14px;padding:8px 14px;background:var(--panel);border-bottom:1px solid var(--line);flex:none}
+  header b{font-size:14px}
+  header .spacer{flex:1}
+  .stat{color:var(--mut)} .stat b{color:var(--text);font-variant-numeric:tabular-nums}
+  /* The unplaced-entities chip — amber "needs review" language (never red: honesty, not error). */
+  #skipChip{display:inline-flex;align-items:center;gap:6px;background:transparent;border:1px solid var(--line);color:#f59e0b;border-radius:6px;padding:4px 10px;font:inherit;cursor:pointer}
+  #skipChip:hover{border-color:#f59e0b}
+  #skipChip[hidden]{display:none} /* the id's display beats the [hidden] UA rule — restore it */
+  /* Full-bleed canvas. Wrapper bg matches the Three.js clear color EXACTLY (#020817) so the brief
+     WebGL-init frame never flashes a seam against the app --bg. */
+  #wrap{flex:1;position:relative;min-height:0;background:#020817}
+  #stage3d{position:absolute;inset:0;width:100%;height:100%;outline:none}
+  #state{position:absolute;inset:0;display:none;align-items:center;justify-content:center;flex-direction:column;gap:10px;background:var(--bg);color:var(--mut);text-align:center;padding:24px;z-index:4}
+  #state.show{display:flex}
+  #state .spin{width:26px;height:26px;border:3px solid var(--line);border-top-color:var(--brand);border-radius:50%;animation:spin .8s linear infinite}
+  #state .msg{max-width:520px;line-height:1.55}
+  #state .msg b{color:var(--text)}
+  @keyframes spin{to{transform:rotate(360deg)}}
+  /* Floating toolbar pill, top-left (the established 3D slot). */
+  #bar{position:absolute;top:12px;left:12px;display:flex;gap:6px;align-items:center;z-index:5}
+  #bar .seg-group{display:inline-flex;border:1px solid var(--line);border-radius:6px;overflow:hidden;background:var(--panel);box-shadow:0 4px 14px rgba(0,0,0,.45)}
+  #bar .seg-group button{padding:5px 11px;margin:0;border:0;border-radius:0;background:transparent;color:var(--mut);font:600 12px system-ui;cursor:pointer}
+  #bar .seg-group button+button{border-left:1px solid var(--line)}
+  #bar .seg-group button:hover{color:var(--text)}
+  #bar .seg-group button.on{background:#0f172a;color:var(--text);box-shadow:inset 0 -2px 0 var(--brand)}
+  #bar>button{background:var(--panel);border:1px solid var(--line);border-radius:6px;color:var(--text);font:600 12px system-ui;padding:5px 11px;cursor:pointer;box-shadow:0 4px 14px rgba(0,0,0,.45)}
+  #bar>button:hover{border-color:var(--brand)}
+  #bar .tb-sep{width:1px;height:18px;background:var(--line);flex:0 0 auto}
+  /* Group visibility toggles folded INLINE into the pill (leaves bottom-left to the skip panel). */
+  #bar .gck{display:inline-flex;align-items:center;gap:6px;background:var(--panel);border:1px solid var(--line);border-radius:6px;padding:4px 9px;box-shadow:0 4px 14px rgba(0,0,0,.45);cursor:pointer;color:var(--text);font-size:12px}
+  #bar .gck input{accent-color:var(--brand);cursor:pointer;margin:0}
+  #bar .gck .ct{color:var(--mut);font-variant-numeric:tabular-nums;font-size:11px}
+  #bar .gck .sw{width:9px;height:9px;border-radius:2px;flex:none}
+  /* The unplaced-entities panel, docked bottom-left. Glanceable (never a modal — it coexists with
+     the scene it annotates). Inner list scrolls with the themed scrollbar. */
+  #skipPanel{position:absolute;left:12px;bottom:12px;width:380px;max-width:calc(100% - 24px);background:var(--panel);border:1px solid var(--line);border-radius:8px;box-shadow:0 8px 24px rgba(0,0,0,.5);z-index:5;display:none}
+  #skipPanel.open{display:block}
+  #skipPanel h3{margin:0;padding:9px 12px 4px;font-size:11px;color:var(--mut);text-transform:uppercase;letter-spacing:.06em}
+  #skipPanel .hint{padding:0 12px 7px;color:var(--mut);font-size:12px;line-height:1.45}
+  #skipList{max-height:200px;overflow:auto;padding:0 6px 8px;display:flex;flex-direction:column;gap:2px}
+  .srow{display:flex;align-items:baseline;gap:6px;padding:4px 6px;border-radius:6px;font-size:12px}
+  .srow:hover{background:var(--line)}
+  .srow .sid{color:#f59e0b;flex:none;font-variant-numeric:tabular-nums}
+  .srow .rsn{color:var(--text);overflow:hidden;text-overflow:ellipsis;white-space:nowrap}
+</style>
+</head>
+<body>
+  <header>
+    <b>Vectorize — 3D</b>
+    <span class="stat" id="title">—</span>
+    <span class="spacer"></span>
+    <span class="stat"><b id="nBoxes">0</b> members · <b id="nExtr">0</b> bodies</span>
+    <button id="skipChip" hidden>⚠ <b id="nSkipped">0</b> unplaced</button>
+  </header>
+  <div id="wrap">
+    <canvas id="stage3d"></canvas>
+    <div id="bar" hidden>
+      <div class="seg-group" id="projSeg">
+        <button data-proj="persp" class="on" title="Perspective view — natural depth">Persp</button>
+        <button data-proj="ortho" title="Orthographic — true scale, no perspective">Ortho</button>
+      </div>
+      <button id="fitBtn" title="Fit all to view">Fit</button>
+      <span class="tb-sep"></span>
+      <div class="seg-group" id="modeSeg">
+        <button data-mode="solid" class="on" title="Solid shaded model">Solid</button>
+        <button data-mode="wire" title="Wireframe — edges only">Wire</button>
+        <button data-mode="xray" title="See-through — reveal hidden parts">X-ray</button>
+      </div>
+      <span class="tb-sep"></span>
+      <span id="groupToggles"></span>
+    </div>
+    <div id="skipPanel">
+      <h3 id="skipTitle">Not shown in 3D</h3>
+      <div class="hint">These couldn't be matched to a 3D position. Fix the reason below, then reopen this view.</div>
+      <div id="skipList"></div>
+    </div>
+    <div id="state" class="show" role="status" aria-live="polite"><div class="spin"></div><div class="msg" id="stateMsg">Reconstructing…</div></div>
+  </div>
+<script type="importmap">{"imports":{"three":"./vendor/three.module.js","three/addons/":"./vendor/","three-bvh-csg":"./vendor/three-bvh-csg.module.js"}}</script>
+<script type="module" src="./steel-3d-view.js"></script>
+<script type="module">
+(function poll(waited) { // steel-3d-view registers window.Steel3DView on module load — wait for it
+  if (window.Steel3DView) { boot(window.Steel3DView); return; }
+  if (waited > 8000) { // the module never loaded (bad vendor path / script error) — don't spin forever
+    document.getElementById('stateMsg').textContent = 'Could not load the 3D viewer. Reload the page, or check the console.';
+    document.getElementById('state').querySelector('.spin').style.display = 'none';
+    return;
+  }
+  setTimeout(() => poll((waited || 0) + 20), 20);
+})(0);
+
+function boot(v3d) {
+  const $ = (id) => document.getElementById(id);
+  const params = new URLSearchParams(location.search);
+  const app = params.get('app');
+  let scene = null;
+  let skipped = [];
+
+  function showState(msgNode, spinning) {
+    $('stateMsg').replaceChildren(msgNode);
+    $('state').classList.add('show');
+    $('state').querySelector('.spin').style.display = spinning ? '' : 'none';
+  }
+  function hideState() { $('state').classList.remove('show'); }
+
+  // The read-only host api: the module's editing/dim/snap hooks are inert here — a viewer never
+  // mutates the contract. fetchScene serves the one scene this page already loaded.
+  const api = {
+    fetchScene: async () => scene,
+    getMembers: () => [],
+    ptPerFt: () => 1,
+    defaultTosMm: () => 0,
+    geoMode: () => null,
+    fmtLen: (mm) => `${Math.round(mm)} mm`,
+    getDimOverlays: () => [],
+    getDims3d: () => [],
+    selDim3d: () => [],
+    newDim3dId: () => 'd0',
+    onSelect: () => {}, onSelectMany: () => {}, onSelectDim3d: () => {}, onAddDim3d: () => {},
+    onMoveMember: () => {}, onMoveEndpoint: () => {}, onElevateMember: () => {}, onSplit: () => {},
+    onTrimExtend: () => {}, onIsolateChange: () => {}, onClipModeChange: () => {}, onClipsChange: () => {},
+    onWorkAreaChange: () => {}, beginClipEdit: () => {},
+    statusHint: () => 'Right-drag orbit · middle-drag pan · wheel zoom · dbl-click to zoom in',
+  };
+
+  function emptyStateNode() {
+    // Plain AEC language — a cold empty state must not lean on schema vocabulary (per design consult).
+    // Two distinct zero-element cases: NOTHING was declared as a 3D entity (cold set), vs entities
+    // were read but NONE could be placed (all skipped) — the honest message differs.
+    const d = document.createElement('div');
+    const b = document.createElement('b');
+    const p = document.createElement('div');
+    p.style.marginTop = '8px';
+    if (skipped.length > 0) {
+      b.textContent = skipped.length === 1
+        ? 'Nothing placed in 3D yet — the one entity read couldn’t be placed.'
+        : `Nothing placed in 3D yet — all ${skipped.length} entities are unplaced.`;
+      p.textContent = 'Each one is listed with the reason in the "Not shown in 3D" panel — usually a missing height (a level datum, an extrude value, or a matching elevation). Fix the reasons and reopen this view.';
+    } else {
+      b.textContent = 'No 3D yet — this drawing set doesn’t have matched plan and elevation sheets.';
+      p.textContent = '3D reconstruction needs at least one plan sheet and one elevation (or section) sheet that share entities, so heights can be worked out from the elevation. Classify your sheets as plan/elevation and make sure floor levels or extrude heights are set, then reopen this view — or ask your terminal AI to do it.';
+    }
+    d.append(b, p);
+    return d;
+  }
+
+  function renderSkipPanel() {
+    const chip = $('skipChip');
+    chip.hidden = skipped.length === 0;
+    $('nSkipped').textContent = skipped.length;
+    $('skipTitle').textContent = `Not shown in 3D (${skipped.length})`;
+    const list = $('skipList');
+    while (list.firstChild) list.removeChild(list.firstChild);
+    for (const s of skipped) {
+      const row = document.createElement('div'); row.className = 'srow';
+      const sid = document.createElement('span'); sid.className = 'sid'; sid.textContent = s.id;
+      const rsn = document.createElement('span'); rsn.className = 'rsn'; rsn.textContent = s.reason; rsn.title = s.reason;
+      row.append(sid, rsn); list.appendChild(row);
+    }
+  }
+
+  function renderGroupToggles() {
+    const box = $('groupToggles');
+    while (box.firstChild) box.removeChild(box.firstChild);
+    const counts = new Map();
+    for (const el of scene.elements) counts.set(el.group, (counts.get(el.group) || 0) + 1);
+    for (const g of v3d.getGroups()) {
+      const lab = document.createElement('label'); lab.className = 'gck';
+      const inp = document.createElement('input'); inp.type = 'checkbox'; inp.checked = true;
+      inp.addEventListener('change', () => v3d.toggleGroup(g.key));
+      const sw = document.createElement('span'); sw.className = 'sw'; sw.style.background = g.color;
+      const nm = document.createElement('span'); nm.textContent = g.label;
+      const ct = document.createElement('span'); ct.className = 'ct'; ct.textContent = String(counts.get(g.key) || 0);
+      lab.append(inp, sw, nm, ct); box.appendChild(lab);
+    }
+  }
+
+  $('fitBtn').addEventListener('click', () => v3d.frameAll());
+  $('projSeg').addEventListener('click', (e) => {
+    const b = e.target.closest('button'); if (!b) return;
+    v3d.setProjection(b.dataset.proj);
+    for (const x of $('projSeg').children) x.classList.toggle('on', x === b);
+  });
+  $('modeSeg').addEventListener('click', (e) => {
+    const b = e.target.closest('button'); if (!b) return;
+    v3d.setDisplayMode(b.dataset.mode);
+    for (const x of $('modeSeg').children) x.classList.toggle('on', x === b);
+  });
+  $('skipChip').addEventListener('click', () => $('skipPanel').classList.toggle('open'));
+
+  (async () => {
+    if (!app) { showState(document.createTextNode('No app given — open this view from a workflow node.'), false); return; }
+    let out;
+    try {
+      const r = await fetch('/api/contract/' + encodeURIComponent(app) + '/scene', {
+        method: 'POST', headers: { 'content-type': 'application/json' }, body: '{}',
+      });
+      out = await r.json();
+      if (!r.ok || !out.ok) throw new Error(out.error || ('HTTP ' + r.status));
+    } catch (e) {
+      showState(document.createTextNode('Could not reconstruct the drawing (' + e.message + ').'), false);
+      return;
+    }
+    scene = out.scene;
+    skipped = Array.isArray(out.skipped) ? out.skipped : [];
+    const name = (scene.meta && scene.meta.name) || app;
+    $('title').textContent = name;
+    document.title = 'Vectorize — 3D · ' + name;
+    const boxes = scene.elements.filter((e) => e.kind === 'box').length;
+    const extr = scene.elements.filter((e) => e.kind === 'extrusion').length;
+    $('nBoxes').textContent = boxes; $('nExtr').textContent = extr;
+    renderSkipPanel();
+    if (skipped.length) $('skipPanel').classList.add('open'); // partial/failed reconstruction: lead with honesty
+    if (scene.elements.length === 0) { showState(emptyStateNode(), false); return; } // (chip + panel still show above #state)
+    v3d.init($('stage3d'), api);
+    v3d.show();
+    await v3d.rebuild(true); // fit the camera on first build
+    renderGroupToggles();
+    $('bar').hidden = false;
+    hideState();
+  })();
+}
+</script>
+</body>
+</html>

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@floless/app",
-  "version": "0.63.0",
+  "version": "0.64.0",
   "type": "module",
   "description": "Thin localhost host for floless.app — serves web/ and shells the aware CLI. No engine, no LLM.",
   "bin": {