The Board becomes a document workspace

[cailmdaley]

The Board becomes a document workspace, and every way of opening a fiber leads into it.

• The Board is now an overview of the fleet's work: a row of the latest receipts, then each fiber that has documents as a folio with a live thumbnail of its lead document. Folios group by recent work, project or host, and you can search them.
• The reader opens when you click a Desk card, a folio, a receipt or a wikilink. It lays one fiber's documents out as a filmstrip modelled on Television: the fiber's own page first, then its other documents. One page is selected, its neighbours are receded and inert, a crossing takes 280 ms, and selecting a page never reloads a document. The reader floats on a vellum veil over the live Desk.
• The card's controls live at the top of the fiber's own page: the worker pill, the composer, Meeting, settings, history, and Temper/Discard. The navbar's worker pill opens the real conversation, as the Desk card's pill does.
• Desk ordering is explicit. Every column ends in an identity tie-break, and In flight splits into Needs you and Working.

Design authority, decisions and the review are in the felt constitution ai-futures/felt/constitutions/document-workspace (design.md, review-findings.md).

What changes for a person using the board

• Documents:
  • Each document appears once per fiber, keyed by owner plus normalized absolute path, with every send kept as a receipt.
  • Tab labels disambiguate colliding names.
  • Audio, video, PDF, image, HTML, markdown and text each have one renderer, shared by reader pages and overview thumbnails; other kinds offer a download.
  • Media keeps its playback state across selection and parking, pauses when its page recedes, and only one thing plays at a time.
• Keyboard: one keymap module drives the Desk, the overview and the reader, and the ? overlay lists it.
  • The Desk and overview move spatially with hjkl or the arrows. The first keypress on the Desk selects the top of Awaiting review.
  • In the reader, h/l step tabs, j/k step constitutions, ↑/↓ scroll, c toggles the Constitutions sidebar and / searches.
  • HTML reports forward keys through a small bridge only when they didn't handle the key themselves.
• Phone: the overview is a single column, the reader shows one document full-width with a bottom bar of ‹ n/N ›, and browser Back works throughout.
• Theme: the workspace takes the Desk's pigments and materials as shared --kbn-* tokens, and every --ws-* colour derives from them.
• Removed: FiberDetailModal and its floating window chrome, LinkedFiberPanel, the Shelf canvas (ShelfView, ShelfReader and their layout code), ReaderZoom, and sheet history.

Daemon

• GET /file serves byte ranges (Range, If-Range, 206/416).
• Files over 1 MiB get a cheap metadata ETag, are streamed rather than read whole, and have open-ended ranges capped at 4 MiB.
• HEAD sends no body, and a remote HEAD is a true upstream HEAD.
• Relays to owner hosts bound open, closed and suffix ranges to 4 MiB and relay at most 64 KiB of an error body.

Remote full-GET fallbacks still buffer within the existing 30 s timeout.

Verification

Gates on the final head (observed):

• make test: Go suite, ExUnit, the UI suite under both pinned time zones, plugin hooks and bootstrap all pass.
• make build SKIP_CLI=1 passes.
• cd ui && npm run e2e: 24/24 browser checks pass. The suite drives the board harness with playwright-core and system Chrome. It covers Desk keys, card → reader, stepping, expand and resize, the inline controls, the worker pill, wikilinks to non-card fibers, the overview, real audio and video playback, PDF, and the phone layout. It asserts document identity (no reloads) and that no page errors occur.

Live real-data checks ran through vite against the dapmcw68 daemon, using documents owned by candide, cineca and amundsen, at 1440×900 and 390×844. An independent Opus review covered the daemon, data safety, entry points, security and dead code. All of its must-fix and fix-soon items have regression tests that fail before the fix.

Known follow-ups

• HTML reports render as same-origin srcdoc, as they did on main. Sandboxing them means porting scrolling, scroll restore and media binding to the bridge.
• Reloading a channel opened from the Desk lands on the Board view.
• A visual design pass is next: depth and parallax, the Desk column sliding out as the sidebar, thumbnail tabs with recency order, per-constitution themes, and the audio page.

🤖 Generated with Claude Code

https://claude.ai/code/session_01LQP1nDgXogDRnyMZNK3hoY