From ede1a5fc50730362dae0d91718e358bd5650cefc Mon Sep 17 00:00:00 2001 From: nesquena-hermes Date: Sun, 12 Apr 2026 11:55:40 -0700 Subject: [PATCH] feat: composer-centric UI refresh + Hermes Control Center (v0.50.0, closes #242) MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit * Polish workspace panel behavior and app dialogs * Replace remaining emoji UI glyphs with Lucide icons * Redesign composer footer around model and context controls Move the model selector into the composer footer, replace the linear context pill with a compact circular badge plus tooltip, and remove the redundant topbar model pill. Design credit and inspiration: Theo / T3 Code. Reference implementation: https://github.com/pingdotgg/t3code/ * Remove obsolete activity bar Drop the old activity bar, keep turn-scoped state in the composer footer, and route remaining non-chat status messages through toasts. This leaves live tool cards and the message timeline as the primary progress UI, with the composer owning stop/cancel and brief turn status. * Move workspace and model switching into composer footer * Move profile switching into composer footer * Refactor Hermes control center UI * Redesign control center settings modal layout Widen the modal to 860px, simplify the tab list to icon+label rows, stretch the tab column's divider to full height, lock the panel to a fixed height so switching tabs no longer resizes the outer shell, and always open on the Conversation tab. Co-Authored-By: Claude Opus 4.6 (1M context) * Put session item actions in a dropdown * Use Hermes mark in sidebar control button * Reset control center section on close * Drop session-item left border indicator Remove the left-border accent used for active, CLI, and project rows — each state already has a dedicated cue (gold fill, cli badge, project dot), so the border was redundant. Fully round the row, add 2px bottom spacing between rows, and strip the matching JS/CSS overrides. Co-Authored-By: Claude Opus 4.6 (1M context) * Increase session search input vertical padding Co-Authored-By: Claude Opus 4.6 (1M context) * Normalise odd pixel values across UI Snap padding, gap, and border-radius values to the 2/4/6/8/10/12 grid across composer chips, sidebar panels, cron list, settings, approval buttons, dropdowns, and inline message edit — eliminating the 7/9/11px drift that was making sibling elements feel subtly misaligned. Co-Authored-By: Claude Opus 4.6 (1M context) * Add missing #btnMobileFiles button and .mobile-files-btn CSS (for mobile QA suite) The mobile layout regression suite (test_mobile_layout.py) requires: - #btnMobileFiles onclick=toggleMobileFiles() in topbar chips - .mobile-files-btn CSS rules for responsive show/hide at 640/900px breakpoints Also adds max-width guard to .profile-dropdown to prevent clipping at narrow viewports. * Improve composer footer mobile responsiveness and UX - Collapse composer chips to icon-only at <=400px viewports - Add model chip icon (CPU) so it remains tappable when labels are hidden - Show send button always (disabled state when empty, hidden during streaming) - Show context usage indicator on session load, not just after streaming - Add cancel status fallback timeout to prevent stale "Cancelling..." text - Update tests to match new send button and busy state behavior * Fix duplicate files button and broken workspace close on mobile Remove redundant #btnMobileFiles button that duplicated #btnWorkspacePanelToggle in the mobile topbar. Fix workspace panel close button calling undefined closeMobileFiles() — now calls closeWorkspacePanel(). Co-Authored-By: Claude Opus 4.6 (1M context) * Fix model chip icon vertical alignment in composer footer Co-Authored-By: Claude Opus 4.6 (1M context) * Fix workspace toggle button hidden on desktop by conflicting CSS class Remove mobile-files-btn class from #btnWorkspacePanelToggle — its display:none!important rule was overriding workspace-toggle-btn visibility on non-mobile viewports. Co-Authored-By: Claude Opus 4.6 (1M context) * Fix session actions dots button inaccessible on mobile sidebar Always show the session actions trigger on mobile (no hover state on touch devices) and restore right padding so text truncates with ellipsis before the dots icon. Co-Authored-By: Claude Opus 4.6 (1M context) * Fix composer footer manage links not opening sidebar panel The "Manage profiles" and "Manage workspaces" links in the composer footer dropdowns called switchPanel() which only changes the active panel content but doesn't open the sidebar. Replaced with mobileSwitchPanel() which also opens the sidebar so the panel is actually visible. Co-Authored-By: Claude Opus 4.6 (1M context) * Widen icon-only composer chips breakpoint from 400px to 768px Move the icon-only chip styling up into the existing max-width:768px media query so chips collapse to icon-only on tablets too, preventing composer footer overflow on mid-size screens. Co-Authored-By: Claude Opus 4.6 (1M context) * Fix composer-left vertical scrollbar by setting overflow-y:hidden When overflow-x is set to auto, the CSS spec implicitly changes overflow-y from visible to auto, allowing a vertical scrollbar to appear from slight chip padding/border overflow. Explicitly set overflow-y:hidden to prevent this. Co-Authored-By: Claude Opus 4.6 (1M context) * fix: resolve rebase conflicts and fix control center test assertions - Resolved 4 conflicts during rebase onto master (workspace.js, boot.js, index.html, test_sprint34.py) - Fixed test_sprint34.py: _controlSection -> _settingsSection, cc-tab -> settings-tabs (matching actual implementation) - Fixed quoting syntax error in test assertion Co-Authored-By: Claude Opus 4.6 (1M context) * fix: update version badge in System tab to v0.49.4 * docs: update README and CHANGELOG for v0.50.0 UI refresh, bump version badge --------- Co-authored-by: Aron Prins Co-authored-by: Claude Opus 4.6 (1M context) Co-authored-by: Nathan Esquenazi --- ARCHITECTURE.md | 44 +++- CHANGELOG.md | 25 ++- README.md | 33 +-- ROADMAP.md | 15 +- SPRINTS.md | 4 +- TESTING.md | 113 ++++++---- static/boot.js | 172 +++++++++++---- static/commands.js | 9 +- static/i18n.js | 24 +++ static/icons.js | 8 + static/index.html | 403 ++++++++++++++++++++++-------------- static/messages.js | 29 ++- static/panels.js | 301 +++++++++++++++++++++------ static/sessions.js | 166 ++++++++------- static/style.css | 228 ++++++++++++++------ static/ui.js | 270 +++++++++++++++++------- tests/conftest.py | 2 +- tests/test_mobile_layout.py | 18 +- tests/test_regressions.py | 24 +-- tests/test_sprint16.py | 18 +- tests/test_sprint20b.py | 20 +- tests/test_sprint34.py | 16 ++ tests/test_sprint6.py | 1 + 23 files changed, 1333 insertions(+), 610 deletions(-) diff --git a/ARCHITECTURE.md b/ARCHITECTURE.md index d51bb1f..bc99374 100644 --- a/ARCHITECTURE.md +++ b/ARCHITECTURE.md @@ -13,14 +13,21 @@ The Hermes Web UI is a lightweight web application that gives you a browser-based interface to the Hermes agent that is functionally equivalent to the CLI. It is modeled on -the Claude-style interface: a three-panel layout with a sidebar for session management, -a central chat area, and a right panel for workspace file browsing. +the Claude-style interface: a sidebar for session management, a central chat area, +and a demand-driven right panel used for workspace browsing and preview surfaces. +The right panel is closed by default on desktop and opens only when it is actively +being used for browsing or previewing content. The design philosophy is deliberately minimal. There is no build step, no bundler, no frontend framework. The Python server is split into a routing shell (server.py) and business logic modules (api/). The frontend is seven vanilla JS modules loaded from static/. This makes the code easy to modify from a terminal or by an agent. +Hermes-level chrome is intentionally consolidated: the sidebar has no dedicated brand header. +Instead, the footer exposes a single "Hermes WebUI" launch button that opens one tabbed +control-center modal for global preferences, conversation import/export, and clear-conversation +actions. The topbar remains focused on conversation context and the workspace/files toggle. + --- ## 2. File Inventory @@ -51,7 +58,7 @@ This makes the code easy to modify from a terminal or by an agent. style.css All CSS incl. mobile responsive (~670 lines) ui.js DOM helpers, renderMd, tool cards, model dropdown, file tree (~977 lines) workspace.js File preview, file ops, loadDir, clearPreview (~185 lines) - sessions.js Session CRUD, list rendering, search, SVG icons, overlay actions (~533 lines) + sessions.js Session CRUD, list rendering, search, SVG icons, dropdown actions (~533 lines) messages.js send(), SSE event handlers, approval, transcript (~297 lines) panels.js Cron, skills, memory, workspace, profiles, todo, settings (~974 lines) commands.js Slash command registry, parser, autocomplete dropdown (~156 lines) @@ -351,7 +358,7 @@ highlighting) and Mermaid.js (diagrams) from CDN, both loaded async/deferred wit Six JS modules loaded in order at end of : 1. ui.js (~846 lines) DOM helpers, renderMd, tool card rendering, global state 2. workspace.js (~169 lines) File tree, preview, file operations - 3. sessions.js (~532 lines) Session CRUD, list rendering, search, SVG icons, overlay actions, project picker + 3. sessions.js (~532 lines) Session CRUD, list rendering, search, SVG icons, dropdown actions, project picker 4. messages.js (~293 lines) send(), SSE event handlers, approval, transcript 5. panels.js (~771 lines) Cron, skills, memory, workspace, todo, switchPanel 6. boot.js (~175 lines) Event wiring + boot IIFE @@ -362,10 +369,19 @@ inherit `currentColor` for consistent theming. Three-panel layout (in static/index.html): -