nntrivi2001
a6bd33bcff
Workspace sessions (docs/plans/desktop-parity, phases 1-5 and 7): - sessions.lane_id: a workspace lists only the sessions its panes held, stamped by bindRunSession (first writer wins, nested `claude -p` excluded); GET /api/sessions?lane=&archived= - session row state dot, double-click rename, archive (sessions.archived_at, hides only); the activity bar's duplicate Sessions tab removed - Fork beside Resume (--fork-session, Claude only), Ctrl/Cmd+click a live session opens it in a second pane, a diff line's comment is pasted into the workspace's last-focused pane (lib/panePaste.ts) dashboard_runs stability: - a pane's previous run is archived as <pane>@<started_at> instead of being overwritten by INSERT OR REPLACE - a run is flagged abandoned only once its tmux session is gone, at boot and on the run-heal beat (panes outlive a server restart) UI: - sidebar: no footer, language or theme block; small collapse button in the brand corner; version + update check in the connection details modal, a status-bar dot while a release is out; language in Settings -> General - one Switch component for every switch, the themed Checkbox for every checkbox (no native checkboxes) Also: AI Tools catalog trimmed to 10 built-ins (custom-file prompt modes tested through fixtures), and the workspace plans under docs/plans/ (the multi-user server plan lives in the AgentHub-Server repo).
81 lines
5.7 KiB
Markdown
81 lines
5.7 KiB
Markdown
# Workspace redesign — overview and phase plan
|
|
|
|
_Status: specs written 2026-10-01, nothing implemented yet. Each phase is one PR, executed in order; a later phase assumes the earlier ones are merged._
|
|
|
|
## Why
|
|
|
|
AgentHub's lane surface grew one card at a time: a horizontal lane strip on
|
|
`/workspace`, a detail header below it, a Changes panel beside that, and a
|
|
Settings page made of horizontal tabs. Orca (https://github.com/stablyai/orca,
|
|
MIT, source cloned at `/tmp/orca-repo` while these specs were written) solved
|
|
the same problem — many agent worktrees on one screen — with a left-hand
|
|
**project → workspace** tree, a terminal workbench in the middle, an
|
|
activity-bar panel on the right and a full-page grouped Settings screen.
|
|
|
|
We are **borrowing Orca's information architecture, not its look**. The
|
|
decisions below are fixed for every phase:
|
|
|
|
| Decision | Value |
|
|
| --- | --- |
|
|
| Visual theme | **Unchanged.** Keep AgentHub's tokens, dark Radix slate + blue accent, warm light theme, the named themes, Inter + JetBrains Mono. Orca's neutral palette is added only as two more *named* themes in phase 3. |
|
|
| Terminology | **Only the word changes**: "lane" → "workspace" in UI copy (en + vi), docs prose, CLI output prose (phase 0). Every identifier stays — `/api/lanes`, `agenthub lanes`, `--lane`, `AGENTHUB_LANE_ID`, DB tables, tmux names, component/file/type names, i18n keys, test ids. |
|
|
| Grouping | Sidebar lists **Projects** (one per git repo = the main worktree's root), each expanded into its **workspaces** (one per lane) and the repo's **untracked worktrees** (from `git worktree list`), the latter shown by default with a user setting to hide them. |
|
|
| Existing pages | Dashboard, Sessions, Workflows all stay as top-level nav items. Nothing is removed. |
|
|
| Split panes | The existing 1 / 2 / 4 pane layout (`splitViewStorage.ts`) stays and gains a tab-style header per pane. |
|
|
| Changes panel | Keeps its Narrow / Medium / Full-screen sizes; gains an activity bar (Files · Changes · Sessions). |
|
|
| Status bar | A new one-line bar at the bottom of the shell: connection, running / needs-you counts, today's cost, update chip. **No provider quota** — reading Claude quota rotates the stored OAuth token (`cc-usage.js`), and the CLI shows it inside the pane anyway. |
|
|
| Per-project settings | Phase 2. |
|
|
| Notification sounds | Phase 3. |
|
|
| Fonts | Unchanged: UI Inter (`client/tailwind.config.js`), terminal JetBrains Mono 13px (`TerminalView.tsx`). The `claude` CLI has no font of its own — it renders in whatever font the hosting terminal uses. |
|
|
|
|
## Phases
|
|
|
|
| # | Spec | Scope | Size |
|
|
| --- | --- | --- | --- |
|
|
| 0 | [00-rename-lane-to-workspace.md](00-rename-lane-to-workspace.md) | Copy-only rename: i18n values, escaped UI literals, CLI prose, docs. No identifier changes. | small, mechanical |
|
|
| 1 | [01-sidebar-and-workbench.md](01-sidebar-and-workbench.md) | Project tree in the sidebar, lane strip removed, workspace cards with status dot + context menu, untracked worktrees, pane tab headers, right-panel activity bar with a Sessions tab, status bar. | large |
|
|
| 2 | [02-settings.md](02-settings.md) | Settings as a full-page grouped nav with search, `/settings/:section` routes, row primitives, per-project pane, worktree-visibility setting moved here. | medium |
|
|
| 3 | [03-appearance-and-sounds.md](03-appearance-and-sounds.md) | Two Orca-derived named themes, notification sounds per category. | small |
|
|
|
|
Phase 1 may start before phase 0 is merged; its new UI strings must already
|
|
say "workspace". New code keeps using the existing `Lane*` identifiers,
|
|
`api.lanes` and `/api/lanes` — only new *user-facing* text uses the new word.
|
|
|
|
## Ground rules for every phase
|
|
|
|
- Follow the repo's `CLAUDE.md` rules verbatim. Three bind these specs hardest:
|
|
the console has **exactly one render site** and collapses with CSS; the
|
|
console never writes a lane's stage; lane git facts come from
|
|
`GET …/:id/git`, never from the list endpoint.
|
|
- Every new or edited `.ts/.tsx/.js/.css` file starts with the header from
|
|
`skills/file-headers/` (`bash skills/file-headers/scripts/check-headers.sh`
|
|
must exit 0).
|
|
- Backend changes: `npm run test:server` (private tmux server — never run the
|
|
suites bare). Frontend: `npm run test:client`; snapshot baselines in
|
|
`client/src/pages/__tests__/screens.snapshot.test.tsx` are regenerated with
|
|
`cd client && npx vitest run -u` **only after** the diff was reviewed as the
|
|
intended change, and the PR says which screens changed.
|
|
- Docs are part of the change-set: `CLAUDE.md` (its sync marker and any
|
|
statement made wrong), `docs/API.md`, `docs/CLI.md`, `docs/LANES.md`
|
|
(file name kept; prose says "workspace"), `client/README.md`, `README.md`. Apply the
|
|
`update-project-docs` skill before finishing.
|
|
- i18n: every new string goes into **both** `client/src/i18n/locales/en/*.json`
|
|
and `…/vi/*.json` (see `docs/I18N.md`); no hardcoded UI text.
|
|
- No new runtime dependency unless the spec names it. The specs name none.
|
|
- Keep response shapes backward compatible; add fields, never rename or drop
|
|
one in the same release as its consumer.
|
|
- Each PR ends with a before/after screenshot of every changed screen in the
|
|
PR body (the Orca reference screenshots used for these specs live in
|
|
`docs/plans/workspace-redesign/reference/`).
|
|
|
|
## Verification matrix (all phases)
|
|
|
|
| Check | Command |
|
|
| --- | --- |
|
|
| Server suite | `npm run test:server` |
|
|
| Client suite | `npm run test:client` |
|
|
| Type check | `cd client && npx tsc --noEmit` |
|
|
| Headers | `bash skills/file-headers/scripts/check-headers.sh` |
|
|
| Build | `npm run build` |
|
|
| Manual | `npm run dev`, open `/workspace`, `/settings`, create a workspace from the sidebar, start a run, resume a session from the Sessions tab, switch theme Dark/Light/System on every changed screen |
|