feat: refine desktop workspace experience

[wolfiesch]

What changed

• refine the desktop shell hierarchy, spacing, rail, titlebar, and session toolbar
• consolidate session tools into one Workspace menu
• add verified session environment context
• reorganize Settings around clearer categories
• add reversible Focus Mode
• improve command-menu search, grouping, highlighting, and keyboard guidance
• preserve 320px mobile reachability and keep Settings visible
• refresh provenance fingerprints for the adapted UI files
• make cross-platform download checks independent of the test runner OS

Why

T4 users frequently move between terminal-first workflows and polished desktop coding clients. This makes the workspace easier to scan and keeps the most important controls predictable without changing the underlying OMP session model.

User impact

Desktop navigation is calmer and more consistent, session tools are easier to find, Focus Mode provides a distraction-free transcript surface, and the narrow phone titlebar no longer overflows.

Before and after

All screenshots use T4's built-in sample data.

Shell hierarchy

Before	After

Session workspace tools

Before	After

Session environment context

Before	After

Command discovery

Before	After

Settings organization

Before	After

Focus Mode

Before	After

Mobile Settings

Before	After

Verification

• Node 24.13.1
• pnpm check
• pnpm test — 1,576 tests passed across 10 workspace projects
• pnpm test:e2e — 26 browser tests passed
• production web and site builds
• provenance check — 0 failures
• gitleaks — no leaks

[Copilot]

Pull request overview

This PR refreshes the desktop workspace UI and interaction model in apps/web, consolidating session tools into a single “Workspace” menu, adding verified session environment context, reorganizing Settings into clearer groups, and introducing a reversible Focus Mode—while updating tests and provenance to match.

Changes:

• Introduces Focus Mode as an ephemeral workspace state, plus new keyboard shortcuts (Cmd/Ctrl+J terminal, Cmd/Ctrl+Shift+F focus) and corresponding UI flows.
• Refactors session header tooling into a unified Workspace menu and adds a Session context popover (host/model/connection + health entry point).
• Reworks Settings navigation into grouped sections (rail + mobile picker) and updates CSS tokens / E2E + unit tests to validate the new UX.

Reviewed changes

Copilot reviewed 18 out of 30 changed files in this pull request and generated no comments.

Show a summary per file

File	Description
provenance/t3code/imports/f1-shell-20260711.json	Updates provenance checksums for adapted/reference shell imports.
provenance/t3code/imports/f0-20260711.json	Updates provenance checksums for token/theme references.
packages/ui/src/tokens.css	Adjusts workspace geometry and visual tokens (topbar height, radius, sidebar bg, shadows, dark palette tweaks).
e2e/site-mobile-docs.spec.ts	Makes desktop download visibility assertions less label-fragile across platforms.
e2e/remote-app.spec.ts	Adds E2E coverage for Workspace menu consolidation, Focus Mode, session context, and Settings grouping.
e2e/pwa-install.spec.ts	Updates expected titlebar padding to match refreshed chrome spacing.
apps/web/test/workspace-store.test.ts	Adds unit coverage for Focus Mode’s “ephemeral + non-destructive” behavior and persistence sanitization.
apps/web/test/shortcuts.test.ts	Adds unit coverage for new terminal + focus keyboard shortcuts.
apps/web/test/mobile-touch-targets.test.tsx	Updates mobile touch-target assertions to reflect Focus Mode and Workspace menu changes.
apps/web/test/live-settings-screen.test.ts	Adds coverage for grouped Settings rail behavior (including unknown/host sections).
apps/web/src/state/workspace-store.ts	Adds focusMode state + action, ensures it remains ephemeral (not persisted).
apps/web/src/keyboard/shortcuts.ts	Extends shortcut resolver with terminal toggle and focus toggle support.
apps/web/src/features/settings/SettingsWorkspace.tsx	Implements grouped Settings rail + optgroup mobile picker; updates layout/typography.
apps/web/src/components/Titlebar.tsx	Adds Focus Mode exit control and refines titlebar styling/spacing.
apps/web/src/components/SessionScreen.tsx	Adds Session context popover; replaces scattered tools with a unified Workspace menu; hides chrome in Focus Mode.
apps/web/src/components/Rail.tsx	Refreshes rail header/labels and keyboard hint presentation.
apps/web/src/components/CommandPalette.tsx	Improves search UX (grouping, recent limiting, keyboard help) and adds workspace actions (focus/terminal/panels).
apps/web/src/components/AppShell.tsx	Wires Focus Mode through shell rendering and keyboard handling; integrates new shortcut actions.

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.