…lback — Principle XI. (#3826)

## Summary

Follow-up crash fix to #3819. A bridge `invoke <target> click` could
segfault the app.

`invoke <target> click` (and `toggle`) ran `QAbstractButton::click()`
**synchronously inside the `QLocalSocket` read callback**. When the
target is a **`QToolButton` with a dropdown menu**, clicking it opens
that menu's popup loop (`popupTimerDone` → `QMenu::exec` →
`QMenu::popup`) — a **nested event loop** — right inside the CFSocket
read callback. That re-enters socket/window state and crashes:

```
QWindow::geometry()  ← SIGSEGV (null window, far=0x8)
QCocoaWindow::setVisible(bool)
QMenu::popup → QMenuPrivate::exec
QToolButtonPrivate::popupTimerDone
QAbstractButton::click()
AutomationServer::doInvoke (AutomationServer.cpp:1555)
AutomationServer::handleLine
AutomationServer::onReadyRead
qt_mac_socket_callback → __CFSocketPerformV0
```

(The app was `Role: Background` at the time, which makes the popup's
native window resolution especially fragile.)

## Root cause & fix

This is the **latent sibling** of the bug #3819 already fixed: that PR
deferred the menu-**action** trigger path out of the socket callback;
the widget **click/toggle** path was left synchronous and opens
popups/dialogs the same way.

Fix: defer `click`/`toggle` to a clean main-loop turn via
`QTimer::singleShot(0, qApp, …)` (QPointer-guarded), so any nested
popup/dialog loop runs on a normal stack — never inside socket I/O. The
response returns `{deferred:true}`; **state setters**
(`setValue`/`setText`/`setChecked`/`setCurrentText`/`setCurrentIndex`/`submit`)
stay synchronous and keep their `newValue` round-trip.

## Verification

Built on `main`, launched a **backgrounded** automation instance, and
clicked the menu-bar overflow popup button (`qt_menubar_ext_button`)
repeatedly:

- `invoke … click` → `{deferred:true}` in <2 ms (was: nested popup →
crash)
- bridge stayed responsive (`ping` immediate)
- app survived every click with **no crash report**

## Note

The general principle now holds across both paths: **a bridge verb must
never run a nested event loop (modal dialog / popup menu) synchronously
inside the socket read callback.** If a *state-setter*'s slot is ever
found to open a modal, the same one-line deferral applies; an
alternative is to dispatch all command handling off the socket callback
entirely (kept out of scope here to preserve the synchronous `newValue`
model).

---

💻 Generated with Claude Code (Opus 4.8) with architecture by @jensenpat

---------

Co-authored-by: Claude Opus 4.8 <noreply@anthropic.com>

…tcuts (#3791) (#3820)

## Summary

Adds **Master Volume Up** and **Master Volume Down** to the configurable
keyboard-shortcut list (Audio category), as requested in #3791.

## Root cause

`MainWindow::registerShortcutActions()`
(`src/gui/MainWindow_Shortcuts.cpp`) registers the Audio category with
per-slice AF Gain Up/Down, mute/mute-all, master mute, and squelch — but
**no master volume up/down**. The user is correct that this is simply a
gap: the identical nudge logic already ships for external controllers
(the Aether Control / StreamDeck `"VolumeUp"` / `"VolumeDown"` dispatch
in `MainWindow_Controllers.cpp`).

## Fix

Register `master_volume_up` / `master_volume_down` in the Audio
category, reusing that exact, already-shipped path:

- clamp `MasterVolume` ±5 into `[0,100]`,
- update the title-bar slider via `TitleBar::setMasterVolume()`,
- push to the audio path via `applyMasterVolume()` — keeping GUI,
persistence, and TCI in sync.

Registered with **no default key** (Up/Down are taken by per-slice AF
Gain, and master volume is a distinct concept — the user binds keys
themselves) and **`autoRepeat=true`** so holding the bound key ramps
continuously (consistent with `rf_gain_up/down` and the tune actions).
Single TU; one added include (`TitleBar.h`, needed for the
`setMasterVolume` call since `MainWindow.h` only forward-declares it).

## How the agent automation bridge proved it

Built and driven through the bridge (`AETHER_AUTOMATION=1`). The two new
entries had to be shown to actually appear in the **Configure
Shortcuts…** list.

Reaching that dialog needed the bridge fidelity work in #3819
(closed-menu `QAction` trigger + per-pid sockets), so the proof was
captured against a local merge of this branch with
`feat/automation-bridge-fidelity`. This branch itself is the single-file
change above.

**1 — machine-readable.** The dialog's Action selector is a non-editable
`QComboBox` populated directly from `ShortcutManager::actions()`.
`setCurrentText` only takes if the item exists, so an exact echo is
proof of registration:

```
invoke AetherSDR::ShortcutDialog/QComboBox setCurrentText "[Audio] Master Volume Up"
  -> newValue="[Audio] Master Volume Up"   PROVEN
invoke AetherSDR::ShortcutDialog/QComboBox setCurrentText "[Audio] Master Volume Down"
  -> newValue="[Audio] Master Volume Down" PROVEN
```

**2 — visual.** With the dialog's search filter set to `Master Volume`,
a `grab` of `AetherSDR::ShortcutDialog` shows exactly two rows —
**Master Volume Up** and **Master Volume Down**, both **Audio**
category, both with empty Current/Default Key (no default binding, as
designed).

| Field | Detail |
|---|---|
| Issue | #3791 — add master volume up/down to configurable shortcuts |
| Root cause | feature simply not registered in the Audio shortcut table
(`MainWindow_Shortcuts.cpp`) |
| Fix | +2 `registerAction` entries reusing the shipped controller
`VolumeUp/Down` nudge; +1 include |
| Bridge proof | non-editable action-combo `setCurrentText` exact-echo
(both entries) + filtered dialog `grab` showing both Audio rows |
| Build | clean (Ninja, all cores) |

💻 Generated with Claude Code (Opus 4.8) with architecture by @jensenpat

Co-authored-by: Claude Opus 4.8 <noreply@anthropic.com>

## Release prep for v26.6.5

Docs + version-string updates for the **50 merges** since v26.6.4. No
code change — safe to merge without a rebuild.

### Changes
- **CHANGELOG.md** — new `[v26.6.5] — 2026-06-28` section, headlined by
**KiwiSDR receive sync** (#3872), **SmartMTR TX meters** (#3776), the
**PROF profile-switcher applet** (#3829), and a large **agent automation
bridge** expansion (#3851/#3856/#3883/#3842/#3832/#3819); categorized
Added/Changed/Fixed/Performance/Removed compiled from the full merge
list. Folds in the prior `[Unreleased]` entries and resets
`[Unreleased]` to empty.
- **CMakeLists.txt / README.md / AGENTS.md** — `26.6.4` → `26.6.5`.
- **ROADMAP.md** — current cycle → `post-v26.6.5`; four v26.6.5
highlights added atop *Recently shipped*.

### Not included
- Tagging `v26.6.5` is a separate, explicit step (not done here).
- The untracked `docs/aetherd-headless-engine-design.md` RFC and
`prototypes/` are intentionally left out.

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-authored-by: Claude Opus 4.8 <noreply@anthropic.com>