Skip to content

Commit 74de58a

Browse files
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

File tree

0 commit comments

Comments
 (0)