singularity-forge/web/components/gsd/command-surface.tsx
Andrew d93956ba4e feat(web): browser-based web interface (#1717)
* chore(M003/S01): auto-commit after plan-slice

* chore(M003/S01/T02): auto-commit after execute-task

* chore(M003/S01/T03): auto-commit after execute-task

* docs: queue M004 — web mode documentation and CI/CD integration

* chore(M003/S01/T04): auto-commit after execute-task

* chore(M003/S01): auto-commit after complete-slice

* chore(M003/S01): auto-commit after reassess-roadmap

* chore: production polish — real logo, remove scaffold remnants

- Replace placeholder 'G' box in header with real GSD logo icon SVG (currentColor, theme-aware)
- Delete 5 dead placeholder files (placeholder-logo.svg/png, placeholder-user.jpg, placeholder.jpg, placeholder.svg)
- Remove v0.app generator tag from layout metadata
- Remove unused @vercel/analytics dependency

* chore(M003/S02): auto-commit after research-slice

* chore(Q1): auto-commit after quick-task

* fix: remove duplicate parse cache block causing web mode boot failure

The 'Parse Cache' section in files.ts was duplicated (merge artifact),
causing 'Identifier CACHE_MAX has already been declared' when Node's
--experimental-strip-types loaded the file. This made /api/boot return
500, which caused waitForBootReady to time out and web mode launch to
fail with 'boot-ready:http 500'.

Removed the second (older) duplicate block, keeping the first one which
includes the improved mid-sample cache key.

* docs: add quick task summary and update STATE.md

* fix: replace sidebar icon+text with full logo image

Swap the inline SVG G-mark icon and 'GSD 2' text span in the app shell
header with an <img> referencing /logo-white.svg (the full GSD wordmark).
Removes the redundant text label. Sized at h-4 (16px) to fit the header.

* docs(S02): add slice plan

* chore: update state for S02 execution

* chore(M003/S02/T01): auto-commit after execute-task

* chore(M003/S02/T02): auto-commit after execute-task

* chore(M003/S02/T03): auto-commit after execute-task

* chore(M003/S02): auto-commit after complete-slice

* chore(M003/S02): auto-commit after reassess-roadmap

* chore(M003/S03): auto-commit after research-slice

* docs(S03): add slice plan

* chore(M003/S03/T01): auto-commit after execute-task

* chore(M003/S03/T02): auto-commit after execute-task

* chore(M003/S03/T03): auto-commit after execute-task

* chore(M003/S03): auto-commit after complete-slice

* chore(M003/S03): auto-commit after reassess-roadmap

* chore(M003/S04): auto-commit after research-slice

* docs(S04): add slice plan

* chore(M003/S04/T01): auto-commit after execute-task

* chore(M003/S04/T02): auto-commit after execute-task

* chore(M003/S04/T03): auto-commit after execute-task

* chore(M003/S04): auto-commit after complete-slice

* chore(M003/S04): auto-commit after reassess-roadmap

* chore(M003/S05): auto-commit after research-slice

* docs(S05): add slice plan

* chore(M003/S05/T01): auto-commit after execute-task

* chore(M003/S05/T02): auto-commit after execute-task

* chore(M003/S05): auto-commit after complete-slice

* chore(M003/S05): auto-commit after reassess-roadmap

* chore(M003/S06): auto-commit after research-slice

* docs: queue M005

* docs(S06): add slice plan

* chore(M003/S06/T01): auto-commit after execute-task

* chore(M003/S06/T02): auto-commit after execute-task

* chore(M003/S06): auto-commit after complete-slice

* chore(M003/S06): auto-commit after reassess-roadmap

* chore(M003/S07): auto-commit after research-slice

* docs(S07): add slice plan

* chore: update STATE.md for S07 execution

* chore(M003/S07/T01): auto-commit after execute-task

* chore(M003/S07/T02): auto-commit after execute-task

* chore(M003/S07/T03): auto-commit after execute-task

* chore(M003): record integration branch

* chore(M003/S07/T04): auto-commit after execute-task

* chore(M003/S07): auto-commit after complete-slice

* chore(M003/S07): auto-commit after reassess-roadmap

* chore(M003/S08): auto-commit after research-slice

* docs(S08): add slice plan

* chore(M003/S08/T01): auto-commit after execute-task

* chore(M003/S08/T02): auto-commit after execute-task

* chore(M003/S08): auto-commit after complete-slice

* chore(M003/S08): auto-commit after reassess-roadmap

* chore(M003/S09): auto-commit after research-slice

* docs(S09): add slice plan

* chore(M003/S09/T01): auto-commit after execute-task

* chore(M003/S09/T02): auto-commit after execute-task

* chore(M003/S09): auto-commit after complete-slice

* chore(M003): auto-commit after complete-milestone

* chore(M004): record integration branch

* chore: untrack .gsd/ runtime files from git index

* chore(M004): auto-commit after research-milestone

* feat(M006): multi-project workspace

- Bridge registry replacing singleton (Map<string, BridgeService> keyed by project path)
- resolveProjectCwd(request) for ?project= query param with env-var fallback
- All 26 API routes and 16 services threaded with project context
- Project discovery service scanning one directory level with smart detection
- /api/projects and /api/preferences routes
- ProjectStoreManager with per-project SSE lifecycle isolation
- Projects NavRail tab with kind badges and signal chips
- Onboarding dev root step (position 3, skippable)
- Context-aware launch detection (resolveContextAwareCwd)
- BootProjectInitializer for auto-registering boot project
- 25 new contract tests (8 bridge, 10 discovery, 7 launch)
- 1222 tests pass, both builds green

Squash-merged from milestone/M006 work on gsd/quick branch.
Includes M004 and M005 milestone artifacts.

* feat: add dev root setup in Projects view and Settings panel

- Projects view empty state now has inline dev root input with
  suggestion chips instead of just a text message
- Settings gear → Workspace tab shows dev root configuration
- /gsd prefs command surface includes dev root section at top
- PUT /api/preferences now merges with existing prefs (read-modify-write)
  instead of overwriting — fixes potential data loss of lastActiveProject
- Fixed pre-existing type issue: sectionLabel/sectionIcon Records use
  Partial<Record> to handle gsd-* sections that aren't in the map

* feat: native folder picker for dev root selection

- New /api/browse-directories?path= endpoint returns directory listings
  from the server filesystem (directories only, excludes dotfiles/node_modules)
- FolderPickerDialog component with directory browser: navigate folders,
  go up to parent, select current folder
- Projects view empty state shows 'Browse for Folder' button opening the picker
- Settings Workspace tab shows current path with 'Change' button opening picker
- Replaces text input approach — no more typing paths manually

* fix: move Projects icon to bottom of NavRail, above Git

Projects is a workspace-level navigation action, not a primary view.
Placing it in the bottom section alongside Git and Settings keeps
the top section focused on content views.

* feat: multi-project-aware exit dialog

When multiple projects are open, the exit button shows two options:
- Close current project (disconnects it, switches to another)
- Stop server (shuts down all projects and closes the tab)

With only one project open, shows the original simple 'Stop server' dialog.

Also adds closeProject(), getProjectCount(), and getActiveProjectPaths()
to ProjectStoreManager.

* feat: intercept browser tab close with confirmation and auto-shutdown

beforeunload triggers the browser's native 'Leave site?' confirmation
dialog when the user tries to close the tab. If they confirm, pagehide
fires sendBeacon to /api/shutdown, cleanly stopping all GSD instances.

* feat: remove session card from dashboard, fix beforeunload

- Removed the session card (model, cost, tokens, elapsed, auto mode,
  live tool/streaming indicators) from the dashboard right column
- Dashboard current slice section now takes full width
- Removed beforeunload handler (tab close silently shuts down via
  pagehide + sendBeacon instead of showing native browser dialog)
- Updated web-state-surfaces-contract test: removed assertion for
  activeToolExecution/streamingAssistantText in dashboard
- 1220/1221 tests pass (1 flaky context-store unrelated to changes)

* feat: show loading dialog when switching to a new project

When clicking a project that doesn't have a bridge instance yet,
a shadcn Dialog with a spinner and 'Opening [project]' message
appears instead of navigating to the dashboard with skeleton cards.
The dialog waits for the store's bootStatus to become 'ready' or
'error' (or 30s timeout) before navigating to the dashboard.

Clicking the already-active project navigates directly.

* feat: restore theme toggle and light/dark CSS from M005

M005's theme work was lost during the M006 squash merge (different
branch base). This restores:

- ThemeProvider in layout.tsx with class-based theming and FOIT prevention
- NavRail theme toggle cycling system → light → dark (Monitor/Sun/Moon icons)
- Light-mode :root CSS variables (monochrome oklch, inverted lightness)
- Dark .dark section with custom tokens (--success, --warning, --info,
  --terminal, --terminal-foreground, --code-line-number)
- suppressHydrationWarning on <html> for next-themes compatibility

* fix: switch logo between black/white variants based on theme

Uses paired dark:/hidden Tailwind classes — zero JS cost, no flash.

* chore: untrack .gsd/ runtime files from git index

* chore(Q2): auto-commit after quick-task

* feat(web): resizable milestone sidebar + rename tab title to GSD

- Add drag-to-resize handle on left edge of milestone sidebar
  (col-resize, 180-480px range, same pattern as terminal resize)
- Change document.title suffix from 'GSD 2' to 'GSD'
- Remove border-l from MilestoneExplorer (drag handle provides separation)

* docs: quick task 2 summary and state update

* feat: spawn GSD instance in right-side terminal, rename browser tab to GSD

- Add command option to PTY manager to spawn pi instead of default shell
- Thread command param through terminal API routes and ShellTerminal component
- DualTerminal right pane now launches a separate pi (GSD) instance
- Update header label to 'Right: Interactive GSD'
- Set browser tab title to 'GSD' instead of project folder name

* fix: use distinct default session ID for GSD terminal to avoid reusing stale zsh session

* fix: make shell terminal respect light/dark theme

- Add light xterm theme alongside existing dark theme
- Detect theme via next-themes useTheme and pass isDark to terminal instances
- Dynamically update xterm theme when user switches themes
- Replace all hardcoded dark bg colors (#0a0a0a, #0c0c0c, zinc-*) with
  theme-aware classes (bg-terminal, text-muted-foreground, etc.)

* feat: add loading spinner while terminal session initializes

* feat: replace left-side AutoTerminal with real GSD terminal instance

- Remove custom AutoTerminal React component
- Left side now runs a real pi terminal (sessionPrefix=gsd-main)
- Right side uses sessionPrefix=gsd-interactive for isolation
- Add sessionPrefix prop to ShellTerminal for distinct session IDs
- Update header labels: Left: Primary GSD | Right: Interactive GSD

* feat: auto-select STATE.md on files view initial load

* feat: pre-initialize dual terminal PTY sessions on boot

Keep DualTerminal always mounted (hidden when not active) so PTY
sessions spawn as soon as the bridge connects. Terminals are ready
immediately when the user switches to the power view.

* fix: move STATE.md auto-select effect after handleSelectFile declaration

Fixes TDZ ReferenceError — the useEffect was referencing handleSelectFile
before its useCallback declaration.

* chore(M006): record integration branch

* Squashed commit of the following:

commit e3f495a224f53e954798b6f96a59806db43bfdb0
Author: snowdamiz <yurlovandrew@gmail.com>
Date:   Tue Mar 17 16:12:50 2026 -0400

    chore: auto-commit before milestone merge

commit d9a0193c9c54fafcaff6bc0de7c169936f41b2df
Author: snowdamiz <yurlovandrew@gmail.com>
Date:   Tue Mar 17 08:35:53 2026 -0400

    chore: auto-commit before milestone merge

commit 010430059ca50c6b773ee4480e42d2c54a1c0b75
Author: snowdamiz <yurlovandrew@gmail.com>
Date:   Tue Mar 17 04:57:49 2026 -0400

    chore(M006): record integration branch

commit a6f6d0294c90a253585571a5a9615c7f3e41e7ea
Author: snowdamiz <yurlovandrew@gmail.com>
Date:   Tue Mar 17 04:57:36 2026 -0400

    docs: queue M006 — Multi-project workspace

commit b2dd57423835d132f6d3963abbb2bfc799e64100
Author: snowdamiz <yurlovandrew@gmail.com>
Date:   Tue Mar 17 03:43:52 2026 -0400

    chore(M005): record integration branch

# Conflicts:
#	.gsd/DECISIONS.md
#	.gsd/PROJECT.md
#	.gsd/REQUIREMENTS.md
#	.gsd/milestones/M006/M006-META.json
#	src/web/recovery-diagnostics-service.ts

* chore(M006): record integration branch

* feat(M006): Multi-Project Workspace

Completed slices:
- S01: Bridge registry and project-scoped API surface
- S02: Project discovery, Projects view, and store switching
- S03: Onboarding dev root step, context-aware launch, and final assembly

Branch: milestone/M006

* refactor(visualizer): redesign visualizer-view layout and tab structure

* docs(M007): context, requirements, and roadmap

* chore(M007): record integration branch

* docs(M007): rewrite roadmap and all slice plans to new template format

* chore(M007/S01/T01): auto-commit after execute-task

* chore(M007/S01/T02): auto-commit after execute-task

* chore(M007/S01): auto-commit after complete-slice

* chore(M007/S01): auto-commit after reassess-roadmap

* chore(M007/S02/T01): auto-commit after execute-task

* chore(M007/S02/T02): auto-commit after execute-task

* chore(M007/S02/T03): auto-commit after execute-task

* chore(M007/S02): auto-commit after complete-slice

* chore(M007/S02): auto-commit after reassess-roadmap

* chore(M007/S03/T01): auto-commit after execute-task

* chore(M007/S03/T02): auto-commit after execute-task

* chore(M007/S03): auto-commit after complete-slice

* chore(M007/S03): auto-commit after reassess-roadmap

* chore(M007/S04/T01): auto-commit after execute-task

* chore(M007/S04/T02): auto-commit after execute-task

* chore(M007/S04/T03): auto-commit after execute-task

* chore(M007/S04): auto-commit after complete-slice

* chore(M007): auto-commit after complete-milestone

* feat(M007): Chat Mode — Consumer-Grade GSD Interface

Completed slices:
- S01: PTY output parser and chat message model
- S02: Chat Mode view — main pane
- S03: TUI prompt intercept UI
- S04: Action toolbar and right panel lifecycle

Branch: milestone/M007

* feat(chat-mode): move Discuss to input bar

* fix(web): launch browser PTYs with GSD loader

* chore(M005): record integration branch

* feat(M005): Light Theme with System-Aware Toggle

Completed slices:
- S01: Theme foundation and NavRail toggle
- S02: Component color audit and visual verification

Branch: milestone/M005

* chore(M007): record integration branch

* feat(web): chat mode action bar, smart CTA, project-level status bar, centered visualizer tabs

- Chat input bar: top 3 buttons (Discuss, Next, Auto) + overflow menu with all /gsd subcommands grouped by category, tooltips on hover
- Action routing: main-panel commands (next, auto, stop, pause) vs action-panel commands (discuss, status, visualize, etc.)
- Removed Config, Hooks, Migrate, Inspect from action menu
- Smart placeholder CTA: derives contextual button from workspace state (New Milestone, Start Auto, Resume, Plan, etc.)
- Status bar: project-level totals (duration, tokens, cost) from visualizer API instead of session-scoped auto data
- Visualizer: centered tab bar

* docs(M008): context, requirements, and roadmap

* chore(M008): record integration branch

* chore(M008/S01): auto-commit after research-slice

* docs(S01): add slice plan

* chore(M008/S01/T01): auto-commit after execute-task

* chore(M008/S01/T02): auto-commit after execute-task

* chore(M008/S01): auto-commit after complete-slice

* chore(M008/S01): auto-commit after reassess-roadmap

* chore(M008/S02): auto-commit after research-slice

* docs(S02): add slice plan

* chore(M008/S02/T01): auto-commit after execute-task

* chore(M008/S02/T02): auto-commit after execute-task

* chore(M008/S02): auto-commit after complete-slice

* chore(M008/S02): auto-commit after reassess-roadmap

* chore(M008/S03): auto-commit after research-slice

* docs(S03): add slice plan

* chore(M008/S03/T01): auto-commit after execute-task

* chore(M008/S03/T02): auto-commit after execute-task

* chore(M008/S03/T03): auto-commit after execute-task

* chore(M008/S03): auto-commit after complete-slice

* chore(M008/S03): auto-commit after reassess-roadmap

* chore(M008/S04): auto-commit after research-slice

* docs(S04): add slice plan

* chore(M008/S04/T01): auto-commit after execute-task

* chore(M008/S04/T02): auto-commit after execute-task

* chore(M008/S04): auto-commit after complete-slice

* chore(M008/S04): auto-commit after reassess-roadmap

* chore(M008/S05): auto-commit after research-slice

* docs(S05): add slice plan

* chore(M008/S05/T01): auto-commit after execute-task

* chore(M008/S05/T02): auto-commit after execute-task

* chore(M008/S05): auto-commit after complete-slice

* chore(M008): auto-commit after complete-milestone

* feat(M008): Web Polish

Completed slices:
- S01: Projects Page Redesign
- S02: Browser Update UI
- S03: Theme Defaults & Light Mode Color Audit
- S04: Remote Questions Settings
- S05: Progress Bar Dynamics & Terminal Text Size

Branch: milestone/M008

* docs: project plan — 3 milestones (M009 editor, M010 upstream sync, M011 CI/CD+PWA)

* chore(M009): record integration branch

* chore(M009/S01): auto-commit after research-slice

* docs(S01): add slice plan

* chore(M009/S01/T01): auto-commit after execute-task

* chore(M009/S01/T02): auto-commit after execute-task

* chore(M009/S01): auto-commit after complete-slice

* chore(M009/S01): auto-commit after reassess-roadmap

* chore(M009/S02): auto-commit after research-slice

* docs(S02): add slice plan

* state: S02 executing, next T01

* chore(M009/S02/T01): auto-commit after execute-task

* chore(M009/S02/T02): auto-commit after execute-task

* chore: untrack .gsd/ runtime files from git index

* chore(M009/S04): auto-commit after plan-slice

* docs(S04): add slice plan

* feat(S04/T01): Added dual shiki theme loading (dark + light) driven by…

- web/components/gsd/file-content-viewer.tsx

* chore(M010): record integration branch

* chore(M011): record integration branch

* feat(S02/T01): Added dist/web/standalone/{server.js, public/manifest.js…

- scripts/validate-pack.js

* test(S02/T02): Created .github/workflows/web.yml with full web host CI…

- .github/workflows/web.yml

* fix gitignore

* chore: update .gitignore to match upstream, untrack ignored files

- Updated .gitignore to match upstream/main patterns
- Removed 498 tracked files now covered by .gitignore:
  - .gsd/ project state (milestones, plans, summaries, db files)
  - Stale lock files (bun.lock, root pnpm-lock.yaml, web/pnpm-lock.yaml)
- Preserved upstream-tracked files:
  - pkg/dist/core/export-html/ (negation rules)
  - packages/*/pnpm-lock.yaml (tracked upstream)

* feat(M011): PWA support — service worker, install prompt, CI workflow

Squash-merge of milestone/M011 branch.

- Serwist service worker integration with Next.js (sw.ts, sw-register.tsx)
- PWA manifest with standalone display mode and app icons
- Install prompt hook and dismissible banner component
- Web host CI workflow (.github/workflows/web.yml)
- Updated web/.gitignore for Serwist build artifacts
- validate-pack.js script addition

* refine .gitignore: track GSD project artifacts, ignore runtime state

* gitignore: restore full .gsd/ exclusion

* docs(M012): context, requirements, and roadmap

* feat(S01/T01): Squash-merged 443 upstream commits (v2.22→v2.31) into fo…

- .gitignore
- src/cli.ts
- src/resource-loader.ts
- src/resources/extensions/get-secrets-from-user.ts
- src/resources/extensions/gsd/workspace-index.ts
- package-lock.json

* chore: squash merge upstream/main (v2.22→v2.31)

Merges 443 upstream commits from v2.22 to v2.31.0. Resolves 12 conflict files. Preserves fork web-mode additions. Switches web build to webpack mode for NodeNext .js extension import compatibility.

* feat(S02/T01): Added a lowercase "beta" pill badge next to the GSD logo…

- web/components/gsd/app-shell.tsx

* feat(S03/T01): Branch FileContentViewer editable mode: non-markdown fil…

- web/components/gsd/file-content-viewer.tsx

* chore(S04/T01): Added image input pipeline for chat mode: drag-and-drop…

- web/lib/image-utils.ts
- web/components/gsd/chat-mode.tsx
- web/lib/pty-chat-parser.ts
- web/lib/gsd-workspace-store.tsx

* feat(S04/T02): Created /api/terminal/upload endpoint and wired drag-dro…

- web/app/api/terminal/upload/route.ts
- web/components/gsd/shell-terminal.tsx

* chore(S05/T01): Replaced left ShellTerminal with bridge-event Terminal…

- web/components/gsd/dual-terminal.tsx

* feat(S06/T01): Created GuidedDialog component wrapping ChatPane in a fu…

- web/components/gsd/guided-dialog.tsx
- web/components/gsd/project-welcome.tsx

* feat(S06/T02): Wired GuidedDialog into Dashboard with nullable state, o…

- web/components/gsd/dashboard.tsx

* merge upstream/main: sync with v2.31.2, resolve conflicts preserving fork web UI changes

- Version bumps: 2.31.0 → 2.31.2 across all packages
- Upstream refactors adopted: createGitService factory, dispatchUnit helper,
  STATE_REBUILD_MIN_INTERVAL_MS constant extraction, KNOWN_UNIT_TYPES centralization
- New upstream features merged: environment health checks, progress score,
  doctor providers, health widget, auto-reentrancy guard
- Fork-specific code preserved: web CLI branch, TTY check with --web hint,
  workspace index risk/depends/demo fields, dist-redirect web/ extensionless imports
- checkExistingEnvKeys moved inline (upstream deleted env-key-utils.ts)
- Fixed 5 pre-existing test failures: edit-mode slash command parity,
  gsd:web script assertion, dual-terminal store contract (moved to terminal.tsx)

* ci: consolidate web workflow into main CI pipeline

Moved web host install and build steps into the CI build job.
Removed the separate web.yml workflow.

* fix(tests): configure onboarding service in bridge/live tests for CI

Tests calling sendBridgeInput via the command route now configure
the onboarding service with in-memory auth storage. Without this,
collectOnboardingState() returns locked (no API key in CI env),
causing all command route calls to return HTTP 423.

* fix: CI and Windows portability for web mode tests

- cli.ts: early TTY check now skips when --web flag is set, allowing
  headless web mode launches in CI (fixes 5 runtime harness failures)
- auto-dashboard-service.ts: convert --import path to file:// URL via
  pathToFileURL() (fixes ERR_UNSUPPORTED_ESM_URL_SCHEME on Windows)
- web-mode-cli.test.ts: use resolve() for registry key lookups so
  Windows-normalized paths match (fixes registerInstance/unregisterInstance)
- web-mode-assembled.test.ts: configure onboarding service with
  in-memory auth for settings and slash-command tests (fixes 423 in CI)

* fix: Windows portability for all web service subprocess launchers

All 17 `--import` arguments across web service files now use
pathToFileURL().href instead of raw file paths. Node's --import
flag requires URL scheme on Windows (D:\ paths fail with
ERR_UNSUPPORTED_ESM_URL_SCHEME).

Affected services: auto-dashboard, recovery-diagnostics, hooks,
export, cleanup, forensics, history, settings, doctor, skill-health,
undo, visualizer, bridge, captures, cli-entry.

Also fixes:
- web-session-parity-contract: normalize git rev-parse output with
  resolve() for Windows backslash consistency

* fix: repair web recovery diagnostics CI failures

* test: align launched-host integration flows with current web UI

* fix(ci): stabilize packaged web onboarding flow

* feat(web): render main-session native TUI in power user mode

* Update web terminal parity and eslint setup

* Fix web lint and typecheck issues

* Normalize Power User terminal headers

* Restore Geist web font loading

* fix(web): update PWA app name and icon assets

* Remove web PWA functionality

* fix(web): scope terminal surfaces to active project

* feat(web): add project creation flow

* refactor(web): centralize workflow actions and simplify dashboard

* test(web): align packaged runtime integration flows

* fix: route dashboard/sidebar CTA commands through session API and handle RPC lock conflicts

Two bugs prevented the dashboard and sidebar workflow action buttons
(New Milestone, Start Auto, Initialize Project, etc.) from working:

1. Frontend: executeWorkflowActionInPowerMode sent commands via raw
   fetch to /api/bridge-terminal/input (PTY keystroke injection) instead
   of the session command pipeline (/api/session/command). The agent
   never received these commands. Refactored to accept a dispatch
   callback that callers wire through sendCommand(buildPromptCommand()).

2. Backend: guardRemoteSession in the /gsd extension called
   showNextAction() — an interactive TUI prompt — when it detected
   another session's lock. In RPC/web bridge mode this blocks forever
   since there is no terminal to answer the prompt. Now detects
   GSD_WEB_BRIDGE_TUI=1 and emits an actionable warning notification
   instead of blocking.

Files changed:
- web/lib/workflow-action-execution.ts (dispatch callback instead of raw fetch)
- web/components/gsd/dashboard.tsx (pass store-backed dispatch)
- web/components/gsd/sidebar.tsx (MilestoneExplorer + CollapsedMilestoneSidebar)
- src/resources/extensions/gsd/commands.ts (RPC-mode guard in guardRemoteSession)

* fix: terminal drag-drop image upload, Shift+Enter newline, and chat mode unified response bubble

Bug 1 - Power Mode drag-drop: Dropping images on either terminal pane
opened the file in a new tab instead of uploading. Fixed by switching
all drag/drop handlers to native DOM capture-phase listeners (React
synthetic events don't reliably fire through xterm's internal DOM).
Both panes now upload images via /api/terminal/upload and inject
@filepath into the terminal input. DualTerminal wrapper prevents
browser default file-navigation as a safety net.

Bug 2 - Chat Mode dual response: During streaming, the assistant
response and thinking indicator rendered as two separate UI blocks.
Fixed by moving thinking content inline into the assistant ChatBubble
via a new InlineThinking component. Removed the standalone
ThinkingIndicator. Thinking text now appears as a collapsible section
above the response text within the same bubble.

Bug 3 - Shift+Enter newline: xterm.js sends \r for both Enter and
Shift+Enter, but pi's TUI editor expects \n (LF) for newline
insertion. Added native DOM capture-phase keydown listeners on both
MainSessionTerminal and ShellTerminal that intercept Shift+Enter,
preventDefault to block xterm, and send \n through the input channel.

* chore: update lockfile and tsbuildinfo

* refactor: remove right-side action panel, route all commands through main bridge

- Remove ActionPanel, StructuredTerminalActionPane, and all PTY screen-scraping
  infrastructure (~700 lines deleted: stripTerminalChrome, isScreenChromeLine,
  normalizeScreenLine, beautifyParsedScreenContent, parseStructuredTerminalScreen,
  SCREEN_* constants, hidden xterm.js terminal buffer)

- All /gsd subcommands now dispatch through the main bridge session via
  sendCommand(buildPromptCommand()). No separate PTY instances.

- Add disabledDuringAuto flag to GSDActionDef. Commands that inject competing
  LLM prompts are disabled while auto-mode runs:
  - discuss: calls dispatchWorkflow -> pi.sendMessage (would conflict with auto)
  - triage: injects triage prompt via pi.sendMessage (same conflict)
  - All other commands verified safe: stop/pause control auto, steer explicitly
    handles auto with HARD STEER message, capture/knowledge/skip are file IO,
    status/queue/history/visualize are read-only, mode/prefs/doctor/export/
    cleanup/remote are config/maintenance

- Add inline PendingUiRequest rendering in ChatPane: select (single + multi),
  confirm, input, and editor requests appear as interactive chat bubbles in the
  message flow with native clickable controls and post-submission confirmation

- Wire FocusedPanel in app-shell.tsx as fallback overlay for pendingUiRequests
  in non-chat views (dashboard, power mode, files, etc.)

- Remove unused imports: AnimatePresence, motion, buildProjectAbsoluteUrl,
  buildProjectPath, HeadlessTerminal type, compact prop

* chore: gitignore tsbuildinfo files

* onboarding overhaul: add mode, project, and remote steps; refactor existing steps

- Add step-mode.tsx for user/dev mode selection
- Add step-project.tsx for project selection/creation
- Add step-remote.tsx for remote repository configuration
- Add use-user-mode.ts hook for mode state management
- Add /api/dev-mode route for dev mode toggle
- Refactor onboarding-gate.tsx flow and step sequencing
- Refactor step-authenticate, step-dev-root, step-optional,
  step-provider, step-ready, step-welcome with updated styling
- Update command-surface, app-shell, dashboard integrations
- Update dev-overrides and workflow-action-execution

* overhaul projects view, simplify boot readiness, add requireProjectCwd

- Redesign projects-view with Sheet/Dialog components and improved styling
- Simplify waitForBootReady: remove bridge phase tracking, return on first successful response
- Boot route returns minimal no-project payload when no project is configured
- Rename resolveProjectCwd → requireProjectCwd across all API routes
- Minor UI adjustments in app-shell, sidebar, terminal

* fix: update tests for upstream merge and UI refactor

Unit tests (7 fixes, 2133/2133 pass):
- smart-entry-complete: match upstream's chooser-based complete flow
- web-bridge-contract: add projectDetection to boot snapshot keys
- web-command-parity: await async registerExtension (upstream decomposition)
- web-mode-cli: update gsd:web script expectation (copy-resources added)
- web-state-surfaces: match refactored editorTextBuffer consumption
- web-workflow-action-execution: match new dispatch-based API, stub localStorage
- web-mode.ts: restore GSD_WEB_PROJECT_CWD in spawn env

Integration tests:
- web-mode-onboarding: simplify to API-only contract (locked→reject→retry→unlocked)
  without fragile browser UI assertions that depend on refactored wizard flow

* Clean up dashboard header and redesign project selection gate

- Simplify dashboard header: inline scope badge with title, remove
  workflow action buttons and status indicators
- Redesign project selection gate: center logo with subtitle, remove
  header bar and side gutters, cleaner layout
- Remove web-mode-runtime integration test

* settings: consolidate tabs, add General panel with font size controls

- Add General tab (terminal font size + code font size) as default settings landing
- Merge Thinking into Model tab (model selection + thinking level in one panel)
- Merge Queue + Compaction + Retry into Session tab (all session behavior knobs)
- Reduce settings nav from 8 tabs to 6 (+ admin when dev mode)
- Legacy section routes (thinking, queue, compaction, retry) still render correctly
- gsd-prefs mega-scroll uses GeneralPanel instead of separate Terminal/Editor panels

* fix: file explorer & visualizer use selected project context, resizable tree panel

- Route all fetch calls in files-view, visualizer-view, and status-bar
  through buildProjectUrl() so they respect the active project selection
  instead of falling back to GSD_WEB_PROJECT_CWD (server startup project)
- Make file explorer tree panel resizable (180-480px) with drag handle,
  matching the milestone sidebar resize pattern

* feat(web): file explorer Agent tab, merged headers, unified chat timeline

- Merge file path display + save button into single header row (3 layers → 2)
- Add Agent tab to file explorer left panel with embedded ChatPane
- Auto-open files in viewer when agent executes edit/write tools
- Show inline diff (red/green lines) for agent-edited files with auto-dismiss
- MD files default to Edit tab when agent-opened so raw changes are visible
- Unified chat timeline: tool executions render inline where they happen,
  not stacked at the bottom
- Persist user messages in workspace store so they survive tab switches
- Shorten chat input placeholder to 'Message…', remove hint text

* feat(chat): persist thinking blocks and render in chronological order

- Add TurnSegment type to track thinking/text/tool events in order
- Finalize streaming content into segments at phase transitions
  (thinking→text, text→thinking, tool start/end, turn boundary)
- Store completedTurnSegments parallel to liveTranscript for history
- Rebuild chat timeline from segments so thinking blocks render
  in their correct position between text and tool calls
- Thinking blocks now persist after streaming ends (collapsible)
- Restyle InlineThinking to monochrome (muted-foreground) — removes
  amber/warning colors for consistency with dark theme

* feat(web): add Integrations tab to settings panel for remote channel config

* feat(web): bot token input in settings and onboarding, card-based integrations panel

- Add PATCH endpoint to /api/remote-questions for saving bot tokens
  to ~/.gsd/agent/auth.json (same storage as TUI key manager)
- Redesign RemoteQuestionsPanel: card-based channel picker, inline
  token input with show/hide toggle, collapsible advanced settings,
  connected state banner with disconnect
- Add bot token input to onboarding StepRemote with same PATCH flow
- Remove 'configure via TUI or environment' messaging — web UI now
  handles the full setup end-to-end

* fix(web): address PR #1717 security review feedback

Security (blocking):
- Add bearer token auth to all API routes via Next.js middleware
- Generate random token at launch, pass to browser via URL fragment
- Add Origin/CORS validation rejecting cross-origin API requests
- Whitelist PTY commands (gsd, user shell, /bin/bash, /bin/zsh, /bin/sh)
- Restrict /api/browse-directories to devRoot scope

Cleanup:
- Move shiki, react-markdown, remark-gfm from root to web/package.json
- Remove as-any casts in input-controller.ts (extend host type properly)
- Add extensions_ready signal to RPC mode (fixes void bindExtensions race)
- Add test fixture dummy keys to .secretscanignore (fixes CI lint)

* fix(web): resolve Next.js 16 build warnings

- Rename middleware.ts → proxy.ts with proxy() export (Next.js 16 convention)
- Add @gsd/native to webpack externals (fixes package path resolution warning)
- Hide require fallback from webpack static analysis in pty-manager (fixes
  critical dependency warning)

* fix(web): pass auth token to boot readiness probe

The readiness probe hits /api/boot to check server startup, but the
proxy now requires a bearer token. Thread the authToken through
waitForBootReady → requestLocalJson so the probe authenticates.

* chore: sync lockfiles after moving deps to web/package.json

* fix(test): update web-mode-cli test for auth token in browser URL

The test asserted the exact opened URL, which now includes a random
auth token fragment. Updated to pattern-match the token and verify
GSD_WEB_AUTH_TOKEN is passed consistently in the spawn env.

* fix(test): pass auth token in web-mode-onboarding integration test

The runtime harness now extracts the auth token from the browser-open
stub log and exposes it on RuntimeLaunchResult.authToken. Added
runtimeAuthHeaders() helper. Updated the onboarding test to pass
Authorization headers on all fetch calls and waitForHttpOk.

* fix(test): match renamed nextMilestoneIdReserved in smart-entry-complete test

Upstream #1569 renamed nextMilestoneId → nextMilestoneIdReserved.
Updated the regex assertion to accept both names.

* feat(web): support GSD_WEB_ALLOWED_ORIGINS for secure tunnel setups

Adds a comma-separated GSD_WEB_ALLOWED_ORIGINS env var that merges
additional origins into the CORS allowlist. Defaults to localhost-only
when unset. Enables Tailscale Serve, Cloudflare Tunnel, ngrok, etc.
2026-03-21 12:16:54 -06:00

2335 lines
99 KiB
TypeScript

"use client"
import { useEffect, useMemo, useRef, useState } from "react"
import {
Archive,
ArrowRightLeft,
Brain,
Check,
ChevronRight,
Cpu,
Download,
ExternalLink,
FileText,
FolderRoot,
GitBranch,
KeyRound,
LifeBuoy,
LoaderCircle,
LogIn,
LogOut,
PencilLine,
Radio,
RefreshCw,
Search,
ShieldCheck,
SlidersHorizontal,
SquareTerminal,
X,
} from "lucide-react"
import { toast } from "sonner"
import { Badge } from "@/components/ui/badge"
import { Button } from "@/components/ui/button"
import { Input } from "@/components/ui/input"
import { ScrollArea } from "@/components/ui/scroll-area"
import {
Sheet,
SheetContent,
SheetDescription,
SheetHeader,
SheetTitle,
} from "@/components/ui/sheet"
import { Switch } from "@/components/ui/switch"
import { Textarea } from "@/components/ui/textarea"
import { Tooltip, TooltipContent, TooltipTrigger } from "@/components/ui/tooltip"
import {
COMMAND_SURFACE_THINKING_LEVELS,
type CommandSurfaceSection,
type CommandSurfaceTarget,
} from "@/lib/command-surface-contract"
import { cn } from "@/lib/utils"
import {
DEV_OVERRIDE_REGISTRY,
useDevOverrides,
} from "@/lib/dev-overrides"
import { DoctorPanel, ForensicsPanel, SkillHealthPanel } from "./diagnostics-panels"
import { KnowledgeCapturesPanel } from "./knowledge-captures-panel"
import { PrefsPanel, ModelRoutingPanel, BudgetPanel, RemoteQuestionsPanel, GeneralPanel } from "./settings-panels"
import { DevRootSettingsSection } from "./projects-view"
import {
QuickPanel,
HistoryPanel,
UndoPanel,
SteerPanel,
HooksPanel,
InspectPanel,
ExportPanel,
CleanupPanel,
QueuePanel,
StatusPanel,
} from "./remaining-command-panels"
import {
formatCost,
formatTokens,
getModelLabel,
getSessionLabelFromBridge,
shortenPath,
useGSDWorkspaceActions,
useGSDWorkspaceState,
} from "@/lib/gsd-workspace-store"
// ─── Section metadata ────────────────────────────────────────────────
const SETTINGS_SURFACE_SECTIONS = ["general", "model", "session-behavior", "recovery", "auth", "integrations", "workspace"] as const
const ADMIN_SECTION: CommandSurfaceSection = "admin"
const GIT_SURFACE_SECTIONS = ["git"] as const
const SESSION_SURFACE_SECTIONS = ["resume", "name", "fork", "session", "compact"] as const
function availableSectionsForSurface(surface: string | null, includeAdmin: boolean = false): CommandSurfaceSection[] {
switch (surface) {
case "git":
return [...GIT_SURFACE_SECTIONS]
case "resume":
case "name":
case "fork":
case "session":
case "export":
case "compact":
return [...SESSION_SURFACE_SECTIONS]
default:
return includeAdmin
? [...SETTINGS_SURFACE_SECTIONS, ADMIN_SECTION]
: [...SETTINGS_SURFACE_SECTIONS]
}
}
function sectionLabel(section: CommandSurfaceSection): string {
const labels: Partial<Record<CommandSurfaceSection, string>> = {
general: "General",
model: "Model",
thinking: "Thinking",
queue: "Queue",
compaction: "Compaction",
retry: "Retry",
"session-behavior": "Session",
recovery: "Recovery",
auth: "Auth",
admin: "Admin",
git: "Git",
resume: "Resume",
name: "Name",
fork: "Fork",
session: "Session",
compact: "Compact",
workspace: "Workspace",
integrations: "Integrations",
}
return labels[section] ?? section
}
function sectionIcon(section: CommandSurfaceSection) {
const icons: Partial<Record<CommandSurfaceSection, React.ReactNode>> = {
general: <SlidersHorizontal className="h-4 w-4" />,
model: <Cpu className="h-4 w-4" />,
thinking: <Brain className="h-4 w-4" />,
queue: <ArrowRightLeft className="h-4 w-4" />,
compaction: <Archive className="h-4 w-4" />,
retry: <RefreshCw className="h-4 w-4" />,
"session-behavior": <ArrowRightLeft className="h-4 w-4" />,
recovery: <LifeBuoy className="h-4 w-4" />,
auth: <ShieldCheck className="h-4 w-4" />,
admin: <SquareTerminal className="h-4 w-4" />,
git: <GitBranch className="h-4 w-4" />,
resume: <ArrowRightLeft className="h-4 w-4" />,
name: <PencilLine className="h-4 w-4" />,
fork: <GitBranch className="h-4 w-4" />,
session: <FileText className="h-4 w-4" />,
compact: <Archive className="h-4 w-4" />,
workspace: <FolderRoot className="h-4 w-4" />,
integrations: <Radio className="h-4 w-4" />,
}
return icons[section] ?? null
}
function surfaceTitle(surface: string | null): string {
const titles: Record<string, string> = {
model: "Model",
thinking: "Thinking",
git: "Git",
login: "Login",
logout: "Logout",
settings: "Settings",
resume: "Resume",
name: "Name",
fork: "Fork",
session: "Session",
export: "Export",
compact: "Compact",
}
return titles[surface ?? ""] ?? "Settings"
}
function currentAuthIntent(activeSurface: string | null, selectedTarget: CommandSurfaceTarget | null): "login" | "logout" | "manage" {
if (selectedTarget?.kind === "auth") return selectedTarget.intent
if (activeSurface === "login") return "login"
if (activeSurface === "logout") return "logout"
return "manage"
}
function formatRelativeTime(isoDate: string): string {
const now = Date.now()
const then = new Date(isoDate).getTime()
const diffMs = now - then
if (diffMs < 60_000) return "just now"
const minutes = Math.floor(diffMs / 60_000)
if (minutes < 60) return `${minutes}m ago`
const hours = Math.floor(minutes / 60)
if (hours < 24) return `${hours}h ago`
const days = Math.floor(hours / 24)
return `${days}d ago`
}
// ─── Inline status dot ──────────────────────────────────────────────
function StatusDot({ status }: { status: "ok" | "warning" | "error" | "idle" }) {
return (
<span
className={cn(
"inline-block h-1.5 w-1.5 rounded-full",
status === "ok" && "bg-success",
status === "warning" && "bg-warning",
status === "error" && "bg-destructive",
status === "idle" && "bg-foreground/20",
)}
/>
)
}
// ─── Inline section header ──────────────────────────────────────────
function SectionHeader({
title,
action,
status,
}: {
title: string
action?: React.ReactNode
status?: React.ReactNode
}) {
return (
<div className="flex items-center justify-between gap-3 pb-4">
<div className="flex items-center gap-2.5">
<h3 className="text-[13px] font-semibold uppercase tracking-[0.08em] text-foreground/70">{title}</h3>
{status}
</div>
{action}
</div>
)
}
// ─── Inline key-value row ───────────────────────────────────────────
function KV({ label, children, mono }: { label: string; children: React.ReactNode; mono?: boolean }) {
return (
<div className="flex items-baseline justify-between gap-4 py-1.5 text-sm">
<span className="shrink-0 text-muted-foreground">{label}</span>
<span className={cn("text-right text-foreground", mono && "font-mono text-xs")}>{children}</span>
</div>
)
}
// ─── Toggle row: label + switch ─────────────────────────────────────
function ToggleRow({
label,
description,
checked,
onCheckedChange,
disabled,
busy,
testId,
}: {
label: string
description?: string
checked: boolean
onCheckedChange: (checked: boolean) => void
disabled?: boolean
busy?: boolean
testId?: string
}) {
return (
<div className="flex items-start justify-between gap-4 rounded-lg border border-border/50 bg-card/50 px-4 py-3">
<div className="min-w-0">
<div className="flex items-center gap-2 text-sm font-medium text-foreground">
{label}
{busy && <LoaderCircle className="h-3 w-3 animate-spin text-muted-foreground" />}
</div>
{description && <p className="mt-0.5 text-xs text-muted-foreground">{description}</p>}
</div>
<Switch checked={checked} onCheckedChange={onCheckedChange} disabled={disabled || busy} data-testid={testId} />
</div>
)
}
// ─── Segmented control ──────────────────────────────────────────────
function SegmentedControl<T extends string>({
options,
value,
onChange,
disabled,
}: {
options: { value: T; label: string }[]
value: T | null
onChange: (value: T) => void
disabled?: boolean
}) {
return (
<div className="inline-flex rounded-lg border border-border/60 bg-card/30 p-0.5">
{options.map((opt) => (
<button
key={opt.value}
type="button"
className={cn(
"rounded-md px-3 py-1.5 text-xs font-medium transition-all",
value === opt.value
? "bg-foreground/10 text-foreground shadow-sm"
: "text-muted-foreground hover:text-foreground",
)}
onClick={() => onChange(opt.value)}
disabled={disabled || value === opt.value}
>
{opt.label}
</button>
))}
</div>
)
}
// ═════════════════════════════════════════════════════════════════════
// MAIN COMPONENT
// ═════════════════════════════════════════════════════════════════════
export function CommandSurface() {
const workspace = useGSDWorkspaceState()
const {
closeCommandSurface,
openCommandSurface,
refreshBoot,
setCommandSurfaceSection,
selectCommandSurfaceTarget,
loadGitSummary,
loadRecoveryDiagnostics,
loadForensicsDiagnostics,
loadDoctorDiagnostics,
loadSkillHealthDiagnostics,
loadKnowledgeData,
loadCapturesData,
loadSettingsData,
updateSessionBrowserState,
loadSessionBrowser,
renameSessionFromSurface,
loadAvailableModels,
applyModelSelection,
applyThinkingLevel,
setSteeringModeFromSurface,
setFollowUpModeFromSurface,
setAutoCompactionFromSurface,
setAutoRetryFromSurface,
abortRetryFromSurface,
switchSessionFromSurface,
loadSessionStats,
exportSessionFromSurface,
loadForkMessages,
forkSessionFromSurface,
compactSessionFromSurface,
saveApiKeyFromSurface,
startProviderFlowFromSurface,
submitProviderFlowInputFromSurface,
cancelProviderFlowFromSurface,
logoutProviderFromSurface,
loadHistoryData,
loadInspectData,
loadHooksData,
loadUndoInfo,
loadCleanupData,
loadSteerData,
} = useGSDWorkspaceActions()
const { commandSurface } = workspace
const onboarding = workspace.boot?.onboarding ?? null
const activeFlow = onboarding?.activeFlow ?? null
const gitSummary = commandSurface.gitSummary
const recovery = commandSurface.recovery
const sessionBrowser = commandSurface.sessionBrowser
const liveSessionState = workspace.boot?.bridge.sessionState ?? null
const settingsRequests = commandSurface.settingsRequests
const currentModelLabel = getModelLabel(workspace.boot?.bridge)
const currentSessionLabel = getSessionLabelFromBridge(workspace.boot?.bridge)
const [apiKeys, setApiKeys] = useState<Record<string, string>>({})
const [flowInput, setFlowInput] = useState("")
const commandSurfaceViewportRef = useRef<HTMLDivElement>(null)
// ─── Auto-loaders ──────────────────────────────────────────────────
useEffect(() => {
if (!commandSurface.open || commandSurface.section !== "model") return
if (commandSurface.availableModels.length > 0) return
if (commandSurface.pendingAction === "loading_models") return
void loadAvailableModels()
}, [commandSurface.open, commandSurface.section, commandSurface.availableModels.length, commandSurface.pendingAction, loadAvailableModels])
useEffect(() => {
if (!commandSurface.open || commandSurface.section !== "git") return
if (commandSurface.pendingAction === "load_git_summary") return
if (commandSurface.gitSummary.loaded || commandSurface.gitSummary.error) return
void loadGitSummary()
}, [commandSurface.open, commandSurface.section, commandSurface.pendingAction, commandSurface.gitSummary.loaded, commandSurface.gitSummary.error, loadGitSummary])
useEffect(() => {
if (!commandSurface.open || commandSurface.section !== "recovery") return
if (commandSurface.pendingAction === "load_recovery_diagnostics") return
if (commandSurface.recovery.pending) return
if (commandSurface.recovery.loaded && !commandSurface.recovery.stale && !commandSurface.recovery.error) return
void loadRecoveryDiagnostics()
}, [
commandSurface.open,
commandSurface.section,
commandSurface.pendingAction,
commandSurface.recovery.pending,
commandSurface.recovery.loaded,
commandSurface.recovery.stale,
commandSurface.recovery.error,
loadRecoveryDiagnostics,
])
// Auto-fetch diagnostics panels when their sections open
const diagnostics = commandSurface.diagnostics
const knowledgeCaptures = commandSurface.knowledgeCaptures
const settingsData = commandSurface.settingsData
const remainingCommands = commandSurface.remainingCommands
useEffect(() => {
if (!commandSurface.open) return
if (commandSurface.section === "gsd-forensics" && diagnostics.forensics.phase === "idle") {
void loadForensicsDiagnostics()
} else if (commandSurface.section === "gsd-doctor" && diagnostics.doctor.phase === "idle") {
void loadDoctorDiagnostics()
} else if (commandSurface.section === "gsd-skill-health" && diagnostics.skillHealth.phase === "idle") {
void loadSkillHealthDiagnostics()
} else if (
commandSurface.section === "gsd-knowledge" &&
knowledgeCaptures.knowledge.phase === "idle"
) {
void loadKnowledgeData()
void loadCapturesData()
} else if (
(commandSurface.section === "gsd-capture" || commandSurface.section === "gsd-triage") &&
knowledgeCaptures.captures.phase === "idle"
) {
void loadCapturesData()
void loadKnowledgeData()
} else if (
(commandSurface.section === "gsd-prefs" ||
commandSurface.section === "gsd-mode" ||
commandSurface.section === "gsd-config") &&
settingsData.phase === "idle"
) {
void loadSettingsData()
} else if (commandSurface.section === "gsd-history" && remainingCommands.history.phase === "idle") {
void loadHistoryData()
} else if (commandSurface.section === "gsd-inspect" && remainingCommands.inspect.phase === "idle") {
void loadInspectData()
} else if (commandSurface.section === "gsd-hooks" && remainingCommands.hooks.phase === "idle") {
void loadHooksData()
} else if (commandSurface.section === "gsd-undo" && remainingCommands.undo.phase === "idle") {
void loadUndoInfo()
} else if (commandSurface.section === "gsd-cleanup" && remainingCommands.cleanup.phase === "idle") {
void loadCleanupData()
} else if (commandSurface.section === "gsd-steer" && remainingCommands.steer.phase === "idle") {
void loadSteerData()
}
}, [
commandSurface.open,
commandSurface.section,
diagnostics.forensics.phase,
diagnostics.doctor.phase,
diagnostics.skillHealth.phase,
knowledgeCaptures.knowledge.phase,
knowledgeCaptures.captures.phase,
settingsData.phase,
remainingCommands.history.phase,
remainingCommands.inspect.phase,
remainingCommands.hooks.phase,
remainingCommands.undo.phase,
remainingCommands.cleanup.phase,
remainingCommands.steer.phase,
loadForensicsDiagnostics,
loadDoctorDiagnostics,
loadSkillHealthDiagnostics,
loadKnowledgeData,
loadCapturesData,
loadSettingsData,
loadHistoryData,
loadInspectData,
loadHooksData,
loadUndoInfo,
loadCleanupData,
loadSteerData,
])
useEffect(() => {
if (!commandSurface.open || (commandSurface.section !== "resume" && commandSurface.section !== "name")) return
if (commandSurface.pendingAction === "load_session_browser") return
if (commandSurface.sessionBrowser.loaded) return
void loadSessionBrowser()
}, [commandSurface.open, commandSurface.section, commandSurface.pendingAction, commandSurface.sessionBrowser.loaded, loadSessionBrowser])
useEffect(() => {
if (!commandSurface.open) return
const viewport = commandSurfaceViewportRef.current
if (!viewport) return
viewport.scrollTop = 0
}, [commandSurface.open, commandSurface.activeSurface, commandSurface.section])
useEffect(() => {
if (!commandSurface.open || commandSurface.section !== "session") return
if (commandSurface.sessionStats) return
if (commandSurface.pendingAction === "load_session_stats") return
void loadSessionStats()
}, [commandSurface.open, commandSurface.section, commandSurface.sessionStats, commandSurface.pendingAction, loadSessionStats])
useEffect(() => {
if (!commandSurface.open || commandSurface.section !== "fork") return
if (commandSurface.forkMessages.length > 0) return
if (commandSurface.pendingAction === "load_fork_messages") return
void loadForkMessages()
}, [commandSurface.open, commandSurface.section, commandSurface.forkMessages.length, commandSurface.pendingAction, loadForkMessages])
useEffect(() => {
if (!commandSurface.open || commandSurface.section !== "resume") return
const selectedResumeTarget = commandSurface.selectedTarget?.kind === "resume" ? commandSurface.selectedTarget : null
if (selectedResumeTarget?.sessionPath) return
const defaultSession = sessionBrowser.sessions.find((session) => !session.isActive) ?? sessionBrowser.sessions[0]
if (!defaultSession) return
selectCommandSurfaceTarget({ kind: "resume", sessionPath: defaultSession.path })
}, [commandSurface.open, commandSurface.section, commandSurface.selectedTarget, sessionBrowser.sessions, selectCommandSurfaceTarget])
useEffect(() => {
if (!commandSurface.open || commandSurface.section !== "name") return
const selectedNameTarget = commandSurface.selectedTarget?.kind === "name" ? commandSurface.selectedTarget : null
if (selectedNameTarget?.sessionPath) return
const defaultSession = sessionBrowser.sessions.find((session) => session.isActive) ?? sessionBrowser.sessions[0]
if (!defaultSession) return
selectCommandSurfaceTarget({ kind: "name", sessionPath: defaultSession.path, name: defaultSession.name ?? "" })
}, [commandSurface.open, commandSurface.section, commandSurface.selectedTarget, sessionBrowser.sessions, selectCommandSurfaceTarget])
useEffect(() => {
const resetTimer = window.setTimeout(() => {
setFlowInput("")
}, 0)
return () => window.clearTimeout(resetTimer)
}, [activeFlow?.flowId])
// ─── Toast on action results ───────────────────────────────────────
useEffect(() => {
if (commandSurface.lastError) {
toast.error(commandSurface.lastError)
}
}, [commandSurface.lastError])
useEffect(() => {
if (commandSurface.lastResult) {
toast.success(commandSurface.lastResult)
}
}, [commandSurface.lastResult])
// ─── Derived state ─────────────────────────────────────────────────
const selectedModelTarget = commandSurface.selectedTarget?.kind === "model" ? commandSurface.selectedTarget : null
const selectedThinkingTarget = commandSurface.selectedTarget?.kind === "thinking" ? commandSurface.selectedTarget : null
const selectedAuthTarget = commandSurface.selectedTarget?.kind === "auth" ? commandSurface.selectedTarget : null
const selectedResumeTarget = commandSurface.selectedTarget?.kind === "resume" ? commandSurface.selectedTarget : null
const selectedNameTarget = commandSurface.selectedTarget?.kind === "name" ? commandSurface.selectedTarget : null
const selectedForkTarget = commandSurface.selectedTarget?.kind === "fork" ? commandSurface.selectedTarget : null
const selectedSessionTarget = commandSurface.selectedTarget?.kind === "session" ? commandSurface.selectedTarget : null
const selectedCompactTarget = commandSurface.selectedTarget?.kind === "compact" ? commandSurface.selectedTarget : null
const selectedAuthIntent = currentAuthIntent(commandSurface.activeSurface, commandSurface.selectedTarget)
const selectedAuthProvider = onboarding?.required.providers.find((provider) => provider.id === selectedAuthTarget?.providerId) ?? null
const modelQuery = (selectedModelTarget?.query ?? commandSurface.args).trim().toLowerCase()
const filteredModels = useMemo(() => {
if (!modelQuery) return commandSurface.availableModels
return commandSurface.availableModels.filter((model) =>
`${model.provider} ${model.modelId} ${model.name ?? ""}`.toLowerCase().includes(modelQuery),
)
}, [commandSurface.availableModels, modelQuery])
// Group filtered models by provider for display
const groupedModels = useMemo(() => {
const groups = new Map<string, typeof filteredModels>()
for (const model of filteredModels) {
const key = model.provider
const existing = groups.get(key)
if (existing) existing.push(model)
else groups.set(key, [model])
}
return groups
}, [filteredModels])
const authBusy = workspace.onboardingRequestState !== "idle"
const modelBusy = commandSurface.pendingAction === "loading_models" || workspace.commandInFlight === "get_available_models"
const gitSummaryBusy = commandSurface.pendingAction === "load_git_summary"
const recoveryBusy = commandSurface.pendingAction === "load_recovery_diagnostics" || recovery.pending
const recoveryDiagnostics = recovery.diagnostics
const sessionBrowserBusy = commandSurface.pendingAction === "load_session_browser"
const forkBusy = commandSurface.pendingAction === "load_fork_messages" || commandSurface.pendingAction === "fork_session"
const sessionBusy = commandSurface.pendingAction === "load_session_stats" || commandSurface.pendingAction === "export_html"
const resumeBusy = commandSurface.pendingAction === "switch_session"
const renameBusy = commandSurface.pendingAction === "rename_session"
const compactBusy = commandSurface.pendingAction === "compact_session" || liveSessionState?.isCompacting === true
const queueBusy = settingsRequests.steeringMode.pending || settingsRequests.followUpMode.pending
const autoCompactionBusy = settingsRequests.autoCompaction.pending
const autoRetryBusy = settingsRequests.autoRetry.pending
const abortRetryBusy = settingsRequests.abortRetry.pending
const selectedProviderApiKey = selectedAuthProvider ? apiKeys[selectedAuthProvider.id] ?? "" : ""
const devOverrides = useDevOverrides()
const surfaceSections = availableSectionsForSurface(commandSurface.activeSurface, devOverrides.isDevMode)
const surfaceKindLabel = `/${commandSurface.activeSurface ?? "settings"}`
const triggerRecoveryBrowserAction = (actionId: string) => {
switch (actionId) {
case "refresh_diagnostics":
void loadRecoveryDiagnostics()
return
case "refresh_workspace":
void refreshBoot({ soft: true })
return
case "open_retry_controls":
setCommandSurfaceSection("retry")
return
case "open_resume_controls":
openCommandSurface("resume", { source: "surface" })
return
case "open_auth_controls":
setCommandSurfaceSection("auth")
return
default:
return
}
}
// ═══════════════════════════════════════════════════════════════════
// SECTION RENDERERS
// ═══════════════════════════════════════════════════════════════════
const renderModelSection = () => (
<div className="space-y-4" data-testid="command-surface-models">
<SectionHeader
title="Model"
status={
<span className="font-mono text-xs text-muted-foreground">{currentModelLabel}</span>
}
action={
<Button type="button" variant="ghost" size="sm" onClick={() => void loadAvailableModels()} disabled={modelBusy} className="h-7 gap-1.5 text-xs">
<RefreshCw className={cn("h-3 w-3", modelBusy && "animate-spin")} />
Refresh
</Button>
}
/>
{/* Search filter */}
<div className="relative">
<Search className="absolute left-3 top-1/2 h-3.5 w-3.5 -translate-y-1/2 text-muted-foreground" />
<Input
value={selectedModelTarget?.query ?? commandSurface.args}
onChange={(e) =>
selectCommandSurfaceTarget({
kind: "model",
provider: selectedModelTarget?.provider,
modelId: selectedModelTarget?.modelId,
query: e.target.value,
})
}
placeholder="Filter models…"
className="h-8 pl-9 text-xs"
/>
</div>
{/* Model list */}
{modelBusy && commandSurface.availableModels.length === 0 ? (
<div className="flex items-center gap-2 py-8 text-xs text-muted-foreground">
<LoaderCircle className="h-3.5 w-3.5 animate-spin" />
Loading models
</div>
) : filteredModels.length > 0 ? (
<div className="space-y-4">
{Array.from(groupedModels.entries()).map(([provider, models]) => (
<div key={provider}>
<div className="mb-1.5 px-1 text-[10px] font-semibold uppercase tracking-widest text-muted-foreground/60">
{provider}
</div>
<div className="space-y-0.5">
{models.map((model) => {
const selected = selectedModelTarget?.provider === model.provider && selectedModelTarget?.modelId === model.modelId
return (
<button
key={`${model.provider}/${model.modelId}`}
type="button"
className={cn(
"group flex w-full items-center gap-3 rounded-lg px-3 py-2 text-left transition-colors",
selected
? "bg-foreground/[0.07]"
: "hover:bg-foreground/[0.03]",
)}
onClick={() =>
selectCommandSurfaceTarget({
kind: "model",
provider: model.provider,
modelId: model.modelId,
query: selectedModelTarget?.query,
})
}
>
{/* Selection indicator */}
<div className={cn(
"flex h-4 w-4 shrink-0 items-center justify-center rounded-full border transition-colors",
selected ? "border-foreground bg-foreground" : "border-foreground/25",
)}>
{selected && <Check className="h-2.5 w-2.5 text-background" />}
</div>
{/* Model info */}
<div className="min-w-0 flex-1">
<div className="flex items-center gap-2">
<span className="text-sm font-medium text-foreground">{model.name || model.modelId}</span>
{model.isCurrent && <StatusDot status="ok" />}
</div>
<div className="mt-0.5 font-mono text-[11px] text-muted-foreground">
{model.modelId}
</div>
</div>
{/* Badges */}
<div className="flex shrink-0 items-center gap-1.5">
{model.isCurrent && (
<span className="rounded bg-foreground/10 px-1.5 py-0.5 text-[10px] font-medium text-foreground/70">Active</span>
)}
{model.reasoning && (
<span className="rounded bg-foreground/10 px-1.5 py-0.5 text-[10px] font-medium text-foreground/70">Thinking</span>
)}
</div>
</button>
)
})}
</div>
</div>
))}
</div>
) : (
<p className="py-6 text-center text-xs text-muted-foreground">No models matched.</p>
)}
{/* Apply */}
<div className="flex justify-end border-t border-border/40 pt-3">
<Button
type="button"
size="sm"
onClick={() =>
selectedModelTarget?.provider &&
selectedModelTarget?.modelId &&
void applyModelSelection(selectedModelTarget.provider, selectedModelTarget.modelId)
}
disabled={!selectedModelTarget?.provider || !selectedModelTarget.modelId || commandSurface.pendingAction === "set_model"}
data-testid="command-surface-apply-model"
className="h-8 gap-1.5"
>
{commandSurface.pendingAction === "set_model" ? (
<LoaderCircle className="h-3.5 w-3.5 animate-spin" />
) : (
<Check className="h-3.5 w-3.5" />
)}
Apply model
</Button>
</div>
</div>
)
const renderThinkingSection = () => (
<div className="space-y-4" data-testid="command-surface-thinking">
<SectionHeader
title="Thinking level"
status={
<span className="font-mono text-xs text-muted-foreground">
{workspace.boot?.bridge.sessionState?.thinkingLevel ?? "off"}
</span>
}
/>
<div className="space-y-1">
{COMMAND_SURFACE_THINKING_LEVELS.map((level) => {
const selected = selectedThinkingTarget?.level === level
const isCurrent = workspace.boot?.bridge.sessionState?.thinkingLevel === level
const description = level === "off" ? "No reasoning overhead" : level === "minimal" ? "Light reasoning" : level === "low" ? "Basic analysis" : level === "medium" ? "Balanced reasoning" : level === "high" ? "Deep analysis" : "Maximum deliberation"
return (
<button
key={level}
type="button"
className={cn(
"flex w-full items-center gap-3 rounded-lg px-3 py-2.5 text-left transition-colors",
selected ? "bg-foreground/[0.07]" : "hover:bg-foreground/[0.03]",
)}
onClick={() => selectCommandSurfaceTarget({ kind: "thinking", level })}
>
<div className={cn(
"flex h-4 w-4 shrink-0 items-center justify-center rounded-full border transition-colors",
selected ? "border-foreground bg-foreground" : "border-foreground/25",
)}>
{selected && <Check className="h-2.5 w-2.5 text-background" />}
</div>
<div className="min-w-0 flex-1">
<div className="flex items-center gap-2">
<span className="text-sm font-medium capitalize text-foreground">{level}</span>
{isCurrent && <StatusDot status="ok" />}
</div>
<span className="text-xs text-muted-foreground">{description}</span>
</div>
</button>
)
})}
</div>
<div className="flex justify-end border-t border-border/40 pt-3">
<Button
type="button"
size="sm"
onClick={() => selectedThinkingTarget && void applyThinkingLevel(selectedThinkingTarget.level)}
disabled={!selectedThinkingTarget || commandSurface.pendingAction === "set_thinking_level"}
data-testid="command-surface-apply-thinking"
className="h-8 gap-1.5"
>
{commandSurface.pendingAction === "set_thinking_level" ? (
<LoaderCircle className="h-3.5 w-3.5 animate-spin" />
) : (
<Check className="h-3.5 w-3.5" />
)}
Apply
</Button>
</div>
</div>
)
const renderQueueSection = () => (
<div className="space-y-5" data-testid="command-surface-queue-settings">
<SectionHeader title="Queue modes" />
{/* Steering mode */}
<div className="space-y-3">
<div className="flex items-center justify-between">
<div>
<div className="text-sm font-medium text-foreground">Steering mode</div>
<p className="text-xs text-muted-foreground">How steering messages queue during streaming</p>
</div>
{settingsRequests.steeringMode.pending && <LoaderCircle className="h-3.5 w-3.5 animate-spin text-muted-foreground" />}
</div>
<SegmentedControl
options={[
{ value: "all" as const, label: "Queue all" },
{ value: "one-at-a-time" as const, label: "One at a time" },
]}
value={liveSessionState?.steeringMode ?? null}
onChange={(v) => void setSteeringModeFromSurface(v)}
disabled={!liveSessionState || queueBusy}
/>
{settingsRequests.steeringMode.error && (
<p className="text-xs text-destructive">{settingsRequests.steeringMode.error}</p>
)}
</div>
<div className="border-t border-border/30" />
{/* Follow-up mode */}
<div className="space-y-3">
<div className="flex items-center justify-between">
<div>
<div className="text-sm font-medium text-foreground">Follow-up mode</div>
<p className="text-xs text-muted-foreground">How follow-up prompts sequence during a live turn</p>
</div>
{settingsRequests.followUpMode.pending && <LoaderCircle className="h-3.5 w-3.5 animate-spin text-muted-foreground" />}
</div>
<SegmentedControl
options={[
{ value: "all" as const, label: "Queue all" },
{ value: "one-at-a-time" as const, label: "One at a time" },
]}
value={liveSessionState?.followUpMode ?? null}
onChange={(v) => void setFollowUpModeFromSurface(v)}
disabled={!liveSessionState || queueBusy}
/>
{settingsRequests.followUpMode.error && (
<p className="text-xs text-destructive">{settingsRequests.followUpMode.error}</p>
)}
</div>
</div>
)
const renderCompactionSection = () => (
<div className="space-y-4" data-testid="command-surface-auto-compaction-settings">
<SectionHeader
title="Auto-compaction"
status={
liveSessionState?.isCompacting ? (
<span className="flex items-center gap-1.5 text-xs text-warning">
<LoaderCircle className="h-3 w-3 animate-spin" /> Compacting
</span>
) : null
}
/>
<ToggleRow
label="Auto-compact"
description="Automatically compact when context thresholds are crossed"
checked={liveSessionState?.autoCompactionEnabled ?? false}
onCheckedChange={(checked) => void setAutoCompactionFromSurface(checked)}
disabled={!liveSessionState || autoCompactionBusy}
busy={autoCompactionBusy}
testId="command-surface-toggle-auto-compaction"
/>
{settingsRequests.autoCompaction.error && (
<p className="text-xs text-destructive">{settingsRequests.autoCompaction.error}</p>
)}
{settingsRequests.autoCompaction.result && (
<p className="text-xs text-success">{settingsRequests.autoCompaction.result}</p>
)}
</div>
)
const renderRetrySection = () => (
<div className="space-y-4" data-testid="command-surface-retry-settings">
<SectionHeader
title="Retry"
status={
liveSessionState?.retryInProgress ? (
<span className="flex items-center gap-1.5 text-xs text-warning">
<Radio className="h-3 w-3" /> Attempt {Math.max(1, liveSessionState.retryAttempt)}
</span>
) : null
}
/>
<ToggleRow
label="Auto-retry"
description="Automatically retry on transient failures"
checked={liveSessionState?.autoRetryEnabled ?? false}
onCheckedChange={(checked) => void setAutoRetryFromSurface(checked)}
disabled={!liveSessionState || autoRetryBusy}
busy={autoRetryBusy}
testId="command-surface-toggle-auto-retry"
/>
<p className="text-xs text-muted-foreground" data-testid="command-surface-auto-retry-state">
{autoRetryBusy
? "Updating auto-retry…"
: settingsRequests.autoRetry.error
? settingsRequests.autoRetry.error
: settingsRequests.autoRetry.result
? settingsRequests.autoRetry.result
: liveSessionState?.autoRetryEnabled
? "Auto-retry enabled"
: "Auto-retry disabled"}
</p>
{liveSessionState?.retryInProgress && (
<div className="flex items-center justify-between rounded-lg border border-warning/20 bg-warning/5 px-4 py-3">
<div>
<div className="text-sm font-medium text-foreground">Retry in progress</div>
<p className="text-xs text-muted-foreground">Attempt {Math.max(1, liveSessionState.retryAttempt)} is active</p>
</div>
<Button
type="button"
variant="destructive"
size="sm"
onClick={() => void abortRetryFromSurface()}
disabled={abortRetryBusy}
data-testid="command-surface-abort-retry"
className="h-7 gap-1.5 text-xs"
>
{abortRetryBusy ? <LoaderCircle className="h-3 w-3 animate-spin" /> : <X className="h-3 w-3" />}
Abort
</Button>
</div>
)}
{settingsRequests.autoRetry.error && <p className="text-xs text-destructive">{settingsRequests.autoRetry.error}</p>}
<p className="text-xs text-muted-foreground" data-testid="command-surface-abort-retry-state">
{abortRetryBusy
? "Aborting retry…"
: settingsRequests.abortRetry.error
? settingsRequests.abortRetry.error
: settingsRequests.abortRetry.result
? settingsRequests.abortRetry.result
: liveSessionState?.retryInProgress
? "Retry can be aborted"
: "No retry in progress"}
</p>
{settingsRequests.abortRetry.error && <p className="text-xs text-destructive">{settingsRequests.abortRetry.error}</p>}
</div>
)
const renderRecoverySection = () => {
const diag = recoveryDiagnostics
return (
<div className="space-y-4" data-testid="command-surface-recovery">
<div className="text-xs text-muted-foreground" data-testid="command-surface-recovery-state">
{recoveryBusy
? "Loading recovery diagnostics…"
: recovery.error
? "Recovery diagnostics failed"
: recovery.stale
? "Recovery diagnostics stale"
: recovery.loaded
? "Recovery diagnostics loaded"
: "Recovery diagnostics idle"}
</div>
<SectionHeader
title="Recovery"
status={
diag ? (
<StatusDot status={diag.summary.tone === "healthy" ? "ok" : diag.summary.tone === "warning" ? "warning" : "error"} />
) : null
}
action={
<Button type="button" variant="ghost" size="sm" onClick={() => void loadRecoveryDiagnostics()} disabled={recoveryBusy} className="h-7 gap-1.5 text-xs">
<RefreshCw className={cn("h-3 w-3", recoveryBusy && "animate-spin")} />
Refresh
</Button>
}
/>
{recovery.error && (
<div
className="rounded-lg border border-destructive/20 bg-destructive/5 px-3 py-2.5 text-xs text-destructive"
data-testid="command-surface-recovery-error"
>
{recovery.error}
</div>
)}
{recoveryBusy && !diag && (
<>
<div className="flex items-center gap-2 py-6 text-xs text-muted-foreground">
<LoaderCircle className="h-3.5 w-3.5 animate-spin" />
Loading diagnostics
</div>
<div className="flex flex-wrap gap-2 border-t border-border/30 pt-3" data-testid="command-surface-recovery-actions">
<Button
type="button"
variant="default"
size="sm"
onClick={() => void loadRecoveryDiagnostics()}
data-testid="command-surface-recovery-action-refresh_diagnostics"
className="h-7 text-xs"
>
Refresh diagnostics
</Button>
</div>
</>
)}
{diag?.status === "unavailable" && !recovery.error && (
<>
<div className="space-y-1 rounded-lg border border-border/50 bg-card/50 px-4 py-3" data-testid="command-surface-recovery-summary">
<div className="text-sm font-medium text-foreground">{diag.summary.label}</div>
<p className="text-xs text-muted-foreground">{diag.summary.detail}</p>
</div>
<div className="flex flex-wrap gap-2 border-t border-border/30 pt-3" data-testid="command-surface-recovery-actions">
<Button
type="button"
variant="default"
size="sm"
onClick={() => void loadRecoveryDiagnostics()}
data-testid="command-surface-recovery-action-refresh_diagnostics"
className="h-7 text-xs"
>
Refresh diagnostics
</Button>
</div>
</>
)}
{diag && diag.status !== "unavailable" && (
<>
<div className="space-y-1" data-testid="command-surface-recovery-summary">
<div className="text-sm font-medium text-foreground">{diag.summary.label}</div>
<p className="text-xs text-muted-foreground">{diag.summary.detail}</p>
</div>
{/* Summary stats */}
<div className="grid grid-cols-2 gap-2">
<div className="rounded-lg border border-border/50 bg-card/50 px-3 py-2.5">
<div className="text-[10px] uppercase tracking-wider text-muted-foreground">Validation</div>
<div className="mt-1 text-lg font-semibold tabular-nums text-foreground">{diag.summary.validationCount}</div>
</div>
<div className="rounded-lg border border-border/50 bg-card/50 px-3 py-2.5">
<div className="text-[10px] uppercase tracking-wider text-muted-foreground">Doctor</div>
<div className="mt-1 text-lg font-semibold tabular-nums text-foreground">{diag.summary.doctorIssueCount}</div>
</div>
</div>
{/* Status badges */}
<div className="flex flex-wrap gap-1.5">
{diag.summary.retryInProgress && <Badge variant="default" className="text-[10px]">Retry {Math.max(1, diag.summary.retryAttempt)}</Badge>}
{diag.summary.compactionActive && <Badge variant="default" className="text-[10px]">Compacting</Badge>}
{diag.summary.lastFailurePhase && <Badge variant="destructive" className="text-[10px]">Phase {diag.summary.lastFailurePhase}</Badge>}
{recovery.stale && <Badge variant="outline" className="text-[10px]">Stale</Badge>}
</div>
{/* Last failure */}
{diag.bridge.lastFailure && (
<div
className="rounded-lg border border-destructive/20 bg-destructive/5 px-3 py-2.5"
data-testid="command-surface-recovery-last-failure"
>
<div className="text-xs font-medium text-destructive">Last failure</div>
<p className="mt-1 text-xs text-destructive/80">{diag.bridge.lastFailure.message}</p>
<div className="mt-1.5 flex gap-3 text-[10px] text-destructive/60">
<span>Phase: {diag.bridge.lastFailure.phase}</span>
<span>{formatRelativeTime(diag.bridge.lastFailure.at)}</span>
</div>
</div>
)}
{/* Validation issues */}
{diag.validation.topIssues.length > 0 && (
<div className="space-y-2">
<div className="text-xs font-medium text-muted-foreground">Validation issues</div>
{diag.validation.topIssues.map((issue) => (
<div key={`${issue.code}:${issue.file ?? issue.message}`} className="rounded-lg border border-border/50 bg-card/50 px-3 py-2">
<div className="flex items-center gap-2">
<Badge variant={issue.severity === "error" ? "destructive" : "outline"} className="text-[10px]">{issue.code}</Badge>
</div>
<p className="mt-1 text-xs text-muted-foreground">{issue.message}</p>
{issue.suggestion && <p className="mt-0.5 text-[11px] text-muted-foreground/70"> {issue.suggestion}</p>}
</div>
))}
</div>
)}
{/* Doctor issues */}
{diag.doctor.topIssues.length > 0 && (
<div className="space-y-2">
<div className="text-xs font-medium text-muted-foreground">Doctor issues</div>
{diag.doctor.topIssues.map((issue) => (
<div key={`${issue.code}:${issue.unitId ?? issue.message}`} className="rounded-lg border border-border/50 bg-card/50 px-3 py-2">
<Badge variant="outline" className="text-[10px]">{issue.code}</Badge>
<p className="mt-1 text-xs text-muted-foreground">{issue.message}</p>
</div>
))}
</div>
)}
{/* Interrupted run */}
{diag.interruptedRun.detected && (
<div className="rounded-lg border border-warning/20 bg-warning/5 px-3 py-2.5" data-testid="command-surface-recovery-interrupted-run">
<div className="text-xs font-medium text-warning">Interrupted run detected</div>
<div className="mt-1 space-y-1 text-xs text-warning/80">
<p>Available: yes</p>
<p>Detected: yes</p>
<p>{diag.interruptedRun.detail}</p>
</div>
<div className="mt-1.5 grid gap-1 text-[10px] text-warning/60">
<span>Tool calls: {diag.interruptedRun.counts.toolCalls}</span>
<span>Files written: {diag.interruptedRun.counts.filesWritten}</span>
<span>Commands: {diag.interruptedRun.counts.commandsRun}</span>
<span>Errors: {diag.interruptedRun.counts.errors}</span>
<span>Last forensic error: {diag.interruptedRun.lastError ?? "[redacted]"}</span>
</div>
</div>
)}
{/* Actions */}
<div className="flex flex-wrap gap-2 border-t border-border/30 pt-3" data-testid="command-surface-recovery-actions">
{diag.actions.browser.length > 0 ? (
diag.actions.browser.map((action) => (
<Button
key={action.id}
type="button"
variant={action.emphasis === "danger" ? "destructive" : action.emphasis === "primary" ? "default" : "outline"}
size="sm"
onClick={() => triggerRecoveryBrowserAction(action.id)}
data-testid={`command-surface-recovery-action-${action.id}`}
className="h-7 text-xs"
>
{action.label}
</Button>
))
) : (
<span className="text-xs text-muted-foreground">
{recoveryBusy ? "Loading recovery actions…" : "No browser recovery actions available."}
</span>
)}
</div>
{diag.actions.commands.length > 0 && (
<div className="space-y-2 border-t border-border/30 pt-3" data-testid="command-surface-recovery-commands">
<div className="text-xs font-medium text-muted-foreground">Suggested commands</div>
{diag.actions.commands.map((command) => (
<div key={command.command} className="rounded-lg border border-border/50 bg-card/50 px-3 py-2 text-xs">
<div className="font-mono text-foreground">{command.command}</div>
<p className="mt-1 text-muted-foreground">{command.label}</p>
</div>
))}
</div>
)}
</>
)}
</div>
)
}
const gitFileStatusColor = (status: string) => {
switch (status) {
case "M": return "text-warning bg-warning/10"
case "A": return "text-success bg-success/10"
case "D": return "text-destructive bg-destructive/10"
case "R": return "text-info bg-info/10"
case "C": return "text-info bg-info/10"
case "U": return "text-destructive bg-destructive/10"
case "?": return "text-muted-foreground bg-foreground/5"
default: return "text-muted-foreground bg-foreground/5"
}
}
const renderGitSection = () => {
const result = gitSummary.result
return (
<div className="space-y-5" data-testid="command-surface-git-summary">
<div className="text-xs text-muted-foreground" data-testid="command-surface-git-state">
{gitSummaryBusy
? "Loading git summary…"
: gitSummary.error
? "Git summary failed"
: result?.kind === "not_repo"
? "No git repository"
: result?.kind === "repo"
? `Repo ready${result.hasChanges ? " — changes detected" : " — clean"}`
: "Git summary idle"}
</div>
{gitSummaryBusy && !result && (
<div className="flex flex-col items-center justify-center gap-3 py-16">
<LoaderCircle className="h-5 w-5 animate-spin text-muted-foreground" />
<span className="text-xs text-muted-foreground">Loading repo state</span>
</div>
)}
{gitSummary.error && (
<div
className="rounded-lg border border-destructive/20 bg-destructive/5 px-4 py-3 text-xs text-destructive"
data-testid="command-surface-git-error"
>
{gitSummary.error}
</div>
)}
{!gitSummary.error && result?.kind === "not_repo" && (
<div className="flex flex-col items-center gap-3 py-16 text-center" data-testid="command-surface-git-not-repo">
<div className="flex h-10 w-10 items-center justify-center rounded-full border border-border/50 bg-card/50">
<GitBranch className="h-4.5 w-4.5 text-muted-foreground" />
</div>
<div>
<div className="text-sm font-medium text-foreground">No Git repository</div>
<p className="mt-1 text-xs text-muted-foreground">{result.message}</p>
</div>
</div>
)}
{!gitSummary.error && result?.kind === "repo" && (
<>
{/* Repo info bar */}
<div className="flex items-center gap-2 text-xs text-muted-foreground">
<span className="font-mono">{shortenPath(result.project.repoRoot, 3)}</span>
{result.project.repoRelativePath && (
<>
<ChevronRight className="h-3 w-3 text-foreground/20" />
<span className="font-mono">{result.project.repoRelativePath}</span>
</>
)}
</div>
{/* Counts row */}
<div className="grid grid-cols-4 gap-1.5" data-testid="command-surface-git-counts">
{[
{ label: "Staged", count: result.counts.staged, active: result.counts.staged > 0, color: "text-success" },
{ label: "Modified", count: result.counts.dirty, active: result.counts.dirty > 0, color: "text-warning" },
{ label: "Untracked", count: result.counts.untracked, active: result.counts.untracked > 0, color: "text-muted-foreground" },
{ label: "Conflicts", count: result.counts.conflicts, active: result.counts.conflicts > 0, color: "text-destructive" },
].map(({ label, count, active, color }) => (
<div key={label} className={cn(
"rounded-md border px-2 py-2 text-center transition-colors",
active ? "border-border/60 bg-card/80" : "border-border/30 bg-card/30",
)}>
<div className={cn(
"text-base font-semibold tabular-nums leading-none",
active ? color : "text-foreground/25",
)}>{count}</div>
<div className={cn(
"mt-1.5 text-[10px] leading-none",
active ? "text-muted-foreground" : "text-muted-foreground/50",
)}>{label}</div>
</div>
))}
</div>
{/* Changed files */}
{result.changedFiles.length > 0 && (
<div data-testid="command-surface-git-files">
<div className="mb-2 flex items-center justify-between">
<span className="text-[11px] font-medium uppercase tracking-[0.06em] text-muted-foreground/70">
Changes
</span>
<span className="text-[11px] tabular-nums text-muted-foreground/50">
{result.changedFiles.length}{result.truncatedFileCount > 0 ? `+${result.truncatedFileCount}` : ""} files
</span>
</div>
<div className="space-y-px rounded-lg border border-border/40 bg-card/30 overflow-hidden">
{result.changedFiles.map((file) => (
<div
key={`${file.status}:${file.repoPath}`}
className="group flex items-center gap-2.5 px-3 py-2 transition-colors hover:bg-foreground/[0.03]"
>
<span className={cn(
"flex h-5 w-5 shrink-0 items-center justify-center rounded text-[10px] font-semibold",
gitFileStatusColor(file.status),
)}>
{file.status}
</span>
<span className="min-w-0 flex-1 truncate font-mono text-[11px] text-foreground/80">
{file.path}
</span>
{file.conflict && (
<span className="shrink-0 rounded bg-destructive/15 px-1.5 py-0.5 text-[9px] font-semibold uppercase tracking-wider text-destructive">
conflict
</span>
)}
</div>
))}
</div>
{result.truncatedFileCount > 0 && (
<p className="mt-1.5 text-center text-[11px] text-muted-foreground/50">
+{result.truncatedFileCount} more files not shown
</p>
)}
</div>
)}
{result.changedFiles.length === 0 && (
<div className="flex flex-col items-center gap-2 py-8 text-center">
<Check className="h-4 w-4 text-success/60" />
<span className="text-xs text-muted-foreground">Working tree clean</span>
</div>
)}
</>
)}
</div>
)
}
const renderSessionBrowserSection = (mode: "resume" | "name") => {
const renameMode = mode === "name"
const selectedSessionPath = renameMode ? selectedNameTarget?.sessionPath : selectedResumeTarget?.sessionPath
return (
<div className="space-y-4" data-testid={renameMode ? "command-surface-name" : "command-surface-resume"}>
<SectionHeader
title={renameMode ? "Rename" : "Resume"}
status={
!renameMode ? (
<span className="text-xs text-muted-foreground">{currentSessionLabel ?? "pending"}</span>
) : null
}
/>
{/* Search bar */}
<div className="flex gap-2">
<div className="relative flex-1">
<Search className="absolute left-3 top-1/2 h-3.5 w-3.5 -translate-y-1/2 text-muted-foreground" />
<Input
value={sessionBrowser.query}
onChange={(e) => updateSessionBrowserState({ query: e.target.value })}
onKeyDown={(e) => { if (e.key === "Enter") { e.preventDefault(); void loadSessionBrowser() } }}
placeholder="Search sessions…"
className="h-8 pl-9 text-xs"
disabled={sessionBrowserBusy}
data-testid="command-surface-session-browser-query"
/>
</div>
<Button type="button" variant="ghost" size="sm" onClick={() => void loadSessionBrowser()} disabled={sessionBrowserBusy} className="h-8 w-8 p-0">
<RefreshCw className={cn("h-3.5 w-3.5", sessionBrowserBusy && "animate-spin")} />
</Button>
</div>
{/* Sort/filter controls */}
<div className="flex items-center gap-2">
<SegmentedControl
options={[
{ value: "threaded" as const, label: "Threaded" },
{ value: "recent" as const, label: "Recent" },
{ value: "relevance" as const, label: "Relevance" },
]}
value={sessionBrowser.sortMode}
onChange={(v) => { updateSessionBrowserState({ sortMode: v }); void loadSessionBrowser({ sortMode: v }) }}
disabled={sessionBrowserBusy}
/>
<button
type="button"
className={cn(
"rounded-md border border-border/60 px-2.5 py-1.5 text-[11px] font-medium transition-colors",
sessionBrowser.nameFilter === "named" ? "bg-foreground/10 text-foreground" : "text-muted-foreground hover:text-foreground",
)}
onClick={() => {
const next = sessionBrowser.nameFilter === "named" ? "all" : "named"
updateSessionBrowserState({ nameFilter: next })
void loadSessionBrowser({ nameFilter: next })
}}
disabled={sessionBrowserBusy}
>
Named
</button>
</div>
{sessionBrowser.error && (
<div className="rounded-lg border border-destructive/20 bg-destructive/5 px-3 py-2.5 text-xs text-destructive">{sessionBrowser.error}</div>
)}
{/* Session list */}
{sessionBrowserBusy && sessionBrowser.sessions.length === 0 ? (
<div className="flex items-center gap-2 py-6 text-xs text-muted-foreground">
<LoaderCircle className="h-3.5 w-3.5 animate-spin" />
Loading sessions
</div>
) : sessionBrowser.sessions.length > 0 ? (
<div className="space-y-1" data-testid="command-surface-session-browser-results">
{sessionBrowser.sessions.map((session) => {
const selected = session.path === selectedSessionPath
return (
<button
key={session.path}
type="button"
className={cn(
"flex w-full items-start gap-3 rounded-lg px-3 py-2.5 text-left transition-colors",
selected ? "bg-foreground/[0.07]" : "hover:bg-foreground/[0.03]",
)}
style={{ paddingLeft: `${0.75 + session.depth * 0.6}rem` }}
onClick={() =>
renameMode
? selectCommandSurfaceTarget({ kind: "name", sessionPath: session.path, name: selectedNameTarget?.sessionPath === session.path ? (selectedNameTarget?.name ?? session.name ?? "") : (session.name ?? "") })
: selectCommandSurfaceTarget({ kind: "resume", sessionPath: session.path })
}
data-testid={`command-surface-session-browser-item-${session.id}`}
>
<div className={cn(
"mt-1 flex h-4 w-4 shrink-0 items-center justify-center rounded-full border transition-colors",
selected ? "border-foreground bg-foreground" : "border-foreground/25",
)}>
{selected && <Check className="h-2.5 w-2.5 text-background" />}
</div>
<div className="min-w-0 flex-1">
<div className="flex items-center gap-2">
<span className="truncate text-sm font-medium text-foreground">
{session.name || session.firstMessage || session.id}
</span>
{session.isActive && <StatusDot status="ok" />}
</div>
{session.name && session.firstMessage && (
<p className="mt-0.5 truncate text-xs text-muted-foreground">{session.firstMessage}</p>
)}
<div className="mt-0.5 flex gap-3 text-[11px] text-muted-foreground/70">
<span>{session.messageCount} msgs</span>
<span>{formatRelativeTime(session.modifiedAt)}</span>
</div>
</div>
</button>
)
})}
</div>
) : (
<p className="py-4 text-center text-xs text-muted-foreground">No sessions matched.</p>
)}
{sessionBrowser.loaded && (
<p className="text-[11px] text-muted-foreground" data-testid="command-surface-session-browser-meta">
Current-project sessions · {sessionBrowser.returnedSessions} of {sessionBrowser.totalSessions} · {sessionBrowser.sortMode} · {sessionBrowser.nameFilter}
</p>
)}
{/* Rename controls */}
{renameMode && (
<div className="space-y-3 border-t border-border/30 pt-3">
<div className="flex gap-2">
<Input
value={selectedNameTarget?.name ?? ""}
onChange={(e) =>
selectCommandSurfaceTarget({ kind: "name", sessionPath: selectedNameTarget?.sessionPath, name: e.target.value })
}
placeholder="Session name"
className="h-8 flex-1 text-xs"
disabled={!selectedNameTarget?.sessionPath || renameBusy}
data-testid="command-surface-rename-input"
/>
<Button
type="button"
size="sm"
onClick={() => selectedNameTarget?.sessionPath && void renameSessionFromSurface(selectedNameTarget.sessionPath, selectedNameTarget.name)}
disabled={!selectedNameTarget?.sessionPath || !selectedNameTarget.name.trim() || renameBusy}
data-testid="command-surface-apply-rename"
className="h-8 gap-1.5"
>
{renameBusy ? <LoaderCircle className="h-3.5 w-3.5 animate-spin" /> : <PencilLine className="h-3.5 w-3.5" />}
Rename
</Button>
</div>
{commandSurface.renameRequest.error && <p className="text-xs text-destructive">{commandSurface.renameRequest.error}</p>}
{commandSurface.renameRequest.result && <p className="text-xs text-success">{commandSurface.renameRequest.result}</p>}
</div>
)}
{/* Resume controls */}
{!renameMode && (
<div className="flex items-center justify-between border-t border-border/30 pt-3">
<span className="text-xs text-muted-foreground" data-testid="command-surface-resume-state">
{resumeBusy ? "Switching…" : commandSurface.resumeRequest.error ?? commandSurface.resumeRequest.result ?? "Select a session"}
</span>
<Button
type="button"
size="sm"
onClick={() => selectedResumeTarget?.sessionPath && void switchSessionFromSurface(selectedResumeTarget.sessionPath)}
disabled={!selectedResumeTarget?.sessionPath || resumeBusy}
data-testid="command-surface-apply-resume"
className="h-8 gap-1.5"
>
{resumeBusy ? <LoaderCircle className="h-3.5 w-3.5 animate-spin" /> : <ArrowRightLeft className="h-3.5 w-3.5" />}
Switch
</Button>
</div>
)}
</div>
)
}
const renderForkSection = () => (
<div className="space-y-4" data-testid="command-surface-fork">
<SectionHeader
title="Fork"
action={
<Button type="button" variant="ghost" size="sm" onClick={() => void loadForkMessages()} disabled={forkBusy} className="h-7 gap-1.5 text-xs">
<RefreshCw className={cn("h-3 w-3", commandSurface.pendingAction === "load_fork_messages" && "animate-spin")} />
Refresh
</Button>
}
/>
{forkBusy && commandSurface.forkMessages.length === 0 ? (
<div className="flex items-center gap-2 py-6 text-xs text-muted-foreground">
<LoaderCircle className="h-3.5 w-3.5 animate-spin" />
Loading fork points
</div>
) : commandSurface.forkMessages.length > 0 ? (
<div className="space-y-1">
{commandSurface.forkMessages.map((message) => {
const selected = selectedForkTarget?.entryId === message.entryId
return (
<button
key={message.entryId}
type="button"
className={cn(
"flex w-full items-start gap-3 rounded-lg px-3 py-2.5 text-left transition-colors",
selected ? "bg-foreground/[0.07]" : "hover:bg-foreground/[0.03]",
)}
onClick={() => selectCommandSurfaceTarget({ kind: "fork", entryId: message.entryId })}
>
<div className={cn(
"mt-1 flex h-4 w-4 shrink-0 items-center justify-center rounded-full border transition-colors",
selected ? "border-foreground bg-foreground" : "border-foreground/25",
)}>
{selected && <Check className="h-2.5 w-2.5 text-background" />}
</div>
<div className="min-w-0 flex-1">
<div className="font-mono text-[10px] text-muted-foreground/60">{message.entryId}</div>
<p className="mt-0.5 text-sm text-foreground">{message.text}</p>
</div>
</button>
)
})}
</div>
) : (
<p className="py-4 text-center text-xs text-muted-foreground">No fork points available yet.</p>
)}
<div className="flex justify-end border-t border-border/40 pt-3">
<Button
type="button"
size="sm"
onClick={() => selectedForkTarget?.entryId && void forkSessionFromSurface(selectedForkTarget.entryId)}
disabled={!selectedForkTarget?.entryId || commandSurface.pendingAction === "fork_session"}
data-testid="command-surface-apply-fork"
className="h-8 gap-1.5"
>
{commandSurface.pendingAction === "fork_session" ? (
<LoaderCircle className="h-3.5 w-3.5 animate-spin" />
) : (
<GitBranch className="h-3.5 w-3.5" />
)}
Create fork
</Button>
</div>
</div>
)
const renderSessionSection = () => (
<div className="space-y-4" data-testid="command-surface-session">
<SectionHeader
title="Session"
status={
<span className="text-xs text-muted-foreground">{currentSessionLabel ?? "pending"}</span>
}
action={
<Button type="button" variant="ghost" size="sm" onClick={() => void loadSessionStats()} disabled={sessionBusy} className="h-7 gap-1.5 text-xs">
<RefreshCw className={cn("h-3 w-3", commandSurface.pendingAction === "load_session_stats" && "animate-spin")} />
Refresh
</Button>
}
/>
{commandSurface.sessionStats ? (
<>
{/* Token & cost grid */}
<div className="grid grid-cols-3 gap-2">
{[
{ label: "Input", value: formatTokens(commandSurface.sessionStats.tokens.input) },
{ label: "Output", value: formatTokens(commandSurface.sessionStats.tokens.output) },
{ label: "Total", value: formatTokens(commandSurface.sessionStats.tokens.total) },
].map(({ label, value }) => (
<div key={label} className="rounded-lg border border-border/50 bg-card/50 px-3 py-2.5 text-center">
<div className="text-[10px] uppercase tracking-wider text-muted-foreground">{label}</div>
<div className="mt-1 text-sm font-semibold tabular-nums text-foreground">{value}</div>
</div>
))}
</div>
{/* Message breakdown */}
<div className="divide-y divide-border/30 rounded-lg border border-border/50 bg-card/50">
<div className="px-4 py-2">
<KV label="User messages">{commandSurface.sessionStats.userMessages}</KV>
<KV label="Assistant messages">{commandSurface.sessionStats.assistantMessages}</KV>
<KV label="Tool calls">{commandSurface.sessionStats.toolCalls}</KV>
<KV label="Tool results">{commandSurface.sessionStats.toolResults}</KV>
</div>
<div className="px-4 py-2">
<KV label="Total messages">{commandSurface.sessionStats.totalMessages}</KV>
<KV label="Cost">{formatCost(commandSurface.sessionStats.cost)}</KV>
{commandSurface.sessionStats.tokens.cacheRead > 0 && (
<KV label="Cache read">{formatTokens(commandSurface.sessionStats.tokens.cacheRead)}</KV>
)}
</div>
</div>
</>
) : (
<p className="py-4 text-center text-xs text-muted-foreground">Refresh to load session stats.</p>
)}
{/* Export */}
<div className="space-y-3 border-t border-border/30 pt-3">
<div className="text-xs font-medium text-muted-foreground">Export</div>
<div className="flex gap-2">
<Input
value={selectedSessionTarget?.outputPath ?? ""}
onChange={(e) => selectCommandSurfaceTarget({ kind: "session", outputPath: e.target.value })}
placeholder="Output path (optional)"
className="h-8 flex-1 text-xs"
disabled={commandSurface.pendingAction === "export_html"}
data-testid="command-surface-export-path"
/>
<Button
type="button"
size="sm"
onClick={() => void exportSessionFromSurface(selectedSessionTarget?.outputPath)}
disabled={commandSurface.pendingAction === "export_html"}
data-testid="command-surface-export-session"
className="h-8 gap-1.5"
>
{commandSurface.pendingAction === "export_html" ? (
<LoaderCircle className="h-3.5 w-3.5 animate-spin" />
) : (
<Download className="h-3.5 w-3.5" />
)}
Export HTML
</Button>
</div>
</div>
</div>
)
const renderCompactSection = () => (
<div className="space-y-4" data-testid="command-surface-compact">
<SectionHeader
title="Manual compact"
status={
compactBusy ? (
<span className="flex items-center gap-1.5 text-xs text-warning">
<LoaderCircle className="h-3 w-3 animate-spin" /> Working
</span>
) : null
}
/>
<div className="space-y-2">
<label className="text-xs font-medium text-muted-foreground" htmlFor="command-surface-compact-instructions">
Custom instructions
</label>
<Textarea
id="command-surface-compact-instructions"
data-testid="command-surface-compact-instructions"
value={selectedCompactTarget?.customInstructions ?? ""}
onChange={(e) => selectCommandSurfaceTarget({ kind: "compact", customInstructions: e.target.value })}
placeholder="Tell compaction what to preserve or emphasize…"
rows={4}
disabled={compactBusy}
className="text-xs"
/>
</div>
<div className="flex justify-end">
<Button
type="button"
size="sm"
onClick={() => void compactSessionFromSurface(selectedCompactTarget?.customInstructions)}
disabled={compactBusy}
data-testid="command-surface-apply-compact"
className="h-8 gap-1.5"
>
{compactBusy ? <LoaderCircle className="h-3.5 w-3.5 animate-spin" /> : <Archive className="h-3.5 w-3.5" />}
Compact now
</Button>
</div>
{commandSurface.lastCompaction && (
<div className="space-y-2 rounded-lg border border-border/50 bg-card/50 px-4 py-3">
<div className="flex items-center justify-between">
<span className="text-xs font-medium text-muted-foreground">Last compaction</span>
<span className="text-[11px] tabular-nums text-muted-foreground">{formatTokens(commandSurface.lastCompaction.tokensBefore)} before</span>
</div>
<p className="whitespace-pre-wrap text-xs text-foreground">{commandSurface.lastCompaction.summary}</p>
<p className="text-[11px] text-muted-foreground">First kept: {commandSurface.lastCompaction.firstKeptEntryId}</p>
</div>
)}
</div>
)
const renderAuthSection = () => {
if (!onboarding) return null
return (
<div className="space-y-4" data-testid="command-surface-auth">
<SectionHeader
title="Auth"
status={
<span className="text-xs text-muted-foreground">
{selectedAuthIntent === "login" ? "Login" : selectedAuthIntent === "logout" ? "Logout" : "Manage"}
</span>
}
/>
{/* Provider list */}
<div className="space-y-1">
{onboarding.required.providers.map((provider) => {
const selected = provider.id === selectedAuthProvider?.id
return (
<button
key={provider.id}
type="button"
className={cn(
"flex w-full items-center gap-3 rounded-lg px-3 py-2.5 text-left transition-colors",
selected ? "bg-foreground/[0.07]" : "hover:bg-foreground/[0.03]",
)}
onClick={() =>
selectCommandSurfaceTarget({ kind: "auth", providerId: provider.id, intent: selectedAuthIntent })
}
>
<div className={cn(
"flex h-4 w-4 shrink-0 items-center justify-center rounded-full border transition-colors",
selected ? "border-foreground bg-foreground" : "border-foreground/25",
)}>
{selected && <Check className="h-2.5 w-2.5 text-background" />}
</div>
<div className="min-w-0 flex-1">
<div className="flex items-center gap-2">
<span className="text-sm font-medium text-foreground">{provider.label}</span>
{provider.configured && <StatusDot status="ok" />}
</div>
<span className="text-xs text-muted-foreground">
{provider.configured ? `via ${provider.configuredVia}` : "Not configured"}
</span>
</div>
{provider.recommended && (
<span className="rounded bg-foreground/10 px-1.5 py-0.5 text-[10px] font-medium text-foreground/70">Recommended</span>
)}
</button>
)
})}
</div>
{/* Selected provider details */}
{selectedAuthProvider && (
<div className="space-y-4 border-t border-border/30 pt-3">
<div className="flex items-center justify-between">
<div>
<div className="text-sm font-medium text-foreground">{selectedAuthProvider.label}</div>
<span className="text-xs text-muted-foreground">{selectedAuthProvider.configuredVia ?? "Not configured"}</span>
</div>
</div>
{/* API key form */}
{selectedAuthProvider.supports.apiKey && (
<form
className="space-y-3"
onSubmit={(e) => {
e.preventDefault()
if (!selectedProviderApiKey.trim()) return
void saveApiKeyFromSurface(selectedAuthProvider.id, selectedProviderApiKey)
}}
>
<div className="flex gap-2">
<Input
type="password"
autoComplete="off"
value={selectedProviderApiKey}
onChange={(e) =>
setApiKeys((prev) => ({ ...prev, [selectedAuthProvider.id]: e.target.value }))
}
placeholder="Paste API key"
className="h-8 flex-1 text-xs"
disabled={authBusy}
data-testid="command-surface-api-key-input"
/>
<Button
type="submit"
size="sm"
disabled={!selectedProviderApiKey.trim() || authBusy}
data-testid="command-surface-save-api-key"
className="h-8 gap-1.5"
>
{commandSurface.pendingAction === "save_api_key" ? (
<LoaderCircle className="h-3.5 w-3.5 animate-spin" />
) : (
<KeyRound className="h-3.5 w-3.5" />
)}
Save
</Button>
</div>
</form>
)}
{/* OAuth / sign-in buttons */}
<div className="flex flex-wrap gap-2">
{selectedAuthProvider.supports.oauth && selectedAuthProvider.supports.oauthAvailable && (
<Button
type="button"
variant="outline"
size="sm"
disabled={authBusy}
onClick={() => void startProviderFlowFromSurface(selectedAuthProvider.id)}
data-testid="command-surface-start-provider-flow"
className="h-8 gap-1.5 text-xs"
>
{commandSurface.pendingAction === "start_provider_flow" ? (
<LoaderCircle className="h-3.5 w-3.5 animate-spin" />
) : (
<LogIn className="h-3.5 w-3.5" />
)}
Browser sign-in
</Button>
)}
<Button
type="button"
variant="ghost"
size="sm"
disabled={authBusy}
onClick={() => void logoutProviderFromSurface(selectedAuthProvider.id)}
data-testid="command-surface-logout-provider"
className="h-8 gap-1.5 text-xs text-destructive hover:text-destructive"
>
{commandSurface.pendingAction === "logout_provider" ? (
<LoaderCircle className="h-3.5 w-3.5 animate-spin" />
) : (
<LogOut className="h-3.5 w-3.5" />
)}
Logout
</Button>
</div>
{/* Active OAuth flow */}
{activeFlow && activeFlow.providerId === selectedAuthProvider.id && (
<div className="space-y-3 rounded-lg border border-foreground/10 bg-foreground/[0.03] px-4 py-3" data-testid="command-surface-active-flow">
<div className="flex items-center gap-2 text-xs">
<Badge variant="outline" className="text-[10px]">{activeFlow.status.replaceAll("_", " ")}</Badge>
<span className="text-muted-foreground">{new Date(activeFlow.updatedAt).toLocaleTimeString()}</span>
</div>
{activeFlow.auth?.instructions && (
<p className="text-xs text-muted-foreground">{activeFlow.auth.instructions}</p>
)}
{activeFlow.auth?.url && (
<Button asChild variant="outline" size="sm" className="h-7 gap-1.5 text-xs" data-testid="command-surface-open-auth-url">
<a href={activeFlow.auth.url} target="_blank" rel="noreferrer">
<ExternalLink className="h-3 w-3" />
Open sign-in page
</a>
</Button>
)}
{activeFlow.progress.length > 0 && (
<div className="space-y-1">
{activeFlow.progress.map((message, index) => (
<div key={`${activeFlow.flowId}-${index}`} className="rounded-md border border-border/40 bg-card/30 px-2.5 py-1.5 text-xs text-muted-foreground">
{message}
</div>
))}
</div>
)}
{activeFlow.prompt && (
<form
className="space-y-2"
onSubmit={(e) => {
e.preventDefault()
if (!activeFlow.prompt?.allowEmpty && !flowInput.trim()) return
void submitProviderFlowInputFromSurface(activeFlow.flowId, flowInput)
}}
>
<Input
value={flowInput}
onChange={(e) => setFlowInput(e.target.value)}
placeholder={activeFlow.prompt.placeholder || "Enter value"}
className="h-8 text-xs"
disabled={authBusy}
data-testid="command-surface-flow-input"
/>
<p className="text-[11px] text-muted-foreground">{activeFlow.prompt.message}</p>
<div className="flex gap-2">
<Button type="submit" size="sm" disabled={authBusy || (!activeFlow.prompt.allowEmpty && !flowInput.trim())} className="h-7 gap-1.5 text-xs">
{commandSurface.pendingAction === "submit_provider_flow_input" ? (
<LoaderCircle className="h-3 w-3 animate-spin" />
) : (
<ShieldCheck className="h-3 w-3" />
)}
Continue
</Button>
<Button type="button" variant="ghost" size="sm" disabled={authBusy} onClick={() => void cancelProviderFlowFromSurface(activeFlow.flowId)} className="h-7 text-xs">
Cancel
</Button>
</div>
</form>
)}
</div>
)}
{/* Bridge auth refresh status */}
{onboarding.bridgeAuthRefresh.phase !== "idle" && (
<div className="rounded-lg border border-border/50 bg-card/50 px-3 py-2.5 text-xs">
<span className="font-medium text-foreground">Auth refresh</span>
<span className="ml-2 text-muted-foreground">
{onboarding.bridgeAuthRefresh.phase === "pending"
? "Refreshing…"
: onboarding.bridgeAuthRefresh.phase === "failed"
? onboarding.bridgeAuthRefresh.error || "Failed."
: "Complete."}
</span>
</div>
)}
</div>
)}
</div>
)
}
// ═══════════════════════════════════════════════════════════════════
// SECTION DISPATCH
// ═══════════════════════════════════════════════════════════════════
const renderAdminSection = () => (
<div className="space-y-5" data-testid="command-surface-admin">
<SectionHeader
title="Admin"
status={
<Badge variant="outline" className="border-warning/20 bg-warning/[0.06] text-[10px] text-warning">
Dev only
</Badge>
}
/>
{/* Master toggle */}
<ToggleRow
label="UI overrides"
description="Enable keyboard shortcuts and forced UI states for development"
checked={devOverrides.enabled}
onCheckedChange={devOverrides.setEnabled}
testId="admin-ui-overrides-master"
/>
{/* Individual overrides — only visible when master is on */}
{devOverrides.enabled && (
<div className="space-y-2 rounded-lg border border-border/50 bg-card/30 p-3">
<div className="text-[11px] font-semibold uppercase tracking-wider text-muted-foreground">
Override shortcuts
</div>
{DEV_OVERRIDE_REGISTRY.map((entry) => (
<div
key={entry.key}
className="flex items-start justify-between gap-3 rounded-md px-3 py-2.5 transition-colors hover:bg-foreground/[0.03]"
>
<div className="min-w-0 flex-1">
<div className="flex items-center gap-2">
<span className="text-sm font-medium text-foreground">{entry.label}</span>
<Badge variant="outline" className="border-border/60 font-mono text-[10px] text-muted-foreground">
{entry.shortcutLabel}
</Badge>
</div>
<p className="mt-0.5 text-xs text-muted-foreground">{entry.description}</p>
</div>
<Switch
checked={devOverrides.overrides[entry.key]}
onCheckedChange={() => devOverrides.toggle(entry.key)}
data-testid={`admin-override-${entry.key}`}
/>
</div>
))}
</div>
)}
{/* Onboarding — one-click launch */}
<div className="rounded-lg border border-border/50 bg-card/30 p-3 space-y-3">
<div className="text-[11px] font-semibold uppercase tracking-wider text-muted-foreground">
Onboarding
</div>
<div className="flex items-center justify-between gap-3 px-3 py-2.5">
<div className="min-w-0 flex-1">
<div className="text-sm font-medium text-foreground">Run setup wizard</div>
<p className="mt-0.5 text-xs text-muted-foreground">
Opens the full onboarding flow as a new user would see it.
</p>
</div>
<Button
type="button"
size="sm"
className="h-8 shrink-0 gap-1.5 text-xs"
onClick={() => {
closeCommandSurface()
// Small delay so the sheet closes before the gate renders
window.setTimeout(() => {
if (!devOverrides.enabled) devOverrides.setEnabled(true)
if (!devOverrides.overrides.forceOnboarding) devOverrides.toggle("forceOnboarding")
}, 150)
}}
data-testid="admin-trigger-onboarding"
>
Launch
</Button>
</div>
</div>
<div className="rounded-lg border border-border/40 bg-card/30 px-3 py-2.5 text-xs text-muted-foreground">
This tab is only visible when running via{" "}
<code className="rounded bg-muted px-1 py-0.5 font-mono text-[11px]">npm run gsd:web</code>.
Overrides reset on page refresh.
</div>
</div>
)
const renderSection = () => {
switch (commandSurface.section) {
case "general": return <GeneralPanel />
case "model": return (
<div className="space-y-8">
{renderModelSection()}
<div className="border-t border-border/30 pt-6">
{renderThinkingSection()}
</div>
</div>
)
case "thinking": return (
<div className="space-y-8">
{renderModelSection()}
<div className="border-t border-border/30 pt-6">
{renderThinkingSection()}
</div>
</div>
)
case "session-behavior": return (
<div className="space-y-6">
{renderQueueSection()}
<div className="border-t border-border/30 pt-4">
{renderCompactionSection()}
</div>
<div className="border-t border-border/30 pt-4">
{renderRetrySection()}
</div>
</div>
)
// Legacy section routes — redirect to merged panels
case "queue": return (
<div className="space-y-6">
{renderQueueSection()}
<div className="border-t border-border/30 pt-4">
{renderCompactionSection()}
</div>
<div className="border-t border-border/30 pt-4">
{renderRetrySection()}
</div>
</div>
)
case "compaction": return (
<div className="space-y-6">
{renderQueueSection()}
<div className="border-t border-border/30 pt-4">
{renderCompactionSection()}
</div>
<div className="border-t border-border/30 pt-4">
{renderRetrySection()}
</div>
</div>
)
case "retry": return (
<div className="space-y-6">
{renderQueueSection()}
<div className="border-t border-border/30 pt-4">
{renderCompactionSection()}
</div>
<div className="border-t border-border/30 pt-4">
{renderRetrySection()}
</div>
</div>
)
case "recovery": return renderRecoverySection()
case "auth": return renderAuthSection()
case "admin": return renderAdminSection()
case "git": return renderGitSection()
case "resume": return renderSessionBrowserSection("resume")
case "name": return renderSessionBrowserSection("name")
case "fork": return renderForkSection()
case "session": return renderSessionSection()
case "compact": return renderCompactSection()
case "workspace": return <DevRootSettingsSection />
case "integrations": return <RemoteQuestionsPanel />
case "gsd-forensics": return <ForensicsPanel />
case "gsd-doctor": return <DoctorPanel />
case "gsd-skill-health": return <SkillHealthPanel />
case "gsd-knowledge": return <KnowledgeCapturesPanel initialTab="knowledge" />
case "gsd-capture": return <KnowledgeCapturesPanel initialTab="captures" />
case "gsd-triage": return <KnowledgeCapturesPanel initialTab="captures" />
case "gsd-prefs": return (
<div className="space-y-6">
<DevRootSettingsSection />
<PrefsPanel />
<ModelRoutingPanel />
<BudgetPanel />
<RemoteQuestionsPanel />
<GeneralPanel />
</div>
)
case "gsd-mode": return <ModelRoutingPanel />
case "gsd-config": return <BudgetPanel />
case "gsd-quick": return <QuickPanel />
case "gsd-history": return <HistoryPanel />
case "gsd-undo": return <UndoPanel />
case "gsd-steer": return <SteerPanel />
case "gsd-hooks": return <HooksPanel />
case "gsd-inspect": return <InspectPanel />
case "gsd-export": return <ExportPanel />
case "gsd-cleanup": return <CleanupPanel />
case "gsd-queue": return <QueuePanel />
case "gsd-status": return <StatusPanel />
default:
// Safety net for any unknown GSD surface
if (commandSurface.section?.startsWith("gsd-")) {
return (
<div className="p-4 text-sm text-muted-foreground" data-testid={`gsd-surface-${commandSurface.section}`}>
<p className="font-medium text-foreground">/gsd {commandSurface.section.slice(4)}</p>
<p className="mt-1">Unknown GSD surface.</p>
</div>
)
}
return null
}
}
// ═══════════════════════════════════════════════════════════════════
// RENDER
// ═══════════════════════════════════════════════════════════════════
const isSingleSection = surfaceSections.length <= 1
const isGitSurface = commandSurface.activeSurface === "git"
const gitResult = gitSummary.result
const renderGitHeader = () => {
const branchName = gitResult?.kind === "repo" ? (gitResult.branch ?? "detached") : null
const mainBranch = gitResult?.kind === "repo" ? gitResult.mainBranch : null
const hasChanges = gitResult?.kind === "repo" ? gitResult.hasChanges : false
const isClean = gitResult?.kind === "repo" && !hasChanges
return (
<div className="border-b border-border/40 px-5 py-4">
<div className="flex items-start justify-between gap-3">
<div className="flex items-center gap-3">
<div className={cn(
"flex h-8 w-8 items-center justify-center rounded-lg",
isClean ? "bg-success/10" : hasChanges ? "bg-warning/10" : "bg-card/50",
)}>
<GitBranch className={cn(
"h-4 w-4",
isClean ? "text-success" : hasChanges ? "text-warning" : "text-muted-foreground",
)} />
</div>
<div>
<div className="flex items-center gap-2">
<h2 className="text-sm font-semibold text-foreground" data-testid="command-surface-title">
{branchName ?? "Git"}
</h2>
{branchName && mainBranch && branchName !== mainBranch && (
<span className="text-[11px] text-muted-foreground/50">from {mainBranch}</span>
)}
</div>
{gitResult?.kind === "repo" && (
<div className="mt-0.5 flex items-center gap-1.5">
<StatusDot status={isClean ? "ok" : hasChanges ? "warning" : "idle"} />
<span className="text-[11px] text-muted-foreground">
{isClean ? "Clean" : hasChanges ? "Changes detected" : "Loading…"}
</span>
</div>
)}
</div>
</div>
<div className="flex items-center gap-1">
<Button
type="button"
variant="ghost"
size="icon"
onClick={() => void loadGitSummary()}
disabled={gitSummaryBusy}
aria-label="Refresh"
className="h-7 w-7"
>
<RefreshCw className={cn("h-3.5 w-3.5", gitSummaryBusy && "animate-spin")} />
</Button>
<Button
type="button"
variant="ghost"
size="icon"
onClick={closeCommandSurface}
aria-label="Close"
className="h-7 w-7"
>
<X className="h-3.5 w-3.5" />
</Button>
</div>
</div>
</div>
)
}
const renderDefaultHeader = () => (
<div className="flex items-center justify-between gap-3 border-b border-border/40 px-5 py-4">
<div>
<div className="text-xs uppercase tracking-wider text-muted-foreground">Command surface</div>
<div className="text-lg font-semibold text-foreground" data-testid="command-surface-title">
{surfaceTitle(commandSurface.activeSurface)}
</div>
</div>
<div className="flex items-center gap-2">
<div className="rounded-full border border-border bg-card px-2.5 py-1 text-xs font-medium text-muted-foreground" data-testid="command-surface-kind">
{surfaceKindLabel}
</div>
<Button
type="button"
variant="ghost"
size="icon"
onClick={closeCommandSurface}
aria-label="Close"
className="h-8 w-8"
>
<X className="h-4 w-4" />
</Button>
</div>
</div>
)
return (
<Sheet open={commandSurface.open} onOpenChange={(open) => !open && closeCommandSurface()}>
<SheetContent side="right" className="flex h-full w-full flex-col p-0 sm:max-w-[540px]" data-testid="command-surface">
{/* Visually hidden accessible title */}
<SheetHeader className="sr-only">
<SheetTitle>{surfaceTitle(commandSurface.activeSurface)}</SheetTitle>
<SheetDescription>Settings and controls</SheetDescription>
</SheetHeader>
<div className="flex h-full min-h-0">
{/* ─── Left nav rail (hidden for single-section surfaces) ─── */}
{!isSingleSection && (
<nav className="flex w-12 shrink-0 flex-col items-center gap-0.5 border-r border-border/40 bg-card/30 py-3" data-testid="command-surface-sections">
{surfaceSections.map((section) => {
const active = commandSurface.section === section
return (
<Tooltip key={section}>
<TooltipTrigger asChild>
<button
type="button"
className={cn(
"flex h-9 w-9 items-center justify-center rounded-lg transition-colors",
active
? "bg-foreground/10 text-foreground"
: "text-muted-foreground hover:bg-foreground/[0.04] hover:text-foreground",
)}
onClick={() => setCommandSurfaceSection(section)}
data-testid={`command-surface-section-${section}`}
>
{sectionIcon(section)}
</button>
</TooltipTrigger>
<TooltipContent side="right" sideOffset={6}>
{sectionLabel(section)}
</TooltipContent>
</Tooltip>
)
})}
</nav>
)}
{/* ─── Right content area ────────────────────────────────── */}
<div className="flex min-h-0 min-w-0 flex-1 flex-col">
{isGitSurface ? renderGitHeader() : renderDefaultHeader()}
{(commandSurface.lastResult || commandSurface.lastError) && (
<div
className={cn(
"border-b border-border/30 px-5 py-3 text-xs",
commandSurface.lastError ? "bg-destructive/5 text-destructive" : "bg-success/5 text-success",
)}
data-testid="command-surface-result"
>
{commandSurface.lastError ?? commandSurface.lastResult}
</div>
)}
<ScrollArea className="min-h-0 flex-1" viewportRef={commandSurfaceViewportRef}>
<div className="px-5 py-5">
{renderSection()}
</div>
</ScrollArea>
</div>
</div>
</SheetContent>
</Sheet>
)
}