@nelsonlongxiang/dsh-open-a2a-net 0.6.28 → 0.6.29

package/nexus-stage/src/planning-view.ts

@@ -36,11 +36,17 @@ import {
   type RemoteTeamRow,
 } from './federation'
 import { clampViewport, fitView, panBy, screenToWorld, worldTransformCss, zoomAt, type LayoutViewport } from './viewport'
+import { boardBounds, fitBelowHud, hudBottomOf } from './planning-fit'
 import { WorldModel, nodeRect, deriveInitialFrame, homeTeams, planSeatClear, planTeamClusters, NODE_W, NODE_H } from './world'
 import { applyAction, actionTeam, innermostFrameAt, reorderOps, yOrderedMembers, type CanvasAction } from './canvas-ops'
 import { FRAME_HUES } from './tokens'
 import { createPlanningMenus } from './planning-menus'
+import { createNodeFlyer, mountBoardSearch } from './planning-search'
+import { applyBoardRelayout } from './planning-relayout'
+import { settleBoard, tidyMembers } from './planning-overlap'
 import { createNodeList } from './planning-nodelist'
+import { cardText } from './planning-card-text'
+import { createLegend } from './planning-legend'
 import { viewportBucket, type PlanningDeps, type PlanningInput, type PlanningSession, type PlanningTeam, type PlanningView, type SeamKey, type SeamPointer, type ViewportBucket } from './planning-types'
 import './planning.css'
 
@@ -78,6 +84,7 @@ export function createPlanningView(deps: PlanningDeps): PlanningView {
   let renderedRevision = -1
   /** Until the first reconcile with nodes (or an adopted viewport), frame the content once. */
   let firstFitPending = true
+  let settledOnce = false
   let viewportAdopted = false
   const bucket = (): ViewportBucket => viewportBucket(globalThis.innerWidth || viewW)
   const markDirty = (): void => {
@@ -151,11 +158,15 @@ export function createPlanningView(deps: PlanningDeps): PlanningView {
     b.addEventListener('click', onClick, signal)
     return b
   }
+  // Review 2026-10-27: the toolbar reads as three groups — view | arrange |
+  // network — split by separators; every action stays one click (owner orders).
+  const sep = (): HTMLElement => { const s = document.createElement('span'); s.className = 'p-sep'; s.setAttribute('role', 'separator'); s.setAttribute('aria-orientation', 'vertical'); return s }
   toolbar.append(
     mkButton('适配', '适配视图（快捷键 0）', () => fitToContent()),
     mkButton('－', '缩小', () => zoomCenter(1 / 1.2)),
     zoomLabel,
     mkButton('＋', '放大', () => zoomCenter(1.2)),
+    sep(),
     mkButton('建队', '组成团队（G）：先框选至少 2 个节点', () => menus.startCreateFromSelection()),
     // gh#48 (owner order, review-seat spec): one-click tidy — inside every
     // team frame, the members that belong to EXACTLY that one team re-seat
@@ -165,6 +176,13 @@ export function createPlanningView(deps: PlanningDeps): PlanningView {
     // ride the same rule; the move persists through the ordinary layout
     // save loop exactly like a hand drag.
     mkButton('整理成员', '每队框内仅属一队的成员自动排齐（多队成员不动）', () => tidyTeamMembers()),
+    // Supervisor order v2 (upgrades gh#48): one-click WHOLE-BOARD relayout —
+    // the two buttons split the job (整理成员 = cards inside one frame;
+    // 一键重排 = every local frame AND its cards). Frame size derives from
+    // content (width and height both); frames tile in a row flow
+    // (constructively disjoint); multi-team members never enter the size
+    // math and never move; remote org frames and frameless nodes stay put.
+    mkButton('一键重排', '全板队框+成员重排：框尺寸随内容自适应、框位行流式平铺（远端队框与多归属成员不动）', () => relayoutBoard()),
   )
   // Unjoined sessions ride a toolbar chip + dropdown: the panel-slim
   // migration made the planning view the join surface — without this, an
@@ -172,7 +190,8 @@ export function createPlanningView(deps: PlanningDeps): PlanningView {
   const netBtn = mkButton('未入网', '未入网会话（点击选择入网）', () => menus.toggleNetMenu())
   netBtn.className = 'p-netbtn'
   netBtn.setAttribute('aria-haspopup', 'menu')
-  toolbar.appendChild(netBtn)
+  toolbar.append(sep(), netBtn)
+  const search = mountBoardSearch(toolbar, model, displayName, id => flyToNode(id))
   // Node list (network-membership-display): the canvas shows teamed nodes
   // only; every other session — teamless joined, unjoined, and each peer's
   // published nodes — is managed from this list, switched by host.
@@ -218,20 +237,8 @@ export function createPlanningView(deps: PlanningDeps): PlanningView {
     if (e.key === 'Enter' || e.key === ' ') { e.preventDefault(); flyToFederation() }
   }, signal)
 
-  const legend = document.createElement('div')
-  legend.className = 'p-legend'
-  const legendRow = (dashed: boolean, text: string, color?: string): void => {
-    const row = document.createElement('span')
-    const bar = document.createElement('i')
-    if (dashed) bar.className = 'dashed'
-    if (color !== undefined) bar.style.borderTopColor = color
-    row.append(bar, document.createTextNode(text))
-    legend.appendChild(row)
-  }
-  legendRow(false, '成员边（星形，框→成员）')
-  legendRow(true, '跨队多属（虚线）')
-  legendRow(false, '活动边（inFlight 路由，瞬时）', 'var(--accent)')
-  legendRow(true, '联邦线（→peer）', 'var(--federal)')
+  // Edge key: a closed-by-default fold (planning-legend), not a fixed panel.
+  const legend = createLegend()
 
   const noticeStack = document.createElement('div')
   noticeStack.className = 'p-notice-stack'
@@ -269,31 +276,22 @@ export function createPlanningView(deps: PlanningDeps): PlanningView {
    * — the same persistence path a hand drag takes.
    */
   function tidyTeamMembers(): void {
-    const PAD = 28
-    const GAP_X = 16
-    const GAP_Y = 14
-    for (const [name, rect] of model.allFrames()) {
-      const members = model.teamMemberIds(name)
-      const sole = members
-        .map(id => model.getNode(id))
-        .filter((n): n is NonNullable<typeof n> => n !== undefined)
-        .filter(n => n.memberships.length === 1)
-      if (sole.length === 0) continue // empty frame / only shared members: untouched
-      const perRow = Math.max(1, Math.floor((rect.w - 2 * PAD + GAP_X) / (NODE_W + GAP_X)))
-      const rows = Math.ceil(sole.length / perRow)
-      const needed = PAD * 2 + rows * NODE_H + (rows - 1) * GAP_Y
-      if (needed > rect.h) {
-        model.setFrame(name, { ...rect, h: Math.min(needed, rect.h + 400) })
-      }
-      const startX = rect.x + PAD + NODE_W / 2
-      let y = rect.y + PAD + NODE_H / 2
-      sole.forEach((n, i) => {
-        const col = i % perRow
-        if (i > 0 && col === 0) y += NODE_H + GAP_Y
-        const x = startX + col * (NODE_W + GAP_X)
-        model.dragNodes([n.id], x - n.x, y - n.y)
-      })
-    }
+    tidyMembers(model) // gh#48 grid (planning-overlap); then nothing may overlap
+    settleBoard(model, new Set(remoteFramesRef.keys()))
+    markDirty()
+    render()
+  }
+
+  /**
+   * Supervisor order v2: whole-board deterministic relayout (the planner
+   * and the model adapter live in planning-relayout.ts): LOCAL frames +
+   * sole members only — remote org frames keep gh#44 live-rect-wins,
+   * frameless nodes and multi-team members never move; the same
+   * markDirty()/render() persistence path a hand drag takes.
+   */
+  function relayoutBoard(): void {
+    if (!applyBoardRelayout(model, new Set(remoteFramesRef.keys()))) return
+    settleBoard(model, new Set(remoteFramesRef.keys())) // vs remote frames + stray cards
     markDirty()
     render()
   }
@@ -381,16 +379,6 @@ export function createPlanningView(deps: PlanningDeps): PlanningView {
     }
   }
 
-  /** Remote card sub line: score + remote team count/names behind this peer. */
-  function remoteSubText(host: string): string {
-    const rows = lastRemoteTeams.get(host) ?? []
-    const names = rows.map(r => r.name !== undefined && r.name !== '' ? r.name : r.team)
-    const head = names.slice(0, 2).join('、')
-    const more = names.length > 2 ? ` +${names.length - 2}` : ''
-    const score = peerScoreByText.get(host)
-    return (score !== undefined ? `score ${score} · ` : '') + `${rows.length} 远端团队` + (head !== '' ? `：${head}${more}` : '')
-  }
-
   /** The mono route line `<host>/canvas/<name>` when the payload carries it. */
   function routeText(name: string): string {
     const t = lastTeams.find(x => x.name === name)
@@ -431,25 +419,13 @@ export function createPlanningView(deps: PlanningDeps): PlanningView {
       el.classList.toggle('selected', model.isSelected(n.id))
       el.setAttribute('aria-selected', String(model.isSelected(n.id)))
       const host = n.id.slice('peer-'.length)
-      // gh#38: member cards show their display NAME as the title (the whole
-      // point is picking a person); peer HOST cards keep the host spelling.
-      const nmText = n.id.startsWith('member-')
-        ? (n.name !== undefined && n.name !== '' ? n.name : n.team)
-        : n.remote === true ? host : displayName(n)
+      // Title / second line / tooltip rules: planning-card-text.
+      const txt = cardText(n, n.remote === true ? lastRemoteTeams.get(host) ?? [] : [], peerScoreByText.get(host))
       const nmEl = el.querySelector<HTMLElement>('.nm-text')!
-      if (nmEl.textContent !== nmText) nmEl.textContent = nmText
+      if (nmEl.textContent !== txt.title) nmEl.textContent = txt.title
       const subEl = el.querySelector<HTMLElement>('.sub')!
-      const subBase = n.team + (n.name !== undefined && n.name !== '' ? ' · ' + n.name : '')
-      // When the title fell back to the team label the sub line would repeat
-      // it verbatim; collapse to the cross-team suffix alone in that case.
-      const subText = n.id.startsWith('member-')
-        ? n.team
-        : n.remote === true
-          ? remoteSubText(host)
-          : (subBase === nmText ? '' : subBase)
-            + (n.memberships.length > 1 ? ` · 跨队×${n.memberships.length}` : '')
-            + (n.teams !== undefined && n.teams.length > 0 ? ` · 网络队×${n.teams.length}` : '')
-      if (subEl.textContent !== subText) subEl.textContent = subText
+      if (subEl.textContent !== txt.sub) subEl.textContent = txt.sub
+      if (el.title !== txt.tip) el.title = txt.tip
       const prioEl = el.querySelector<HTMLElement>('.prio')!
       if (n.remote === true) {
         // gh#20 W-A: the peer badge — link class colors the chip (linked
@@ -470,6 +446,7 @@ export function createPlanningView(deps: PlanningDeps): PlanningView {
     for (const [id, el] of [...nodeEls]) {
       if (!seen.has(id)) { el.remove(); nodeEls.delete(id) }
     }
+    search.refresh()
   }
 
   // ── edges: stateless, rebuilt wholesale ──
@@ -515,6 +492,8 @@ export function createPlanningView(deps: PlanningDeps): PlanningView {
     markDirty()
   }
 
+  /** W1 pick: frame one node at ~100% and pulse its card. */
+  const flyToNode = createNodeFlyer({ model, viewSize: measure, setVp: next => { vp = next }, applyViewport, markDirty, cardEl: id => nodeEls.get(id) })
   // ── status counts ──
   function renderStatus(input: PlanningInput): void {
     const live = input.sessions.filter(s => s.live !== false).length
@@ -595,7 +574,7 @@ export function createPlanningView(deps: PlanningDeps): PlanningView {
         const saved = layoutDoc?.nodes[id]
         const seat = saved !== undefined ? { x: saved.x, y: saved.y } : seatFor2(id)
         model.upsertNode({
-          id, x: seat.x, y: seat.y, label: s.label, team: s.team, name: s.name,
+          id, x: seat.x, y: seat.y, label: s.label, team: s.team, name: s.name, description: s.description,
           live: s.live !== false, memberships: [],
           ...(s.teams !== undefined && s.teams.length > 0 ? { teams: s.teams } : {}),
         })
@@ -725,6 +704,7 @@ export function createPlanningView(deps: PlanningDeps): PlanningView {
       ev.preventDefault()
       return
     }
+    if (target !== null && target.closest('button, input, textarea, select, .p-toolbar, .p-search, .p-lamp, .p-status, .p-legend') !== null) return // HUD chrome owns its presses (no marquee / preventDefault: that stole the search box's focus — and, first, its native right-click menu)
     const p = localXY(ev)
     // 右键按下：按住拖动 = 平移（Figma 惯例），原地抬起 = 上下文菜单。
     // Pan actually starts on the first move beyond RIGHT_DRAG_THRESHOLD px;
@@ -735,7 +715,6 @@ export function createPlanningView(deps: PlanningDeps): PlanningView {
       try { root.setPointerCapture(ev.pointerId ?? 0) } catch { /* jsdom */ }
       return
     }
-    if (target !== null && (target.closest('button') !== null || target.closest('.p-lamp') !== null || target.closest('.p-status') !== null)) return
     const nodeEl = target !== null ? target.closest<HTMLElement>('.p-node') : null
     const headEl = target !== null ? target.closest<HTMLElement>('.p-frame-head') : null
     if ((nodeEl !== null || headEl !== null) && ev.button === 1) {
@@ -930,10 +909,9 @@ export function createPlanningView(deps: PlanningDeps): PlanningView {
       for (const el of frameEls.values()) el.classList.remove('drop-target')
       gesture.el?.classList.remove('dragging')
       render()
-    } else if (gesture.kind === 'frame') {
-      if (gesture.moved) markDirty()
-    } else if (gesture.kind === 'frame-resize') {
-      if (gesture.moved) markDirty() // the resized rect persists with the layout
+    } else if (gesture.kind === 'frame' || gesture.kind === 'frame-resize') {
+      // The frame stays where it was put; neighbours and stray cards yield (planning-overlap).
+      if (gesture.moved) { settleBoard(model, new Set(remoteFramesRef.keys()), gesture.name); markDirty(); render() }
     } else if (gesture.kind === 'pan') {
       if (gesture.moved) markDirty() // the viewport persists with the layout
     } else if (gesture.kind === 'marquee') {
@@ -977,13 +955,14 @@ export function createPlanningView(deps: PlanningDeps): PlanningView {
 
   function fitToContent(): void {
     syncViewSize()
-    vp = fitView(model.contentBounds(), viewW, viewH)
+    vp = fitBelowHud(boardBounds(model.contentBounds(), model.allNodes()), viewW, viewH, hudBottomOf(toolbar, status))
     applyViewport()
     markDirty()
   }
 
   function key(ev: SeamKey): void {
-    if (menus.isDialogOpen()) return // modal: the dialog input handles Enter/Esc itself
+    if (menus.isDialogOpen() || (ev.target as Element | null)?.closest?.('.p-search') !== null) return // modal / search box own their keys
+    if ((ev.ctrlKey || ev.metaKey) && ev.key.toLowerCase() === 'k') { ev.preventDefault(); search.focus(); return } // W1 Ctrl+K
     if (ev.ctrlKey || ev.metaKey) return // browser/OS chords stay browser/OS
     if (menus.isMenuOpen()) {
       // The menu owns most keys (its own handler navigates); Escape still
@@ -1098,7 +1077,7 @@ export function createPlanningView(deps: PlanningDeps): PlanningView {
   root.addEventListener('keyup', (ev) => keyUp(ev as unknown as SeamKey), signal)
   root.addEventListener('contextmenu', (ev) => {
     const e = ev as unknown as SeamPointer
-    e.preventDefault()
+    if ((e.target as Element | null)?.closest?.('input, textarea, .p-search') != null) return // text fields keep the native menu (paste)
     // Right-drag pans (suppressNextMenu); a clean right-click opens the
     // menu programmatically at pointerup. Either way the native menu dies.
     e.preventDefault()
@@ -1174,7 +1153,7 @@ export function createPlanningView(deps: PlanningDeps): PlanningView {
       if (model.getNode(s.id) !== undefined) {
         model.upsertNode({
           id: s.id, x: model.getNode(s.id)!.x, y: model.getNode(s.id)!.y,
-          label: s.label, team: s.team, name: s.name, live: s.live !== false,
+          label: s.label, team: s.team, name: s.name, description: s.description, live: s.live !== false,
           memberships: effective,
           ...(s.teams !== undefined && s.teams.length > 0 ? { teams: s.teams } : {}),
         })
@@ -1188,7 +1167,7 @@ export function createPlanningView(deps: PlanningDeps): PlanningView {
           y = seat.y
         }
         model.upsertNode({
-          id: s.id, x, y, label: s.label, team: s.team, name: s.name, live: s.live !== false,
+          id: s.id, x, y, label: s.label, team: s.team, name: s.name, description: s.description, live: s.live !== false,
           memberships: effective,
           ...(s.teams !== undefined && s.teams.length > 0 ? { teams: s.teams } : {}),
         })
@@ -1389,21 +1368,17 @@ export function createPlanningView(deps: PlanningDeps): PlanningView {
     // opened empty. Fit once, the first time there is something to frame.
     // Not marked dirty — nothing the user arranged changed; a saved layout
     // (adopted at any point) keeps its own viewport and cancels this.
+    // Once per load, a board that arrives overlapped is shown settled (not
+    // saved: no write without a user action; the next edit persists it).
+    if (!settledOnce && gesture.kind === 'none' && model.nodeIds().length > 0) { settledOnce = true; settleBoard(model, new Set(remoteFramesRef.keys())) }
     if (firstFitPending && gesture.kind === 'none' && model.nodeIds().length > 0) {
       syncViewSize()
       if (viewW > 0 && viewH > 0) {
         firstFitPending = false
         // Peer cards hang outside the local content bounds — frame them too,
-        // or the federation column opens clipped at the board's edge.
-        let bounds = model.contentBounds()
-        for (const n of model.allNodes()) {
-          if (n.remote !== true) continue
-          const r = nodeRect(n)
-          bounds = bounds === null
-            ? { minX: r.x, minY: r.y, maxX: r.x + r.w, maxY: r.y + r.h }
-            : { minX: Math.min(bounds.minX, r.x), minY: Math.min(bounds.minY, r.y), maxX: Math.max(bounds.maxX, r.x + r.w), maxY: Math.max(bounds.maxY, r.y + r.h) }
-        }
-        vp = fitView(bounds, viewW, viewH, 1) // frame, never magnify
+        // or the federation column opens clipped at the board's edge. Same
+        // framing as 适配 (planning-fit): ≤100%, below the HUD.
+        vp = fitBelowHud(boardBounds(model.contentBounds(), model.allNodes()), viewW, viewH, hudBottomOf(toolbar, status))
       }
     }
     render()

package/nexus-stage/src/planning.css

@@ -97,12 +97,31 @@
 #dsh-plan .p-node .nm{font-weight:600; display:flex; align-items:center; gap:7px;
   overflow:hidden; text-overflow:ellipsis; white-space:nowrap}
 /* The name span clips with an ellipsis (min-width:0 lets it shrink inside
-   the flex row) — without it a long peer address was hard-cut mid-digit. */
-#dsh-plan .p-node .nm-text{min-width:0; overflow:hidden; text-overflow:ellipsis; white-space:nowrap}
+   the flex row) — without it a long peer address was hard-cut mid-digit.
+   属主令 W2: TWO-LINE clamp for the name (long Chinese team titles read
+   fully); the card's 172x56 geometry is untouched — the clamp absorbs the
+   overflow. The handle line (.sub) stays single-line ellipsis below. */
+#dsh-plan .p-node .nm-text{min-width:0; overflow:hidden; white-space:normal;
+  display:-webkit-box; -webkit-line-clamp:2; -webkit-box-orient:vertical; line-height:1.25}
+/* A peer address has no break point, so the two-line clamp clipped it to one
+   line under the badge; let it wrap anywhere onto the second line. */
+#dsh-plan .p-node.remote .nm-text{overflow-wrap:anywhere}
 #dsh-plan .p-node .dot{width:8px; height:8px; border-radius:50%; background:var(--edge-live); flex:none}
 #dsh-plan .p-node.cold .dot{background:transparent; border:1.5px solid var(--edge-cold)}
 #dsh-plan .p-node .sub{font-size:11px; color:var(--ink-muted); margin-top:2px;
   overflow:hidden; text-overflow:ellipsis; white-space:nowrap}
+/* W1: a picked search hit pulses its card for 1.2s (class removed on timer). */
+#dsh-plan .p-node.pulse{box-shadow:0 0 0 2px var(--accent), 0 0 14px 4px var(--uupm-wash-15); border-color:var(--accent)}
+/* W1: toolbar search box + hit list. */
+#dsh-plan .p-search{position:relative}
+#dsh-plan .p-search-input{width:170px; min-height:28px; padding:2px 8px; font-size:12px;
+  background:transparent; color:var(--ink); border:1px solid var(--card-line); border-radius:6px}
+#dsh-plan .p-search-input:focus-visible{outline:2px solid var(--accent); outline-offset:1px}
+#dsh-plan .p-search-list{position:absolute; top:100%; left:0; margin-top:4px; display:none;
+  min-width:240px; max-height:220px; overflow:auto; z-index:9;
+  background:var(--toolbar-bg); border:1px solid var(--card-line); border-radius:6px}
+#dsh-plan .p-search-hit{padding:5px 10px; font-size:12px; color:var(--ink); cursor:pointer; white-space:nowrap; overflow:hidden; text-overflow:ellipsis}
+#dsh-plan .p-search-hit:hover, #dsh-plan .p-search-hit.active{background:var(--uupm-wash-15)}
 #dsh-plan .p-node .prio{position:absolute; top:6px; right:8px; font-size:10px; color:var(--ink-muted);
   border:1px solid var(--card-line); border-radius:4px; padding:0 5px}
 
@@ -126,6 +145,8 @@
 #dsh-plan .p-toolbar button:active{background:var(--uupm-wash-15)}
 #dsh-plan .p-toolbar button:focus-visible{outline:2px solid var(--accent); outline-offset:1px}
 #dsh-plan .p-zoom{min-width:44px; text-align:center; font-size:11px; color:var(--ink-muted)}
+/* Toolbar groups (view | arrange | network): a hairline between them. */
+#dsh-plan .p-sep{align-self:stretch; width:1px; margin:2px 4px; background:var(--card-line)}
 #dsh-plan .p-lamp{display:flex; align-items:center; gap:6px; font-size:11px; color:var(--ink-muted); padding:0 6px}
 #dsh-plan .p-lamp i{width:7px; height:7px; border-radius:50%; background:var(--ink-muted); transition:background 140ms ease}
 #dsh-plan .p-lamp.saved i{background:var(--edge-live)}
@@ -140,8 +161,11 @@
 #dsh-plan .ok{color:var(--edge-live)} #dsh-plan .warn{color:var(--uupm-warn)} #dsh-plan .mut{color:var(--ink-muted)}
 
 #dsh-plan .p-legend{position:absolute; bottom:16px; left:16px; z-index:3; font-size:11px; color:var(--ink-muted);
-  background:var(--toolbar-bg); border:1px solid var(--card-line); border-radius:8px; padding:8px 12px;
-  display:grid; gap:4px}
+  background:var(--toolbar-bg); border:1px solid var(--card-line); border-radius:8px; padding:4px 10px}
+#dsh-plan .p-legend summary{cursor:pointer; padding:2px 0; user-select:none}
+#dsh-plan .p-legend summary:focus-visible{outline:2px solid var(--accent); outline-offset:2px}
+#dsh-plan .p-legend[open]{padding-bottom:8px}
+#dsh-plan .p-legend-rows{display:grid; gap:4px; margin-top:4px}
 #dsh-plan .p-legend i{display:inline-block; width:18px; border-top:2px solid var(--uupm-edge-member);
   vertical-align:middle; margin-right:6px}
 #dsh-plan .p-legend i.dashed{border-top-style:dashed}
@@ -149,12 +173,19 @@
 /* ── narrow board (<680px): the HUD stacks instead of colliding ──
    The toolbar, status chip and legend are absolutely placed for a wide
    board; on a phone they overlapped each other and the toolbar's CJK
-   labels wrapped one glyph per line. Toolbar scrolls sideways on one row,
-   the status chip drops under it, the legend (reference, not state) hides. */
+   labels wrapped one glyph per line. The one-row sideways scroll that
+   followed hid the search box and half the actions off-screen (review
+   2026-10-27), so the toolbar and status chip now flow at the top of the
+   board instead: the toolbar wraps, search first on its own row, and the
+   status chip sits under whatever height that takes. The legend (reference,
+   not state) hides. */
 @media (max-width:680px){
-  #dsh-plan .p-toolbar{left:8px; right:8px; top:8px; overflow-x:auto; scrollbar-width:none}
+  #dsh-plan .p-toolbar{position:relative; top:auto; left:auto; margin:8px 8px 0; flex-wrap:wrap; row-gap:6px}
   #dsh-plan .p-toolbar > *{flex:none}
-  #dsh-plan .p-status{left:8px; right:auto; top:58px; padding:6px 10px; gap:10px; flex-wrap:wrap}
+  #dsh-plan .p-toolbar .p-search{order:-1; flex:1 1 100%}
+  #dsh-plan .p-toolbar .p-sep{display:none}
+  #dsh-plan .p-toolbar .p-search-input{width:100%; box-sizing:border-box}
+  #dsh-plan .p-status{position:relative; top:auto; right:auto; left:auto; width:fit-content; margin:6px 8px 0; padding:6px 10px; gap:10px; flex-wrap:wrap}
   #dsh-plan .p-legend{display:none}
 }
 @media (pointer:coarse){

package/nexus-stage/src/seat.ts

@@ -1,35 +1,35 @@
-/**
- * Deterministic fallback seating: a session id hashes to a stable polar
- * seat, so a reload reproduces the same star map even when no layout is
- * persisted (saved layouts still win - main.ts checks them first). This
- * replaces three Math.random() calls whose only product was a star map
- * that reshuffled on every reload, making screenshots and sessions
- * incomparable. Same hash family as getHue (FNV-1a 32-bit); zero
- * dependencies so the unit test pins stability/bounds without three.
- * @module nexus-stage/seat
- */
-
-/** Radial distance bounds, mirroring the historical random-seat envelope. */
-export const SEAT_DIST_MIN = 12
-export const SEAT_DIST_MAX = 30
-/** Vertical jitter bound in world units above/below the grid plane. */
-export const SEAT_Y_SPAN = 1
-
-/** FNV-1a 32-bit - the same determinism family as getHue. */
-export function hashId(sid: string): number {
-  let h = 0x811c9dc5
-  for (let i = 0; i < sid.length; i++) {
-    h ^= sid.charCodeAt(i)
-    h = Math.imul(h, 0x01000193) >>> 0
-  }
-  return h >>> 0
-}
-
-/** Deterministic world seat (x, vertical jitter, z) for one session id. */
-export function seatFor(sid: string): { x: number; y: number; z: number } {
-  const h = hashId(sid)
-  const angle = ((h % 3600) / 3600) * Math.PI * 2
-  const dist = SEAT_DIST_MIN + (((h >>> 9) % 1800) / 1800) * (SEAT_DIST_MAX - SEAT_DIST_MIN)
-  const y = (((h >>> 18) % 2000) / 1999) * 2 * SEAT_Y_SPAN - SEAT_Y_SPAN
-  return { x: Math.cos(angle) * dist, y, z: Math.sin(angle) * dist }
-}
+/**
+ * Deterministic fallback seating: a session id hashes to a stable polar
+ * seat, so a reload reproduces the same star map even when no layout is
+ * persisted (saved layouts still win - main.ts checks them first). This
+ * replaces three Math.random() calls whose only product was a star map
+ * that reshuffled on every reload, making screenshots and sessions
+ * incomparable. Same hash family as getHue (FNV-1a 32-bit); zero
+ * dependencies so the unit test pins stability/bounds without three.
+ * @module nexus-stage/seat
+ */
+
+/** Radial distance bounds, mirroring the historical random-seat envelope. */
+export const SEAT_DIST_MIN = 12
+export const SEAT_DIST_MAX = 30
+/** Vertical jitter bound in world units above/below the grid plane. */
+export const SEAT_Y_SPAN = 1
+
+/** FNV-1a 32-bit - the same determinism family as getHue. */
+export function hashId(sid: string): number {
+  let h = 0x811c9dc5
+  for (let i = 0; i < sid.length; i++) {
+    h ^= sid.charCodeAt(i)
+    h = Math.imul(h, 0x01000193) >>> 0
+  }
+  return h >>> 0
+}
+
+/** Deterministic world seat (x, vertical jitter, z) for one session id. */
+export function seatFor(sid: string): { x: number; y: number; z: number } {
+  const h = hashId(sid)
+  const angle = ((h % 3600) / 3600) * Math.PI * 2
+  const dist = SEAT_DIST_MIN + (((h >>> 9) % 1800) / 1800) * (SEAT_DIST_MAX - SEAT_DIST_MIN)
+  const y = (((h >>> 18) % 2000) / 1999) * 2 * SEAT_Y_SPAN - SEAT_Y_SPAN
+  return { x: Math.cos(angle) * dist, y, z: Math.sin(angle) * dist }
+}

package/nexus-stage/src/stage-name.ts

@@ -1,13 +1,13 @@
-/**
- * Display name for one stage node: the session title when present, then the
- * routable team label (`team/<id8>`), then the host fallback label
- * (`dsh-host-<node>-<id8>`). Untitled cold joined sessions carry no title and
- * without the middle step the canvas drowned in dsh-host-* noise (2026-08-30
- * user report: the planning canvas showed a dozen unreadable label cards).
- * @module nexus-stage/stage-name
- */
-
-/** One node's display title. */
-export function displayName(node: { readonly name?: string; readonly team?: string; readonly label?: string }): string {
-  return node.name ?? node.team ?? node.label ?? ''
-}
+/**
+ * Display name for one stage node: the session title when present, then the
+ * routable team label (`team/<id8>`), then the host fallback label
+ * (`dsh-host-<node>-<id8>`). Untitled cold joined sessions carry no title and
+ * without the middle step the canvas drowned in dsh-host-* noise (2026-08-30
+ * user report: the planning canvas showed a dozen unreadable label cards).
+ * @module nexus-stage/stage-name
+ */
+
+/** One node's display title. */
+export function displayName(node: { readonly name?: string; readonly team?: string; readonly label?: string }): string {
+  return node.name ?? node.team ?? node.label ?? ''
+}

package/nexus-stage/src/tokens.ts

@@ -1,32 +1,32 @@
-/**
- * A2A Nexus design tokens.
- * Three-layer: primitive(C) -> semantic(S) -> component-level inline styles.
- */
-
-export const C = {
-  bg0: '#060a12',
-  bg1: '#0d1322',
-  ink: '#dde3f0',
-  inkMuted: '#7a86a0',
-  accent: '#8b5cf6',
-  liveGreen: '#4ade80',
-  coldGrey: '#4a5568',
-  lineFederal: '#6366f1',
-  membershipLine: '#22d3ee',
-} as const;
-
-/**
- * Semantic layer: the scene-facing names the viewer actually consumes,
- * each pinned to its primitive above. This is the `S` main.ts reached for
- * as `T.S.*` — the layer was documented but never exported, so every seat
- * attempt threw and cycle()'s empty catch buried it: an eternally empty
- * stage behind a healthy-looking render loop.
- */
-export const S = {
-  /** Mesh color + emissive for live session nodes (primitive liveGreen). */
-  nodeLive: 0x4ade80,
-  /** Mesh color + emissive for cold/joined-offline nodes (primitive coldGrey). */
-  nodeCold: 0x4a5568,
-} as const;
-
+/**
+ * A2A Nexus design tokens.
+ * Three-layer: primitive(C) -> semantic(S) -> component-level inline styles.
+ */
+
+export const C = {
+  bg0: '#060a12',
+  bg1: '#0d1322',
+  ink: '#dde3f0',
+  inkMuted: '#7a86a0',
+  accent: '#8b5cf6',
+  liveGreen: '#4ade80',
+  coldGrey: '#4a5568',
+  lineFederal: '#6366f1',
+  membershipLine: '#22d3ee',
+} as const;
+
+/**
+ * Semantic layer: the scene-facing names the viewer actually consumes,
+ * each pinned to its primitive above. This is the `S` main.ts reached for
+ * as `T.S.*` — the layer was documented but never exported, so every seat
+ * attempt threw and cycle()'s empty catch buried it: an eternally empty
+ * stage behind a healthy-looking render loop.
+ */
+export const S = {
+  /** Mesh color + emissive for live session nodes (primitive liveGreen). */
+  nodeLive: 0x4ade80,
+  /** Mesh color + emissive for cold/joined-offline nodes (primitive coldGrey). */
+  nodeCold: 0x4a5568,
+} as const;
+
 export const FRAME_HUES = [0x8b5cf6, 0x3b82f6, 0x14b8a6, 0xf59e0b, 0xec4899, 0x84cc16];

package/nexus-stage/src/viewport.ts

@@ -60,16 +60,39 @@ export function zoomAt(vp: LayoutViewport, factor: number, ax: number, ay: numbe
 /** Content bounds in world space (null = nothing to fit). */
 export interface WorldBounds { readonly minX: number; readonly minY: number; readonly maxX: number; readonly maxY: number }
 
+/** A fit never shrinks past a readable floor: below {@link NARROW_FIT_WIDTH}
+ *  (the board's phone breakpoint) {@link NARROW_FIT_FLOOR}, at any wider
+ *  viewport {@link WIDE_FIT_FLOOR}. Fitting a whole board drew 13px card
+ *  names at ~7px on a phone, and a real 66-card board at 30% on a desktop
+ *  (review 2026-10-27, real-host check). Past the floor the fit anchors the
+ *  content's top-left corner instead of its centre; the rest is a pan away. */
+export const NARROW_FIT_WIDTH = 680
+export const NARROW_FIT_FLOOR = 0.8
+export const WIDE_FIT_FLOOR = 0.6
+const FIT_MARGIN = 16
+
 /**
  * Fit the content bounds into a viewW x viewH viewport at 90% fill,
  * clamped to the persisted scale envelope; empty bounds reset to identity.
+ * The scale is floored (see {@link WIDE_FIT_FLOOR}); an explicit maxScale
+ * below the floor still wins.
  */
 export function fitView(bounds: WorldBounds | null, viewW: number, viewH: number, maxScale = Number.POSITIVE_INFINITY): LayoutViewport {
   if (bounds === null || viewW <= 0 || viewH <= 0) return IDENTITY_VIEWPORT
   const bw = bounds.maxX - bounds.minX
   const bh = bounds.maxY - bounds.minY
   if (!(bw > 0) || !(bh > 0)) return IDENTITY_VIEWPORT
-  const scale = clampScale(Math.min(maxScale, 0.9 * Math.min(viewW / bw, viewH / bh)))
+  // The floor is about content that does not FIT at a readable scale, so it
+  // is judged on the natural fit — a caller's maxScale cap below the floor
+  // must not turn a board that fits into a top-left-anchored one (PR #79 review).
+  const natural = 0.9 * Math.min(viewW / bw, viewH / bh)
+  const fitted = Math.min(maxScale, natural)
+  const floor = viewW < NARROW_FIT_WIDTH ? NARROW_FIT_FLOOR : WIDE_FIT_FLOOR
+  if (natural < floor) {
+    const scale = clampScale(Math.min(maxScale, floor))
+    return { x: bounds.minX - FIT_MARGIN / scale, y: bounds.minY - FIT_MARGIN / scale, scale }
+  }
+  const scale = clampScale(fitted)
   return {
     x: (bounds.minX + bounds.maxX) / 2 - viewW / (2 * scale),
     y: (bounds.minY + bounds.maxY) / 2 - viewH / (2 * scale),