Repository navigation
Commit 74de58a
authored
docs(qa): macOS tray UX + settings-parity audit (ux-audit epic) (#1043)
* docs(qa): macOS tray UX + settings-parity audit
Read-only sweep of the running v0.60.0 tray (accessibility-tree menu walk)
plus a static comparison of the tray's native surfaces and settings
catalogue against the Web UI.
Parity matrix (feature surfaces, settings fields, per-server actions) and
16 ranked findings: dead menu-bar health badge, unlabelled status item,
silent action failures, unreachable Agent Tokens view, and three settings
fields that drifted out of the tray catalogue.
* docs(qa): mark the tray audit resolved, and say what was not re-verified
The document read as an open backlog, but #1055 ("fix(tray): close the 16
findings of the macOS tray UX + settings-parity audit", merged 2026-08-25) fixed
all 16, with #1056 as a catalogue follow-up. The header's "no version skew, so
every finding below is reproducible from source" is no longer true against main.
- Header scopes that claim to the time of the walk and carries a status banner.
- New §6 Resolution records the two fixes whose obvious implementation is wrong:
F1's severity dot is an attributed-title glyph, not a composite image (the
status image stays isTemplate and a template image renders monochrome), and F6
added a parity gate rather than just the three missing keys.
- Verified on main rather than taken on trust: Menu/TrayIcon.swift is deleted,
TokensView is reachable from Views/MainWindow.swift, MCPProxyApp.swift sets
isTemplate + accessibilityDescription + toolTip + attributedTitle glyph, and
SettingsCatalog.swift carries deep_scan / instructions /
code_execution_max_parallel.
Note for anyone tracing this later: #1053's body claims to fix these 16 tray
findings, but #1053 touches no Swift file — it is the Web UI cluster its own
title names. #1055 is the tray PR.
The caveat is stated rather than hidden: this pass could not re-walk the live
tray, because macOS Accessibility was revoked on the reviewing machine
(check_accessibility -> trusted:false), so the resolution is read from the #1055
diff, not from a second walk.
* docs(qa): correct two §1 claims that were wrong at the time of the walk
Verified against v0.60.0 rather than taken on trust:
- The tray Settings tab is named "Raw", not "Raw JSON"
(native/macos/MCPProxy/MCPProxy/Views/SettingsView.swift:38 at v0.60.0). The
§1.2 inventory, the §2 parity matrix and F6's body all said "Raw JSON".
- The Web UI had no /usage route at v0.60.0 - the router's path list runs
/, /servers, /repositories, /search, /settings, /secrets, /sessions, /tools,
/activity, /security, /tokens with no usage or overview entry. Usage was a
Dashboard tab; /usage became a route later, in #1044. The parity matrix's
"Usage report | ⚠ savings % on Dashboard | ✅ /usage | inconsistent" overstated
the Web UI side of that comparison.
Also noted in §6 that three §1.1 menu labels have changed since the walk as part
of the F9 fix: Open MCPProxy Window, Open Web UI in Browser, Launch at Login.
* docs(qa): re-walk the live tray and record that the findings still hold
Replaces the "could not re-walk" caveat with the walk itself. macOS
Accessibility was granted, so mcpproxy-ui-test works now; the walk reproduces
this audit almost verbatim, because the installed tray is still v0.60.0 with
"Update 0.61.0 — ready to restart?" sitting in the menu.
Reproduced live: F2 (empty status-bar title, no description, no tooltip), F5 (no
Agent Tokens entry), F7 (ElevenLabs "Stop" vs cloudflare-graphql "Disable"; and
memory showing status Disabled above action Start), F8 (all three quarantined
servers offer only Disable/Stop, Restart, View Logs), F11 (research and deploy
still offered at 0 tools), F12 (streamable-http beside http and sse), F15 (29
flat entries), F16 (no tool search), and the pre-#1055 menu labels.
One drift worth noting: the Clients block now reads "No clients in the last 24h"
rather than listing an idle client - the empty state H5 exists to avoid.
The consequence for the resolution section: #1055's fixes are real in the diff
but remain unverified against a running tray. That needs the pending 0.61.0
restart or the dev bundle-swap, neither of which this pass did - restarting the
tray kills the core it manages.1 parent 310386f commit 74de58a
1 file changed
Lines changed: 266 additions & 0 deletions
0 commit comments