Problem
Headless defines important menu shortcuts but has no automated collision or action-wiring coverage. Cmd+P currently means Pin on Top, conflicting with the standard Print expectation, and there is no Cmd+, Settings action.
Scope
Inventory every menu command, key equivalent, modifier set, target, and selector. Keep platform conventions where possible, move Pin on Top to Cmd+Option+P or leave it unassigned, and add Cmd+, when the Settings window lands. Document intentional deviations such as snapshot capture.
Shortcuts remain app-scoped. Do not introduce global hotkeys that can interfere with other applications or system controls.
Acceptance criteria
- A macOS test rejects duplicate key and modifier combinations.
- Tests verify critical items have valid targets, selectors, and expected mappings.
- E2E coverage exercises new window, location, reload, close, snapshot, zoom, history, pin, and Settings.
- Text-editing shortcuts continue to target the active responder correctly.
- Full-screen and system-reserved combinations retain standard behavior.
- The shortcut reference is documented and macOS E2E passes.
Depends on #158 only for Cmd+,. The collision audit can land independently.
Problem
Headless defines important menu shortcuts but has no automated collision or action-wiring coverage. Cmd+P currently means Pin on Top, conflicting with the standard Print expectation, and there is no Cmd+, Settings action.
Scope
Inventory every menu command, key equivalent, modifier set, target, and selector. Keep platform conventions where possible, move Pin on Top to Cmd+Option+P or leave it unassigned, and add Cmd+, when the Settings window lands. Document intentional deviations such as snapshot capture.
Shortcuts remain app-scoped. Do not introduce global hotkeys that can interfere with other applications or system controls.
Acceptance criteria
Depends on #158 only for Cmd+,. The collision audit can land independently.