@floless/app 0.35.0 → 0.36.0

package/dist/floless-server.cjs

@@ -52856,7 +52856,7 @@ function appVersion() {
   return resolveVersion({
     isSea: isSea2(),
     sqVersionXml: readSqVersionXml(),
-    define: true ? "0.35.0" : void 0,
+    define: true ? "0.36.0" : void 0,
     pkgVersion: readPkgVersion()
   });
 }
@@ -52866,7 +52866,7 @@ function resolveChannel(s) {
   return "dev";
 }
 function appChannel() {
-  return resolveChannel({ isSea: isSea2(), define: true ? "0.35.0" : void 0 });
+  return resolveChannel({ isSea: isSea2(), define: true ? "0.36.0" : void 0 });
 }
 
 // oauth-presets.ts
@@ -53759,6 +53759,10 @@ function bakeContractIntoApp(sourcePath, contract) {
 // contract-to-scene.ts
 var FT_TO_MM = 304.8;
 var IN_TO_MM = 25.4;
+function depthPosition(explicit, dzMm, horizMm) {
+  if (explicit === "top" || explicit === "middle" || explicit === "bottom") return explicit;
+  return dzMm > horizMm * 0.5774 ? "middle" : "top";
+}
 function profileDims(profile) {
   if (!profile) return null;
   const p = profile.trim().toUpperCase();
@@ -53826,8 +53830,10 @@ function contractToScene(contractInput) {
       } else {
         const z0 = m.ends?.[0]?.tos != null ? m.ends[0].tos * IN_TO_MM : defaultTosMm;
         const z1 = m.ends?.[1]?.tos != null ? m.ends[1].tos * IN_TO_MM : defaultTosMm;
-        from = [ax, ay, z0];
-        to = [bx, by, z1];
+        const pos = depthPosition(m.position, Math.abs(z1 - z0), Math.hypot(bx - ax, by - ay));
+        const zoff = pos === "top" ? -dims.d / 2 : pos === "bottom" ? dims.d / 2 : 0;
+        from = [ax, ay, z0 + zoff];
+        to = [bx, by, z1 + zoff];
       }
       elements.push({ id: m.id, group: profile, kind: "box", from, to, section: { w: dims.w, d: dims.d }, meta: { profile } });
     }
@@ -58653,6 +58659,8 @@ async function startServer() {
   });
   app.post(
     "/api/contract/:appId/score",
+    { bodyLimit: 25 * 1024 * 1024 },
+    // contracts embed rasters (matches /scene + PUT) — the editor/host-AI POSTs the live contract to score
     async (req, reply) => {
       const doc2 = req.body && "contract" in req.body ? req.body.contract : readContract(req.params.appId);
       if (doc2 == null) return reply.status(404).send({ ok: false, error: "no contract to score" });
@@ -58682,6 +58690,8 @@ async function startServer() {
   );
   app.post(
     "/api/contract/:appId/scene",
+    { 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 doc2 = req.body && "contract" in req.body ? req.body.contract : readContract(req.params.appId);
       if (doc2 == null) return reply.status(404).send({ ok: false, error: "no contract to render" });

package/dist/schemas/steel.takeoff.v1.schema.json

@@ -125,6 +125,7 @@
         },
         "angle": { "enum": ["H", "V", "D"] },
         "role": { "enum": ["beam", "column"], "description": "Defaults to beam when absent." },
+        "position": { "enum": ["top", "middle", "bottom"], "description": "Profile placement relative to the reference line (the work-line between the two work-points), like Tekla's depth position. top = line at the section top (steel hangs below); middle = line through the centroid; bottom = line at the section bottom. When absent the editor defaults a flat beam to top (line = top of steel) and a column / steep brace to middle." },
         "rfi": { "type": "boolean", "description": "True when the size is unresolved (excluded from the BOM)." },
         "mf": { "type": "boolean", "description": "Moment-frame member (persistent flag)." },
         "ends": {

package/dist/skills/floless-app-steel-takeoff/SKILL.md

@@ -222,6 +222,14 @@ Important optional fields:
 Key field rules:
 - All `wp` / `disp` / `a` / `b` coordinates are **display space** (not native PDF coords, not
   millimetres).
+- **Endpoint direction (canonical order).** `wp[0]`/`ends[0]` is the member's **START** (drawn as a
+  **yellow** dot in the editor); `wp[1]`/`ends[1]` is the **END** (drawn **magenta**). Always emit
+  endpoints in a consistent direction so start/end read the same across the whole takeoff:
+  - **Columns** — bottom → top (start at the lower elevation): `wp`/`col` go `bos` (start) → `tos` (end).
+  - **Beams** in plan — **left → right** (start = smaller X); for a vertical-in-plan run, **bottom → up**
+    (start = the lower end on the sheet, i.e. the **larger** display-Y since display Y grows downward).
+  This is the on-screen reading direction (→ or ↑). It costs nothing to get right at authoring time and
+  makes the yellow/magenta end handles meaningful in both the 2D and 3D editor.
 - Elevations are **decimal inches** (canonical); the editor accepts/displays ft-in strings.
   `tosDef: false` means the value came from a drawing callout; `true` means it follows the plan
   default.

package/dist/skills/floless-app-workflows/references/dev-server-and-run-trace.md

@@ -88,8 +88,10 @@ machine via a `self_test:true` watch fixture — no Tekla, no `--simulate`:
 - **The installed SEA server usually already holds :4317** (and it 404s `/api/status` — different
   build). Don't fight it: `index.ts` honors `PORT`, so run the dev server on a free port —
   `PORT=4318 FLOLESS_LICENSE_DIR="$LOCALAPPDATA/FlolessApp-data" npx tsx main.ts --serve` (from
-  `server/`, background). Without the license dir it serves the **sign-in gate** (no `#routines-btn`)
-  — assert `document.getElementById('routines-btn')` exists before driving the panel.
+  `server/`, background). Without the license dir it serves the **sign-in gate** (the workspace
+  chrome is absent) — assert a stable workspace element like `document.getElementById('run-btn')`
+  (or `#menu-btn`) exists before driving the UI. (Don't probe `#routines-btn`/`#browse-btn` —
+  those header buttons moved into the ≡ menu in #149.)
 - **The Playwright MCP browser is flaky/locked here** ("Browser is already in use…"). A **standalone
   Node script is more reliable**: `playwright-core` resolves at
   `C:/Users/Pawel/AppData/Roaming/npm/node_modules/@playwright/cli/node_modules/playwright-core`;

package/dist/web/app.css

@@ -115,7 +115,7 @@
        reachable by scrolling), at viewport widths narrower than the design (#53). */
     min-width: 0;
   }
-  /* Brand + view-toggle stay full size; .controls is the shrink sink instead. */
+  /* The ≡ menu + brand stay full size; .controls is the shrink sink instead. */
   .header-left { display: flex; align-items: center; gap: 10px; flex-shrink: 0; }
   .brand { display: flex; align-items: center; gap: 12px; }
   .brand .mark {
@@ -169,10 +169,8 @@
     outline: 2px solid var(--accent);
     outline-offset: 2px;
   }
-  /* Agents = utility (opens a reference modal, not a workflow step): ghost button,
-     quietest tier. Label kept — an unlabeled icon would be an unclear affordance. */
-  #browse-btn { background: transparent; border-color: transparent; color: var(--text-dim); }
-  #browse-btn:hover { background: var(--surface-2); border-color: var(--border-strong); color: var(--text); }
+  /* (The #browse-btn "Agents" toolbar button moved into the ≡ menu in #149; its
+     ghost-tier styles were removed with it.) */
   /* Simulate mirrors Compile (outline-accent tier) — a consistent secondary
      sibling; Run stays the only filled (primary) button, so the two outline
      buttons reading alike is the correct hierarchy, not a lost signal. */
@@ -1490,10 +1488,8 @@
   #confirm-dont-save:hover { color: var(--err); border-color: var(--err); background: color-mix(in srgb, var(--err) 10%, transparent); }
 
   /* ========== ROUTINES ========== */
-  /* Header entry point: same ghost tier as #browse-btn (Agents) — a utility that
-     opens a management modal, not a workflow step. */
-  #routines-btn { background: transparent; border-color: transparent; color: var(--text-dim); }
-  #routines-btn:hover { background: var(--surface-2); border-color: var(--border-strong); color: var(--text); }
+  /* (The #routines-btn header button moved into the ≡ menu in #149; the panel is
+     opened from there and via Ctrl+R, so its toolbar styles were removed.) */
 
   .modal.routines { width: 600px; max-width: 92vw; max-height: 86vh; display: flex; flex-direction: column; }
   .rtn-quota { font-size: 11px; color: var(--text-dim); margin-bottom: 10px; flex: 0 0 auto; }
@@ -1787,6 +1783,21 @@
     transition: all 0.15s;
     margin-right: 10px;
     flex-shrink: 0;
+    position: relative; /* anchors the dashboard-updated badge below */
+  }
+  /* "Dashboard updated" badge — panels.js lights this when dashboard panels change while
+     the user is on Canvas, so the signal stays visible without opening the ≡ menu (#149,
+     the old Dashboard-toggle dot's new home). Cleared when the dashboard is viewed. */
+  .hamburger.has-dash-update::after {
+    content: "";
+    position: absolute;
+    top: 3px;
+    right: 3px;
+    width: 6px;
+    height: 6px;
+    border-radius: 50%;
+    background: var(--accent);
+    box-shadow: 0 0 0 2px var(--bg);
   }
   .hamburger:hover {
     border-color: var(--accent-dim);
@@ -2881,20 +2892,10 @@ body {
    shipped UI. No new colors, fonts, or aesthetics here — composition only.
    ========================================================================== */
 
-/* Header view switch (Canvas | Dashboard) — compact segmented control next to
-   the brand; reuses the .rtn-mode pill vocabulary at header scale. */
-.view-toggle { display: inline-flex; gap: 4px; margin-left: 16px; }
-.view-btn {
-  background: var(--surface-2); border: 1px solid var(--border-strong);
-  color: var(--text-dim); font-size: 10.5px; text-transform: uppercase;
-  letter-spacing: 0.1em; padding: 4px 12px; border-radius: 6px; cursor: pointer;
-  transition: color 0.15s, border-color 0.15s, background 0.15s;
-}
-.view-btn:hover { color: var(--text); border-color: var(--accent-dim); }
-.view-btn.active { color: var(--accent); border-color: var(--accent-dim); background: var(--accent-soft); }
-.view-btn:focus-visible { outline: 2px solid var(--accent); outline-offset: 2px; }
-/* "Dashboard updated" dot — lit when panels changed while the user was on Canvas. */
-.view-dot { color: var(--accent); font-size: 8px; vertical-align: 2px; margin-left: 5px; }
+/* The Canvas|Dashboard segmented toggle moved into the ≡ menu in #149; its styles are
+   gone. The "dashboard updated" dot lives on now: in the menu's view-switch item (.view-dot)
+   and as the ≡ hamburger badge (.hamburger.has-dash-update, defined above). */
+.view-dot { color: var(--accent); font-size: 8px; vertical-align: 2px; margin-left: auto; padding-left: 6px; }
 .view-dot[hidden] { display: none; }
 
 /* Customized pill — present only while custom panels exist; opens the ext menu. */

package/dist/web/app.js

@@ -50,7 +50,6 @@ function saveCollapse() {
 const $app          = document.getElementById('app');
 const $promptSel    = document.getElementById('prompt-select');
 const $runBtn       = document.getElementById('run-btn');
-const $browseBtn    = document.getElementById('browse-btn');
 const $messages     = document.getElementById('messages');
 const $topology     = document.getElementById('topology');
 const $tabs         = document.getElementById('tabs');
@@ -952,8 +951,6 @@ $runBtn.onclick = async () => {
   appendNarration(`Execution complete · ${nodeIds(p).length} steps fired · check the <strong>Execution</strong> tab on each agent for the full trace.`);
 };
 
-$browseBtn.onclick = openLibrary;
-
 document.querySelectorAll('.panel-toggle').forEach(btn => {
   btn.onclick = () => toggleCollapse(btn.dataset.side);
 });
@@ -1050,6 +1047,7 @@ function handleMenuAction(action) {
     case 'save-as':      doSaveAs(); break;
     case 'find':         openFind(); break;
     case 'integrations': openIntegrations(); break;
+    case 'agents':       openLibrary(); break;
     case 'routines': openRoutines(); break;
     case 'report-issue': openReportIssue(); break;
     case 'fullscreen': toggleFullscreen(); break;
@@ -1546,6 +1544,12 @@ document.addEventListener('keydown', (e) => {
   if (cmd && !e.shiftKey && e.key.toLowerCase() === 's') { e.preventDefault(); doSave(); return; }
   if (cmd && e.key.toLowerCase() === 'f') { e.preventDefault(); openFind(); return; }
   if (cmd && e.key.toLowerCase() === 'i') { e.preventDefault(); openIntegrations(); return; }
+  // Agents and Routines — the panels reachable from the ≡ menu since #149 moved their
+  // toolbar buttons there. Use the same Ctrl-or-Cmd modifier (`cmd`) as Ctrl+O/S/F/I
+  // above, so on macOS these are Cmd+G/Cmd+R. The !e.shiftKey guard leaves the Shift+
+  // hard-reload (Ctrl/Cmd+Shift+R) untouched. Both override a browser default, as O/S do.
+  if (cmd && !e.shiftKey && e.key.toLowerCase() === 'g') { e.preventDefault(); openLibrary(); return; }
+  if (cmd && !e.shiftKey && e.key.toLowerCase() === 'r') { e.preventDefault(); openRoutines(); return; }
   if (cmd && (e.key === '=' || e.key === '+')) { e.preventDefault(); zoomBy(+1); return; }
   if (cmd && e.key === '-') { e.preventDefault(); zoomBy(-1); return; }
   if (cmd && e.key === '0') { e.preventDefault(); resetView(); autoFit = false; return; }

package/dist/web/aware.js

@@ -1848,8 +1848,16 @@
   // `fields`: [{name,label,type,value,placeholder,multiline}]. Resolves with a
   // { name: value } object on Save (Enter), or null on Cancel (Esc / backdrop).
   const $formModal = document.getElementById('form-modal');
+  // The styled modal is a single shared #form-modal. Opening a second one while one is
+  // already up would clobber the first's button/keydown handlers and strand it (#148).
+  // Refuse re-entry: the second caller resolves null (treated as "cancelled") and aborts,
+  // and warns so the drop is observable rather than a silent no-op. The flag is set at the
+  // END of setup (not here) so a synchronous setup error can't latch it shut for the whole
+  // session; done() clears it on every close.
+  let _formModalOpen = false;
   function formModal({ title, sub = '', fields, okLabel = 'Save', danger = false }) {
     return new Promise((resolve) => {
+      if (_formModalOpen) { console.warn('formModal: a modal is already open — refusing re-entry'); resolve(null); return; }
       const $title = document.getElementById('form-modal-title');
       const $sub = document.getElementById('form-modal-sub');
       const $body = document.getElementById('form-modal-body');
@@ -2017,6 +2025,7 @@
         return out;
       };
       const done = (result) => {
+        _formModalOpen = false;
         hideModal($formModal);
         $ok.onclick = null; $cancel.onclick = null; $formModal.onclick = null; $formModal.onkeydown = null; $body.onpaste = null;
         $ok.classList.remove('danger'); $ok.classList.add('primary'); $cancel.classList.remove('primary'); // reset chrome for the next caller
@@ -2032,6 +2041,10 @@
         if (e.key === 'Escape') { e.preventDefault(); done(null); }
         else if (e.key === 'Enter' && !danger && e.target.tagName !== 'TEXTAREA') { e.preventDefault(); done(collect()); }
       };
+      // Setup succeeded and the modal is shown — mark it open now. Setting it here (not
+      // before the synchronous setup above) means a setup throw can't latch the guard for
+      // the whole session; done() clears it on close.
+      _formModalOpen = true;
     });
   }
 
@@ -2689,6 +2702,11 @@
   // installed build exists, show a footer pill → click opens the release-notes
   // popover → Update now → POST /api/update/apply, which downloads + relaunches into
   // the new version. Hidden in dev/npm (supported:false).
+  // Mutual lock across the two footer update flows (#148). A floless self-update downloads
+  // + relaunches the app; an AWARE upgrade reinstalls @aware-aeco/cli in place. Running both
+  // at once can relaunch mid-install or strand a pill on a phantom "↑ Updating…". Only one
+  // update may be in flight at a time — held from the confirm dialog through to completion.
+  let _updateApplying = null; // 'app' | 'aware' | null
   const $appUpdate = document.getElementById('app-update');
   let _appUpdateRecoveryTimer = null; // cleared before each new apply attempt
   // The apply body, extracted so the popover's "Update now" can drive it with the
@@ -2704,10 +2722,14 @@
       showToast('Update in your terminal — ' + cmd, 'info');
       return;
     }
-    // desktop (Velopack): one-click download + relaunch
+    // desktop (Velopack): one-click download + relaunch. Refuse to start while another
+    // update (or this one) is already in flight, so a back-to-back click can't drive two
+    // updates against the shared confirm modal (#148).
+    if (_updateApplying) { showToast('An update is already in progress — please wait for it to complete.', 'info'); return; }
+    _updateApplying = 'app';
     const v = version || '';
     const go = await formModal({ title: 'Update and relaunch', sub: 'FloLess will download v' + v + ', close, and relaunch into the new version.', fields: [], okLabel: 'Update now' });
-    if (!go) return;
+    if (!go) { _updateApplying = null; return; }
     // Record the pending version so the new build's first paint can reveal the
     // what's-new panel (survives the relaunch via localStorage; cleared once shown).
     try { localStorage.setItem('floless.whatsNew.pending', v); } catch { /* private mode */ }
@@ -2727,6 +2749,7 @@
         _appUpdateRecoveryTimer = null;
         if ($appUpdate && $appUpdate.disabled) {
           $appUpdate.disabled = false;
+          _updateApplying = null; // relaunch never happened — release the lock so retry works
           $appUpdate.textContent = '↑ Relaunch failed — retry';
           try { localStorage.removeItem('floless.whatsNew.pending'); } catch { /* private mode */ }
           refreshUpdate(); // re-poll so the pill state reflects reality, same as catch path
@@ -2734,6 +2757,7 @@
       }, 90_000);
     } catch (e) {
       $appUpdate.disabled = false;
+      _updateApplying = null;
       try { localStorage.removeItem('floless.whatsNew.pending'); } catch { /* private mode */ }
       showToast('Update failed — ' + String((e && e.message) || e).slice(0, 80), 'warn');
       refreshUpdate();
@@ -2808,9 +2832,13 @@
   // affordance and shows a brief "installed" confirmation before the pill hides.
   async function applyAwareUpdate(version) {
     if (!$awareUpdate) return;
+    // One update at a time — see _updateApplying (#148). AWARE stays open on success, so the
+    // lock is released in every terminal path below (success, cancel, error).
+    if (_updateApplying) { showToast('An update is already in progress — please wait for it to complete.', 'info'); return; }
+    _updateApplying = 'aware';
     const v = version || '';
     const go = await formModal({ title: 'Upgrade AWARE runtime', sub: 'Reinstalls @aware-aeco/cli to v' + v + ' in place. The app stays open — the version updates automatically when the install finishes.', fields: [], okLabel: 'Upgrade now' });
-    if (!go) return;
+    if (!go) { _updateApplying = null; return; }
     $awareUpdate.disabled = true;
     $awareUpdate.textContent = '↑ Upgrading…';
     try {
@@ -2820,6 +2848,7 @@
       if (!r.ok || !d.ok) throw new Error(d.error || 'aware upgrade failed');
       // Success is silent: the pill disappears and the AWARE version re-stamps live.
       $awareUpdate.disabled = false;
+      _updateApplying = null; // AWARE stays open — release the lock so the app pill can update
       const wv = document.getElementById('aware-version');
       if (wv && d.version) {
         wv.textContent = 'AWARE ' + d.version;
@@ -2836,6 +2865,7 @@
       setTimeout(() => { $awareUpdate.hidden = true; refreshAwareUpdate(); }, 2000);
     } catch (e) {
       $awareUpdate.disabled = false;
+      _updateApplying = null;
       const msg = (e && e.name === 'TimeoutError')
         ? 'AWARE upgrade is taking a while — it may still be installing; the version updates when it finishes'
         : 'AWARE upgrade failed — ' + String((e && e.message) || e).slice(0, 80);
@@ -5253,7 +5283,8 @@
   };
 
   // Wiring (the modal elements are static in index.html, present when this runs).
-  document.getElementById('routines-btn').onclick = () => openRoutines();
+  // The header "Routines" button moved into the ≡ menu (#149); it's opened from there
+  // (data-action="routines") and via Ctrl+R, so there's no toolbar button to wire here.
   document.getElementById('routines-close').onclick = () => hideModal($routinesModal);
   onBackdropDismiss($routinesModal, () => hideModal($routinesModal));
   document.getElementById('rtn-add').onclick = () => openRoutineEdit(null);
@@ -5455,9 +5486,20 @@
   // app.js already stored the ORIGINAL functions as .onclick/.oninput before we
   // reassigned the globals; rebind via arrows so they resolve our versions at
   // call-time (otherwise Save/library-search silently run the demo code).
-  $browseBtn.onclick = () => openLibrary();
+  // The header "⊞ Agents" button moved into the ≡ menu (#149) — openLibrary is now
+  // driven from there (data-action="agents") and via Ctrl+G, so no toolbar button to bind.
   $libSearch.oninput = () => renderLibrary();
 
+  // One-time hint: the Agents/Routines buttons moved into the ≡ menu (#149). Fire once
+  // so existing users (muscle memory) and new users both learn where they are + the
+  // shortcuts. Gated by localStorage like the what's-new panel; private mode → skip.
+  try {
+    if (!localStorage.getItem('floless.hint.menuMoved')) {
+      localStorage.setItem('floless.hint.menuMoved', '1');
+      showToast('Agents and Routines live in the ≡ menu — press Ctrl+G or Ctrl+R to open them.', 'info');
+    }
+  } catch { /* private mode — skip the hint */ }
+
   // Agent Library two-tab wiring (Installed | Available). The Available tab is
   // lazy-loaded on first switch (see switchLibTab).
   const $libTabs = document.getElementById('lib-tabs');

package/dist/web/index.html

@@ -33,13 +33,10 @@
         </span>
         <span class="name">FloLess</span>
         </div>
-        <!-- Workspace view switch (Canvas = the workflow topology; Dashboard = the
-             user's custom panels from ~/.floless/ui/extensions.json). The dot on
-             Dashboard lights when panels changed while the user was on Canvas. -->
-        <div class="view-toggle" id="view-toggle" role="group" aria-label="Workspace view">
-          <button type="button" class="view-btn active" data-view="canvas" aria-pressed="true">Canvas</button>
-          <button type="button" class="view-btn" data-view="dashboard" aria-pressed="false">Dashboard<span class="view-dot" id="dash-dot" hidden aria-label="Dashboard updated">●</span></button>
-        </div>
+        <!-- Workspace view switch (Canvas = the workflow topology; Dashboard = the user's
+             custom panels from ~/.floless/ui/extensions.json) moved into the ≡ menu in #149.
+             The "dashboard updated" signal now rides the ≡ hamburger badge (.has-dash-update)
+             and the menu item's dot (#dash-dot, relocated into the menu). -->
         <!-- Shown only while custom panels exist; opens Undo · History · Reset. -->
         <button type="button" id="ext-badge" class="ext-badge" hidden aria-haspopup="menu" aria-expanded="false" aria-controls="ext-menu" data-tip="Your dashboard is customized — undo, history, reset to default">Customized</button>
       </div>
@@ -57,8 +54,8 @@
           </div>
         </div>
         <select id="prompt-select" hidden></select>
-        <button id="browse-btn" data-tip="Browse all installed agents">⊞ Agents</button>
-        <button id="routines-btn" data-tip="Routines — run a workflow on a schedule or a live trigger">⏱ Routines</button>
+        <!-- Agents (⊞) and Routines (⏱) buttons moved into the ≡ menu in #149
+             (Ctrl+G / Ctrl+R); the toolbar keeps only the run-critical controls. -->
         <span class="ctl-sep" aria-hidden="true"></span>
         <span class="run-state" id="run-state" role="status" aria-live="polite"></span>
         <button id="compile-btn" data-tip="Compile + approve → freeze the .lock">⎙ Compile</button>
@@ -265,7 +262,22 @@
       <span class="menu-label">Find on canvas</span>
       <span class="menu-kbd">Ctrl+F</span>
     </button>
+    <!-- Workspace view switch (was the header Canvas|Dashboard toggle, #149). One
+         contextual item: the label names the OTHER view; the dot lights when the
+         dashboard changed while on Canvas. Wired in panels.js (owns the view state). -->
+    <button class="menu-item" data-action="view-switch" role="menuitem">
+      <span class="menu-icon" aria-hidden="true"><svg viewBox="0 0 24 24"><path d="M8 3 4 7l4 4"/><path d="M4 7h16"/><path d="m16 21 4-4-4-4"/><path d="M20 17H4"/></svg></span>
+      <span class="menu-label" id="menu-view-label">Switch to Dashboard</span>
+      <span class="view-dot" id="dash-dot" hidden aria-label="Dashboard updated">●</span>
+    </button>
     <div class="menu-divider"></div>
+    <!-- Agents library (was the header ⊞ Agents button, #149). Heads the agent group
+         (Agents / Graft into agent / Bake into agent). Ctrl+G. -->
+    <button class="menu-item" data-action="agents" role="menuitem">
+      <span class="menu-icon" aria-hidden="true"><svg viewBox="0 0 24 24"><path d="M12 8V4H8"/><rect width="16" height="12" x="4" y="8" rx="2"/><path d="M2 14h2"/><path d="M20 14h2"/><path d="M15 13v2"/><path d="M9 13v2"/></svg></span>
+      <span class="menu-label">Agents</span>
+      <span class="menu-kbd">Ctrl+G</span>
+    </button>
     <button class="menu-item" data-action="graft" role="menuitem">
       <span class="menu-icon" aria-hidden="true"><svg viewBox="0 0 24 24"><path d="M12 22v-5"/><path d="M15 8V2"/><path d="M17 8a1 1 0 0 1 1 1v4a4 4 0 0 1-4 4h-4a4 4 0 0 1-4-4V9a1 1 0 0 1 1-1z"/><path d="M9 8V2"/></svg></span>
       <span class="menu-label">Graft into agent</span>
@@ -283,6 +295,7 @@
     <button class="menu-item" data-action="routines" role="menuitem">
       <span class="menu-icon" aria-hidden="true"><svg viewBox="0 0 24 24"><line x1="10" x2="14" y1="2" y2="2"/><line x1="12" x2="15" y1="14" y2="11"/><circle cx="12" cy="14" r="8"/></svg></span>
       <span class="menu-label">Routines</span>
+      <span class="menu-kbd">Ctrl+R</span>
     </button>
     <div class="menu-divider"></div>
     <button class="menu-item" data-action="report-issue" role="menuitem">

package/dist/web/panels.js

@@ -28,8 +28,9 @@
 
   const $canvasMain = document.getElementById('canvas-main');
   const $dashboard = document.getElementById('dashboard');
-  const $viewToggle = document.getElementById('view-toggle');
-  const $dashDot = document.getElementById('dash-dot');
+  const $dashDot = document.getElementById('dash-dot');             // the "updated" dot, now in the ≡ menu item
+  const $menuBtn = document.getElementById('menu-btn');             // hosts the dashboard-updated badge (#149)
+  const $menuViewLabel = document.getElementById('menu-view-label'); // the ≡ "Switch to Dashboard/Canvas" label
   const $extBadge = document.getElementById('ext-badge');
   const $extMenu = document.getElementById('ext-menu');
   const $extUndo = document.getElementById('ext-undo');
@@ -38,7 +39,7 @@
   const $centerName = document.getElementById('center-panel-name');
   const $centerRole = document.getElementById('center-panel-role');
   const $resetModal = document.getElementById('ext-reset-modal');
-  if (!$dashboard || !$viewToggle) return; // markup absent — nothing to wire
+  if (!$dashboard) return; // markup absent — nothing to wire
 
   const LS_VIEW = 'floless:view';
   let view = 'canvas';
@@ -65,18 +66,23 @@
   const descriptorInvalid = () => !!(ext.validation && ext.validation.valid === false);
 
   // ── view toggle (Canvas | Dashboard) ─────────────────────────────────────────
+  // The "dashboard updated" signal: a dot on the ≡ menu's view-switch item AND a badge on
+  // the ≡ hamburger, so it's visible without opening the menu (#149 — the old toggle that
+  // hosted the dot is gone).
+  function setDashUpdated(on) {
+    if ($dashDot) $dashDot.hidden = !on;
+    if ($menuBtn) $menuBtn.classList.toggle('has-dash-update', on);
+  }
   function applyView() {
     const dash = view === 'dashboard';
     if ($canvasMain) $canvasMain.classList.toggle('view-dashboard', dash);
     $dashboard.hidden = !dash;
-    $viewToggle.querySelectorAll('.view-btn').forEach((b) => {
-      const on = b.dataset.view === view;
-      b.classList.toggle('active', on);
-      b.setAttribute('aria-pressed', on ? 'true' : 'false');
-    });
+    // The Canvas|Dashboard toggle now lives in the ≡ menu as one contextual item (#149):
+    // its label names the OTHER view — the destination of the switch.
+    if ($menuViewLabel) $menuViewLabel.textContent = dash ? 'Switch to Canvas' : 'Switch to Dashboard';
     if ($centerName) $centerName.textContent = dash ? 'Dashboard' : 'Canvas';
     if ($centerRole) $centerRole.textContent = dash ? 'your panels · composed by your terminal AI' : 'transparency layer · read-mostly';
-    if (dash && $dashDot) $dashDot.hidden = true; // seen — clear the "updated" dot
+    if (dash) setDashUpdated(false); // seen — clear the "updated" signal
   }
   function setView(v) {
     view = v === 'dashboard' ? 'dashboard' : 'canvas';
@@ -84,7 +90,15 @@
     applyView();
     if (view === 'dashboard') renderDashboard();
   }
-  $viewToggle.querySelectorAll('.view-btn').forEach((b) => { b.onclick = () => setView(b.dataset.view); });
+  function toggleView() { setView(view === 'dashboard' ? 'canvas' : 'dashboard'); }
+  // The ≡ menu's "Switch to Dashboard/Canvas" item drives the view (the header toggle was
+  // removed in #149). handleMenuAction lives in app.js and is already wrapped in aware.js
+  // for graft/bake; wrap once more here for view-switch and fall through for everything else.
+  const _prevHandleMenuAction = handleMenuAction;
+  handleMenuAction = function (action) {
+    if (action === 'view-switch') { toggleView(); return; }
+    _prevHandleMenuAction(action);
+  };
 
   // ── block renderers (all output escaped; placeholders over errors) ──────────
   const payloadFor = (source) => (typeof source === 'string' ? ext.data[source] : undefined);
@@ -685,7 +699,7 @@
     renderDashboard();
     // Content changed while the user is on Canvas → light the Dashboard dot
     // (never auto-switch — don't yank their context).
-    if (opts.fromChange && view === 'canvas' && allPanels().length && $dashDot) $dashDot.hidden = false;
+    if (opts.fromChange && view === 'canvas' && allPanels().length) setDashUpdated(true);
     refreshPending();
   }