feat(shortcuts): default to hold Right Alt (push-to-talk) for new installs (#648)

* feat(shortcuts): default to hold Right Alt push-to-talk on first install

Double-tap Ctrl conflicts with many desktop and app shortcuts, so new
installs now use hold Right Alt (Option) in push-to-talk mode. Existing
config.json values are preserved unchanged.

Updates README, user guide, AGENTS.md, first-run dialog, website copy,
and tests to match the new defaults.

* refactor(shortcuts): trim redundant default-change test and comments

Drop the fresh-install assertion that duplicated DEFAULT_CONFIG coverage,
remove the duplicated Right-Alt rationale from config_manager, and drop a
vacuous source-string check from the settings shortcuts test.

* fix(shortcuts): align install.sh seeds and preserve legacy toggle mode

install.sh still wrote ctrl+ctrl without mode, so merges with the new
push_to_talk default became hold-Ctrl. Seed right_alt + push_to_talk for
new installs, and migrate existing shortcut-only configs to mode=toggle
so prior behavior is unchanged.

* style(config): fix black formatting after shortcuts migration

* fix(shortcuts): preserve legacy defaults when shortcuts section is missing

Existing config files without a shortcuts section previously inherited
ctrl+ctrl toggle from DEFAULT_CONFIG. Pin those historical defaults on
upgrade so the new first-install Right Alt push-to-talk defaults do not
silently change behavior.

* docs(agents): unwrap hard-broken dictation control paragraph

Keep the AGENTS.md paragraph as a single line like the surrounding prose.

docs/DISTRO_COMPATIBILITY.md

@@ -519,7 +519,7 @@ Use this checklist when testing on a new distribution:
 - [ ] Launch from terminal: `~/.local/bin/vocalinux-gui`
 - [ ] Launch from application menu
 - [ ] Verify tray icon appears
-- [ ] Test keyboard shortcuts (Ctrl+Alt+M by default)
+- [ ] Test keyboard shortcuts (Hold Right Alt by default)
 - [ ] Test audio recording
 - [ ] Test text injection in different applications
 - [ ] Test Settings dialog opens correctly

docs/USER_GUIDE.md

@@ -32,9 +32,9 @@ Vocalinux supports login autostart using the standard Linux desktop-session mech
 
 1. **Launch the application**: Run `vocalinux` in a terminal or launch it from your application menu
 2. **Find the tray icon**: Look for the microphone icon in your system tray
-3. **Start voice typing**: Click the tray icon and select "Start Voice Typing", or use your configured shortcut mode (toggle or push-to-talk)
+3. **Start voice typing**: Hold Right Alt (Option) by default, or use the tray menu / your configured shortcut
 4. **Speak clearly**: As you speak, your words will be transcribed into the currently focused application
-5. **Stop voice typing**: Click the tray icon and select "Stop Voice Typing" when you're done, double-tap again in toggle mode, or release the key in push-to-talk mode
+5. **Stop voice typing**: Release the key in push-to-talk (default), double-tap again in toggle mode, or use the tray menu
 
 ### Dictation formatting
 
@@ -84,8 +84,8 @@ Vocalinux supports several commands that you can speak to control formatting:
 
 Vocalinux supports two shortcut modes for controlling voice typing:
 
-- **Toggle mode (default)**: Double-tap the shortcut key (Ctrl by default) to start/stop voice typing
-- **Push-to-talk mode**: Hold the configured shortcut key to speak, then release to stop
+- **Push-to-talk mode (default)**: Hold Right Alt (Option on Mac-layout keyboards) to speak, then release to stop
+- **Toggle mode**: Double-tap the configured shortcut key to start/stop voice typing
 - Configure mode and key in **Settings -> Shortcuts**
 
 ### Model Settings