seroxdesigndocs: preserve serve pipeline design baselineb58a5114 months agoHistory
64 lines · 7.7 KB · MarkdownRawDownload

PROGRESS

State snapshot after the terminal/perf/UX overhaul session. Branch loop/home-for-people, pushed to origin/main through commit 7192e00a.

Shipped to main (released)

Release workflow succeeded on push; semantic-release cut the release from these commits.

Fixes and features

  • fix: portal sidebar new-chat menu ... (pre-session work, included in push)
  • fix: open sidebar new terminal directly instead of converting a fresh chat — single openProjectTerminal reducer action; no more chat-then-convert.
  • feat: attach models to omp via models.yml with enabledModels opt-in — omp (~/.omp/agent/models.yml) is a local-agent attach target; appends provider/model to enabledModels in config.yml when an allowlist exists; reported via extraUpdates.
  • fix: keep model logo initials visible until the avatar image loads — initials base layer, avatar overlay on onLoad, stale-event guards.
  • fix: isolate chat and terminal pane targets and consume one-shot nav params — chats never claim/replace terminal panes; new/terminal/split/open URL params stripped after handling (reload no longer replays them).
  • feat: configurable terminal hotkeys, search, font size, and pane splits — src/lib/terminal-keybinds.ts store; defaults: ⌘T new, ⌘W close, ⌘K clear, ⌘F search, ⌘±/⌘0 font, ⌘D/⌘⇧D splits; Settings → Terminal section with rebind capture, per-row/all reset, duplicate warnings, font slider; xterm @xterm/addon-search + inline search bar; split buttons in terminal pane header.
  • fix: decouple agent browser tools from panel state and widen chromium discovery — browser tools follow the persisted composer toggle, not panel geometry (no more silent tool loss / runtime restarts on focus change); Brave/Edge/Arc/Vivaldi/Canary discovery; stateful reading-mode fallback; unavailability banner in panel; dead webview command surface removed.
  • feat: cap workspace splits at three columns by two rows + fix: clamp restored workspace layouts to the split grid cap — layoutGridSize/splitLeafWithinLimits/clampLayoutToLimits; restore prunes only terminal leaves, never chats.
  • perf: stop syncing transcript and session caches through durable ui prefs — ui-preferences.json went 3.1MB → ~7KB; the 3MB payload was re-serialized over IPC and POSTed to the controller after every workspace change.
  • fix: keep controller credentials out of remote ui preference sync — local-studio.controllers (apiKeys) filtered from controller /studio/settings sync on save AND hydrate; desktop-local persistence unchanged.
  • perf: split transcript crash cache into per-session keys — v2 per-session localStorage keys replace the 3MB monolith parsed on every session open; legacy key purged on load; excluded from durable prefs by prefix.
  • perf: mount sidebar terminal owners lazily on first activation — no more N simultaneous xterm+PTY boots on /agent mount.
  • feat: let sidechats pick their own model — same AgentModelPicker as main pane; selection persists on the sidechat session and drives turns.
  • fix: register xml grammar so html files highlight — highlight.js xml grammar registration (serves html/htm/svg/xml/vue/svelte).
  • fix: open sidebar sessions in place instead of hard page reloads — root cause of "black pane for seconds": navigateToSessionHref fell back to window.location.assign after a 70ms race. Session clicks now dispatch workspaceCommands().openSession(project, piSessionId, title) (in-place reducer path); hard-nav fallback deleted; active rows reuse the replay/focus path.
  • fix: drop stale replay drains when a pane swaps sessions — ChatPaneHandle carries sessionId; replay queue drains only when handle matches the pane's current session (fixes transcript landing in a dead session on same-pane switches).
  • feat: infer model family avatars for local recipe ids + fix: fall back through avatar owner candidates for local model paths — ordered owner candidates (author → plausible hub owner → brand keyword table) advancing on img error; 22/22 model rows show brand icons.

Tests added (all mutation-checked by Tester agents)

  • frontend/scripts/open-project-terminal.test.ts — terminal action, splits, grid caps, chat isolation, clamp, restore.
  • frontend/scripts/omp-local-agent-attach.test.ts — omp attach flow.
  • frontend/scripts/terminal-keybinds.test.ts — match/serialize/store.
  • frontend/scripts/transcript-cache.test.ts — v2 per-session cache.
  • frontend/scripts/replay-queue.test.ts — stale-handle drain guards.
  • frontend/scripts/terminal-pane-model.test.ts — 3 tests updated to the new chat/terminal isolation contract.

Desktop

Canonical app /Applications/Local Studio.app rebuilt/reinstalled repeatedly; final installed build includes everything above; /api/desktop-health 200.

DONE 2026-07-09: main CI fixed forward (eae9167a, CI green)

  • navigate-to-session.test.ts rewritten to the push-only contract (hard-nav fallback deleted on purpose).
  • Replay harness handles now stamp sessionId; last-wins test uses an unbound loading session (a bound session correctly rejects mismatched replays).
  • agent-browser-tools-regressions.test.ts: dropped the two tests of the deleted runBrowserPanelCommand webview surface (private-URL guarding still covered by the reader fetch route test).

DONE 2026-07-09: terminal session tabs + persistence + open latency (2cfa5d98, 184e5d8f)

User-reported problems fixed:

  1. Slow new terminal/chat — sidebar '+' menu preloads xterm chunks; terminal boot skips the pty.status() pre-flight IPC; projects list warm-starts from a localStorage cache (local-studio.agent.projects.cache.v1) so /agent?project=…&new=/terminal= no longer blocks on the projects fetch before opening the pane.
  2. Terminals now create session tabs — terminal panes broadcast as kind:"terminal" active-session rows (tabId = PTY mountKey, projectId stamped on TerminalPaneState); sidebar renders them with a Terminal icon under their project.
  3. Terminals survive navigation / Back — session replay never clobbers a terminal pane (splits beside it; siblingPaneId skips terminal leaves). Clicking a terminal row focuses its pane or recreates one with the SAME mountKey — the Electron PTY manager keeps owner-keyed shells alive with a 200KB replay buffer, so it reattaches with history. /agent?terminal=<mountKey> deep-links a reattach (terminal=1 still = fresh terminal).

Tests: open-project-terminal.test.ts (+5), terminal-pane-model.test.ts (broadcast + split-not-clobber), projects-store-cache.test.ts (new). All gates + both suites green; prod build green.

NOT yet click-verified in Electron (desktop rebuild kicked off; PTY reattach path needs a live app pass).

Known remaining risks / not verified

  • The exact Electron revisit of long-RUNNING glm-5.2 sessions was never fully reproduced; runtime SSE event-replay catch-up for in-flight turns is untouched and remains the suspect if slowness persists there.
  • Large-project sidebar expansion had one inconclusive freeze probe (may have been tooling).
  • Sidechat model picker + HTML highlighting were gate-verified, not click-tested in Electron.
  • local-studio.controllers with apiKeys still lives in desktop-local ui-preferences.json (by design for reinstall restore); only remote sync is filtered.
  • Untracked WIP in the tree not mine, left alone: vercel.json, .vercelignore, frontend/src/app/docs/, frontend/src/app/landing/, frontend/src/features/landing-page/, .gitignore edits.

Also delivered earlier in session

  • Models-page redesign proposal (controller-rack concept) with interactive mockup at /tmp/models-rack-proposal.html — awaiting user verdict; multi-controller fan-out plumbing not implemented.