From ffe839869e1ca78adab0c290864e0dd583f13df7 Mon Sep 17 00:00:00 2001
From: iceice400 <AdamAndrew2468@gmail.com>
Date: Fri, 12 Jun 2026 03:17:16 -0400
Subject: [PATCH 1/3] feat(dashboard): operator status strips, MQTT broker
 health, map hint

Add console-style status footers on Stats, live MQTT runtime card on
Configuration, map overlay GPS hint, and Home Assistant cookbook docs.

Co-authored-by: Cursor <cursoragent@cursor.com>
---
 docs/HOME-ASSISTANT-COOKBOOK.md        | 125 +++++++++++++++++++++++++
 docs/plans/v0.7.8-operator-polish.md   |  87 +++++++++++++++++
 frontend/css/status_strip.css          | 105 +++++++++++++++++++++
 frontend/index.html                    |   2 +
 frontend/js/components/node_map.js     |  30 +++++-
 frontend/js/configuration/mqtt_card.js |  80 ++++++++++++++++
 frontend/js/stats_tab.js               |  34 +++++++
 frontend/js/status_strip.js            |  65 +++++++++++++
 src/api/routes/mqtt_config_routes.py   |  55 ++++++++++-
 src/api/server.py                      |   5 +-
 src/coordinator.py                     |   4 +
 src/relay/mqtt_publisher.py            |  38 ++++++++
 tests/test_mqtt_config_routes.py       |  43 +++++++++
 tests/test_mqtt_publisher.py           |  12 +++
 14 files changed, 678 insertions(+), 7 deletions(-)
 create mode 100644 docs/HOME-ASSISTANT-COOKBOOK.md
 create mode 100644 docs/plans/v0.7.8-operator-polish.md
 create mode 100644 frontend/css/status_strip.css
 create mode 100644 frontend/js/status_strip.js

diff --git a/docs/HOME-ASSISTANT-COOKBOOK.md b/docs/HOME-ASSISTANT-COOKBOOK.md
new file mode 100644
index 00000000..43630a93
--- /dev/null
+++ b/docs/HOME-ASSISTANT-COOKBOOK.md
@@ -0,0 +1,125 @@
+# Home Assistant Cookbook
+
+Copy-paste recipes for Meshpoint LAN automation. Enable the API first
+(see [API-AUTOMATION.md](./API-AUTOMATION.md)), then add these snippets
+to `configuration.yaml` or package files.
+
+All examples assume:
+
+- Meshpoint dashboard: `http://192.168.1.50:8080`
+- Token stored in `secrets.yaml` as `meshpoint_automation_token`
+
+## Node count sensor
+
+```yaml
+rest:
+  - resource: "http://192.168.1.50:8080/api/automation/nodes?limit=500"
+    headers:
+      X-Meshpoint-Token: !secret meshpoint_automation_token
+    scan_interval: 60
+    sensor:
+      - name: "Mesh Nodes"
+        unique_id: meshpoint_node_count
+        value_template: "{{ value_json | length }}"
+        unit_of_measurement: "nodes"
+        icon: mdi:access-point-network
+```
+
+## Meshpoint health binary
+
+Alerts when the automation API stops responding (power loss, service crash).
+
+```yaml
+rest:
+  - resource: "http://192.168.1.50:8080/api/automation/status"
+    headers:
+      X-Meshpoint-Token: !secret meshpoint_automation_token
+    scan_interval: 30
+    binary_sensor:
+      - name: "Meshpoint Online"
+        unique_id: meshpoint_online
+        value_template: "{{ value_json.uptime_seconds is defined }}"
+        device_class: connectivity
+```
+
+## Relay activity sensor
+
+```yaml
+rest:
+  - resource: "http://192.168.1.50:8080/api/automation/status"
+    headers:
+      X-Meshpoint-Token: !secret meshpoint_automation_token
+    scan_interval: 60
+    sensor:
+      - name: "Meshpoint Relayed"
+        unique_id: meshpoint_relayed_total
+        value_template: "{{ value_json.relay.relayed | default(0) }}"
+        unit_of_measurement: "packets"
+      - name: "Meshpoint Relay Rejected"
+        unique_id: meshpoint_relay_rejected
+        value_template: "{{ value_json.relay.rejected | default(0) }}"
+        unit_of_measurement: "packets"
+```
+
+## Broadcast from an automation
+
+```yaml
+rest_command:
+  meshpoint_broadcast:
+    url: "http://192.168.1.50:8080/api/automation/send"
+    method: POST
+    headers:
+      Content-Type: "application/json"
+      X-Meshpoint-Token: !secret meshpoint_automation_token
+    payload: '{"text":"{{ message }}","channel":0,"destination":"broadcast"}'
+
+automation:
+  - alias: "Mesh morning check-in"
+    trigger:
+      - platform: time
+        at: "08:00:00"
+    action:
+      - service: rest_command.meshpoint_broadcast
+        data:
+          message: "Good morning from Home Assistant"
+```
+
+## Alert when node count drops
+
+Useful when a backbone node disappears from the mesh.
+
+```yaml
+automation:
+  - alias: "Mesh node count drop"
+    trigger:
+      - platform: numeric_state
+        entity_id: sensor.mesh_nodes
+        below: 5
+        for: "00:05:00"
+    action:
+      - service: notify.mobile_app
+        data:
+          title: "Meshpoint alert"
+          message: "Node count fell below 5 for 5 minutes"
+```
+
+## MQTT + Home Assistant (packet stream)
+
+If `mqtt.enabled` is true, Meshpoint can publish decoded packets to your
+broker. Enable **Home Assistant auto-discovery** under Configuration →
+MQTT, or subscribe manually to `msh/<region>/2/json/...` topics.
+
+The Configuration MQTT card shows live broker health: connection state,
+publish count, disconnect count, and topic prefix.
+
+## Node-RED
+
+Use an **http request** node pointed at `/api/automation/status` or
+`/api/automation/nodes` with header `X-Meshpoint-Token`. Poll every 30–60 s
+for dashboards; use inject + POST for one-shot messages.
+
+## Security notes
+
+- Keep `automation.token` at 32+ random characters.
+- Do not expose port 8080 to the internet.
+- MQTT credentials live in `config/local.yaml`; treat that file like a secret.
diff --git a/docs/plans/v0.7.8-operator-polish.md b/docs/plans/v0.7.8-operator-polish.md
new file mode 100644
index 00000000..d6e561f0
--- /dev/null
+++ b/docs/plans/v0.7.8-operator-polish.md
@@ -0,0 +1,87 @@
+# v0.7.8 Operator Polish
+
+**Purpose:** Small, green-tier improvements that help field operators trust
+dashboard data and integrate Meshpoint with LAN automation. Submit **after**
+Tier A (v0.7.7) PRs begin merging; **one PR at a time**.
+
+**Risk:** 🟢 Frontend + read-only backend surfaces.
+
+---
+
+## Queue
+
+| # | Branch | Title | Depends on | Status |
+|---|--------|-------|------------|--------|
+| 17 | `feat/operator-polish` | Operator status strips + MQTT broker health + map hint | Tier A baseline | ✅ Ready |
+| 18 | `feat/stats-traffic-heatmap` | SVG traffic heatmap (extends #69 histogram data) | **#69 merged** | ⬜ Not started |
+| 19 | `feat/analytics-status-strips` | RF + Unknown RF + Topology tab footers | **#72, #79, #80 merged** | 🔄 Partial (#72) |
+| 20 | `docs/home-assistant-cookbook` | Expanded HA recipes (ships with #17 docs) | — | ✅ In #17 |
+
+---
+
+## PR 17 — Operator polish (green)
+
+| | |
+|---|---|
+| **Branch** | `feat/operator-polish` |
+| **Title** | `feat(dashboard): operator status strips and MQTT broker health` |
+| **Risk** | 🟢 |
+
+### What ships
+
+1. **Status strip component** (`status_strip.js`, `status_strip.css`)
+   - Console-style footer: `TRAFFIC · concentrator · 8,247 pkts · updated 14s ago`
+   - Wired on Stats tab (more tabs in PR 19 after their parent PRs merge)
+
+2. **MQTT broker health** (`GET /api/config/mqtt/runtime`)
+   - Live connection, publish count, disconnect count, topic prefix
+   - Configuration → MQTT card banner (no restart required to view)
+
+3. **Map topology GPS hint**
+   - Amber banner when Topology Links overlay is on but no lines draw
+   - Points operators to Topology tab for logical graph
+
+4. **Home Assistant cookbook** (`docs/HOME-ASSISTANT-COOKBOOK.md`)
+
+### Test plan
+
+- [ ] Stats tab footer updates on refresh
+- [ ] MQTT card shows connected/disabled/offline states
+- [ ] Map hint appears when links exist without GPS on both ends
+- [ ] `python -m unittest tests.test_mqtt_publisher tests.test_mqtt_config_routes`
+
+---
+
+## PR 18 — Traffic heatmap (green, follow-up to #69)
+
+Do **not** rewrite #69 mid-merge. After #69 lands, add optional SVG
+hour × protocol heatmap beside the 24h bar chart using the same SQL.
+
+---
+
+## PR 19 — Analytics tab footers (green)
+
+After #72 (topology), #79 (RF), and #80 (unknown RF) merge, add
+`StatusStrip` footers:
+
+| Tab | Label | Example |
+|-----|-------|---------|
+| Topology | `TOPOLOGY` | `47 nodes · 23 links · neighborinfo+routing · updated 2m ago` |
+| RF Environment | `RF ENV` | `noise -112 dBm · live scan · 48 samples · updated 5s ago` |
+| Unknown RF | `UNKNOWN RF` | `12 frames · 3 SF buckets · updated 1m ago` |
+
+Rebase each tab's branch and add ~20 lines; or land as one PR on top of
+merged analytics tabs.
+
+---
+
+## Submission order
+
+```
+Tier A merges (v0.7.7)
+  → PR 17 operator-polish
+  → wait for #69 merge → PR 18 heatmap
+  → wait for #72/#79/#80 → PR 19 tab footers
+```
+
+Never open PR 17 and PR 18 simultaneously.
diff --git a/frontend/css/status_strip.css b/frontend/css/status_strip.css
new file mode 100644
index 00000000..aa3dc0c4
--- /dev/null
+++ b/frontend/css/status_strip.css
@@ -0,0 +1,105 @@
+/* Operator status footer — console-style telemetry in panel chrome. */
+
+.status-strip {
+    display: flex;
+    align-items: baseline;
+    flex-wrap: wrap;
+    gap: 0.35rem;
+    margin-top: 1.25rem;
+    padding: 0.5rem 0.75rem;
+    border-radius: var(--radius-sm);
+    border: 1px solid rgba(255, 255, 255, 0.04);
+    background: rgba(6, 182, 212, 0.03);
+    font-family: var(--font-mono);
+    font-size: 0.68rem;
+    letter-spacing: 0.04em;
+    color: var(--text-muted);
+}
+
+.status-strip__label {
+    color: var(--text-secondary);
+    font-weight: 600;
+    letter-spacing: 0.1em;
+    font-size: 0.62rem;
+}
+
+.status-strip__sep {
+    opacity: 0.35;
+}
+
+.status-strip__items {
+    color: var(--accent-cyan);
+    text-shadow: 0 0 6px rgba(6, 182, 212, 0.12);
+}
+
+.status-strip__updated {
+    color: var(--text-muted);
+    font-style: italic;
+}
+
+.status-strip--quiet .status-strip__items {
+    color: var(--text-muted);
+    text-shadow: none;
+    font-style: italic;
+}
+
+.map-topology-hint {
+    position: absolute;
+    left: 50%;
+    bottom: 2.75rem;
+    transform: translateX(-50%);
+    z-index: 800;
+    max-width: min(92%, 28rem);
+    padding: 0.45rem 0.75rem;
+    border-radius: var(--radius-sm);
+    border: 1px solid rgba(245, 158, 11, 0.35);
+    background: rgba(15, 23, 42, 0.92);
+    color: var(--accent-amber);
+    font-family: var(--font-mono);
+    font-size: 0.68rem;
+    letter-spacing: 0.03em;
+    text-align: center;
+    pointer-events: none;
+    box-shadow: var(--glow-amber);
+}
+
+.mqtt-runtime {
+    margin: 0 0 1rem;
+    padding: 0.55rem 0.75rem;
+    border-radius: var(--radius-sm);
+    border: 1px solid rgba(255, 255, 255, 0.05);
+    background: rgba(0, 229, 160, 0.04);
+    font-family: var(--font-mono);
+    font-size: 0.68rem;
+    letter-spacing: 0.03em;
+    color: var(--text-muted);
+}
+
+.mqtt-runtime--offline {
+    background: rgba(239, 68, 68, 0.06);
+    border-color: rgba(239, 68, 68, 0.25);
+}
+
+.mqtt-runtime--disabled {
+    background: rgba(100, 116, 139, 0.08);
+}
+
+.mqtt-runtime__label {
+    color: var(--text-secondary);
+    font-weight: 600;
+    letter-spacing: 0.1em;
+    font-size: 0.62rem;
+    margin-right: 0.35rem;
+}
+
+.mqtt-runtime__state {
+    color: var(--accent-green);
+}
+
+.mqtt-runtime--offline .mqtt-runtime__state {
+    color: var(--accent-red);
+}
+
+.mqtt-runtime--disabled .mqtt-runtime__state {
+    color: var(--text-muted);
+}
diff --git a/frontend/index.html b/frontend/index.html
index 239398cc..69a41a12 100644
--- a/frontend/index.html
+++ b/frontend/index.html
@@ -21,6 +21,7 @@
     <link rel="stylesheet" href="css/init_checklist.css" />
     <link rel="stylesheet" href="css/route_motion.css" />
     <link rel="stylesheet" href="css/since_line.css" />
+    <link rel="stylesheet" href="css/status_strip.css" />
     <link rel="stylesheet" href="css/command_palette.css" />
     <link rel="stylesheet" href="css/keymap_overlay.css" />
     <link rel="stylesheet" href="css/theme_high_contrast.css" />
@@ -747,6 +748,7 @@ <h3 class="dangerous-panel__title">Service actions</h3>
     <script src="topbar/topbar_controller.js"></script>
     <script src="js/build_stamp.js"></script>
     <script src="js/last_visit_tracker.js"></script>
+    <script src="js/status_strip.js"></script>
     <script src="js/since_line.js"></script>
     <script src="js/since_line_controller.js"></script>
     <script src="js/init_checklist.js"></script>
diff --git a/frontend/js/components/node_map.js b/frontend/js/components/node_map.js
index c8a88af8..72564281 100644
--- a/frontend/js/components/node_map.js
+++ b/frontend/js/components/node_map.js
@@ -404,12 +404,33 @@ class NodeMap {
         }, 200);
     }
 
+    _showTopologyMapHint(show) {
+        let el = document.getElementById('map-topology-hint');
+        if (!el && this._map) {
+            el = document.createElement('div');
+            el.id = 'map-topology-hint';
+            el.className = 'map-topology-hint';
+            el.hidden = true;
+            this._map.getContainer().appendChild(el);
+        }
+        if (!el) return;
+        if (show) {
+            el.textContent =
+                'Links need GPS on both endpoints. Open the Topology tab for the logical graph.';
+            el.hidden = false;
+        } else {
+            el.hidden = true;
+        }
+    }
+
     async _loadTopology() {
         try {
-            const res = await fetch('/api/analytics/topology');
-            const links = await res.json();
+            const res = await fetch('/api/analytics/topology?hours=24');
+            const data = await res.json();
+            const links = Array.isArray(data) ? data : (data.edges || []);
             this._topologyLayer.clearLayers();
 
+            let drawn = 0;
             for (const link of links) {
                 const srcMarker = this._markers[link.source];
                 const tgtMarker = this._markers[link.target];
@@ -434,9 +455,14 @@ class NodeMap {
                 line.bindTooltip(tooltip);
 
                 this._topologyLayer.addLayer(line);
+                drawn += 1;
             }
+            this._showTopologyMapHint(
+                this._topologyVisible && links.length > 0 && drawn === 0,
+            );
         } catch (e) {
             console.error('Topology load failed:', e);
+            this._showTopologyMapHint(false);
         }
     }
 
diff --git a/frontend/js/configuration/mqtt_card.js b/frontend/js/configuration/mqtt_card.js
index 2678d460..c7738e4c 100644
--- a/frontend/js/configuration/mqtt_card.js
+++ b/frontend/js/configuration/mqtt_card.js
@@ -11,6 +11,7 @@ class MqttConfigCard {
         this._root = null;
         this._passwordDirty = false;
         this._unsubDisplayUnits = null;
+        this._runtimeInterval = null;
     }
 
     mount(root) {
@@ -25,6 +26,10 @@ class MqttConfigCard {
                         are published. Undecrypted packets never leave the device.
                     </p>
                 </header>
+                <div class="mqtt-runtime mqtt-runtime--disabled" data-mqtt-runtime hidden>
+                    <span class="mqtt-runtime__label">BROKER</span>
+                    <span class="mqtt-runtime__state" data-mqtt-runtime-text>Loading…</span>
+                </div>
                 <form class="cfg-form" data-mqtt-form>
                     <label class="cfg-field cfg-field--toggle">
                         <input type="checkbox" data-mqtt-enabled>
@@ -144,6 +149,8 @@ class MqttConfigCard {
         this._previewMc = this._root.querySelector('[data-mqtt-preview-mc]');
         this._previewJson = this._root.querySelector('[data-mqtt-preview-json]');
         this._statusEl = this._root.querySelector('[data-mqtt-status]');
+        this._runtimeEl = this._root.querySelector('[data-mqtt-runtime]');
+        this._runtimeText = this._root.querySelector('[data-mqtt-runtime-text]');
 
         this._pass.addEventListener('input', () => { this._passwordDirty = true; });
         this._json.addEventListener('change', () => this._renderPreviews());
@@ -196,6 +203,79 @@ class MqttConfigCard {
         if (this._ha) this._ha.checked = !!mqtt.homeassistant_discovery;
         if (this._tls) this._tls.checked = !!mqtt.tls_enabled;
         this._renderPreviews(mqtt);
+        this._refreshRuntime();
+        this._startRuntimePolling();
+    }
+
+    _startRuntimePolling() {
+        if (this._runtimeInterval) return;
+        this._runtimeInterval = setInterval(() => {
+            const section = document.querySelector('[data-section="configuration/mqtt"]');
+            if (section && section.classList.contains('section--active')) {
+                this._refreshRuntime();
+            } else {
+                clearInterval(this._runtimeInterval);
+                this._runtimeInterval = null;
+            }
+        }, 10000);
+    }
+
+    async _refreshRuntime() {
+        if (!this._runtimeEl) return;
+        try {
+            const res = await fetch('/api/config/mqtt/runtime');
+            if (!res.ok) return;
+            const data = await res.json();
+            this._renderRuntime(data);
+        } catch (_) {
+            /* non-fatal */
+        }
+    }
+
+    _renderRuntime(data) {
+        if (!this._runtimeEl || !this._runtimeText) return;
+        this._runtimeEl.hidden = false;
+        this._runtimeEl.classList.remove(
+            'mqtt-runtime--offline',
+            'mqtt-runtime--disabled',
+        );
+
+        if (!data.config_enabled) {
+            this._runtimeEl.classList.add('mqtt-runtime--disabled');
+            this._runtimeText.textContent = 'MQTT disabled in config';
+            return;
+        }
+
+        if (!data.publisher_active) {
+            this._runtimeEl.classList.add('mqtt-runtime--offline');
+            this._runtimeText.textContent =
+                'Enabled but publisher not running (restart Meshpoint after save)';
+            return;
+        }
+
+        const host = data.broker_host || 'broker';
+        const port = data.broker_port ?? 1883;
+        const prefix = data.topic_prefix || 'msh';
+        const pub = data.publish_count ?? 0;
+        const disc = data.disconnect_count ?? 0;
+
+        if (!data.connected) {
+            this._runtimeEl.classList.add('mqtt-runtime--offline');
+            const rc = data.last_disconnect_rc ?? data.last_connect_rc;
+            const rcLabel = rc != null ? ` · rc ${rc}` : '';
+            this._runtimeText.textContent =
+                `${host}:${port} · disconnected${rcLabel} · ${disc} drops · ${pub} published`;
+            return;
+        }
+
+        const since = data.connected_since
+            ? `since ${new Date(data.connected_since).toLocaleTimeString()}`
+            : 'connected';
+        const lastPub = data.last_publish_at
+            ? ` · last pub ${new Date(data.last_publish_at).toLocaleTimeString()}`
+            : '';
+        this._runtimeText.textContent =
+            `${host}:${port} · ${since} · ${prefix} · ${pub} published · ${disc} drops${lastPub}`;
     }
 
     _renderPreviews(cached) {
diff --git a/frontend/js/stats_tab.js b/frontend/js/stats_tab.js
index bafc368d..ce7d6f7a 100644
--- a/frontend/js/stats_tab.js
+++ b/frontend/js/stats_tab.js
@@ -70,6 +70,8 @@ class StatsTab {
         this._charts = {};
         this._refreshInterval = null;
         this._rendered = false;
+        this._statusStrip = null;
+        this._fetchedAt = null;
     }
 
     async refresh() {
@@ -80,6 +82,7 @@ class StatsTab {
                 this._buildLayout();
                 this._rendered = true;
             }
+            this._fetchedAt = Date.now();
             this._update(data);
         } catch (e) {
             console.error('Stats refresh failed:', e);
@@ -268,7 +271,15 @@ class StatsTab {
                 </div>
             </section>
 
+            <div id="stats-status-strip-host"></div>
+
         </div>`;
+
+        const host = document.getElementById('stats-status-strip-host');
+        if (host && window.StatusStrip) {
+            this._statusStrip = new window.StatusStrip(host, 'TRAFFIC');
+            this._statusStrip.mount();
+        }
     }
 
     _update(data) {
@@ -303,6 +314,29 @@ class StatsTab {
         this._updateTimeline(data.traffic_timeline || {});
         this._updateRelay(data.relay || {});
         this._updateRejectReasons(data.relay || {});
+        this._updateStatusStrip(traffic, network, device, data.relay || {});
+    }
+
+    _updateStatusStrip(traffic, network, device, relay) {
+        if (!this._statusStrip) return;
+        const total = traffic.total_packets || 0;
+        const nodes = network.total_nodes || 0;
+        const region = device.region || 'region n/a';
+        const relayed = relay.relayed ?? relay.relayed_count ?? 0;
+        const rejected = relay.rejected ?? relay.rejected_count ?? 0;
+        const relayLine = relay.enabled
+            ? `relay ${relayed} ok / ${rejected} blocked`
+            : 'relay off';
+        this._statusStrip.update(
+            [
+                'concentrator',
+                `${total.toLocaleString()} pkts`,
+                `${nodes} nodes`,
+                region,
+                relayLine,
+            ],
+            this._fetchedAt,
+        );
     }
 
     _setText(id, value) {
diff --git a/frontend/js/status_strip.js b/frontend/js/status_strip.js
new file mode 100644
index 00000000..afba91ea
--- /dev/null
+++ b/frontend/js/status_strip.js
@@ -0,0 +1,65 @@
+/**
+ * Console-style operator status footer for analytics tabs.
+ *
+ * Renders a slim monospace strip at the bottom of a panel:
+ *   TRAFFIC · concentrator · 8,247 pkts · updated 14s ago
+ */
+class StatusStrip {
+    constructor(hostEl, label) {
+        this._host = hostEl;
+        this._label = (label || 'STATUS').toUpperCase();
+        this._root = null;
+        this._itemsEl = null;
+        this._updatedEl = null;
+    }
+
+    mount() {
+        if (!this._host || this._root) return;
+        const root = document.createElement('footer');
+        root.className = 'status-strip';
+        root.setAttribute('role', 'status');
+        root.setAttribute('aria-live', 'polite');
+        root.innerHTML = `
+            <span class="status-strip__label">${this._label}</span>
+            <span class="status-strip__sep" aria-hidden="true">·</span>
+            <span class="status-strip__items"></span>
+            <span class="status-strip__updated"></span>
+        `;
+        this._host.appendChild(root);
+        this._root = root;
+        this._itemsEl = root.querySelector('.status-strip__items');
+        this._updatedEl = root.querySelector('.status-strip__updated');
+    }
+
+    /**
+     * @param {string[]} items - dot-separated status fragments
+     * @param {Date|number|null} updatedAt - when underlying data was fetched
+     */
+    update(items, updatedAt) {
+        if (!this._root) return;
+        const parts = (items || []).filter((item) => item != null && String(item).trim());
+        this._itemsEl.textContent = parts.length ? parts.join(' · ') : 'waiting for data';
+        this._root.classList.toggle('status-strip--quiet', parts.length === 0);
+
+        if (this._updatedEl) {
+            if (updatedAt) {
+                this._updatedEl.textContent = ` · updated ${_formatRelative(updatedAt)}`;
+            } else {
+                this._updatedEl.textContent = '';
+            }
+        }
+    }
+}
+
+function _formatRelative(timestamp) {
+    const ms = timestamp instanceof Date ? timestamp.getTime() : Number(timestamp);
+    if (!ms) return 'just now';
+    const seconds = Math.max(0, Math.floor((Date.now() - ms) / 1000));
+    if (seconds < 30) return 'just now';
+    if (seconds < 60) return `${seconds}s ago`;
+    if (seconds < 3600) return `${Math.floor(seconds / 60)}m ago`;
+    if (seconds < 86400) return `${Math.floor(seconds / 3600)}h ago`;
+    return `${Math.floor(seconds / 86400)}d ago`;
+}
+
+window.StatusStrip = StatusStrip;
diff --git a/src/api/routes/mqtt_config_routes.py b/src/api/routes/mqtt_config_routes.py
index a024d473..547b064f 100644
--- a/src/api/routes/mqtt_config_routes.py
+++ b/src/api/routes/mqtt_config_routes.py
@@ -19,26 +19,60 @@
 from src.api.auth.dependencies import require_admin
 from src.api.auth.jwt_session import SessionClaims
 from src.config import AppConfig, MqttConfig, save_section_to_yaml
-from src.relay.mqtt_publisher import _resolve_gateway_id
+from src.relay.mqtt_publisher import MqttPublisher, _resolve_gateway_id
 
 logger = logging.getLogger(__name__)
 
 router = APIRouter(prefix="/api/config", tags=["config"])
 
 _config: AppConfig | None = None
+_mqtt_publisher: MqttPublisher | None = None
 
 _GATEWAY_RE = re.compile(r"^!?[0-9a-fA-F]{8}$")
 _LOCATION_PRECISION = frozenset({"exact", "approximate", "none"})
 
 
-def init_routes(config: AppConfig) -> None:
-    global _config
+def init_routes(
+    config: AppConfig,
+    mqtt_publisher: MqttPublisher | None = None,
+) -> None:
+    global _config, _mqtt_publisher
     _config = config
+    _mqtt_publisher = mqtt_publisher
 
 
 def reset_routes() -> None:
-    global _config
+    global _config, _mqtt_publisher
     _config = None
+    _mqtt_publisher = None
+
+
+def build_mqtt_runtime_status(
+    mqtt: MqttConfig,
+    publisher: MqttPublisher | None,
+) -> dict:
+    """Live broker health for the Configuration MQTT card."""
+    base = {
+        "config_enabled": mqtt.enabled,
+        "publisher_active": publisher is not None,
+        "connected": False,
+        "publish_count": 0,
+        "disconnect_count": 0,
+        "last_connect_rc": None,
+        "last_disconnect_rc": None,
+        "last_publish_at": None,
+        "connected_since": None,
+        "topic_prefix": None,
+        "gateway_id": _resolve_gateway_id(mqtt.gateway_id, "meshpoint"),
+        "broker_host": mqtt.broker,
+        "broker_port": mqtt.port,
+    }
+    if publisher is None:
+        return base
+    runtime = publisher.get_runtime_status()
+    base.update(runtime)
+    base["publisher_active"] = True
+    return base
 
 
 def build_mqtt_status(mqtt: MqttConfig, device_name: str) -> dict:
@@ -124,6 +158,19 @@ def _check_precision(cls, value: str) -> str:
         return value
 
 
+@router.get("/mqtt/runtime")
+async def get_mqtt_runtime():
+    """Read-only MQTT broker connection health (any authenticated user)."""
+    if _config is None:
+        raise HTTPException(503, "Config not loaded")
+    device_name = _config.device.device_name or "meshpoint"
+    payload = build_mqtt_runtime_status(_config.mqtt, _mqtt_publisher)
+    payload["gateway_id"] = _resolve_gateway_id(
+        _config.mqtt.gateway_id, device_name
+    )
+    return payload
+
+
 @router.put("/mqtt")
 async def update_mqtt(
     req: MqttUpdate,
diff --git a/src/api/server.py b/src/api/server.py
index 3bd4fb06..b3ff5483 100644
--- a/src/api/server.py
+++ b/src/api/server.py
@@ -1261,7 +1261,10 @@ def _init_routes(
         tx_service=tx_service,
         identity=identity,
     )
-    mqtt_config_routes.init_routes(config=config)
+    mqtt_config_routes.init_routes(
+        config=config,
+        mqtt_publisher=coord.mqtt_publisher,
+    )
     upstream_config_routes.init_routes(config=config)
     device_config_routes.init_routes(config=config, identity=identity)
     gps_status.init_routes(location_source=coord.location_source)
diff --git a/src/coordinator.py b/src/coordinator.py
index 665e9ca7..8ffd7e57 100644
--- a/src/coordinator.py
+++ b/src/coordinator.py
@@ -113,6 +113,10 @@ def location_source(self) -> LocationSource:
         """Live GPS source. Always present (defaults to ``StaticSource``)."""
         return self._location_source
 
+    @property
+    def mqtt_publisher(self) -> Optional[MqttPublisher]:
+        return self._mqtt
+
     def on_packet(self, callback: Callable[[Packet], None]) -> None:
         """Register a callback invoked for each decoded packet."""
         self._on_packet_callbacks.append(callback)
diff --git a/src/relay/mqtt_publisher.py b/src/relay/mqtt_publisher.py
index 89b2294c..1fff7c1a 100644
--- a/src/relay/mqtt_publisher.py
+++ b/src/relay/mqtt_publisher.py
@@ -12,6 +12,8 @@
 
 import json
 import logging
+import time
+from datetime import datetime, timezone
 from typing import Optional
 
 from src.config import MqttConfig
@@ -54,6 +56,11 @@ def __init__(
         self._client: Optional[paho_mqtt.Client] = None
         self._connected = False
         self._publish_count = 0
+        self._disconnect_count = 0
+        self._last_connect_rc: int | None = None
+        self._last_disconnect_rc: int | None = None
+        self._last_publish_monotonic: float | None = None
+        self._connected_since_monotonic: float | None = None
 
         self._allowed_channels = set(
             ch.lower() for ch in config.publish_channels
@@ -89,6 +96,22 @@ def connected(self) -> bool:
     def publish_count(self) -> int:
         return self._publish_count
 
+    def get_runtime_status(self) -> dict:
+        """Live broker connection stats for the Configuration dashboard."""
+        return {
+            "connected": self._connected,
+            "publish_count": self._publish_count,
+            "disconnect_count": self._disconnect_count,
+            "last_connect_rc": self._last_connect_rc,
+            "last_disconnect_rc": self._last_disconnect_rc,
+            "last_publish_at": _iso_from_monotonic(self._last_publish_monotonic),
+            "connected_since": _iso_from_monotonic(self._connected_since_monotonic),
+            "topic_prefix": self._topic_prefix,
+            "gateway_id": self._gateway_id,
+            "broker_host": self._config.broker,
+            "broker_port": self._config.port,
+        }
+
     def connect(self) -> bool:
         if not PAHO_AVAILABLE:
             logger.error(
@@ -162,6 +185,7 @@ def publish(self, packet: Packet) -> bool:
 
         if published:
             self._publish_count += 1
+            self._last_publish_monotonic = time.monotonic()
             logger.debug("MQTT published %s (%s)", packet.packet_id, packet.packet_type.value)
             if self._ha_discovery:
                 self._ha_discovery.announce_node(packet)
@@ -210,8 +234,10 @@ def _format_packet(self, packet: Packet) -> list[MqttMessage]:
         return messages
 
     def _on_connect(self, client, userdata, flags, rc) -> None:
+        self._last_connect_rc = rc
         if rc == 0:
             self._connected = True
+            self._connected_since_monotonic = time.monotonic()
             logger.info("MQTT publisher started as %s", self._gateway_id)
             logger.debug("MQTT connected to broker=%s", self._config.broker)
             if self._config.homeassistant_discovery and self._client:
@@ -222,7 +248,10 @@ def _on_connect(self, client, userdata, flags, rc) -> None:
 
     def _on_disconnect(self, client, userdata, rc) -> None:
         self._connected = False
+        self._last_disconnect_rc = rc
+        self._connected_since_monotonic = None
         if rc != 0:
+            self._disconnect_count += 1
             logger.warning("MQTT unexpected disconnect (rc=%d), auto-reconnecting", rc)
 
     def _resolve_topic_prefix(self) -> str:
@@ -376,6 +405,15 @@ def _gps_tracker_config(self, node_id: str) -> tuple[str, str]:
         return topic, json.dumps(config)
 
 
+def _iso_from_monotonic(monotonic_at: float | None) -> str | None:
+    if monotonic_at is None:
+        return None
+    elapsed = time.monotonic() - monotonic_at
+    return datetime.fromtimestamp(
+        time.time() - elapsed, tz=timezone.utc
+    ).isoformat()
+
+
 def _resolve_gateway_id(override: Optional[str], device_name: str) -> str:
     """Use explicit config override or derive from device name."""
     if override:
diff --git a/tests/test_mqtt_config_routes.py b/tests/test_mqtt_config_routes.py
index acc562c1..b535a193 100644
--- a/tests/test_mqtt_config_routes.py
+++ b/tests/test_mqtt_config_routes.py
@@ -136,6 +136,49 @@ def test_empty_publish_channels_returns_422(self) -> None:
         self.assertEqual(resp.status_code, 422)
 
 
+class TestMqttRuntimeRoute(unittest.TestCase):
+    def tearDown(self) -> None:
+        mqtt_module.reset_routes()
+
+    def test_runtime_disabled_when_mqtt_off(self) -> None:
+        mqtt_module.init_routes(_fake_app_config())
+        client = TestClient(_build_app())
+        resp = client.get("/api/config/mqtt/runtime")
+        self.assertEqual(resp.status_code, 200)
+        body = resp.json()
+        self.assertFalse(body["config_enabled"])
+        self.assertFalse(body["publisher_active"])
+        self.assertFalse(body["connected"])
+
+    def test_runtime_reflects_live_publisher(self) -> None:
+        publisher = MagicMock()
+        publisher.get_runtime_status.return_value = {
+            "connected": True,
+            "publish_count": 42,
+            "disconnect_count": 1,
+            "last_connect_rc": 0,
+            "last_disconnect_rc": None,
+            "last_publish_at": "2026-06-11T12:00:00+00:00",
+            "connected_since": "2026-06-11T11:00:00+00:00",
+            "topic_prefix": "msh/US",
+            "gateway_id": "!aabbccdd",
+            "broker_host": "broker.example.com",
+            "broker_port": 1883,
+        }
+        cfg = _fake_app_config()
+        cfg.mqtt.enabled = True
+        mqtt_module.init_routes(cfg, mqtt_publisher=publisher)
+        client = TestClient(_build_app())
+        resp = client.get("/api/config/mqtt/runtime")
+        self.assertEqual(resp.status_code, 200)
+        body = resp.json()
+        self.assertTrue(body["config_enabled"])
+        self.assertTrue(body["publisher_active"])
+        self.assertTrue(body["connected"])
+        self.assertEqual(body["publish_count"], 42)
+        self.assertEqual(body["topic_prefix"], "msh/US")
+
+
 class TestResolveGatewayId(unittest.TestCase):
     def test_override_wins_over_device_name(self) -> None:
         self.assertEqual(
diff --git a/tests/test_mqtt_publisher.py b/tests/test_mqtt_publisher.py
index 004fe4b1..40baa00d 100644
--- a/tests/test_mqtt_publisher.py
+++ b/tests/test_mqtt_publisher.py
@@ -78,6 +78,18 @@ def test_on_connect_logs_start_message(self):
             logs.output,
         )
 
+    def test_runtime_status_tracks_connect_and_disconnect(self) -> None:
+        pub = MqttPublisher(MqttConfig(enabled=True), device_name="meshpoint-alpha")
+        pub._on_connect(client=None, userdata=None, flags=None, rc=0)
+        status = pub.get_runtime_status()
+        self.assertTrue(status["connected"])
+        self.assertIsNotNone(status["connected_since"])
+        pub._on_disconnect(client=None, userdata=None, rc=7)
+        status = pub.get_runtime_status()
+        self.assertFalse(status["connected"])
+        self.assertEqual(status["disconnect_count"], 1)
+        self.assertEqual(status["last_disconnect_rc"], 7)
+
 
 if __name__ == "__main__":
     unittest.main()

From 74ae4f5c8939b289b34760d0730d526d66dffed0 Mon Sep 17 00:00:00 2001
From: iceice400 <AdamAndrew2468@gmail.com>
Date: Fri, 12 Jun 2026 03:34:26 -0400
Subject: [PATCH 2/3] docs(roadmap): add master PR queue and v0.7.8 polish
 status

Link PR 17 to #90, mark PR 19 partial on #72/#79/#80, note heatmap branch.

Co-authored-by: Cursor <cursoragent@cursor.com>
---
 docs/plans/master-pr-roadmap.md      | 773 +++++++++++++++++++++++++++
 docs/plans/v0.7.8-operator-polish.md |  22 +-
 2 files changed, 788 insertions(+), 7 deletions(-)
 create mode 100644 docs/plans/master-pr-roadmap.md

diff --git a/docs/plans/master-pr-roadmap.md b/docs/plans/master-pr-roadmap.md
new file mode 100644
index 00000000..5e2c2bd0
--- /dev/null
+++ b/docs/plans/master-pr-roadmap.md
@@ -0,0 +1,773 @@
+# Meshpoint — Master PR Roadmap (16 PRs)
+
+**Purpose:** Ordered pull-request queue across three feature-request batches. Submit **one at a time**; wait for merge or explicit feedback before opening the next.  
+**Workflow:** [CONTRIBUTING.md](../../CONTRIBUTING.md) — branch from current `upstream/main`, one focused PR per branch, squash-merge on `KMX415/meshpoint:main`.  
+**Risk tiers** (from CONTRIBUTING.md):
+
+| Tier | Meaning |
+|------|---------|
+| 🟢 Green | Frontend or read-only backend — minimal review |
+| 🟡 Yellow | New backend logic / config — standard review |
+| 🔴 Red | Relay module or concentrator path — extra review |
+
+**Sources:**
+
+| Code | Suite |
+|------|-------|
+| FR1 | Feature Request 1 — Operator Diagnostics |
+| FR2 | Feature Request 2 — Operator Intelligence |
+| FR3 | Feature Request 3 — Field Operations |
+| FR4 | Feature Request 4 — Remote Node Administration |
+
+---
+
+## Review status (your checklist)
+
+Use this table to track what is **done**, **in flight**, or **not started**. Update the Status column as PRs merge.
+
+| # | PR | Branch | Source | Risk | Status | Upstream PR |
+|---|-----|--------|--------|------|--------|-------------|
+| 01 | Packet Detail Modal | `feat/packet-detail-modal` | FR1 | 🟢 | ✅ Submitted | [#68](https://github.com/KMX415/meshpoint/pull/68) |
+| 02 | Config QR Export | `feat/config-qr-export` | FR3 | 🟢 | ✅ Submitted | [#76](https://github.com/KMX415/meshpoint/pull/76) |
+| 03 | 24-Hour Traffic Histograms | `feat/traffic-histograms` | FR1 | 🟢 | ✅ Submitted | [#69](https://github.com/KMX415/meshpoint/pull/69) |
+| 04 | LAN Browser Push Notifications | `feat/lan-push-notifications` | FR3 | 🟢 | ✅ Submitted | [#77](https://github.com/KMX415/meshpoint/pull/77) |
+| 05 | Per-Node Signal Health Sparklines | `feat/signal-health-tracking` | FR1 | 🟢 | ✅ Submitted | [#70](https://github.com/KMX415/meshpoint/pull/70) |
+| 06 | Node Coverage Map Layer | `feat/node-coverage-map` | FR2 | 🟢 | ✅ Submitted | [#78](https://github.com/KMX415/meshpoint/pull/78) |
+| 07 | Spectrum Analyzer Dashboard Tab | `feat/spectrum-analyzer-tab` | FR2 | 🟡 | ✅ Submitted | [#79](https://github.com/KMX415/meshpoint/pull/79) |
+| 08 | Stray Frame Logger | `feat/stray-frame-logger` | FR3 | 🟡 | ✅ Submitted | [#80](https://github.com/KMX415/meshpoint/pull/80) |
+| 09 | Prometheus Metrics Endpoint | `feat/prometheus-metrics` | FR2 | 🟡 | ✅ Submitted | [#81](https://github.com/KMX415/meshpoint/pull/81) |
+| 10 | Event-Driven Webhook Engine | `feat/webhook-engine-config` | FR3 | 🟡 | ✅ Submitted | [#82](https://github.com/KMX415/meshpoint/pull/82) |
+| 11 | Webhook Dashboard UI | `feat/webhook-ui` | FR3 | 🟢 | ✅ Submitted | [#83](https://github.com/KMX415/meshpoint/pull/83) |
+| 12 | Storm Guard Auto-Quarantine | `feat/storm-guard-quarantine` | FR2 | 🔴 | ✅ Submitted | [#84](https://github.com/KMX415/meshpoint/pull/84) |
+| 13 | Smart Relay Filter Controls | `feat/relay-filter-controls` | FR1 | 🔴 | ✅ Submitted | [#71](https://github.com/KMX415/meshpoint/pull/71) |
+| 14 | USB Companion Firmware Flasher | `feat/companion-firmware-flasher` | FR3 | 🟡 | ✅ Submitted | [#85](https://github.com/KMX415/meshpoint/pull/85) |
+| 15 | Remote Node Config Reader | `feat/remote-node-config-read` | FR4 | 🔴 | ✅ Submitted | [#86](https://github.com/KMX415/meshpoint/pull/86) |
+| 16 | Remote Node Config Writer | `feat/remote-node-config-write` | FR4 | 🔴 | ✅ Submitted | [#87](https://github.com/KMX415/meshpoint/pull/87) |
+
+**Legend:** ✅ Submitted · 🔄 In review · ⬜ Not started · ⏸ Blocked (waiting on dependency)
+
+### Also submitted (parallel diagnostics track — not in the 13-PR queue)
+
+These were built in the earlier [7-PR diagnostics suite](./operator-diagnostics-pr-list.md). They are **in scope** for Meshpoint but numbered separately in that plan:
+
+| Diagnostics PR | Branch | Upstream PR | Notes |
+|----------------|--------|-------------|-------|
+| 5 — Visual Topology Graph | `feat/topology-graph-tab` | [#72](https://github.com/KMX415/meshpoint/pull/72) | FR2-adjacent; map/topology |
+| 6 — LAN REST Automation API | `feat/lan-rest-api` | [#73](https://github.com/KMX415/meshpoint/pull/73) | FR3-adjacent; Home Assistant |
+| 7 — Relay Duty-Cycle Throttle | `feat/relay-duty-cycle` | [#74](https://github.com/KMX415/meshpoint/pull/74) | 🔴 relay; depends on PR 03 + 13 logic |
+
+**Recommended:** Let #68–#71 merge before opening #02–#12. Rebase any in-flight branch onto `main` after each merge.
+
+### v0.7.8 operator polish (after Tier A / v0.7.7)
+
+Green-tier operator UX that does not block the 16-PR queue. Full detail:
+[`v0.7.8-operator-polish.md`](./v0.7.8-operator-polish.md).
+
+| # | Branch | Risk | Status | Notes |
+|---|--------|------|--------|-------|
+| 17 | `feat/operator-polish` | 🟢 | ✅ [#90](https://github.com/KMX415/meshpoint/pull/90) | Status strips (Stats), MQTT runtime health, map GPS hint, HA cookbook |
+| 18 | `feat/stats-traffic-heatmap` | 🟢 | 🔄 In progress | After **#69** merges; branches from `feat/traffic-histograms` |
+| 19 | `feat/analytics-status-strips` | 🟢 | ✅ Partial | Footers on **#72, #79, #80**; Stats footer in **#90** |
+| 20 | `docs/home-assistant-cookbook` | Docs | In #17 | Standalone doc also linked from README when #17 lands |
+
+Submit **17** only after Tier A PRs begin landing. Never open 17 and 18 at once.
+
+---
+
+## Master table (submit in this order)
+
+| # | Branch | Source | Risk | Relay? | Backend? | Frontend? | Depends on |
+|---|--------|--------|------|--------|----------|-----------|------------|
+| 01 | `feat/packet-detail-modal` | FR1 | 🟢 | No | No | Yes | — |
+| 02 | `feat/config-qr-export` | FR3 | 🟢 | No | Minimal | Yes | — |
+| 03 | `feat/traffic-histograms` | FR1 | 🟢 | No | One endpoint | Yes | — |
+| 04 | `feat/lan-push-notifications` | FR3 | 🟢 | No | One WS field | Yes | — |
+| 05 | `feat/signal-health-tracking` | FR1 | 🟢 | No | One endpoint | Yes | — |
+| 06 | `feat/node-coverage-map` | FR2 | 🟢 | No | One endpoint | Yes | — |
+| 07 | `feat/spectrum-analyzer-tab` | FR2 | 🟡 | No | One endpoint | Yes | — |
+| 08 | `feat/stray-frame-logger` | FR3 | 🟡 | No | Table + insert | Yes | — |
+| 09 | `feat/prometheus-metrics` | FR2 | 🟡 | No | One endpoint | No | — |
+| 10 | `feat/webhook-engine-config` | FR3 | 🟡 | No | New module | No | — |
+| 11 | `feat/webhook-ui` | FR3 | 🟢 | No | Two endpoints | Yes | **PR 10** |
+| 12 | `feat/storm-guard-quarantine` | FR2 | 🔴 | Yes | Rate counter | Yes | [#84](https://github.com/KMX415/meshpoint/pull/84) |
+| 13 | `feat/relay-filter-controls` | FR1 | 🔴 | Yes | Config R/W | Yes | — |
+| 14 | `feat/companion-firmware-flasher` | FR3 | 🟡 | No | Subprocess + WS | Yes | — |
+| 15 | `feat/remote-node-config-read` | FR4 | 🔴 | Yes | ADMIN TX read | Yes | **PR 14** |
+| 16 | `feat/remote-node-config-write` | FR4 | 🔴 | Yes | ADMIN TX write | Yes | **PR 15** + 1 wk soak |
+
+**Merge order:** 01 → 02 → … → 16 (ascending risk within each phase). **Never open two PRs at once.**
+
+**Field hardware suite (14–16):** Submit **14**, wait for merge, then **15**, wait for merge + **≥1 week production soak**, then **16**.
+
+---
+
+## Shared prerequisites (every PR)
+
+```bash
+git fetch upstream
+git checkout -B feat/<branch-name> upstream/main
+```
+
+**PR description must include:**
+
+- What / why / how tested
+- Hardware (RAK7248 or Pi + RAK2287/5146 HAT) and region (US915; EU868 where relevant)
+- Risks (especially 🔴 relay PRs)
+- `Closes #NNN` or `Related to #NNN`
+- AI disclosure line (see [Submission notes](#submission-notes))
+
+**Suggested GitHub issue (umbrella):**
+
+> `[Feature] Master roadmap — diagnostics, intelligence, field operations, and remote admin (16 PRs)`
+
+---
+
+## PR 01 — Packet Detail Modal
+
+| | |
+|---|---|
+| **Branch** | `feat/packet-detail-modal` |
+| **Title** | `feat(dashboard): packet detail modal in live feed` |
+| **Source** | FR1 |
+| **Risk** | 🟢 Frontend only |
+| **Status** | ✅ [#68](https://github.com/KMX415/meshpoint/pull/68) |
+
+### Scope
+
+Click any row in the live packet feed → layered modal (RF, mesh header, decoded payload, capture meta). Uses existing WebSocket `Packet.to_dict()` — **no new API**.
+
+### Files (codebase-accurate)
+
+| Layer | Files |
+|-------|-------|
+| Frontend | `frontend/js/simple_packet_feed.js` |
+| Frontend | `frontend/js/packet_detail_modal.js` — **new** |
+| Frontend | `frontend/css/packet_detail_modal.css` — **new** |
+| Frontend | `frontend/index.html` — script/style tags |
+
+*Roadmap text said `PacketFeed.js` — actual feed module is `simple_packet_feed.js`.*
+
+### Done when
+
+- [ ] Modal layers: RF, mesh, payload/decrypt, capture
+- [ ] Decrypt-failure state explicit
+- [ ] Close: ✕, Escape, backdrop
+- [ ] Feed updates behind open modal
+- [ ] Tested on target hardware
+
+---
+
+## PR 02 — Config QR Export
+
+| | |
+|---|---|
+| **Branch** | `feat/config-qr-export` |
+| **Title** | `feat(config): Quick Deploy QR export of public channel params` |
+| **Source** | FR3 |
+| **Risk** | 🟢 One read-only endpoint + frontend |
+| **Status** | ⬜ Not started |
+
+### Scope
+
+"Quick Deploy" generates QR + downloadable JSON of **public** channel parameters (name, frequency, modem preset). **PSKs never included.** QR format matches Meshtastic channel URL scheme.
+
+### Files
+
+| Layer | Files |
+|-------|-------|
+| Backend | `src/api/routes/config_routes.py` (or new `export_routes.py`) — `GET /api/config/export` |
+| Frontend | New QR panel (Configuration or Radio tab) + QR library (CDN or vendored) |
+| Docs | `docs/CONFIGURATION.md` — export section |
+
+### Endpoint (proposed)
+
+```
+GET /api/config/export
+→ { channel_name, frequency_mhz, region, modem_preset, meshtastic_url, ... }
+```
+
+Read from existing `AppConfig` / `GET /api/config` enrichment — no secrets.
+
+### Done when
+
+- [ ] Response contains zero PSK / `channel_keys` material
+- [ ] QR scans correctly in Meshtastic app
+- [ ] JSON download works offline
+- [ ] Auth: same as other config routes (`require_auth`)
+
+---
+
+## PR 03 — 24-Hour Traffic Histograms
+
+| | |
+|---|---|
+| **Branch** | `feat/traffic-histograms` |
+| **Title** | `feat(stats): 24-hour hourly traffic histogram with duty-cycle estimate` |
+| **Source** | FR1 |
+| **Risk** | 🟢 Frontend + one read-only SQL query |
+| **Status** | ✅ [#69](https://github.com/KMX415/meshpoint/pull/69) |
+
+### Scope
+
+Hourly packet volume (24h), stacked Meshtastic/MeshCore, duty-cycle overlay (est.). EU868 1% limit line when `radio.region == EU_868`.
+
+### Files
+
+| Layer | Files |
+|-------|-------|
+| Backend | `src/storage/packet_repository.py` — `get_hourly_traffic()` |
+| Backend | `src/api/routes/stats_routes.py` — `GET /api/stats/hourly` |
+| Backend | `src/analytics/toa_estimate.py` — shared ToA helper |
+| Frontend | `frontend/js/stats_tab.js`, `frontend/css/stats.css` |
+| Tests | `tests/test_traffic_hourly.py` |
+
+### Done when
+
+- [ ] Hourly counts match manual SQL spot-check
+- [ ] Duty line labeled **est.**
+- [ ] EU868 limit line only when region matches
+- [ ] No schema migration (uses `idx_packets_timestamp`)
+
+---
+
+## PR 04 — LAN Browser Push Notifications
+
+| | |
+|---|---|
+| **Branch** | `feat/lan-push-notifications` |
+| **Title** | `feat(dashboard): LAN browser push notifications for mesh alerts` |
+| **Source** | FR3 |
+| **Risk** | 🟢 Frontend + one additive WS field |
+| **Status** | ✅ [#77](https://github.com/KMX415/meshpoint/pull/77) |
+
+### Scope
+
+Native browser notifications via Service Worker when operator-selected events occur (node offline/online, battery low, storm-guard trigger). Preferences in `localStorage`. Works while any dashboard tab is open.
+
+### Files
+
+| Layer | Files |
+|-------|-------|
+| Backend | WS broadcast schema — add optional `event_type: "alert"` (additive, non-breaking) |
+| Frontend | Service worker — **new** (`frontend/sw.js` or similar) |
+| Frontend | Notification settings UI (Configuration or global settings) |
+| Frontend | `frontend/js/app.js` — WS handler for alerts |
+
+### Depends on
+
+- Nothing for basic alerts
+- Storm-guard **content** needs PR 12 to emit quarantine alerts (can ship PR 04 with other triggers first)
+
+### Done when
+
+- [ ] Permission prompt + per-event toggles
+- [ ] Existing WS packet stream unchanged when alerts disabled
+- [ ] No notification when tab focused (optional UX)
+- [ ] Tested in Chromium + Firefox
+
+---
+
+## PR 05 — Per-Node Signal Health Sparklines
+
+| | |
+|---|---|
+| **Branch** | `feat/signal-health-tracking` |
+| **Title** | `feat(nodes): RSSI sparklines and health badges on node cards` |
+| **Source** | FR1 |
+| **Risk** | 🟢 Frontend + read-only SQL per node |
+| **Status** | ✅ [#70](https://github.com/KMX415/meshpoint/pull/70) |
+
+### Scope
+
+RSSI/SNR sparkline on node cards (24h, 15-min buckets), expandable in node drawer. Green/yellow/red badge from configurable thresholds in `local.yaml`. Lazy-loaded (`IntersectionObserver`).
+
+### Files
+
+| Layer | Files |
+|-------|-------|
+| Backend | `src/storage/packet_repository.py` — `get_signal_buckets()` |
+| Backend | `src/api/routes/nodes.py` — extend `GET /api/nodes/{id}/metrics_history?bucket_minutes=15` |
+| Config | `src/config.py` — `SignalHealthConfig` (optional) |
+| Frontend | `frontend/js/signal_sparkline.js`, `frontend/js/node_cards.js` |
+| Tests | `tests/test_signal_buckets.py` |
+
+*Roadmap proposed `/signal_history` — **extend existing** `metrics_history` instead of a parallel endpoint.*
+
+### Done when
+
+- [ ] Sparkline loads only when card visible
+- [ ] Badge hidden when packet count below `min_packets_per_hour`
+- [ ] Thresholds documented in `CONFIGURATION.md`
+
+---
+
+## PR 06 — Node Coverage Map Layer
+
+| | |
+|---|---|
+| **Branch** | `feat/node-coverage-map` |
+| **Title** | `feat(map): RSSI coverage circles on dashboard map` |
+| **Source** | FR2 |
+| **Risk** | 🟢 Frontend + one read-only SQL JOIN |
+| **Status** | ✅ [#78](https://github.com/KMX415/meshpoint/pull/78) |
+
+### Scope
+
+"Coverage View" toggle on existing Leaflet map. Nodes with GPS → color-coded circles (RSSI quality), size ∝ packet confidence. Nodes without GPS → "unplotted" count in sidebar. Click marker → existing node drawer.
+
+### Files
+
+| Layer | Files |
+|-------|-------|
+| Backend | `src/api/routes/nodes.py` — `GET /api/nodes/coverage` (JOIN nodes + packet aggregates) |
+| Backend | `src/storage/node_repository.py` / `packet_repository.py` — aggregation helper |
+| Frontend | `frontend/js/components/node_map.js` — coverage layer toggle |
+| Frontend | `frontend/css/` — circle layer styles |
+
+*Existing map: `NodeMap` in `node_map.js`; data today via `GET /api/nodes/map` → `NetworkMapper.get_map_data()`.*
+
+### Done when
+
+- [ ] Toggle does not break topology layer (PR diagnostics #5)
+- [ ] Unplotted count accurate
+- [ ] No new tile server
+- [ ] Performance OK with 500+ nodes
+
+---
+
+## PR 07 — Spectrum Analyzer Dashboard Tab
+
+| | |
+|---|---|
+| **Branch** | `feat/spectrum-analyzer-tab` |
+| **Title** | `feat(rf): RF Environment tab exposing spectral scan + noise floor` |
+| **Source** | FR2 |
+| **Risk** | 🟡 New endpoint reading existing services |
+| **Status** | ✅ [#79](https://github.com/KMX415/meshpoint/pull/79) |
+
+### Scope
+
+New **RF Environment** tab: noise-floor sparkline + calibration state; spectral histogram from latest scan. **Exposure only** — backend services already exist and are tested.
+
+### Already in repo
+
+| Component | Path |
+|-----------|------|
+| `NoiseFloorTracker` | `src/api/telemetry/noise_floor.py` |
+| `SpectralScanService` | `src/api/telemetry/spectral_scan_service.py` |
+| HAL scan | `src/hal/sx1302_spectral_scan.py` |
+| Tests | `tests/test_noise_floor.py`, `tests/test_spectral_scan_*.py` |
+
+### Files
+
+| Layer | Files |
+|-------|-------|
+| Backend | `src/api/routes/rf_routes.py` — **new** — `GET /api/rf/status` |
+| Backend | `src/api/server.py` — wire tracker + scan service into route init |
+| Frontend | New RF tab JS + CSS; sidebar entry in `frontend/index.html` |
+
+### Done when
+
+- [ ] Tab shows "no hardware scan" gracefully when `spectral_scan_interval_seconds: 0`
+- [ ] Values labeled live vs packet-derived fallback
+- [ ] No new HAL code unless bugfix required
+
+---
+
+## PR 08 — Stray Frame Logger
+
+| | |
+|---|---|
+| **Branch** | `feat/stray-frame-logger` |
+| **Title** | `feat(capture): log undecodable RF frames to stray_frames table` |
+| **Source** | FR3 |
+| **Risk** | 🟡 New SQLite table + receive-path insert |
+| **Status** | ✅ Submitted ([#80](https://github.com/KMX415/meshpoint/pull/80)) |
+
+### Scope
+
+When a frame fails **both** Meshtastic and MeshCore decode, persist RF metadata only (channel, frequency, SF, BW, RSSI, SNR, frame size) to `stray_frames`. Dashboard **Unknown RF** tab with filter + CSV export. Auto-prune by retention hours.
+
+### Files
+
+| Layer | Files |
+|-------|-------|
+| Storage | `src/storage/database.py` — migration for `stray_frames` |
+| Storage | `src/storage/stray_frame_repository.py` — **new** |
+| Pipeline | Insert after decode failure, before discard (coordinator / packet router) |
+| API | `GET /api/stray_frames` (+ optional `?format=csv`) |
+| Frontend | New tab or Stats subsection |
+| Config | `stray_frames.max_retained` / `retention_hours` in `local.yaml` |
+
+### Done when
+
+- [ ] Insertion is **after** both decoders return None — no TX, no relay, no re-encode
+- [ ] CSV export works
+- [ ] Prune job does not block receive loop
+- [ ] Unit test for repository + insert hook
+
+---
+
+## PR 09 — Prometheus Metrics Endpoint
+
+| | |
+|---|---|
+| **Branch** | `feat/prometheus-metrics` |
+| **Title** | `feat(metrics): Prometheus-compatible /metrics endpoint` |
+| **Source** | FR2 |
+| **Risk** | 🟡 New endpoint + optional config |
+| **Status** | ✅ Submitted ([#81](https://github.com/KMX415/meshpoint/pull/81)) |
+
+### Scope
+
+`GET /metrics` in Prometheus text format: packet counts, duty-cycle est., noise floor, node counts, RSSI averages, CRC errors, relay stats, uptime. Read from in-memory state. **Disabled by default** (`metrics.enabled: false`). Optional `metrics.require_auth`.
+
+### Files
+
+| Layer | Files |
+|-------|-------|
+| Backend | `src/api/routes/metrics_routes.py` — **new** |
+| Config | `src/config.py` — `MetricsConfig` |
+| Docs | `docs/CONFIGURATION.md` |
+
+**Implementation choice (decide before coding):**
+
+- **A)** Zero-dep raw `# HELP` / `# TYPE` writer (preferred for Pi installs)
+- **B)** Optional `prometheus_client` dependency
+
+### Done when
+
+- [ ] Default off — zero behaviour change on upgrade
+- [ ] Document scrape config for LAN Prometheus
+- [ ] No PSK / token values in labels
+
+---
+
+## PR 10 — Event-Driven Webhook Engine (Config Only)
+
+| | |
+|---|---|
+| **Branch** | `feat/webhook-engine-config` |
+| **Title** | `feat(webhooks): configurable outbound HTTP rules for mesh events` |
+| **Source** | FR3 |
+| **Risk** | 🟡 New async module + yaml schema |
+| **Status** | ✅ Submitted ([#82](https://github.com/KMX415/meshpoint/pull/82)) |
+
+### Scope
+
+`local.yaml` webhook rules → async HTTP POST on events (battery low, node silence/return, keyword match, duty spike, storm quarantine). Per-rule cooldown in memory. Failures never block packet processing. Fires logged to audit log.
+
+### Files
+
+| Layer | Files |
+|-------|-------|
+| Backend | `src/webhook/engine.py` — **new** (or `src/integrations/webhook_engine.py`) |
+| Config | `src/config.py` — `WebhookConfig` / rules list |
+| Wiring | `src/coordinator.py` or packet callbacks — subscribe to decoded stream |
+| Docs | `docs/CONFIGURATION.md` |
+
+Uses `httpx` (already in stack). **No relay / TX / decoder changes.**
+
+### Depends on
+
+- Storm-guard **trigger** needs PR 12; all other triggers work independently
+
+### Done when
+
+- [ ] Failed POST does not slow pipeline
+- [ ] Cooldown prevents alert storms
+- [ ] Rules validated at startup
+- [ ] Unit tests with mocked HTTP
+
+---
+
+## PR 11 — Webhook Dashboard UI
+
+| | |
+|---|---|
+| **Branch** | `feat/webhook-ui` |
+| **Title** | `feat(dashboard): webhook rules status and test panel` |
+| **Source** | FR3 |
+| **Risk** | 🟢 Frontend + thin API |
+| **Status** | ✅ Submitted ([#83](https://github.com/KMX415/meshpoint/pull/83)) |
+| **Depends on** | **PR 10 merged** ([#82](https://github.com/KMX415/meshpoint/pull/82)) |
+
+### Scope
+
+Settings panel: active rules from config, last-fired timestamps, **Test** button (dummy POST to verify URL from Pi).
+
+### Files
+
+| Layer | Files |
+|-------|-------|
+| Backend | `GET /api/webhooks/status`, `POST /api/webhooks/test/{rule_name}` |
+| Frontend | Configuration card — **new** |
+
+### Done when
+
+- [ ] Test POST clearly marked dummy payload
+- [ ] Last-fired updates without restart
+- [ ] No rule secrets in API response
+
+---
+
+## PR 12 — Storm Guard Auto-Quarantine
+
+| | |
+|---|---|
+| **Branch** | `feat/storm-guard-quarantine` |
+| **Title** | `feat(relay): automatic storm/replay quarantine with auto-release` |
+| **Source** | FR2 |
+| **Risk** | 🔴 Relay module — **extra review** |
+| **Status** | ✅ [#84](https://github.com/KMX415/meshpoint/pull/84) |
+
+### Scope
+
+Temporary **memory-only** quarantine for storm/replay behavior:
+
+- Identical `packet_id` seen N times in rolling window, **or**
+- Excessive packets/minute from one node
+
+Separate from permanent blocklist (PR 13). Auto-release after duration. Amber badge + countdown on node cards. Operator can release early or promote to blocklist.
+
+### Config (proposed — under `relay` section)
+
+```yaml
+relay:
+  storm_guard:
+    enabled: true
+    window_seconds: 60
+    identical_packet_threshold: 5
+    rate_threshold_per_minute: 30
+    quarantine_duration_seconds: 300
+    notify_dashboard: true
+```
+
+### Files
+
+| Layer | Files |
+|-------|-------|
+| Relay | `src/relay/storm_guard.py` — **new** |
+| Relay | `src/relay/relay_manager.py` — check quarantine before approve |
+| API | Optional `GET /api/relay/quarantine` for dashboard |
+| Frontend | Node card badge; Relay / Stats section |
+| WS | Optional `event_type: alert` for PR 04 |
+
+### Risks (call out in PR)
+
+- False positive quarantine on busy legitimate nodes
+- Memory growth if quarantine dict not pruned
+- Distinction from blocklist must be documented
+
+### Done when
+
+- [ ] Quarantine does not write SQLite
+- [ ] Auto-release tested with clock injection
+- [ ] Tested against fast TX test node
+- [ ] `channel_throttled` / blocklist interaction documented
+
+---
+
+## PR 13 — Smart Relay Filter Controls
+
+| | |
+|---|---|
+| **Branch** | `feat/relay-filter-controls` |
+| **Title** | `feat(relay): dashboard blocklist, priority list, and dedup TTL` |
+| **Source** | FR1 |
+| **Risk** | 🔴 Relay + config — **extra review** |
+| **Status** | ✅ [#71](https://github.com/KMX415/meshpoint/pull/71) |
+
+### Scope
+
+Dashboard UI for relay filters without editing `local.yaml`. Blocklist, priority list, dedup TTL. Hot-reload without restart.
+
+### Files
+
+| Layer | Files |
+|-------|-------|
+| Config | `src/config.py` — `relay.blocklist`, `priority_list`, `dedup_ttl_seconds` |
+| Relay | `src/relay/relay_manager.py` — `reload_filters()` |
+| API | `PUT /api/config/relay` in `system_config_routes.py` |
+| Frontend | `frontend/js/configuration/relay_filters_card.js` |
+| Tests | `tests/test_relay_filters.py` |
+
+*Roadmap used flat keys `relay_blocklist` — actual schema nests under `relay:` in `local.yaml`.*
+
+### Done when
+
+- [ ] Blocklist is relay-only — feed unchanged
+- [ ] Priority bypasses burst gate only (not per-minute cap)
+- [ ] Node ID validated server-side (8 hex chars)
+- [ ] Persistence across restart via `save_section_to_yaml`
+
+---
+
+## PR 14 — USB Companion Firmware Flasher
+
+| | |
+|---|---|
+| **Branch** | `feat/companion-firmware-flasher` |
+| **Title** | `feat(hardware): USB companion firmware flasher with live esptool output` |
+| **Source** | FR3 |
+| **Risk** | 🟡 Subprocess + WebSocket — **no radio TX** |
+| **Status** | ✅ Submitted — [#85](https://github.com/KMX415/meshpoint/pull/85) |
+
+### Scope
+
+Upload a `.bin` from **Settings → System** and flash the USB MeshCore/Meshtastic companion via `esptool`. Live log stream on authenticated WebSocket. MeshCore USB releases serial before flash; auto-reconnect after ESP reboot.
+
+### Files
+
+| Layer | Files |
+|-------|-------|
+| Backend | `src/firmware/flasher.py`, `upload_store.py`, `log_broadcast.py` |
+| Backend | `src/api/routes/firmware_routes.py` |
+| Backend | `src/capture/meshcore_usb_source.py` — `release_serial_for_flash()` |
+| Backend | `src/api/server.py` — router + MeshCore suspend hook |
+| Frontend | `frontend/js/settings/companion_flash_card.js` |
+| Deps | `requirements.txt` — `esptool>=4.7.0` |
+| Tests | `tests/test_firmware_flasher.py` |
+| Docs | `docs/CONFIGURATION.md` — companion flash section |
+
+### Done when
+
+- [x] Admin-only upload + flash; audit `firmware_flash`
+- [x] WS uses `_gate_ws_or_close` pattern (4401 when unauthenticated)
+- [x] Per-port lock; HTTP 409 on concurrent flash
+- [x] Temp upload cleaned up on all paths
+- [x] DangerousModal confirmation before flash POST
+- [ ] Hardware flash on RAK7248 + Heltec companion
+
+---
+
+## PR 15 — Remote Node Config Reader (ADMIN, read-only)
+
+| | |
+|---|---|
+| **Branch** | `feat/remote-node-config-read` |
+| **Title** | `feat(admin): remote Meshtastic node config reader via ADMIN portnum` |
+| **Source** | FR4 |
+| **Risk** | 🔴 TX path — one ADMIN request per click |
+| **Status** | ✅ Submitted — [#86](https://github.com/KMX415/meshpoint/pull/86) |
+
+### Scope
+
+**Request config** in node detail drawer. Sends encrypted `get_config_request` ADMIN packet; displays decoded response read-only. Requires `meshtastic.admin_key_b64` in `local.yaml`.
+
+### Done when
+
+- [x] No write path in this PR
+- [x] 30 s timeout + retry UI; 30 s button debounce
+- [x] PSK redacted in audit log
+- [ ] Tested 1-hop and 3-hop on hardware
+
+---
+
+## PR 16 — Remote Node Config Writer (ADMIN write)
+
+| | |
+|---|---|
+| **Branch** | `feat/remote-node-config-write` |
+| **Title** | `feat(admin): remote Meshtastic node config write (limited fields)` |
+| **Source** | FR4 |
+| **Risk** | 🔴 **Highest in roadmap** — write TX + crypto |
+| **Status** | ✅ Submitted — [#87](https://github.com/KMX415/meshpoint/pull/87) |
+
+### Scope
+
+Editable fields: names, telemetry interval, screen timeout, device role (typed `CONFIRM`). Post-write automatic config read to verify. No frequency/PSK/factory reset.
+
+### Done when
+
+- [x] Role change requires second confirmation
+- [x] Follow-up read verifies applied state
+- [ ] Hardware: role + telemetry interval change verified
+
+---
+
+## Submission strategy
+
+| Phase | PRs | Goal |
+|-------|-----|------|
+| **A — Green baseline** | 01–06 (skip done: 01, 03, 05) | Establish clean contribution pattern |
+| **B — Yellow backend** | 07–09 | After ≥2 green merges |
+| **C — Webhooks** | 10 → 11 | Engine reviewed before UI |
+| **D — Relay last** | 12 → 13 | Highest review; 13 already submitted — merge before PR 12 if both open |
+| **E — Field hardware** | 14 → 15 → 16 | 14 no TX; 15–16 ADMIN TX; **1 week soak** between 15 and 16 |
+
+**Never submit two PRs simultaneously.**
+
+After each merge:
+
+```bash
+git fetch upstream
+git checkout -B feat/<next-branch> upstream/main
+```
+
+---
+
+## Scope alignment notes (roadmap vs repo)
+
+| Roadmap item | Repo reality |
+|--------------|--------------|
+| `PacketFeed.js` | `frontend/js/simple_packet_feed.js` |
+| `/api/nodes/{id}/signal_history` | Extend `GET /api/nodes/{id}/metrics_history` |
+| `relay_blocklist` top-level keys | `relay.blocklist` under `relay:` in yaml |
+| `relay_duplicate_window_sec: 30` | Implemented as `relay.dedup_ttl_seconds` (default 300) |
+| `src/api.py` | Routes live under `src/api/routes/*.py` |
+| Topology graph | Already PR diagnostics #5 ([#72](https://github.com/KMX415/meshpoint/pull/72)) — not in 13-PR table |
+| Duty-cycle throttle | Already PR diagnostics #7 ([#74](https://github.com/KMX415/meshpoint/pull/74)) — after PR 03 + 13 |
+
+---
+
+## Operator test matrix (all PRs)
+
+| Item | Value |
+|------|-------|
+| Primary hardware | RAK Hotspot V2 (RAK7248) or Pi 4 + RAK2287/5146 Pi HAT |
+| Region | US915 primary; EU868 re-test for PR 03 duty line + PR 12/13 |
+| OS | Raspberry Pi OS 64-bit Bookworm |
+| Load profile | ~8k–12k packets/day backbone |
+| MeshCore | Heltec V3 `companion_radio_usb` optional |
+
+---
+
+## Submission notes
+
+### AI-assisted contributions
+
+Per CONTRIBUTING.md, include in **each** PR description:
+
+> Note: PR description and initial scaffolding assisted by Claude. All code reviewed and tested on target hardware before submission.
+
+### What to say when starting each PR
+
+| Step | Action |
+|------|--------|
+| Start next green PR | `git checkout -B feat/<branch> upstream/main` |
+| After merge | Rebase or recreate branch from fresh `upstream/main` |
+| Relay PR | Request extra review; document insertion point + failure modes |
+
+### Suggested next PR (as of this doc)
+
+With 01–13 submitted (02 also submitted as #76) and **14–16** queued:
+
+1. **Waiting:** PR **16** [#87](https://github.com/KMX415/meshpoint/pull/87) in review — hardware role + telemetry verify
+2. **Waiting:** PR **15** [#86](https://github.com/KMX415/meshpoint/pull/86) in review — hardware read 1-hop + 3-hop
+3. **Waiting:** PR **14** [#85](https://github.com/KMX415/meshpoint/pull/85) in review (companion flash)
+4. **Roadmap E complete** once 14–16 merge; soak #15 before #16 merge per strategy
+4. Rebase open relay/webhook PRs (#80–#84) onto `main` as merges land
+
+---
+
+## Quick review checklist (per PR before submit)
+
+- [ ] Branch from latest `upstream/main` (not stacked on another feature branch)
+- [ ] Single focused change; no drive-by refactors
+- [ ] Tests added or extended where backend logic changes
+- [ ] `docs/CONFIGURATION.md` updated if new yaml keys
+- [ ] No secrets in repo, logs, or API responses
+- [ ] PR body: what / why / test plan / hardware / region / risks
+- [ ] AI disclosure line present
+- [ ] 🔴 Relay PRs: explicit "does not change TX to mesh" vs relay-only behaviour
diff --git a/docs/plans/v0.7.8-operator-polish.md b/docs/plans/v0.7.8-operator-polish.md
index d6e561f0..5b35d0bc 100644
--- a/docs/plans/v0.7.8-operator-polish.md
+++ b/docs/plans/v0.7.8-operator-polish.md
@@ -12,9 +12,9 @@ Tier A (v0.7.7) PRs begin merging; **one PR at a time**.
 
 | # | Branch | Title | Depends on | Status |
 |---|--------|-------|------------|--------|
-| 17 | `feat/operator-polish` | Operator status strips + MQTT broker health + map hint | Tier A baseline | ✅ Ready |
-| 18 | `feat/stats-traffic-heatmap` | SVG traffic heatmap (extends #69 histogram data) | **#69 merged** | ⬜ Not started |
-| 19 | `feat/analytics-status-strips` | RF + Unknown RF + Topology tab footers | **#72, #79, #80 merged** | 🔄 Partial (#72) |
+| 17 | `feat/operator-polish` | Operator status strips + MQTT broker health + map hint | Tier A baseline | ✅ [#90](https://github.com/KMX415/meshpoint/pull/90) |
+| 18 | `feat/stats-traffic-heatmap` | SVG traffic heatmap (extends #69 histogram data) | **#69 merged** | 🔄 Branch ready (draft) |
+| 19 | `feat/analytics-status-strips` | RF + Unknown RF + Topology tab footers | **#72, #79, #80** | ✅ On #72, #79, #80 |
 | 20 | `docs/home-assistant-cookbook` | Expanded HA recipes (ships with #17 docs) | — | ✅ In #17 |
 
 ---
@@ -25,6 +25,7 @@ Tier A (v0.7.7) PRs begin merging; **one PR at a time**.
 |---|---|
 | **Branch** | `feat/operator-polish` |
 | **Title** | `feat(dashboard): operator status strips and MQTT broker health` |
+| **Upstream PR** | [#90](https://github.com/KMX415/meshpoint/pull/90) |
 | **Risk** | 🟢 |
 
 ### What ships
@@ -54,15 +55,22 @@ Tier A (v0.7.7) PRs begin merging; **one PR at a time**.
 
 ## PR 18 — Traffic heatmap (green, follow-up to #69)
 
-Do **not** rewrite #69 mid-merge. After #69 lands, add optional SVG
-hour × protocol heatmap beside the 24h bar chart using the same SQL.
+Do **not** rewrite #69 mid-merge. After #69 lands, open PR from
+`feat/stats-traffic-heatmap` (branched from `feat/traffic-histograms`).
+
+Adds an SVG hour × protocol heatmap under the 24h bar chart using
+`GET /api/stats/hourly` data already added by [#69](https://github.com/KMX415/meshpoint/pull/69).
+No new backend endpoints.
 
 ---
 
 ## PR 19 — Analytics tab footers (green)
 
-After #72 (topology), #79 (RF), and #80 (unknown RF) merge, add
-`StatusStrip` footers:
+`StatusStrip` footers are already on open PRs [#72](https://github.com/KMX415/meshpoint/pull/72),
+[#79](https://github.com/KMX415/meshpoint/pull/79), and
+[#80](https://github.com/KMX415/meshpoint/pull/80). Stats footer ships in #90.
+
+Reference labels:
 
 | Tab | Label | Example |
 |-----|-------|---------|

From 3691ee11953a5491406237529f480929a94833d8 Mon Sep 17 00:00:00 2001
From: iceice400 <AdamAndrew2468@gmail.com>
Date: Fri, 12 Jun 2026 03:38:30 -0400
Subject: [PATCH 3/3] docs(readme): link Home Assistant cookbook and
 contributor roadmap

Co-authored-by: Cursor <cursoragent@cursor.com>
---
 README.md | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/README.md b/README.md
index 6bfd4fa7..1a25585f 100644
--- a/README.md
+++ b/README.md
@@ -284,6 +284,7 @@ Start with the doc that matches what you are trying to do.
 - **[Configuration Guide](docs/CONFIGURATION.md):** all config options, private channels, relay, upstream, MQTT, radio tuning
 - **[Radio Config Explained](docs/RADIO-CONFIG-EXPLAINED.md):** the "why" behind region, spreading factor, bandwidth, custom slots, Part 15 awareness
 - **[MQTT and Meshradar](docs/MQTT-AND-MESHRADAR.md):** the two cloud paths side-by-side, what data flows where, privacy posture
+- **[Home Assistant cookbook](docs/HOME-ASSISTANT-COOKBOOK.md):** copy-paste REST sensors, alerts, and broadcast automations for LAN integrations
 - **[Network Watchdog](docs/NETWORK-WATCHDOG.md):** how the WiFi auto-recovery service works, default thresholds, re-enabling auto-reboot
 
 **When something goes wrong**
@@ -292,6 +293,7 @@ Start with the doc that matches what you are trying to do.
 - **[Troubleshooting](docs/TROUBLESHOOTING.md):** longer diagnostic flows, recovery from corrupted installs
 
 **Project**
+- **[Contributor PR roadmap](docs/plans/master-pr-roadmap.md):** ordered queue for diagnostics, intelligence, and field-ops PRs
 - **[Changelog](docs/CHANGELOG.md):** version history and release notes
 - **[GitHub Issues](https://github.com/KMX415/meshpoint/issues)** and **[Discussions](https://github.com/KMX415/meshpoint/discussions)** for bugs and questions
 - **[Discord](https://discord.gg/BnhSeFXVY8)** for real-time community support